├── .gitignore
├── README.md
├── dtd
    ├── eagle-6.6.dtd
    ├── eagle-7.0.dtd
    ├── eagle-7.1.dtd
    ├── eagle-7.2.dtd
    ├── eagle-7.3.dtd
    ├── eagle-7.4.dtd
    ├── eagle-7.5.dtd
    ├── eagle-7.6.dtd
    └── eagle-7.7.dtd
├── merge.py
└── test
    ├── run.sh
    ├── test_in.brd
    └── test_out.brd


/.gitignore:
--------------------------------------------------------------------------------
1 | *.pyc
2 | __pycache__
3 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | 
 2 | Overview
 3 | --------
 4 | 
 5 | This command-line tool merges several board files produced by CadSoft Eagle CAD
 6 | software into one, effectively reimplementing the panelize.ulp script included
 7 | in the program itself, but without the board size limit in the light and
 8 | freeware editions of the program.
 9 | 
10 | The tool helps to perform panelization of one or several designs into a board
11 | larger than the board size limit. The output is a regular Eagle board file
12 | which can be easily inspected. Moreover, it's possible to perform various
13 | additional modifications, as Eagle only restricts component movement outside
14 | the board size limits. This is especially useful in cases when the production
15 | facility requires all panelized boards to be connected somehow, which is
16 | the case with most low-cost prototype PCB producers.
17 | 
18 | Operation
19 | ---------
20 | 
21 | The tool copies the board data optionally rotating the board and adding a
22 | position offset to the coordinates. The included component data is correctly
23 | merged.
24 | 
25 | If several input files use the same component from the same library, the
26 | duplicates are removed. The user must ensure that the input files use up-to
27 | date libraries. If there is a mismatch between the definitions of the same
28 | component used in different files, the program aborts.
29 | 
30 | The tool may change signal or element names to ensure that resulting output file
31 | does not have signals or elements with duplicate names. This is required by
32 | Eagle. Whenever element name is changed, the tool ensures that the displayed
33 | label stays the same by introducing a custom attribute which is displayed
34 | instead of the name attribute.
35 | 
36 | All input files should use the same design rules. If there is a mismatch, the
37 | program aborts.
38 | 
39 | This tool does not support board files produced by Eagle versions earlier than
40 | 6.0. Most features of the newer board files are supported. The program aborts
41 | whenever unsupported feature is encountered.
42 | 
43 | Usage
44 | -----
45 | 
46 |     merge.py output-file [in-file [--offx offset-x] [--offy offset-y] [--rotation rotation]]...
47 | 
48 |  - `output-file`: path to the output .brd file
49 |  - `in-file`: path to an input .brd file
50 |  - `offset-x`, `offset-y`: the position offset to apply to the particular input file.
51 |    The suffix determines the units. The following suffixes are supported:
52 |      - mm: millimeters
53 |  - `rotation`: The counter-clockwise rotation in degrees to apply to the
54 |    particular input file. The following values are supported: `0`, `90`, `180`
55 |    and `270`.
56 | 
57 | Requirements
58 | ------------
59 | 
60 | python3 and lxml are required.
61 | 
62 | License
63 | -------
64 | 
65 | The tool is licensed under General Public License.
66 | 
67 | Copyright (C) 2016  Povilas Kanapickas <povilas@radix.lt>
68 | 
69 | This program is free software: you can redistribute it and/or modify
70 | it under the terms of the GNU General Public License as published by
71 | the Free Software Foundation, either version 3 of the License, or
72 | (at your option) any later version.
73 | This program is distributed in the hope that it will be useful,
74 | but WITHOUT ANY WARRANTY; without even the implied warranty of
75 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
76 | GNU General Public License for more details.
77 | You should have received a copy of the GNU General Public License
78 | along with this program.  If not, see http://www.gnu.org/licenses/.
79 | 
80 | 
81 | 
82 | 
83 | 
84 | 
85 | 


--------------------------------------------------------------------------------
/dtd/eagle-6.6.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 6.6.0 DTD
  3 |   Copyright (c) 2014 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 6.6.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 6.6.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 43 | <!ENTITY % ContactRoute      "(all | any)">
 44 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 45 | <!ENTITY % Severity          "(info | warning | error)">
 46 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 47 | <!ENTITY % VerticalText      "(up | down)">
 48 | 
 49 | <!-- ### Drawing definitions ############################################## -->
 50 | 
 51 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 52 | <!ATTLIST eagle
 53 |           version       %Real;         #REQUIRED
 54 |           >
 55 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 56 | 
 57 | <!ELEMENT compatibility (note)*>
 58 | 
 59 | <!ELEMENT note (#PCDATA)>
 60 | <!ATTLIST note
 61 |           version       %Real;         #REQUIRED
 62 |           severity      %Severity;     #REQUIRED
 63 |           >
 64 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 65 | 
 66 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 67 | 
 68 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 69 | <!ATTLIST library
 70 |           name          %String;       #REQUIRED
 71 |           >
 72 |           <!-- name: Only in libraries used inside boards or schematics -->
 73 | 
 74 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, parts?, sheets?, errors?)>
 75 | <!ATTLIST schematic
 76 |           xreflabel     %String;       #IMPLIED
 77 |           xrefpart      %String;       #IMPLIED
 78 |           >
 79 | 
 80 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 81 | 
 82 | <!-- ### High level objects ############################################### -->
 83 | 
 84 | <!ELEMENT sheet (description?, plain?, instances?, busses?, nets?)>
 85 | 
 86 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 87 | <!ATTLIST package
 88 |           name          %String;       #REQUIRED
 89 |           >
 90 | 
 91 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
 92 | <!ATTLIST symbol
 93 |           name          %String;       #REQUIRED
 94 |           >
 95 | 
 96 | <!ELEMENT deviceset (description?, gates, devices)>
 97 | <!ATTLIST deviceset
 98 |           name          %String;       #REQUIRED
 99 |           prefix        %String;       ""
