% gEDA - GPL Electronic Design Automation
% cascade.tex - RF Cascade symbol library and gnetlist backend documentation
% 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{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{gEDA/gaf Cascade RF Symboles et Netlister}
\author{Dan McMahill\\
        \\
	traduit par iznogood@iznogood-factory.org
	\\
	Ce document est \'ecrit sous GFDL\\
        \\
        (\url{http://www.gnu.org/copyleft/fdl.html})}
\date{December 3rd, 2003}

\begin{document}

\maketitle
\newpage

\tableofcontents
\newpage


\section{Survol}
Ce document d\'ecrit la biblioth\`eque symbole et le support gnetlist qui permet
le pilotage des simulations Cascade RF (\url{http://rfcascade.sourceforge.net})
depuis le syst\`eme gEDA/gaf.
Cascade est un outil d'analyse de bruit et de distorsion adapt\'e pour la conception
de r\'ecepteurs radios.

Les \'etapes de base pour l'utilisation de gEDA comme interface pour les simulations
de Cascade sont~:

\begin{enumerate}
\item Cr\'eer les sch\'emas du circuit.
\item Extraire la netlist.
\item Lancer Cascade.
\end{enumerate}

\section{Logiciels n\'ecessaires}
Vous aurez besoin des programmes suivants d'install\'es.
\begin{enumerate}
\item Une version r\'ecente de gEDA/gaf. Pour v\'erifier si votre version est
suffisamment r\'ecente, regardez si le r\'epertoire 
{\tt \${prefix}/share/gEDA/sym/cascade} existe. {\tt \${prefix}} est le
pr\'efixe d'installation gEDA sur votre syst\`eme.

\item Cascade RF. L'ex\'ecutable est habituellement appel\'e {\tt cascade}.  
  Si Cascade n'est pas disponible sur votre syst\`eme, vous devrez obtenir
  une copie depuis \url{http://rfcascade.sourceforge.net}.
\end{enumerate}

\section{Cr\'eation des sch\'emas}
Lorsque vous cr\'eez un sch\'ema dans l'\'editeur de sch\'emas {\tt gschem},
n'utilisez que les symboles de la biblioth\`eque de cascade. Chaque bloc
doit avoir un \'el\'ement ``cascade-source''. De plus, le bloc doit \^etre
un \'el\'ement cascade simple. Aucun chemin parall\`ele ou ni aucune branche 
ne sont permis.

Toutes les instances doivent avoir une d\'esignation de r\'ef\'erence unique.
Pour un sch\'ema de r\'ecepteur, il est souvent beaucoup plus efficace de le terminer
en les saisissant manuellement. La seule restriction sur les noms de 
d\'esignation est qu'ils ne contiennent pas d'espace. Un nom descriptif
tel que ``RF\_Filter'' ou ``First\_Mixer'' est utile car il soulignera
le rapport de sortie de cascade. 

\section{Extraction du fichier d'entr\'ee de Cascade}
Pour extraire le fichier d'entr\'ee de Cascade, lancez
\begin{verbatim}
    gnetlist -g cascade -o test.cas file1.sch [file2.sch ...]
\end{verbatim}
Pour le fichier d'exemple contenu dans cette archive, vous pouvez lancer~: 
\begin{verbatim}
    gnetlist -g cascade -o example.cas example.sch
\end{verbatim}

La netlist est conserv\'ee dans {\tt example.cas}.

\section{Lancer Cascade}
Cascade est tr\`es simple \`a lancer. Faites
\begin{verbatim}
    cascade example.cas > example.out
\end{verbatim}
pour lancer l'analyse sur le syst\`eme contenu dans le fichier
{\tt example.cas} et \'ecrivez le r\'esultat dans le fichier
{\tt example.out}. Veuillez consulter la documentation de Cascade
pour une information compl\`ete.

\appendix
\section{Les symboles dans la biblioth\`eque}
Veuillez noter que toutes les instances doivent avoir le jeu d'attributs
{\tt refdes=}.

\subsection{Sources (cascade-source)}
Source. \\
Attributs:
\begin{itemize}
\item {\bf C}=Niveau de la porteuse en dBm. Optionel.
\item {\bf CN0}=Ratio de densit\'e spectrale entre la porteuse et le bruit en dBm/Hz.  Optionel.
\item {\bf CN}=Ratio de la porteuse par rapport au bruit en dB. Optionel.
\item {\bf BW}=Largeur de bande du signal en Hz. Optionel mais n\'ecessaire si 
{\tt CN=} est utilis\'e.
\end{itemize}

\subsection{D\'efauts (cascade-default)}
Ce symbole positionne les niveaux d'imp\'edence par d\'efaut de m\^eme que les
coefficients de correlation utilis\'es pour les calculs de distortion au
troisi\`eme ordre.
Il y a deux versions de ce symbole. L'une est utilis\'ee pour initialiser
les r\'eglages par d\'efaut au d\'ebut de la d\'efinition. L'autre peut \^etre plac\'ee
en s\'eries avec cascade pour changer le comportement des parties par d\'efaut.
C'est tr\`es utile si vous souhaitez changer les niveaux d'imp\'edance dans le
milieu de la cha\^ine de r\'eception. \\
Attributs~:
\begin{itemize}
\item {\bf RIN}=R\'esistance du bloc d'entr\'ee par d\'efaut en Ohms. Optionel.
\item {\bf ROUT}=R\'esistance du bloc de sortie par d\'efaut en Ohms. Optionel.
\item {\bf RHO}=Coefficient de correlation de la distortion du troisi\`eme ordre par d\'efaut. Optionel.
\end{itemize}

\subsection{\'El\'ements}
Cascade caract\'erise chaque bloc d'un syst\`eme par son gain et optionnellement
par l'image de son bruit et le point d'interception au troisi\`eme ordre. Cela
implique qu'il n'y a pas de distinction entre les divers \'el\'ements tels que les
amplificateurs, les filtres et les m\'elangeurs. La biblioth\`eque de symboles
de Cascade RF pour gEDA/gaf contient diff\'erents symboles seulement pour la
clart\'e dans le sch\'ema. Les \'el\'ements de symboles actuellement disponibles sont~:
\begin{table}[h]
\begin{center}
\begin{tabular}{||l|l||} \hline \hline
cascade-amp           & Amplificateur    \\ \hline 
cascade-filter        & Filtre       \\ \hline 
cascade-mixer         & M\'elangeur        \\ \hline 
cascade-transformer   & Transformateur  \\ \hline 
\hline
\end{tabular}
\caption{Types d'\'el\'ements}
\label{tab:elements}
\end{center}
\end{table}
Attributs~:
\begin{itemize}
\item Le gain est sp\'ecifi\'e par un des suivants~:
  \begin {itemize}
  \item {\bf G}=Gain de puissance en dB.
  \item {\bf GP}=Gain de puissance en dB.
  \item {\bf GV}=Gain de tension en dB.
  \end {itemize}
\item {\bf NF}=Image du bruit en dB. Optionel.
\item {\bf IIP3}=Point d'interception d'entr\'ee du troisi\`eme ordre en dBm. Optionel.
\item {\bf RIN}=R\'esistance d'entr\'ee du bloc en Ohms.  Optionel.
\item {\bf ROUT}=R\'esistance de sortie du bloc en Ohms.  Optionel.
\item {\bf RHO}=Coefficient de correlation de distortion au troisi\`eme ordre. Optionel.
\end{itemize}
\section{Exemple}
Cet appendice fournit un exemple simple sur le processus complet de
la g\'en\'eration d'un sch\'ema, la production un fichier d'entr\'ee pour Cascade,
du lancement d'une analyse et de l'observation du r\'esultat.

\subsection{Exemple de sch\'ema}
Figure~\ref{fig:ckt} montre le sch\'ema d'une cha\^ine de signal d'un receveur
simple.
\begin{figure}
\begin{center}
\includegraphics[angle=270,width=4in]{example.eps}
\end{center}
\caption{Sch\'ema de bloc de cha\^ine de signal d'un r\'ecepteur simple}
\label{fig:ckt}
\end{figure}
Figure~\ref{fig:example.cas} montre le contenu du fichier {\tt example.cas}.
\begin{figure}
\begin{verbatim}

# Cascade (http://rfcascade.sourceforge.net)
# Created with gEDA/gnetlist

# Initial global defaults
defaults RIN=75 ROUT=75 RHO=0 

source C=-35 CN0=78 
RF_FILTER1 G=-2.5 NF=2.5 
LNA G=12 NF=2.7 IIP3=0 
RF_FILTER2 G=-2.5 NF=2.5 
MIXER G=-7 NF=7 IIP3=-3 
IF_FILTER G=-6 NF=6 
T1 G=0 NF=0 RIN=75 ROUT=50 
defaults RIN=75 ROUT=200 RHO=0 
IF_AMP G=12 NF=6 IIP3=7 

# End of netlist created by gEDA/gnetlist

\end{verbatim}
\caption{Exemple de fichier d'entr\'ee Cascade RF, {\tt example.cas}}
\label{fig:example.cas}
\end{figure}

\subsection{Cr\'eation du netlist du sch\'ema}
Pour avoir le netlist du sch\'ema, lancez~:
\begin{verbatim}
    gnetlist -g cascade example.cas example.sch
\end{verbatim}

\subsection{Lancement de l'analyse}
Lancez l'analyse avec~:
\begin{verbatim}
    cascade example.cas
\end{verbatim}
\newpage
\section{Historique de la r\'evision du Document}

\begin{table}[h]
\begin{tabular}{|l|l|} \hline
December 3rd, 2003 & Created cascade.tex \\ \hline
\end{tabular}
\end{table}

\end{document}

