Package Generator
Contents
The Package generator dialog
The "package generator" is made for easy creation of component packages including 3D view. It can be found in layout menu "Packages" and opens like this:
Image: The package generator dialog
It consists of three parts: A technical drawing to the left, which contains the definition of the parameters of the part. Such a drawing can be found in any data sheet. This image can not be modified here. Middle of the dialog you find the list of parameters, where all parameters can be entered according to the specifications of the data sheet. It is the basis for how the package later will look like. The abbreviations left of the equal sign are the same as in the technical drawing to the very left. Up to the right the package image can be seen the way it appears in the layout later. Below the 3D image can be seen.
The component type to be created can be selected from the list top left:
Image: The list of component types
If you select a DIL (Dual-In-Line) from the list, the dialog changes the way that DIL parameters can be entered.
Image: The dialog for a DIL
The button Unit mm (top center) wants to make clear that metric scale has prevailed against inch in component drawing. There is no inch-scale here.
The buttons Default, Load, Save in the center of the dialog refer to the set of values currently entered. One can save certain sets of values under an individual name and load them again. Or you might use the default setting.
The button Generate! opens the well known dialog for saving the part to the data base. Component type, component name, package description and manufacturer can be entered as usual and the process is finished. Regarding the buttons Edit and Debug please see the following chapters.
Quick creation of a package using the N-Pole type
If you are not a programmer and don't like to create a script on your own for a part which isn't represented here, you might use the package type N-Pole. Find it in the list here:
The idea is simply to have a package outline with a certain kind and number of pads in a row. You can import this "raw" to a layout, finish it correctly by pushing the pads on their correct place and save it again under a certain name. It might be the fact that the package won't come perfectly from the generator but the generator itself already has done a lot of constructive work. Now you might do corrections in the layout and save the part again. As you might know in the layout you can refine any part at any time and save it again (overwrite it or save it under a new name).
How to create a package script
What is a package script?
Each component type which you will find in the list top left is based on exactly one script. So what you see in the dialog windoe when selecting a certain component type is defined by a script. A package script is a program which determins the geometrical shape of all drawing elements of a package. It is called script because it is stored as a text. So one does not create a script for one singular more or less complicated package but always for a package kind or type. A package type normally is built up according to special geometrical rules, only the number of leads (this is the easiest case) varies. View the script of package type by pressing the button:
You can modify each script, save it under a different name ("Save as...") and then use it. When opening the package generator dialog again, the new script can be chosen from the list.
Button: opens the "Debugger" of the script.
The "Step" button in the debug dialog allows a step by step (= row by row) walk through the script in order to see what each script row effects for the image(s). So if bugs in the script would occur, one can easily find them and fix them. In the above dialog for example row 52 is responsible for the vertical line on the right edge of the package outline.
The setup of a script by an example
For the component type SIL (Single-In-Line) the script has the following look (syntax to the left, explanation to the right):
Script syntax (line by line) | Explanation |
---|---|
01 Script:"SIL (Single-In-Line)" | Name of the script, shown in the selection box top left. Active with the next opening of the generator. |
02 Hint:"Single-In-Line SIL/SIP THT packages" | Hint which appears in the dialog right beside the selection box. |
03 Comment:"TARGET 3001! package script, Unit mm" | All following in this line is comment. |
04 Author:"Steve Miller" | Author of the script. |
05 Date:"28.11.2013" | Date of last modification. Needs to be controled/managed manually. |
06 Image:"SIL.png" | File name of the image shown to the left. PNG-Image always 350x580 pixel. |
07 Num:N,7,"Number of pins",Edt | Declare numeric variable. Here the input box "Number of pins" is defined. Name, Default value, Hint, Display. Display missing=not shown, EDT=editable, RDO=Read-Only. Variable names need to start with one or more alphabetic character. Then numeric characters may follow. Upper case/lower case is not recignized. |
08 Num:W,2.5,"Width of case",Edt | dito. Input box "Width of case" is defined. |
09 Num:L,18,"Length of case",Edt | dito. Input box "Length of case" is defined. |
10 Num:H,5.1,"Height of case",Edt | dito. Input box "Height of case" is defined. |
11 Num:P,2.54,"Pitch of pins",Edt | dito. Input box "Pitch of pins" is defined. |
12 Num:A,0.6,"Width or radius of pins",Edt | dito. Input box "Width or radius of pins" is defined. |
13 Num:B,0.3,"Thickness of pins or zero",Edt | dito. Input box "Thickness of pins or zero" is defined. |
14 Num:C,1.5,"Width of pads",Edt | dito. Input box "Width of pads" is defined. |
15 Num:D,2.5,"Height of pads",Edt | dito. Input box "Height of pads" is defined. |
16 Num:E,0.9,"Diameter of drill holes",Edt | dito. Input box "Diameter of drill holes" is defined. |
17 Num:F,0.1,"Distance to PCB",Edt | dito. Input box "Distance to PCB" is defined. |
18 Str:Col,"$225522","Package color",Edt | Declare text variable. Name, Default value, Hint, Display. Display missing=not shown, EDT=editable, RDO=Read-Only. Colors need to be defined hexadecimally like $BBGGRR . The two B represent Blue, the two G represent Green and the two R represent Red. |
19 |
Blank line |
20 Comment:------------> Drawing |
Comment: The syntax of the package (land pattern with package outline) starts from here. |
21 |
Blank line |
22 Name:("SIL-"+N+"/"+L+"x"+W+"x"+H) |
This is how the proposal for a package name is created when pushing the "Generate" button. It is a string. The visible is denoted within quotes. Those characters added by a plus sign are variables. |
23 Type:"SIL / SIP (single in-line package)" |
Package type. Please inherit from data base "package types". |
24 Calc:X1=(N/2-0.5)*P |
Announce a calculation. Variable=Expression. More than on calculation separate by comma. Operators within the expression: +, -, *, /, (), mathematic functions, see below. |
25 For:I,1,N |
Begin a For-loop. Hereby iteratively is executed what line 26 defines: Variable name, Start value, End value, (step=1). Start value and End value can be expressions. |
26 Pad:-X1+P*(I-1),0,C,D,E,I,All,Oct |
Create a pad in the layout. X, Y, Width, Height, Drill diameter, Layer, Form, Rotation, (Padname=), (Solder paste=True), (Solder stop=True). |
27 EndFor |
Ende of the For loop. For loops can be nested. Colon optionally. |
28 Calc:X=L/2 |
Announce a calculation. Variable=Expression. More than on calculation separate by comma. Operators within the expression: +, -, *, /, (), mathematic functions, see below. |
29 Calc:Y=W/2 |
Announce a calculation. Variable=Expression. More than on calculation separate by comma. Operators within the expression: +, -, *, /, (), mathematic functions, see below. |
30 Line:-X,-Y,X,-Y,0.3 |
Draw a line in the layout. X1, Y1, X2, Y2, (Line width=0.3), (Layer Function=4=Position top).
|
31 Line:X,-Y,X,Y,0.3 |
Draw a line in the layout. X1, Y1, X2, Y2, (Line width=0.3), (Layer Function=4=Position top).
|
32 Line:X,Y,-X,Y,0.3 |
Draw a line in the layout. X1, Y1, X2, Y2, (Line width=0.3), (Layer Function=4=Position top).
|
33 Line:-X,Y,-X,-Y,0.3 |
Draw a line in the layout. X1, Y1, X2, Y2, (Line width=0.3), (Layer Function=4=Position top).
|
34 Calc:X=X1-P/2 |
Announce a calculation. Variable=Expression. More than on calculation separate by comma. Operators within the expression: +, -, *, /, (), mathematic functions, see below. |
35 Line:-X,Y,-X,-Y,0.3 |
Draw a line in the layout. X1, Y1, X2, Y2, (Line width=0.3), (Layer Function=4=Position top).
|
36 Text:-X+1.5,W/2+1,2.5,1.6,0,"!Name","DIN-ISO-ANSI" |
Display text in the layout. X, Y, Hight, Width, Rotation, Text content, Charcter set, (Layer function=4=Position top). |
37 Text:-X+1.5,-W/2-3.2,2.5,1.6,0,"!Value","DIN-ISO-ANSI" |
Display text in the layout. X, Y, Hight, Width, Rotation, Text content, Charcter set, (Layer function=4=Position top). |
38 Comment:------------> 3D |
Comment: The syntax of the 3D image starts from here. |
39 Solid:0,0,F,0,0,F+H,L,W,Col,0.4 |
Display a cuboid in 3D. X1, Y1, Z1, X2, Y2, Z2, Width, Height, Color, (Champfer radius=0). The Syntax for the 3D modelling applies. |
40 Text3D:-X1+1.5,-0.5,F+H+0.01,1.2,0.5,0,"DIN-ISO-ANSI","!Value",$FFFFFF |
Display text in the 3D image. X1, Y1, Z1, Height, Width, Rotation, Character set, Text content, Color. The Syntax for the 3D modelling applies. |
41 Cylinder:-X1,0,F+H-0.1,-X1,0,F+H+0.01,1,$FFFFFF |
Display cylinder in 3D. X1, Y1, Z1, X2, Y2, Z2, Diameter, Color, (Champfer radius=0). The Syntax for the 3D modelling applies. |
42 For:I,1,N |
For loop in order to create the 3D leads iteratively |
43 Calc:X2=-X1+P*(I-1),Y2=0,Z=(F+H)/2 |
Announcement of a calculation |
44 IF:B>0 |
Start If condition. Expression Operator Expression. Operators: =, <, >, <=, >=. Combine several conditions by & (=and). |
45 Solid:X2,Y2,-3,X2,Y2,0.1,A,B,$CCCCCC,0 |
Display a cuboid in 3D. X1, Y1, Z1, X2, Y2, Z2, Width, Height, Color, (Champfer radius=0). The Syntax for the 3D modelling applies. |
46 ELSE |
Else branch. Colon optional. |
47 Cylinder:X2,Y2,-3,X2,Y2,0.1,A,$CCCCCC |
Display cylinder in 3D. X1, Y1, Z1, X2, Y2, Z2, Diameter, Color, (Champfer radius=0). The Syntax for the 3D modelling applies. |
48 ENDIF |
End of the If condition. If conditions can be nested. Colon optional. |
49 EndFor | End of the For loop. For loops can be nested as well. Colon optional. |
Please note: The values of the variables for the current SIL package are denoted on the right hand side of the debugger dialog.
Script commands
General
Every textual indication (=string) is embedded in quotes. Example: "Hello".
Coordinate indications are in metric scale [mm]. If you look on the X-Y-plane, the positive Z-axis points upward to the spectator.
Numeric characters are rounded to 1/1000.
Angle indications are in 0...360 degrees [°].
The rotational direction is CCW (=CounterClockWise). 0° is east.
The right-hand-rule applies for all axes.
Colors are indicated hexadecimally according to $BBGGRR. B represents Blue, G represents Green and R represents Red.
Script commands in detail
These script commands exist currently:
- SCRIPT: Name des Scripts, der oben in der Auswahlbox gezeigt wird. Wirkt erst beim nächsten Öffnen des Generators.
- HINT: Hinweis, der oben neben der Auswahlbox gezeigt wird.
- COMMENT: Alles Folgende in dieser Zeile ist Kommentar
- AUTHOR: Autor des Scriptes
- DATE: Datum der letzten Änderung. Muss manuell geführt werden.
- IMAGE: Dateiname des Imagees, das links gezeigt wird. PNG-Image immer 350x580 Pixel.
- TYPE: Gehäusetyp. Bitte aus der Datenbank aus package_types entnehmen.
- NAME: So wird ein Vorschlag für den Gehäusenamen beim Generieren erzeugt.
- NUM: Numerische Variable deklarieren. Name, Defaultwert, Hinweis, Anzeige. Anzeige fehlt=wird nicht gezeigt, EDT=editierbar, RDO=Read-Only. Variablennamen müssen mit einem oder mehreren Buchstaben beginnen. Dann können Ziffern folgen. Groß- und Klein-Schreibung wird nicht unterschieden.
- STR: Text-Variable deklarieren. Name, Defaultwert, Hinweis, Anzeige. Anzeige fehlt=wird nicht gezeigt, EDT=editierbar, RDO=Read-Only.
- CALC: Berechnungen ankündigen. Variable=Ausdruck. Mehrere Berechnungen mit Komma trennen. Operatoren im Ausdruck: +, -, *, /, (), mathematische Funktionen:
- ABS(x) Absolutwert,
- SIN(x) Sinus [°],
- ASIN(x) Arcus Sinus,
- COS(x) Cosinus,
- ACOS(x) Arcus Cosinus,
- TAN(x) Tangens,
- ATAN(x) Arcus Tangens,
- MAX(x,y) Größerer Wert der Ausdrücke x und y,
- MIN(x,y) Kleinerer Wert der Ausdrücke x und y,
- INT(x) Gerundete Ganzzahl,
- SQR(x) Quadrat,
- SQRT(x) Quadratwurzel,
- EVEN(x) 1 wenn gerade, 0 wenn ungerade,
- ODD(x) 1 wenn ungerade, 0 wenn gerade.
- Berechnungen für Zeichenketten kennen nur den Operator + für Anhängen und die folgenden Funktionen:
- NCH(i) Number-Character: 1=A, 2=B, ... 21=Z, 22=AA, 23=AB, ... 42=AZ, 43=BA ... (z.B. für die Zeilen-Namen von BGA-Gehäusen)
- CHR(i) ASCII-Zeichen: 33=!, ... 65=A, 66=B, ... 90=Z, ... 97=a, 98=b, ... 122=z, ... 219=?
- INT(i) Gerundete Ganzahl
- REAL(i) Dezimalzahl mit maximal 3 Stellen
- FOR: For-Schleife beginnen. Variablenname, Startwert, Endwert, (Schritt=1). Startwert und Endwert können Ausdrücke sein.
- ENDFOR: Ende der For-Schleife. For-Schleifen können auch geschachtelt sein (nested). Doppelpunkt optional.
- IF: If-Abfrage beginnen. Ausdruck Operator Ausdruck. Operatoren: =, <, >, <=, >=. Mehrere Bedingungen mit & (=and) verbindbar.
- ELSE: Else Zweig. Doppelpunkt optional.
- ENDIF: Ende der If-Abfrage. If-Abfragen können geschachtelt sein (nested). Doppelpunkt optional.
- PAD: Pad im Layout erzeugen. X, Y, Breite, Höhe, Bohrdurchmesser, Ebene, Form, Rotation, (Padname=), (Lötpaste=True), (Lötstopp=True).
- Ebene = Top oder Bot oder All
- Form = Rnd oder Oct oder Rct oder Ovl
- Lötpaste = True oder False
- Lötstopp = True oder False
- Angaben in Klammern sind optional. Default wird verwendet.
- LINE: Linie im Layout zeichnen. X1, Y1, X2, Y2, (Linienbreite=0.3), (Ebenenfunktion=4=Bestückung oben).
- Ebenenfunktion: 3=Bestückung unten, 4=Bestückung oben, 12=Lötstopp oben, 15=Lötpaste oben, 16=Gold oben, 18=Kleber oben
- ARC: Bogen im Layout zeichnen. X, Y, Radius, Linienbreite, Startwinkel, Endwinkel, (Ebenenfunktion=4=Bestückung oben).
- CIRC: Scheibe im Layout zeichnen. X, Y, Radius, (Ebenenfunktion=4=Bestückung oben).
- TRI: Dreieck im Layout zeichnen. X1, Y1, X2, Y2, X3, Y3, (Ebenenfunktion=4=Bestückung oben).
- RECT: Rechteck im Layout zeichnen. X, Y, Breite, Höhe, Rotation, (Ebenenfunktion=4=Bestückung oben).
- TEXT: Text im Layout ausgeben. X, Y, Höhe, Breite, Rotation, Textinhalt, Zeichensatz, (Ebenenfunktion=4=Bestückung oben).
- !NAME und !VALUE als Textinhalt werden später in den Namen und den Wert des Bauteils gewandelt.
- Zeichensatz= TARGET oder DIN-ISO-ANSI oder Arial oder Times New Roman ...
- SOLID: Quader in 3D ausgeben. X1, Y1, Z1, X2, Y2, Z2, Breite, Höhe, Farbe, (Abrundungsradius=0).
- CYLINDER: Zylinder in 3D ausgeben. X1, Y1, Z1, X2, Y2, Z2, Durchmesser, Farbe, (Abrundungsradius=0).
- TORUS: Bogen in 3D ausgeben. X oder Y oder Z, Xm, Ym, Zm, Radius, Durchmesser, Startwinkel, Endwinkel, Farbe.
- SPHERE: Kugel in 3D ausgeben. Xm, Ym, Zm, Durchmesser, Farbe.
- POLYGON3D: In Z-Richtung extrudiertes Polygon in 3D ausgeben. N, X1, Y1, X2, Y2, ... Xn, Yn, Z1, dZ, Farbe.
- TEXT3D: Text in 3D ausgeben. X1, Y1, Z1, Höhe, Breite, Rotation, Zeichensatz, Textinhalt, Farbe.
- 3D: Zeile für 3D zusammenbasteln.
- EXIT: Programm sofort beenden.
Wenn ein Array z. B. n=16 Pole hat, braucht es unten Pad 1 und Pad 8=n/2 und eine Reihe von Pad 2 bis Pad 7=n/2-1.
Oben benötigt man rechts Pad 9=n/2+1 und Pad 16=n. Dazwischen die Reihe von Pad 10=n/2+2 bis Pad 15=n-1.
Im 3D braucht es ein linkes und ein rechtes Endstück und (n-4)/2 Zwischenstücke.
Speichern und aktivieren des Skriptes
Ein Script wird im Edit-Dialog erzeugt, verändert und gespeichert. Speicherort ist das Verzeichnis:
Benutzer\Name\AppData\Roaming\ibf\TarVxx\<Ausbaustufe>\PCK_gen
An diesem Ort werden auch die *.png- Imageer gespeichert, die die technische Zeichnung beinhalten und die im Dialog links dann auftauchen. Es ist sinnvoll (kein Muss), wenn das Image den gleichen Namen hat wie das Script.
Ein Script aus der Liste löschen
Löschen Sie es einfach aus diesem Verzeichnis:
Benutzer\Name\AppData\Roaming\ibf\TarVxx\<Ausbaustufe>\PCK_gen
Dann ist es beim nächsten Öffnen auch aus der Liste verschwunden.