This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
geda:master_attributes_list.ru [2012/02/20 15:14] 127.0.0.1 external edit |
geda:master_attributes_list.ru [2012/12/13 12:32] vzh Fix a term and add a link to the glossary |
||
---|---|---|---|
Line 11: | Line 11: | ||
===== Обзор ===== | ===== Обзор ===== | ||
- | В настоящем документе содержится описание всех атрибутов, используемых в | + | В настоящем документе приводится описание всех атрибутов, используемых в |
gEDA/gaf | gEDA/gaf | ||
(GPL'd Electronic Design Automation / __g__schem __a__nd __f__riends)((САПР | (GPL'd Electronic Design Automation / __g__schem __a__nd __f__riends)((САПР | ||
Line 17: | Line 17: | ||
Документ разбит на несколько разделов: данная обзорная часть, атрибуты только | Документ разбит на несколько разделов: данная обзорная часть, атрибуты только | ||
для [[geda:glossary.ru#Символ|символов]], атрибуты только для схем, атрибуты | для [[geda:glossary.ru#Символ|символов]], атрибуты только для схем, атрибуты | ||
- | для символов и схем, описание устаревших или отклонённых атрибутов.\\ | + | для символов и схем, описание устаревших атрибутов или атрибутов, |
+ | использовать которые больше не рекомендуется.\\ | ||
Далее в настоящем документе имена атрибутов выделены **жирным шрифтом**, | Далее в настоящем документе имена атрибутов выделены **жирным шрифтом**, | ||
примеры --- ''машинописным''. | примеры --- ''машинописным''. | ||
Line 31: | Line 32: | ||
информацию, специфическую для объекта, он должен быть прикреплён | информацию, специфическую для объекта, он должен быть прикреплён | ||
непосредственно к этому объекту, в противном случае он может быть свободным | непосредственно к этому объекту, в противном случае он может быть свободным | ||
- | (плавающим, неприкреплённым). В файлах символов свободные атрибуты находятся | + | (плавающим, неприкреплённым). Свободные атрибуты просто находятся в файле |
- | просто в виде текстовых элементов вида **имя_атрибута**=значение. | + | символа как текстовые элементы вида **имя_атрибута**=значение. |
===== Атрибуты только для символов ===== | ===== Атрибуты только для символов ===== | ||
==== device ==== | ==== device ==== | ||
- | Атрибут **device**= задаёт название устройства в символе. | + | Атрибутом **device**= задаётся название устройства в символе. |
- | Он должен быть в символе и его следует сделать невидимым. Данный атрибут | + | Его нужно расположить где-нибудь в символе и сделать невидимым. Данный атрибут |
является свободным. Если объект является графическим, то атрибут **device**= | является свободным. Если объект является графическим, то атрибут **device**= | ||
- | должен иметь значение ''none'' (**device**=none) и в символе должен быть | + | должен иметь значение ''none'' (**device**=none), и в символе должен быть |
атрибут [[#graphical]]=. Не следует путать данный атрибут с простым текстовым | атрибут [[#graphical]]=. Не следует путать данный атрибут с простым текстовым | ||
обозначением устройства. Не следует в названии устройства использовать | обозначением устройства. Не следует в названии устройства использовать | ||
- | пробелы, некоторым программам это не нравится. Как правило название устройства | + | пробелы, некоторым программам это не нравится. Как правило, название устройства |
указывается полностью прописными буквами.\\ | указывается полностью прописными буквами.\\ | ||
- | //Примеры://\\ ''device=7400\\ device=CONNECTOR 10\\ device=NPN_TRANSISTOR'' | + | //Примеры://\\ ''device=7400\\ device=CONNECTOR_10\\ device=NPN_TRANSISTOR'' |
Line 53: | Line 54: | ||
основной надписи для чертежей, являются чисто графическими. Любой символ, | основной надписи для чертежей, являются чисто графическими. Любой символ, | ||
имеющий **graphical**=1, игнорируется программой **gnetlist**.\\ | имеющий **graphical**=1, игнорируется программой **gnetlist**.\\ | ||
- | Атрибут **graphical**=1 должен быть в чисто графическом символе и его следует | + | Чисто графический символ должен содержать невидимый атрибут **graphical**=1. |
- | сделать невидимым. Данный атрибут является свободным. При его наличии не | + | Данный атрибут является свободным. При его наличии не |
забудьте установить [[#device]]=none.\\ | забудьте установить [[#device]]=none.\\ | ||
//Пример://\\ ''graphical=1'' | //Пример://\\ ''graphical=1'' | ||
Line 87: | Line 88: | ||
==== pinseq ==== | ==== pinseq ==== | ||
Данный атрибут используется для задания каждому выводу уникального порядкового | Данный атрибут используется для задания каждому выводу уникального порядкового | ||
- | номера. Атрибуты **pinseq**=# должны быть прикреплёны к каждому из выводов. Их | + | номера. Атрибуты **pinseq**=# должны быть прикреплены к каждому из выводов. Их |
- | следует сделать невидимыми. Данный атрибут широко используется программами | + | следует сделать невидимыми. Данные атрибуты широко используются программами |
**gschem** и **gnetlist**.\\ | **gschem** и **gnetlist**.\\ | ||
При работе некоторых драйверов (особенно драйвера SPICE) | При работе некоторых драйверов (особенно драйвера SPICE) | ||
Line 94: | Line 95: | ||
Порядковые номера должны начинаться с 1 и последовательно увеличиваться, | Порядковые номера должны начинаться с 1 и последовательно увеличиваться, | ||
причём пропускать их не допускается. Данный атрибут не является номером вывода | причём пропускать их не допускается. Данный атрибут не является номером вывода | ||
- | (т.е. номером вывода компонента, как, например, вывод GND имеет номер 7 для | + | (т. е. номером вывода компонента, как, например, вывод GND имеет номер 7 для |
многих TTL-микросхем). Для нумерации выводов служит атрибут [[#pinnumber]]=.\\ | многих TTL-микросхем). Для нумерации выводов служит атрибут [[#pinnumber]]=.\\ | ||
//Примеры://\\ ''pinseq=1\\ pinseq=2\\ pinseq=3'' | //Примеры://\\ ''pinseq=1\\ pinseq=2\\ pinseq=3'' | ||
Line 105: | Line 106: | ||
вывод GND имеет номер 7 для TTL серии 74). Он должен быть прикреплён к каждому | вывод GND имеет номер 7 для TTL серии 74). Он должен быть прикреплён к каждому | ||
выводу.\\ | выводу.\\ | ||
- | Значения могут задаваться цифрами или буквами. Атрибут должен быть видимым и | + | Значения могут задаваться цифрами или буквами. Атрибут должен быть видимым, |
- | видимым следует сделать только его значение. Также необходим атрибут | + | причём видимым должно быть только значение. Также необходим атрибут |
[[#pinseq]]=.\\ | [[#pinseq]]=.\\ | ||
//Примеры://\\ ''pinnumber=1\\ pinnumber=13\\ pinnumber=A0'' | //Примеры://\\ ''pinnumber=1\\ pinnumber=13\\ pinnumber=A0'' | ||
Line 119: | Line 120: | ||
Атрибут **pintype**= не очень широко применяется в библиотеке символов, но он | Атрибут **pintype**= не очень широко применяется в библиотеке символов, но он | ||
используется для [[geda:glossary.ru#Проверка соответствия проектным нормам|проверки соответствия проектным нормам]] (DRC) и | используется для [[geda:glossary.ru#Проверка соответствия проектным нормам|проверки соответствия проектным нормам]] (DRC) и | ||
- | для создания [[geda:glossary.ru#Список соединений|списков соединений]].\\ | + | для создания [[geda:glossary.ru#Список соединений|списков соединений]]. |
+ | Если никакой другой тип для вывода не подходит, используйте "пассивный" | ||
+ | ("pas").\\ | ||
//Примеры://\\ ''pintype=clk\\ pintype=in\\ pintype=pas'' | //Примеры://\\ ''pintype=clk\\ pintype=in\\ pintype=pas'' | ||
| in | Input | Вход | | | in | Input | Вход | | ||
Line 129: | Line 132: | ||
| tp | Totem pole | Идольский столб((Шуточная расшифровка. На самом деле | | tp | Totem pole | Идольский столб((Шуточная расшифровка. На самом деле | ||
расшифровывается как "test pin/point" | расшифровывается как "test pin/point" | ||
- | ([[geda:glossary.ru#Контрольная точка|контрольный вывод/контрольная точка]]). | + | ([[geda:glossary.ru#контрольная точка]]/[[geda:glossary.ru#контрольный вывод]]). |
- | В ряде случаев в спецификациях выводы для тестирования или демпфирования | + | --- //Прим. перев.//)) | |
- | отмечаются производителями просто как неподключаемые (no-connect, nc). | + | |
- | Поскольку в рабочем режиме на указанных таким образом выводах может быть | + | |
- | какой-то потенциал, их не рекомендуется подключать к чему-либо в схеме. --- | + | |
- | //Прим. перев.//)) | | + | |
| tri | Tristate (high impedance)| Трёхстабильный, третье состояние --- высокоимпедансное | | | tri | Tristate (high impedance)| Трёхстабильный, третье состояние --- высокоимпедансное | | ||
| clk | Clock | Тактовый | | | clk | Clock | Тактовый | | ||
| pwr | Power/Ground | Питание/общий | | | pwr | Power/Ground | Питание/общий | | ||
- | | Таблица 1: Значения атрибута pintype ||| | + | | **Таблица 1:** Значения атрибута pintype ||| |
Line 144: | Line 143: | ||
Атрибут **pinlabel**= устанавливает метку вывода. Главным образом он | Атрибут **pinlabel**= устанавливает метку вывода. Главным образом он | ||
нужен программе **gnetlist** для поддержки иерархических проектов.\\ | нужен программе **gnetlist** для поддержки иерархических проектов.\\ | ||
- | Данный атрибут должен быть прикреплён к выводу и его следует сделать видимым. | + | Данный атрибут нужно прикрепить к выводу и сделать видимым. |
- | Он должен быть зелёного цвета (вместо жёлтого, который используется для | + | Он должен быть зелёного цвета (вместо жёлтого, стандартного цвета |
- | атрибутов по умолчанию).\\ | + | атрибутов).\\ |
//Примеры://\\ ''pinlabel=A0\\ pinlabel=DATA1\\ pinlabel=CLK'' | //Примеры://\\ ''pinlabel=A0\\ pinlabel=DATA1\\ pinlabel=CLK'' | ||
Line 155: | Line 154: | ||
например, 7400, имеющий 4 логических элемента 2И-НЕ в одном корпусе), то необходим | например, 7400, имеющий 4 логических элемента 2И-НЕ в одном корпусе), то необходим | ||
атрибут **numslots**=#. Число # задаёт количество элементов в физическом | атрибут **numslots**=#. Число # задаёт количество элементов в физическом | ||
- | устройстве. Атрибут **numslots**= должен быть в символе и его следует сделать | + | устройстве. Атрибут **numslots**= нужно расположить где-нибудь в символе и сделать |
- | невидимым. Данный атрибут является свободным. Если символ не требуется | + | невидимым. Данный атрибут является свободным. Если символу не нужно |
- | разбивать на секции, в файл символа следует поместить **numslots**=0.\\ | + | [[geda:glossary.ru#Назначение логических секций|назначать секции]], в |
+ | файл символа следует поместить **numslots**=0.\\ | ||
//Пример://\\ ''numslots=4'' | //Пример://\\ ''numslots=4'' | ||
Line 165: | Line 165: | ||
компонент|многосекционного прибора]], содержащего | компонент|многосекционного прибора]], содержащего | ||
несколько секций в одном физическом корпусе, то для каждой из этих | несколько секций в одном физическом корпусе, то для каждой из этих | ||
- | секций необходимо задать атрибут **slotdef**=slotnumber:#,#,#... . \\ | + | секций необходимо задать атрибут **slotdef**=номер_секции:#,#,#... . \\ |
- | Число ''slotnumber'' соответствует номеру секции. Двоеточие после номера | + | Число ''номер_секции'' соответствует номеру секции. Двоеточие после номера |
секции обязательно. Например, для устройства, содержащего 4 секции, в | секции обязательно. Например, для устройства, содержащего 4 секции, в | ||
- | символе должны быть атрибуты **slotdef**=1:..., **slotdef**=2:..., | + | символ нужно было бы добавить атрибуты **slotdef**=1:..., **slotdef**=2:..., |
- | **slotdef**=3:... и **slotdef**=4:..., их следует сделать невидимыми. Данный | + | **slotdef**=3:... и **slotdef**=4:... и сделать их невидимыми. Данный |
атрибут является свободным.\\ | атрибут является свободным.\\ | ||
Числа # однозначно соответствуют значениям атрибутов [[#pinseq]]= и определяют | Числа # однозначно соответствуют значениям атрибутов [[#pinseq]]= и определяют | ||
Line 176: | Line 176: | ||
Для всех символов, определяющих несколько секций, рекомендуется задавать | Для всех символов, определяющих несколько секций, рекомендуется задавать | ||
атрибут [[#slot]]=1, прикрепляемый таким же образом, как и [[#device]]=.\\ | атрибут [[#slot]]=1, прикрепляемый таким же образом, как и [[#device]]=.\\ | ||
- | Для конкретного примера см. символ 7400-1.sym.\\ | + | См. символ 7400-1.sym как пример реального применения **slotdef**=.\\ |
//Примеры://\\ ''slotdef=1:1,2,3\\ slotdef=2:4,5,6\\ slotdef=3:7,8,9''\\ | //Примеры://\\ ''slotdef=1:1,2,3\\ slotdef=2:4,5,6\\ slotdef=3:7,8,9''\\ | ||
Данный атрибут замещает устаревший **slot**#=#. | Данный атрибут замещает устаревший **slot**#=#. | ||
Line 182: | Line 182: | ||
==== footprint ==== | ==== footprint ==== | ||
- | В символе должен быть атрибут **footprint**=название_корпуса, его следует | + | Атрибут **footprint**=название_корпуса нужно расположить где-нибудь в символе и |
сделать невидимым. Он используется программой **gnetlist** и главным образом | сделать невидимым. Он используется программой **gnetlist** и главным образом | ||
для пакета **pcb**.\\ | для пакета **pcb**.\\ | ||
Line 188: | Line 188: | ||
свободным.\\ | свободным.\\ | ||
''название_корпуса'' определяет посадочное место для **pcb** или типоразмер корпуса, | ''название_корпуса'' определяет посадочное место для **pcb** или типоразмер корпуса, | ||
- | как например DIP14 или DIP40. Хотя в принципе значения данного атрибута | + | как, например, DIP14 или DIP40. Хотя в принципе значения данного атрибута |
зависят от пакета **pcb**, в gEDA/gaf существуют соглашения о том, чтобы | зависят от пакета **pcb**, в gEDA/gaf существуют соглашения о том, чтобы | ||
делать их как можно лучше переносимыми для предоставления пользователям | делать их как можно лучше переносимыми для предоставления пользователям | ||
Line 199: | Line 199: | ||
==== documentation ==== | ==== documentation ==== | ||
- | В символе может быть атрибут **documentation**=ссылка_на_документацию и, если он | + | Атрибут **documentation**=ссылка_на_документацию можно расположить где-нибудь |
- | имеется, его следует сделать невидимым. Данный атрибут используется программой | + | в символе и сделать невидимым. Данный атрибут используется программой |
**gschemdoc** для поиска подходящей документации по символу, или, вернее, по | **gschemdoc** для поиска подходящей документации по символу, или, вернее, по | ||
устройству или компоненту, определяемому данным символом.\\ | устройству или компоненту, определяемому данным символом.\\ | ||
Line 234: | Line 234: | ||
имени файла подсхемы (например, ''block.sch''), но не полного пути | имени файла подсхемы (например, ''block.sch''), но не полного пути | ||
доступа. Указанный файл подсхемы должен находиться в одном из каталогов, | доступа. Указанный файл подсхемы должен находиться в одном из каталогов, | ||
- | перечисленных среди путей доступа к библиотекам источников данных. Можно | + | перечисленных среди путей доступа к |
+ | [[gEDA:glossary.ru#Библиотека исходных данных|библиотекам исходных данных]]. | ||
+ | Можно | ||
прикреплять несколько таких атрибутов с различными значениями, что, по | прикреплять несколько таких атрибутов с различными значениями, что, по | ||
- | существу, означает, что есть несколько связанных подсхем.\\ | + | существу, означает, что подсхема представляет собой набор из нескольких |
+ | связанных между собой схем.\\ | ||
//Примеры://\\ ''source=underlying.sch\\ source=memory.sch'' | //Примеры://\\ ''source=underlying.sch\\ source=memory.sch'' | ||
Line 246: | Line 249: | ||
имеющего какой-либо электрический смысл. Для установки позиционного | имеющего какой-либо электрический смысл. Для установки позиционного | ||
обозначения, используемого для компонента по умолчанию (такого как 'U?', | обозначения, используемого для компонента по умолчанию (такого как 'U?', | ||
- | например), данный атрибут может задаваться непосредственно в символе (если он | + | например), данный атрибут может задаваться непосредственно в символе (и если он |
видим, то при помещении символа в схему будет вынесен, то есть прикреплён вне | видим, то при помещении символа в схему будет вынесен, то есть прикреплён вне | ||
символа).\\ | символа).\\ | ||
Line 258: | Line 261: | ||
В частности [[geda:faq-gsch2pcb.ru|gsch2pcb]] требует: | В частности [[geda:faq-gsch2pcb.ru|gsch2pcb]] требует: | ||
* Не должно быть пробелов. | * Не должно быть пробелов. | ||
- | * Не должно быть дефисов. Это может расстроить макроязык M4, потенциально используемый для генерирования посадочных мест. Символ подчёркивания "_" допустим. | + | * Не должно быть дефисов. Это может привести к сбою интерпретатора макроязыка M4, потенциально используемого для генерирования посадочных мест. Символ подчёркивания "_" допустим. |
* Любой суффикс из строчных букв игнорируется. Таким образом в схему можно добавить 4 дискретных элемента И-НЕ с обозначениями ''U1a'', ''U1b'', ''U1c'' и ''U1d''. При создании списка соединений они будут относиться к одному посадочному месту с названием ''U1''. | * Любой суффикс из строчных букв игнорируется. Таким образом в схему можно добавить 4 дискретных элемента И-НЕ с обозначениями ''U1a'', ''U1b'', ''U1c'' и ''U1d''. При создании списка соединений они будут относиться к одному посадочному месту с названием ''U1''. | ||
* Символы, не входящие в [[geda:glossary.ru#ASCII]], такие как, например, üöäß, не выводятся в **pcb**. | * Символы, не входящие в [[geda:glossary.ru#ASCII]], такие как, например, üöäß, не выводятся в **pcb**. | ||
Line 268: | Line 271: | ||
не соответствуют отечественным стандартам, см. ГОСТ 2.710-81. --- | не соответствуют отечественным стандартам, см. ГОСТ 2.710-81. --- | ||
//Прим. перев.//)) | //Прим. перев.//)) | ||
- | (замените ? на число): | + | (''?'' заменяется числом): |
^ Обозначение ^ Тип компонента ^ | ^ Обозначение ^ Тип компонента ^ | ||
| R? |Резистор| | | R? |Резистор| | ||
Line 295: | Line 298: | ||
приборе]]. В схеме | приборе]]. В схеме | ||
он должен прикрепляться к экземпляру символа компонента. Для выбора секции | он должен прикрепляться к экземпляру символа компонента. Для выбора секции | ||
- | по умолчанию данный атрибут может задаваться в символе (если он видим, то при | + | по умолчанию данный атрибут может задаваться в символе (и если он видим, то при |
помещении символа в схему будет вынесен, то есть прикреплён вне символа). | помещении символа в схему будет вынесен, то есть прикреплён вне символа). | ||
Line 301: | Line 304: | ||
==== net ==== | ==== net ==== | ||
Атрибут **net**= используется для создания соединений питания и специальных | Атрибут **net**= используется для создания соединений питания и специальных | ||
- | целей. Для более подробной информации обратитесь к | + | целей. Подробности см. в |
[[gEDA:na_howto.ru|Мини-HOWTO по атрибуту net=]]. Если данный атрибут | [[gEDA:na_howto.ru|Мини-HOWTO по атрибуту net=]]. Если данный атрибут | ||
находится в символе, он используется для создания соединений. Если же он | находится в символе, он используется для создания соединений. Если же он | ||
Line 347: | Line 350: | ||
версии). | версии). | ||
- | Обычно при помещении данного атрибута в файл символа целесообразно сделать его | + | Обычно при помещении данного атрибута в файл символа его лучше сделать |
- | невидимым. Если атрибут найден в символе при его помещении в схему, то он | + | невидимым. Если при добавлении символа в схему в нём найден этот атрибут, то он |
- | всегда выносится. Вручную прикреплять данный атрибут к имеющимся в схеме | + | всегда выносится. Не следует прикреплять данный атрибут к имеющимся в схеме |
- | экземплярам символов пользователи не должны. | + | экземплярам символов вручную. |
//Примеры: //\\ ''symversion=1.1\\ symversion=2.0'' | //Примеры: //\\ ''symversion=1.1\\ symversion=2.0'' | ||
Line 358: | Line 361: | ||
Атрибут **dist-license**= используется для указания лицензии, под которой | Атрибут **dist-license**= используется для указания лицензии, под которой | ||
распространяется символ или схема. В нём должна задаваться известная лицензия. | распространяется символ или схема. В нём должна задаваться известная лицензия. | ||
- | Вот некоторые примеры: | + | Вот несколько примеров его возможных значений: |
''GPL'', ''GPL version 2 only'', ''GPL version 3 only'', ''public domain'', | ''GPL'', ''GPL version 2 only'', ''GPL version 3 only'', ''public domain'', | ||
- | ''Apache version 2'', ''Modified BSD'', ''X11'' и т.д..\\ | + | ''Apache version 2'', ''Modified BSD'', ''X11'' и т. д.\\ |
\\ | \\ | ||
Перечни существующих лицензий можно найти по следующим адресам: | Перечни существующих лицензий можно найти по следующим адресам: | ||
Line 372: | Line 375: | ||
схемах и платах. Вот примеры его значений: ''unlimited'' (неограниченная), | схемах и платах. Вот примеры его значений: ''unlimited'' (неограниченная), | ||
''personal use only'' (только для личного пользования), ''not for sale'' (не | ''personal use only'' (только для личного пользования), ''not for sale'' (не | ||
- | для продажи) и т.д..\\ | + | для продажи) и т. д.\\ |
FIXME: добавить сюда набор примеров получше. | FIXME: добавить сюда набор примеров получше. | ||
Line 385: | Line 388: | ||
==== name ==== | ==== name ==== | ||
Атрибут **name**= не должен ни использоваться в символе, ни прикрепляться в | Атрибут **name**= не должен ни использоваться в символе, ни прикрепляться в | ||
- | схеме. Он считается неоднозначным. Данный атрибут никогда не использовался в | + | схеме. Считается, что такое название атрибута неоднозначно. Данный атрибут |
- | gEDA/gaf. | + | никогда не использовался в gEDA/gaf. |
Line 404: | Line 407: | ||
==== slot# ==== | ==== slot# ==== | ||
Атрибут **slot#**=# устарел и использоваться не должен. Ранее в нём | Атрибут **slot#**=# устарел и использоваться не должен. Ранее в нём | ||
- | предоставлялась информация о секциях компонентов. Теперь | + | предоставлялась информация о [[geda:glossary.ru#Назначение логических |
+ | секций|назначении секций]] компонентов. Теперь | ||
эту функцию выполняет атрибут [[#slotdef]]=. | эту функцию выполняет атрибут [[#slotdef]]=. | ||
Line 427: | Line 431: | ||
| 6 июля 2004 г. | Добавлен атрибут symversion=. | | | 6 июля 2004 г. | Добавлен атрибут symversion=. | | ||
| 10 июля 2007 г. | Добавлены атрибуты dist-license= и use-license=. | | | 10 июля 2007 г. | Добавлены атрибуты dist-license= и use-license=. | | ||
- |