User Tools

Site Tools


geda:pcb-quick_reference

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
geda:pcb-quick_reference [2012/06/29 03:54]
vzh Footnote
geda:pcb-quick_reference [2016/02/10 17:50]
ptay [Examples] added three more examples
Line 1: Line 1:
 +//​Translations of this page are also available in the following languages://​ [[pcb-quick_reference.fr|Français]],​ [[pcb-quick_reference.ru|Русский]].
 +
 ====== PCB: Quick Reference ====== ====== PCB: Quick Reference ======
 +
 +===== Additional information =====
 +More information on PCB you can find in the PCB Command reference
 +(//''​refcard.pdf''//​) containing description of all PCB shortcuts
 +and in the PCB Manual (//''​pcb.pdf''//​ or //''​pcb.html''//​)
 +residing in the //''​doc/''//​ directory of your PCB installation
 +(its path may vary on various systems).
 +
  
 ===== Default Key Mapping ===== ===== Default Key Mapping =====
Line 69: Line 79:
 |            <​key>​v</​key>​ | view extents ​      | global view of working area  | |            <​key>​v</​key>​ | view extents ​      | global view of working area  |
 |          <​key>​S-v</​key>​ | via tool dia       | increase the diameter of new vias by 5 mil  | |          <​key>​S-v</​key>​ | via tool dia       | increase the diameter of new vias by 5 mil  |
 +|          <​key>​C-v</​key>​ | paste buffer ​      | paste from buffer |
 |        <​key>​C-S-v</​key>​ | via tool dia (-)   | decrease the diameter of new vias by 5 mil  | |        <​key>​C-S-v</​key>​ | via tool dia (-)   | decrease the diameter of new vias by 5 mil  |
 |          <​key>​A-v</​key>​ | via tool drill     | increase the drill diameter of new vias by 5 mil  | |          <​key>​A-v</​key>​ | via tool drill     | increase the drill diameter of new vias by 5 mil  |
 |        <​key>​S-A-v</​key>​ | via tool drill (-) | decrease the drill diameter of new vias by 5 mil  | |        <​key>​S-A-v</​key>​ | via tool drill (-) | decrease the drill diameter of new vias by 5 mil  |
 +|          <​key>​C-x</​key>​ | cut to buffer ​     | cut selection to buffer |
 |            <​key>​z</​key>​ | zoom               | view: zoom in  | |            <​key>​z</​key>​ | zoom               | view: zoom in  |
 |          <​key>​S-z</​key>​ | un-zoom ​           | view: zoom out  | |          <​key>​S-z</​key>​ | un-zoom ​           | view: zoom out  |
Line 101: Line 113:
 ==== Layers ==== ==== Layers ====
 ^  Key                                   ​^ ​ Mnemonic ​ ^ Description ​ ^ ^  Key                                   ​^ ​ Mnemonic ​ ^ Description ​ ^
-|  <​key>​1</​key>​ to <​key>​9</​key> ​         | - | select layers 1 to 9  | +|  <​key>​1</​key>​ to <​key>​9</​key> ​         |   | select layers 1 to 9  | 
-|  <​key>​0</​key> ​                         | - | select layer 10<​sup>​*</​sup> ​ | +|  <​key>​0</​key> ​                         |   | select layer 10<​sup>​*</​sup> ​ | 
-|  <​key>​A-1</​key>​ to <​key>​A-9</​key> ​     | - | select layers 11 to 19<​sup>​*</​sup> ​ | +|  <​key>​A-1</​key>​ to <​key>​A-9</​key> ​     |   | select layers 11 to 19<​sup>​*</​sup> ​ | 
-|  <​key>​A-0</​key> ​                       | - | select layer 20<​sup>​*</​sup> ​ | +|  <​key>​A-0</​key> ​                       |   | select layer 20<​sup>​*</​sup> ​ | 
-|  <​key>​C-1</​key>​ to <​key>​C-9</​key> ​     | - | toggle visibility of layers 1 to 9<​sup>​*</​sup> ​ | +|  <​key>​C-1</​key>​ to <​key>​C-9</​key> ​     |   | toggle visibility of layers 1 to 9<​sup>​*</​sup> ​ | 
-|  <​key>​C-0</​key> ​                       | - | toggle visibility of layer 10<​sup>​*</​sup> ​ | +|  <​key>​C-0</​key> ​                       |   | toggle visibility of layer 10<​sup>​*</​sup> ​ | 
-|  <​key>​C-A-1</​key>​ to <​key>​C-A-9</​key> ​ | - | toggle visibility of 11 to 19<​sup>​*</​sup> ​ | +|  <​key>​C-A-1</​key>​ to <​key>​C-A-9</​key> ​ |   | toggle visibility of 11 to 19<​sup>​*</​sup> ​ | 
-|  <​key>​C-A-0</​key> ​                     | - | toggle visibility of 20<​sup>​*</​sup> ​ |+|  <​key>​C-A-0</​key> ​                     |   | toggle visibility of 20<​sup>​*</​sup> ​ |
 <​sup>​*</​sup>​ <​sub>​These accels are available in PCB, GTK GUI in versions after August 2011</​sub>​ <​sup>​*</​sup>​ <​sub>​These accels are available in PCB, GTK GUI in versions after August 2011</​sub>​
-====== Footprint Reference ======+====== Footprint ​Quick Reference ======
 The Master document for footprint creation is the [[http://​pcb.geda-project.org/​manual.html|PCB Manual]]. There is also Stuart Brorson’s [[http://​www.brorson.com/​gEDA/​land_patterns_20050129.pdf|Footprint Creation for the Open-Source Layout Program PCB]]. The Master document for footprint creation is the [[http://​pcb.geda-project.org/​manual.html|PCB Manual]]. There is also Stuart Brorson’s [[http://​www.brorson.com/​gEDA/​land_patterns_20050129.pdf|Footprint Creation for the Open-Source Layout Program PCB]].
  
 ===== General syntax ===== ===== General syntax =====
 A pcb footprint file may contain any of the following commands: A pcb footprint file may contain any of the following commands:
-  * **''​Element [element_flags,​ description, ​pcb-name, value, mark_x, mark_y, text_x, text_y, text_direction,​ text_scale, text_flags]''​**+  * **''​Element [element_flags,​ description, ​pcb_name, value, mark_x, mark_y, text_x, text_y, text_direction,​ text_scale, text_flags]''​**
   * **''​Pad [x1 y1 x2 y2 thickness clearance mask name pad_number flags]''​**   * **''​Pad [x1 y1 x2 y2 thickness clearance mask name pad_number flags]''​**
   * **''​Pin [x y thickness clearance mask drillholedia name number flags]''​**   * **''​Pin [x y thickness clearance mask drillholedia name number flags]''​**
Line 121: Line 133:
   * **''​ElementLine [x1 y1 x2 y2 thickness] –> thickness != 1000 = 10 mils almost for all footprints''​**   * **''​ElementLine [x1 y1 x2 y2 thickness] –> thickness != 1000 = 10 mils almost for all footprints''​**
   * Comment lines start with the ‘**''#''​**’-sign   * Comment lines start with the ‘**''#''​**’-sign
 +
 +===== PCB Units =====
 +PCB handles metric and imperial units in the following way:
 +       * The base Imperial unit is the "​centimil",​ or 1/100 of a thousandth, or 1/100,000 inch, or 0.00001 inch.
 +       * Allowable imperial value range: ​ "​0.04"​ (0.0000004 inches) to approx. "​78740000"​ (about 78-3/​4"​)
 +       * The base Metric unit is 1nm (one nanometer). ​ PCB parses in metric if the number has a "​mm"​ behind it.
 +       * Allowable metric value range: ​ "​0.000001mm"​ to "​2000mm"​
 +       * NOTES:
 +         * use "​mm"​ after number to specify metric
 +         * imperial and metric may be mixed within a footprint (!)
  
 ===== Elements ===== ===== Elements =====
-**''​Element [element_flags,​ description, ​pcb-name, value, mark_x, mark_y, text_x, text_y, text_direction,​ text_scale, text_flags]''​**+**''​Element [element_flags,​ description, ​pcb_name, value, mark_x, mark_y, text_x, text_y, text_direction,​ text_scale, text_flags]''​**
  
- ​item  ​^  ​allowed ​value  ^  explanation ​ ^  comment ​ ^+   ^  ​Allowed ​value (unit = 1e-5 inches) ^  Allowed Value (mm)  ​^ ​ explanation ​ ^  comment ​ ^
 |  element_flags ​ |  unsigned hex value  |  |  | |  element_flags ​ |  unsigned hex value  |  |  |
-|  description ​ |  string ​ |  text description of footprint ​ |written by footprint author ​ | +|  description ​ |  string ​ ​| ​ ​| ​ text description of footprint ​ |  ​user-defined ​ | 
-|  ​pcb name  ​| ​ string ​ |  ​refdes used on this particular pcb  |xxx  | +|  ​pcb_name ​ ​| ​ string ​ |  ​ generic refdes (R?, U? etc.) |  ​user-defined ​  
-|  value  |  string ​ |  ​value of component ​on this particular pcb layout ​ |xxx  | +|  value  |  string ​ |  ​|  ​component ​value (layout ​specific) ​ ​| ​ ​user-defined (blank) ​ | 
-|  mark_x ​ |  1/100th mils  ​| ​ |  | +|  mark_x ​ |  ​"1" to ~ "​78740000" ​ ​| ​ "​0.000001mm"​ to "​2000mm" ​ |  (x,y) loc. of center mark  ​| ​ | 
-|  mark_y ​ |  1/100th mils  ​| ​ |  | +|  mark_y ​ |  ​"1" to ~ "​78740000" ​ |  "​0.000001mm"​ to "​2000mm" ​ ​| ​ |  | 
-|  text_x ​ |  1/100th mils  ​| ​ |  | +|  text_x ​ |  ​"1" to ~ "​78740000" ​ ​| ​ "​0.000001mm"​ to "​2000mm" ​ |  (x,y) loc. of REFDES ​ ​| ​ | 
-|  text_y ​ |  1/100th mils  ​| ​ |  | +|  text_y ​ |  ​"1" to ~ "​78740000" ​ |  "​0.000001mm"​ to "​2000mm" ​ ​| ​ |  | 
-|  ​text direction ​ ​| ​ decimal integer ​ |  0=horiz; 1=ccw90; 2=180; 3=cw90 ​ |  | +|  ​text_direction ​ ​| ​ decimal integer ​ ​| ​ ​| ​ 0=horiz; 1=ccw90; 2=180; 3=cw90 ​ |  | 
-|  text_scale ​ |  decimal integer ​ |  |usu. set 100  | +|  text_scale ​ |  decimal integer ​ |  |  ​|  ​usu. set to 100  | 
-|  text_flags ​ |  unsigned hex  |  |  |+|  text_flags ​ |  unsigned hex  ​| ​ ​| ​ |  |
  
 ===== Pads ===== ===== Pads =====
Line 149: Line 171:
 |  clearance ​ |  1/100 mils  |  distance to any other copper on any layer  |actually 1/2 of this number is used!  | |  clearance ​ |  1/100 mils  |  distance to any other copper on any layer  |actually 1/2 of this number is used!  |
 |  mask  |  1/100th mils  |  width of mask relief ​ |actual width of the mask centered on pad copper ​ | |  mask  |  1/100th mils  |  width of mask relief ​ |actual width of the mask centered on pad copper ​ |
-|  name  |  string ​ |  name of pad (arb. string) ​ |e.g. pad_1” or positive” or any other string ​ |+|  name  |  string ​ |  name of pad (arb. string) ​ |e.g. %%"pad_1"​%% ​or %%"positive"​%% ​or any other string ​ |
 |  pad_number ​ |  string ​ |  pad #  | used for nets. it MUST be consistent with the definitions on the netlist. ​ | |  pad_number ​ |  string ​ |  pad #  | used for nets. it MUST be consistent with the definitions on the netlist. ​ |
 |  flags  |  hex or string ​ |   | examples: ​ | |  flags  |  hex or string ​ |   | examples: ​ |
Line 168: Line 190:
  
 ===== Examples ===== ===== Examples =====
-  * **''​Pad[-24606 14760 -19538 14760 1181 2000 3181 “” “16” “square]''​** +  * **''​%%Pad[-24606 14760 -19538 14760 1181 2000 3181 ""​ "16" "square"]%%''​** 
-  * **''​Pad[-14760 19538 -14760 24606 1181 2000 3181 “” “17” “square,​edge2]''​** +  * **''​%%Pad[-14760 19538 -14760 24606 1181 2000 3181 ""​ "17" "square,​edge2"]%%''​** 
-  * **''​Pin[0 0 12000 2000 12500 6400 “” “1” 0×00000001]''​** +  * **''​%%Pad[-240.00mil 0.0000 -80.00mil 0.0000 40.00mil 20.00mil 46.00mil "​2"​ "​2"​ "​onsolder,​square"​]%%''​** 
-  * **''​ElementArc [0 0 6800 6800 0 360 1000]''​** +  * **''​%%Pad[80.00mil 0.0000 240.00mil 0.0000 40.00mil 20.00mil 46.00mil "​1"​ "​1"​ "​onsolder,​square,​edge2"​]%%''​** 
-  * **''​ElementLine [-26696 -26696 26696 -26696 1000]''​** +  * **''​%%Pin[0 0 12000 2000 12500 6400 ""​ "1" ​0×00000001]%%''​** 
-  * **''#​ notes within PCB Footprints go after the pound sign''​**+  * **''​%%Pin[0 0 11500 11800 35000 12500 ""​ "​1"​ 0x08]%%''​** ​                 <-- unplated / nonplated hole 
 +  * **''​%%ElementArc [0 0 6800 6800 0 360 1000]%%''​** 
 +  * **''​%%ElementLine [-26696 -26696 26696 -26696 1000]%%''​** 
 +  * **''​%%# notes within PCB Footprints go after the pound sign%%''​**
  
  
geda/pcb-quick_reference.txt · Last modified: 2016/02/18 13:04 by ptay