This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
geda:master_attributes_list.ru [2012/05/02 01:34] vzh Updated, revised the translation |
geda:master_attributes_list.ru [2014/04/23 07:05] vzh Updated using po4a |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | //Эта страница доступна также на следующих языках:// | ||
+ | [[master_attributes_list|English]] | ||
+ | |||
====== Перечень основных атрибутов gEDA/gaf ====== | ====== Перечень основных атрибутов gEDA/gaf ====== | ||
- | Автор: Ales Hvezda, ahvezda@geda.seul.org | + | //Ales Hvezda, ahvezda@geda.seul.org// |
- | Настоящий документ выпущен под лицензией | + | Настоящий документ распространяется под лицензией |
[[http://www.gnu.org/copyleft/fdl.html|GFDL]] | [[http://www.gnu.org/copyleft/fdl.html|GFDL]] | ||
10 июля 2007 г. | 10 июля 2007 г. | ||
- | |||
- | Перевод: Владимир Жбанов, 2010-2011 гг. | ||
- | |||
===== Обзор ===== | ===== Обзор ===== | ||
В настоящем документе приводится описание всех атрибутов, используемых в | В настоящем документе приводится описание всех атрибутов, используемых в | ||
- | gEDA/gaf | + | gEDA/gaf (GPL'd Electronic Design Automation / __g__schem __a__nd |
- | (GPL'd Electronic Design Automation / __g__schem __a__nd __f__riends)((САПР | + | __f__riends)((САПР электроники под лицензией GPL / gschem и друзья. --- |
- | электроники под лицензией GPL / gschem и друзья. --- //Прим. перев.//)). | + | //Прим. перев.//)). Документ разбит на несколько разделов: данная обзорная |
- | Документ разбит на несколько разделов: данная обзорная часть, атрибуты только | + | часть, атрибуты только для [[geda:glossary.ru#Символ|символов]], атрибуты |
- | для [[geda:glossary.ru#Символ|символов]], атрибуты только для схем, атрибуты | + | только для схем, атрибуты для символов и схем, описание устаревших атрибутов |
- | для символов и схем, описание устаревших атрибутов или атрибутов, | + | или атрибутов, использовать которые больше не рекомендуется.\\ Далее в |
- | использовать которые больше не рекомендуется.\\ | + | настоящем документе имена атрибутов выделены **жирным шрифтом**, примеры --- |
- | Далее в настоящем документе имена атрибутов выделены **жирным шрифтом**, | + | ''машинописным''. |
- | примеры --- ''машинописным''. | + | |
===== Что такое атрибуты? ===== | ===== Что такое атрибуты? ===== | ||
Line 27: | Line 25: | ||
**имя_атрибута**=значение. Имя может содержать что угодно, за исключением | **имя_атрибута**=значение. Имя может содержать что угодно, за исключением | ||
знака равенства. Значение может также содержать что угодно, но не может быть | знака равенства. Значение может также содержать что угодно, но не может быть | ||
- | пустой строкой. **имя_атрибута**= (без значения) не является допустимым атрибутом. | + | пустой строкой. **имя_атрибута**= (без значения) не является допустимым |
- | Также не должно быть пробелов непосредственно до или после знака равенства.\\ | + | атрибутом. Также не должно быть пробелов непосредственно до или после знака |
- | Атрибуты могут быть прикреплены к некоторой части символа. Если атрибут несёт | + | равенства.\\ Атрибуты могут быть прикреплены к некоторой части символа. Если |
- | информацию, специфическую для объекта, он должен быть прикреплён | + | атрибут несёт информацию, специфическую для объекта, он должен быть |
- | непосредственно к этому объекту, в противном случае он может быть свободным | + | прикреплён непосредственно к этому объекту, в противном случае он может быть |
- | (плавающим, неприкреплённым). Свободные атрибуты просто находятся в файле | + | свободным (плавающим, неприкреплённым). Свободные атрибуты просто находятся |
- | символа как текстовые элементы вида **имя_атрибута**=значение. | + | в файле символа как текстовые элементы вида **имя_атрибута**=значение. |
+ | ===== Атрибуты только для символов ===== | ||
- | ===== Атрибуты только для символов ===== | ||
==== device ==== | ==== device ==== | ||
- | Атрибутом **device**= задаётся название устройства в символе. | + | Атрибутом **device**= задаётся название устройства в символе. Его нужно расположить где-нибудь в символе и сделать невидимым. Данный атрибут является свободным. Если объект является графическим, то атрибут **device**= должен иметь значение ''none'' (**device**=none), и в символе должен быть атрибут [[#graphical]]=. Не следует путать данный атрибут с простым текстовым обозначением устройства. Не следует в названии устройства использовать пробелы, некоторым программам это не нравится. Как правило, название устройства указывается полностью прописными буквами.\\ //Примеры://\\ ''device=7400\\ device=CONNECTOR_10\\ device=NPN_TRANSISTOR'' |
- | Его нужно расположить где-нибудь в символе и сделать невидимым. Данный атрибут | + | |
- | является свободным. Если объект является графическим, то атрибут **device**= | + | |
- | должен иметь значение ''none'' (**device**=none), и в символе должен быть | + | |
- | атрибут [[#graphical]]=. Не следует путать данный атрибут с простым текстовым | + | |
- | обозначением устройства. Не следует в названии устройства использовать | + | |
- | пробелы, некоторым программам это не нравится. Как правило, название устройства | + | |
- | указывается полностью прописными буквами.\\ | + | |
- | //Примеры://\\ ''device=7400\\ device=CONNECTOR_10\\ device=NPN_TRANSISTOR'' | + | |
==== graphical ==== | ==== graphical ==== | ||
- | Наличие атрибута **graphical**=1 обязательно для символов, не предназначенных | + | Наличие атрибута **graphical**=1 обязательно для символов, не |
- | для электрических или схемотехнических целей. Такие символы, как рамка | + | предназначенных для электрических или схемотехнических целей. Такие символы, |
- | основной надписи для чертежей, являются чисто графическими. Любой символ, | + | как рамка основной надписи для чертежей, являются чисто графическими. Любой |
- | имеющий **graphical**=1, игнорируется программой **gnetlist**.\\ | + | символ, имеющий **graphical**=1, игнорируется программой **gnetlist**.\\ |
- | Чисто графический символ должен содержать невидимый атрибут **graphical**=1. | + | Чисто графический символ должен содержать невидимый атрибут |
- | Данный атрибут является свободным. При его наличии не | + | **graphical**=1. Данный атрибут является свободным. При его наличии не |
забудьте установить [[#device]]=none.\\ | забудьте установить [[#device]]=none.\\ | ||
- | //Пример://\\ ''graphical=1'' | + | //Пример://\\ |
+ | ''graphical=1'' | ||
==== description ==== | ==== description ==== | ||
Line 66: | Line 55: | ||
''description=4 NAND gates with 2 inputs''\\ | ''description=4 NAND gates with 2 inputs''\\ | ||
''description=4x2И-НЕ'' | ''description=4x2И-НЕ'' | ||
- | |||
==== author ==== | ==== author ==== | ||
Line 72: | Line 60: | ||
адрес. Данный атрибут является необязательным, но порой просто приятно иметь | адрес. Данный атрибут является необязательным, но порой просто приятно иметь | ||
представление о том, кто какой символ сделал. Ещё он служит для того, чтобы | представление о том, кто какой символ сделал. Ещё он служит для того, чтобы | ||
- | узнать, с кем можно связаться, если есть вопросы о назначении символа. Данный | + | узнать, с кем можно связаться, если есть вопросы о назначении |
- | атрибут имеет свободную форму и поэтому может также содержать и имена | + | символа. Данный атрибут имеет свободную форму и поэтому может также |
- | изменявших символ людей, и множество электронных адресов. Ещё может быть было | + | содержать и имена изменявших символ людей, и множество электронных |
- | бы неплохо как-то изменить адрес, чтобы он не стал жертвой спама.\\ | + | адресов. Ещё может быть было бы неплохо как-то изменить адрес, чтобы он не |
- | //Пример://\\ ''author=Ales Hvezda ahvezdaATgeda.seul.org'' | + | стал жертвой спама.\\ |
+ | //Пример://\\ | ||
+ | ''author=Ales Hvezda ahvezdaATgeda.seul.org'' | ||
==== comment ==== | ==== comment ==== | ||
Атрибут **comment**= может содержать всё что угодно. С его помощью может | Атрибут **comment**= может содержать всё что угодно. С его помощью может | ||
- | передаваться любая дополнительная информация, которую нельзя включить в другие | + | передаваться любая дополнительная информация, которую нельзя включить в |
- | атрибуты. В символе может быть несколько экземпляров данного атрибута.\\ | + | другие атрибуты. В символе может быть несколько экземпляров данного |
- | //Пример://\\ ''comment=Это комментарий внутри символа'' | + | атрибута.\\ |
+ | //Пример://\\ | ||
+ | ''comment=Это комментарий внутри символа'' | ||
==== pinseq ==== | ==== pinseq ==== | ||
- | Данный атрибут используется для задания каждому выводу уникального порядкового | + | Данный атрибут используется для задания каждому выводу уникального |
- | номера. Атрибуты **pinseq**=# должны быть прикреплены к каждому из выводов. Их | + | порядкового номера. Атрибуты **pinseq**=# должны быть прикреплены к каждому |
- | следует сделать невидимыми. Данные атрибуты широко используются программами | + | из выводов. Их следует сделать невидимыми. Данные атрибуты широко |
- | **gschem** и **gnetlist**.\\ | + | используются программами **gschem** и **gnetlist**.\\ При работе некоторых |
- | При работе некоторых драйверов (особенно драйвера SPICE) | + | драйверов (особенно драйвера SPICE) **gnetlist** выдаёт выводы в порядке |
- | **gnetlist** выдаёт выводы в порядке возрастания их порядковых номеров. | + | возрастания их порядковых номеров. Порядковые номера должны начинаться с 1 |
- | Порядковые номера должны начинаться с 1 и последовательно увеличиваться, | + | и последовательно увеличиваться, причём пропускать их не допускается. Данный |
- | причём пропускать их не допускается. Данный атрибут не является номером вывода | + | атрибут не является номером вывода (т. е. номером вывода компонента, как, |
- | (т. е. номером вывода компонента, как, например, вывод GND имеет номер 7 для | + | например, вывод GND имеет номер 7 для многих TTL-микросхем). Для нумерации |
- | многих TTL-микросхем). Для нумерации выводов служит атрибут [[#pinnumber]]=.\\ | + | выводов служит атрибут [[#pinnumber]]=.\\ |
- | //Примеры://\\ ''pinseq=1\\ pinseq=2\\ pinseq=3'' | + | //Примеры://\\ |
+ | ''pinseq=1\\ | ||
+ | pinseq=2\\ | ||
+ | pinseq=3'' | ||
Данный атрибут замещает устаревший **pin#**=#. | Данный атрибут замещает устаревший **pin#**=#. | ||
- | |||
==== pinnumber ==== | ==== pinnumber ==== | ||
Атрибут **pinnumber**=# определяет номер вывода компонента (как, например, | Атрибут **pinnumber**=# определяет номер вывода компонента (как, например, | ||
- | вывод GND имеет номер 7 для TTL серии 74). Он должен быть прикреплён к каждому | + | вывод GND имеет номер 7 для TTL серии 74). Он должен быть прикреплён к |
- | выводу.\\ | + | каждому выводу.\\ |
Значения могут задаваться цифрами или буквами. Атрибут должен быть видимым, | Значения могут задаваться цифрами или буквами. Атрибут должен быть видимым, | ||
причём видимым должно быть только значение. Также необходим атрибут | причём видимым должно быть только значение. Также необходим атрибут | ||
[[#pinseq]]=.\\ | [[#pinseq]]=.\\ | ||
- | //Примеры://\\ ''pinnumber=1\\ pinnumber=13\\ pinnumber=A0'' | + | //Примеры://\\ |
+ | ''pinnumber=1\\ | ||
+ | pinnumber=13\\ | ||
+ | pinnumber=A0'' | ||
Данный атрибут замещает устаревший **pin#**=#. | Данный атрибут замещает устаревший **pin#**=#. | ||
- | |||
==== pintype ==== | ==== pintype ==== | ||
Line 118: | Line 112: | ||
следует сделать невидимым. В таблице 1 приведены допустимые значения данного | следует сделать невидимым. В таблице 1 приведены допустимые значения данного | ||
атрибута.\\ | атрибута.\\ | ||
- | Атрибут **pintype**= не очень широко применяется в библиотеке символов, но он | + | Атрибут **pintype**= не очень широко применяется в библиотеке символов, но |
- | используется для [[geda:glossary.ru#Проверка соответствия проектным нормам|проверки соответствия проектным нормам]] (DRC) и | + | он используется для [[geda:glossary.ru#Проверка соответствия проектным |
- | для создания [[geda:glossary.ru#Список соединений|списков соединений]]. | + | нормам|проверки соответствия проектным нормам]] (DRC) и для создания |
- | Если никакой другой тип для вывода не подходит, используйте "пассивный" | + | [[geda:glossary.ru#Список соединений|списков соединений]]. Если никакой |
- | ("pas").\\ | + | другой тип для вывода не подходит, используйте «пассивный» («pas»).\\ |
- | //Примеры://\\ ''pintype=clk\\ pintype=in\\ pintype=pas'' | + | //Примеры://\\ |
+ | ''pintype=clk\\ | ||
+ | pintype=in\\ | ||
+ | pintype=pas'' | ||
+ | |||
+ | **Таблица 1:** Значения атрибута pintype | ||
| in | Input | Вход | | | in | Input | Вход | | ||
| out | Output | Выход | | | out | Output | Выход | | ||
Line 130: | Line 129: | ||
| oe | Open emitter | Открытый эмиттер | | | oe | Open emitter | Открытый эмиттер | | ||
| pas | Passive | Пассивный | | | pas | Passive | Пассивный | | ||
- | | tp | Totem pole | Идольский столб((Шуточная расшифровка. На самом деле | + | | tp | Totem pole | Идольский столб((Шуточная расшифровка. На самом деле расшифровывается как «test pin/point» ([[geda:glossary.ru#контрольная точка]]/[[geda:glossary.ru#контрольный вывод]]). --- //Прим. перев.//)) | |
- | расшифровывается как "test pin/point" | + | |
- | ([[geda:glossary.ru#контрольная точка]]/[[geda:glossary.ru#контрольный вывод]]). | + | |
- | --- //Прим. перев.//)) | | + | |
| tri | Tristate (high impedance)| Трёхстабильный, третье состояние --- высокоимпедансное | | | tri | Tristate (high impedance)| Трёхстабильный, третье состояние --- высокоимпедансное | | ||
| clk | Clock | Тактовый | | | clk | Clock | Тактовый | | ||
| pwr | Power/Ground | Питание/общий | | | pwr | Power/Ground | Питание/общий | | ||
- | | **Таблица 1:** Значения атрибута pintype ||| | ||
- | |||
==== pinlabel ==== | ==== pinlabel ==== | ||
- | Атрибут **pinlabel**= устанавливает метку вывода. Главным образом он | + | Атрибут **pinlabel**= устанавливает метку вывода. Главным образом он нужен |
- | нужен программе **gnetlist** для поддержки иерархических проектов.\\ | + | программе **gnetlist** для поддержки иерархических проектов.\\ |
- | Данный атрибут нужно прикрепить к выводу и сделать видимым. | + | Данный атрибут нужно прикрепить к выводу и сделать видимым. Он должен быть |
- | Он должен быть зелёного цвета (вместо жёлтого, стандартного цвета | + | зелёного цвета (вместо жёлтого, стандартного цвета атрибутов).\\ |
- | атрибутов).\\ | + | //Примеры://\\ |
- | //Примеры://\\ ''pinlabel=A0\\ pinlabel=DATA1\\ pinlabel=CLK'' | + | ''pinlabel=A0\\ |
+ | pinlabel=DATA1\\ | ||
+ | pinlabel=CLK'' | ||
==== numslots ==== | ==== numslots ==== | ||
Если компонент содержит несколько [[geda:glossary.ru#Секция | Если компонент содержит несколько [[geda:glossary.ru#Секция | ||
- | компонента|секций]] (элементов) в одном физическом корпусе (как, | + | компонента|секций]] (элементов) в одном физическом корпусе (как, например, |
- | например, 7400, имеющий 4 логических элемента 2И-НЕ в одном корпусе), то необходим | + | 7400, имеющий 4 логических элемента 2И-НЕ в одном корпусе), то необходим |
атрибут **numslots**=#. Число # задаёт количество элементов в физическом | атрибут **numslots**=#. Число # задаёт количество элементов в физическом | ||
- | устройстве. Атрибут **numslots**= нужно расположить где-нибудь в символе и сделать | + | устройстве. Атрибут **numslots**= нужно расположить где-нибудь в символе и |
- | невидимым. Данный атрибут является свободным. Если символ не требуется | + | сделать невидимым. Данный атрибут является свободным. Если символу не нужно |
- | разбивать на секции, в файл символа следует поместить **numslots**=0.\\ | + | [[geda:glossary.ru#Назначение логических секций|назначать секции]], в файл |
- | //Пример://\\ ''numslots=4'' | + | символа следует поместить **numslots**=0.\\ |
+ | //Пример://\\ | ||
+ | ''numslots=4'' | ||
==== slotdef ==== | ==== slotdef ==== | ||
Если компонент служит для представления [[geda:glossary.ru#Многосекционный | Если компонент служит для представления [[geda:glossary.ru#Многосекционный | ||
- | компонент|многосекционного прибора]], содержащего | + | компонент|многосекционного прибора]], содержащего несколько секций в одном |
- | несколько секций в одном физическом корпусе, то для каждой из этих | + | физическом корпусе, то для каждой из этих секций необходимо задать атрибут |
- | секций необходимо задать атрибут **slotdef**=номер_секции:#,#,#... . \\ | + | **slotdef**=номер_секции:#,#,#... \\ |
Число ''номер_секции'' соответствует номеру секции. Двоеточие после номера | Число ''номер_секции'' соответствует номеру секции. Двоеточие после номера | ||
- | секции обязательно. Например, для устройства, содержащего 4 секции, в | + | секции обязательно. Например, для устройства, содержащего 4 секции, в символ |
- | символ нужно было бы добавить атрибуты **slotdef**=1:..., **slotdef**=2:..., | + | нужно было бы добавить атрибуты **slotdef**=1:..., **slotdef**=2:..., |
**slotdef**=3:... и **slotdef**=4:... и сделать их невидимыми. Данный | **slotdef**=3:... и **slotdef**=4:... и сделать их невидимыми. Данный | ||
атрибут является свободным.\\ | атрибут является свободным.\\ | ||
- | Числа # однозначно соответствуют значениям атрибутов [[#pinseq]]= и определяют | + | Числа # однозначно соответствуют значениям атрибутов [[#pinseq]]= и |
- | номера выводов [[#pinnumber]]=#, используемые для отображения на экране (в | + | определяют номера выводов [[#pinnumber]]=#, используемые для отображения на |
- | **gschem**) и для создания списка соединений (с помощью **gnetlist**).\\ | + | экране (в **gschem**) и для создания списка соединений (с помощью |
+ | **gnetlist**).\\ | ||
Для всех символов, определяющих несколько секций, рекомендуется задавать | Для всех символов, определяющих несколько секций, рекомендуется задавать | ||
атрибут [[#slot]]=1, прикрепляемый таким же образом, как и [[#device]]=.\\ | атрибут [[#slot]]=1, прикрепляемый таким же образом, как и [[#device]]=.\\ | ||
См. символ 7400-1.sym как пример реального применения **slotdef**=.\\ | См. символ 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**#=#. | ||
- | |||
==== footprint ==== | ==== footprint ==== | ||
- | Атрибут **footprint**=название_корпуса нужно расположить где-нибудь в символе и | + | Атрибут **footprint**=название_корпуса нужно расположить где-нибудь в символе и сделать невидимым. Он используется программой **gnetlist** и главным образом для пакета **pcb**.\\ |
- | сделать невидимым. Он используется программой **gnetlist** и главным образом | + | Атрибут прикрепляется таким же образом, как и [[#device]]=. Он является свободным.\\ |
- | для пакета **pcb**.\\ | + | ''название_корпуса'' определяет посадочное место для **pcb** или типоразмер корпуса, как, например, DIP14 или DIP40. Хотя в принципе значения данного атрибута зависят от пакета **pcb**, в gEDA/gaf существуют соглашения о том, чтобы делать их как можно лучше переносимыми для предоставления пользователям возможностей удобного сотрудничества и совместного использования. См. [[gEDA:pcb_footprint_naming_conventions.ru|Соглашения по именованию посадочных мест]].\\ |
- | Атрибут прикрепляется таким же образом, как и [[#device]]=. Он является | + | Если для символа посадочное место не нужно или если оно должно переопределяться в схеме, следует установить **footprint**=none. Если название посадочного места неизвестно, следует установить **footprint**=unknown. |
- | свободным.\\ | + | |
- | ''название_корпуса'' определяет посадочное место для **pcb** или типоразмер корпуса, | + | |
- | как, например, DIP14 или DIP40. Хотя в принципе значения данного атрибута | + | |
- | зависят от пакета **pcb**, в gEDA/gaf существуют соглашения о том, чтобы | + | |
- | делать их как можно лучше переносимыми для предоставления пользователям | + | |
- | возможностей удобного сотрудничества и совместного использования. | + | |
- | См. [[gEDA:pcb_footprint_naming_conventions.ru|Соглашения по именованию посадочных мест]].\\ | + | |
- | Если для символа посадочное место не нужно или если оно должно | + | |
- | переопределяться в схеме, следует установить **footprint**=none. Если | + | |
- | название посадочного места неизвестно, следует установить **footprint**=unknown. | + | |
==== documentation ==== | ==== documentation ==== | ||
- | Атрибут **documentation**=ссылка_на_документацию можно расположить где-нибудь | + | Атрибут **documentation**=ссылка_на_документацию можно расположить где-нибудь в символе и сделать невидимым. Данный атрибут используется программой **gschemdoc** для поиска подходящей документации по символу, или, вернее, по устройству или компоненту, определяемому данным символом.\\ |
- | в символе и сделать невидимым. Данный атрибут используется программой | + | Атрибут прикрепляется таким же образом, как и [[#device]]=. Он является свободным.\\ |
- | **gschemdoc** для поиска подходящей документации по символу, или, вернее, по | + | ''ссылка_на_документацию'' определяет либо имя основного файла документации, либо полный интернет-адрес. Если в атрибуте задано имя файла, программа попытается найти его в локальном каталоге //''documentation''// пакета gEDA.\\ |
- | устройству или компоненту, определяемому данным символом.\\ | + | //Пример имени файла://\\ |
- | Атрибут прикрепляется таким же образом, как и [[#device]]=. Он является | + | ''documentation=sn74ls00.pdf''\\ |
- | свободным.\\ | + | |
- | ''ссылка_на_документацию'' определяет либо имя основного файла документации, | + | |
- | либо полный интернет-адрес. Если в атрибуте задано имя файла, программа | + | |
- | попытается найти его в локальном каталоге //''documentation''// пакета | + | |
- | gEDA.\\ | + | |
- | + | ||
- | //Пример имени файла://\\ ''documentation=sn74ls00.pdf''\\ | + | |
//Пример интернет-адреса://\\ | //Пример интернет-адреса://\\ | ||
''%%documentation=http://www-s.ti.com/sc/ds/sn74ls00.pdf%%'' | ''%%documentation=http://www-s.ti.com/sc/ds/sn74ls00.pdf%%'' | ||
- | |||
===== Атрибуты только для схем ===== | ===== Атрибуты только для схем ===== | ||
==== netname ==== | ==== netname ==== | ||
Атрибут **netname**= должен прикрепляться к объекту | Атрибут **netname**= должен прикрепляться к объекту | ||
- | <<[[geda:glossary.ru#соединение]]>> для | + | <<[[geda:glossary.ru#соединение]]>> для установки его имени. Крайне не |
- | установки его имени. Крайне не рекомендуется использовать разные имена | + | рекомендуется использовать разные имена для связанных сегментов |
- | для связанных сегментов соединений. Одинаково названные соединения считаются | + | соединений. Одинаково названные соединения считаются электрически замкнутыми |
- | электрически замкнутыми между собой. Недопустимо использовать данный атрибут | + | между собой. Недопустимо использовать данный атрибут внутри символов (так |
- | внутри символов (так как внутри символов соединения использовать нельзя).\\ | + | как внутри символов соединения использовать нельзя).\\ |
- | //Примеры://\\ ''netname=DATA0 H\\ netname=CLK L'' | + | //Примеры://\\ |
+ | ''netname=DATA0 H\\ | ||
+ | netname=CLK L'' | ||
==== source ==== | ==== source ==== | ||
Line 229: | Line 211: | ||
[[geda:glossary.ru#Подсхема|подсхемы]]. Он прикрепляется непосредственно к | [[geda:glossary.ru#Подсхема|подсхемы]]. Он прикрепляется непосредственно к | ||
символу компонента.\\ | символу компонента.\\ | ||
- | Данный атрибут должен прикрепляться только к экземплярам символов компонентов | + | Данный атрибут должен прикрепляться только к экземплярам символов |
- | в схеме. Атрибут следует прикрепить к символу и задать значение в виде | + | компонентов в схеме. Атрибут следует прикрепить к символу и задать значение |
- | имени файла подсхемы (например, ''block.sch''), но не полного пути | + | в виде имени файла подсхемы (например, ''block.sch''), но не полного пути |
доступа. Указанный файл подсхемы должен находиться в одном из каталогов, | доступа. Указанный файл подсхемы должен находиться в одном из каталогов, | ||
- | перечисленных среди путей доступа к библиотекам источников данных. Можно | + | перечисленных среди путей доступа к [[gEDA:glossary.ru#Библиотека исходных |
- | прикреплять несколько таких атрибутов с различными значениями, что, по | + | данных|библиотекам исходных данных]]. Можно прикреплять несколько таких |
- | существу, означает, что подсхема представляет собой набор из нескольких | + | атрибутов с различными значениями, что, по существу, означает, что подсхема |
- | связанных между собой схем.\\ | + | представляет собой набор из нескольких связанных между собой схем.\\ |
- | //Примеры://\\ ''source=underlying.sch\\ source=memory.sch'' | + | //Примеры://\\ |
+ | ''source=underlying.sch\\ | ||
+ | source=memory.sch'' | ||
===== Атрибуты для символов и схем ===== | ===== Атрибуты для символов и схем ===== | ||
- | ==== refdes ==== | ||
- | Атрибут **refdes**= определяет позиционное обозначение конкретного экземпляра | ||
- | компонента в схеме. Данный атрибут должен быть у КАЖДОГО компонента, | ||
- | имеющего какой-либо электрический смысл. Для установки позиционного | ||
- | обозначения, используемого для компонента по умолчанию (такого как 'U?', | ||
- | например), данный атрибут может задаваться непосредственно в символе (и если он | ||
- | видим, то при помещении символа в схему будет вынесен, то есть прикреплён вне | ||
- | символа).\\ | ||
- | //Примеры://\\ ''refdes=U1\\ refdes=R10\\ refdes=CONN1'' | ||
+ | ==== refdes ==== | ||
+ | Атрибут **refdes**= определяет позиционное обозначение конкретного | ||
+ | экземпляра компонента в схеме. Данный атрибут должен быть у КАЖДОГО | ||
+ | компонента, имеющего какой-либо электрический смысл. Для установки | ||
+ | позиционного обозначения, используемого для компонента по умолчанию (такого | ||
+ | как 'U?', например), данный атрибут может задаваться непосредственно в | ||
+ | символе (и если он видим, то при помещении символа в схему будет вынесен, то | ||
+ | есть прикреплён вне символа).\\ | ||
+ | //Примеры://\\ | ||
+ | ''refdes=U1\\ | ||
+ | refdes=R10\\ | ||
+ | refdes=CONN1'' | ||
=== Ограничения для позиционных обозначений === | === Ограничения для позиционных обозначений === | ||
- | В качестве значения атрибута **refdes**= **gschem** принимает любые строки. Но | + | В качестве значения атрибута **refdes**= **gschem** принимает любые |
- | некоторые драйверы **gnetlist** накладывают ограничения на допустимый синтаксис. | + | строки. Но некоторые драйверы **gnetlist** накладывают ограничения на |
+ | допустимый синтаксис. | ||
В частности [[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 264: | Line 251: | ||
=== Соглашения по позиционным обозначениям === | === Соглашения по позиционным обозначениям === | ||
- | Существует соглашение о применяемых позиционных обозначениях для разных типов | + | Существует соглашение о применяемых позиционных обозначениях для разных типов компонентов. Здесь приведены некоторые из них((Данные соглашения в ряде случаев не соответствуют отечественным стандартам, см. ГОСТ 2.710-81. --- //Прим. перев.//)) (''?'' заменяется числом): |
- | компонентов. Здесь приведены некоторые из них((Данные соглашения в ряде случаев | + | |
- | не соответствуют отечественным стандартам, см. ГОСТ 2.710-81. --- | + | |
- | //Прим. перев.//)) | + | |
- | (''?'' заменяется числом): | + | |
^ Обозначение ^ Тип компонента ^ | ^ Обозначение ^ Тип компонента ^ | ||
| R? |Резистор| | | R? |Резистор| | ||
Line 288: | Line 271: | ||
| U? |ИС (интегральная схема)| | | U? |ИС (интегральная схема)| | ||
| X? |Кварцевый осциллятор| | | X? |Кварцевый осциллятор| | ||
- | |||
==== slot ==== | ==== slot ==== | ||
Атрибут **slot**= используется для выбора конкретного устройства (секции) в | Атрибут **slot**= используется для выбора конкретного устройства (секции) в | ||
- | [[geda:glossary.ru#Многосекционный компонент|многосекционном | + | [[geda:glossary.ru#Многосекционный компонент|многосекционном приборе]]. В |
- | приборе]]. В схеме | + | схеме он должен прикрепляться к экземпляру символа компонента. Для выбора |
- | он должен прикрепляться к экземпляру символа компонента. Для выбора секции | + | секции по умолчанию данный атрибут может задаваться в символе (и если он |
- | по умолчанию данный атрибут может задаваться в символе (и если он видим, то при | + | видим, то при помещении символа в схему будет вынесен, то есть прикреплён |
- | помещении символа в схему будет вынесен, то есть прикреплён вне символа). | + | вне символа). |
==== net ==== | ==== net ==== | ||
Атрибут **net**= используется для создания соединений питания и специальных | Атрибут **net**= используется для создания соединений питания и специальных | ||
- | целей. Подробности см. в | + | целей. Подробности см. в [[gEDA:na_howto.ru|Мини-HOWTO по атрибуту |
- | [[gEDA:na_howto.ru|Мини-HOWTO по атрибуту net=]]. Если данный атрибут | + | net=]]. Если данный атрибут находится в символе, он используется для |
- | находится в символе, он используется для создания соединений. Если же он | + | создания соединений. Если же он прикрепляется к экземпляру компонента в |
- | прикрепляется к экземпляру компонента в схеме, то может использоваться также | + | схеме, то может использоваться также для создания новых соединений и |
- | для создания новых соединений и переопределения уже существующих. | + | переопределения уже существующих. |
==== value ==== | ==== value ==== | ||
Атрибут **value**= в основном используется в драйвере | Атрибут **value**= в основном используется в драйвере | ||
- | [[geda:glossary.ru#Генератор списка соединений|генератора списка соединений]] | + | [[geda:glossary.ru#Генератор списка соединений|генератора списка |
- | для SPICE с целью определения значений различных элементов. Он не | + | соединений]] для SPICE с целью определения значений различных элементов. Он |
- | переводится и помещается в список соединений как есть. \\ | + | не переводится и помещается в список соединений как есть.\\ |
- | //Примеры://\\ ''value=1K\\ value=10V'' | + | //Примеры://\\ |
+ | ''value=1K\\ | ||
+ | value=10V'' | ||
==== symversion ==== | ==== symversion ==== | ||
Атрибут **symversion**= используется для определения версии содержимого | Атрибут **symversion**= используется для определения версии содержимого | ||
- | символа. | + | символа. Так как по умолчанию символы в схему не внедряются, а приводится |
- | Так как по умолчанию символы в схему не внедряются, а приводится лишь ссылка | + | лишь ссылка на них, то в схеме, использующей какой-либо конкретный символ, |
- | на них, то в схеме, использующей какой-либо конкретный символ, при изменении | + | при изменении файла этого символа могут возникнуть проблемы. Например, |
- | файла этого символа могут возникнуть проблемы. Например, изменение | + | изменение расположения выводов в символе приведёт к тому, что линии |
- | расположения выводов в символе приведёт к тому, что линии соединений в схеме | + | соединений в схеме уже не будут подключены к надлежащим выводам. Атрибут |
- | уже не будут подключены к надлежащим выводам. Атрибут **symversion**= | + | **symversion**= позволяет отслеживать такие разрушительные изменения в |
- | позволяет отслеживать такие разрушительные изменения в символах и уведомлять | + | символах и уведомлять пользователя о потенциальных проблемах при загрузке |
- | пользователя о потенциальных проблемах при загрузке схемы. | + | схемы. |
Данный атрибут необязателен, но при наличии в символе он должен принимать | Данный атрибут необязателен, но при наличии в символе он должен принимать | ||
следующую форму:\\ | следующую форму:\\ | ||
**старший_номер.младший_номер**,\\ | **старший_номер.младший_номер**,\\ | ||
+ | |||
где ''старший_номер'' и ''младший_номер'' --- целые числа. Старший номер при | где ''старший_номер'' и ''младший_номер'' --- целые числа. Старший номер при | ||
- | вводе новой версии инкрементируется((Увеличивается на 1. --- //Прим. перев.//)) | + | вводе новой версии инкрементируется((Увеличивается на 1. --- |
- | в случае таких изменений в символе, которые могут привести к порче | + | //Прим. перев.//)) в случае таких изменений в символе, которые могут |
- | существующих схем, использующих предыдущие версии символа. Младший номер | + | привести к порче существующих схем, использующих предыдущие версии |
- | инкрементируется только в случае небольших изменений (изменений, не приводящих | + | символа. Младший номер инкрементируется только в случае небольших изменений |
- | к порче существующих схем, таких как косметические изменения при сохранении | + | (изменений, не приводящих к порче существующих схем, таких как косметические |
- | структуры, то есть положения выводов). | + | изменения при сохранении структуры, то есть положения выводов). |
Если символ, содержащий данный атрибут, помещается в схему, атрибут | Если символ, содержащий данный атрибут, помещается в схему, атрибут | ||
- | **symversion**= автоматически "выносится", то есть для данного экземпляра | + | **symversion**= автоматически «выносится», то есть для данного экземпляра |
- | символа копия атрибута **symversion**=M.N сохраняется непосредственно в файле | + | символа копия атрибута **symversion**=M.N сохраняется непосредственно в |
- | схемы. При загрузке символа с диска значение атрибута **symversion**= в файле | + | файле схемы. При загрузке символа с диска значение атрибута **symversion**= |
- | символа (при его наличии) сравнивается со значением атрибута, прикреплённого к | + | в файле символа (при его наличии) сравнивается со значением атрибута, |
- | экземпляру символа в схеме. | + | прикреплённого к экземпляру символа в схеме. Если эти значения различаются, |
- | Если эти значения различаются, то **libgeda** выдаст предупреждение (при | + | то **libgeda** выдаст предупреждение (при изменении младшего номера версии) |
- | изменении младшего номера версии) или ошибку (при изменении старшего номера | + | или ошибку (при изменении старшего номера версии). |
- | версии). | + | |
Обычно при помещении данного атрибута в файл символа его лучше сделать | Обычно при помещении данного атрибута в файл символа его лучше сделать | ||
- | невидимым. Если при добавлении символа в схему в нём найден этот атрибут, то он | + | невидимым. Если при добавлении символа в схему в нём найден этот атрибут, то |
- | всегда выносится. Не следует прикреплять данный атрибут к имеющимся в схеме | + | он всегда выносится. Не следует прикреплять данный атрибут к имеющимся в |
- | экземплярам символов вручную. | + | схеме экземплярам символов вручную.\\ |
- | + | //Примеры: //\\ | |
- | //Примеры: //\\ ''symversion=1.1\\ symversion=2.0'' | + | ''symversion=1.1\\ |
+ | symversion=2.0'' | ||
==== dist-license ==== | ==== dist-license ==== | ||
+ | |||
Атрибут **dist-license**= используется для указания лицензии, под которой | Атрибут **dist-license**= используется для указания лицензии, под которой | ||
- | распространяется символ или схема. В нём должна задаваться известная лицензия. | + | распространяется символ или схема. В нём должна задаваться известная |
- | Вот несколько примеров его возможных значений: | + | лицензия. Вот несколько примеров его возможных значений: ''GPL'', ''GPL |
- | ''GPL'', ''GPL version 2 only'', ''GPL version 3 only'', ''public domain'', | + | version 2 only'', ''GPL version 3 only'', ''public domain'', ''Apache |
- | ''Apache version 2'', ''Modified BSD'', ''X11'' и т. д.\\ | + | version 2'', ''Modified BSD'', ''X11'' и т. д.\\ |
\\ | \\ | ||
Перечни существующих лицензий можно найти по следующим адресам: | Перечни существующих лицензий можно найти по следующим адресам: | ||
[[http://www.gnu.org/philosophy/license-list.html|Перечень лицензий FSF]] и | [[http://www.gnu.org/philosophy/license-list.html|Перечень лицензий FSF]] и | ||
[[http://www.opensource.org/licenses/category|Перечень лицензий OSI]]. | [[http://www.opensource.org/licenses/category|Перечень лицензий OSI]]. | ||
+ | |||
+ | |||
==== use-license ==== | ==== use-license ==== | ||
- | Атрибут **use-license**= используется для указания лицензии, определяющей, как | ||
- | другие пользователи могут использовать данный символ или данную схему в своих | ||
- | схемах и платах. Вот примеры его значений: ''unlimited'' (неограниченная), | ||
- | ''personal use only'' (только для личного пользования), ''not for sale'' (не | ||
- | для продажи) и т. д.\\ | ||
+ | Атрибут **use-license**= используется для указания лицензии, определяющей, | ||
+ | как другие пользователи могут использовать данный символ или данную схему в | ||
+ | своих схемах и платах. Вот примеры его значений: ''unlimited'' | ||
+ | (неограниченная), ''personal use only'' (только для личного пользования), | ||
+ | ''not for sale'' (не для продажи) и т. д.\\ | ||
+ | \\ | ||
FIXME: добавить сюда набор примеров получше. | FIXME: добавить сюда набор примеров получше. | ||
- | |||
===== Устаревшие атрибуты ===== | ===== Устаревшие атрибуты ===== | ||
==== uref ==== | ==== uref ==== | ||
- | Атрибут **uref=** устарел и использоваться не должен. Он применялся для тех же | + | Атрибут **uref=** устарел и использоваться не должен. Он применялся для тех |
- | целей, что и [[#refdes]]=. | + | же целей, что и [[#refdes]]=. |
==== name ==== | ==== name ==== | ||
Line 387: | Line 371: | ||
схеме. Считается, что такое название атрибута неоднозначно. Данный атрибут | схеме. Считается, что такое название атрибута неоднозначно. Данный атрибут | ||
никогда не использовался в gEDA/gaf. | никогда не использовался в gEDA/gaf. | ||
- | |||
==== label ==== | ==== label ==== | ||
Line 393: | Line 376: | ||
определения названий/меток соединений и меток выводов. Теперь эти функции | определения названий/меток соединений и меток выводов. Теперь эти функции | ||
выполняют соответственно атрибуты [[#netname]]= и [[#pinlabel]]=. | выполняют соответственно атрибуты [[#netname]]= и [[#pinlabel]]=. | ||
- | |||
==== pin# ==== | ==== pin# ==== | ||
Line 400: | Line 382: | ||
компонента. Теперь эти функции выполняют соответственно [[#pinseq]]= и | компонента. Теперь эти функции выполняют соответственно [[#pinseq]]= и | ||
[[#pinnumber]]=. | [[#pinnumber]]=. | ||
- | |||
==== slot# ==== | ==== slot# ==== | ||
Атрибут **slot#**=# устарел и использоваться не должен. Ранее в нём | Атрибут **slot#**=# устарел и использоваться не должен. Ранее в нём | ||
- | предоставлялась информация о секциях компонентов. Теперь | + | предоставлялась информация о [[geda:glossary.ru#Назначение логических |
- | эту функцию выполняет атрибут [[#slotdef]]=. | + | секций|назначении секций]] компонентов. Теперь эту функцию выполняет атрибут |
+ | [[#slotdef]]=. | ||
==== type ==== | ==== type ==== | ||
Атрибут **type**= устарел и использоваться не должен. Он применялся для | Атрибут **type**= устарел и использоваться не должен. Он применялся для | ||
установки типа выводов. Теперь эту функцию выполняет атрибут [[#pintype]]=. | установки типа выводов. Теперь эту функцию выполняет атрибут [[#pintype]]=. | ||
- | |||
==== email ==== | ==== email ==== | ||
Информация из данного атрибута вынесена в атрибут [[#author]]=. | Информация из данного атрибута вынесена в атрибут [[#author]]=. | ||
- | |||
===== История изменений документа ===== | ===== История изменений документа ===== | ||
- | | 14 июля 2002 г. | Создан attributes.tex из attributes.txt. | | + | | 14 июля 2002 г. | Создан attributes.tex из attributes.txt. | |
- | | 14 июля 2002 г. | Документ обновлён для синхронизации с post-20020527. | | + | | 14 июля 2002 г. | Документ обновлён для синхронизации с post-20020527. | |
- | | 25 августа 2002 г. | Добавлен устаревший атрибут type=. | | + | | 25 августа 2002 г. | Добавлен устаревший атрибут type=. | |
- | | 14 сентября 2002 г. | Добавлен атрибут description=. Небольшие исправления | | + | | 14 сентября 2002 г. | Добавлен атрибут description=. Небольшие исправления | |
- | | 7 октября 2002 г. | Добавлен атрибут doc=; Egil Kvaleberg. | | + | | 7 октября 2002 г. | Добавлен атрибут doc=; Egil Kvaleberg. | |
- | | 11 февраля 2003 г. | Добавлена ссылка на соглашения по посадочным местам. | | + | | 11 февраля 2003 г. | Добавлена ссылка на соглашения по посадочным местам. | |
- | | 23 февраля 2003 г. | Добавлены атрибуты author=, email=, и comment=. | | + | | 23 февраля 2003 г. | Добавлены атрибуты author=, email=, и comment=. | |
- | | 6 июля 2004 г. | Добавлен атрибут symversion=. | | + | | 6 июля 2004 г. | Добавлен атрибут symversion=. | |
- | | 10 июля 2007 г. | Добавлены атрибуты dist-license= и use-license=. | | + | | 10 июля 2007 г. | Добавлены атрибуты dist-license= и use-license=. | |