missing NULL terminator in set_config_x
[geda-gaf.git] / docs / wiki / geda-master_attributes_list.ru.html
blob141fb94b730dd379420f4fe79a28c749b34c7084
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
6 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
7 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
10 </head>
11 <body>
13 <p>
14 <em>Эта страница доступна также на следующих языках:</em>
15 <a href="geda-master_attributes_list.html" class="wikilink1" title="geda-master_attributes_list.html">English</a>
16 </p>
18 <h1 class="sectionedit1" id="перечень_основных_атрибутов_geda_gaf">Перечень основных атрибутов gEDA/gaf</h1>
19 <div class="level1">
21 <p>
22 <em>Ales Hvezda, ahvezda@geda.seul.org</em>
23 </p>
25 <p>
26 Настоящий документ распространяется под лицензией
27 <a href="http://www.gnu.org/copyleft/fdl.html" class="urlextern" title="http://www.gnu.org/copyleft/fdl.html" rel="nofollow">GFDL</a>
28 </p>
30 <p>
31 10 июля 2007 г.
32 </p>
34 </div>
35 <!-- EDIT1 SECTION "Перечень основных атрибутов gEDA/gaf" [131-410] -->
36 <h2 class="sectionedit2" id="обзор">Обзор</h2>
37 <div class="level2">
39 <p>
40 В настоящем документе приводится описание всех атрибутов, используемых в
41 gEDA/gaf (<abbr title="GNU General Public License">GPL</abbr>&#039;d Electronic Design Automation / <em class="u">g</em>schem <em class="u">a</em>nd
42 <em class="u">f</em>riends)<sup><a href="#fn__10" id="fnt__10" class="fn_top">10)</a></sup>. Документ разбит на несколько разделов: данная обзорная
43 часть, атрибуты только для <a href="geda-glossary.ru.html#символ" class="wikilink1" title="geda-glossary.ru.html">символов</a>, атрибуты
44 только для схем, атрибуты для символов и схем, описание устаревших атрибутов
45 или атрибутов, использовать которые больше не рекомендуется.<br/>
46 Далее в
47 настоящем документе имена атрибутов выделены <strong>жирным шрифтом</strong>, примеры —
48 <code>машинописным</code>.
49 </p>
51 </div>
52 <!-- EDIT2 SECTION "Обзор" [411-1429] -->
53 <h2 class="sectionedit3" id="что_такое_атрибуты">Что такое атрибуты?</h2>
54 <div class="level2">
56 <p>
57 Атрибуты в gEDA/gaf — это не что иное, как текстовые элементы вида:
58 <strong>имя_атрибута</strong>=значение. Имя может содержать что угодно, за исключением
59 знака равенства. Значение может также содержать что угодно, но не может быть
60 пустой строкой. <strong>имя_атрибута</strong>= (без значения) не является допустимым
61 атрибутом. Также не должно быть пробелов непосредственно до или после знака
62 равенства.<br/>
63 Атрибуты могут быть прикреплены к некоторой части символа. Если
64 атрибут несёт информацию, специфическую для объекта, он должен быть
65 прикреплён непосредственно к этому объекту, в противном случае он может быть
66 свободным (плавающим, неприкреплённым). Свободные атрибуты просто находятся
67 в файле символа как текстовые элементы вида <strong>имя_атрибута</strong>=значение.
68 </p>
70 </div>
71 <!-- EDIT3 SECTION "Что такое атрибуты?" [1430-2808] -->
72 <h2 class="sectionedit4" id="атрибуты_только_для_символов">Атрибуты только для символов</h2>
73 <div class="level2">
75 </div>
76 <!-- EDIT4 SECTION "Атрибуты только для символов" [2809-2875] -->
77 <h3 class="sectionedit5" id="device">device</h3>
78 <div class="level3">
80 <p>
81 Атрибутом <strong>device</strong>= задаётся название устройства в символе. Его нужно расположить где-нибудь в символе и сделать невидимым. Данный атрибут является свободным. Если объект является графическим, то атрибут <strong>device</strong>= должен иметь значение <code>none</code> (<strong>device</strong>=none), и в символе должен быть атрибут <a href="#graphical" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">graphical</a>=. Не следует путать данный атрибут с простым текстовым обозначением устройства. Не следует в названии устройства использовать пробелы, некоторым программам это не нравится. Как правило, название устройства указывается полностью прописными буквами.<br/>
82 <em>Примеры:</em><br/>
83 <code>device=7400<br/>
84 device=CONNECTOR_10<br/>
85 device=NPN_TRANSISTOR</code>
86 </p>
88 </div>
89 <!-- EDIT5 SECTION "device" [2876-3965] -->
90 <h3 class="sectionedit6" id="graphical">graphical</h3>
91 <div class="level3">
93 <p>
94 Наличие атрибута <strong>graphical</strong>=1 обязательно для символов, не
95 предназначенных для электрических или схемотехнических целей. Такие символы,
96 как рамка основной надписи для чертежей, являются чисто графическими. Любой
97 символ, имеющий <strong>graphical</strong>=1, игнорируется программой <strong>gnetlist</strong>.<br/>
99 Чисто графический символ должен содержать невидимый атрибут
100 <strong>graphical</strong>=1. Данный атрибут является свободным. При его наличии не
101 забудьте установить <a href="#device" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">device</a>=none.<br/>
103 <em>Пример:</em><br/>
105 <code>graphical=1</code>
106 </p>
108 </div>
109 <!-- EDIT6 SECTION "graphical" [3966-4803] -->
110 <h3 class="sectionedit7" id="description">description</h3>
111 <div class="level3">
114 Атрибут <strong>description</strong>= задаёт простое однострочное описание того, какой
115 символ намеревался изобразить автор.<br/>
117 <em>Примеры:</em><br/>
119 <code>description=4 NAND gates with 2 inputs</code><br/>
121 <code>description=4&times;2И-НЕ</code>
122 </p>
124 </div>
125 <!-- EDIT7 SECTION "description" [4804-5114] -->
126 <h3 class="sectionedit8" id="author">author</h3>
127 <div class="level3">
130 Атрибут <strong>author</strong>= определяет имя автора данного символа и его электронный
131 адрес. Данный атрибут является необязательным, но порой просто приятно иметь
132 представление о том, кто какой символ сделал. Ещё он служит для того, чтобы
133 узнать, с кем можно связаться, если есть вопросы о назначении
134 символа. Данный атрибут имеет свободную форму и поэтому может также
135 содержать и имена изменявших символ людей, и множество электронных
136 адресов. Ещё может быть было бы неплохо как-то изменить адрес, чтобы он не
137 стал жертвой спама.<br/>
139 <em>Пример:</em><br/>
141 <code>author=Ales Hvezda ahvezdaATgeda.seul.org</code>
142 </p>
144 </div>
145 <!-- EDIT8 SECTION "author" [5115-6140] -->
146 <h3 class="sectionedit9" id="comment">comment</h3>
147 <div class="level3">
150 Атрибут <strong>comment</strong>= может содержать всё что угодно. С его помощью может
151 передаваться любая дополнительная информация, которую нельзя включить в
152 другие атрибуты. В символе может быть несколько экземпляров данного
153 атрибута.<br/>
155 <em>Пример:</em><br/>
157 <code>comment=Это комментарий внутри символа</code>
158 </p>
160 </div>
161 <!-- EDIT9 SECTION "comment" [6141-6652] -->
162 <h3 class="sectionedit10" id="pinseq">pinseq</h3>
163 <div class="level3">
166 Данный атрибут используется для задания каждому выводу уникального
167 порядкового номера. Атрибуты <strong>pinseq</strong>=# должны быть прикреплены к каждому
168 из выводов. Их следует сделать невидимыми. Данные атрибуты широко
169 используются программами <strong>gschem</strong> и <strong>gnetlist</strong>.<br/>
170 При работе некоторых
171 драйверов (особенно драйвера SPICE) <strong>gnetlist</strong> выдаёт выводы в порядке
172 возрастания их порядковых номеров. Порядковые номера должны начинаться с 1
173 и последовательно увеличиваться, причём пропускать их не допускается. Данный
174 атрибут не является номером вывода (т. е. номером вывода компонента, как,
175 например, вывод GND имеет номер 7 для многих TTL-микросхем). Для нумерации
176 выводов служит атрибут <a href="#pinnumber" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinnumber</a>=.<br/>
178 <em>Примеры:</em><br/>
180 <code>pinseq=1<br/>
182 pinseq=2<br/>
184 pinseq=3</code>
185 </p>
188 Данный атрибут замещает устаревший <strong>pin#</strong>=#.
189 </p>
191 </div>
192 <!-- EDIT10 SECTION "pinseq" [6653-8022] -->
193 <h3 class="sectionedit11" id="pinnumber">pinnumber</h3>
194 <div class="level3">
197 Атрибут <strong>pinnumber</strong>=# определяет номер вывода компонента (как, например,
198 вывод GND имеет номер 7 для TTL серии 74). Он должен быть прикреплён к
199 каждому выводу.<br/>
201 Значения могут задаваться цифрами или буквами. Атрибут должен быть видимым,
202 причём видимым должно быть только значение. Также необходим атрибут
203 <a href="#pinseq" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinseq</a>=.<br/>
205 <em>Примеры:</em><br/>
207 <code>pinnumber=1<br/>
209 pinnumber=13<br/>
211 pinnumber=A0</code>
212 </p>
215 Данный атрибут замещает устаревший <strong>pin#</strong>=#.
216 </p>
218 </div>
219 <!-- EDIT11 SECTION "pinnumber" [8023-8744] -->
220 <h3 class="sectionedit12" id="pintype">pintype</h3>
221 <div class="level3">
224 Атрибут <strong>pintype</strong>=значение должен быть прикреплён к каждому выводу. Его
225 следует сделать невидимым. В таблице 1 приведены допустимые значения данного
226 атрибута.<br/>
228 Атрибут <strong>pintype</strong>= не очень широко применяется в библиотеке символов, но
229 он используется для <a href="geda-glossary.ru.html#проверка_соответствия_проектным_нормам" class="wikilink1" title="geda-glossary.ru.html">проверки соответствия проектным нормам</a> (DRC) и для создания
230 <a href="geda-glossary.ru.html#список_соединений" class="wikilink1" title="geda-glossary.ru.html">списков соединений</a>. Если никакой
231 другой тип для вывода не подходит, используйте «пассивный» («pas»).<br/>
233 <em>Примеры:</em><br/>
235 <code>pintype=clk<br/>
237 pintype=in<br/>
239 pintype=pas</code>
240 </p>
243 <strong>Таблица 1:</strong> Значения атрибута pintype
244 </p>
245 <div class="table sectionedit13"><table class="inline">
246 <tr class="row0">
247 <td class="col0"> in </td><td class="col1"> Input </td><td class="col2"> Вход </td>
248 </tr>
249 <tr class="row1">
250 <td class="col0"> out </td><td class="col1"> Output </td><td class="col2"> Выход </td>
251 </tr>
252 <tr class="row2">
253 <td class="col0"> io </td><td class="col1"> Input/Output </td><td class="col2"> Вход/выход </td>
254 </tr>
255 <tr class="row3">
256 <td class="col0"> oc </td><td class="col1"> Open collector </td><td class="col2"> Открытый коллектор </td>
257 </tr>
258 <tr class="row4">
259 <td class="col0"> oe </td><td class="col1"> Open emitter </td><td class="col2"> Открытый эмиттер </td>
260 </tr>
261 <tr class="row5">
262 <td class="col0"> pas </td><td class="col1"> Passive </td><td class="col2"> Пассивный </td>
263 </tr>
264 <tr class="row6">
265 <td class="col0"> tp </td><td class="col1"> Totem pole </td><td class="col2"> Идольский столб<sup><a href="#fn__11" id="fnt__11" class="fn_top">11)</a></sup> </td>
266 </tr>
267 <tr class="row7">
268 <td class="col0"> tri </td><td class="col1"> Tristate (high impedance)</td><td class="col2"> Трёхстабильный, третье состояние — высокоимпедансное </td>
269 </tr>
270 <tr class="row8">
271 <td class="col0"> clk </td><td class="col1"> Clock </td><td class="col2"> Тактовый </td>
272 </tr>
273 <tr class="row9">
274 <td class="col0"> pwr </td><td class="col1"> Power/Ground </td><td class="col2"> Питание/общий </td>
275 </tr>
276 </table></div>
277 <!-- EDIT13 TABLE [9786-10590] -->
278 </div>
279 <!-- EDIT12 SECTION "pintype" [8745-10591] -->
280 <h3 class="sectionedit14" id="pinlabel">pinlabel</h3>
281 <div class="level3">
284 Атрибут <strong>pinlabel</strong>= устанавливает метку вывода. Главным образом он нужен
285 программе <strong>gnetlist</strong> для поддержки иерархических проектов.<br/>
287 Данный атрибут нужно прикрепить к выводу и сделать видимым. Он должен быть
288 зелёного цвета (вместо жёлтого, стандартного цвета атрибутов).<br/>
290 <em>Примеры:</em><br/>
292 <code>pinlabel=A0<br/>
294 pinlabel=DATA1<br/>
296 pinlabel=CLK</code>
297 </p>
299 </div>
300 <!-- EDIT14 SECTION "pinlabel" [10592-11168] -->
301 <h3 class="sectionedit15" id="numslots">numslots</h3>
302 <div class="level3">
305 Если компонент содержит несколько <a href="geda-glossary.ru.html#секция_компонента" class="wikilink1" title="geda-glossary.ru.html">секций</a> (элементов) в одном физическом корпусе (как, например,
306 7400, имеющий 4 логических элемента 2И-НЕ в одном корпусе), то необходим
307 атрибут <strong>numslots</strong>=#. Число # задаёт количество элементов в физическом
308 устройстве. Атрибут <strong>numslots</strong>= нужно расположить где-нибудь в символе и
309 сделать невидимым. Данный атрибут является свободным. Если символу не нужно
310 <a href="geda-glossary.ru.html#назначение_логических_секций" class="wikilink1" title="geda-glossary.ru.html">назначать секции</a>, в файл
311 символа следует поместить <strong>numslots</strong>=0.<br/>
313 <em>Пример:</em><br/>
315 <code>numslots=4</code>
316 </p>
318 </div>
319 <!-- EDIT15 SECTION "numslots" [11169-12153] -->
320 <h3 class="sectionedit16" id="slotdef">slotdef</h3>
321 <div class="level3">
324 Если компонент служит для представления <a href="geda-glossary.ru.html#многосекционный_компонент" class="wikilink1" title="geda-glossary.ru.html">многосекционного прибора</a>, содержащего несколько секций в одном
325 физическом корпусе, то для каждой из этих секций необходимо задать атрибут
326 <strong>slotdef</strong>=номер_секции:#,#,#… <br/>
328 Число <code>номер_секции</code> соответствует номеру секции. Двоеточие после номера
329 секции обязательно. Например, для устройства, содержащего 4 секции, в символ
330 нужно было бы добавить атрибуты <strong>slotdef</strong>=1:…, <strong>slotdef</strong>=2:…,
331 <strong>slotdef</strong>=3:… и <strong>slotdef</strong>=4:… и сделать их невидимыми. Данный
332 атрибут является свободным.<br/>
334 Числа # однозначно соответствуют значениям атрибутов <a href="#pinseq" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinseq</a>= и
335 определяют номера выводов <a href="#pinnumber" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinnumber</a>=#, используемые для отображения на
336 экране (в <strong>gschem</strong>) и для создания списка соединений (с помощью
337 <strong>gnetlist</strong>).<br/>
339 Для всех символов, определяющих несколько секций, рекомендуется задавать
340 атрибут <a href="#slot" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">slot</a>=1, прикрепляемый таким же образом, как и <a href="#device" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">device</a>=.<br/>
342 См. символ 7400-1.sym как пример реального применения <strong>slotdef</strong>=.<br/>
344 <em>Примеры:</em><br/>
346 <code>slotdef=1:1,2,3<br/>
348 slotdef=2:4,5,6<br/>
350 slotdef=3:7,8,9</code>
351 </p>
354 Данный атрибут замещает устаревший <strong>slot</strong>#=#.
355 </p>
357 </div>
358 <!-- EDIT16 SECTION "slotdef" [12154-14026] -->
359 <h3 class="sectionedit17" id="footprint">footprint</h3>
360 <div class="level3">
363 Атрибут <strong>footprint</strong>=название_корпуса нужно расположить где-нибудь в символе и сделать невидимым. Он используется программой <strong>gnetlist</strong> и главным образом для пакета <strong>pcb</strong>.<br/>
365 Атрибут прикрепляется таким же образом, как и <a href="#device" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">device</a>=. Он является свободным.<br/>
367 <code>название_корпуса</code> определяет посадочное место для <strong>pcb</strong> или типоразмер корпуса, как, например, DIP14 или DIP40. Хотя в принципе значения данного атрибута зависят от пакета <strong>pcb</strong>, в gEDA/gaf существуют соглашения о том, чтобы делать их как можно лучше переносимыми для предоставления пользователям возможностей удобного сотрудничества и совместного использования. См. <a href="geda-pcb_footprint_naming_conventions.ru.html" class="wikilink1" title="geda-pcb_footprint_naming_conventions.ru.html">Соглашения по именованию посадочных мест</a>.<br/>
369 Если для символа посадочное место не нужно или если оно должно переопределяться в схеме, следует установить <strong>footprint</strong>=none. Если название посадочного места неизвестно, следует установить <strong>footprint</strong>=unknown.
370 </p>
372 </div>
373 <!-- EDIT17 SECTION "footprint" [14027-15630] -->
374 <h3 class="sectionedit18" id="documentation">documentation</h3>
375 <div class="level3">
378 Атрибут <strong>documentation</strong>=ссылка_на_документацию можно расположить где-нибудь в символе и сделать невидимым. Данный атрибут используется программой <strong>gschemdoc</strong> для поиска подходящей документации по символу, или, вернее, по устройству или компоненту, определяемому данным символом.<br/>
380 Атрибут прикрепляется таким же образом, как и <a href="#device" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">device</a>=. Он является свободным.<br/>
382 <code>ссылка_на_документацию</code> определяет либо имя основного файла документации, либо полный интернет-адрес. Если в атрибуте задано имя файла, программа попытается найти его в локальном каталоге <em><code>documentation</code></em> пакета gEDA.<br/>
384 <em>Пример имени файла:</em><br/>
386 <code>documentation=sn74ls00.pdf</code><br/>
388 <em>Пример интернет-адреса:</em><br/>
390 <code>documentation=http://www-s.ti.com/sc/ds/sn74ls00.pdf</code>
391 </p>
393 </div>
394 <!-- EDIT18 SECTION "documentation" [15631-16873] -->
395 <h2 class="sectionedit19" id="атрибуты_только_для_схем">Атрибуты только для схем</h2>
396 <div class="level2">
398 </div>
399 <!-- EDIT19 SECTION "Атрибуты только для схем" [16874-16931] -->
400 <h3 class="sectionedit20" id="netname">netname</h3>
401 <div class="level3">
404 Атрибут <strong>netname</strong>= должен прикрепляться к объекту
405 «<a href="geda-glossary.ru.html#соединение" class="wikilink1" title="geda-glossary.ru.html">соединение</a>» для установки его имени. Крайне не
406 рекомендуется использовать разные имена для связанных сегментов
407 соединений. Одинаково названные соединения считаются электрически замкнутыми
408 между собой. Недопустимо использовать данный атрибут внутри символов (так
409 как внутри символов соединения использовать нельзя).<br/>
411 <em>Примеры:</em><br/>
413 <code>netname=DATA0 H<br/>
415 netname=CLK L</code>
416 </p>
418 </div>
419 <!-- EDIT20 SECTION "netname" [16932-17707] -->
420 <h3 class="sectionedit21" id="source">source</h3>
421 <div class="level3">
424 Атрибут <strong>source</strong>= указывает, что символ является представлением
425 <a href="geda-glossary.ru.html#подсхема" class="wikilink1" title="geda-glossary.ru.html">подсхемы</a>. Он прикрепляется непосредственно к
426 символу компонента.<br/>
428 Данный атрибут должен прикрепляться только к экземплярам символов
429 компонентов в схеме. Атрибут следует прикрепить к символу и задать значение
430 в виде имени файла подсхемы (например, <code>block.sch</code>), но не полного пути
431 доступа. Указанный файл подсхемы должен находиться в одном из каталогов,
432 перечисленных среди путей доступа к <a href="geda-glossary.ru.html#библиотека_исходных_данных" class="wikilink1" title="geda-glossary.ru.html">библиотекам исходных данных</a>. Можно прикреплять несколько таких
433 атрибутов с различными значениями, что, по существу, означает, что подсхема
434 представляет собой набор из нескольких связанных между собой схем.<br/>
436 <em>Примеры:</em><br/>
438 <code>source=underlying.sch<br/>
440 source=memory.sch</code>
441 </p>
443 </div>
444 <!-- EDIT21 SECTION "source" [17708-19108] -->
445 <h2 class="sectionedit22" id="атрибуты_для_символов_и_схем">Атрибуты для символов и схем</h2>
446 <div class="level2">
448 </div>
449 <!-- EDIT22 SECTION "Атрибуты для символов и схем" [19109-19174] -->
450 <h3 class="sectionedit23" id="refdes">refdes</h3>
451 <div class="level3">
454 Атрибут <strong>refdes</strong>= определяет позиционное обозначение конкретного
455 экземпляра компонента в схеме. Данный атрибут должен быть у КАЖДОГО
456 компонента, имеющего какой-либо электрический смысл. Для установки
457 позиционного обозначения, используемого для компонента по умолчанию (такого
458 как &#039;U?&#039;, например), данный атрибут может задаваться непосредственно в
459 символе (и если он видим, то при помещении символа в схему будет вынесен, то
460 есть прикреплён вне символа).<br/>
462 <em>Примеры:</em><br/>
464 <code>refdes=U1<br/>
466 refdes=R10<br/>
468 refdes=CONN1</code>
469 </p>
471 </div>
473 <h4 id="ограничения_для_позиционных_обозначений">Ограничения для позиционных обозначений</h4>
474 <div class="level4">
477 В качестве значения атрибута <strong>refdes</strong>= <strong>gschem</strong> принимает любые
478 строки. Но некоторые драйверы <strong>gnetlist</strong> накладывают ограничения на
479 допустимый синтаксис.
480 </p>
483 В частности <a href="geda-faq-gsch2pcb.ru.html" class="wikilink1" title="geda-faq-gsch2pcb.ru.html">gsch2pcb</a> требует:
484 </p>
485 <ul>
486 <li class="level1"><div class="li"> Не должно быть пробелов.</div>
487 </li>
488 <li class="level1"><div class="li"> Не должно быть дефисов. Это может привести к сбою интерпретатора макроязыка M4, потенциально используемого для генерирования посадочных мест. Символ подчёркивания «_» допустим.</div>
489 </li>
490 <li class="level1"><div class="li"> Любой суффикс из строчных букв игнорируется. Таким образом в схему можно добавить 4 дискретных элемента И-НЕ с обозначениями <code>U1a</code>, <code>U1b</code>, <code>U1c</code> и <code>U1d</code>. При создании списка соединений они будут относиться к одному посадочному месту с названием <code>U1</code>.</div>
491 </li>
492 <li class="level1"><div class="li"> Символы, не входящие в <a href="geda-glossary.ru.html#ascii" class="wikilink1" title="geda-glossary.ru.html">ASCII</a>, такие как, например, üöäß, не выводятся в <strong>pcb</strong>.</div>
493 </li>
494 </ul>
496 </div>
498 <h4 id="соглашения_по_позиционным_обозначениям">Соглашения по позиционным обозначениям</h4>
499 <div class="level4">
502 Существует соглашение о применяемых позиционных обозначениях для разных типов компонентов. Здесь приведены некоторые из них<sup><a href="#fn__12" id="fnt__12" class="fn_top">12)</a></sup> (<code>?</code> заменяется числом):
503 </p>
504 <div class="table sectionedit24"><table class="inline">
505 <thead>
506 <tr class="row0">
507 <th class="col0"> Обозначение </th><th class="col1"> Тип компонента </th>
508 </tr>
509 </thead>
510 <tr class="row1">
511 <td class="col0 leftalign"> R? </td><td class="col1">Резистор</td>
512 </tr>
513 <tr class="row2">
514 <td class="col0 leftalign"> RN? </td><td class="col1">Набор резисторов</td>
515 </tr>
516 <tr class="row3">
517 <td class="col0 leftalign"> FB? </td><td class="col1">Ферритовый фильтр </td>
518 </tr>
519 <tr class="row4">
520 <td class="col0 leftalign"> L? </td><td class="col1">Катушка индуктивности, дроссель</td>
521 </tr>
522 <tr class="row5">
523 <td class="col0 leftalign"> C? </td><td class="col1">Конденсатор</td>
524 </tr>
525 <tr class="row6">
526 <td class="col0 leftalign"> B? </td><td class="col1">Батарея</td>
527 </tr>
528 <tr class="row7">
529 <td class="col0 leftalign"> F? </td><td class="col1">Предохранитель</td>
530 </tr>
531 <tr class="row8">
532 <td class="col0 leftalign"> J? </td><td class="col1">Соединитель, разъём </td>
533 </tr>
534 <tr class="row9">
535 <td class="col0 leftalign"> P? </td><td class="col1">Соединитель, разъём (обычно сопрягаемый с обозначенным как J?)</td>
536 </tr>
537 <tr class="row10">
538 <td class="col0 leftalign"> K? </td><td class="col1">Реле</td>
539 </tr>
540 <tr class="row11">
541 <td class="col0 leftalign"> S? </td><td class="col1">Выключатель, переключатель</td>
542 </tr>
543 <tr class="row12">
544 <td class="col0 leftalign"> T? </td><td class="col1">Трансформатор</td>
545 </tr>
546 <tr class="row13">
547 <td class="col0 leftalign"> TP? </td><td class="col1">Контрольная точка</td>
548 </tr>
549 <tr class="row14">
550 <td class="col0 leftalign"> M? </td><td class="col1">Двигатель</td>
551 </tr>
552 <tr class="row15">
553 <td class="col0 leftalign"> D? </td><td class="col1">Диод</td>
554 </tr>
555 <tr class="row16">
556 <td class="col0 leftalign"> Q? </td><td class="col1">Транзистор</td>
557 </tr>
558 <tr class="row17">
559 <td class="col0 leftalign"> U? </td><td class="col1">ИС (интегральная схема)</td>
560 </tr>
561 <tr class="row18">
562 <td class="col0 leftalign"> X? </td><td class="col1">Кварцевый осциллятор</td>
563 </tr>
564 </table></div>
565 <!-- EDIT24 TABLE [22049-22882] -->
566 </div>
567 <!-- EDIT23 SECTION "refdes" [19175-22883] -->
568 <h3 class="sectionedit25" id="slot">slot</h3>
569 <div class="level3">
572 Атрибут <strong>slot</strong>= используется для выбора конкретного устройства (секции) в
573 <a href="geda-glossary.ru.html#многосекционный_компонент" class="wikilink1" title="geda-glossary.ru.html">многосекционном приборе</a>. В
574 схеме он должен прикрепляться к экземпляру символа компонента. Для выбора
575 секции по умолчанию данный атрибут может задаваться в символе (и если он
576 видим, то при помещении символа в схему будет вынесен, то есть прикреплён
577 вне символа).
578 </p>
580 </div>
581 <!-- EDIT25 SECTION "slot" [22884-23580] -->
582 <h3 class="sectionedit26" id="net">net</h3>
583 <div class="level3">
586 Атрибут <strong>net</strong>= используется для создания соединений питания и специальных
587 целей. Подробности см. в <a href="geda-na_howto.ru.html" class="wikilink1" title="geda-na_howto.ru.html">Мини-HOWTO по атрибуту
588 net=</a>. Если данный атрибут находится в символе, он используется для
589 создания соединений. Если же он прикрепляется к экземпляру компонента в
590 схеме, то может использоваться также для создания новых соединений и
591 переопределения уже существующих.
592 </p>
594 </div>
595 <!-- EDIT26 SECTION "net" [23581-24274] -->
596 <h3 class="sectionedit27" id="value">value</h3>
597 <div class="level3">
600 Атрибут <strong>value</strong>= в основном используется в драйвере
601 <a href="geda-glossary.ru.html#генератор_списка_соединений" class="wikilink1" title="geda-glossary.ru.html">генератора списка
602 соединений</a> для SPICE с целью определения значений различных элементов. Он
603 не переводится и помещается в список соединений как есть.<br/>
605 <em>Примеры:</em><br/>
607 <code>value=1K<br/>
609 value=10V</code>
610 </p>
612 </div>
613 <!-- EDIT27 SECTION "value" [24275-24777] -->
614 <h3 class="sectionedit28" id="symversion">symversion</h3>
615 <div class="level3">
618 Атрибут <strong>symversion</strong>= используется для определения версии содержимого
619 символа. Так как по умолчанию символы в схему не внедряются, а приводится
620 лишь ссылка на них, то в схеме, использующей какой-либо конкретный символ,
621 при изменении файла этого символа могут возникнуть проблемы. Например,
622 изменение расположения выводов в символе приведёт к тому, что линии
623 соединений в схеме уже не будут подключены к надлежащим выводам. Атрибут
624 <strong>symversion</strong>= позволяет отслеживать такие разрушительные изменения в
625 символах и уведомлять пользователя о потенциальных проблемах при загрузке
626 схемы.
627 </p>
630 Данный атрибут необязателен, но при наличии в символе он должен принимать
631 следующую форму:<br/>
633 <strong>старший_номер.младший_номер</strong>,<br/>
635 </p>
638 где <code>старший_номер</code> и <code>младший_номер</code> — целые числа. Старший номер при
639 вводе новой версии инкрементируется<sup><a href="#fn__13" id="fnt__13" class="fn_top">13)</a></sup> в случае таких изменений в символе, которые могут
640 привести к порче существующих схем, использующих предыдущие версии
641 символа. Младший номер инкрементируется только в случае небольших изменений
642 (изменений, не приводящих к порче существующих схем, таких как косметические
643 изменения при сохранении структуры, то есть положения выводов).
644 </p>
647 Если символ, содержащий данный атрибут, помещается в схему, атрибут
648 <strong>symversion</strong>= автоматически «выносится», то есть для данного экземпляра
649 символа копия атрибута <strong>symversion</strong>=M.N сохраняется непосредственно в
650 файле схемы. При загрузке символа с диска значение атрибута <strong>symversion</strong>=
651 в файле символа (при его наличии) сравнивается со значением атрибута,
652 прикреплённого к экземпляру символа в схеме. Если эти значения различаются,
653 то <strong>libgeda</strong> выдаст предупреждение (при изменении младшего номера версии)
654 или ошибку (при изменении старшего номера версии).
655 </p>
658 Обычно при помещении данного атрибута в файл символа его лучше сделать
659 невидимым. Если при добавлении символа в схему в нём найден этот атрибут, то
660 он всегда выносится. Не следует прикреплять данный атрибут к имеющимся в
661 схеме экземплярам символов вручную.<br/>
663 <em>Примеры: </em><br/>
665 <code>symversion=1.1<br/>
667 symversion=2.0</code>
668 </p>
670 </div>
671 <!-- EDIT28 SECTION "symversion" [24778-28481] -->
672 <h3 class="sectionedit29" id="dist-license">dist-license</h3>
673 <div class="level3">
676 Атрибут <strong>dist-license</strong>= используется для указания лицензии, под которой
677 распространяется символ или схема. В нём должна задаваться известная
678 лицензия. Вот несколько примеров его возможных значений: <code><abbr title="GNU General Public License">GPL</abbr></code>, <code><abbr title="GNU General Public License">GPL</abbr>
679 version 2 only</code>, <code><abbr title="GNU General Public License">GPL</abbr> version 3 only</code>, <code>public domain</code>, <code>Apache
680 version 2</code>, <code>Modified BSD</code>, <code>X11</code> и т. д.<br/>
682 <br/>
684 Перечни существующих лицензий можно найти по следующим адресам:
685 <a href="http://www.gnu.org/philosophy/license-list.html" class="urlextern" title="http://www.gnu.org/philosophy/license-list.html" rel="nofollow">Перечень лицензий FSF</a> и
686 <a href="http://www.opensource.org/licenses/category" class="urlextern" title="http://www.opensource.org/licenses/category" rel="nofollow">Перечень лицензий OSI</a>.
687 </p>
689 </div>
690 <!-- EDIT29 SECTION "dist-license" [28482-29304] -->
691 <h3 class="sectionedit30" id="use-license">use-license</h3>
692 <div class="level3">
695 Атрибут <strong>use-license</strong>= используется для указания лицензии, определяющей,
696 как другие пользователи могут использовать данный символ или данную схему в
697 своих схемах и платах. Вот примеры его значений: <code>unlimited</code>
698 (неограниченная), <code>personal use only</code> (только для личного пользования),
699 <code>not for sale</code> (не для продажи) и т. д.<br/>
701 <br/>
703 <img src="images/smileys/fixme.gif" align="middle" alt="FIXME" />: добавить сюда набор примеров получше.
704 </p>
706 </div>
707 <!-- EDIT30 SECTION "use-license" [29305-29950] -->
708 <h2 class="sectionedit31" id="устаревшие_атрибуты">Устаревшие атрибуты</h2>
709 <div class="level2">
711 </div>
712 <!-- EDIT31 SECTION "Устаревшие атрибуты" [29951-30000] -->
713 <h3 class="sectionedit32" id="uref">uref</h3>
714 <div class="level3">
717 Атрибут <strong>uref=</strong> устарел и использоваться не должен. Он применялся для тех
718 же целей, что и <a href="#refdes" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">refdes</a>=.
719 </p>
721 </div>
722 <!-- EDIT32 SECTION "uref" [30001-30188] -->
723 <h3 class="sectionedit33" id="name">name</h3>
724 <div class="level3">
727 Атрибут <strong>name</strong>= не должен ни использоваться в символе, ни прикрепляться в
728 схеме. Считается, что такое название атрибута неоднозначно. Данный атрибут
729 никогда не использовался в gEDA/gaf.
730 </p>
732 </div>
733 <!-- EDIT33 SECTION "name" [30189-30533] -->
734 <h3 class="sectionedit34" id="label">label</h3>
735 <div class="level3">
738 Атрибут <strong>label</strong>= устарел и использоваться не должен. Он применялся для
739 определения названий/меток соединений и меток выводов. Теперь эти функции
740 выполняют соответственно атрибуты <a href="#netname" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">netname</a>= и <a href="#pinlabel" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinlabel</a>=.
741 </p>
743 </div>
744 <!-- EDIT34 SECTION "label" [30534-30910] -->
745 <h3 class="sectionedit35" id="pin">pin#</h3>
746 <div class="level3">
749 Атрибут <strong>pin#</strong>=# устарел и использоваться не должен. Он применялся для
750 определения порядковых номеров выводов в символе и номеров выводов для
751 компонента. Теперь эти функции выполняют соответственно <a href="#pinseq" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinseq</a>= и
752 <a href="#pinnumber" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pinnumber</a>=.
753 </p>
755 </div>
756 <!-- EDIT35 SECTION "pin#" [30911-31321] -->
757 <h3 class="sectionedit36" id="slot1">slot#</h3>
758 <div class="level3">
761 Атрибут <strong>slot#</strong>=# устарел и использоваться не должен. Ранее в нём
762 предоставлялась информация о <a href="geda-glossary.ru.html#назначение_логических_секций" class="wikilink1" title="geda-glossary.ru.html">назначении секций</a> компонентов. Теперь эту функцию выполняет атрибут
763 <a href="#slotdef" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">slotdef</a>=.
764 </p>
766 </div>
767 <!-- EDIT36 SECTION "slot#" [31322-31725] -->
768 <h3 class="sectionedit37" id="type">type</h3>
769 <div class="level3">
772 Атрибут <strong>type</strong>= устарел и использоваться не должен. Он применялся для
773 установки типа выводов. Теперь эту функцию выполняет атрибут <a href="#pintype" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">pintype</a>=.
774 </p>
776 </div>
777 <!-- EDIT37 SECTION "type" [31726-31993] -->
778 <h3 class="sectionedit38" id="email">email</h3>
779 <div class="level3">
782 Информация из данного атрибута вынесена в атрибут <a href="#author" title=":geda:master_attributes_list.ru.txt ↵" class="wikilink1">author</a>=.
783 </p>
785 </div>
786 <!-- EDIT38 SECTION "email" [31994-32117] -->
787 <h2 class="sectionedit39" id="история_изменений_документа">История изменений документа</h2>
788 <div class="level2">
789 <div class="table sectionedit40"><table class="inline">
790 <tr class="row0">
791 <td class="col0 leftalign"> 14 июля 2002 г. </td><td class="col1 leftalign"> Создан attributes.tex из attributes.txt. </td>
792 </tr>
793 <tr class="row1">
794 <td class="col0 leftalign"> 14 июля 2002 г. </td><td class="col1"> Документ обновлён для синхронизации с post-20020527. </td>
795 </tr>
796 <tr class="row2">
797 <td class="col0 leftalign"> 25 августа 2002 г. </td><td class="col1 leftalign"> Добавлен устаревший атрибут type=. </td>
798 </tr>
799 <tr class="row3">
800 <td class="col0"> 14 сентября 2002 г. </td><td class="col1"> Добавлен атрибут description=. Небольшие исправления </td>
801 </tr>
802 <tr class="row4">
803 <td class="col0 leftalign"> 7 октября 2002 г. </td><td class="col1 leftalign"> Добавлен атрибут doc=; Egil Kvaleberg. </td>
804 </tr>
805 <tr class="row5">
806 <td class="col0 leftalign"> 11 февраля 2003 г. </td><td class="col1"> Добавлена ссылка на соглашения по посадочным местам. </td>
807 </tr>
808 <tr class="row6">
809 <td class="col0 leftalign"> 23 февраля 2003 г. </td><td class="col1 leftalign"> Добавлены атрибуты author=, email=, и comment=. </td>
810 </tr>
811 <tr class="row7">
812 <td class="col0 leftalign"> 6 июля 2004 г. </td><td class="col1 leftalign"> Добавлен атрибут symversion=. </td>
813 </tr>
814 <tr class="row8">
815 <td class="col0 leftalign"> 10 июля 2007 г. </td><td class="col1 leftalign"> Добавлены атрибуты dist-license= и use-license=. </td>
816 </tr>
817 </table></div>
818 <!-- EDIT40 TABLE [32183-33166] -->
819 </div>
820 <!-- EDIT39 SECTION "История изменений документа" [32118-] --><div class="footnotes">
821 <div class="fn"><sup><a href="#fnt__10" id="fn__10" class="fn_bot">10)</a></sup>
822 <div class="content">САПР электроники под лицензией <abbr title="GNU General Public License">GPL</abbr> / gschem и друзья. —
823 <em>Прим. перев.</em></div></div>
824 <div class="fn"><sup><a href="#fnt__11" id="fn__11" class="fn_bot">11)</a></sup>
825 <div class="content">Шуточная расшифровка. На самом деле расшифровывается как «test pin/point» (<a href="geda-glossary.ru.html#контрольная_точка" class="wikilink1" title="geda-glossary.ru.html">контрольная точка</a>/<a href="geda-glossary.ru.html#контрольный_вывод" class="wikilink1" title="geda-glossary.ru.html">контрольный вывод</a>). — <em>Прим. перев.</em></div></div>
826 <div class="fn"><sup><a href="#fnt__12" id="fn__12" class="fn_bot">12)</a></sup>
827 <div class="content">Данные соглашения в ряде случаев не соответствуют отечественным стандартам, см. ГОСТ 2.710-81. — <em>Прим. перев.</em></div></div>
828 <div class="fn"><sup><a href="#fnt__13" id="fn__13" class="fn_bot">13)</a></sup>
829 <div class="content">Увеличивается на 1. —
830 <em>Прим. перев.</em></div></div>
831 </div>
832 </body>
833 </html>