100 |           uservalue     %Bool;         "no"
101 |           >
102 | 
103 | <!ELEMENT device (connects?, technologies?)>
104 | <!ATTLIST device
105 |           name          %String;       ""
106 |           package       %String;       #IMPLIED
107 |           >
108 | 
109 | <!ELEMENT bus (segment)*>
110 | <!ATTLIST bus
111 |           name          %String;       #REQUIRED
112 |           >
113 | 
114 | <!ELEMENT net (segment)*>
115 | <!ATTLIST net
116 |           name          %String;       #REQUIRED
117 |           class         %Class;        "0"
118 |           >
119 | 
120 | <!ELEMENT segment (pinref | wire | junction | label)*>
121 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
122 | 
123 | <!ELEMENT signal (contactref | polygon | wire | via)*>
124 | <!ATTLIST signal
125 |           name          %String;       #REQUIRED
126 |           class         %Class;        "0"
127 |           airwireshidden %Bool;        "no"
128 |           >
129 | 
130 | <!-- ### Basic objects #################################################### -->
131 | 
132 | <!ELEMENT variantdef EMPTY>
133 | <!ATTLIST variantdef
134 |           name          %String;       #REQUIRED
135 |           current       %Bool;         "no"
136 |           >
137 | 
138 | <!ELEMENT variant EMPTY>
139 | <!ATTLIST variant
140 |           name          %String;       #REQUIRED
141 |           populate      %Bool;         "yes"
142 |           value         %String;       #IMPLIED
143 |           technology    %String;       #IMPLIED
144 |           >
145 |           <!-- technology: Only in part context -->
146 | 
147 | <!ELEMENT gate EMPTY>
148 | <!ATTLIST gate
149 |           name          %String;       #REQUIRED
150 |           symbol        %String;       #REQUIRED
151 |           x             %Coord;        #REQUIRED
152 |           y             %Coord;        #REQUIRED
153 |           addlevel      %GateAddLevel; "next"
154 |           swaplevel     %Int;          "0"
155 |           >
156 | 
157 | <!ELEMENT wire EMPTY>
158 | <!ATTLIST wire
159 |           x1            %Coord;        #REQUIRED
160 |           y1            %Coord;        #REQUIRED
161 |           x2            %Coord;        #REQUIRED
162 |           y2            %Coord;        #REQUIRED
163 |           width         %Dimension;    #REQUIRED
164 |           layer         %Layer;        #REQUIRED
165 |           extent        %Extent;       #IMPLIED
166 |           style         %WireStyle;    "continuous"
167 |           curve         %WireCurve;    "0"
168 |           cap           %WireCap;      "round"
169 |           >
170 |           <!-- extent: Only applicable for airwires -->
171 |           <!-- cap   : Only applicable if 'curve' is not zero -->
172 | 
173 | <!ELEMENT dimension EMPTY>
174 | <!ATTLIST dimension
175 |           x1            %Coord;        #REQUIRED
176 |           y1            %Coord;        #REQUIRED
177 |           x2            %Coord;        #REQUIRED
178 |           y2            %Coord;        #REQUIRED
179 |           x3            %Coord;        #REQUIRED
180 |           y3            %Coord;        #REQUIRED
181 |           layer         %Layer;        #REQUIRED
182 |           dtype         %DimensionType; "parallel"
183 |           width         %Dimension;    #REQUIRED
184 |           extwidth      %Dimension;    "0"
185 |           extlength     %Dimension;    "0"
186 |           extoffset     %Dimension;    "0"
187 |           textsize      %Dimension;    #REQUIRED
188 |           textratio     %Int;          "8"
189 |           unit          %GridUnit;     "mm"
190 |           precision     %Int;          "2"
191 |           visible       %Bool;         "no"
192 |           >
193 | 
194 | <!ELEMENT text (#PCDATA)>
195 | <!ATTLIST text
196 |           x             %Coord;        #REQUIRED
197 |           y             %Coord;        #REQUIRED
198 |           size          %Dimension;    #REQUIRED
199 |           layer         %Layer;        #REQUIRED
200 |           font          %TextFont;     "proportional"
201 |           ratio         %Int;          "8"
202 |           rot           %Rotation;     "R0"
203 |           align         %Align;        "bottom-left"
204 |           distance      %Int;          "50"
205 |           >
206 | 
207 | <!ELEMENT circle EMPTY>
208 | <!ATTLIST circle
209 |           x             %Coord;        #REQUIRED
210 |           y             %Coord;        #REQUIRED
211 |           radius        %Coord;        #REQUIRED
212 |           width         %Dimension;    #REQUIRED
213 |           layer         %Layer;        #REQUIRED
214 |           >
215 | 
216 | <!ELEMENT rectangle EMPTY>
217 | <!ATTLIST rectangle
218 |           x1            %Coord;        #REQUIRED
219 |           y1            %Coord;        #REQUIRED
220 |           x2            %Coord;        #REQUIRED
221 |           y2            %Coord;        #REQUIRED
222 |           layer         %Layer;        #REQUIRED
223 |           rot           %Rotation;     "R0"
224 |           >
225 | 
226 | <!ELEMENT frame EMPTY>
227 | <!ATTLIST frame
228 |           x1            %Coord;       #REQUIRED
229 |           y1            %Coord;       #REQUIRED
230 |           x2            %Coord;       #REQUIRED
231 |           y2            %Coord;       #REQUIRED
232 |           columns       %Int;         #REQUIRED
233 |           rows          %Int;         #REQUIRED
234 |           layer         %Layer;       #REQUIRED
235 |           border-left   %Bool;        "yes"
236 |           border-top    %Bool;        "yes"
237 |           border-right  %Bool;        "yes"
238 |           border-bottom %Bool;        "yes"
239 |           >
240 | 
241 | <!ELEMENT hole EMPTY>
242 | <!ATTLIST hole
243 |           x             %Coord;        #REQUIRED
244 |           y             %Coord;        #REQUIRED
245 |           drill         %Dimension;    #REQUIRED
246 |           >
247 | 
248 | <!ELEMENT pad EMPTY>
249 | <!ATTLIST pad
250 |           name          %String;       #REQUIRED
251 |           x             %Coord;        #REQUIRED
252 |           y             %Coord;        #REQUIRED
253 |           drill         %Dimension;    #REQUIRED
254 |           diameter      %Dimension;    "0"
255 |           shape         %PadShape;     "round"
256 |           rot           %Rotation;     "R0"
257 |           stop          %Bool;         "yes"
258 |           thermals      %Bool;         "yes"
259 |           first         %Bool;         "no"
260 |           >
261 | 
262 | <!ELEMENT smd EMPTY>
263 | <!ATTLIST smd
264 |           name          %String;       #REQUIRED
265 |           x             %Coord;        #REQUIRED
266 |           y             %Coord;        #REQUIRED
267 |           dx            %Dimension;    #REQUIRED
268 |           dy            %Dimension;    #REQUIRED
269 |           layer         %Layer;        #REQUIRED
270 |           roundness     %Int;          "0"
271 |           rot           %Rotation;     "R0"
272 |           stop          %Bool;         "yes"
273 |           thermals      %Bool;         "yes"
274 |           cream         %Bool;         "yes"
275 |           >
276 | 
277 | <!ELEMENT element (attribute*, variant*)>
278 | <!ATTLIST element
279 |           name          %String;       #REQUIRED
280 |           library       %String;       #REQUIRED
281 |           package       %String;       #REQUIRED
282 |           value         %String;       #REQUIRED
283 |           x             %Coord;        #REQUIRED
284 |           y             %Coord;        #REQUIRED
285 |           locked        %Bool;         "no"
286 |           smashed       %Bool;         "no"
287 |           rot           %Rotation;     "R0"
288 |           >
289 | 
290 | <!ELEMENT via EMPTY>
291 | <!ATTLIST via
292 |           x             %Coord;        #REQUIRED
293 |           y             %Coord;        #REQUIRED
294 |           extent        %Extent;       #REQUIRED
295 |           drill         %Dimension;    #REQUIRED
296 |           diameter      %Dimension;    "0"
297 |           shape         %ViaShape;     "round"
298 |           alwaysstop    %Bool;         "no"
299 |           >
300 | 
301 | <!ELEMENT polygon (vertex)*>
302 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
303 | <!ATTLIST polygon
304 |           width         %Dimension;    #REQUIRED
305 |           layer         %Layer;        #REQUIRED
306 |           spacing       %Dimension;    #IMPLIED
307 |           pour          %PolygonPour;  "solid"
308 |           isolate       %Dimension;    #IMPLIED
309 |           orphans       %Bool;         "no"
310 |           thermals      %Bool;         "yes"
311 |           rank          %Int;          "0"
312 |           >
313 |           <!-- isolate: Only in <signal> or <package> context -->
314 |           <!-- orphans: Only in <signal> context -->
315 |           <!-- thermals:Only in <signal> context -->
316 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
317 | 
318 | <!ELEMENT vertex EMPTY>
319 | <!ATTLIST vertex
320 |           x             %Coord;        #REQUIRED
321 |           y             %Coord;        #REQUIRED
322 |           curve         %WireCurve;    "0"
323 |           >
324 |           <!-- curve: The curvature from this vertex to the next one -->
325 | 
326 | <!ELEMENT pin EMPTY>
327 | <!ATTLIST pin
328 |           name          %String;       #REQUIRED
329 |           x             %Coord;        #REQUIRED
330 |           y             %Coord;        #REQUIRED
331 |           visible       %PinVisible;   "both"
332 |           length        %PinLength;    "long"
333 |           direction     %PinDirection; "io"
334 |           function      %PinFunction;  "none"
335 |           swaplevel     %Int;          "0"
336 |           rot           %Rotation;     "R0"
337 |           >
338 | 
339 | <!ELEMENT part (attribute*, variant*)>
340 | <!ATTLIST part
341 |           name          %String;       #REQUIRED
342 |           library       %String;       #REQUIRED
343 |           deviceset     %String;       #REQUIRED
344 |           device        %String;       #REQUIRED
345 |           technology    %String;       ""
346 |           value         %String;       #IMPLIED
347 |           >
348 | 
349 | <!ELEMENT instance (attribute)*>
350 | <!ATTLIST instance
351 |           part          %String;       #REQUIRED
352 |           gate          %String;       #REQUIRED
353 |           x             %Coord;        #REQUIRED
354 |           y             %Coord;        #REQUIRED
355 |           smashed       %Bool;         "no"
356 |           rot           %Rotation;     "R0"
357 |           >
358 |           <!-- rot: Only 0, 90, 180 or 270 -->
359 | 
360 | <!ELEMENT label EMPTY>
361 | <!ATTLIST label
362 |           x             %Coord;        #REQUIRED
363 |           y             %Coord;        #REQUIRED
364 |           size          %Dimension;    #REQUIRED
365 |           layer         %Layer;        #REQUIRED
366 |           font          %TextFont;     "proportional"
367 |           ratio         %Int;          "8"
368 |           rot           %Rotation;     "R0"
369 |           xref          %Bool;         "no"
370 |           >
371 |           <!-- rot:  Only 0, 90, 180 or 270 -->
372 |           <!-- xref: Only in <net> context -->
373 | 
374 | <!ELEMENT junction EMPTY>
375 | <!ATTLIST junction
376 |           x             %Coord;        #REQUIRED
377 |           y             %Coord;        #REQUIRED
378 |           >
379 | 
380 | <!ELEMENT connect EMPTY>
381 | <!ATTLIST connect
382 |           gate          %String;       #REQUIRED
383 |           pin           %String;       #REQUIRED
384 |           pad           %String;       #REQUIRED
385 |           route         %ContactRoute; "all"
386 |           >
387 | 
388 | <!ELEMENT technology (attribute)*>
389 | <!ATTLIST technology
390 |           name          %String;       #REQUIRED
391 |           >
392 | 
393 | <!ELEMENT attribute EMPTY>
394 | <!ATTLIST attribute
395 |           name          %String;       #REQUIRED
396 |           value         %String;       #IMPLIED
397 |           x             %Coord;        #IMPLIED
398 |           y             %Coord;        #IMPLIED
399 |           size          %Dimension;    #IMPLIED
400 |           layer         %Layer;        #IMPLIED
401 |           font          %TextFont;     #IMPLIED
402 |           ratio         %Int;          #IMPLIED
403 |           rot           %Rotation;     "R0"
404 |           display       %AttributeDisplay; "value"
405 |           constant      %Bool;         "no"
406 |           >
407 |           <!-- display: Only in <element> or <instance> context -->
408 |           <!-- constant:Only in <device> context -->
409 | 
410 | <!ELEMENT pinref EMPTY>
411 | <!ATTLIST pinref
412 |           part          %String;       #REQUIRED
413 |           gate          %String;       #REQUIRED
414 |           pin           %String;       #REQUIRED
415 |           >
416 | 
417 | <!ELEMENT contactref EMPTY>
418 | <!ATTLIST contactref
419 |           element       %String;       #REQUIRED
420 |           pad           %String;       #REQUIRED
421 |           route         %ContactRoute; "all"
422 |           routetag      %String;       ""
423 |           >
424 | 
425 | <!-- ### Object lists ##################################################### -->
426 | 
427 | <!ELEMENT variantdefs (variantdef)*>
428 | <!ELEMENT settings (setting)*>
429 | <!ELEMENT sheets (sheet)*>
430 | <!ELEMENT layers (layer)*>
431 | <!ELEMENT packages (package)*>
432 | <!ELEMENT symbols (symbol)*>
433 | <!ELEMENT devicesets (deviceset)*>
434 | <!ELEMENT gates (gate)*>
435 | <!ELEMENT devices (device)*>
436 | <!ELEMENT libraries (library)*>
437 | <!ELEMENT connects (connect)*>
438 | <!ELEMENT technologies (technology)*>
439 | <!ELEMENT attributes (attribute)*>
440 | <!ELEMENT classes (class)*>
441 | <!ELEMENT parts (part)*>
442 | <!ELEMENT instances (instance)*>
443 | <!ELEMENT errors (approved)*>
444 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
445 | <!ELEMENT autorouter (pass)*>
446 | <!ELEMENT elements (element)*>
447 | <!ELEMENT signals (signal)*>
448 | <!ELEMENT busses (bus)*>
449 | <!ELEMENT nets (net)*>
450 | 
451 | <!-- ### Miscellaneous objects ############################################ -->
452 | 
453 | <!ELEMENT setting EMPTY>
454 | <!ATTLIST setting
455 |           alwaysvectorfont %Bool;         #IMPLIED
456 |           verticaltext     %VerticalText; "up"
457 |           >
458 | 
459 | <!ELEMENT designrules (description*, param*)>
460 | <!ATTLIST designrules
461 |           name          %String;       #REQUIRED
462 |           >
463 | 
464 | <!ELEMENT grid EMPTY>
465 | <!ATTLIST grid
466 |           distance      %Real;         #IMPLIED
467 |           unitdist      %GridUnit;     #IMPLIED
468 |           unit          %GridUnit;     #IMPLIED
469 |           style         %GridStyle;    "lines"
470 |           multiple      %Int;          "1"
471 |           display       %Bool;         "no"
472 |           altdistance   %Real;         #IMPLIED
473 |           altunitdist   %GridUnit;     #IMPLIED
474 |           altunit       %GridUnit;     #IMPLIED
475 |           >
476 | 
477 | <!ELEMENT layer EMPTY>
478 | <!ATTLIST layer
479 |           number        %Layer;        #REQUIRED
480 |           name          %String;       #REQUIRED
481 |           color         %Int;          #REQUIRED
482 |           fill          %Int;          #REQUIRED
483 |           visible       %Bool;         "yes"
484 |           active        %Bool;         "yes"
485 |           >
486 | 
487 | <!ELEMENT class (clearance)*>
488 | <!ATTLIST class
489 |           number        %Class;        #REQUIRED
490 |           name          %String;       #REQUIRED
491 |           width         %Dimension;    "0"
492 |           drill         %Dimension;    "0"
493 |           >
494 | 
495 | <!ELEMENT clearance EMPTY>
496 | <!ATTLIST clearance
497 |           class         %Class;        #REQUIRED
498 |           value         %Dimension;    "0"
499 |           >
500 | 
501 | <!ELEMENT description (#PCDATA)>
502 | <!ATTLIST description
503 |           language      %String;       "en"
504 |           >
505 | 
506 | <!ELEMENT param EMPTY>
507 | <!ATTLIST param
508 |           name          %String;       #REQUIRED
509 |           value         %String;       #REQUIRED
510 |           >
511 | 
512 | <!ELEMENT pass (param)*>
513 | <!ATTLIST pass
514 |           name          %String;       #REQUIRED
515 |           refer         %String;       #IMPLIED
516 |           active        %Bool;         "yes"
517 |           >
518 | 
519 | <!ELEMENT approved EMPTY>
520 | <!ATTLIST approved
521 |           hash          %String;       #REQUIRED
522 |           >
523 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.0.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.0.0 DTD
  3 |   Copyright (c) 2014 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.0.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.0.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | 
 91 | <!-- ### High level objects ############################################### -->
 92 | 
 93 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 94 | 
 95 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 96 | <!ATTLIST package
 97 |           name          %String;       #REQUIRED
 98 |           >
 99 | 
100 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
101 | <!ATTLIST symbol
102 |           name          %String;       #REQUIRED
103 |           >
104 | 
105 | <!ELEMENT deviceset (description?, gates, devices)>
106 | <!ATTLIST deviceset
107 |           name          %String;       #REQUIRED
108 |           prefix        %String;       ""
109 |           uservalue     %Bool;         "no"
110 |           >
111 | 
112 | <!ELEMENT device (connects?, technologies?)>
113 | <!ATTLIST device
114 |           name          %String;       ""
115 |           package       %String;       #IMPLIED
116 |           >
117 | 
118 | <!ELEMENT bus (segment)*>
119 | <!ATTLIST bus
120 |           name          %String;       #REQUIRED
121 |           >
122 | 
123 | <!ELEMENT net (segment)*>
124 | <!ATTLIST net
125 |           name          %String;       #REQUIRED
126 |           class         %Class;        "0"
127 |           >
128 | 
129 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
130 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
131 | 
132 | <!ELEMENT signal (contactref | polygon | wire | via)*>
133 | <!ATTLIST signal
134 |           name          %String;       #REQUIRED
135 |           class         %Class;        "0"
136 |           airwireshidden %Bool;        "no"
137 |           >
138 | 
139 | <!-- ### Basic objects #################################################### -->
140 | 
141 | <!ELEMENT moduleinst (attribute)*>
142 | <!ATTLIST moduleinst
143 |           name          %String;       #REQUIRED
144 |           module        %String;       #REQUIRED
145 |           modulevariant %String;       ""
146 |           x             %Coord;        #REQUIRED
147 |           y             %Coord;        #REQUIRED
148 |           offset        %Int;          "0"
149 |           smashed       %Bool;         "no"
150 |           rot           %Rotation;     "R0"
151 |           >
152 |           <!-- rot: Only 0, 90, 180 or 270 -->
153 | 
154 | <!ELEMENT variantdef EMPTY>
155 | <!ATTLIST variantdef
156 |           name          %String;       #REQUIRED
157 |           current       %Bool;         "no"
158 |           >
159 | 
160 | <!ELEMENT variant EMPTY>
161 | <!ATTLIST variant
162 |           name          %String;       #REQUIRED
163 |           populate      %Bool;         "yes"
164 |           value         %String;       #IMPLIED
165 |           technology    %String;       #IMPLIED
166 |           >
167 |           <!-- technology: Only in part context -->
168 | 
169 | <!ELEMENT gate EMPTY>
170 | <!ATTLIST gate
171 |           name          %String;       #REQUIRED
172 |           symbol        %String;       #REQUIRED
173 |           x             %Coord;        #REQUIRED
174 |           y             %Coord;        #REQUIRED
175 |           addlevel      %GateAddLevel; "next"
176 |           swaplevel     %Int;          "0"
177 |           >
178 | 
179 | <!ELEMENT wire EMPTY>
180 | <!ATTLIST wire
181 |           x1            %Coord;        #REQUIRED
182 |           y1            %Coord;        #REQUIRED
183 |           x2            %Coord;        #REQUIRED
184 |           y2            %Coord;        #REQUIRED
185 |           width         %Dimension;    #REQUIRED
186 |           layer         %Layer;        #REQUIRED
187 |           extent        %Extent;       #IMPLIED
188 |           style         %WireStyle;    "continuous"
189 |           curve         %WireCurve;    "0"
190 |           cap           %WireCap;      "round"
191 |           >
192 |           <!-- extent: Only applicable for airwires -->
193 |           <!-- cap   : Only applicable if 'curve' is not zero -->
194 | 
195 | <!ELEMENT dimension EMPTY>
196 | <!ATTLIST dimension
197 |           x1            %Coord;        #REQUIRED
198 |           y1            %Coord;        #REQUIRED
199 |           x2            %Coord;        #REQUIRED
200 |           y2            %Coord;        #REQUIRED
201 |           x3            %Coord;        #REQUIRED
202 |           y3            %Coord;        #REQUIRED
203 |           layer         %Layer;        #REQUIRED
204 |           dtype         %DimensionType; "parallel"
205 |           width         %Dimension;    #REQUIRED
206 |           extwidth      %Dimension;    "0"
207 |           extlength     %Dimension;    "0"
208 |           extoffset     %Dimension;    "0"
209 |           textsize      %Dimension;    #REQUIRED
210 |           textratio     %Int;          "8"
211 |           unit          %GridUnit;     "mm"
212 |           precision     %Int;          "2"
213 |           visible       %Bool;         "no"
214 |           >
215 | 
216 | <!ELEMENT text (#PCDATA)>
217 | <!ATTLIST text
218 |           x             %Coord;        #REQUIRED
219 |           y             %Coord;        #REQUIRED
220 |           size          %Dimension;    #REQUIRED
221 |           layer         %Layer;        #REQUIRED
222 |           font          %TextFont;     "proportional"
223 |           ratio         %Int;          "8"
224 |           rot           %Rotation;     "R0"
225 |           align         %Align;        "bottom-left"
226 |           distance      %Int;          "50"
227 |           >
228 | 
229 | <!ELEMENT circle EMPTY>
230 | <!ATTLIST circle
231 |           x             %Coord;        #REQUIRED
232 |           y             %Coord;        #REQUIRED
233 |           radius        %Coord;        #REQUIRED
234 |           width         %Dimension;    #REQUIRED
235 |           layer         %Layer;        #REQUIRED
236 |           >
237 | 
238 | <!ELEMENT rectangle EMPTY>
239 | <!ATTLIST rectangle
240 |           x1            %Coord;        #REQUIRED
241 |           y1            %Coord;        #REQUIRED
242 |           x2            %Coord;        #REQUIRED
243 |           y2            %Coord;        #REQUIRED
244 |           layer         %Layer;        #REQUIRED
245 |           rot           %Rotation;     "R0"
246 |           >
247 | 
248 | <!ELEMENT frame EMPTY>
249 | <!ATTLIST frame
250 |           x1            %Coord;       #REQUIRED
251 |           y1            %Coord;       #REQUIRED
252 |           x2            %Coord;       #REQUIRED
253 |           y2            %Coord;       #REQUIRED
254 |           columns       %Int;         #REQUIRED
255 |           rows          %Int;         #REQUIRED
256 |           layer         %Layer;       #REQUIRED
257 |           border-left   %Bool;        "yes"
258 |           border-top    %Bool;        "yes"
259 |           border-right  %Bool;        "yes"
260 |           border-bottom %Bool;        "yes"
261 |           >
262 | 
263 | <!ELEMENT hole EMPTY>
264 | <!ATTLIST hole
265 |           x             %Coord;        #REQUIRED
266 |           y             %Coord;        #REQUIRED
267 |           drill         %Dimension;    #REQUIRED
268 |           >
269 | 
270 | <!ELEMENT pad EMPTY>
271 | <!ATTLIST pad
272 |           name          %String;       #REQUIRED
273 |           x             %Coord;        #REQUIRED
274 |           y             %Coord;        #REQUIRED
275 |           drill         %Dimension;    #REQUIRED
276 |           diameter      %Dimension;    "0"
277 |           shape         %PadShape;     "round"
278 |           rot           %Rotation;     "R0"
279 |           stop          %Bool;         "yes"
280 |           thermals      %Bool;         "yes"
281 |           first         %Bool;         "no"
282 |           >
283 | 
284 | <!ELEMENT smd EMPTY>
285 | <!ATTLIST smd
286 |           name          %String;       #REQUIRED
287 |           x             %Coord;        #REQUIRED
288 |           y             %Coord;        #REQUIRED
289 |           dx            %Dimension;    #REQUIRED
290 |           dy            %Dimension;    #REQUIRED
291 |           layer         %Layer;        #REQUIRED
292 |           roundness     %Int;          "0"
293 |           rot           %Rotation;     "R0"
294 |           stop          %Bool;         "yes"
295 |           thermals      %Bool;         "yes"
296 |           cream         %Bool;         "yes"
297 |           >
298 | 
299 | <!ELEMENT element (attribute*, variant*)>
300 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
301 | <!ATTLIST element
302 |           name          %String;       #REQUIRED
303 |           library       %String;       #REQUIRED
304 |           package       %String;       #REQUIRED
305 |           value         %String;       #REQUIRED
306 |           x             %Coord;        #REQUIRED
307 |           y             %Coord;        #REQUIRED
308 |           locked        %Bool;         "no"
309 |           populate      %Bool;         "yes"
310 |           smashed       %Bool;         "no"
311 |           rot           %Rotation;     "R0"
312 |           >
313 | 
314 | <!ELEMENT via EMPTY>
315 | <!ATTLIST via
316 |           x             %Coord;        #REQUIRED
317 |           y             %Coord;        #REQUIRED
318 |           extent        %Extent;       #REQUIRED
319 |           drill         %Dimension;    #REQUIRED
320 |           diameter      %Dimension;    "0"
321 |           shape         %ViaShape;     "round"
322 |           alwaysstop    %Bool;         "no"
323 |           >
324 | 
325 | <!ELEMENT polygon (vertex)*>
326 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
327 | <!ATTLIST polygon
328 |           width         %Dimension;    #REQUIRED
329 |           layer         %Layer;        #REQUIRED
330 |           spacing       %Dimension;    #IMPLIED
331 |           pour          %PolygonPour;  "solid"
332 |           isolate       %Dimension;    #IMPLIED
333 |           orphans       %Bool;         "no"
334 |           thermals      %Bool;         "yes"
335 |           rank          %Int;          "0"
336 |           >
337 |           <!-- isolate: Only in <signal> or <package> context -->
338 |           <!-- orphans: Only in <signal> context -->
339 |           <!-- thermals:Only in <signal> context -->
340 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
341 | 
342 | <!ELEMENT vertex EMPTY>
343 | <!ATTLIST vertex
344 |           x             %Coord;        #REQUIRED
345 |           y             %Coord;        #REQUIRED
346 |           curve         %WireCurve;    "0"
347 |           >
348 |           <!-- curve: The curvature from this vertex to the next one -->
349 | 
350 | <!ELEMENT pin EMPTY>
351 | <!ATTLIST pin
352 |           name          %String;       #REQUIRED
353 |           x             %Coord;        #REQUIRED
354 |           y             %Coord;        #REQUIRED
355 |           visible       %PinVisible;   "both"
356 |           length        %PinLength;    "long"
357 |           direction     %PinDirection; "io"
358 |           function      %PinFunction;  "none"
359 |           swaplevel     %Int;          "0"
360 |           rot           %Rotation;     "R0"
361 |           >
362 | 
363 | <!ELEMENT part (attribute*, variant*)>
364 | <!ATTLIST part
365 |           name          %String;       #REQUIRED
366 |           library       %String;       #REQUIRED
367 |           deviceset     %String;       #REQUIRED
368 |           device        %String;       #REQUIRED
369 |           technology    %String;       ""
370 |           value         %String;       #IMPLIED
371 |           >
372 | 
373 | <!ELEMENT port EMPTY>
374 | <!ATTLIST port
375 |           name          %String;       #REQUIRED
376 |           side          %Int;          #REQUIRED
377 |           coord         %Coord;        #REQUIRED
378 |           direction     %PortDirection; "io"
379 |           >
380 | 
381 | <!ELEMENT instance (attribute)*>
382 | <!ATTLIST instance
383 |           part          %String;       #REQUIRED
384 |           gate          %String;       #REQUIRED
385 |           x             %Coord;        #REQUIRED
386 |           y             %Coord;        #REQUIRED
387 |           smashed       %Bool;         "no"
388 |           rot           %Rotation;     "R0"
389 |           >
390 |           <!-- rot: Only 0, 90, 180 or 270 -->
391 | 
392 | <!ELEMENT label EMPTY>
393 | <!ATTLIST label
394 |           x             %Coord;        #REQUIRED
395 |           y             %Coord;        #REQUIRED
396 |           size          %Dimension;    #REQUIRED
397 |           layer         %Layer;        #REQUIRED
398 |           font          %TextFont;     "proportional"
399 |           ratio         %Int;          "8"
400 |           rot           %Rotation;     "R0"
401 |           xref          %Bool;         "no"
402 |           >
403 |           <!-- rot:  Only 0, 90, 180 or 270 -->
404 |           <!-- xref: Only in <net> context -->
405 | 
406 | <!ELEMENT junction EMPTY>
407 | <!ATTLIST junction
408 |           x             %Coord;        #REQUIRED
409 |           y             %Coord;        #REQUIRED
410 |           >
411 | 
412 | <!ELEMENT connect EMPTY>
413 | <!ATTLIST connect
414 |           gate          %String;       #REQUIRED
415 |           pin           %String;       #REQUIRED
416 |           pad           %String;       #REQUIRED
417 |           route         %ContactRoute; "all"
418 |           >
419 | 
420 | <!ELEMENT technology (attribute)*>
421 | <!ATTLIST technology
422 |           name          %String;       #REQUIRED
423 |           >
424 | 
425 | <!ELEMENT attribute EMPTY>
426 | <!ATTLIST attribute
427 |           name          %String;       #REQUIRED
428 |           value         %String;       #IMPLIED
429 |           x             %Coord;        #IMPLIED
430 |           y             %Coord;        #IMPLIED
431 |           size          %Dimension;    #IMPLIED
432 |           layer         %Layer;        #IMPLIED
433 |           font          %TextFont;     #IMPLIED
434 |           ratio         %Int;          #IMPLIED
435 |           rot           %Rotation;     "R0"
436 |           display       %AttributeDisplay; "value"
437 |           constant      %Bool;         "no"
438 |           >
439 |           <!-- display: Only in <element> or <instance> context -->
440 |           <!-- constant:Only in <device> context -->
441 | 
442 | <!ELEMENT pinref EMPTY>
443 | <!ATTLIST pinref
444 |           part          %String;       #REQUIRED
445 |           gate          %String;       #REQUIRED
446 |           pin           %String;       #REQUIRED
447 |           >
448 | 
449 | <!ELEMENT contactref EMPTY>
450 | <!ATTLIST contactref
451 |           element       %String;       #REQUIRED
452 |           pad           %String;       #REQUIRED
453 |           route         %ContactRoute; "all"
454 |           routetag      %String;       ""
455 |           >
456 | 
457 | <!ELEMENT portref EMPTY>
458 | <!ATTLIST portref
459 |           moduleinst    %String;       #REQUIRED
460 |           port          %String;       #REQUIRED
461 |           >
462 | 
463 | <!-- ### Object lists ##################################################### -->
464 | 
465 | <!ELEMENT variantdefs (variantdef)*>
466 | <!ELEMENT settings (setting)*>
467 | <!ELEMENT modules (module)*>
468 | <!ELEMENT moduleinsts (moduleinst)*>
469 | <!ELEMENT ports (port)*>
470 | <!ELEMENT sheets (sheet)*>
471 | <!ELEMENT layers (layer)*>
472 | <!ELEMENT packages (package)*>
473 | <!ELEMENT symbols (symbol)*>
474 | <!ELEMENT devicesets (deviceset)*>
475 | <!ELEMENT gates (gate)*>
476 | <!ELEMENT devices (device)*>
477 | <!ELEMENT libraries (library)*>
478 | <!ELEMENT connects (connect)*>
479 | <!ELEMENT technologies (technology)*>
480 | <!ELEMENT attributes (attribute)*>
481 | <!ELEMENT classes (class)*>
482 | <!ELEMENT parts (part)*>
483 | <!ELEMENT instances (instance)*>
484 | <!ELEMENT errors (approved)*>
485 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
486 | <!ELEMENT autorouter (pass)*>
487 | <!ELEMENT elements (element)*>
488 | <!ELEMENT signals (signal)*>
489 | <!ELEMENT busses (bus)*>
490 | <!ELEMENT nets (net)*>
491 | 
492 | <!-- ### Miscellaneous objects ############################################ -->
493 | 
494 | <!ELEMENT setting EMPTY>
495 | <!ATTLIST setting
496 |           alwaysvectorfont %Bool;         #IMPLIED
497 |           verticaltext     %VerticalText; "up"
498 |           >
499 | 
500 | <!ELEMENT designrules (description*, param*)>
501 | <!ATTLIST designrules
502 |           name          %String;       #REQUIRED
503 |           >
504 | 
505 | <!ELEMENT grid EMPTY>
506 | <!ATTLIST grid
507 |           distance      %Real;         #IMPLIED
508 |           unitdist      %GridUnit;     #IMPLIED
509 |           unit          %GridUnit;     #IMPLIED
510 |           style         %GridStyle;    "lines"
511 |           multiple      %Int;          "1"
512 |           display       %Bool;         "no"
513 |           altdistance   %Real;         #IMPLIED
514 |           altunitdist   %GridUnit;     #IMPLIED
515 |           altunit       %GridUnit;     #IMPLIED
516 |           >
517 | 
518 | <!ELEMENT layer EMPTY>
519 | <!ATTLIST layer
520 |           number        %Layer;        #REQUIRED
521 |           name          %String;       #REQUIRED
522 |           color         %Int;          #REQUIRED
523 |           fill          %Int;          #REQUIRED
524 |           visible       %Bool;         "yes"
525 |           active        %Bool;         "yes"
526 |           >
527 | 
528 | <!ELEMENT class (clearance)*>
529 | <!ATTLIST class
530 |           number        %Class;        #REQUIRED
531 |           name          %String;       #REQUIRED
532 |           width         %Dimension;    "0"
533 |           drill         %Dimension;    "0"
534 |           >
535 | 
536 | <!ELEMENT clearance EMPTY>
537 | <!ATTLIST clearance
538 |           class         %Class;        #REQUIRED
539 |           value         %Dimension;    "0"
540 |           >
541 | 
542 | <!ELEMENT description (#PCDATA)>
543 | <!ATTLIST description
544 |           language      %String;       "en"
545 |           >
546 | 
547 | <!ELEMENT param EMPTY>
548 | <!ATTLIST param
549 |           name          %String;       #REQUIRED
550 |           value         %String;       #REQUIRED
551 |           >
552 | 
553 | <!ELEMENT pass (param)*>
554 | <!ATTLIST pass
555 |           name          %String;       #REQUIRED
556 |           refer         %String;       #IMPLIED
557 |           active        %Bool;         "yes"
558 |           >
559 | 
560 | <!ELEMENT approved EMPTY>
561 | <!ATTLIST approved
562 |           hash          %String;       #REQUIRED
563 |           >
564 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.1.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.1.0 DTD
  3 |   Copyright (c) 2014 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.1.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.1.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | 
 91 | <!-- ### High level objects ############################################### -->
 92 | 
 93 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 94 | 
 95 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 96 | <!ATTLIST package
 97 |           name          %String;       #REQUIRED
 98 |           >
 99 | 
100 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
101 | <!ATTLIST symbol
102 |           name          %String;       #REQUIRED
103 |           >
104 | 
105 | <!ELEMENT deviceset (description?, gates, devices)>
106 | <!ATTLIST deviceset
107 |           name          %String;       #REQUIRED
108 |           prefix        %String;       ""
109 |           uservalue     %Bool;         "no"
110 |           >
111 | 
112 | <!ELEMENT device (connects?, technologies?)>
113 | <!ATTLIST device
114 |           name          %String;       ""
115 |           package       %String;       #IMPLIED
116 |           >
117 | 
118 | <!ELEMENT bus (segment)*>
119 | <!ATTLIST bus
120 |           name          %String;       #REQUIRED
121 |           >
122 | 
123 | <!ELEMENT net (segment)*>
124 | <!ATTLIST net
125 |           name          %String;       #REQUIRED
126 |           class         %Class;        "0"
127 |           >
128 | 
129 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
130 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
131 | 
132 | <!ELEMENT signal (contactref | polygon | wire | via)*>
133 | <!ATTLIST signal
134 |           name          %String;       #REQUIRED
135 |           class         %Class;        "0"
136 |           airwireshidden %Bool;        "no"
137 |           >
138 | 
139 | <!-- ### Basic objects #################################################### -->
140 | 
141 | <!ELEMENT moduleinst (attribute)*>
142 | <!ATTLIST moduleinst
143 |           name          %String;       #REQUIRED
144 |           module        %String;       #REQUIRED
145 |           modulevariant %String;       ""
146 |           x             %Coord;        #REQUIRED
147 |           y             %Coord;        #REQUIRED
148 |           offset        %Int;          "0"
149 |           smashed       %Bool;         "no"
150 |           rot           %Rotation;     "R0"
151 |           >
152 |           <!-- rot: Only 0, 90, 180 or 270 -->
153 | 
154 | <!ELEMENT variantdef EMPTY>
155 | <!ATTLIST variantdef
156 |           name          %String;       #REQUIRED
157 |           current       %Bool;         "no"
158 |           >
159 | 
160 | <!ELEMENT variant EMPTY>
161 | <!ATTLIST variant
162 |           name          %String;       #REQUIRED
163 |           populate      %Bool;         "yes"
164 |           value         %String;       #IMPLIED
165 |           technology    %String;       #IMPLIED
166 |           >
167 |           <!-- technology: Only in part context -->
168 | 
169 | <!ELEMENT gate EMPTY>
170 | <!ATTLIST gate
171 |           name          %String;       #REQUIRED
172 |           symbol        %String;       #REQUIRED
173 |           x             %Coord;        #REQUIRED
174 |           y             %Coord;        #REQUIRED
175 |           addlevel      %GateAddLevel; "next"
176 |           swaplevel     %Int;          "0"
177 |           >
178 | 
179 | <!ELEMENT wire EMPTY>
180 | <!ATTLIST wire
181 |           x1            %Coord;        #REQUIRED
182 |           y1            %Coord;        #REQUIRED
183 |           x2            %Coord;        #REQUIRED
184 |           y2            %Coord;        #REQUIRED
185 |           width         %Dimension;    #REQUIRED
186 |           layer         %Layer;        #REQUIRED
187 |           extent        %Extent;       #IMPLIED
188 |           style         %WireStyle;    "continuous"
189 |           curve         %WireCurve;    "0"
190 |           cap           %WireCap;      "round"
191 |           >
192 |           <!-- extent: Only applicable for airwires -->
193 |           <!-- cap   : Only applicable if 'curve' is not zero -->
194 | 
195 | <!ELEMENT dimension EMPTY>
196 | <!ATTLIST dimension
197 |           x1            %Coord;        #REQUIRED
198 |           y1            %Coord;        #REQUIRED
199 |           x2            %Coord;        #REQUIRED
200 |           y2            %Coord;        #REQUIRED
201 |           x3            %Coord;        #REQUIRED
202 |           y3            %Coord;        #REQUIRED
203 |           layer         %Layer;        #REQUIRED
204 |           dtype         %DimensionType; "parallel"
205 |           width         %Dimension;    #REQUIRED
206 |           extwidth      %Dimension;    "0"
207 |           extlength     %Dimension;    "0"
208 |           extoffset     %Dimension;    "0"
209 |           textsize      %Dimension;    #REQUIRED
210 |           textratio     %Int;          "8"
211 |           unit          %GridUnit;     "mm"
212 |           precision     %Int;          "2"
213 |           visible       %Bool;         "no"
214 |           >
215 | 
216 | <!ELEMENT text (#PCDATA)>
217 | <!ATTLIST text
218 |           x             %Coord;        #REQUIRED
219 |           y             %Coord;        #REQUIRED
220 |           size          %Dimension;    #REQUIRED
221 |           layer         %Layer;        #REQUIRED
222 |           font          %TextFont;     "proportional"
223 |           ratio         %Int;          "8"
224 |           rot           %Rotation;     "R0"
225 |           align         %Align;        "bottom-left"
226 |           distance      %Int;          "50"
227 |           >
228 | 
229 | <!ELEMENT circle EMPTY>
230 | <!ATTLIST circle
231 |           x             %Coord;        #REQUIRED
232 |           y             %Coord;        #REQUIRED
233 |           radius        %Coord;        #REQUIRED
234 |           width         %Dimension;    #REQUIRED
235 |           layer         %Layer;        #REQUIRED
236 |           >
237 | 
238 | <!ELEMENT rectangle EMPTY>
239 | <!ATTLIST rectangle
240 |           x1            %Coord;        #REQUIRED
241 |           y1            %Coord;        #REQUIRED
242 |           x2            %Coord;        #REQUIRED
243 |           y2            %Coord;        #REQUIRED
244 |           layer         %Layer;        #REQUIRED
245 |           rot           %Rotation;     "R0"
246 |           >
247 | 
248 | <!ELEMENT frame EMPTY>
249 | <!ATTLIST frame
250 |           x1            %Coord;       #REQUIRED
251 |           y1            %Coord;       #REQUIRED
252 |           x2            %Coord;       #REQUIRED
253 |           y2            %Coord;       #REQUIRED
254 |           columns       %Int;         #REQUIRED
255 |           rows          %Int;         #REQUIRED
256 |           layer         %Layer;       #REQUIRED
257 |           border-left   %Bool;        "yes"
258 |           border-top    %Bool;        "yes"
259 |           border-right  %Bool;        "yes"
260 |           border-bottom %Bool;        "yes"
261 |           >
262 | 
263 | <!ELEMENT hole EMPTY>
264 | <!ATTLIST hole
265 |           x             %Coord;        #REQUIRED
266 |           y             %Coord;        #REQUIRED
267 |           drill         %Dimension;    #REQUIRED
268 |           >
269 | 
270 | <!ELEMENT pad EMPTY>
271 | <!ATTLIST pad
272 |           name          %String;       #REQUIRED
273 |           x             %Coord;        #REQUIRED
274 |           y             %Coord;        #REQUIRED
275 |           drill         %Dimension;    #REQUIRED
276 |           diameter      %Dimension;    "0"
277 |           shape         %PadShape;     "round"
278 |           rot           %Rotation;     "R0"
279 |           stop          %Bool;         "yes"
280 |           thermals      %Bool;         "yes"
281 |           first         %Bool;         "no"
282 |           >
283 | 
284 | <!ELEMENT smd EMPTY>
285 | <!ATTLIST smd
286 |           name          %String;       #REQUIRED
287 |           x             %Coord;        #REQUIRED
288 |           y             %Coord;        #REQUIRED
289 |           dx            %Dimension;    #REQUIRED
290 |           dy            %Dimension;    #REQUIRED
291 |           layer         %Layer;        #REQUIRED
292 |           roundness     %Int;          "0"
293 |           rot           %Rotation;     "R0"
294 |           stop          %Bool;         "yes"
295 |           thermals      %Bool;         "yes"
296 |           cream         %Bool;         "yes"
297 |           >
298 | 
299 | <!ELEMENT element (attribute*, variant*)>
300 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
301 | <!ATTLIST element
302 |           name          %String;       #REQUIRED
303 |           library       %String;       #REQUIRED
304 |           package       %String;       #REQUIRED
305 |           value         %String;       #REQUIRED
306 |           x             %Coord;        #REQUIRED
307 |           y             %Coord;        #REQUIRED
308 |           locked        %Bool;         "no"
309 |           populate      %Bool;         "yes"
310 |           smashed       %Bool;         "no"
311 |           rot           %Rotation;     "R0"
312 |           >
313 | 
314 | <!ELEMENT via EMPTY>
315 | <!ATTLIST via
316 |           x             %Coord;        #REQUIRED
317 |           y             %Coord;        #REQUIRED
318 |           extent        %Extent;       #REQUIRED
319 |           drill         %Dimension;    #REQUIRED
320 |           diameter      %Dimension;    "0"
321 |           shape         %ViaShape;     "round"
322 |           alwaysstop    %Bool;         "no"
323 |           >
324 | 
325 | <!ELEMENT polygon (vertex)*>
326 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
327 | <!ATTLIST polygon
328 |           width         %Dimension;    #REQUIRED
329 |           layer         %Layer;        #REQUIRED
330 |           spacing       %Dimension;    #IMPLIED
331 |           pour          %PolygonPour;  "solid"
332 |           isolate       %Dimension;    #IMPLIED
333 |           orphans       %Bool;         "no"
334 |           thermals      %Bool;         "yes"
335 |           rank          %Int;          "0"
336 |           >
337 |           <!-- isolate: Only in <signal> or <package> context -->
338 |           <!-- orphans: Only in <signal> context -->
339 |           <!-- thermals:Only in <signal> context -->
340 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
341 | 
342 | <!ELEMENT vertex EMPTY>
343 | <!ATTLIST vertex
344 |           x             %Coord;        #REQUIRED
345 |           y             %Coord;        #REQUIRED
346 |           curve         %WireCurve;    "0"
347 |           >
348 |           <!-- curve: The curvature from this vertex to the next one -->
349 | 
350 | <!ELEMENT pin EMPTY>
351 | <!ATTLIST pin
352 |           name          %String;       #REQUIRED
353 |           x             %Coord;        #REQUIRED
354 |           y             %Coord;        #REQUIRED
355 |           visible       %PinVisible;   "both"
356 |           length        %PinLength;    "long"
357 |           direction     %PinDirection; "io"
358 |           function      %PinFunction;  "none"
359 |           swaplevel     %Int;          "0"
360 |           rot           %Rotation;     "R0"
361 |           >
362 | 
363 | <!ELEMENT part (attribute*, variant*)>
364 | <!ATTLIST part
365 |           name          %String;       #REQUIRED
366 |           library       %String;       #REQUIRED
367 |           deviceset     %String;       #REQUIRED
368 |           device        %String;       #REQUIRED
369 |           technology    %String;       ""
370 |           value         %String;       #IMPLIED
371 |           >
372 | 
373 | <!ELEMENT port EMPTY>
374 | <!ATTLIST port
375 |           name          %String;       #REQUIRED
376 |           side          %Int;          #REQUIRED
377 |           coord         %Coord;        #REQUIRED
378 |           direction     %PortDirection; "io"
379 |           >
380 | 
381 | <!ELEMENT instance (attribute)*>
382 | <!ATTLIST instance
383 |           part          %String;       #REQUIRED
384 |           gate          %String;       #REQUIRED
385 |           x             %Coord;        #REQUIRED
386 |           y             %Coord;        #REQUIRED
387 |           smashed       %Bool;         "no"
388 |           rot           %Rotation;     "R0"
389 |           >
390 |           <!-- rot: Only 0, 90, 180 or 270 -->
391 | 
392 | <!ELEMENT label EMPTY>
393 | <!ATTLIST label
394 |           x             %Coord;        #REQUIRED
395 |           y             %Coord;        #REQUIRED
396 |           size          %Dimension;    #REQUIRED
397 |           layer         %Layer;        #REQUIRED
398 |           font          %TextFont;     "proportional"
399 |           ratio         %Int;          "8"
400 |           rot           %Rotation;     "R0"
401 |           xref          %Bool;         "no"
402 |           >
403 |           <!-- rot:  Only 0, 90, 180 or 270 -->
404 |           <!-- xref: Only in <net> context -->
405 | 
406 | <!ELEMENT junction EMPTY>
407 | <!ATTLIST junction
408 |           x             %Coord;        #REQUIRED
409 |           y             %Coord;        #REQUIRED
410 |           >
411 | 
412 | <!ELEMENT connect EMPTY>
413 | <!ATTLIST connect
414 |           gate          %String;       #REQUIRED
415 |           pin           %String;       #REQUIRED
416 |           pad           %String;       #REQUIRED
417 |           route         %ContactRoute; "all"
418 |           >
419 | 
420 | <!ELEMENT technology (attribute)*>
421 | <!ATTLIST technology
422 |           name          %String;       #REQUIRED
423 |           >
424 | 
425 | <!ELEMENT attribute EMPTY>
426 | <!ATTLIST attribute
427 |           name          %String;       #REQUIRED
428 |           value         %String;       #IMPLIED
429 |           x             %Coord;        #IMPLIED
430 |           y             %Coord;        #IMPLIED
431 |           size          %Dimension;    #IMPLIED
432 |           layer         %Layer;        #IMPLIED
433 |           font          %TextFont;     #IMPLIED
434 |           ratio         %Int;          #IMPLIED
435 |           rot           %Rotation;     "R0"
436 |           display       %AttributeDisplay; "value"
437 |           constant      %Bool;         "no"
438 |           >
439 |           <!-- display: Only in <element> or <instance> context -->
440 |           <!-- constant:Only in <device> context -->
441 | 
442 | <!ELEMENT pinref EMPTY>
443 | <!ATTLIST pinref
444 |           part          %String;       #REQUIRED
445 |           gate          %String;       #REQUIRED
446 |           pin           %String;       #REQUIRED
447 |           >
448 | 
449 | <!ELEMENT contactref EMPTY>
450 | <!ATTLIST contactref
451 |           element       %String;       #REQUIRED
452 |           pad           %String;       #REQUIRED
453 |           route         %ContactRoute; "all"
454 |           routetag      %String;       ""
455 |           >
456 | 
457 | <!ELEMENT portref EMPTY>
458 | <!ATTLIST portref
459 |           moduleinst    %String;       #REQUIRED
460 |           port          %String;       #REQUIRED
461 |           >
462 | 
463 | <!-- ### Object lists ##################################################### -->
464 | 
465 | <!ELEMENT variantdefs (variantdef)*>
466 | <!ELEMENT settings (setting)*>
467 | <!ELEMENT modules (module)*>
468 | <!ELEMENT moduleinsts (moduleinst)*>
469 | <!ELEMENT ports (port)*>
470 | <!ELEMENT sheets (sheet)*>
471 | <!ELEMENT layers (layer)*>
472 | <!ELEMENT packages (package)*>
473 | <!ELEMENT symbols (symbol)*>
474 | <!ELEMENT devicesets (deviceset)*>
475 | <!ELEMENT gates (gate)*>
476 | <!ELEMENT devices (device)*>
477 | <!ELEMENT libraries (library)*>
478 | <!ELEMENT connects (connect)*>
479 | <!ELEMENT technologies (technology)*>
480 | <!ELEMENT attributes (attribute)*>
481 | <!ELEMENT classes (class)*>
482 | <!ELEMENT parts (part)*>
483 | <!ELEMENT instances (instance)*>
484 | <!ELEMENT errors (approved)*>
485 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
486 | <!ELEMENT autorouter (pass)*>
487 | <!ELEMENT elements (element)*>
488 | <!ELEMENT signals (signal)*>
489 | <!ELEMENT busses (bus)*>
490 | <!ELEMENT nets (net)*>
491 | 
492 | <!-- ### Miscellaneous objects ############################################ -->
493 | 
494 | <!ELEMENT setting EMPTY>
495 | <!ATTLIST setting
496 |           alwaysvectorfont %Bool;         #IMPLIED
497 |           verticaltext     %VerticalText; "up"
498 |           >
499 | 
500 | <!ELEMENT designrules (description*, param*)>
501 | <!ATTLIST designrules
502 |           name          %String;       #REQUIRED
503 |           >
504 | 
505 | <!ELEMENT grid EMPTY>
506 | <!ATTLIST grid
507 |           distance      %Real;         #IMPLIED
508 |           unitdist      %GridUnit;     #IMPLIED
509 |           unit          %GridUnit;     #IMPLIED
510 |           style         %GridStyle;    "lines"
511 |           multiple      %Int;          "1"
512 |           display       %Bool;         "no"
513 |           altdistance   %Real;         #IMPLIED
514 |           altunitdist   %GridUnit;     #IMPLIED
515 |           altunit       %GridUnit;     #IMPLIED
516 |           >
517 | 
518 | <!ELEMENT layer EMPTY>
519 | <!ATTLIST layer
520 |           number        %Layer;        #REQUIRED
521 |           name          %String;       #REQUIRED
522 |           color         %Int;          #REQUIRED
523 |           fill          %Int;          #REQUIRED
524 |           visible       %Bool;         "yes"
525 |           active        %Bool;         "yes"
526 |           >
527 | 
528 | <!ELEMENT class (clearance)*>
529 | <!ATTLIST class
530 |           number        %Class;        #REQUIRED
531 |           name          %String;       #REQUIRED
532 |           width         %Dimension;    "0"
533 |           drill         %Dimension;    "0"
534 |           >
535 | 
536 | <!ELEMENT clearance EMPTY>
537 | <!ATTLIST clearance
538 |           class         %Class;        #REQUIRED
539 |           value         %Dimension;    "0"
540 |           >
541 | 
542 | <!ELEMENT description (#PCDATA)>
543 | <!ATTLIST description
544 |           language      %String;       "en"
545 |           >
546 | 
547 | <!ELEMENT param EMPTY>
548 | <!ATTLIST param
549 |           name          %String;       #REQUIRED
550 |           value         %String;       #REQUIRED
551 |           >
552 | 
553 | <!ELEMENT pass (param)*>
554 | <!ATTLIST pass
555 |           name          %String;       #REQUIRED
556 |           refer         %String;       #IMPLIED
557 |           active        %Bool;         "yes"
558 |           >
559 | 
560 | <!ELEMENT approved EMPTY>
561 | <!ATTLIST approved
562 |           hash          %String;       #REQUIRED
563 |           >
564 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.2.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.2.0 DTD
  3 |   Copyright (c) 2014 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.2.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.2.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | 
 91 | <!-- ### High level objects ############################################### -->
 92 | 
 93 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 94 | 
 95 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 96 | <!ATTLIST package
 97 |           name          %String;       #REQUIRED
 98 |           >
 99 | 
100 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
101 | <!ATTLIST symbol
102 |           name          %String;       #REQUIRED
103 |           >
104 | 
105 | <!ELEMENT deviceset (description?, gates, devices)>
106 | <!ATTLIST deviceset
107 |           name          %String;       #REQUIRED
108 |           prefix        %String;       ""
109 |           uservalue     %Bool;         "no"
110 |           >
111 | 
112 | <!ELEMENT device (connects?, technologies?)>
113 | <!ATTLIST device
114 |           name          %String;       ""
115 |           package       %String;       #IMPLIED
116 |           >
117 | 
118 | <!ELEMENT bus (segment)*>
119 | <!ATTLIST bus
120 |           name          %String;       #REQUIRED
121 |           >
122 | 
123 | <!ELEMENT net (segment)*>
124 | <!ATTLIST net
125 |           name          %String;       #REQUIRED
126 |           class         %Class;        "0"
127 |           >
128 | 
129 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
130 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
131 | 
132 | <!ELEMENT signal (contactref | polygon | wire | via)*>
133 | <!ATTLIST signal
134 |           name          %String;       #REQUIRED
135 |           class         %Class;        "0"
136 |           airwireshidden %Bool;        "no"
137 |           >
138 | 
139 | <!-- ### Basic objects #################################################### -->
140 | 
141 | <!ELEMENT moduleinst (attribute)*>
142 | <!ATTLIST moduleinst
143 |           name          %String;       #REQUIRED
144 |           module        %String;       #REQUIRED
145 |           modulevariant %String;       ""
146 |           x             %Coord;        #REQUIRED
147 |           y             %Coord;        #REQUIRED
148 |           offset        %Int;          "0"
149 |           smashed       %Bool;         "no"
150 |           rot           %Rotation;     "R0"
151 |           >
152 |           <!-- rot: Only 0, 90, 180 or 270 -->
153 | 
154 | <!ELEMENT variantdef EMPTY>
155 | <!ATTLIST variantdef
156 |           name          %String;       #REQUIRED
157 |           current       %Bool;         "no"
158 |           >
159 | 
160 | <!ELEMENT variant EMPTY>
161 | <!ATTLIST variant
162 |           name          %String;       #REQUIRED
163 |           populate      %Bool;         "yes"
164 |           value         %String;       #IMPLIED
165 |           technology    %String;       #IMPLIED
166 |           >
167 |           <!-- technology: Only in part context -->
168 | 
169 | <!ELEMENT gate EMPTY>
170 | <!ATTLIST gate
171 |           name          %String;       #REQUIRED
172 |           symbol        %String;       #REQUIRED
173 |           x             %Coord;        #REQUIRED
174 |           y             %Coord;        #REQUIRED
175 |           addlevel      %GateAddLevel; "next"
176 |           swaplevel     %Int;          "0"
177 |           >
178 | 
179 | <!ELEMENT wire EMPTY>
180 | <!ATTLIST wire
181 |           x1            %Coord;        #REQUIRED
182 |           y1            %Coord;        #REQUIRED
183 |           x2            %Coord;        #REQUIRED
184 |           y2            %Coord;        #REQUIRED
185 |           width         %Dimension;    #REQUIRED
186 |           layer         %Layer;        #REQUIRED
187 |           extent        %Extent;       #IMPLIED
188 |           style         %WireStyle;    "continuous"
189 |           curve         %WireCurve;    "0"
190 |           cap           %WireCap;      "round"
191 |           >
192 |           <!-- extent: Only applicable for airwires -->
193 |           <!-- cap   : Only applicable if 'curve' is not zero -->
194 | 
195 | <!ELEMENT dimension EMPTY>
196 | <!ATTLIST dimension
197 |           x1            %Coord;        #REQUIRED
198 |           y1            %Coord;        #REQUIRED
199 |           x2            %Coord;        #REQUIRED
200 |           y2            %Coord;        #REQUIRED
201 |           x3            %Coord;        #REQUIRED
202 |           y3            %Coord;        #REQUIRED
203 |           layer         %Layer;        #REQUIRED
204 |           dtype         %DimensionType; "parallel"
205 |           width         %Dimension;    #REQUIRED
206 |           extwidth      %Dimension;    "0"
207 |           extlength     %Dimension;    "0"
208 |           extoffset     %Dimension;    "0"
209 |           textsize      %Dimension;    #REQUIRED
210 |           textratio     %Int;          "8"
211 |           unit          %GridUnit;     "mm"
212 |           precision     %Int;          "2"
213 |           visible       %Bool;         "no"
214 |           >
215 | 
216 | <!ELEMENT text (#PCDATA)>
217 | <!ATTLIST text
218 |           x             %Coord;        #REQUIRED
219 |           y             %Coord;        #REQUIRED
220 |           size          %Dimension;    #REQUIRED
221 |           layer         %Layer;        #REQUIRED
222 |           font          %TextFont;     "proportional"
223 |           ratio         %Int;          "8"
224 |           rot           %Rotation;     "R0"
225 |           align         %Align;        "bottom-left"
226 |           distance      %Int;          "50"
227 |           >
228 | 
229 | <!ELEMENT circle EMPTY>
230 | <!ATTLIST circle
231 |           x             %Coord;        #REQUIRED
232 |           y             %Coord;        #REQUIRED
233 |           radius        %Coord;        #REQUIRED
234 |           width         %Dimension;    #REQUIRED
235 |           layer         %Layer;        #REQUIRED
236 |           >
237 | 
238 | <!ELEMENT rectangle EMPTY>
239 | <!ATTLIST rectangle
240 |           x1            %Coord;        #REQUIRED
241 |           y1            %Coord;        #REQUIRED
242 |           x2            %Coord;        #REQUIRED
243 |           y2            %Coord;        #REQUIRED
244 |           layer         %Layer;        #REQUIRED
245 |           rot           %Rotation;     "R0"
246 |           >
247 | 
248 | <!ELEMENT frame EMPTY>
249 | <!ATTLIST frame
250 |           x1            %Coord;       #REQUIRED
251 |           y1            %Coord;       #REQUIRED
252 |           x2            %Coord;       #REQUIRED
253 |           y2            %Coord;       #REQUIRED
254 |           columns       %Int;         #REQUIRED
255 |           rows          %Int;         #REQUIRED
256 |           layer         %Layer;       #REQUIRED
257 |           border-left   %Bool;        "yes"
258 |           border-top    %Bool;        "yes"
259 |           border-right  %Bool;        "yes"
260 |           border-bottom %Bool;        "yes"
261 |           >
262 | 
263 | <!ELEMENT hole EMPTY>
264 | <!ATTLIST hole
265 |           x             %Coord;        #REQUIRED
266 |           y             %Coord;        #REQUIRED
267 |           drill         %Dimension;    #REQUIRED
268 |           >
269 | 
270 | <!ELEMENT pad EMPTY>
271 | <!ATTLIST pad
272 |           name          %String;       #REQUIRED
273 |           x             %Coord;        #REQUIRED
274 |           y             %Coord;        #REQUIRED
275 |           drill         %Dimension;    #REQUIRED
276 |           diameter      %Dimension;    "0"
277 |           shape         %PadShape;     "round"
278 |           rot           %Rotation;     "R0"
279 |           stop          %Bool;         "yes"
280 |           thermals      %Bool;         "yes"
281 |           first         %Bool;         "no"
282 |           >
283 | 
284 | <!ELEMENT smd EMPTY>
285 | <!ATTLIST smd
286 |           name          %String;       #REQUIRED
287 |           x             %Coord;        #REQUIRED
288 |           y             %Coord;        #REQUIRED
289 |           dx            %Dimension;    #REQUIRED
290 |           dy            %Dimension;    #REQUIRED
291 |           layer         %Layer;        #REQUIRED
292 |           roundness     %Int;          "0"
293 |           rot           %Rotation;     "R0"
294 |           stop          %Bool;         "yes"
295 |           thermals      %Bool;         "yes"
296 |           cream         %Bool;         "yes"
297 |           >
298 | 
299 | <!ELEMENT element (attribute*, variant*)>
300 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
301 | <!ATTLIST element
302 |           name          %String;       #REQUIRED
303 |           library       %String;       #REQUIRED
304 |           package       %String;       #REQUIRED
305 |           value         %String;       #REQUIRED
306 |           x             %Coord;        #REQUIRED
307 |           y             %Coord;        #REQUIRED
308 |           locked        %Bool;         "no"
309 |           populate      %Bool;         "yes"
310 |           smashed       %Bool;         "no"
311 |           rot           %Rotation;     "R0"
312 |           >
313 | 
314 | <!ELEMENT via EMPTY>
315 | <!ATTLIST via
316 |           x             %Coord;        #REQUIRED
317 |           y             %Coord;        #REQUIRED
318 |           extent        %Extent;       #REQUIRED
319 |           drill         %Dimension;    #REQUIRED
320 |           diameter      %Dimension;    "0"
321 |           shape         %ViaShape;     "round"
322 |           alwaysstop    %Bool;         "no"
323 |           >
324 | 
325 | <!ELEMENT polygon (vertex)*>
326 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
327 | <!ATTLIST polygon
328 |           width         %Dimension;    #REQUIRED
329 |           layer         %Layer;        #REQUIRED
330 |           spacing       %Dimension;    #IMPLIED
331 |           pour          %PolygonPour;  "solid"
332 |           isolate       %Dimension;    #IMPLIED
333 |           orphans       %Bool;         "no"
334 |           thermals      %Bool;         "yes"
335 |           rank          %Int;          "0"
336 |           >
337 |           <!-- isolate: Only in <signal> or <package> context -->
338 |           <!-- orphans: Only in <signal> context -->
339 |           <!-- thermals:Only in <signal> context -->
340 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
341 | 
342 | <!ELEMENT vertex EMPTY>
343 | <!ATTLIST vertex
344 |           x             %Coord;        #REQUIRED
345 |           y             %Coord;        #REQUIRED
346 |           curve         %WireCurve;    "0"
347 |           >
348 |           <!-- curve: The curvature from this vertex to the next one -->
349 | 
350 | <!ELEMENT pin EMPTY>
351 | <!ATTLIST pin
352 |           name          %String;       #REQUIRED
353 |           x             %Coord;        #REQUIRED
354 |           y             %Coord;        #REQUIRED
355 |           visible       %PinVisible;   "both"
356 |           length        %PinLength;    "long"
357 |           direction     %PinDirection; "io"
358 |           function      %PinFunction;  "none"
359 |           swaplevel     %Int;          "0"
360 |           rot           %Rotation;     "R0"
361 |           >
362 | 
363 | <!ELEMENT part (attribute*, variant*)>
364 | <!ATTLIST part
365 |           name          %String;       #REQUIRED
366 |           library       %String;       #REQUIRED
367 |           deviceset     %String;       #REQUIRED
368 |           device        %String;       #REQUIRED
369 |           technology    %String;       ""
370 |           value         %String;       #IMPLIED
371 |           >
372 | 
373 | <!ELEMENT port EMPTY>
374 | <!ATTLIST port
375 |           name          %String;       #REQUIRED
376 |           side          %Int;          #REQUIRED
377 |           coord         %Coord;        #REQUIRED
378 |           direction     %PortDirection; "io"
379 |           >
380 | 
381 | <!ELEMENT instance (attribute)*>
382 | <!ATTLIST instance
383 |           part          %String;       #REQUIRED
384 |           gate          %String;       #REQUIRED
385 |           x             %Coord;        #REQUIRED
386 |           y             %Coord;        #REQUIRED
387 |           smashed       %Bool;         "no"
388 |           rot           %Rotation;     "R0"
389 |           >
390 |           <!-- rot: Only 0, 90, 180 or 270 -->
391 | 
392 | <!ELEMENT label EMPTY>
393 | <!ATTLIST label
394 |           x             %Coord;        #REQUIRED
395 |           y             %Coord;        #REQUIRED
396 |           size          %Dimension;    #REQUIRED
397 |           layer         %Layer;        #REQUIRED
398 |           font          %TextFont;     "proportional"
399 |           ratio         %Int;          "8"
400 |           rot           %Rotation;     "R0"
401 |           xref          %Bool;         "no"
402 |           >
403 |           <!-- rot:  Only 0, 90, 180 or 270 -->
404 |           <!-- xref: Only in <net> context -->
405 | 
406 | <!ELEMENT junction EMPTY>
407 | <!ATTLIST junction
408 |           x             %Coord;        #REQUIRED
409 |           y             %Coord;        #REQUIRED
410 |           >
411 | 
412 | <!ELEMENT connect EMPTY>
413 | <!ATTLIST connect
414 |           gate          %String;       #REQUIRED
415 |           pin           %String;       #REQUIRED
416 |           pad           %String;       #REQUIRED
417 |           route         %ContactRoute; "all"
418 |           >
419 | 
420 | <!ELEMENT technology (attribute)*>
421 | <!ATTLIST technology
422 |           name          %String;       #REQUIRED
423 |           >
424 | 
425 | <!ELEMENT attribute EMPTY>
426 | <!ATTLIST attribute
427 |           name          %String;       #REQUIRED
428 |           value         %String;       #IMPLIED
429 |           x             %Coord;        #IMPLIED
430 |           y             %Coord;        #IMPLIED
431 |           size          %Dimension;    #IMPLIED
432 |           layer         %Layer;        #IMPLIED
433 |           font          %TextFont;     #IMPLIED
434 |           ratio         %Int;          #IMPLIED
435 |           rot           %Rotation;     "R0"
436 |           display       %AttributeDisplay; "value"
437 |           constant      %Bool;         "no"
438 |           >
439 |           <!-- display: Only in <element> or <instance> context -->
440 |           <!-- constant:Only in <device> context -->
441 | 
442 | <!ELEMENT pinref EMPTY>
443 | <!ATTLIST pinref
444 |           part          %String;       #REQUIRED
445 |           gate          %String;       #REQUIRED
446 |           pin           %String;       #REQUIRED
447 |           >
448 | 
449 | <!ELEMENT contactref EMPTY>
450 | <!ATTLIST contactref
451 |           element       %String;       #REQUIRED
452 |           pad           %String;       #REQUIRED
453 |           route         %ContactRoute; "all"
454 |           routetag      %String;       ""
455 |           >
456 | 
457 | <!ELEMENT portref EMPTY>
458 | <!ATTLIST portref
459 |           moduleinst    %String;       #REQUIRED
460 |           port          %String;       #REQUIRED
461 |           >
462 | 
463 | <!-- ### Object lists ##################################################### -->
464 | 
465 | <!ELEMENT variantdefs (variantdef)*>
466 | <!ELEMENT settings (setting)*>
467 | <!ELEMENT modules (module)*>
468 | <!ELEMENT moduleinsts (moduleinst)*>
469 | <!ELEMENT ports (port)*>
470 | <!ELEMENT sheets (sheet)*>
471 | <!ELEMENT layers (layer)*>
472 | <!ELEMENT packages (package)*>
473 | <!ELEMENT symbols (symbol)*>
474 | <!ELEMENT devicesets (deviceset)*>
475 | <!ELEMENT gates (gate)*>
476 | <!ELEMENT devices (device)*>
477 | <!ELEMENT libraries (library)*>
478 | <!ELEMENT connects (connect)*>
479 | <!ELEMENT technologies (technology)*>
480 | <!ELEMENT attributes (attribute)*>
481 | <!ELEMENT classes (class)*>
482 | <!ELEMENT parts (part)*>
483 | <!ELEMENT instances (instance)*>
484 | <!ELEMENT errors (approved)*>
485 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
486 | <!ELEMENT autorouter (pass)*>
487 | <!ELEMENT elements (element)*>
488 | <!ELEMENT signals (signal)*>
489 | <!ELEMENT busses (bus)*>
490 | <!ELEMENT nets (net)*>
491 | 
492 | <!-- ### Miscellaneous objects ############################################ -->
493 | 
494 | <!ELEMENT setting EMPTY>
495 | <!ATTLIST setting
496 |           alwaysvectorfont %Bool;         #IMPLIED
497 |           verticaltext     %VerticalText; "up"
498 |           >
499 | 
500 | <!ELEMENT designrules (description*, param*)>
501 | <!ATTLIST designrules
502 |           name          %String;       #REQUIRED
503 |           >
504 | 
505 | <!ELEMENT grid EMPTY>
506 | <!ATTLIST grid
507 |           distance      %Real;         #IMPLIED
508 |           unitdist      %GridUnit;     #IMPLIED
509 |           unit          %GridUnit;     #IMPLIED
510 |           style         %GridStyle;    "lines"
511 |           multiple      %Int;          "1"
512 |           display       %Bool;         "no"
513 |           altdistance   %Real;         #IMPLIED
514 |           altunitdist   %GridUnit;     #IMPLIED
515 |           altunit       %GridUnit;     #IMPLIED
516 |           >
517 | 
518 | <!ELEMENT layer EMPTY>
519 | <!ATTLIST layer
520 |           number        %Layer;        #REQUIRED
521 |           name          %String;       #REQUIRED
522 |           color         %Int;          #REQUIRED
523 |           fill          %Int;          #REQUIRED
524 |           visible       %Bool;         "yes"
525 |           active        %Bool;         "yes"
526 |           >
527 | 
528 | <!ELEMENT class (clearance)*>
529 | <!ATTLIST class
530 |           number        %Class;        #REQUIRED
531 |           name          %String;       #REQUIRED
532 |           width         %Dimension;    "0"
533 |           drill         %Dimension;    "0"
534 |           >
535 | 
536 | <!ELEMENT clearance EMPTY>
537 | <!ATTLIST clearance
538 |           class         %Class;        #REQUIRED
539 |           value         %Dimension;    "0"
540 |           >
541 | 
542 | <!ELEMENT description (#PCDATA)>
543 | <!ATTLIST description
544 |           language      %String;       "en"
545 |           >
546 | 
547 | <!ELEMENT param EMPTY>
548 | <!ATTLIST param
549 |           name          %String;       #REQUIRED
550 |           value         %String;       #REQUIRED
551 |           >
552 | 
553 | <!ELEMENT pass (param)*>
554 | <!ATTLIST pass
555 |           name          %String;       #REQUIRED
556 |           refer         %String;       #IMPLIED
557 |           active        %Bool;         "yes"
558 |           >
559 | 
560 | <!ELEMENT approved EMPTY>
561 | <!ATTLIST approved
562 |           hash          %String;       #REQUIRED
563 |           >
564 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.3.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.3.0 DTD
  3 |   Copyright (c) 2015 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.3.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.3.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | 
 91 | <!-- ### High level objects ############################################### -->
 92 | 
 93 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 94 | 
 95 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 96 | <!ATTLIST package
 97 |           name          %String;       #REQUIRED
 98 |           >
 99 | 
100 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
101 | <!ATTLIST symbol
102 |           name          %String;       #REQUIRED
103 |           >
104 | 
105 | <!ELEMENT deviceset (description?, gates, devices)>
106 | <!ATTLIST deviceset
107 |           name          %String;       #REQUIRED
108 |           prefix        %String;       ""
109 |           uservalue     %Bool;         "no"
110 |           >
111 | 
112 | <!ELEMENT device (connects?, technologies?)>
113 | <!ATTLIST device
114 |           name          %String;       ""
115 |           package       %String;       #IMPLIED
116 |           >
117 | 
118 | <!ELEMENT bus (segment)*>
119 | <!ATTLIST bus
120 |           name          %String;       #REQUIRED
121 |           >
122 | 
123 | <!ELEMENT net (segment)*>
124 | <!ATTLIST net
125 |           name          %String;       #REQUIRED
126 |           class         %Class;        "0"
127 |           >
128 | 
129 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
130 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
131 | 
132 | <!ELEMENT signal (contactref | polygon | wire | via)*>
133 | <!ATTLIST signal
134 |           name          %String;       #REQUIRED
135 |           class         %Class;        "0"
136 |           airwireshidden %Bool;        "no"
137 |           >
138 | 
139 | <!-- ### Basic objects #################################################### -->
140 | 
141 | <!ELEMENT moduleinst (attribute)*>
142 | <!ATTLIST moduleinst
143 |           name          %String;       #REQUIRED
144 |           module        %String;       #REQUIRED
145 |           modulevariant %String;       ""
146 |           x             %Coord;        #REQUIRED
147 |           y             %Coord;        #REQUIRED
148 |           offset        %Int;          "0"
149 |           smashed       %Bool;         "no"
150 |           rot           %Rotation;     "R0"
151 |           >
152 |           <!-- rot: Only 0, 90, 180 or 270 -->
153 | 
154 | <!ELEMENT variantdef EMPTY>
155 | <!ATTLIST variantdef
156 |           name          %String;       #REQUIRED
157 |           current       %Bool;         "no"
158 |           >
159 | 
160 | <!ELEMENT variant EMPTY>
161 | <!ATTLIST variant
162 |           name          %String;       #REQUIRED
163 |           populate      %Bool;         "yes"
164 |           value         %String;       #IMPLIED
165 |           technology    %String;       #IMPLIED
166 |           >
167 |           <!-- technology: Only in part context -->
168 | 
169 | <!ELEMENT gate EMPTY>
170 | <!ATTLIST gate
171 |           name          %String;       #REQUIRED
172 |           symbol        %String;       #REQUIRED
173 |           x             %Coord;        #REQUIRED
174 |           y             %Coord;        #REQUIRED
175 |           addlevel      %GateAddLevel; "next"
176 |           swaplevel     %Int;          "0"
177 |           >
178 | 
179 | <!ELEMENT wire EMPTY>
180 | <!ATTLIST wire
181 |           x1            %Coord;        #REQUIRED
182 |           y1            %Coord;        #REQUIRED
183 |           x2            %Coord;        #REQUIRED
184 |           y2            %Coord;        #REQUIRED
185 |           width         %Dimension;    #REQUIRED
186 |           layer         %Layer;        #REQUIRED
187 |           extent        %Extent;       #IMPLIED
188 |           style         %WireStyle;    "continuous"
189 |           curve         %WireCurve;    "0"
190 |           cap           %WireCap;      "round"
191 |           >
192 |           <!-- extent: Only applicable for airwires -->
193 |           <!-- cap   : Only applicable if 'curve' is not zero -->
194 | 
195 | <!ELEMENT dimension EMPTY>
196 | <!ATTLIST dimension
197 |           x1            %Coord;        #REQUIRED
198 |           y1            %Coord;        #REQUIRED
199 |           x2            %Coord;        #REQUIRED
200 |           y2            %Coord;        #REQUIRED
201 |           x3            %Coord;        #REQUIRED
202 |           y3            %Coord;        #REQUIRED
203 |           layer         %Layer;        #REQUIRED
204 |           dtype         %DimensionType; "parallel"
205 |           width         %Dimension;    #REQUIRED
206 |           extwidth      %Dimension;    "0"
207 |           extlength     %Dimension;    "0"
208 |           extoffset     %Dimension;    "0"
209 |           textsize      %Dimension;    #REQUIRED
210 |           textratio     %Int;          "8"
211 |           unit          %GridUnit;     "mm"
212 |           precision     %Int;          "2"
213 |           visible       %Bool;         "no"
214 |           >
215 | 
216 | <!ELEMENT text (#PCDATA)>
217 | <!ATTLIST text
218 |           x             %Coord;        #REQUIRED
219 |           y             %Coord;        #REQUIRED
220 |           size          %Dimension;    #REQUIRED
221 |           layer         %Layer;        #REQUIRED
222 |           font          %TextFont;     "proportional"
223 |           ratio         %Int;          "8"
224 |           rot           %Rotation;     "R0"
225 |           align         %Align;        "bottom-left"
226 |           distance      %Int;          "50"
227 |           >
228 | 
229 | <!ELEMENT circle EMPTY>
230 | <!ATTLIST circle
231 |           x             %Coord;        #REQUIRED
232 |           y             %Coord;        #REQUIRED
233 |           radius        %Coord;        #REQUIRED
234 |           width         %Dimension;    #REQUIRED
235 |           layer         %Layer;        #REQUIRED
236 |           >
237 | 
238 | <!ELEMENT rectangle EMPTY>
239 | <!ATTLIST rectangle
240 |           x1            %Coord;        #REQUIRED
241 |           y1            %Coord;        #REQUIRED
242 |           x2            %Coord;        #REQUIRED
243 |           y2            %Coord;        #REQUIRED
244 |           layer         %Layer;        #REQUIRED
245 |           rot           %Rotation;     "R0"
246 |           >
247 | 
248 | <!ELEMENT frame EMPTY>
249 | <!ATTLIST frame
250 |           x1            %Coord;       #REQUIRED
251 |           y1            %Coord;       #REQUIRED
252 |           x2            %Coord;       #REQUIRED
253 |           y2            %Coord;       #REQUIRED
254 |           columns       %Int;         #REQUIRED
255 |           rows          %Int;         #REQUIRED
256 |           layer         %Layer;       #REQUIRED
257 |           border-left   %Bool;        "yes"
258 |           border-top    %Bool;        "yes"
259 |           border-right  %Bool;        "yes"
260 |           border-bottom %Bool;        "yes"
261 |           >
262 | 
263 | <!ELEMENT hole EMPTY>
264 | <!ATTLIST hole
265 |           x             %Coord;        #REQUIRED
266 |           y             %Coord;        #REQUIRED
267 |           drill         %Dimension;    #REQUIRED
268 |           >
269 | 
270 | <!ELEMENT pad EMPTY>
271 | <!ATTLIST pad
272 |           name          %String;       #REQUIRED
273 |           x             %Coord;        #REQUIRED
274 |           y             %Coord;        #REQUIRED
275 |           drill         %Dimension;    #REQUIRED
276 |           diameter      %Dimension;    "0"
277 |           shape         %PadShape;     "round"
278 |           rot           %Rotation;     "R0"
279 |           stop          %Bool;         "yes"
280 |           thermals      %Bool;         "yes"
281 |           first         %Bool;         "no"
282 |           >
283 | 
284 | <!ELEMENT smd EMPTY>
285 | <!ATTLIST smd
286 |           name          %String;       #REQUIRED
287 |           x             %Coord;        #REQUIRED
288 |           y             %Coord;        #REQUIRED
289 |           dx            %Dimension;    #REQUIRED
290 |           dy            %Dimension;    #REQUIRED
291 |           layer         %Layer;        #REQUIRED
292 |           roundness     %Int;          "0"
293 |           rot           %Rotation;     "R0"
294 |           stop          %Bool;         "yes"
295 |           thermals      %Bool;         "yes"
296 |           cream         %Bool;         "yes"
297 |           >
298 | 
299 | <!ELEMENT element (attribute*, variant*)>
300 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
301 | <!ATTLIST element
302 |           name          %String;       #REQUIRED
303 |           library       %String;       #REQUIRED
304 |           package       %String;       #REQUIRED
305 |           value         %String;       #REQUIRED
306 |           x             %Coord;        #REQUIRED
307 |           y             %Coord;        #REQUIRED
308 |           locked        %Bool;         "no"
309 |           populate      %Bool;         "yes"
310 |           smashed       %Bool;         "no"
311 |           rot           %Rotation;     "R0"
312 |           >
313 | 
314 | <!ELEMENT via EMPTY>
315 | <!ATTLIST via
316 |           x             %Coord;        #REQUIRED
317 |           y             %Coord;        #REQUIRED
318 |           extent        %Extent;       #REQUIRED
319 |           drill         %Dimension;    #REQUIRED
320 |           diameter      %Dimension;    "0"
321 |           shape         %ViaShape;     "round"
322 |           alwaysstop    %Bool;         "no"
323 |           >
324 | 
325 | <!ELEMENT polygon (vertex)*>
326 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
327 | <!ATTLIST polygon
328 |           width         %Dimension;    #REQUIRED
329 |           layer         %Layer;        #REQUIRED
330 |           spacing       %Dimension;    #IMPLIED
331 |           pour          %PolygonPour;  "solid"
332 |           isolate       %Dimension;    #IMPLIED
333 |           orphans       %Bool;         "no"
334 |           thermals      %Bool;         "yes"
335 |           rank          %Int;          "0"
336 |           >
337 |           <!-- isolate: Only in <signal> or <package> context -->
338 |           <!-- orphans: Only in <signal> context -->
339 |           <!-- thermals:Only in <signal> context -->
340 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
341 | 
342 | <!ELEMENT vertex EMPTY>
343 | <!ATTLIST vertex
344 |           x             %Coord;        #REQUIRED
345 |           y             %Coord;        #REQUIRED
346 |           curve         %WireCurve;    "0"
347 |           >
348 |           <!-- curve: The curvature from this vertex to the next one -->
349 | 
350 | <!ELEMENT pin EMPTY>
351 | <!ATTLIST pin
352 |           name          %String;       #REQUIRED
353 |           x             %Coord;        #REQUIRED
354 |           y             %Coord;        #REQUIRED
355 |           visible       %PinVisible;   "both"
356 |           length        %PinLength;    "long"
357 |           direction     %PinDirection; "io"
358 |           function      %PinFunction;  "none"
359 |           swaplevel     %Int;          "0"
360 |           rot           %Rotation;     "R0"
361 |           >
362 | 
363 | <!ELEMENT part (attribute*, variant*)>
364 | <!ATTLIST part
365 |           name          %String;       #REQUIRED
366 |           library       %String;       #REQUIRED
367 |           deviceset     %String;       #REQUIRED
368 |           device        %String;       #REQUIRED
369 |           technology    %String;       ""
370 |           value         %String;       #IMPLIED
371 |           >
372 | 
373 | <!ELEMENT port EMPTY>
374 | <!ATTLIST port
375 |           name          %String;       #REQUIRED
376 |           side          %Int;          #REQUIRED
377 |           coord         %Coord;        #REQUIRED
378 |           direction     %PortDirection; "io"
379 |           >
380 | 
381 | <!ELEMENT instance (attribute)*>
382 | <!ATTLIST instance
383 |           part          %String;       #REQUIRED
384 |           gate          %String;       #REQUIRED
385 |           x             %Coord;        #REQUIRED
386 |           y             %Coord;        #REQUIRED
387 |           smashed       %Bool;         "no"
388 |           rot           %Rotation;     "R0"
389 |           >
390 |           <!-- rot: Only 0, 90, 180 or 270 -->
391 | 
392 | <!ELEMENT label EMPTY>
393 | <!ATTLIST label
394 |           x             %Coord;        #REQUIRED
395 |           y             %Coord;        #REQUIRED
396 |           size          %Dimension;    #REQUIRED
397 |           layer         %Layer;        #REQUIRED
398 |           font          %TextFont;     "proportional"
399 |           ratio         %Int;          "8"
400 |           rot           %Rotation;     "R0"
401 |           xref          %Bool;         "no"
402 |           >
403 |           <!-- rot:  Only 0, 90, 180 or 270 -->
404 |           <!-- xref: Only in <net> context -->
405 | 
406 | <!ELEMENT junction EMPTY>
407 | <!ATTLIST junction
408 |           x             %Coord;        #REQUIRED
409 |           y             %Coord;        #REQUIRED
410 |           >
411 | 
412 | <!ELEMENT connect EMPTY>
413 | <!ATTLIST connect
414 |           gate          %String;       #REQUIRED
415 |           pin           %String;       #REQUIRED
416 |           pad           %String;       #REQUIRED
417 |           route         %ContactRoute; "all"
418 |           >
419 | 
420 | <!ELEMENT technology (attribute)*>
421 | <!ATTLIST technology
422 |           name          %String;       #REQUIRED
423 |           >
424 | 
425 | <!ELEMENT attribute EMPTY>
426 | <!ATTLIST attribute
427 |           name          %String;       #REQUIRED
428 |           value         %String;       #IMPLIED
429 |           x             %Coord;        #IMPLIED
430 |           y             %Coord;        #IMPLIED
431 |           size          %Dimension;    #IMPLIED
432 |           layer         %Layer;        #IMPLIED
433 |           font          %TextFont;     #IMPLIED
434 |           ratio         %Int;          #IMPLIED
435 |           rot           %Rotation;     "R0"
436 |           display       %AttributeDisplay; "value"
437 |           constant      %Bool;         "no"
438 |           >
439 |           <!-- display: Only in <element> or <instance> context -->
440 |           <!-- constant:Only in <device> context -->
441 | 
442 | <!ELEMENT pinref EMPTY>
443 | <!ATTLIST pinref
444 |           part          %String;       #REQUIRED
445 |           gate          %String;       #REQUIRED
446 |           pin           %String;       #REQUIRED
447 |           >
448 | 
449 | <!ELEMENT contactref EMPTY>
450 | <!ATTLIST contactref
451 |           element       %String;       #REQUIRED
452 |           pad           %String;       #REQUIRED
453 |           route         %ContactRoute; "all"
454 |           routetag      %String;       ""
455 |           >
456 | 
457 | <!ELEMENT portref EMPTY>
458 | <!ATTLIST portref
459 |           moduleinst    %String;       #REQUIRED
460 |           port          %String;       #REQUIRED
461 |           >
462 | 
463 | <!-- ### Object lists ##################################################### -->
464 | 
465 | <!ELEMENT variantdefs (variantdef)*>
466 | <!ELEMENT settings (setting)*>
467 | <!ELEMENT modules (module)*>
468 | <!ELEMENT moduleinsts (moduleinst)*>
469 | <!ELEMENT ports (port)*>
470 | <!ELEMENT sheets (sheet)*>
471 | <!ELEMENT layers (layer)*>
472 | <!ELEMENT packages (package)*>
473 | <!ELEMENT symbols (symbol)*>
474 | <!ELEMENT devicesets (deviceset)*>
475 | <!ELEMENT gates (gate)*>
476 | <!ELEMENT devices (device)*>
477 | <!ELEMENT libraries (library)*>
478 | <!ELEMENT connects (connect)*>
479 | <!ELEMENT technologies (technology)*>
480 | <!ELEMENT attributes (attribute)*>
481 | <!ELEMENT classes (class)*>
482 | <!ELEMENT parts (part)*>
483 | <!ELEMENT instances (instance)*>
484 | <!ELEMENT errors (approved)*>
485 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
486 | <!ELEMENT autorouter (pass)*>
487 | <!ELEMENT elements (element)*>
488 | <!ELEMENT signals (signal)*>
489 | <!ELEMENT busses (bus)*>
490 | <!ELEMENT nets (net)*>
491 | 
492 | <!-- ### Miscellaneous objects ############################################ -->
493 | 
494 | <!ELEMENT setting EMPTY>
495 | <!ATTLIST setting
496 |           alwaysvectorfont %Bool;         #IMPLIED
497 |           verticaltext     %VerticalText; "up"
498 |           >
499 | 
500 | <!ELEMENT designrules (description*, param*)>
501 | <!ATTLIST designrules
502 |           name          %String;       #REQUIRED
503 |           >
504 | 
505 | <!ELEMENT grid EMPTY>
506 | <!ATTLIST grid
507 |           distance      %Real;         #IMPLIED
508 |           unitdist      %GridUnit;     #IMPLIED
509 |           unit          %GridUnit;     #IMPLIED
510 |           style         %GridStyle;    "lines"
511 |           multiple      %Int;          "1"
512 |           display       %Bool;         "no"
513 |           altdistance   %Real;         #IMPLIED
514 |           altunitdist   %GridUnit;     #IMPLIED
515 |           altunit       %GridUnit;     #IMPLIED
516 |           >
517 | 
518 | <!ELEMENT layer EMPTY>
519 | <!ATTLIST layer
520 |           number        %Layer;        #REQUIRED
521 |           name          %String;       #REQUIRED
522 |           color         %Int;          #REQUIRED
523 |           fill          %Int;          #REQUIRED
524 |           visible       %Bool;         "yes"
525 |           active        %Bool;         "yes"
526 |           >
527 | 
528 | <!ELEMENT class (clearance)*>
529 | <!ATTLIST class
530 |           number        %Class;        #REQUIRED
531 |           name          %String;       #REQUIRED
532 |           width         %Dimension;    "0"
533 |           drill         %Dimension;    "0"
534 |           >
535 | 
536 | <!ELEMENT clearance EMPTY>
537 | <!ATTLIST clearance
538 |           class         %Class;        #REQUIRED
539 |           value         %Dimension;    "0"
540 |           >
541 | 
542 | <!ELEMENT description (#PCDATA)>
543 | <!ATTLIST description
544 |           language      %String;       "en"
545 |           >
546 | 
547 | <!ELEMENT param EMPTY>
548 | <!ATTLIST param
549 |           name          %String;       #REQUIRED
550 |           value         %String;       #REQUIRED
551 |           >
552 | 
553 | <!ELEMENT pass (param)*>
554 | <!ATTLIST pass
555 |           name          %String;       #REQUIRED
556 |           refer         %String;       #IMPLIED
557 |           active        %Bool;         "yes"
558 |           >
559 | 
560 | <!ELEMENT approved EMPTY>
561 | <!ATTLIST approved
562 |           hash          %String;       #REQUIRED
563 |           >
564 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.4.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.4.0 DTD
  3 |   Copyright (c) 2015 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.4.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.4.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | <!ATTLIST board
 91 |           limitedwidth  %Dimension;    #IMPLIED
 92 |           >
 93 | 
 94 | <!-- ### High level objects ############################################### -->
 95 | 
 96 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 97 | 
 98 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 99 | <!ATTLIST package
100 |           name          %String;       #REQUIRED
101 |           >
102 | 
103 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
104 | <!ATTLIST symbol
105 |           name          %String;       #REQUIRED
106 |           >
107 | 
108 | <!ELEMENT deviceset (description?, gates, devices)>
109 | <!ATTLIST deviceset
110 |           name          %String;       #REQUIRED
111 |           prefix        %String;       ""
112 |           uservalue     %Bool;         "no"
113 |           >
114 | 
115 | <!ELEMENT device (connects?, technologies?)>
116 | <!ATTLIST device
117 |           name          %String;       ""
118 |           package       %String;       #IMPLIED
119 |           >
120 | 
121 | <!ELEMENT bus (segment)*>
122 | <!ATTLIST bus
123 |           name          %String;       #REQUIRED
124 |           >
125 | 
126 | <!ELEMENT net (segment)*>
127 | <!ATTLIST net
128 |           name          %String;       #REQUIRED
129 |           class         %Class;        "0"
130 |           >
131 | 
132 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
133 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
134 | 
135 | <!ELEMENT signal (contactref | polygon | wire | via)*>
136 | <!ATTLIST signal
137 |           name          %String;       #REQUIRED
138 |           class         %Class;        "0"
139 |           airwireshidden %Bool;        "no"
140 |           >
141 | 
142 | <!-- ### Basic objects #################################################### -->
143 | 
144 | <!ELEMENT moduleinst (attribute)*>
145 | <!ATTLIST moduleinst
146 |           name          %String;       #REQUIRED
147 |           module        %String;       #REQUIRED
148 |           modulevariant %String;       ""
149 |           x             %Coord;        #REQUIRED
150 |           y             %Coord;        #REQUIRED
151 |           offset        %Int;          "0"
152 |           smashed       %Bool;         "no"
153 |           rot           %Rotation;     "R0"
154 |           >
155 |           <!-- rot: Only 0, 90, 180 or 270 -->
156 | 
157 | <!ELEMENT variantdef EMPTY>
158 | <!ATTLIST variantdef
159 |           name          %String;       #REQUIRED
160 |           current       %Bool;         "no"
161 |           >
162 | 
163 | <!ELEMENT variant EMPTY>
164 | <!ATTLIST variant
165 |           name          %String;       #REQUIRED
166 |           populate      %Bool;         "yes"
167 |           value         %String;       #IMPLIED
168 |           technology    %String;       #IMPLIED
169 |           >
170 |           <!-- technology: Only in part context -->
171 | 
172 | <!ELEMENT gate EMPTY>
173 | <!ATTLIST gate
174 |           name          %String;       #REQUIRED
175 |           symbol        %String;       #REQUIRED
176 |           x             %Coord;        #REQUIRED
177 |           y             %Coord;        #REQUIRED
178 |           addlevel      %GateAddLevel; "next"
179 |           swaplevel     %Int;          "0"
180 |           >
181 | 
182 | <!ELEMENT wire EMPTY>
183 | <!ATTLIST wire
184 |           x1            %Coord;        #REQUIRED
185 |           y1            %Coord;        #REQUIRED
186 |           x2            %Coord;        #REQUIRED
187 |           y2            %Coord;        #REQUIRED
188 |           width         %Dimension;    #REQUIRED
189 |           layer         %Layer;        #REQUIRED
190 |           extent        %Extent;       #IMPLIED
191 |           style         %WireStyle;    "continuous"
192 |           curve         %WireCurve;    "0"
193 |           cap           %WireCap;      "round"
194 |           >
195 |           <!-- extent: Only applicable for airwires -->
196 |           <!-- cap   : Only applicable if 'curve' is not zero -->
197 | 
198 | <!ELEMENT dimension EMPTY>
199 | <!ATTLIST dimension
200 |           x1            %Coord;        #REQUIRED
201 |           y1            %Coord;        #REQUIRED
202 |           x2            %Coord;        #REQUIRED
203 |           y2            %Coord;        #REQUIRED
204 |           x3            %Coord;        #REQUIRED
205 |           y3            %Coord;        #REQUIRED
206 |           layer         %Layer;        #REQUIRED
207 |           dtype         %DimensionType; "parallel"
208 |           width         %Dimension;    #REQUIRED
209 |           extwidth      %Dimension;    "0"
210 |           extlength     %Dimension;    "0"
211 |           extoffset     %Dimension;    "0"
212 |           textsize      %Dimension;    #REQUIRED
213 |           textratio     %Int;          "8"
214 |           unit          %GridUnit;     "mm"
215 |           precision     %Int;          "2"
216 |           visible       %Bool;         "no"
217 |           >
218 | 
219 | <!ELEMENT text (#PCDATA)>
220 | <!ATTLIST text
221 |           x             %Coord;        #REQUIRED
222 |           y             %Coord;        #REQUIRED
223 |           size          %Dimension;    #REQUIRED
224 |           layer         %Layer;        #REQUIRED
225 |           font          %TextFont;     "proportional"
226 |           ratio         %Int;          "8"
227 |           rot           %Rotation;     "R0"
228 |           align         %Align;        "bottom-left"
229 |           distance      %Int;          "50"
230 |           >
231 | 
232 | <!ELEMENT circle EMPTY>
233 | <!ATTLIST circle
234 |           x             %Coord;        #REQUIRED
235 |           y             %Coord;        #REQUIRED
236 |           radius        %Coord;        #REQUIRED
237 |           width         %Dimension;    #REQUIRED
238 |           layer         %Layer;        #REQUIRED
239 |           >
240 | 
241 | <!ELEMENT rectangle EMPTY>
242 | <!ATTLIST rectangle
243 |           x1            %Coord;        #REQUIRED
244 |           y1            %Coord;        #REQUIRED
245 |           x2            %Coord;        #REQUIRED
246 |           y2            %Coord;        #REQUIRED
247 |           layer         %Layer;        #REQUIRED
248 |           rot           %Rotation;     "R0"
249 |           >
250 | 
251 | <!ELEMENT frame EMPTY>
252 | <!ATTLIST frame
253 |           x1            %Coord;       #REQUIRED
254 |           y1            %Coord;       #REQUIRED
255 |           x2            %Coord;       #REQUIRED
256 |           y2            %Coord;       #REQUIRED
257 |           columns       %Int;         #REQUIRED
258 |           rows          %Int;         #REQUIRED
259 |           layer         %Layer;       #REQUIRED
260 |           border-left   %Bool;        "yes"
261 |           border-top    %Bool;        "yes"
262 |           border-right  %Bool;        "yes"
263 |           border-bottom %Bool;        "yes"
264 |           >
265 | 
266 | <!ELEMENT hole EMPTY>
267 | <!ATTLIST hole
268 |           x             %Coord;        #REQUIRED
269 |           y             %Coord;        #REQUIRED
270 |           drill         %Dimension;    #REQUIRED
271 |           >
272 | 
273 | <!ELEMENT pad EMPTY>
274 | <!ATTLIST pad
275 |           name          %String;       #REQUIRED
276 |           x             %Coord;        #REQUIRED
277 |           y             %Coord;        #REQUIRED
278 |           drill         %Dimension;    #REQUIRED
279 |           diameter      %Dimension;    "0"
280 |           shape         %PadShape;     "round"
281 |           rot           %Rotation;     "R0"
282 |           stop          %Bool;         "yes"
283 |           thermals      %Bool;         "yes"
284 |           first         %Bool;         "no"
285 |           >
286 | 
287 | <!ELEMENT smd EMPTY>
288 | <!ATTLIST smd
289 |           name          %String;       #REQUIRED
290 |           x             %Coord;        #REQUIRED
291 |           y             %Coord;        #REQUIRED
292 |           dx            %Dimension;    #REQUIRED
293 |           dy            %Dimension;    #REQUIRED
294 |           layer         %Layer;        #REQUIRED
295 |           roundness     %Int;          "0"
296 |           rot           %Rotation;     "R0"
297 |           stop          %Bool;         "yes"
298 |           thermals      %Bool;         "yes"
299 |           cream         %Bool;         "yes"
300 |           >
301 | 
302 | <!ELEMENT element (attribute*, variant*)>
303 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
304 | <!ATTLIST element
305 |           name          %String;       #REQUIRED
306 |           library       %String;       #REQUIRED
307 |           package       %String;       #REQUIRED
308 |           value         %String;       #REQUIRED
309 |           x             %Coord;        #REQUIRED
310 |           y             %Coord;        #REQUIRED
311 |           locked        %Bool;         "no"
312 |           populate      %Bool;         "yes"
313 |           smashed       %Bool;         "no"
314 |           rot           %Rotation;     "R0"
315 |           >
316 | 
317 | <!ELEMENT via EMPTY>
318 | <!ATTLIST via
319 |           x             %Coord;        #REQUIRED
320 |           y             %Coord;        #REQUIRED
321 |           extent        %Extent;       #REQUIRED
322 |           drill         %Dimension;    #REQUIRED
323 |           diameter      %Dimension;    "0"
324 |           shape         %ViaShape;     "round"
325 |           alwaysstop    %Bool;         "no"
326 |           >
327 | 
328 | <!ELEMENT polygon (vertex)*>
329 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
330 | <!ATTLIST polygon
331 |           width         %Dimension;    #REQUIRED
332 |           layer         %Layer;        #REQUIRED
333 |           spacing       %Dimension;    #IMPLIED
334 |           pour          %PolygonPour;  "solid"
335 |           isolate       %Dimension;    #IMPLIED
336 |           orphans       %Bool;         "no"
337 |           thermals      %Bool;         "yes"
338 |           rank          %Int;          "0"
339 |           >
340 |           <!-- isolate: Only in <signal> or <package> context -->
341 |           <!-- orphans: Only in <signal> context -->
342 |           <!-- thermals:Only in <signal> context -->
343 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
344 | 
345 | <!ELEMENT vertex EMPTY>
346 | <!ATTLIST vertex
347 |           x             %Coord;        #REQUIRED
348 |           y             %Coord;        #REQUIRED
349 |           curve         %WireCurve;    "0"
350 |           >
351 |           <!-- curve: The curvature from this vertex to the next one -->
352 | 
353 | <!ELEMENT pin EMPTY>
354 | <!ATTLIST pin
355 |           name          %String;       #REQUIRED
356 |           x             %Coord;        #REQUIRED
357 |           y             %Coord;        #REQUIRED
358 |           visible       %PinVisible;   "both"
359 |           length        %PinLength;    "long"
360 |           direction     %PinDirection; "io"
361 |           function      %PinFunction;  "none"
362 |           swaplevel     %Int;          "0"
363 |           rot           %Rotation;     "R0"
364 |           >
365 | 
366 | <!ELEMENT part (attribute*, variant*)>
367 | <!ATTLIST part
368 |           name          %String;       #REQUIRED
369 |           library       %String;       #REQUIRED
370 |           deviceset     %String;       #REQUIRED
371 |           device        %String;       #REQUIRED
372 |           technology    %String;       ""
373 |           value         %String;       #IMPLIED
374 |           >
375 | 
376 | <!ELEMENT port EMPTY>
377 | <!ATTLIST port
378 |           name          %String;       #REQUIRED
379 |           side          %Int;          #REQUIRED
380 |           coord         %Coord;        #REQUIRED
381 |           direction     %PortDirection; "io"
382 |           >
383 | 
384 | <!ELEMENT instance (attribute)*>
385 | <!ATTLIST instance
386 |           part          %String;       #REQUIRED
387 |           gate          %String;       #REQUIRED
388 |           x             %Coord;        #REQUIRED
389 |           y             %Coord;        #REQUIRED
390 |           smashed       %Bool;         "no"
391 |           rot           %Rotation;     "R0"
392 |           >
393 |           <!-- rot: Only 0, 90, 180 or 270 -->
394 | 
395 | <!ELEMENT label EMPTY>
396 | <!ATTLIST label
397 |           x             %Coord;        #REQUIRED
398 |           y             %Coord;        #REQUIRED
399 |           size          %Dimension;    #REQUIRED
400 |           layer         %Layer;        #REQUIRED
401 |           font          %TextFont;     "proportional"
402 |           ratio         %Int;          "8"
403 |           rot           %Rotation;     "R0"
404 |           xref          %Bool;         "no"
405 |           >
406 |           <!-- rot:  Only 0, 90, 180 or 270 -->
407 |           <!-- xref: Only in <net> context -->
408 | 
409 | <!ELEMENT junction EMPTY>
410 | <!ATTLIST junction
411 |           x             %Coord;        #REQUIRED
412 |           y             %Coord;        #REQUIRED
413 |           >
414 | 
415 | <!ELEMENT connect EMPTY>
416 | <!ATTLIST connect
417 |           gate          %String;       #REQUIRED
418 |           pin           %String;       #REQUIRED
419 |           pad           %String;       #REQUIRED
420 |           route         %ContactRoute; "all"
421 |           >
422 | 
423 | <!ELEMENT technology (attribute)*>
424 | <!ATTLIST technology
425 |           name          %String;       #REQUIRED
426 |           >
427 | 
428 | <!ELEMENT attribute EMPTY>
429 | <!ATTLIST attribute
430 |           name          %String;       #REQUIRED
431 |           value         %String;       #IMPLIED
432 |           x             %Coord;        #IMPLIED
433 |           y             %Coord;        #IMPLIED
434 |           size          %Dimension;    #IMPLIED
435 |           layer         %Layer;        #IMPLIED
436 |           font          %TextFont;     #IMPLIED
437 |           ratio         %Int;          #IMPLIED
438 |           rot           %Rotation;     "R0"
439 |           display       %AttributeDisplay; "value"
440 |           constant      %Bool;         "no"
441 |           >
442 |           <!-- display: Only in <element> or <instance> context -->
443 |           <!-- constant:Only in <device> context -->
444 | 
445 | <!ELEMENT pinref EMPTY>
446 | <!ATTLIST pinref
447 |           part          %String;       #REQUIRED
448 |           gate          %String;       #REQUIRED
449 |           pin           %String;       #REQUIRED
450 |           >
451 | 
452 | <!ELEMENT contactref EMPTY>
453 | <!ATTLIST contactref
454 |           element       %String;       #REQUIRED
455 |           pad           %String;       #REQUIRED
456 |           route         %ContactRoute; "all"
457 |           routetag      %String;       ""
458 |           >
459 | 
460 | <!ELEMENT portref EMPTY>
461 | <!ATTLIST portref
462 |           moduleinst    %String;       #REQUIRED
463 |           port          %String;       #REQUIRED
464 |           >
465 | 
466 | <!-- ### Object lists ##################################################### -->
467 | 
468 | <!ELEMENT variantdefs (variantdef)*>
469 | <!ELEMENT settings (setting)*>
470 | <!ELEMENT modules (module)*>
471 | <!ELEMENT moduleinsts (moduleinst)*>
472 | <!ELEMENT ports (port)*>
473 | <!ELEMENT sheets (sheet)*>
474 | <!ELEMENT layers (layer)*>
475 | <!ELEMENT packages (package)*>
476 | <!ELEMENT symbols (symbol)*>
477 | <!ELEMENT devicesets (deviceset)*>
478 | <!ELEMENT gates (gate)*>
479 | <!ELEMENT devices (device)*>
480 | <!ELEMENT libraries (library)*>
481 | <!ELEMENT connects (connect)*>
482 | <!ELEMENT technologies (technology)*>
483 | <!ELEMENT attributes (attribute)*>
484 | <!ELEMENT classes (class)*>
485 | <!ELEMENT parts (part)*>
486 | <!ELEMENT instances (instance)*>
487 | <!ELEMENT errors (approved)*>
488 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
489 | <!ELEMENT autorouter (pass)*>
490 | <!ELEMENT elements (element)*>
491 | <!ELEMENT signals (signal)*>
492 | <!ELEMENT busses (bus)*>
493 | <!ELEMENT nets (net)*>
494 | 
495 | <!-- ### Miscellaneous objects ############################################ -->
496 | 
497 | <!ELEMENT setting EMPTY>
498 | <!ATTLIST setting
499 |           alwaysvectorfont %Bool;         #IMPLIED
500 |           verticaltext     %VerticalText; "up"
501 |           >
502 | 
503 | <!ELEMENT designrules (description*, param*)>
504 | <!ATTLIST designrules
505 |           name          %String;       #REQUIRED
506 |           >
507 | 
508 | <!ELEMENT grid EMPTY>
509 | <!ATTLIST grid
510 |           distance      %Real;         #IMPLIED
511 |           unitdist      %GridUnit;     #IMPLIED
512 |           unit          %GridUnit;     #IMPLIED
513 |           style         %GridStyle;    "lines"
514 |           multiple      %Int;          "1"
515 |           display       %Bool;         "no"
516 |           altdistance   %Real;         #IMPLIED
517 |           altunitdist   %GridUnit;     #IMPLIED
518 |           altunit       %GridUnit;     #IMPLIED
519 |           >
520 | 
521 | <!ELEMENT layer EMPTY>
522 | <!ATTLIST layer
523 |           number        %Layer;        #REQUIRED
524 |           name          %String;       #REQUIRED
525 |           color         %Int;          #REQUIRED
526 |           fill          %Int;          #REQUIRED
527 |           visible       %Bool;         "yes"
528 |           active        %Bool;         "yes"
529 |           >
530 | 
531 | <!ELEMENT class (clearance)*>
532 | <!ATTLIST class
533 |           number        %Class;        #REQUIRED
534 |           name          %String;       #REQUIRED
535 |           width         %Dimension;    "0"
536 |           drill         %Dimension;    "0"
537 |           >
538 | 
539 | <!ELEMENT clearance EMPTY>
540 | <!ATTLIST clearance
541 |           class         %Class;        #REQUIRED
542 |           value         %Dimension;    "0"
543 |           >
544 | 
545 | <!ELEMENT description (#PCDATA)>
546 | <!ATTLIST description
547 |           language      %String;       "en"
548 |           >
549 | 
550 | <!ELEMENT param EMPTY>
551 | <!ATTLIST param
552 |           name          %String;       #REQUIRED
553 |           value         %String;       #REQUIRED
554 |           >
555 | 
556 | <!ELEMENT pass (param)*>
557 | <!ATTLIST pass
558 |           name          %String;       #REQUIRED
559 |           refer         %String;       #IMPLIED
560 |           active        %Bool;         "yes"
561 |           >
562 | 
563 | <!ELEMENT approved EMPTY>
564 | <!ATTLIST approved
565 |           hash          %String;       #REQUIRED
566 |           >
567 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.5.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.5.0 DTD
  3 |   Copyright (c) 2015 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.5.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.5.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | <!ATTLIST board
 91 |           limitedwidth  %Dimension;    #IMPLIED
 92 |           >
 93 | 
 94 | <!-- ### High level objects ############################################### -->
 95 | 
 96 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 97 | 
 98 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 99 | <!ATTLIST package
100 |           name          %String;       #REQUIRED
101 |           >
102 | 
103 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
104 | <!ATTLIST symbol
105 |           name          %String;       #REQUIRED
106 |           >
107 | 
108 | <!ELEMENT deviceset (description?, gates, devices)>
109 | <!ATTLIST deviceset
110 |           name          %String;       #REQUIRED
111 |           prefix        %String;       ""
112 |           uservalue     %Bool;         "no"
113 |           >
114 | 
115 | <!ELEMENT device (connects?, technologies?)>
116 | <!ATTLIST device
117 |           name          %String;       ""
118 |           package       %String;       #IMPLIED
119 |           >
120 | 
121 | <!ELEMENT bus (segment)*>
122 | <!ATTLIST bus
123 |           name          %String;       #REQUIRED
124 |           >
125 | 
126 | <!ELEMENT net (segment)*>
127 | <!ATTLIST net
128 |           name          %String;       #REQUIRED
129 |           class         %Class;        "0"
130 |           >
131 | 
132 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
133 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
134 | 
135 | <!ELEMENT signal (contactref | polygon | wire | via)*>
136 | <!ATTLIST signal
137 |           name          %String;       #REQUIRED
138 |           class         %Class;        "0"
139 |           airwireshidden %Bool;        "no"
140 |           >
141 | 
142 | <!-- ### Basic objects #################################################### -->
143 | 
144 | <!ELEMENT moduleinst (attribute)*>
145 | <!ATTLIST moduleinst
146 |           name          %String;       #REQUIRED
147 |           module        %String;       #REQUIRED
148 |           modulevariant %String;       ""
149 |           x             %Coord;        #REQUIRED
150 |           y             %Coord;        #REQUIRED
151 |           offset        %Int;          "0"
152 |           smashed       %Bool;         "no"
153 |           rot           %Rotation;     "R0"
154 |           >
155 |           <!-- rot: Only 0, 90, 180 or 270 -->
156 | 
157 | <!ELEMENT variantdef EMPTY>
158 | <!ATTLIST variantdef
159 |           name          %String;       #REQUIRED
160 |           current       %Bool;         "no"
161 |           >
162 | 
163 | <!ELEMENT variant EMPTY>
164 | <!ATTLIST variant
165 |           name          %String;       #REQUIRED
166 |           populate      %Bool;         "yes"
167 |           value         %String;       #IMPLIED
168 |           technology    %String;       #IMPLIED
169 |           >
170 |           <!-- technology: Only in part context -->
171 | 
172 | <!ELEMENT gate EMPTY>
173 | <!ATTLIST gate
174 |           name          %String;       #REQUIRED
175 |           symbol        %String;       #REQUIRED
176 |           x             %Coord;        #REQUIRED
177 |           y             %Coord;        #REQUIRED
178 |           addlevel      %GateAddLevel; "next"
179 |           swaplevel     %Int;          "0"
180 |           >
181 | 
182 | <!ELEMENT wire EMPTY>
183 | <!ATTLIST wire
184 |           x1            %Coord;        #REQUIRED
185 |           y1            %Coord;        #REQUIRED
186 |           x2            %Coord;        #REQUIRED
187 |           y2            %Coord;        #REQUIRED
188 |           width         %Dimension;    #REQUIRED
189 |           layer         %Layer;        #REQUIRED
190 |           extent        %Extent;       #IMPLIED
191 |           style         %WireStyle;    "continuous"
192 |           curve         %WireCurve;    "0"
193 |           cap           %WireCap;      "round"
194 |           >
195 |           <!-- extent: Only applicable for airwires -->
196 |           <!-- cap   : Only applicable if 'curve' is not zero -->
197 | 
198 | <!ELEMENT dimension EMPTY>
199 | <!ATTLIST dimension
200 |           x1            %Coord;        #REQUIRED
201 |           y1            %Coord;        #REQUIRED
202 |           x2            %Coord;        #REQUIRED
203 |           y2            %Coord;        #REQUIRED
204 |           x3            %Coord;        #REQUIRED
205 |           y3            %Coord;        #REQUIRED
206 |           layer         %Layer;        #REQUIRED
207 |           dtype         %DimensionType; "parallel"
208 |           width         %Dimension;    #REQUIRED
209 |           extwidth      %Dimension;    "0"
210 |           extlength     %Dimension;    "0"
211 |           extoffset     %Dimension;    "0"
212 |           textsize      %Dimension;    #REQUIRED
213 |           textratio     %Int;          "8"
214 |           unit          %GridUnit;     "mm"
215 |           precision     %Int;          "2"
216 |           visible       %Bool;         "no"
217 |           >
218 | 
219 | <!ELEMENT text (#PCDATA)>
220 | <!ATTLIST text
221 |           x             %Coord;        #REQUIRED
222 |           y             %Coord;        #REQUIRED
223 |           size          %Dimension;    #REQUIRED
224 |           layer         %Layer;        #REQUIRED
225 |           font          %TextFont;     "proportional"
226 |           ratio         %Int;          "8"
227 |           rot           %Rotation;     "R0"
228 |           align         %Align;        "bottom-left"
229 |           distance      %Int;          "50"
230 |           >
231 | 
232 | <!ELEMENT circle EMPTY>
233 | <!ATTLIST circle
234 |           x             %Coord;        #REQUIRED
235 |           y             %Coord;        #REQUIRED
236 |           radius        %Coord;        #REQUIRED
237 |           width         %Dimension;    #REQUIRED
238 |           layer         %Layer;        #REQUIRED
239 |           >
240 | 
241 | <!ELEMENT rectangle EMPTY>
242 | <!ATTLIST rectangle
243 |           x1            %Coord;        #REQUIRED
244 |           y1            %Coord;        #REQUIRED
245 |           x2            %Coord;        #REQUIRED
246 |           y2            %Coord;        #REQUIRED
247 |           layer         %Layer;        #REQUIRED
248 |           rot           %Rotation;     "R0"
249 |           >
250 | 
251 | <!ELEMENT frame EMPTY>
252 | <!ATTLIST frame
253 |           x1            %Coord;       #REQUIRED
254 |           y1            %Coord;       #REQUIRED
255 |           x2            %Coord;       #REQUIRED
256 |           y2            %Coord;       #REQUIRED
257 |           columns       %Int;         #REQUIRED
258 |           rows          %Int;         #REQUIRED
259 |           layer         %Layer;       #REQUIRED
260 |           border-left   %Bool;        "yes"
261 |           border-top    %Bool;        "yes"
262 |           border-right  %Bool;        "yes"
263 |           border-bottom %Bool;        "yes"
264 |           >
265 | 
266 | <!ELEMENT hole EMPTY>
267 | <!ATTLIST hole
268 |           x             %Coord;        #REQUIRED
269 |           y             %Coord;        #REQUIRED
270 |           drill         %Dimension;    #REQUIRED
271 |           >
272 | 
273 | <!ELEMENT pad EMPTY>
274 | <!ATTLIST pad
275 |           name          %String;       #REQUIRED
276 |           x             %Coord;        #REQUIRED
277 |           y             %Coord;        #REQUIRED
278 |           drill         %Dimension;    #REQUIRED
279 |           diameter      %Dimension;    "0"
280 |           shape         %PadShape;     "round"
281 |           rot           %Rotation;     "R0"
282 |           stop          %Bool;         "yes"
283 |           thermals      %Bool;         "yes"
284 |           first         %Bool;         "no"
285 |           >
286 | 
287 | <!ELEMENT smd EMPTY>
288 | <!ATTLIST smd
289 |           name          %String;       #REQUIRED
290 |           x             %Coord;        #REQUIRED
291 |           y             %Coord;        #REQUIRED
292 |           dx            %Dimension;    #REQUIRED
293 |           dy            %Dimension;    #REQUIRED
294 |           layer         %Layer;        #REQUIRED
295 |           roundness     %Int;          "0"
296 |           rot           %Rotation;     "R0"
297 |           stop          %Bool;         "yes"
298 |           thermals      %Bool;         "yes"
299 |           cream         %Bool;         "yes"
300 |           >
301 | 
302 | <!ELEMENT element (attribute*, variant*)>
303 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
304 | <!ATTLIST element
305 |           name          %String;       #REQUIRED
306 |           library       %String;       #REQUIRED
307 |           package       %String;       #REQUIRED
308 |           value         %String;       #REQUIRED
309 |           x             %Coord;        #REQUIRED
310 |           y             %Coord;        #REQUIRED
311 |           locked        %Bool;         "no"
312 |           populate      %Bool;         "yes"
313 |           smashed       %Bool;         "no"
314 |           rot           %Rotation;     "R0"
315 |           >
316 | 
317 | <!ELEMENT via EMPTY>
318 | <!ATTLIST via
319 |           x             %Coord;        #REQUIRED
320 |           y             %Coord;        #REQUIRED
321 |           extent        %Extent;       #REQUIRED
322 |           drill         %Dimension;    #REQUIRED
323 |           diameter      %Dimension;    "0"
324 |           shape         %ViaShape;     "round"
325 |           alwaysstop    %Bool;         "no"
326 |           >
327 | 
328 | <!ELEMENT polygon (vertex)*>
329 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
330 | <!ATTLIST polygon
331 |           width         %Dimension;    #REQUIRED
332 |           layer         %Layer;        #REQUIRED
333 |           spacing       %Dimension;    #IMPLIED
334 |           pour          %PolygonPour;  "solid"
335 |           isolate       %Dimension;    #IMPLIED
336 |           orphans       %Bool;         "no"
337 |           thermals      %Bool;         "yes"
338 |           rank          %Int;          "0"
339 |           >
340 |           <!-- isolate: Only in <signal> or <package> context -->
341 |           <!-- orphans: Only in <signal> context -->
342 |           <!-- thermals:Only in <signal> context -->
343 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
344 | 
345 | <!ELEMENT vertex EMPTY>
346 | <!ATTLIST vertex
347 |           x             %Coord;        #REQUIRED
348 |           y             %Coord;        #REQUIRED
349 |           curve         %WireCurve;    "0"
350 |           >
351 |           <!-- curve: The curvature from this vertex to the next one -->
352 | 
353 | <!ELEMENT pin EMPTY>
354 | <!ATTLIST pin
355 |           name          %String;       #REQUIRED
356 |           x             %Coord;        #REQUIRED
357 |           y             %Coord;        #REQUIRED
358 |           visible       %PinVisible;   "both"
359 |           length        %PinLength;    "long"
360 |           direction     %PinDirection; "io"
361 |           function      %PinFunction;  "none"
362 |           swaplevel     %Int;          "0"
363 |           rot           %Rotation;     "R0"
364 |           >
365 | 
366 | <!ELEMENT part (attribute*, variant*)>
367 | <!ATTLIST part
368 |           name          %String;       #REQUIRED
369 |           library       %String;       #REQUIRED
370 |           deviceset     %String;       #REQUIRED
371 |           device        %String;       #REQUIRED
372 |           technology    %String;       ""
373 |           value         %String;       #IMPLIED
374 |           >
375 | 
376 | <!ELEMENT port EMPTY>
377 | <!ATTLIST port
378 |           name          %String;       #REQUIRED
379 |           side          %Int;          #REQUIRED
380 |           coord         %Coord;        #REQUIRED
381 |           direction     %PortDirection; "io"
382 |           >
383 | 
384 | <!ELEMENT instance (attribute)*>
385 | <!ATTLIST instance
386 |           part          %String;       #REQUIRED
387 |           gate          %String;       #REQUIRED
388 |           x             %Coord;        #REQUIRED
389 |           y             %Coord;        #REQUIRED
390 |           smashed       %Bool;         "no"
391 |           rot           %Rotation;     "R0"
392 |           >
393 |           <!-- rot: Only 0, 90, 180 or 270 -->
394 | 
395 | <!ELEMENT label EMPTY>
396 | <!ATTLIST label
397 |           x             %Coord;        #REQUIRED
398 |           y             %Coord;        #REQUIRED
399 |           size          %Dimension;    #REQUIRED
400 |           layer         %Layer;        #REQUIRED
401 |           font          %TextFont;     "proportional"
402 |           ratio         %Int;          "8"
403 |           rot           %Rotation;     "R0"
404 |           xref          %Bool;         "no"
405 |           >
406 |           <!-- rot:  Only 0, 90, 180 or 270 -->
407 |           <!-- xref: Only in <net> context -->
408 | 
409 | <!ELEMENT junction EMPTY>
410 | <!ATTLIST junction
411 |           x             %Coord;        #REQUIRED
412 |           y             %Coord;        #REQUIRED
413 |           >
414 | 
415 | <!ELEMENT connect EMPTY>
416 | <!ATTLIST connect
417 |           gate          %String;       #REQUIRED
418 |           pin           %String;       #REQUIRED
419 |           pad           %String;       #REQUIRED
420 |           route         %ContactRoute; "all"
421 |           >
422 | 
423 | <!ELEMENT technology (attribute)*>
424 | <!ATTLIST technology
425 |           name          %String;       #REQUIRED
426 |           >
427 | 
428 | <!ELEMENT attribute EMPTY>
429 | <!ATTLIST attribute
430 |           name          %String;       #REQUIRED
431 |           value         %String;       #IMPLIED
432 |           x             %Coord;        #IMPLIED
433 |           y             %Coord;        #IMPLIED
434 |           size          %Dimension;    #IMPLIED
435 |           layer         %Layer;        #IMPLIED
436 |           font          %TextFont;     #IMPLIED
437 |           ratio         %Int;          #IMPLIED
438 |           rot           %Rotation;     "R0"
439 |           display       %AttributeDisplay; "value"
440 |           constant      %Bool;         "no"
441 |           >
442 |           <!-- display: Only in <element> or <instance> context -->
443 |           <!-- constant:Only in <device> context -->
444 | 
445 | <!ELEMENT pinref EMPTY>
446 | <!ATTLIST pinref
447 |           part          %String;       #REQUIRED
448 |           gate          %String;       #REQUIRED
449 |           pin           %String;       #REQUIRED
450 |           >
451 | 
452 | <!ELEMENT contactref EMPTY>
453 | <!ATTLIST contactref
454 |           element       %String;       #REQUIRED
455 |           pad           %String;       #REQUIRED
456 |           route         %ContactRoute; "all"
457 |           routetag      %String;       ""
458 |           >
459 | 
460 | <!ELEMENT portref EMPTY>
461 | <!ATTLIST portref
462 |           moduleinst    %String;       #REQUIRED
463 |           port          %String;       #REQUIRED
464 |           >
465 | 
466 | <!-- ### Object lists ##################################################### -->
467 | 
468 | <!ELEMENT variantdefs (variantdef)*>
469 | <!ELEMENT settings (setting)*>
470 | <!ELEMENT modules (module)*>
471 | <!ELEMENT moduleinsts (moduleinst)*>
472 | <!ELEMENT ports (port)*>
473 | <!ELEMENT sheets (sheet)*>
474 | <!ELEMENT layers (layer)*>
475 | <!ELEMENT packages (package)*>
476 | <!ELEMENT symbols (symbol)*>
477 | <!ELEMENT devicesets (deviceset)*>
478 | <!ELEMENT gates (gate)*>
479 | <!ELEMENT devices (device)*>
480 | <!ELEMENT libraries (library)*>
481 | <!ELEMENT connects (connect)*>
482 | <!ELEMENT technologies (technology)*>
483 | <!ELEMENT attributes (attribute)*>
484 | <!ELEMENT classes (class)*>
485 | <!ELEMENT parts (part)*>
486 | <!ELEMENT instances (instance)*>
487 | <!ELEMENT errors (approved)*>
488 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
489 | <!ELEMENT autorouter (pass)*>
490 | <!ELEMENT elements (element)*>
491 | <!ELEMENT signals (signal)*>
492 | <!ELEMENT busses (bus)*>
493 | <!ELEMENT nets (net)*>
494 | 
495 | <!-- ### Miscellaneous objects ############################################ -->
496 | 
497 | <!ELEMENT setting EMPTY>
498 | <!ATTLIST setting
499 |           alwaysvectorfont %Bool;         #IMPLIED
500 |           verticaltext     %VerticalText; "up"
501 |           >
502 | 
503 | <!ELEMENT designrules (description*, param*)>
504 | <!ATTLIST designrules
505 |           name          %String;       #REQUIRED
506 |           >
507 | 
508 | <!ELEMENT grid EMPTY>
509 | <!ATTLIST grid
510 |           distance      %Real;         #IMPLIED
511 |           unitdist      %GridUnit;     #IMPLIED
512 |           unit          %GridUnit;     #IMPLIED
513 |           style         %GridStyle;    "lines"
514 |           multiple      %Int;          "1"
515 |           display       %Bool;         "no"
516 |           altdistance   %Real;         #IMPLIED
517 |           altunitdist   %GridUnit;     #IMPLIED
518 |           altunit       %GridUnit;     #IMPLIED
519 |           >
520 | 
521 | <!ELEMENT layer EMPTY>
522 | <!ATTLIST layer
523 |           number        %Layer;        #REQUIRED
524 |           name          %String;       #REQUIRED
525 |           color         %Int;          #REQUIRED
526 |           fill          %Int;          #REQUIRED
527 |           visible       %Bool;         "yes"
528 |           active        %Bool;         "yes"
529 |           >
530 | 
531 | <!ELEMENT class (clearance)*>
532 | <!ATTLIST class
533 |           number        %Class;        #REQUIRED
534 |           name          %String;       #REQUIRED
535 |           width         %Dimension;    "0"
536 |           drill         %Dimension;    "0"
537 |           >
538 | 
539 | <!ELEMENT clearance EMPTY>
540 | <!ATTLIST clearance
541 |           class         %Class;        #REQUIRED
542 |           value         %Dimension;    "0"
543 |           >
544 | 
545 | <!ELEMENT description (#PCDATA)>
546 | <!ATTLIST description
547 |           language      %String;       "en"
548 |           >
549 | 
550 | <!ELEMENT param EMPTY>
551 | <!ATTLIST param
552 |           name          %String;       #REQUIRED
553 |           value         %String;       #REQUIRED
554 |           >
555 | 
556 | <!ELEMENT pass (param)*>
557 | <!ATTLIST pass
558 |           name          %String;       #REQUIRED
559 |           refer         %String;       #IMPLIED
560 |           active        %Bool;         "yes"
561 |           >
562 | 
563 | <!ELEMENT approved EMPTY>
564 | <!ATTLIST approved
565 |           hash          %String;       #REQUIRED
566 |           >
567 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.6.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.6.0 DTD
  3 |   Copyright (c) 2016 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.6.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.6.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | <!ATTLIST board
 91 |           limitedwidth  %Dimension;    #IMPLIED
 92 |           >
 93 | 
 94 | <!-- ### High level objects ############################################### -->
 95 | 
 96 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 97 | 
 98 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 99 | <!ATTLIST package
100 |           name          %String;       #REQUIRED
101 |           >
102 | 
103 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
104 | <!ATTLIST symbol
105 |           name          %String;       #REQUIRED
106 |           >
107 | 
108 | <!ELEMENT deviceset (description?, gates, devices)>
109 | <!ATTLIST deviceset
110 |           name          %String;       #REQUIRED
111 |           prefix        %String;       ""
112 |           uservalue     %Bool;         "no"
113 |           >
114 | 
115 | <!ELEMENT device (connects?, technologies?)>
116 | <!ATTLIST device
117 |           name          %String;       ""
118 |           package       %String;       #IMPLIED
119 |           >
120 | 
121 | <!ELEMENT bus (segment)*>
122 | <!ATTLIST bus
123 |           name          %String;       #REQUIRED
124 |           >
125 | 
126 | <!ELEMENT net (segment)*>
127 | <!ATTLIST net
128 |           name          %String;       #REQUIRED
129 |           class         %Class;        "0"
130 |           >
131 | 
132 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
133 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
134 | 
135 | <!ELEMENT signal (contactref | polygon | wire | via)*>
136 | <!ATTLIST signal
137 |           name          %String;       #REQUIRED
138 |           class         %Class;        "0"
139 |           airwireshidden %Bool;        "no"
140 |           >
141 | 
142 | <!-- ### Basic objects #################################################### -->
143 | 
144 | <!ELEMENT moduleinst (attribute)*>
145 | <!ATTLIST moduleinst
146 |           name          %String;       #REQUIRED
147 |           module        %String;       #REQUIRED
148 |           modulevariant %String;       ""
149 |           x             %Coord;        #REQUIRED
150 |           y             %Coord;        #REQUIRED
151 |           offset        %Int;          "0"
152 |           smashed       %Bool;         "no"
153 |           rot           %Rotation;     "R0"
154 |           >
155 |           <!-- rot: Only 0, 90, 180 or 270 -->
156 | 
157 | <!ELEMENT variantdef EMPTY>
158 | <!ATTLIST variantdef
159 |           name          %String;       #REQUIRED
160 |           current       %Bool;         "no"
161 |           >
162 | 
163 | <!ELEMENT variant EMPTY>
164 | <!ATTLIST variant
165 |           name          %String;       #REQUIRED
166 |           populate      %Bool;         "yes"
167 |           value         %String;       #IMPLIED
168 |           technology    %String;       #IMPLIED
169 |           >
170 |           <!-- technology: Only in part context -->
171 | 
172 | <!ELEMENT gate EMPTY>
173 | <!ATTLIST gate
174 |           name          %String;       #REQUIRED
175 |           symbol        %String;       #REQUIRED
176 |           x             %Coord;        #REQUIRED
177 |           y             %Coord;        #REQUIRED
178 |           addlevel      %GateAddLevel; "next"
179 |           swaplevel     %Int;          "0"
180 |           >
181 | 
182 | <!ELEMENT wire EMPTY>
183 | <!ATTLIST wire
184 |           x1            %Coord;        #REQUIRED
185 |           y1            %Coord;        #REQUIRED
186 |           x2            %Coord;        #REQUIRED
187 |           y2            %Coord;        #REQUIRED
188 |           width         %Dimension;    #REQUIRED
189 |           layer         %Layer;        #REQUIRED
190 |           extent        %Extent;       #IMPLIED
191 |           style         %WireStyle;    "continuous"
192 |           curve         %WireCurve;    "0"
193 |           cap           %WireCap;      "round"
194 |           >
195 |           <!-- extent: Only applicable for airwires -->
196 |           <!-- cap   : Only applicable if 'curve' is not zero -->
197 | 
198 | <!ELEMENT dimension EMPTY>
199 | <!ATTLIST dimension
200 |           x1            %Coord;        #REQUIRED
201 |           y1            %Coord;        #REQUIRED
202 |           x2            %Coord;        #REQUIRED
203 |           y2            %Coord;        #REQUIRED
204 |           x3            %Coord;        #REQUIRED
205 |           y3            %Coord;        #REQUIRED
206 |           layer         %Layer;        #REQUIRED
207 |           dtype         %DimensionType; "parallel"
208 |           width         %Dimension;    #REQUIRED
209 |           extwidth      %Dimension;    "0"
210 |           extlength     %Dimension;    "0"
211 |           extoffset     %Dimension;    "0"
212 |           textsize      %Dimension;    #REQUIRED
213 |           textratio     %Int;          "8"
214 |           unit          %GridUnit;     "mm"
215 |           precision     %Int;          "2"
216 |           visible       %Bool;         "no"
217 |           >
218 | 
219 | <!ELEMENT text (#PCDATA)>
220 | <!ATTLIST text
221 |           x             %Coord;        #REQUIRED
222 |           y             %Coord;        #REQUIRED
223 |           size          %Dimension;    #REQUIRED
224 |           layer         %Layer;        #REQUIRED
225 |           font          %TextFont;     "proportional"
226 |           ratio         %Int;          "8"
227 |           rot           %Rotation;     "R0"
228 |           align         %Align;        "bottom-left"
229 |           distance      %Int;          "50"
230 |           >
231 | 
232 | <!ELEMENT circle EMPTY>
233 | <!ATTLIST circle
234 |           x             %Coord;        #REQUIRED
235 |           y             %Coord;        #REQUIRED
236 |           radius        %Coord;        #REQUIRED
237 |           width         %Dimension;    #REQUIRED
238 |           layer         %Layer;        #REQUIRED
239 |           >
240 | 
241 | <!ELEMENT rectangle EMPTY>
242 | <!ATTLIST rectangle
243 |           x1            %Coord;        #REQUIRED
244 |           y1            %Coord;        #REQUIRED
245 |           x2            %Coord;        #REQUIRED
246 |           y2            %Coord;        #REQUIRED
247 |           layer         %Layer;        #REQUIRED
248 |           rot           %Rotation;     "R0"
249 |           >
250 | 
251 | <!ELEMENT frame EMPTY>
252 | <!ATTLIST frame
253 |           x1            %Coord;       #REQUIRED
254 |           y1            %Coord;       #REQUIRED
255 |           x2            %Coord;       #REQUIRED
256 |           y2            %Coord;       #REQUIRED
257 |           columns       %Int;         #REQUIRED
258 |           rows          %Int;         #REQUIRED
259 |           layer         %Layer;       #REQUIRED
260 |           border-left   %Bool;        "yes"
261 |           border-top    %Bool;        "yes"
262 |           border-right  %Bool;        "yes"
263 |           border-bottom %Bool;        "yes"
264 |           >
265 | 
266 | <!ELEMENT hole EMPTY>
267 | <!ATTLIST hole
268 |           x             %Coord;        #REQUIRED
269 |           y             %Coord;        #REQUIRED
270 |           drill         %Dimension;    #REQUIRED
271 |           >
272 | 
273 | <!ELEMENT pad EMPTY>
274 | <!ATTLIST pad
275 |           name          %String;       #REQUIRED
276 |           x             %Coord;        #REQUIRED
277 |           y             %Coord;        #REQUIRED
278 |           drill         %Dimension;    #REQUIRED
279 |           diameter      %Dimension;    "0"
280 |           shape         %PadShape;     "round"
281 |           rot           %Rotation;     "R0"
282 |           stop          %Bool;         "yes"
283 |           thermals      %Bool;         "yes"
284 |           first         %Bool;         "no"
285 |           >
286 | 
287 | <!ELEMENT smd EMPTY>
288 | <!ATTLIST smd
289 |           name          %String;       #REQUIRED
290 |           x             %Coord;        #REQUIRED
291 |           y             %Coord;        #REQUIRED
292 |           dx            %Dimension;    #REQUIRED
293 |           dy            %Dimension;    #REQUIRED
294 |           layer         %Layer;        #REQUIRED
295 |           roundness     %Int;          "0"
296 |           rot           %Rotation;     "R0"
297 |           stop          %Bool;         "yes"
298 |           thermals      %Bool;         "yes"
299 |           cream         %Bool;         "yes"
300 |           >
301 | 
302 | <!ELEMENT element (attribute*, variant*)>
303 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
304 | <!ATTLIST element
305 |           name          %String;       #REQUIRED
306 |           library       %String;       #REQUIRED
307 |           package       %String;       #REQUIRED
308 |           value         %String;       #REQUIRED
309 |           x             %Coord;        #REQUIRED
310 |           y             %Coord;        #REQUIRED
311 |           locked        %Bool;         "no"
312 |           populate      %Bool;         "yes"
313 |           smashed       %Bool;         "no"
314 |           rot           %Rotation;     "R0"
315 |           >
316 | 
317 | <!ELEMENT via EMPTY>
318 | <!ATTLIST via
319 |           x             %Coord;        #REQUIRED
320 |           y             %Coord;        #REQUIRED
321 |           extent        %Extent;       #REQUIRED
322 |           drill         %Dimension;    #REQUIRED
323 |           diameter      %Dimension;    "0"
324 |           shape         %ViaShape;     "round"
325 |           alwaysstop    %Bool;         "no"
326 |           >
327 | 
328 | <!ELEMENT polygon (vertex)*>
329 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
330 | <!ATTLIST polygon
331 |           width         %Dimension;    #REQUIRED
332 |           layer         %Layer;        #REQUIRED
333 |           spacing       %Dimension;    #IMPLIED
334 |           pour          %PolygonPour;  "solid"
335 |           isolate       %Dimension;    #IMPLIED
336 |           orphans       %Bool;         "no"
337 |           thermals      %Bool;         "yes"
338 |           rank          %Int;          "0"
339 |           >
340 |           <!-- isolate: Only in <signal> or <package> context -->
341 |           <!-- orphans: Only in <signal> context -->
342 |           <!-- thermals:Only in <signal> context -->
343 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
344 | 
345 | <!ELEMENT vertex EMPTY>
346 | <!ATTLIST vertex
347 |           x             %Coord;        #REQUIRED
348 |           y             %Coord;        #REQUIRED
349 |           curve         %WireCurve;    "0"
350 |           >
351 |           <!-- curve: The curvature from this vertex to the next one -->
352 | 
353 | <!ELEMENT pin EMPTY>
354 | <!ATTLIST pin
355 |           name          %String;       #REQUIRED
356 |           x             %Coord;        #REQUIRED
357 |           y             %Coord;        #REQUIRED
358 |           visible       %PinVisible;   "both"
359 |           length        %PinLength;    "long"
360 |           direction     %PinDirection; "io"
361 |           function      %PinFunction;  "none"
362 |           swaplevel     %Int;          "0"
363 |           rot           %Rotation;     "R0"
364 |           >
365 | 
366 | <!ELEMENT part (attribute*, variant*)>
367 | <!ATTLIST part
368 |           name          %String;       #REQUIRED
369 |           library       %String;       #REQUIRED
370 |           deviceset     %String;       #REQUIRED
371 |           device        %String;       #REQUIRED
372 |           technology    %String;       ""
373 |           value         %String;       #IMPLIED
374 |           >
375 | 
376 | <!ELEMENT port EMPTY>
377 | <!ATTLIST port
378 |           name          %String;       #REQUIRED
379 |           side          %Int;          #REQUIRED
380 |           coord         %Coord;        #REQUIRED
381 |           direction     %PortDirection; "io"
382 |           >
383 | 
384 | <!ELEMENT instance (attribute)*>
385 | <!ATTLIST instance
386 |           part          %String;       #REQUIRED
387 |           gate          %String;       #REQUIRED
388 |           x             %Coord;        #REQUIRED
389 |           y             %Coord;        #REQUIRED
390 |           smashed       %Bool;         "no"
391 |           rot           %Rotation;     "R0"
392 |           >
393 |           <!-- rot: Only 0, 90, 180 or 270 -->
394 | 
395 | <!ELEMENT label EMPTY>
396 | <!ATTLIST label
397 |           x             %Coord;        #REQUIRED
398 |           y             %Coord;        #REQUIRED
399 |           size          %Dimension;    #REQUIRED
400 |           layer         %Layer;        #REQUIRED
401 |           font          %TextFont;     "proportional"
402 |           ratio         %Int;          "8"
403 |           rot           %Rotation;     "R0"
404 |           xref          %Bool;         "no"
405 |           >
406 |           <!-- rot:  Only 0, 90, 180 or 270 -->
407 |           <!-- xref: Only in <net> context -->
408 | 
409 | <!ELEMENT junction EMPTY>
410 | <!ATTLIST junction
411 |           x             %Coord;        #REQUIRED
412 |           y             %Coord;        #REQUIRED
413 |           >
414 | 
415 | <!ELEMENT connect EMPTY>
416 | <!ATTLIST connect
417 |           gate          %String;       #REQUIRED
418 |           pin           %String;       #REQUIRED
419 |           pad           %String;       #REQUIRED
420 |           route         %ContactRoute; "all"
421 |           >
422 | 
423 | <!ELEMENT technology (attribute)*>
424 | <!ATTLIST technology
425 |           name          %String;       #REQUIRED
426 |           >
427 | 
428 | <!ELEMENT attribute EMPTY>
429 | <!ATTLIST attribute
430 |           name          %String;       #REQUIRED
431 |           value         %String;       #IMPLIED
432 |           x             %Coord;        #IMPLIED
433 |           y             %Coord;        #IMPLIED
434 |           size          %Dimension;    #IMPLIED
435 |           layer         %Layer;        #IMPLIED
436 |           font          %TextFont;     #IMPLIED
437 |           ratio         %Int;          #IMPLIED
438 |           rot           %Rotation;     "R0"
439 |           display       %AttributeDisplay; "value"
440 |           constant      %Bool;         "no"
441 |           >
442 |           <!-- display: Only in <element> or <instance> context -->
443 |           <!-- constant:Only in <device> context -->
444 | 
445 | <!ELEMENT pinref EMPTY>
446 | <!ATTLIST pinref
447 |           part          %String;       #REQUIRED
448 |           gate          %String;       #REQUIRED
449 |           pin           %String;       #REQUIRED
450 |           >
451 | 
452 | <!ELEMENT contactref EMPTY>
453 | <!ATTLIST contactref
454 |           element       %String;       #REQUIRED
455 |           pad           %String;       #REQUIRED
456 |           route         %ContactRoute; "all"
457 |           routetag      %String;       ""
458 |           >
459 | 
460 | <!ELEMENT portref EMPTY>
461 | <!ATTLIST portref
462 |           moduleinst    %String;       #REQUIRED
463 |           port          %String;       #REQUIRED
464 |           >
465 | 
466 | <!-- ### Object lists ##################################################### -->
467 | 
468 | <!ELEMENT variantdefs (variantdef)*>
469 | <!ELEMENT settings (setting)*>
470 | <!ELEMENT modules (module)*>
471 | <!ELEMENT moduleinsts (moduleinst)*>
472 | <!ELEMENT ports (port)*>
473 | <!ELEMENT sheets (sheet)*>
474 | <!ELEMENT layers (layer)*>
475 | <!ELEMENT packages (package)*>
476 | <!ELEMENT symbols (symbol)*>
477 | <!ELEMENT devicesets (deviceset)*>
478 | <!ELEMENT gates (gate)*>
479 | <!ELEMENT devices (device)*>
480 | <!ELEMENT libraries (library)*>
481 | <!ELEMENT connects (connect)*>
482 | <!ELEMENT technologies (technology)*>
483 | <!ELEMENT attributes (attribute)*>
484 | <!ELEMENT classes (class)*>
485 | <!ELEMENT parts (part)*>
486 | <!ELEMENT instances (instance)*>
487 | <!ELEMENT errors (approved)*>
488 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
489 | <!ELEMENT autorouter (pass)*>
490 | <!ELEMENT elements (element)*>
491 | <!ELEMENT signals (signal)*>
492 | <!ELEMENT busses (bus)*>
493 | <!ELEMENT nets (net)*>
494 | 
495 | <!-- ### Miscellaneous objects ############################################ -->
496 | 
497 | <!ELEMENT setting EMPTY>
498 | <!ATTLIST setting
499 |           alwaysvectorfont %Bool;         #IMPLIED
500 |           verticaltext     %VerticalText; "up"
501 |           >
502 | 
503 | <!ELEMENT designrules (description*, param*)>
504 | <!ATTLIST designrules
505 |           name          %String;       #REQUIRED
506 |           >
507 | 
508 | <!ELEMENT grid EMPTY>
509 | <!ATTLIST grid
510 |           distance      %Real;         #IMPLIED
511 |           unitdist      %GridUnit;     #IMPLIED
512 |           unit          %GridUnit;     #IMPLIED
513 |           style         %GridStyle;    "lines"
514 |           multiple      %Int;          "1"
515 |           display       %Bool;         "no"
516 |           altdistance   %Real;         #IMPLIED
517 |           altunitdist   %GridUnit;     #IMPLIED
518 |           altunit       %GridUnit;     #IMPLIED
519 |           >
520 | 
521 | <!ELEMENT layer EMPTY>
522 | <!ATTLIST layer
523 |           number        %Layer;        #REQUIRED
524 |           name          %String;       #REQUIRED
525 |           color         %Int;          #REQUIRED
526 |           fill          %Int;          #REQUIRED
527 |           visible       %Bool;         "yes"
528 |           active        %Bool;         "yes"
529 |           >
530 | 
531 | <!ELEMENT class (clearance)*>
532 | <!ATTLIST class
533 |           number        %Class;        #REQUIRED
534 |           name          %String;       #REQUIRED
535 |           width         %Dimension;    "0"
536 |           drill         %Dimension;    "0"
537 |           >
538 | 
539 | <!ELEMENT clearance EMPTY>
540 | <!ATTLIST clearance
541 |           class         %Class;        #REQUIRED
542 |           value         %Dimension;    "0"
543 |           >
544 | 
545 | <!ELEMENT description (#PCDATA)>
546 | <!ATTLIST description
547 |           language      %String;       "en"
548 |           >
549 | 
550 | <!ELEMENT param EMPTY>
551 | <!ATTLIST param
552 |           name          %String;       #REQUIRED
553 |           value         %String;       #REQUIRED
554 |           >
555 | 
556 | <!ELEMENT pass (param)*>
557 | <!ATTLIST pass
558 |           name          %String;       #REQUIRED
559 |           refer         %String;       #IMPLIED
560 |           active        %Bool;         "yes"
561 |           >
562 | 
563 | <!ELEMENT approved EMPTY>
564 | <!ATTLIST approved
565 |           hash          %String;       #REQUIRED
566 |           >
567 | 


--------------------------------------------------------------------------------
/dtd/eagle-7.7.dtd:
--------------------------------------------------------------------------------
  1 | <!--
  2 |   EAGLE version 7.7.0 DTD
  3 |   Copyright (c) 2016 CadSoft Computer GmbH
  4 |   http://www.cadsoft.de
  5 | 
  6 |   This file describes the XML file format used by EAGLE version 7.7.0,
  7 |   hereafter referred to as the "EAGLE File Format".
  8 |   It is made available under the creative commons "CC BY-ND 3.0" license
  9 |   (see http://creativecommons.org/licenses/by-nd/3.0).
 10 |   You may use this file to implement a program that reads and/or writes files
 11 |   in the EAGLE File Format. If your program writes files in the EAGLE File
 12 |   Format, these files must be readable by EAGLE version 7.7.0
 13 |   without any error messages or warnings.
 14 | -->
 15 | 
 16 | <!-- ### Entity definitions ############################################### -->
 17 | 
 18 | <!ENTITY % Int               "CDATA"> <!-- an integer number -->
 19 | <!ENTITY % Real              "CDATA"> <!-- a real number -->
 20 | <!ENTITY % String            "CDATA"> <!-- a character string -->
 21 | <!ENTITY % Bool              "(no | yes)">
 22 | <!ENTITY % Coord             "%Real;"> <!-- coordinates, given in millimeters -->
 23 | <!ENTITY % Dimension         "%Real;"> <!-- dimensions, given in millimeters -->
 24 | <!ENTITY % Layer             "%Int;"> <!-- layer number -->
 25 | <!ENTITY % GridUnit          "(mic | mm | mil | inch)">
 26 | <!ENTITY % GridStyle         "(lines | dots)">
 27 | <!ENTITY % WireStyle         "(continuous | longdash | shortdash | dashdot)">
 28 | <!ENTITY % WireCap           "(flat | round)">
 29 | <!ENTITY % WireCurve         "%Real;"> <!-- curvature of a wire; allowed range: -359.9..359.9 -->
 30 | <!ENTITY % Class             "%Int;"> <!-- net class -->
 31 | <!ENTITY % PadShape          "(square | round | octagon | long | offset)">
 32 | <!ENTITY % ViaShape          "(square | round | octagon)">
 33 | <!ENTITY % TextFont          "(vector | proportional | fixed)">
 34 | <!ENTITY % Rotation          "CDATA"> <!-- rotation of an object; allowed range: [MSR]0..359.9 -->
 35 | <!ENTITY % AttributeDisplay  "(off | value | name | both)">
 36 | <!ENTITY % Extent            "%String;"> <!-- the layers a via or airwire extends through, given as "topmost-bottommost" -->
 37 | <!ENTITY % PolygonPour       "(solid | hatch | cutout)">
 38 | <!ENTITY % PinVisible        "(off | pad | pin | both)">
 39 | <!ENTITY % PinLength         "(point | short | middle | long)">
 40 | <!ENTITY % PinDirection      "(nc | in | out | io | oc | pwr | pas | hiz | sup)">
 41 | <!ENTITY % PinFunction       "(none | dot | clk | dotclk)">
 42 | <!ENTITY % PortDirection     "(nc | in | out | io | oc | pwr | pas | hiz)">
 43 | <!ENTITY % GateAddLevel      "(must | can | next | request | always)">
 44 | <!ENTITY % ContactRoute      "(all | any)">
 45 | <!ENTITY % DimensionType     "(parallel | horizontal | vertical | radius | diameter | leader)">
 46 | <!ENTITY % Severity          "(info | warning | error)">
 47 | <!ENTITY % Align             "(bottom-left | bottom-center | bottom-right | center-left | center | center-right | top-left | top-center | top-right)">
 48 | <!ENTITY % VerticalText      "(up | down)">
 49 | 
 50 | <!-- ### Drawing definitions ############################################## -->
 51 | 
 52 | <!ELEMENT eagle (compatibility?, drawing, compatibility?)>
 53 | <!ATTLIST eagle
 54 |           version       %Real;         #REQUIRED
 55 |           >
 56 |           <!-- version: The EAGLE program version that generated this file, in the form V.RR -->
 57 | 
 58 | <!ELEMENT compatibility (note)*>
 59 | 
 60 | <!ELEMENT note (#PCDATA)>
 61 | <!ATTLIST note
 62 |           version       %Real;         #REQUIRED
 63 |           severity      %Severity;     #REQUIRED
 64 |           >
 65 |           <!-- version: The EAGLE program version that introduced this compatibility note -->
 66 | 
 67 | <!ELEMENT drawing (settings?, grid?, layers, (library | schematic | board))>
 68 | 
 69 | <!ELEMENT library (description?, packages?, symbols?, devicesets?)>
 70 | <!ATTLIST library
 71 |           name          %String;       #REQUIRED
 72 |           >
 73 |           <!-- name: Only in libraries used inside boards or schematics -->
 74 | 
 75 | <!ELEMENT schematic (description?, libraries?, attributes?, variantdefs?, classes?, modules?, parts?, sheets?, errors?)>
 76 | <!ATTLIST schematic
 77 |           xreflabel     %String;       #IMPLIED
 78 |           xrefpart      %String;       #IMPLIED
 79 |           >
 80 | 
 81 | <!ELEMENT module (description?, ports?, variantdefs?, parts?, sheets?)>
 82 | <!ATTLIST module
 83 |           name          %String;       #REQUIRED
 84 |           prefix        %String;       ""
 85 |           dx            %Coord;        #REQUIRED
 86 |           dy            %Coord;        #REQUIRED
 87 |           >
 88 | 
 89 | <!ELEMENT board (description?, plain?, libraries?, attributes?, variantdefs?, classes?, designrules?, autorouter?, elements?, signals?, errors?)>
 90 | <!ATTLIST board
 91 |           limitedwidth  %Dimension;    #IMPLIED
 92 |           >
 93 | 
 94 | <!-- ### High level objects ############################################### -->
 95 | 
 96 | <!ELEMENT sheet (description?, plain?, moduleinsts?, instances?, busses?, nets?)>
 97 | 
 98 | <!ELEMENT package (description?, (polygon | wire | text | dimension | circle | rectangle | frame | hole | pad | smd)*)>
 99 | <!ATTLIST package
100 |           name          %String;       #REQUIRED
101 |           >
102 | 
103 | <!ELEMENT symbol (description?, (polygon | wire | text | dimension | pin | circle | rectangle | frame)*)>
104 | <!ATTLIST symbol
105 |           name          %String;       #REQUIRED
106 |           >
107 | 
108 | <!ELEMENT deviceset (description?, gates, devices)>
109 | <!ATTLIST deviceset
110 |           name          %String;       #REQUIRED
111 |           prefix        %String;       ""
112 |           uservalue     %Bool;         "no"
113 |           >
114 | 
115 | <!ELEMENT device (connects?, technologies?)>
116 | <!ATTLIST device
117 |           name          %String;       ""
118 |           package       %String;       #IMPLIED
119 |           >
120 | 
121 | <!ELEMENT bus (segment)*>
122 | <!ATTLIST bus
123 |           name          %String;       #REQUIRED
124 |           >
125 | 
126 | <!ELEMENT net (segment)*>
127 | <!ATTLIST net
128 |           name          %String;       #REQUIRED
129 |           class         %Class;        "0"
130 |           >
131 | 
132 | <!ELEMENT segment (pinref | portref | wire | junction | label)*>
133 |           <!-- 'pinref' and 'junction' are only valid in a <net> context -->
134 | 
135 | <!ELEMENT signal (contactref | polygon | wire | via)*>
136 | <!ATTLIST signal
137 |           name          %String;       #REQUIRED
138 |           class         %Class;        "0"
139 |           airwireshidden %Bool;        "no"
140 |           >
141 | 
142 | <!-- ### Basic objects #################################################### -->
143 | 
144 | <!ELEMENT moduleinst (attribute)*>
145 | <!ATTLIST moduleinst
146 |           name          %String;       #REQUIRED
147 |           module        %String;       #REQUIRED
148 |           modulevariant %String;       ""
149 |           x             %Coord;        #REQUIRED
150 |           y             %Coord;        #REQUIRED
151 |           offset        %Int;          "0"
152 |           smashed       %Bool;         "no"
153 |           rot           %Rotation;     "R0"
154 |           >
155 |           <!-- rot: Only 0, 90, 180 or 270 -->
156 | 
157 | <!ELEMENT variantdef EMPTY>
158 | <!ATTLIST variantdef
159 |           name          %String;       #REQUIRED
160 |           current       %Bool;         "no"
161 |           >
162 | 
163 | <!ELEMENT variant EMPTY>
164 | <!ATTLIST variant
165 |           name          %String;       #REQUIRED
166 |           populate      %Bool;         "yes"
167 |           value         %String;       #IMPLIED
168 |           technology    %String;       #IMPLIED
169 |           >
170 |           <!-- technology: Only in part context -->
171 | 
172 | <!ELEMENT gate EMPTY>
173 | <!ATTLIST gate
174 |           name          %String;       #REQUIRED
175 |           symbol        %String;       #REQUIRED
176 |           x             %Coord;        #REQUIRED
177 |           y             %Coord;        #REQUIRED
178 |           addlevel      %GateAddLevel; "next"
179 |           swaplevel     %Int;          "0"
180 |           >
181 | 
182 | <!ELEMENT wire EMPTY>
183 | <!ATTLIST wire
184 |           x1            %Coord;        #REQUIRED
185 |           y1            %Coord;        #REQUIRED
186 |           x2            %Coord;        #REQUIRED
187 |           y2            %Coord;        #REQUIRED
188 |           width         %Dimension;    #REQUIRED
189 |           layer         %Layer;        #REQUIRED
190 |           extent        %Extent;       #IMPLIED
191 |           style         %WireStyle;    "continuous"
192 |           curve         %WireCurve;    "0"
193 |           cap           %WireCap;      "round"
194 |           >
195 |           <!-- extent: Only applicable for airwires -->
196 |           <!-- cap   : Only applicable if 'curve' is not zero -->
197 | 
198 | <!ELEMENT dimension EMPTY>
199 | <!ATTLIST dimension
200 |           x1            %Coord;        #REQUIRED
201 |           y1            %Coord;        #REQUIRED
202 |           x2            %Coord;        #REQUIRED
203 |           y2            %Coord;        #REQUIRED
204 |           x3            %Coord;        #REQUIRED
205 |           y3            %Coord;        #REQUIRED
206 |           layer         %Layer;        #REQUIRED
207 |           dtype         %DimensionType; "parallel"
208 |           width         %Dimension;    #REQUIRED
209 |           extwidth      %Dimension;    "0"
210 |           extlength     %Dimension;    "0"
211 |           extoffset     %Dimension;    "0"
212 |           textsize      %Dimension;    #REQUIRED
213 |           textratio     %Int;          "8"
214 |           unit          %GridUnit;     "mm"
215 |           precision     %Int;          "2"
216 |           visible       %Bool;         "no"
217 |           >
218 | 
219 | <!ELEMENT text (#PCDATA)>
220 | <!ATTLIST text
221 |           x             %Coord;        #REQUIRED
222 |           y             %Coord;        #REQUIRED
223 |           size          %Dimension;    #REQUIRED
224 |           layer         %Layer;        #REQUIRED
225 |           font          %TextFont;     "proportional"
226 |           ratio         %Int;          "8"
227 |           rot           %Rotation;     "R0"
228 |           align         %Align;        "bottom-left"
229 |           distance      %Int;          "50"
230 |           >
231 | 
232 | <!ELEMENT circle EMPTY>
233 | <!ATTLIST circle
234 |           x             %Coord;        #REQUIRED
235 |           y             %Coord;        #REQUIRED
236 |           radius        %Coord;        #REQUIRED
237 |           width         %Dimension;    #REQUIRED
238 |           layer         %Layer;        #REQUIRED
239 |           >
240 | 
241 | <!ELEMENT rectangle EMPTY>
242 | <!ATTLIST rectangle
243 |           x1            %Coord;        #REQUIRED
244 |           y1            %Coord;        #REQUIRED
245 |           x2            %Coord;        #REQUIRED
246 |           y2            %Coord;        #REQUIRED
247 |           layer         %Layer;        #REQUIRED
248 |           rot           %Rotation;     "R0"
249 |           >
250 | 
251 | <!ELEMENT frame EMPTY>
252 | <!ATTLIST frame
253 |           x1            %Coord;       #REQUIRED
254 |           y1            %Coord;       #REQUIRED
255 |           x2            %Coord;       #REQUIRED
256 |           y2            %Coord;       #REQUIRED
257 |           columns       %Int;         #REQUIRED
258 |           rows          %Int;         #REQUIRED
259 |           layer         %Layer;       #REQUIRED
260 |           border-left   %Bool;        "yes"
261 |           border-top    %Bool;        "yes"
262 |           border-right  %Bool;        "yes"
263 |           border-bottom %Bool;        "yes"
264 |           >
265 | 
266 | <!ELEMENT hole EMPTY>
267 | <!ATTLIST hole
268 |           x             %Coord;        #REQUIRED
269 |           y             %Coord;        #REQUIRED
270 |           drill         %Dimension;    #REQUIRED
271 |           >
272 | 
273 | <!ELEMENT pad EMPTY>
274 | <!ATTLIST pad
275 |           name          %String;       #REQUIRED
276 |           x             %Coord;        #REQUIRED
277 |           y             %Coord;        #REQUIRED
278 |           drill         %Dimension;    #REQUIRED
279 |           diameter      %Dimension;    "0"
280 |           shape         %PadShape;     "round"
281 |           rot           %Rotation;     "R0"
282 |           stop          %Bool;         "yes"
283 |           thermals      %Bool;         "yes"
284 |           first         %Bool;         "no"
285 |           >
286 | 
287 | <!ELEMENT smd EMPTY>
288 | <!ATTLIST smd
289 |           name          %String;       #REQUIRED
290 |           x             %Coord;        #REQUIRED
291 |           y             %Coord;        #REQUIRED
292 |           dx            %Dimension;    #REQUIRED
293 |           dy            %Dimension;    #REQUIRED
294 |           layer         %Layer;        #REQUIRED
295 |           roundness     %Int;          "0"
296 |           rot           %Rotation;     "R0"
297 |           stop          %Bool;         "yes"
298 |           thermals      %Bool;         "yes"
299 |           cream         %Bool;         "yes"
300 |           >
301 | 
302 | <!ELEMENT element (attribute*, variant*)>
303 |           <!-- variant* is accepted only for compatibility with EAGLE 6.x files -->
304 | <!ATTLIST element
305 |           name          %String;       #REQUIRED
306 |           library       %String;       #REQUIRED
307 |           package       %String;       #REQUIRED
308 |           value         %String;       #REQUIRED
309 |           x             %Coord;        #REQUIRED
310 |           y             %Coord;        #REQUIRED
311 |           locked        %Bool;         "no"
312 |           populate      %Bool;         "yes"
313 |           smashed       %Bool;         "no"
314 |           rot           %Rotation;     "R0"
315 |           >
316 | 
317 | <!ELEMENT via EMPTY>
318 | <!ATTLIST via
319 |           x             %Coord;        #REQUIRED
320 |           y             %Coord;        #REQUIRED
321 |           extent        %Extent;       #REQUIRED
322 |           drill         %Dimension;    #REQUIRED
323 |           diameter      %Dimension;    "0"
324 |           shape         %ViaShape;     "round"
325 |           alwaysstop    %Bool;         "no"
326 |           >
327 | 
328 | <!ELEMENT polygon (vertex)*>
329 |           <!-- the vertices must define a valid polygon; if the last vertex is the same as the first one, it is ignored -->
330 | <!ATTLIST polygon
331 |           width         %Dimension;    #REQUIRED
332 |           layer         %Layer;        #REQUIRED
333 |           spacing       %Dimension;    #IMPLIED
334 |           pour          %PolygonPour;  "solid"
335 |           isolate       %Dimension;    #IMPLIED
336 |           orphans       %Bool;         "no"
337 |           thermals      %Bool;         "yes"
338 |           rank          %Int;          "0"
339 |           >
340 |           <!-- isolate: Only in <signal> or <package> context -->
341 |           <!-- orphans: Only in <signal> context -->
342 |           <!-- thermals:Only in <signal> context -->
343 |           <!-- rank:    1..6 in <signal> context, 0 or 7 in <package> context -->
344 | 
345 | <!ELEMENT vertex EMPTY>
346 | <!ATTLIST vertex
347 |           x             %Coord;        #REQUIRED
348 |           y             %Coord;        #REQUIRED
349 |           curve         %WireCurve;    "0"
350 |           >
351 |           <!-- curve: The curvature from this vertex to the next one -->
352 | 
353 | <!ELEMENT pin EMPTY>
354 | <!ATTLIST pin
355 |           name          %String;       #REQUIRED
356 |           x             %Coord;        #REQUIRED
357 |           y             %Coord;        #REQUIRED
358 |           visible       %PinVisible;   "both"
359 |           length        %PinLength;    "long"
360 |           direction     %PinDirection; "io"
361 |           function      %PinFunction;  "none"
362 |           swaplevel     %Int;          "0"
363 |           rot           %Rotation;     "R0"
364 |           >
365 | 
366 | <!ELEMENT part (attribute*, variant*)>
367 | <!ATTLIST part
368 |           name          %String;       #REQUIRED
369 |           library       %String;       #REQUIRED
370 |           deviceset     %String;       #REQUIRED
371 |           device        %String;       #REQUIRED
372 |           technology    %String;       ""
373 |           value         %String;       #IMPLIED
374 |           >
375 | 
376 | <!ELEMENT port EMPTY>
377 | <!ATTLIST port
378 |           name          %String;       #REQUIRED
379 |           side          %Int;          #REQUIRED
380 |           coord         %Coord;        #REQUIRED
381 |           direction     %PortDirection; "io"
382 |           >
383 | 
384 | <!ELEMENT instance (attribute)*>
385 | <!ATTLIST instance
386 |           part          %String;       #REQUIRED
387 |           gate          %String;       #REQUIRED
388 |           x             %Coord;        #REQUIRED
389 |           y             %Coord;        #REQUIRED
390 |           smashed       %Bool;         "no"
391 |           rot           %Rotation;     "R0"
392 |           >
393 |           <!-- rot: Only 0, 90, 180 or 270 -->
394 | 
395 | <!ELEMENT label EMPTY>
396 | <!ATTLIST label
397 |           x             %Coord;        #REQUIRED
398 |           y             %Coord;        #REQUIRED
399 |           size          %Dimension;    #REQUIRED
400 |           layer         %Layer;        #REQUIRED
401 |           font          %TextFont;     "proportional"
402 |           ratio         %Int;          "8"
403 |           rot           %Rotation;     "R0"
404 |           xref          %Bool;         "no"
405 |           >
406 |           <!-- rot:  Only 0, 90, 180 or 270 -->
407 |           <!-- xref: Only in <net> context -->
408 | 
409 | <!ELEMENT junction EMPTY>
410 | <!ATTLIST junction
411 |           x             %Coord;        #REQUIRED
412 |           y             %Coord;        #REQUIRED
413 |           >
414 | 
415 | <!ELEMENT connect EMPTY>
416 | <!ATTLIST connect
417 |           gate          %String;       #REQUIRED
418 |           pin           %String;       #REQUIRED
419 |           pad           %String;       #REQUIRED
420 |           route         %ContactRoute; "all"
421 |           >
422 | 
423 | <!ELEMENT technology (attribute)*>
424 | <!ATTLIST technology
425 |           name          %String;       #REQUIRED
426 |           >
427 | 
428 | <!ELEMENT attribute EMPTY>
429 | <!ATTLIST attribute
430 |           name          %String;       #REQUIRED
431 |           value         %String;       #IMPLIED
432 |           x             %Coord;        #IMPLIED
433 |           y             %Coord;        #IMPLIED
434 |           size          %Dimension;    #IMPLIED
435 |           layer         %Layer;        #IMPLIED
436 |           font          %TextFont;     #IMPLIED
437 |           ratio         %Int;          #IMPLIED
438 |           rot           %Rotation;     "R0"
439 |           display       %AttributeDisplay; "value"
440 |           constant      %Bool;         "no"
441 |           >
442 |           <!-- display: Only in <element> or <instance> context -->
443 |           <!-- constant:Only in <device> context -->
444 | 
445 | <!ELEMENT pinref EMPTY>
446 | <!ATTLIST pinref
447 |           part          %String;       #REQUIRED
448 |           gate          %String;       #REQUIRED
449 |           pin           %String;       #REQUIRED
450 |           >
451 | 
452 | <!ELEMENT contactref EMPTY>
453 | <!ATTLIST contactref
454 |           element       %String;       #REQUIRED
455 |           pad           %String;       #REQUIRED
456 |           route         %ContactRoute; "all"
457 |           routetag      %String;       ""
458 |           >
459 | 
460 | <!ELEMENT portref EMPTY>
461 | <!ATTLIST portref
462 |           moduleinst    %String;       #REQUIRED
463 |           port          %String;       #REQUIRED
464 |           >
465 | 
466 | <!-- ### Object lists ##################################################### -->
467 | 
468 | <!ELEMENT variantdefs (variantdef)*>
469 | <!ELEMENT settings (setting)*>
470 | <!ELEMENT modules (module)*>
471 | <!ELEMENT moduleinsts (moduleinst)*>
472 | <!ELEMENT ports (port)*>
473 | <!ELEMENT sheets (sheet)*>
474 | <!ELEMENT layers (layer)*>
475 | <!ELEMENT packages (package)*>
476 | <!ELEMENT symbols (symbol)*>
477 | <!ELEMENT devicesets (deviceset)*>
478 | <!ELEMENT gates (gate)*>
479 | <!ELEMENT devices (device)*>
480 | <!ELEMENT libraries (library)*>
481 | <!ELEMENT connects (connect)*>
482 | <!ELEMENT technologies (technology)*>
483 | <!ELEMENT attributes (attribute)*>
484 | <!ELEMENT classes (class)*>
485 | <!ELEMENT parts (part)*>
486 | <!ELEMENT instances (instance)*>
487 | <!ELEMENT errors (approved)*>
488 | <!ELEMENT plain (polygon | wire | text | dimension | circle | rectangle | frame | hole)*>
489 | <!ELEMENT autorouter (pass)*>
490 | <!ELEMENT elements (element)*>
491 | <!ELEMENT signals (signal)*>
492 | <!ELEMENT busses (bus)*>
493 | <!ELEMENT nets (net)*>
494 | 
495 | <!-- ### Miscellaneous objects ############################################ -->
496 | 
497 | <!ELEMENT setting EMPTY>
498 | <!ATTLIST setting
499 |           alwaysvectorfont %Bool;         #IMPLIED
500 |           verticaltext     %VerticalText; "up"
501 |           >
502 | 
503 | <!ELEMENT designrules (description*, param*)>
504 | <!ATTLIST designrules
505 |           name          %String;       #REQUIRED
506 |           >
507 | 
508 | <!ELEMENT grid EMPTY>
509 | <!ATTLIST grid
510 |           distance      %Real;         #IMPLIED
511 |           unitdist      %GridUnit;     #IMPLIED
512 |           unit          %GridUnit;     #IMPLIED
513 |           style         %GridStyle;    "lines"
514 |           multiple      %Int;          "1"
515 |           display       %Bool;         "no"
516 |           altdistance   %Real;         #IMPLIED
517 |           altunitdist   %GridUnit;     #IMPLIED
518 |           altunit       %GridUnit;     #IMPLIED
519 |           >
520 | 
521 | <!ELEMENT layer EMPTY>
522 | <!ATTLIST layer
523 |           number        %Layer;        #REQUIRED
524 |           name          %String;       #REQUIRED
525 |           color         %Int;          #REQUIRED
526 |           fill          %Int;          #REQUIRED
527 |           visible       %Bool;         "yes"
528 |           active        %Bool;         "yes"
529 |           >
530 | 
531 | <!ELEMENT class (clearance)*>
532 | <!ATTLIST class
533 |           number        %Class;        #REQUIRED
534 |           name          %String;       #REQUIRED
535 |           width         %Dimension;    "0"
536 |           drill         %Dimension;    "0"
537 |           >
538 | 
539 | <!ELEMENT clearance EMPTY>
540 | <!ATTLIST clearance
541 |           class         %Class;        #REQUIRED
542 |           value         %Dimension;    "0"
543 |           >
544 | 
545 | <!ELEMENT description (#PCDATA)>
546 | <!ATTLIST description
547 |           language      %String;       "en"
548 |           >
549 | 
550 | <!ELEMENT param EMPTY>
551 | <!ATTLIST param
552 |           name          %String;       #REQUIRED
553 |           value         %String;       #REQUIRED
554 |           >
555 | 
556 | <!ELEMENT pass (param)*>
557 | <!ATTLIST pass
558 |           name          %String;       #REQUIRED
559 |           refer         %String;       #IMPLIED
560 |           active        %Bool;         "yes"
561 |           >
562 | 
563 | <!ELEMENT approved EMPTY>
564 | <!ATTLIST approved
565 |           hash          %String;       #REQUIRED
566 |           >
567 | 


--------------------------------------------------------------------------------
/merge.py:
--------------------------------------------------------------------------------
  1 | #!/usr/bin/env python3
  2 | '''
  3 | Copyright (C) 2016  Povilas Kanapickas <povilas@radix.lt>
  4 | 
  5 | This program is free software: you can redistribute it and/or modify
  6 | it under the terms of the GNU General Public License as published by
  7 | the Free Software Foundation, either version 3 of the License, or
  8 | (at your option) any later version.
  9 | 
 10 | This program is distributed in the hope that it will be useful,
 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of
 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 13 | GNU General Public License for more details.
 14 | 
 15 | You should have received a copy of the GNU General Public License
 16 | along with this program.  If not, see http://www.gnu.org/licenses/.
 17 | '''
 18 | 
 19 | ''' We operate on the Eagle XML files directly instead of parsing them into
 20 |     some kind of intermediate structure. We only care about very limited subset
 21 |     of information, thus complete format support is unnecessary.
 22 | '''
 23 | 
 24 | from copy import deepcopy
 25 | import os
 26 | import sys
 27 | import lxml.etree as etree
 28 | from functools import cmp_to_key
 29 | import re
 30 | 
 31 | class InputFile:
 32 | 
 33 |     def __init__(self):
 34 |         self.path = None
 35 |         self.offsetx = 0
 36 |         self.offsety = 0
 37 |         self.rotation = 0
 38 | 
 39 | def print_usage_and_exit():
 40 |     print('''Usage:
 41 |     merge.py output-file [in-file [--offx offset-x] [--offy offset-y] [--rotation rotation]]...
 42 |     ''')
 43 |     sys.exit(1)
 44 | 
 45 | def print_file_error_and_exit(infile, el, err = "Unexpected element"):
 46 |     print("For file {0}".format(infile.path))
 47 |     print("Error : " + el.getroottree().getpath(el) + " : " + err)
 48 |     sys.exit(2)
 49 | 
 50 | def print_file_warning(infile, warn):
 51 |     print("For file {0}".format(infile.path))
 52 |     print("Warning : " + warn)
 53 | 
 54 | def parse_offset(val):
 55 |     if val.endswith('mm'):
 56 |         try:
 57 |             return float(val[:-2])
 58 |         except:
 59 |             pass
 60 | 
 61 |     print("Can't parse {0} as an offset value. Were units forgotten?".format(val))
 62 |     print_usage_and_exit()
 63 | 
 64 | def parse_rotation(val):
 65 |     if val in ['0', '90', '180', '270']:
 66 |         return int(val)
 67 |     print("Can't parse {0} as a rotation value. Supported rotations are 0, 90, 180, 270.".format(val))
 68 |     print_usage_and_exit()
 69 | 
 70 | def fetch_arg(num):
 71 |     if num >= len(sys.argv):
 72 |         print('Too few arguments specified. Expected at least one more')
 73 |         print_usage_and_exit()
 74 |     return sys.argv[num]
 75 | 
 76 | def parse_args():
 77 | 
 78 |     outfile = fetch_arg(1)
 79 |     infiles = []
 80 |     infile = None
 81 | 
 82 |     i = 2
 83 |     while i < len(sys.argv):
 84 |         arg = fetch_arg(i)
 85 |         if arg.startswith('-'):
 86 |             # Apply one option to current input file
 87 |             if arg == '--offx':
 88 |                 infile.offsetx = parse_offset(fetch_arg(i+1))
 89 |             elif arg == '--offy':
 90 |                 infile.offsety = parse_offset(fetch_arg(i+1))
 91 |             elif arg == '--rotation':
 92 |                 infile.rotation = parse_rotation(fetch_arg(i+1))
 93 |             else:
 94 |                 print("Unsupported option {0}".format(arg))
 95 |                 print_usage_and_exit()
 96 |             i = i + 2
 97 |         else:
 98 |             # Start with new input file
 99 |             if infile != None:
100 |                 infiles.append(infile)
101 |             infile = InputFile()
102 |             infile.path = arg
103 |             i = i + 1
104 | 
105 |     if infile != None:
106 |         infiles.append(infile)
107 | 
108 |     return (outfile, infiles)
109 | 
110 | ''' Retrieves a child of lxml element el which matches the given criteria:
111 |      * has matching tag
112 |      * has at least the given attributes with matching values. If None is
113 |         specified, any value is accepted
114 |     If child is not found, None is returned
115 | '''
116 | def find_child(el, tag, attrs = {}):
117 |     for child in el:
118 |         if child.tag == tag:
119 |             valid = True
120 |             for key in attrs:
121 |                 attr = child.get(key)
122 |                 if attr != attrs[key] and attrs[key] != None:
123 |                     valid = False
124 |             if valid:
125 |                 return child
126 |     return None
127 | 
128 | ''' Same as find_child, except that if the child is not fould, a new one with
129 |     the given tag is created.
130 | '''
131 | def find_or_create_child(el, tag, attrs = {}):
132 |     child = find_child(el, tag, attrs)
133 |     if child != None:
134 |         return child
135 |     return etree.SubElement(el, tag)
136 | 
137 | ''' Compares two Xml trees
138 | '''
139 | def xml_tree_compare(a, b):
140 |     # compare root node
141 |     if a.tag < b.tag:
142 |         return -1
143 |     elif a.tag > b.tag:
144 |         return 1
145 |     elif a.tail < b.tail:
146 |         return -1
147 |     elif a.tail > b.tail:
148 |         return 1
149 | 
150 |     # compare attributes
151 |     aitems = a.attrib.items()
152 |     aitems.sort()
153 |     bitems = b.attrib.items()
154 |     bitems.sort()
155 |     if aitems < bitems:
156 |         return -1
157 |     elif aitems > bitems:
158 |         return 1
159 | 
160 |     # compare child nodes
161 |     achildren = list(a)
162 |     achildren.sort(key=cmp_to_key(xml_tree_compare))
163 |     bchildren = list(b)
164 |     bchildren.sort(key=cmp_to_key(xml_tree_compare))
165 | 
166 |     for achild, bchild in zip(achildren, bchildren):
167 |         cmpval = xml_tree_compare(achild, bchild)
168 |         if  cmpval < 0:
169 |             return -1
170 |         elif cmpval > 0:
171 |             return 1
172 | 
173 |     # must be equal
174 |     return 0
175 | 
176 | def sync_child_error(el, tag, child, infile, err = None):
177 |     if err == None:
178 |         err = "Unsupported difference"
179 | 
180 |     el_child = find_child(el, tag)
181 |     if el_child == None:
182 |         el.append(deepcopy(child))
183 |     elif xml_tree_compare(el_child, child) != 0:
184 |         print_file_error_and_exit(infile, child, err + "\n" +
185 |                                     etree.tostring(el_child).decode() + "\n" +
186 |                                     etree.tostring(child).decode())
187 | 
188 | def sync_child(el, tag, child):
189 |     if find_child(el, tag) == None:
190 |         el.append(deepcopy(child))
191 | 
192 | # Merges /eagle/drawing/settings element
193 | def merge_xml_settings(out_el, in_el, infile):
194 |     for child in in_el:
195 |         if child.tag == "setting":
196 |             if len(child) > 0:
197 |                 print_file_error_and_exit(infile, child, "Expected empty")
198 | 
199 |             # find any setting matching attributes
200 |             attrs = child.attrib
201 |             attrs = { key : None for key, value in attrs.items() }
202 | 
203 |             found = find_child(out_el, "setting", attrs)
204 | 
205 |             if found == None:
206 |                 out_el.append(deepcopy(child))
207 |             else:
208 |                 # check if elements are equivalent
209 |                 if xml_tree_compare(found, child) != 0:
210 |                     print_file_warning(infile, "Incompatible settings \n" +
211 |                                        etree.tostring(found).decode() + "\n" +
212 |                                        etree.tostring(child).decode())
213 |         else:
214 |             print_file_error_and_exit(infile, child)
215 | 
216 |     if len(in_el.attrib) > 0:
217 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
218 | 
219 | # Merges /eagle/drawing/layers element
220 | def merge_xml_layers(out_el, in_el, infile):
221 |     # we only ensure that layer exists, layer info differences are ignored.
222 |     for child in in_el:
223 |         if child.tag == "layer":
224 |             if find_child(out_el, "layer", { "number" : child.get("number") }) == None:
225 |                 out_el.append(deepcopy(child))
226 |         else:
227 |             print_file_error_and_exit(infile, child)
228 | 
229 |     if len(in_el.attrib) > 0:
230 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
231 | 
232 | def offset_and_rotate(x, y, infile):
233 |     if infile.rotation == 0:
234 |         pass
235 |     elif infile.rotation == 90:
236 |         tmp = -y
237 |         y = x
238 |         x = tmp
239 |     elif infile.rotation == 180:
240 |         x = -x
241 |         y = -y
242 |     elif infile.rotation == 270:
243 |         tmp = y
244 |         y = -x
245 |         x = tmp
246 |     else:
247 |         assert False
248 | 
249 |     x += infile.offsetx
250 |     y += infile.offsety
251 |     return x, y
252 | 
253 | def update_xml_routing_pos(el, xattr, yattr, infile):
254 |     x = el.get(xattr)
255 |     y = el.get(yattr)
256 |     if x == None or y == None:
257 |         print_file_error_and_exit(infile, el)
258 |     x, y = offset_and_rotate(float(x), float(y), infile)
259 |     el.set(xattr, str(x))
260 |     el.set(yattr, str(y))
261 | 
262 | def update_xml_routing_rot(el, rotattr, infile):
263 |     rot = el.get(rotattr)
264 |     if rot == None or rot == "":
265 |         rot = "R0"
266 |     m = re.match(r"^([a-zA-Z]*)(\d+)$", rot)
267 |     if m == None:
268 |         print_file_error_and_exit(infile, el, "Unsupported rotation attribute " + rot)
269 |     prefix = m.group(1)
270 |     introt = int(m.group(2))
271 | 
272 |     # rotate mirrored parts to opposite direction
273 |     if "M" in prefix:
274 |         introt = (introt - infile.rotation) % 360
275 |     else:
276 |         introt = (introt + infile.rotation) % 360
277 |     rot = prefix + str(introt)
278 | 
279 |     if el.get(rotattr) == None and rot == "R0":
280 |         # no changes needed
281 |         return
282 |     el.set(rotattr, rot)
283 | 
284 | # Updates the elements within the following nodes and all their sub-nodes:
285 | # plain, signal, elements
286 | # This is where the actual position and rotation modifications are made
287 | def update_routing(el, infile):
288 |     if el.tag == "wire":
289 |         # in plain or signal
290 |         update_xml_routing_pos(el, "x1", "y1", infile)
291 |         update_xml_routing_pos(el, "x2", "y2", infile)
292 |     elif el.tag == "polygon":
293 |         # in plain or signal
294 |         for child in el:
295 |             update_routing(child, infile) # process vertex nodes
296 |     elif el.tag == "text":
297 |         # in plain
298 |         update_xml_routing_pos(el, "x", "y", infile)
299 |         update_xml_routing_rot(el, "rot", infile)
300 |     elif el.tag == "dimension":
301 |         # in plain
302 |         update_xml_routing_pos(el, "x1", "y1", infile)
303 |         update_xml_routing_pos(el, "x2", "y2", infile)
304 |         update_xml_routing_pos(el, "x3", "y3", infile)
305 |     elif el.tag == "circle":
306 |         # in plain
307 |         update_xml_routing_pos(el, "x", "y", infile)
308 |     elif el.tag == "rectangle":
309 |         # in plain
310 |         update_xml_routing_pos(el, "x1", "y1", infile)
311 |         update_xml_routing_pos(el, "x2", "y2", infile)
312 |         # note that we are ignoring rotation as it will be dealt with by
313 |         # changing the positions of the corners of the rectangle
314 |     elif el.tag == "frame":
315 |         # in plain
316 |         update_xml_routing_pos(el, "x1", "y1", infile)
317 |         update_xml_routing_pos(el, "x2", "y2", infile)
318 |     elif el.tag == "hole":
319 |         # in plain
320 |         update_xml_routing_pos(el, "x", "y", infile)
321 |     elif el.tag == "contactref":
322 |         # in signal
323 |         pass
324 |     elif el.tag == "via":
325 |         # in signal
326 |         update_xml_routing_pos(el, "x", "y", infile)
327 |     elif el.tag == "element":
328 |         # in elements
329 |         update_xml_routing_pos(el, "x", "y", infile)
330 |         update_xml_routing_rot(el, "rot", infile)
331 |         for child in el:
332 |             update_routing(child, infile) # process attribute or variant nodes
333 |     elif el.tag == "vertex":
334 |         # in polygon
335 |         update_xml_routing_pos(el, "x", "y", infile)
336 |     elif el.tag == "attribute":
337 |         # in element
338 |         update_xml_routing_pos(el, "x", "y", infile)
339 |         update_xml_routing_rot(el, "rot", infile)
340 |     elif el.tag == "variant":
341 |         # in element
342 |         pass
343 |     else:
344 |         print_file_error_and_exit(infile, el)
345 | 
346 | # Hides the current name label and adds a custom label that is displayed as if
347 | # the element has old_name.
348 | def override_name_label(el, old_name):
349 | 
350 |     if el.get("name") == old_name:
351 |         return
352 |     name_attr = find_child(el, "attribute", { "name" : "NAME" })
353 |     if name_attr == None:
354 |         return
355 |     name_attr_dup = deepcopy(name_attr)
356 |     name_attr_dup.set("name", "NAME1")
357 |     name_attr_dup.set("value", old_name)
358 |     el.append(name_attr_dup)
359 |     name_attr.set("display", "off")
360 | 
361 | # Merges /eagle/drawing/board/plain element
362 | def append_xml_plain(out_el, in_el, infile):
363 | 
364 |     for child in in_el:
365 |         new_child = deepcopy(child)
366 |         out_el.append(new_child)
367 |         update_routing(new_child, infile)
368 | 
369 |     if len(in_el.attrib) > 0:
370 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
371 | 
372 | # Merges /eagle/drawing/board/libraries/library/packages element
373 | def merge_xml_packages(out_el, in_el, infile):
374 | 
375 |     for child in in_el:
376 |         if child.tag == "package":
377 |             out_child = find_child(out_el, "package", { "name" : child.get("name") })
378 |             if out_child == None:
379 |                 out_el.append(deepcopy(child))
380 |             else:
381 |                 if xml_tree_compare(out_child, child) != 0:
382 |                     err = "Embedded libraries contain different packages of the same name {0}\n".format(child.get("name"))
383 |                     err += etree.tostring(out_child).decode() + "\n"
384 |                     err += etree.tostring(child).decode()
385 |                     print_file_error_and_exit(infile, child, err)
386 |         else:
387 |             print_file_error_and_exit(infile, child)
388 | 
389 |     if len(in_el.attrib) > 0:
390 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
391 | 
392 | # Merges /eagle/drawing/board/libraries/library element
393 | def merge_xml_library(out_el, in_el, infile):
394 |     assert out_el.get("name") == in_el.get("name")
395 | 
396 |     for child in in_el:
397 |         if child.tag == "description":
398 |             sync_child(out_el, "description", child)
399 |         elif child.tag == "packages":
400 |             merge_xml_packages(find_or_create_child(out_el, "packages"), child, infile)
401 |         else:
402 |             print_file_error_and_exit(infile, child)
403 | 
404 |     #if len(in_el.attrib) > 0:
405 |     #    print_file_error_and_exit(infile, in_el, "Unexpected attributes")
406 | 
407 | # Merges /eagle/drawing/board/libraries element
408 | def merge_xml_libraries(out_el, in_el, infile):
409 | 
410 |     for child in in_el:
411 |         if child.tag == "library":
412 |             out_child = find_child(out_el, "library", { "name" : child.get("name") })
413 |             if out_child == None:
414 |                 out_el.append(deepcopy(child))
415 |             else:
416 |                 merge_xml_library(out_child, child, infile)
417 |         else:
418 |             print_file_error_and_exit(infile, child)
419 | 
420 |     if len(in_el.attrib) > 0:
421 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
422 | 
423 | # Merges /eagle/drawing/board/elements element
424 | # Eagle requires that real names of elements are not duplicated, thus this
425 | # function ensures that a unique name is used. The label is overridden to
426 | # display the old name by defining a custom attribute.
427 | def append_xml_elements(out_el, in_el, element_map, infile):
428 | 
429 |     for child in in_el:
430 |         if child.tag == "element":
431 |             new_child = deepcopy(child)
432 |             update_routing(new_child, infile)
433 | 
434 |             # make sure the name of the new signal is unique
435 |             name = new_child.get("name")
436 |             prev_name = name
437 |             postfix = ""
438 |             postfix_num = 1
439 |             while find_child(out_el, "element", { "name" : name + postfix }) != None:
440 |                 postfix = "_" + str(postfix_num)
441 |                 postfix_num += 1
442 |             name = name + postfix
443 | 
444 |             new_child.set("name", name)
445 |             if name != prev_name:
446 |                 element_map[prev_name] = name
447 |                 override_name_label(new_child, prev_name)
448 | 
449 |             out_el.append(new_child)
450 |         else:
451 |             print_file_error_and_exit(infile, child)
452 | 
453 |     if len(in_el.attrib) > 0:
454 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
455 | 
456 | def update_signal_element_names(el, element_map):
457 |     if el.tag != "contactref":
458 |         return
459 |     name = el.get("element")
460 |     if name != None and name in element_map:
461 |         el.set("element", element_map[name])
462 | 
463 | # Merges /eagle/drawing/board/signals element
464 | def append_xml_signals(out_el, in_el, element_map, infile):
465 | 
466 |     for child in in_el:
467 |         if child.tag == "signal":
468 |             new_child = deepcopy(child)
469 |             for new_child2 in new_child:
470 |                 update_routing(new_child2, infile)
471 |                 update_signal_element_names(new_child2, element_map)
472 | 
473 |             # make sure the name of the new signal is unique
474 |             name = new_child.get("name")
475 |             postfix = ""
476 |             postfix_num = 1
477 |             while find_child(out_el, "signal", { "name" : name + postfix }) != None:
478 |                 postfix = str(postfix_num)
479 |                 postfix_num += 1
480 |             name = name + postfix
481 | 
482 |             new_child.set("name", name)
483 |             out_el.append(new_child)
484 |         else:
485 |             print_file_error_and_exit(infile, child)
486 | 
487 |     if len(in_el.attrib) > 0:
488 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
489 | 
490 | # Merges /eagle/drawing/board/errors element
491 | def append_xml_errors(out_el, in_el, infile):
492 |     # TODO
493 |     pass
494 | 
495 | # Merges /eagle/drawing/board element
496 | def merge_xml_board(out_el, in_el, infile):
497 | 
498 |     # Element names must be unique; this dict stores the old->new name mapping
499 |     element_map = {}
500 | 
501 |     for child in in_el:
502 |         if child.tag == "plain":
503 |             append_xml_plain(find_or_create_child(out_el, "plain"), child, infile)
504 |         elif child.tag == "libraries":
505 |             merge_xml_libraries(find_or_create_child(out_el, "libraries"), child, infile)
506 |         elif child.tag == "attributes":
507 |             sync_child_error(out_el, "attributes", child, infile) # differences not supported
508 |         elif child.tag == "variantdefs":
509 |             sync_child_error(out_el, "variantdefs", child, infile) # differences not supported
510 |         elif child.tag == "classes":
511 |             sync_child_error(out_el, "classes", child, infile) # differences not supported
512 |         elif child.tag == "designrules":
513 |             # ensure that design rule info is equivalent
514 |             sync_child_error(out_el, "designrules", child, infile, "Design rules must be equivalent")
515 |         elif child.tag == "autorouter":
516 |             # we just take the autorouter element of the first file it exists
517 |             sync_child(out_el, "autorouter", child)
518 |         elif child.tag == "elements":
519 |             append_xml_elements(find_or_create_child(out_el, "elements"), child, element_map, infile)
520 |         elif child.tag == "signals":
521 |             append_xml_signals(find_or_create_child(out_el, "signals"), child, element_map, infile)
522 |         elif child.tag == "errors":
523 |             append_xml_errors(find_or_create_child(out_el, "errors"), child, infile)
524 |         else:
525 |             print_file_error_and_exit(infile, child)
526 | 
527 |     if len(in_el.attrib) > 0:
528 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
529 | 
530 | # Merges /eagle/drawing element
531 | def merge_xml_drawing(out_el, in_el, infile):
532 | 
533 |     for child in in_el:
534 |         if child.tag == "settings":
535 |             merge_xml_settings(find_or_create_child(out_el, "settings"), child, infile)
536 |         elif child.tag == "grid":
537 |             # we just take the grid element of the first file
538 |             sync_child(out_el, "grid", child)
539 |         elif child.tag == "layers":
540 |             merge_xml_layers(find_or_create_child(out_el, "layers"), child, infile)
541 |         elif child.tag == "board":
542 |             merge_xml_board(find_or_create_child(out_el, "board"), child, infile)
543 |         else:
544 |             print_file_error_and_exit(infile, child)
545 | 
546 |     if len(in_el.attrib) > 0:
547 |         print_file_error_and_exit(infile, in_el, "Unexpected attributes")
548 | 
549 | # Merges /eagle element
550 | def merge_xml_eagle(out_el, in_el, infile):
551 |     assert out_el.tag == "eagle" and in_el.tag == "eagle"
552 | 
553 |     in_attrs = in_el.attrib
554 |     for attr in in_attrs:
555 |         if attr == "version":
556 |             in_version = in_el.get("version")
557 |             out_version = out_el.get("version")
558 |             if out_version == None:
559 |                 out_el.set("version", in_version)
560 |             else:
561 |                 if in_version != out_version:
562 |                     print_file_error_and_exit(infile, in_el,
563 |                                             "Eagle version mismatch: {0} != {1}".format(in_version, out_version))
564 |         else:
565 |             print_file_error_and_exit(infile, in_el, "Unexpected attributes")
566 | 
567 | 
568 |     for child in in_el:
569 |         if child.tag == "drawing":
570 |             merge_xml_drawing(find_or_create_child(out_el, "drawing"), child, infile)
571 |         elif child.tag == "compatibility":
572 |             print_file_warning(infile, "Compatibility notes ignored")
573 | 
574 | def main():
575 |     outfile, infiles = parse_args()
576 | 
577 |     out_el = etree.Element("eagle")
578 |     for infile in infiles:
579 |         if not os.path.exists(infile.path):
580 |             print("Input file {0} not found!".format(infile.path))
581 |             sys.exit(1)
582 | 
583 |         in_el = etree.parse(infile.path)
584 |         merge_xml_eagle(out_el, in_el.getroot(), infile)
585 | 
586 |     open(outfile, "wb").write(etree.tostring(out_el, xml_declaration=True,
587 |                                             encoding="UTF-8",
588 |                                             doctype="<!DOCTYPE eagle SYSTEM \"eagle.dtd\">"))
589 | 
590 | if __name__ == "__main__":
591 |     main()
592 | 


--------------------------------------------------------------------------------
/test/run.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 | 
3 | ../merge.py test_out.brd \
4 | 			test_in.brd	 \
5 | 			test_in.brd --offx 100mm --rotation 90 \
6 | 			test_in.brd --offx 100mm --offy 100mm --rotation 180 \
7 | 			test_in.brd --offy 100mm --rotation 270
8 | 


--------------------------------------------------------------------------------