gsch2pcb: Make --m4-file and -m4-pcbdir arguments work again.
[geda-gaf/peter-b.git] / docs / wiki / geda-tragesym_tutorial.fr.html
blob996f7d74c799423ad0219d6c44bbe1b5d2567d14
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <title></title>
6 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
7 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
8 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 </head>
12 <body>
15 <h1 class="sectionedit1342"><a name="creer_des_symboles_gschem_rapidement_et_facilement_en_utilisant_tragesym_et_un_tableur" id="creer_des_symboles_gschem_rapidement_et_facilement_en_utilisant_tragesym_et_un_tableur">Créer des symboles gschem rapidement et facilement en utilisant tragesym et un tableur</a></h1>
16 <div class="level1">
18 <p>
20 La création de symboles pour le dessin de schémas peut prendre beaucoup de temps, générer beaucoup d&#039;erreurs et de frustrations. Heureusement, gschem utilise un format de fichier texte ouvert qui est très facile à utiliser avec des scripts. Ce tutoriel succint décrit comment utiliser tragesym, un outil extérieur, pour créer des symboles très rapidement (probablement plus rapidement qu&#039;avec tout paquet commercial).
21 </p>
23 </div>
24 <!-- EDIT1342 SECTION "Créer des symboles gschem rapidement et facilement en utilisant tragesym et un tableur" [1-532] -->
25 <h2 class="sectionedit1343"><a name="etapes_necessaires" id="etapes_necessaires">Étapes nécessaires</a></h2>
26 <div class="level2">
27 <ul>
28 <li class="level1"><div class="li"> Étape 1: Ouvrir un fichier de formulaire tragesym</div>
29 </li>
30 <li class="level1"><div class="li"> Étape 2: Télécharger le fichier technique du composant et trouver la liste des broches</div>
31 </li>
32 <li class="level1"><div class="li"> Étape 3: Copier la liste des broches dans un éditeur et la préparer</div>
33 </li>
34 <li class="level1"><div class="li"> Étape 4: Insérer toutes les données manquantes dans la feuille de calcul</div>
35 </li>
36 <li class="level1"><div class="li"> Étape 5: Exporter la feuille de calcul dans un fichier texte avec séparation par tabulation</div>
37 </li>
38 <li class="level1"><div class="li"> Étape 6: Lancer tragesym et créer le symbole</div>
39 </li>
40 <li class="level1"><div class="li"> Étape 7: Contrôler le résultat avec gschem et peaufiner le symbole</div>
41 </li>
42 </ul>
44 </div>
45 <!-- EDIT1343 SECTION "Étapes nécessaires" [533-1094] -->
46 <h2 class="sectionedit1344"><a name="etape_1ouvrir_un_fichier_de_formulaire_tragesym" id="etape_1ouvrir_un_fichier_de_formulaire_tragesym">Étape 1: Ouvrir un fichier de formulaire tragesym</a></h2>
47 <div class="level2">
49 <p>
51 tragesym est fourni avec deux fichiers de formulaires. L&#039;un est en <a href="media/tragesym/template.txt" class="media" target="_blank" title="tragesym:template.txt">texte ASCII</a>, le second est une <a href="media/tragesym/template.ods" class="media" target="_blank" title="tragesym:template.ods">feuille de calcul OpenOffice</a>. Vous pouvez aussi les obtenir depuis le paquet d&#039;utilitaires gEDA (utils/examples/tragesym/template.src et utils/examples/tragesym/template.ods).
52 Si vous préférez un tableur différent, comme gnumeric ou kspread, créez simplement votre propre fichier formulaire texte à partir de celui qui est fourni. La seule différence entre les formulaires texte et calcul est la syntaxe des valeurs dans les sections [options] et [geda_attr]. Le fichier texte les sépare avec un signe (clé=valeur), la feuille de calcul obtient la valeur dans la seconde colonne (qui devient une tabulation après avoir été exportée).
53 </p>
55 </div>
56 <!-- EDIT1344 SECTION "Étape 1: Ouvrir un fichier de formulaire tragesym" [1095-1958] -->
57 <h2 class="sectionedit1345"><a name="etape_2telecharger_le_fichier_technique_du_composant_et_trouver_la_liste_des_broches" id="etape_2telecharger_le_fichier_technique_du_composant_et_trouver_la_liste_des_broches">Étape 2: Télécharger le fichier technique du composant et trouver la liste des broches</a></h2>
58 <div class="level2">
60 <p>
62 Pour cet exemple, nous allons créer un symbole avec les ports IO du PCA9555 16-bit IIC IO de Philips
63 Semiconductor. La description du produit et la fiche technique sont disponibles sur Philips :
64 [<a href="http://www-us.semiconductors.philips.com/cgi-bin/pldb/pip/pca9555.html" class="urlextern" title="http://www-us.semiconductors.philips.com/cgi-bin/pldb/pip/pca9555.html" rel="nofollow">http://www-us.semiconductors.philips.com/cgi-bin/pldb/pip/pca9555.html</a>]. Téléchargez la fiche technique et ouvrez-la avec un visualiseur pdf qui permet la copie du texte à l&#039;extérieur du <acronym title="Portable Document Format">PDF</acronym>, tel que xpdf (téléchargeable sur [<a href="http://www.foolabs.com/xpdf/home.html" class="urlextern" title="http://www.foolabs.com/xpdf/home.html" rel="nofollow">http://www.foolabs.com/xpdf/home.html</a>]). Passez les pages jusqu&#039;à ce que vous ayez trouvé le brochage ou le composant·:
65 </p>
67 <p>
68 <a href="media/tragesym/kpdf_pinconfiguration.png" class="media" target="_blank" title="tragesym:kpdf_pinconfiguration.png"><img src="media/tragesym/kpdf_pinconfiguration.png" class="media" alt="" /></a> <a href="media/tragesym/acroread_selectiontable.png" class="media" target="_blank" title="tragesym:acroread_selectiontable.png"><img src="media/tragesym/acroread_selectiontable.png" class="media" alt="" /></a>
69 </p>
71 <p>
72 Dans la feuille de calcul, la liste des broches peut être seulement présente dans le dessin du boîtier. S&#039;il existe une belle table, comme dans la second image, d&#039;un autre fichie technique, utilisez-la.
73 </p>
75 </div>
76 <!-- EDIT1345 SECTION "Étape 2: Télécharger le fichier technique du composant et trouver la liste des broches" [1959-2906] -->
77 <h2 class="sectionedit1346"><a name="etape_3copier_la_liste_des_broches_dans_un_editeur_et_la_preparer" id="etape_3copier_la_liste_des_broches_dans_un_editeur_et_la_preparer">Étape 3: Copier la liste des broches dans un éditeur et la préparer</a></h2>
78 <div class="level2">
80 <p>
82 Sélectionnez la liste des broches et copiez-la dans un éditeur de texte. C&#039;est une étape intermédiaire nécessaire car votre tableur a besoin de champs séparateurs spéciaux, comme les virgules ou les tabulations. Vous pouvez avoir à enlever les séparateurs en double ou de les remplacer avec des tabulations.
83 </p>
85 <p>
86 <strong>Note:</strong> Le comportement lors de la sélection de kpdf est différent de celui de acroread. kpdf semble vous donner une copie qui ressemble plus à une présentation graphique, alors que acroread fournit une sortie qui est plus «·orientée fichier·». Si vous devez créer beaucoup de symboles, testez les deux et comparez les résultats (NdT: xpdf semble fonctionner très bien au 04/12/2006 et reste très léger).
87 </p>
89 <p>
90 <a href="media/tragesym/xemacs_rawselection.png" class="media" target="_blank" title="tragesym:xemacs_rawselection.png"><img src="media/tragesym/xemacs_rawselection.png" class="media" alt="" /></a> <a href="media/tragesym/xemacs_modifiedselection.png" class="media" target="_blank" title="tragesym:xemacs_modifiedselection.png"><img src="media/tragesym/xemacs_modifiedselection.png" class="media" alt="" /></a> <a href="media/tragesym/ooo_selection.png" class="media" target="_blank" title="tragesym:ooo_selection.png"><img src="media/tragesym/ooo_selection.png" class="media" alt="" /></a>
91 </p>
93 <p>
94 L&#039;image ci-dessus illustre les étapes·:
95 </p>
96 <ul>
97 <li class="level1"><div class="li"> insérez la sélection depuis votre visualiseur pdf vers un éditeur de texte</div>
98 </li>
99 <li class="level1"><div class="li"> modifiez la liste des broches pour rendre votre tableur heureux </div>
100 <ul>
101 <li class="level2"><div class="li"> coupez la liste de 24 à 13 avec la sélection rectangulaire</div>
102 </li>
103 <li class="level2"><div class="li"> insérez la sélection rectangulaire sous les broches 1 à 12</div>
104 </li>
105 <li class="level2"><div class="li"> triez les lignes (xemacs peut le faire <img src="images/smileys/icon_wink.gif" align="middle" alt=";-)" />)</div>
106 </li>
107 <li class="level2"><div class="li"> enlevez ou réparez les lignes avec les numéros 2,3,… Ils ne sont pas sur la même ligne. Vous pouvez facilement recréer les numéros de broche plus tard</div>
108 </li>
109 <li class="level2"><div class="li"> remplacez les espaces avec des tabulations (pas réellement nécessaire en utilisant OpenOffice)</div>
110 </li>
111 </ul>
112 </li>
113 <li class="level1"><div class="li"> copiez les données modifiées dans le formulaire feuille de calcul quelque part en dessous</div>
114 </li>
115 </ul>
117 </div>
118 <!-- EDIT1346 SECTION "Étape 3: Copier la liste des broches dans un éditeur et la préparer" [2907-4587] -->
119 <h2 class="sectionedit1347"><a name="etape_4inserer_toutes_les_donnees_manquantes_dans_la_feuille_de_calcul" id="etape_4inserer_toutes_les_donnees_manquantes_dans_la_feuille_de_calcul">Étape 4: Insérer toutes les données manquantes dans la feuille de calcul</a></h2>
120 <div class="level2">
124 Déplacez maintenant les étiquettes et les numéros de broches dans leurs colonnes respectives. Vous pouvez aussi utiliser la fonctionnalité d&#039;autoremplissage de votre tableur pour créer les numéros de broche.
125 </p>
128 <a href="media/tragesym/ooo_rearanged.png" class="media" target="_blank" title="tragesym:ooo_rearanged.png"><img src="media/tragesym/ooo_rearanged.png" class="media" alt="" /></a>
129 </p>
132 Remplissez les colonens de type, de style et de position aux valeurs les plus habituelles. Vous pouvez à nouveau utiliser la fonctionnalité d&#039;autoremplissage
133 Maintenant vous allez changer quelques unes de ces valeurs. Jetez un coup d&#039;oeil sur le tableau descriptif de la fiche technique:
134 </p>
137 <a href="media/tragesym/kpdf_pindescription.png" class="media" target="_blank" title="tragesym:kpdf_pindescription.png"><img src="media/tragesym/kpdf_pindescription.png" class="media" alt="" /></a>
138 </p>
141 Selon ce tableau, nous changeons les éléments suivants (voir le résultat ci-dessus):
142 </p>
143 <ul>
144 <li class="level1"><div class="li"> La broche 1 est une sortie, nous voudrions avoir un rond d&#039;inversion (NdT: trad à revoir) et une barre de négation</div>
145 </li>
146 <li class="level1"><div class="li"> A1 à A3 sont des entrées, nous changeons le type et les déplaçons sur le côté gauche</div>
147 </li>
148 <li class="level1"><div class="li"> mettez le type de SCL en entrée et déplacez aussi SCL et SDA sur le côté gauche </div>
149 </li>
150 <li class="level1"><div class="li"> changez le type des broches d&#039;alimentations VSS et VDD et ajoutez des noms de net. Nous utilisons les habituels GND et Vcc.</div>
151 </li>
152 </ul>
156 <strong>Note:</strong> Si une de vos étiquettes contient un backslash «·\·», vous devez le remplacer par sa séquence d&#039;échapement «·\\·».
157 </p>
160 <a href="media/tragesym/ooo_changedpins.png" class="media" target="_blank" title="tragesym:ooo_changedpins.png"><img src="media/tragesym/ooo_changedpins.png" class="media" alt="" /></a>
161 </p>
164 Avant de configurer les attributs et les options aux valeurs appropriées.
165 </p>
168 <a href="media/tragesym/ooo_attributes.png" class="media" target="_blank" title="tragesym:ooo_attributes.png"><img src="media/tragesym/ooo_attributes.png" class="media" alt="" /></a>
169 </p>
171 </div>
172 <!-- EDIT1347 SECTION "Étape 4: Insérer toutes les données manquantes dans la feuille de calcul" [4588-6061] -->
173 <h2 class="sectionedit1348"><a name="etape_5exporter_la_feuille_de_calcul_dans_un_fichier_texte_avec_separation_par_tabulation" id="etape_5exporter_la_feuille_de_calcul_dans_un_fichier_texte_avec_separation_par_tabulation">Étape 5: Exporter la feuille de calcul dans un fichier texte avec séparation par tabulation</a></h2>
174 <div class="level2">
178 Vous pouvez soit utiliser le fonction export de votre tableur pour créer un fichier texte délimité par des tabulations ou simplement sélectionner le tableau et copier son contenu dans votre éditeur de texte et sauvegarder le fichier.
179 </p>
181 </div>
182 <!-- EDIT1348 SECTION "Étape 5: Exporter la feuille de calcul dans un fichier texte avec séparation par tabulation" [6062-6409] -->
183 <h2 class="sectionedit1349"><a name="etape_6lancer_tragesym_et_creer_le_symbole" id="etape_6lancer_tragesym_et_creer_le_symbole">Étape 6: Lancer tragesym et créer le symbole</a></h2>
184 <div class="level2">
188 Utilisez un shell et exécutez tragesym:
189 </p>
192 <code>werner@werner-amd64:~/Desktop/tragesym_tutorial&gt; tragesym pca555.src pca555.sch</code>
193 </p>
196 Si tragesym indique qu&#039;il y a une erreur, faites quelques changements dans la feuille de calcul et exportez à nouveau le fichier ou éditez simplement le fichier exporté.
197 </p>
199 </div>
200 <!-- EDIT1349 SECTION "Étape 6: Lancer tragesym et créer le symbole" [6410-6771] -->
201 <h2 class="sectionedit1350"><a name="etape_7controler_le_resultat_avec_gschem_et_peaufiner_le_symbole" id="etape_7controler_le_resultat_avec_gschem_et_peaufiner_le_symbole">Étape 7: Contrôler le résultat avec gschem et peaufiner le symbole</a></h2>
202 <div class="level2">
206 Ouvrez maintenant le symbole généré avec et contrôlez le résultat
207 </p>
210 <code>werner@werner-amd64:~/Desktop/tragesym_tutorial&gt; gschem pca555.sch</code>
211 </p>
214 En validant le texte caché («·en·», Edit→Show/Hide Inv Text), vous pouvez voir le symbole généré en entier. Il n&#039;est pas réellement nécessaire de changer quoi que ce soit mais cela peut améliorer l&#039;aspect du symbole si vous réarrangez un peu les broches.
215 </p>
218 <a href="media/tragesym/gschem_showhidden.png" class="media" target="_blank" title="tragesym:gschem_showhidden.png"><img src="media/tragesym/gschem_showhidden.png" class="media" alt="" /></a> <a href="media/tragesym/gschem_finished.png" class="media" target="_blank" title="tragesym:gschem_finished.png"><img src="media/tragesym/gschem_finished.png" class="media" alt="" /></a>
219 </p>
222 Nous avons maintenant un symbole complet. Vous pouvez le copier dans votre bibliothèque locale de symboles, e.g. /usr/local/share/gEDA/sym/local/ et l&#039;utiliser.
223 </p>
225 </div>
226 <!-- EDIT1350 SECTION "Étape 7: Contrôler le résultat avec gschem et peaufiner le symbole" [6772-7503] -->
227 <h2 class="sectionedit1351"><a name="conclusion" id="conclusion">Conclusion</a></h2>
228 <div class="level2">
232 C&#039;était un exemple simple avec peu de broches mais cela est d&#039;autant plus rentable lorsque vous en avez beaucoup (ie, bga-272, tfqp-100, etc.).
233 </p>
235 </div>
236 <!-- EDIT1351 SECTION "Conclusion" [7504-7673] -->
237 <h2 class="sectionedit1352"><a name="credits" id="credits">Crédits</a></h2>
238 <div class="level2">
242 De grands remerciements à &lt;Russ.Dill(AT)asu.edu&gt;, qui a écrti la première version de ce tutoriel.
243 Vous pouvez trouver ce tutoriel sur <a href="http://www.geda.seul.org/docs/current/tutorials/tragesym/tragesym.html" class="urlextern" title="http://www.geda.seul.org/docs/current/tutorials/tragesym/tragesym.html" rel="nofollow">http://www.geda.seul.org/docs/current/tutorials/tragesym/tragesym.html</a> (version anglaise)
244 </p>
247 NdT·: si vous voulez la version française: <a href="http://www.iznogood-factory.org/pub/gEDA/symboles.html" class="urlextern" title="http://www.iznogood-factory.org/pub/gEDA/symboles.html" rel="nofollow">http://www.iznogood-factory.org/pub/gEDA/symboles.html</a>
249 </p>
251 </div>
252 <!-- EDIT1352 SECTION "Crédits" [7674-] --></body>
253 </html>