Downloaded and integrated latest wiki documentation from the geda website.
[geda-gaf/peter-b.git] / docs / wiki / geda_gschem2pcb_readme.html
blob5c7d4e251c774d6ba90af9de1a78a1fd47398ebe
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
4 lang="en" dir="ltr">
5 <head>
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7 <title>geda:gschem2pcb_readme</title>
8 <meta name="generator" content="DokuWiki Release rc2007-05-24" />
9 <meta name="robots" content="index,follow" />
10 <meta name="date" content="2007-05-24T22:27:24-0400" />
11 <meta name="keywords" content="geda,gschem2pcb_readme" />
12 <link rel="search" type="application/opensearchdescription+xml" href="http://geda.seul.org/wiki/lib/exe/opensearch.php" title="geda Wiki" />
13 <link rel="start" href="http://geda.seul.org/wiki/" />
14 <link rel="contents" href="http://geda.seul.org/wiki/geda:gschem2pcb_readme?do=index" title="Index" />
15 <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="http://geda.seul.org/wiki/feed.php" />
16 <link rel="alternate" type="application/rss+xml" title="Current Namespace" href="http://geda.seul.org/wiki/feed.php?mode=list&ns=geda" />
17 <link rel="alternate" type="text/html" title="Plain HTML" href="http://geda.seul.org/wiki/_export/xhtml/geda:gschem2pcb_readme" />
18 <link rel="alternate" type="text/plain" title="Wiki Markup" href="http://geda.seul.org/wiki/_export/raw/geda:gschem2pcb_readme" />
19 <link rel="stylesheet" media="all" type="text/css" href="lib/exe/css" />
20 <link rel="stylesheet" media="screen" type="text/css" href="lib/exe/001css" />
21 <link rel="stylesheet" media="print" type="text/css" href="lib/exe/002css" />
22 </head>
23 <body>
24 <div class="dokuwiki export">
28 <h1><a name="gschem2pcb_readme" id="gschem2pcb_readme">gschem2pcb README</a></h1>
29 <div class="level1">
30 <pre class="code">------------------------------------------------------------------
31 JM Routoure. routoure@greyc.ismra.fr
32 17/01/2000
34 I would like to thank Stefan Petersen for debuging the scheme program.
36 -------------------------------------------------------------------
39 This document describes how to install (section I) and use (section II) the
40 gschem2pcb package. Section III describes some of the footprints
41 available in pcb
43 The purpose of this package is to interface gschem with pcb. It uses a scheme
44 program and a script.
47 Section I : Installation.
49 1. Untar the gschem2pcb.tar. You must obtain 3 files gschem2pcb.sh,
50 GNET-PCBboard.scm and the README file.
52 2. Move gschem2pcb.sh in a directory which is in your PATH (/usr/local/bin for
53 instance ). Be sure that gschem2pcb.sh can be executed (chmod 755 gschem2pcb.sh)
55 3. Move GNET-PCBboard.scm in the share directory of your gEDA distribution.
56 Normally, it should be /usr/local/share/gEDA/scheme.
58 4. Modify the common.m4 file of the pcb program (should be found in
59 /usr/X11R6/lib/X11/pcb/m4/) like this : the include keywords at the end of the
60 file must be replace by
62 include(/usr/X11R6/lib/X11/pcb/m4/connector.inc)
63 include(/usr/X11R6/lib/X11/pcb/m4/dil.inc)
64 include(/usr/X11R6/lib/X11/pcb/m4/misc.inc)
65 include(/usr/X11R6/lib/X11/pcb/m4/plcc.inc)
66 include(/usr/X11R6/lib/X11/pcb/m4/to.inc)
67 include(/usr/X11R6/lib/X11/pcb/m4/qfp.inc)
69 5. Edit the ~/.gEDA/gschemrc file and be sure that the following line exists :
70 (attribute-name &quot;footprint&quot;)
73 6. Be sure that grep, sed and gawk are installed. That&#039;s all..
76 Section II : using gschem2pcb.
78 1. With gschem, create a schematic. All the device you want to have in pcb must
79 have a Uref attribute. The footprint that you want to use in pcb are indicated
80 by the footprint attribute (see section III for the description of the footprint
81 in pcb)
83 Be careful that the attributes Uref, name, value and device must not contain
84 space char.
85 --------------------------------------------------------
87 2. Save your work (ultralownoise.sch for instance -ambitious design!) and type in a shell
89 gschem2pcb.sh ultralownoise.sch.
91 note : the gschem file must end by .sch
93 Error messages will appear if some space characters are found in the
94 attributes Uref, name, value and device and if the name of the footprint was not
95 found. Warning, pcb files are created even if errors occur!
97 - if ultralownoise.pcb does not exist, it will be created. A netlist file
98 ultralownoise.net will also be created. In pcb, load the pcb (load layout). All
99 the footprints will appears at the top-left corner of the windows. Load the
100 netlist (load netlist file) and type the key &quot;w&quot;. Place the footprints and type
101 &quot;o&quot; to optimize the rastnet. See the pcb documentation for details.
103 - if ultralownoise.pcb exists, a ultralownoise.new.pcb file should be
104 created. It should contain only the new device that have been added in the
105 schematic since the last save of the ultralownoise.pcb file. Use &quot;load layout
106 data to paste buffer&quot; to include the new footprints in the pcb file. The nestlist
107 file is also updated so read it again.
110 Section III. Description of the name of the footprint in pcb.
111 pcb uses macro to define the footprints. For DIL packages, for instance, 2
112 arguments are used to indicate the number of pins and the width in mil of the
113 footprint. In gschem the footprint attribute of a 300 mil width and 8 pins DIL
114 is:
115 DIL 8 300.
116 Warning, for that attribute, you have to included the space char!
118 In the following. I describe the footprint attribute that are to be used in
119 gschem for the footprint avalaible in pcb. N stands
120 for the number of pins, W the width in mil, L the length in mil and D the
121 diameter in mil
122 CONNECTOR ROWS COLS # single connector
123 DIN41_651LAY N # DIN 41.651 laying
124 DIN41_651STAND N # DIN 41.651 standing
125 SUBD_LAY_BASE N # SUB-D connector laying
126 SUBD_MALE_LAY_BASE N # SUB-D connector male laying
127 SUBD_FEMALE_LAY_BASE N # SUB-D connector female laying
128 DIL N W # dual-inline standard
129 D N # dual inline with W=244
130 DW N # dual inline with W=419
131 SD N # SD (ZIP)
132 MULTIWATT15 # 15 pins multiwatt footprint
133 R025 # standard 1/4W resistor !now attributes
134 SIL N # SIL
135 CSIL # SIL package with a common pin
136 QFP132 # QFP132 flat pack
137 LED D # standing LED
138 DIODE_LAY L # laying diode
139 AXIAL_LAY L # standard axial footprint
140 CRYSTAL W # crystal package
141 OSC # a can oscillator
142 ISA8 # 8 bit ISA Slot card
143 OVEN_OSC # ovenized-oscillator package
144 RADIAL_CAN W # a radial capcitor package
145 PLCC N # pllc
146 PLCC N add # pllc with additionnal border add
147 QFP N add # qfp with additionnal border add
148 No additional parameters for the to footprints
149 TO3_90
150 TO3_45
152 TO92
153 TO126
154 TO126LAY-WIDE
155 TO126STAND-WIDE
156 TO220
157 TO220LAY-WIDE
158 TO220STAND
159 TO220STAND-WIDE
161 </pre>
163 </div>
164 </div>
165 </body>
166 </html>