User Tools

Site Tools


geda:tragesym_tutorial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
geda:tragesym_tutorial [2012/04/19 05:37]
vzh Replaced a broken link
geda:tragesym_tutorial [2014/04/18 08:28] (current)
vzh Add links to translations
Line 1: Line 1:
 +//​Translations of this page are also available in the following languages://​ [[tragesym_tutorial.fr|Français]],​ [[tragesym_tutorial.ru|Русский]].
 +
 ====== Creating gschem symbols quickly and easily using tragesym and a spreadsheet program ====== ====== Creating gschem symbols quickly and easily using tragesym and a spreadsheet program ======
  
Line 21: Line 23:
 ===== Step2: Download the part data sheet and find the pin list ===== ===== Step2: Download the part data sheet and find the pin list =====
  
-For this example, we will create a symbol from the Philips Semiconductor PCA9555 16-bit IIC IO port. The description of product and datasheet is available at Philips: ​ [[http://​www-us.semiconductors.philips.com/​cgi-bin/​pldb/​pip/​pca9555.html]]. Download the datasheet and open it with a pdf viewer that allows copying text out of the pdf file, such as kpdf or acroread. Flip through the pages until you find the pinout for the device: ​+For this example, we will create a symbol from the Philips Semiconductor PCA9555 16-bit IIC IO port. The description of product and datasheet is available at Philips: ​ [[http://​www-us.semiconductors.philips.com/​cgi-bin/​pldb/​pip/​pca9555.html]]. Download the datasheet and open it with a pdf viewer that allows copying text out of the pdf file, such as kpdf or acroread. Flip through the pages until you find the pinout for the device:
  
 {{:​tragesym:​kpdf_pinconfiguration.png}} {{:​tragesym:​acroread_selectiontable.png}} {{:​tragesym:​kpdf_pinconfiguration.png}} {{:​tragesym:​acroread_selectiontable.png}}
Line 28: Line 30:
  
 ===== Step3: Copy the pin list into an editor and prepare it ===== ===== Step3: Copy the pin list into an editor and prepare it =====
-Select the pin list and copy it into a text editor. This intermediate step is required as your spreadsheet program may need a special field separator, like comma or tab. You may have to remove duplicate separators or replace it with tabs. +Select the pin list and copy it into a text editor. This intermediate step is required as your spreadsheet program may need a special field separator, like comma or tab. You may have to remove duplicate separators or replace it with tabs.
  
 **Note:** The selection behaviour of kpdf is different from the acroread viewer. The kpdf viewer seems to give you a copy that looks more like the graphical representation,​ while the acroread viewer produces an output that is more "file order" oriented. If you have to create a lot of symbols, try both and compare the results. **Note:** The selection behaviour of kpdf is different from the acroread viewer. The kpdf viewer seems to give you a copy that looks more like the graphical representation,​ while the acroread viewer produces an output that is more "file order" oriented. If you have to create a lot of symbols, try both and compare the results.
Line 34: Line 36:
 {{:​tragesym:​xemacs_rawselection.png}} {{:​tragesym:​xemacs_modifiedselection.png}} {{:​tragesym:​ooo_selection.png}} {{:​tragesym:​xemacs_rawselection.png}} {{:​tragesym:​xemacs_modifiedselection.png}} {{:​tragesym:​ooo_selection.png}}
  
-The pictures above illustrate the steps: ​+The pictures above illustrate the steps:
   * insert the selection from your pdf viewer into a text editor   * insert the selection from your pdf viewer into a text editor
-  * modify the pinlist to make your spreadsheet program happy +  * modify the pinlist to make your spreadsheet program happy
     * cut out pinlist 24 to 13 with a rectangular selection     * cut out pinlist 24 to 13 with a rectangular selection
     * insert the rectangular selection below the pins 1 to 12     * insert the rectangular selection below the pins 1 to 12
Line 56: Line 58:
 {{:​tragesym:​kpdf_pindescription.png}} {{:​tragesym:​kpdf_pindescription.png}}
  
-Regarding to that table we change the following things (see result below): ​+Regarding to that table we change the following things (see result below):
   * Pin 1 is an output, we like to have a negation bubble and a negation overbar   * Pin 1 is an output, we like to have a negation bubble and a negation overbar
   * A1 to A3 are inputs, we change the type and move them to the left side   * A1 to A3 are inputs, we change the type and move them to the left side
-  * set the SCL type to input and move SCL and SDA to the left side, too +  * set the SCL type to input and move SCL and SDA to the left side, too
   * change the type of the power pins VSS and VDD and add net names. We use the more usual GND and Vcc.   * change the type of the power pins VSS and VDD and add net names. We use the more usual GND and Vcc.
  
Line 76: Line 78:
  
 ===== Step6: execute tragesym and create the symbol ===== ===== Step6: execute tragesym and create the symbol =====
-Use a shell and execute tragesym: ​+Use a shell and execute tragesym:
  
 ''​werner@werner-amd64:​~/​Desktop/​tragesym_tutorial>​ tragesym pca555.src pca555.sch''​ ''​werner@werner-amd64:​~/​Desktop/​tragesym_tutorial>​ tragesym pca555.src pca555.sch''​
Line 84: Line 86:
 ===== Step7: check the result with gschem and do some artwork ===== ===== Step7: check the result with gschem and do some artwork =====
  
-Now open the generated symbol with gschem and check the result ​+Now open the generated symbol with gschem and check the result
  
-''​werner@werner-amd64:​~/​Desktop/​tragesym_tutorial>​ gschem pca555.sch'' ​+''​werner@werner-amd64:​~/​Desktop/​tragesym_tutorial>​ gschem pca555.sch''​
  
 Enabling the hidden text ("​en",​ Edit->​Show/​Hide Inv Text), you can see the whole generated symbol. It's not really necessary to change anything, but it might improve the look of the symbol if you rearrange the pins a little bit. Enabling the hidden text ("​en",​ Edit->​Show/​Hide Inv Text), you can see the whole generated symbol. It's not really necessary to change anything, but it might improve the look of the symbol if you rearrange the pins a little bit.
geda/tragesym_tutorial.txt · Last modified: 2014/04/18 08:28 by vzh