% $Id: pads_backannotate.tex,v 1.2 2003/09/28 00:44:06 ahvezda Exp $
%
% gEDA - GPL Electronic Design Automation
% geda_pads_annotate.tex - Documentation for forward/backward
% annotation between gEDA and Pads PowerPCB.
%
% Copyright (C) 2003 Dan McMahill
%
% This program is free software; you can redistribute it and/or modify
% it under the terms of the GNU General Public License as published by
% the Free Software Foundation; either version 2 of the License, or
% (at your option) any later version.
%
% This program is distributed in the hope that it will be useful,
% but WITHOUT ANY WARRANTY; without even the implied warranty of
% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
% GNU General Public License for more details.
%
% You should have received a copy of the GNU General Public License
% along with this program; if not, write to the Free Software
% Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

\documentclass{article}
%\usepackage{epsfig}
\usepackage{graphicx}
% This line will enable hyperlinks in the PDF output
% file.
\usepackage[ps2pdf,breaklinks=true,colorlinks=true]{hyperref}

\setlength{\parindent}{0pt}
\setlength{\parskip}{1ex plus 0.5ex minus 0.2ex}

\title{Forward/Backward Annotation Between gEDA/gaf and Pads PowerPCB}
\author{Dan McMahill\\
\\
	traduit par iznogood@iznogood-factory.org
	\\
	Ce document est \'ecrit sous GFDL\\
        \\
	(\url{http://www.gnu.org/copyleft/fdl.html})}
\date{March 6th, 2003}

\begin{document}

\maketitle
\newpage

\tableofcontents
\newpage

\section{Annotation directe des changements de sch\'emas de gEDA vers les implantations de Pads PowerPCB}
\subsection{Survol}
L'annotation directe est le processus de mise \`a jour d'implantation pour refl\'eter
les changements faits dans le sch\'ema. Ce processus est utilis\'e lorsque, par exemple,
un nouveau composant est ajout\'e dans un sch\'ema et a besoin d'\^etre inclu dans
l'implantation. Cette section d\'ecrit comment effectuer un changement d'annotation
dans un sch\'ema gEDA vers une implantation Pads PowerPCB.

Pads int\`egre l'annotation directe par l'utilisation d'un fichier ECO (Engineering 
Change Order). Le fichier ECO d\'ecrit les diff\'erences entre le dessin courant et
le dessin souhait\'e. Pads g\'en\`ere le fichier ECO en effectuant une comparaison de
netlist entre un nouveau fichier netlist et le netlist contenu dans l'implantation
courante.

\subsection{Proc\'edure d'annotation directe d\'etaill\'ee}
Cette proc\'edure suppose que vous avez une implantation de carte ouverte dans Pads et
que vous avez fait vos changements de sch\'emas dans {\tt gschem}. Dans un but
d'illustration, supposons que votre sch\'ema soit coup\'e en deux pages dans les fichiers  {\tt pg1.sch} et {\tt pg2.sch}.

\begin{enumerate}
\item Cr\'eez une netlist mise \`a jour de Pads en lançant ``{\tt gnetlist -g pads
    -o mynet.asc pg1.sch pg2.sch}''. Ceci cr\'eera le fichier netlist ``{\tt mynet.asc}''.

\item Faites une copie de sauvegarde de votre implantation Pads dans le cas o\`u
les choses se passeraient mal dans le sens d'une destruction.

\item Depuis Pads, choisissez ``Tools$\rightarrow$Compare
  Netlist'' dans le menu item et prennez les options suivantes dans le masque
  de saisie.\\
  \\
  \begin{tabular}{|r l|}
    \hline 
    dessin original pour comparer:& utiliser le dessin PCB actuel \\
    nouveau dessin avec des changements:& mynet.asc \\
     $\surd$&g\'en\`ere le rapport de diff\'erences \\
     $\surd$&g\'en\`ere le fichier eco\\
     &\\
     options de comparaison &\\
     $\surd$&compare seulement les parties enregistr\'ees dans ECO\\
     &\\
     niveau de comparaison d'attributs &\\
     $\surd$&ignore tous les attributs\\
    \hline 
  \end{tabular}
  \\
  Cliquez sur le bouton OK pour cr\'eer le fichier ECO.

\item Examinez le fichier ECO pour vous assurer que tout est normal (le fichier
ECO est un fichier texte qui peut \^etre vu avec tout \'editeur de texte).

\item Depuis Pads, choisissez ``File$\rightarrow$Import...'' dans le menu item.  Localisez et choisissez le fichier ECO cr\'e\'e pr\'ec\'edement.

\end{enumerate}

\section{Annotation arri\`ere des changements de l'implantation de Pads PowerPCB vers les sch\'emas de gEDA}
L'annotation arri\`ere est le processus de mise \`a jour des sch\'emas pour refl\'eter
les changements faits sur l'implantation. Ce processus est utilis\'e, par exemple,
lorsque les d\'esignations de r\'ef\'erence ont \'et\'e recalcul\'ees sur l'implantation, lorsque
les broches ont \'et\'e permut\'ees (i.e. sur une porte AND) ou des slots ont \'et\'e permut\'es
(i.e. sur un bo\^itier multi-portes). Cette section d\'ecrit quels changements faire d'une implantation de Pads PowerPCB vers un sch\'ema de gEDA. L'outil Pads PowerPCB supporte
trois types de notation arri\`ere de sch\'emas~:

\begin{enumerate}
\item Changement de d\'esignation de r\'ef\'erence. Ceci est souvent utilis\'e \`a la fin
d'une implantation pour donner aux composants qui sont g\'eographiquement proches, un
jeu de d\'esignation de r\'ef\'erences qui sont num\'eriquement proches.

\item Permutation de slot. Ceci est habituellement trouv\'e dans les dessins num\'eriques
o\`u il peut y avoir plusieurs portes identiques dans un seul bo\^itier. Par exemple,
vous pouvez souhaiter permuter les slots utilis\'es dans un sextuple inverseur.

\item Permutation de broche. Pendant la mise en place, le concepteur peut souhaiter
permuter des broches \'equivalentes d'un bo\^itier. Les deux entr\'ees d'une porte NAND, par
exemple.
\end{enumerate}

Actuellement, seuls les changements de d\'esignations de r\'ef\'erence sont automatiquement
trait\'ees par l'outil d'annotation arri\`ere de Pads par gschem. Les changements de 
permutation de slot et de broche sont fournis dans un rapport que le concepteur de
sch\'ema doit utiliser pour corriger manuellement le sch\'ema.

\subsection{Proc\'edure d'annotation arri\`ere d\'etaill\'ee}
Cette proc\'edure suppose que vous avez une implantation de circuit ouverte dans Pads.
Dans un but d'illustration, supposons que votre sch\'ema soit coup\'e en deux pages dans les fichiers {\tt pg1.sch} et {\tt pg2.sch}.

\begin{enumerate}
\item Cr\'eez une netlist mise \`a jour de Pads en lançant ``{\tt gnetlist -g pads
    -o mynet.asc pg1.sch pg2.sch}''. Ceci cr\'eera le fichier netlist ``{\tt mynet.asc}''.

\item Depuis Pads, choisissez ``Tools$\rightarrow$Compare
  Netlist'' dans le menu item et prennez les options suivantes dans le masque
  de saisie.\\
  \\
  \begin{tabular}{|r l|}
    \hline 
    dessin original \`a comparer:& mynet.asc \\
    nouveau dessin avec les changements:& utilisez les dessins de PCB courant \\
     $\surd$&g\'en\`ere les diff\'erents rapports \\
     $\surd$&g\'en\`ere le fichier eco\\
     &\\
     comparaison d'options &\\
     $\surd$&compare seulement les parties enregistr\'ees d'ECO\\
     &\\
     niveau de comparaison d'attributs &\\
     $\surd$&ignore tous les attributs\\
    \hline 
  \end{tabular}
  \\
  Cliquez sur le bouton OK pour cr\'eer le fichier ECO.

\item Examinez le fichier ECO pour vous assurer qu'il soit normal (le fichier ECO
  est un fichier texte qui peut \^etre vu par tout \'editeur de texte).

\item Faites une copie de sauvegarde de votre implantation de sch\'emas de gEDA dans 
le cas o\`u les choses se passeraient mal dans le sens d'une destruction.

\item Lancez ``{\tt pads\_backannotate file.eco pg1.sch pg2.sch | tee
    backanno.log}'' o\`u 
  {\tt file.eco} est le nom du fichier ECO cr\'e\'e pr\'ec\'edement, {\tt pg1.sch} et 
  {\tt pg2.sch} forment toutes vos pages de sch\'ema.
  Ceci appliquera des portions de changement de d\'esignation de r\'ef\'erence du fichier
  ECO et g\'en\`ere aussi une liste de broches et de permutation de slots qui doit
  \^etre effectu\'ee \`a la main. Le fichier {\tt backanno.log} doit contenir un journal
  de la session qui peut consult\'e lors de la permutation de broche et de slot.
\end{enumerate}

\end{document}

