1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
<html>
<head>
<title>EAGLE Help: UL_PIN</title>
</head>
<body bgcolor=white>
<font face=Helvetica,Arial>
<hr>
<i>EAGLE Help</i>
<h1><center>UL_PIN</center></h1>
<hr>
<b>Data members</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>angle</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=157.htm>real</a> (<tt>0</tt>, <tt>90</tt>, <tt>180</tt> and <tt>270</tt>)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>contact</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=168.htm>UL_CONTACT</a> (see note)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>direction</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=156.htm>int</a> (<tt>PIN_DIRECTION_...</tt>)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>function</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=156.htm>int</a> (<tt>PIN_FUNCTION_FLAG_...</tt>)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>length</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=156.htm>int</a> (<tt>PIN_LENGTH_...</tt>)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>name</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=158.htm>string</a> (<tt>PIN_NAME_LENGTH</tt>)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>net</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=158.htm>string</a> (see note)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>swaplevel</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=156.htm>int</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>visible</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=156.htm>int</a> (<tt>PIN_VISIBLE_FLAG_...</tt>)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>x, y</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=156.htm>int</a> (connection point)</font></td></tr>
</table>
<p>
<b>Loop members</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>circles()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=166.htm>UL_CIRCLE</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>texts()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=194.htm>UL_TEXT</a></font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>wires()</tt> </font></td><td valign=top><font face=Helvetica,Arial><a href=196.htm>UL_WIRE</a></font></td></tr>
</table>
<p>
<b>Constants</b>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_NC</tt> </font></td><td valign=top><font face=Helvetica,Arial>not connected</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_IN</tt> </font></td><td valign=top><font face=Helvetica,Arial>input</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_OUT</tt> </font></td><td valign=top><font face=Helvetica,Arial>output (totem-pole)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_IO</tt> </font></td><td valign=top><font face=Helvetica,Arial>in/output (bidirectional)</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_OC</tt> </font></td><td valign=top><font face=Helvetica,Arial>open collector</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_PWR</tt> </font></td><td valign=top><font face=Helvetica,Arial>power input pin</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_PAS</tt> </font></td><td valign=top><font face=Helvetica,Arial>passive</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_HIZ</tt> </font></td><td valign=top><font face=Helvetica,Arial>high impedance output</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_DIRECTION_SUP</tt> </font></td><td valign=top><font face=Helvetica,Arial>supply pin</font></td></tr>
</table>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_FUNCTION_FLAG_NONE</tt> </font></td><td valign=top><font face=Helvetica,Arial>no symbol</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_FUNCTION_FLAG_DOT</tt> </font></td><td valign=top><font face=Helvetica,Arial>inverter symbol</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_FUNCTION_FLAG_CLK</tt> </font></td><td valign=top><font face=Helvetica,Arial>clock symbol</font></td></tr>
</table>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_LENGTH_POINT</tt> </font></td><td valign=top><font face=Helvetica,Arial>no wire</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_LENGTH_SHORT</tt> </font></td><td valign=top><font face=Helvetica,Arial>0.1 inch wire</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_LENGTH_MIDDLE</tt> </font></td><td valign=top><font face=Helvetica,Arial>0.2 inch wire</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_LENGTH_LONG</tt> </font></td><td valign=top><font face=Helvetica,Arial>0.3 inch wire</font></td></tr>
</table>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_NAME_LENGTH</tt> </font></td><td valign=top><font face=Helvetica,Arial>max. recommended length of a pin name (used in formatted output only)</font></td></tr>
</table>
<p>
<table>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_VISIBLE_FLAG_OFF</tt> </font></td><td valign=top><font face=Helvetica,Arial>no name drawn</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_VISIBLE_FLAG_PAD</tt> </font></td><td valign=top><font face=Helvetica,Arial>pad name drawn</font></td></tr>
<tr><td valign=top><font face=Helvetica,Arial><tt>PIN_VISIBLE_FLAG_PIN</tt> </font></td><td valign=top><font face=Helvetica,Arial>pin name drawn</font></td></tr>
</table>
<p>
<b>See also</b> <a href=193.htm>UL_SYMBOL</a>,
<a href=185.htm>UL_PINREF</a>,
<a href=169.htm>UL_CONTACTREF</a>
<p>
<b>Note</b>
<p>
The <tt>contact</tt> data member returns the <a href=168.htm>contact</a>
that has been assigned to the pin through a <a href=36.htm>CONNECT</a>
command. It can be used as a boolean function to check whether a contact has been
assigned to a pin (see example below).
<p>
The coordinates (and layer, in case of an SMD) of the contact returned by
the <tt>contact</tt> data member depend on the context in which it is called:
<ul>
<li>if the pin is derived from a UL_PART that is used on a sheet, and if there
is a corresponding element on the board, the resulting contact will have
the coordinates as used on the board
<li>in all other cases, the coordinates of the contact will be the same as
defined in the package drawing
</ul>
The <tt>name</tt> data member always returns the name of the pin as it was defined
in the library, with any <tt>'@'</tt> character for pins with the same name left intact
(see the <a href=69.htm>PIN</a> command for details).<br>
The <tt>texts</tt> loop member, on the other hand, returns the pin name (if it is
visible) in the same way as it is displayed in the current drawing type.
<p>
The <tt>net</tt> data member returns the name of the net to which this pin is connected.
<p>
<b>Example</b>
<pre>
library(L) {
L.symbols(S) {
printf("Symbol: %s\n", S.name);
S.pins(P) {
printf("\tPin: %s, (%d %d)", P.name, P.x, P.y);
if (P.direction == PIN_DIRECTION_IN)
printf(" input");
if ((P.function & PIN_FUNCTION_FLAG_DOT) != 0)
printf(" inverted");
printf("\n");
}
}
L.devices(D) {
D.gates(G) {
G.symbol.pins(P) {
if (!P.contact)
printf("Unconnected pin: %s/%s/%s\n", D.name, G.name, P.name);
}
}
}
}
</pre>
<hr>
<table width=100% cellspacing=0 border=0><tr><td align=left><font face=Helvetica,Arial>
<a href=index.htm>Index</a>
</font></td><td align=right><font face=Helvetica,Arial size=-1>
<i>Copyright © 2005 CadSoft Computer GmbH</i>
</font></td></tr></table>
<hr>
</font>
</body>
</html>
|
