Основой функциональности библиотеки баз данных является файл библиотеки баз данных. Он существует в двух вариантах — в зависимости от того, используете ли вы стандартную библиотеку баз данных или библиотеку баз данных под управлением системы контроля версий:
-
Standard Database Library - файл Database Library. Этот файл создаётся и управляется с помощью редактора DatabaseLib Editor в Altium Designer. Этот редактор становится доступен, когда активным документом в главном окне проектирования является файл *.DbLib.
-
Version-Controlled Database Library - файл SVN Database Library. Этот файл создаётся и управляется с помощью редактора SVNDatabaseLib Editor в Altium Designer. Этот редактор становится доступен, когда активным документом в главном окне проектирования является файл *.SVNDbLib.
Пример файла DbLib, открытого в DatabaseLib Editor. Наведите курсор на изображение, чтобы увидеть пример файла SVNDbLib, открытого в SVNDatabaseLib Editor.
Создайте новый файл этих типов, выбрав команду File » New » Library в главном меню и указав вариант Database Library или SVN Database Library в области Database диалога New Library, который откроется.
Подключение к внешней базе данных
Таблицы и данные сопоставления появятся в основном окне редактора только после того, как активный файл Database Library/SVN Database Library будет успешно подключён к требуемой внешней базе данных. Подключение задаётся с помощью элементов управления в области Source of Connection.
Задание подключения к внешней базе данных через файл DbLib. Наведите курсор на изображение, чтобы увидеть подключение через файл SVNDbLib.
Можно подключить любую базу данных, поддерживающую OLE DB. Параметры, доступные в этой области, используют строку подключения OLE DB для соединения с целевой базой данных. Некоторые базы данных могут не поддерживать OLE DB. Однако практически все используемые сегодня СУБД доступны через интерфейс Open Database Connectivity (ODBC). Функция связи с базой данных использует ODBC-провайдер Microsoft, который позволяет ADO (ActiveX Data Object) подключаться к любому источнику данных ODBC. В результате можно подключить любую ODBC-базу данных. OLE DB-провайдер для ODBC-базы данных указывается как часть строки подключения.
Подключение также можно задать на вкладке Connection диалога Database Connection, открываемого командой Tools » Database Connection из главного меню, либо нажатием кнопки Advanced (справа от кнопки Connect , внизу области).
Options and Controls of the Database Connection Dialog
Вкладка Connection
-
Source of Connection
-
Use Data Link File - строка подключения — это строковое представление сведений о подключении к базе данных; её можно сохранить как отдельный файл с расширением .udl, называемый файлом Microsoft Data Link. Если вы хотите использовать файл data link как источник подключения к базе данных, выберите этот вариант и нажмите Browse , чтобы открыть диалог Select Data Link File, либо используйте выпадающий список для поиска нужного файла .udl.
-
Use Connection String - выберите этот вариант и нажмите Build , чтобы открыть диалог Data Link Properties и заново сформировать строку подключения к базе данных для сопоставления параметров компонентов. Сведения, задаваемые в строке подключения, могут различаться в зависимости от выбранного OLE DB-провайдера.
Вкладка Advanced
-
SQL Options
-
Quote Tables - включите, чтобы использовать специальные символы кавычек для заключения имён таблиц.
-
Left Quote Character - задайте левый символ кавычек. По умолчанию — "[".
-
Right Quote Character - задайте правый символ кавычек. По умолчанию — "]".
Конкретные символы кавычек зависят от используемой базы данных. Например, квадратные скобки ([ ]) допустимы только в базах данных Microsoft, таких как MS Access, тогда как MySQL использует символ "`" для заключения в кавычки.
-
Include Table Schema Names - включите этот параметр, чтобы включать таблицы с именами схем (Table Schema Names). По умолчанию параметр выключен, и используются только таблицы с обычными именами.
В большинстве баз данных таблицы идентифицируются по имени таблицы. В других базах данных, например Oracle, у таблиц также есть префикс, называемый table schema name. Чтобы включать такие таблицы, этот параметр необходимо включить.
-
Field Data Type - задайте тип данных для новых полей. Например, TEXT(N) или VARCHAR(N) можно использовать для баз данных MS Access или MySQL; VARCHAR2(N) можно использовать для баз данных Oracle.
Быстрое подключение к базам данных Access и Excel
Параметр Select Database Type предлагает ускоренный способ создания строки подключения, когда целевая база данных создана в Microsoft Access или Microsoft Excel. Используя этот параметр, выберите тип базы данных, затем перейдите к нужному файлу базы данных и выберите его. Соответствующая строка подключения будет автоматически сформирована и введена в поле параметра Use Connection String.
Можно указать полный путь или выбрать хранение пути относительно файла Database Library/SVN Database Library.
Формирование строки подключения
Если корпоративная база данных не основана на Access или Excel и вы хотите явно сформировать строку подключения, включите параметр Use Connection String, затем нажмите связанную с ним кнопку Build справа. Появится диалог Data Link Properties.
Формирование строки подключения через диалог Data Link Properties.
Диалог открывается на вкладке Connection . OLE DB Provider Microsoft Office <Version> Access Database Engine OLE DB Provider по умолчанию задан на вкладке Provider диалога. Это настройка провайдера по умолчанию для новых файлов Database Library/SVN Database Library, и она также используется для подключения к файлам баз данных Access (*.mdb). При необходимости измените провайдера.
На вкладке Connection введите имя (включая путь) базы данных, к которой вы хотите подключиться.
Если для вашей базы данных требуется вход, укажите необходимые данные, а также любые другие расширенные настройки, доступные на вкладке Advanced диалога. Вкладка All содержит сводный список заданных параметров связи, а также расширенные параметры, относящиеся к выбранному OLE DB Provider. При необходимости параметры можно изменить на этой вкладке.
После задания параметров связи вы можете проверить успешность подключения, нажав кнопку Test Connection (на вкладке Connection ). При успешном подключении появится подтверждающий диалог.
Диалог Data Link Properties является диалогом Microsoft, и поэтому нажатие F1 или использование доступной кнопки Help даст доступ к файлу Microsoft Data Link Help. Этот файл не входит в комплект документации Altium Designer.
Указание файла Data Link
Если источник данных, к которому вы хотите подключиться, описан с помощью файла Microsoft Data Link (*.udl), включите третий вариант подключения — Use Data Link File — и нажмите связанную кнопку Browse , чтобы найти нужный файл. Файл Data Link по сути является контейнером для строки подключения.
Выполнение подключения
После задания подключения к внешней базе данных текст на кнопке Connect станет полужирным, что означает возможность продолжить подключение. Если параметры подключения корректны, сведения о таблицах и сопоставлении для целевой базы данных будут загружены в файл Database Library/SVN Database Library. Текст на кнопке Connect изменится на Connected, а сама кнопка станет неактивной (серой).
Если с параметрами подключения есть проблема (например, строка подключения сформирована неверно или путь введён ошибочно), подключение не выполнится и появится сообщение с предупреждением. Проверьте настройки подключения и снова нажмите кнопку Connect .
Примеры индикации ошибки подключения в библиотеке баз данных.
Если вы измените настройки подключения, оставаясь подключёнными к базе данных, «живое» подключение будет потеряно, и текст на кнопке Connect изменится на Reconnect. Нажмите, чтобы восстановить подключение.
После успешного первоначального подключения и сохранения файла Database Library/SVN Database Library подключение будет выполняться автоматически при каждом открытии файла — при условии, что расположение и имя файла целевой базы данных не изменились.
Указание ссылки на репозиторий системы контроля версий (только SVNDbLib)
В DbLib библиотеки символов и моделей хранятся на вашем жёстком диске или другом локальном/сетевом носителе. Помните, что для SVNDbLib эти библиотеки хранятся под контролем версий в репозитории Subversion. В составе файла SVNDbLib необходимо определить ссылку на этот репозиторий. Подключение к SVN-репозиторию задаётся на вкладке SVN Repository диалога Database Library Options (Tools » Options). Этот диалог также можно открыть, нажав кнопку Options в области Field Settings представления документа.
Пример подключения к файловому SVN-репозиторию.
Список таблиц базы данных
После успешного подключения к внешней базе данных будут загружены данные таблиц и сопоставления. В левой части документа DbLib/SVNDbLib перечислены все таблицы, существующие в подключённой базе данных.
Для базы данных на основе Excel таблица фактически является листом в связанном электронном документе. Имя таблицы будет иметь суффикс $.
Таблицы, существующие в подключённой базе данных.
Параметр Enable рядом с каждой записью таблицы позволяет управлять тем, будет ли эта таблица частью результирующей библиотеки баз данных. Когда библиотека баз данных добавляется в список доступных файловых библиотек (Available File-based Libraries) для просмотра в панели Components, каждая таблица будет отображаться как отдельная библиотечная сущность. Поэтому, хотя фактически добавляется только одна библиотека баз данных, с точки зрения панели Components это выглядит так, будто вы добавили несколько отдельных библиотек. Подробнее см. Searching for Components in File-based & Database Libraries.
Когда вы щелкаете по записи таблицы в списке, ее значок меняется с 
на 
, чтобы обозначить, что это текущая активная таблица. Таблица — со всеми своими данными — отображается на вкладке Table Browser документа. Это редактируемое представление таблицы, которое позволяет быстро просматривать ее содержимое и при необходимости вносить правки, не запуская саму внешнюю базу данных.
Просмотр исходной таблицы в подключенной базе данных.
Чтобы увеличить область Table Browser (как показано на иллюстрации выше), сверните всю область сверху (настройки подключения и полей), щелкнув элемент управления
в правом верхнем углу представления документа. Нажмите
, чтобы развернуть. Таблица также поддерживает привычные функции группировки, сортировки и фильтрации.
Задание критериев сопоставления
После размещения компонента из внешней базы данных должен существовать способ сохранить связь между размещенным компонентом и записью базы данных, информация из которой использовалась для его создания. По сути, эти два объекта нужно сопоставить.
При размещении компонента его параметры создаются «на лету» на основе соответствующих полей записи базы данных. Связь после размещения между компонентом на схеме и записью базы данных устанавливается с помощью одного или нескольких из этих параметров. Область Field Settings документа позволяет определить критерии сопоставления — либо простой поиск по одному ключу, либо более продвинутое сопоставление с использованием условия Where.
Критерии сопоставления задаются отдельно для каждой таблицы.
Управление критериями сопоставления после размещения.
Поиск по одному ключу
Если включена опция Single key lookup (по умолчанию), становятся доступны поля Database field и Part parameter. Первое содержит список всех доступных имен полей (заголовков столбцов) в активной таблице базы данных. Поскольку параметры компонента на схеме добавляются в момент его размещения, поле Part parameter будет отражать выбранное поле базы данных.
Обычно в качестве ключевого поля используют то, что однозначно идентифицирует каждый компонент во внешней базе данных, например Part Number. Выбранное поле поиска выделяется на вкладке Field Mappings документа записью Design Parameter, отображаемой серым цветом.
Сопоставление по одному ключу через Part Number.
При использовании функции Update Parameters From Database на каком-то этапе после размещения информация считывается из выбранного ключевого параметра у размещенных компонентов на схеме и затем ищется в выбранном (ключевом) поле базы данных — по всем включенным таблицам. При совпадении данные из других ячеек этой записи родительской таблицы могут быть возвращены в сопоставленные параметры компонента на схеме.
Расширенное сопоставление — условие Where
Хотя опция Single key lookup хорошо работает, если есть уникальный part number/id для сопоставления, она не столь эффективна при сопоставлении по параметру, который не является уникальным, например по емкости или сопротивлению. В этом случае следует использовать более продвинутое условие Where, позволяющее задать сопоставление по нескольким ключам, чтобы связать компонент на схеме с исходной записью базы данных.
В самом простом виде условие Where (записываемое с использованием синтаксиса SQL) отражает выбранные элементы, определяющие поиск по одному ключу. Например, если Database field было выбрано как Part Number (по умолчанию), то поле Part parameter автоматически также будет установлено в Part Number, а запись для условия Where будет такой:
[Part Number] = '{Part Number}'
Квадратные скобки вокруг поля базы данных (столбца таблицы) являются символами кавычек, как задано на вкладке Advanced диалога Database Connection dialog. Открыть этот диалог можно либо щелкнув кнопку Advanced в области Source of Connection документа, либо из главного меню Tools .
Вкладка Advanced диалога Database Connection предоставляет дополнительные SQL-опции для кавычек
таблиц или использования имен схем таблиц в формируемом условии Where.
При заключении таблиц в кавычки конкретные символы кавычек зависят от используемой базы данных. Например, квадратные скобки [ ] применимы только в базах Microsoft, таких как Access, Excel через ADO или MSSQL (поздние версии). MYSQL использует символ ` (обратная кавычка) для кавычек. В большинстве баз данных заключать в кавычки имена столбцов нужно только если они содержат пробелы или являются зарезервированными словами (для этой базы). Проверьте документацию к вашему ПО базы данных, чтобы узнать, какие символы кавычек используются (если используются).
Фигурные скобки (braces) указывают, что ссылка идет на параметр проекта. Одинарные кавычки используются, чтобы параметр проекта трактовался как строка, а не как число (для числа кавычки не нужны). Сопоставление типов очень важно, поскольку SQL чувствителен к типам. Параметр проекта должен иметь тот же тип, что и столбец в базе данных.
Используя стандартный синтаксис SQL, условие Where затем можно расширить для сопоставления по нескольким записям Database field/Part parameter, например:
[Capacitance] = '{Capacitance}' AND [Tolerance] = {Tolerance} AND [Manufacturer] = '{Manufacturer}'
В этом случае одна запись в соответствующей таблице базы данных будет связана с использованием трех разных параметров проекта. Обратите внимание, что значение для параметра проекта Tolerance не заключено в кавычки. Это означает, что тип столбца в связанной таблице базы данных — Number, а не String.
Используя стандартный синтаксис SQL, вы, в принципе, можете сделать условие Where настолько простым или настолько сложным, насколько захотите.
Сопоставление полей базы данных с параметрами проекта
Параметры проекта для компонента, размещаемого из библиотек базы данных, создаются/добавляются в момент размещения. Какие именно параметры будут созданы, и какие опции используются для обновления их информации после размещения — с помощью команды Tools » Update Parameters From Database — определяется сопоставлением и сведениями об обновлении, заданными в файле Database Library/SVN Database Library. Эти настройки выполняются на вкладке Field Mappings основного представления документа.
Параметры сопоставления и обновления задаются отдельно для каждой таблицы.
Задайте сопоставление параметров и опции обновления на вкладке Field Mappings документа DbLib/SVNDbLib.
Сопоставление моделей и параметров
Первые два столбца (слева) на вкладке Field Mappings используются для управления тем, какая информация из базы данных будет сопоставлена с атрибутами, моделями и параметрами компонента.
-
Database Field Name — этот столбец перечисляет все имена полей (столбцов) в текущей активной таблице базы данных.
-
Design Parameter — этот столбец определяет, как использовать каждое соответствующее поле базы данных. Это может быть источник для модели символа или посадочного места компонента (в этом случае оно будет заключено в квадратные скобки), либо включение в качестве параметра компонента (тогда скобки не используются).
Когда вы открываете документ DbLib/SVNDbLib, подключенный к базе данных, вы заметите, что некоторые Design Parameters содержат квадратные скобки, а другие — нет. Квадратные скобки обозначают зарезервированное имя, например [Library Ref]. Эти данные используются для заполнения атрибутов и моделей компонента. Design Parameters без квадратных скобок становятся параметрами компонента.
Начальное сопоставление выполняется автоматически при подключении к базе данных, при этом сопоставляются все поля базы данных.
Обратите внимание: автоматическое сопоставление предполагает, что имена полей базы данных совпадают с зарезервированными именами, используемыми в Altium Designer. Если это не так, сопоставление необходимо настроить вручную.
Атрибуты и модели
Если имя поля базы данных является одним из следующих зарезервированных имен, соответствующая запись сопоставления атрибута/модели будет автоматически установлена в поле Design Parameter:
-
Description → [Description]
-
Footprint Ref → [Footprint Ref]
-
Footprint Path → [Footprint Path]
-
Footprint Ref n → [Footprint Ref n]
-
Footprint Path n → [Footprint Path n]
В таблице базы данных можно задать неограниченное число ссылок на модели посадочных мест (и пути к ним) и сопоставить их в файле DbLib/SVNDbLib. В зарезервированных именах n представляет собой положительное целое число, начиная с 2.
-
Library Ref → [Library Ref]
-
Library Path → [Library Path]
-
Orcad Footprint → [Orcad Footprint]
-
Orcad Library → [Orcad Library]
Эти ссылки используются при импорте конфигурационного файла OrCAD CIS и библиотек, а также при генерации стандартной библиотеки базы данных (DbLib).
-
PCB3D Ref → [PCB3D Ref]
-
PCB3D Path → [PCB3D Path]
-
Ссылки на PCB3D относятся к устаревшему 3D-просмотрщику; их не следует использовать для новых проектов. Собственный 3D-движок PCB Editor может отображать тела компонентов и импортированные файлы 3D-моделей, связанные с посадочными местами компонентов.
-
Сопоставления моделей PCB3D можно определить в файле SVNDbLib, однако хранение библиотек моделей PCB3D в репозитории Subversion не поддерживается.
-
Sim Description → [Sim Description]
-
Sim Excluded Parts → [Sim Excluded Parts]
-
Sim File → [Sim File]
-
Sim Kind → [Sim Kind]
-
Sim Model Name → [Sim Model Name]
-
Sim Netlist → [Sim Netlist]
-
Sim Parameters → [Sim Parameters]
-
Sim Port Map → [Sim Port Map]
-
Sim Spice Prefix → [Sim Spice Prefix]
-
Sim SubKind → [Sim SubKind]
Для компонента во внешней базе данных можно определить только одну ссылку на модель симуляции. Обычно для компонента всегда будет связана только одна модель симуляции. Если вы хотите настроить несколько ссылок на модели симуляции, остальные ссылки нужно будет определить и хранить вместе с этим компонентом в исходном файле библиотеки схем.
Связанные модели симуляции поддерживаются для библиотеки базы данных под управлением версий (SVNDbLib), однако хранение файлов моделей симуляции в репозитории Subversion не поддерживается.
Эти сопоставления определяют атрибуты и сведения о моделях компонента. При размещении компонента символ схемы, заданный полем [Library Ref] соответствующей записи базы данных, будет извлечен из указанной библиотеки схем. Аналогично, информация о посадочном месте PCB и модели симуляции, сохраненная в записи, будет добавлена к компоненту как связанные модели посадочного места и симуляции соответственно.
Запись [Library Ref] должна существовать в столбце Design Parameter и быть сопоставлена с Database Field Name, который задаёт условное графическое обозначение (schematic symbol), чтобы можно было разместить компонент из Database Library/SVN Database Library на схеме. Если таблица базы данных содержит ссылку на символ в другом Database Field Name, например SCH Symbol, вам потребуется вручную задать связанное значение Design Parameter для этого поля как [Library Ref], используя доступный выпадающий список для этой ячейки.
Аналогично, если сведения о ссылках на модели заносятся в базу данных с использованием других имён полей, вам нужно будет вручную выполнить сопоставление, выбирая соответствующую запись Design Parameter ([Footprint Ref], [Footprint Ref n], [PCB3D Ref], [Sim Model Name] и т. д.) из выпадающего списка — по очереди для каждого поля.
Чтобы при размещении компонента определить информацию о символе и модели, ключевыми сущностями сопоставления являются поля ссылок на символ и модель в базе данных — убедитесь, что в определённом сопоставлении присутствуют символ и как минимум одна ссылка на посадочное место PCB.
Как упоминалось, можно сопоставить несколько PCB‑моделей. Database Field Name, сопоставленный с Design Parameter [Footprint Ref], будет посадочным местом по умолчанию при размещении компонента на схеме. Именно это посадочное место будет размещено при переносе проекта в область PCB.
Сопоставление моделей симуляции
В этом разделе рассматривается каждое из полей базы данных, которые можно добавить во внешнюю таблицу базы данных, чтобы определить ссылку на модель симуляции, которая будет создана при размещении компонента.
-
Sim Model Name – имя модели, которую вы хотите использовать. После размещения компонента эта информация появится в поле Model Name диалога Sim Model .
При сопоставлении полей базы данных с параметрами проекта в файле DBLib поле Sim Model Name аналогично полям Footprint Ref, Library Ref и т. п.
-
Sim Description – описание связанной модели. Это необязательная информация и она не влияет на работу ссылки на модель симуляции.
-
Sim File – конкретный файл модели, в котором следует искать модель симуляции, указанную в поле Sim Model Name. Это поле можно использовать несколькими способами:
-
Можно указать абсолютный путь к файлу модели (например,
C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl). Модель, указанная в поле Sim Model Name, будет искаться внутри этого файла и будет использована, если найдена.
-
Можно указать относительный путь (относительно файла DbLib) к файлу модели (например,
Libraries\JAS33.mdl). Модель, указанная в поле Sim Model Name, будет искаться внутри этого файла и будет использована, если найдена.
-
Можно указать только имя файла модели (например,
JAS33.mdl). Пути поиска, определённые в составе файла DbLib, будут использованы для нахождения первого файла модели, который соответствует указанному имени и содержит совпадение для модели, указанной в поле Sim Model Name.
-
Можно оставить поле пустым. Пути поиска, определённые в составе файла DbLib, будут использованы для нахождения первого файла модели, содержащего совпадение для модели, указанной в поле Sim Model Name.
Пути поиска задаются для файла DbLib на вкладке Symbol & Model Search Paths диалога Database Library Options (Tools » Options).
-
Sim Kind – родительская категория для подключаемой модели.
-
Sim SubKind – тип подключаемой модели.
-
Sim Netlist – информация о шаблоне нетлиста (netlist template) в соответствии с типом подключаемой модели. Это поле становится особенно важным, если вы задаёте собственный шаблон нетлиста и установили поле Sim SubKind в Generic Editor, что даёт больше контроля над тем, какая информация попадает в нетлист.
Это поле должно быть определено и не должно оставаться пустым, иначе запись для модели не будет добавлена в симуляционный нетлист, и компонент не будет симулироваться при размещении из библиотеки базы данных.
Netlist Template Syntax
При определении Netlist Template вводимая информация должна соответствовать требованиям SPICE и правилам синтаксиса, описанным ниже.
Символы, введённые в шаблон, записываются в SPICE‑нетлист дословно, за исключением следующих специальных символов:
| % |
знак процента |
| @ |
знак «коммерческое at» |
| & |
амперсанд |
| ? |
вопросительный знак |
| ~ |
тильда |
| # |
знак решётки |
Эти символы преобразуются при создании нетлиста, как показано в следующей таблице:
| Синтаксис в Netlist Template... |
Netlister заменяет на... |
| @<param> |
Значение <param>. Выдаётся ошибка, если параметр с таким именем не существует или если ему не назначено значение. |
| &<param> |
Значение <param>. Ошибка не выдаётся, если параметр не определён. |
| ?<param>s...s |
Текст между разделителями s...s, если <param> определён. |
| ?<param>s...ss...s |
Текст между первыми разделителями s...s, если <param> определён, иначе — между вторыми разделителями s...s. |
| ~<param>s...s |
Текст между разделителями s...s, если <param> НЕ определён. |
| ~<param>s...ss...s |
Текст между первыми разделителями s...s, если <param> НЕ определён, иначе — между вторыми разделителями s...s. |
| #<param>s...s |
Текст между разделителями s...s, если <param> определён, но игнорировать остальную часть шаблона, если <param> НЕ определён. |
| #s...s |
Текст между разделителями s...s, если есть какой‑либо текст, который нужно добавить в XSpice‑нетлист из последующих записей в Netlist Template. |
| %<pin id> |
Имя сети (net name) сети, к которой подключается вывод схемы, сопоставленный с <pin id>. |
| %% |
Буквальный символ процента. |
В таблице выше:
-
s обозначает символ‑разделитель (, . ; / |).
-
<param> означает имя параметра.
Если имя параметра содержит какие‑либо неалфавитно‑цифровые символы, его следует заключить в двойные кавычки. Например:
@"DC Magnitude" - двойные кавычки используются здесь, потому что имя содержит пробел.
&"Init_Cond" - двойные кавычки используются здесь, потому что имя содержит символ подчёркивания.
Двойные кавычки также следует использовать, когда вы хотите добавить буквенно‑цифровой префикс к имени параметра. Например:
@"DESIGNATOR"A - использование двойных кавычек гарантирует, что A будет добавлена к позиционному обозначению компонента.
Ниже приведены примеры записей синтаксиса специальных символов из предыдущей таблицы. В каждом случае указано, как запись синтаксиса преобразуется Netlister’ом.
@"AC Phase"
Имя параметра AC Phase заключено в фигурные скобки из‑за пробела. В нетлисте это будет заменено значением параметра AC Phase. Если параметра с таким именем нет или его значение пустое, будет выдана ошибка.
&Area
Если параметр с именем Area существует и имеет значение, то его значение будет внесено в нетлист. Если параметр не определён (т. е. либо не существует, либо ему не назначено значение), то в нетлист ничего не будет записано, но ошибка не будет выдана. Это можно использовать для необязательных параметров.
?IC|IC=@IC|
Если параметр с именем IC определён, то текст внутри разделителей || будет вставлен в нетлист. Например, если параметр IC имеет значение 0.5, то IC=0.5 будет вставлено в нетлист вместо этой записи. Если параметр не определён, то в нетлист ничего не будет вставлено.
?IC/IC=@IC//IC=0/
То же самое, что и в предыдущем примере, за исключением того, что если параметр IC не определён, то в нетлист будет вставлено IC=0. Обратите внимание, что использован другой символ‑разделитель.
~VALUE/1k/
Если параметр с именем VALUE НЕ определён, то в нетлист будет вставлен текст 1k.
~VALUE/1k//@VALUE/
То же самое, что и в предыдущем примере, за исключением того, что если параметр VALUE определён, то в нетлист будет вставлено его текстовое значение.
#"AC Magnitude"|AC@"AC Magnitude"|@"AC Phase"
Этот пример можно увидеть в предопределённом шаблоне нетлиста для синусоидального источника напряжения.
Если параметр AC Magnitude определён, то содержимое между разделителями вычисляется и вставляется в нетлист. Все последующие записи в нетлисте также вычисляются и добавляются в нетлист (в данном случае @"AC Phase").
Если, например, AC Magnitude=1 и AC Phase=0, то в нетлист будет вставлено AC 1 0. Если же AC Phase не определён, будет выдана ошибка.
Если параметр AC Magnitude не определён, то ничего, что следует за записью #"AC Magnitude" в шаблоне нетлиста, не будет внесено в нетлист.
#|PARAMS:|?Resistance|Resistance=Resistance|?Current|Current=@Current|
Этот пример можно увидеть в предопределённом шаблоне нетлиста для параметризованной подсхемы (см. F1 в Fuse.PrjPcb).
Если параметры Resistance и Current оба не определены, то после записи #|PARAMS:| в нетлисте не будет вставлено никакого текста, поэтому текст в разделителях также будет опущен.
Если, например, параметры имеют значения Resistance=1k и Current=5mA, то это приведёт к появлению текста после записи #|PARAMS:|, и в нетлисте будет создана запись PARAMS: Resistance=1k Current=5mA.
@DESIGNATOR%1%2@VALUE
Этот пример предназначен для демонстрации использования символа %.
Если, например, параметры имеют значения DESIGNATOR=R1 и VALUE=1k, а выводы сопоставлены в области Pin Mapping диалога Sim Model согласно следующей таблице:
| Вывод схемы |
Вывод модели |
Имя цепи, к которой подключается вывод схемы |
| 1 (N+) |
1 (1) |
GND |
| 2 (N-) |
2 (2) |
OUT |
Тогда текст R1 GND OUT 1k будет помещён в SPICE-нетлист для этого компонента.
-
Sim Spice Prefix – SPICE-префикс для типа модели, на которую вы выполняете ссылку.
-
Sim Port Map – сопоставление выводов компонента на схеме с выводами связанной модели. После размещения компонента эта информация появится в области Pin Mapping диалога Sim Model.
Каждая пара выводов должна быть введена в следующем формате:
(SchematicPinNumber:ModelPinNumber),
при этом каждая сопоставленная пара отделяется запятой.
Например, при сопоставлении модели диода для симуляции, где вывод схемы 1 (анод) должен быть сопоставлен с выводом модели 1 (анод), а вывод схемы 3 (катод) должен быть сопоставлен с выводом модели 2 (катод), это будет введено в поле базы данных как:
(1:1),(3:2)
-
Sim Excluded Parts – создайте это поле в базе данных, если вы хотите исключить определённые части многосекционного компонента из симуляции. Эта информация соответствует опции Exclude part from simulation в области Pin Mapping диалога Sim Model.
По умолчанию в симуляцию включаются все части многосекционного компонента, поэтому вам нужно указать только те части, которые вы хотите исключить, по номеру. Разделяйте несколько частей в списке исключения запятыми. Например, если компонент имеет четыре части и вы не хотите, чтобы части 2 и 4 включались в какую-либо симуляцию, то в поле базы данных следует ввести:
2,4
-
Sim Parameters – создайте это поле в базе данных, если вы хотите назначить значения параметрам симуляции для модели. Это параметры, которые можно задавать на уровне компонента, в отличие от более продвинутых параметров, которые могут быть включены в файл модели.
Параметр должен быть введён в следующем формате:
ParameterName=Value,
Несколько параметров должны разделяться символом вертикальной черты (|).
Вы можете помнить, что параметр симуляции уровня компонента также можно задать как параметр компонента — он будет отображаться в области Parameters соответствующего диалога Component Properties, с возможностью затем выводить его на лист схемы. По умолчанию запись параметра в поле Sim Parameters будет автоматически добавлена как параметр компонента. Если вы не хотите, чтобы параметр симуляции добавлялся как параметр компонента, просто добавьте к имени параметра префикс в виде восклицательного знака (например, !Initial Voltage=100mV).
Рассмотрим модель диода, у которой есть следующие четыре параметра уровня компонента:
-
Коэффициент площади
-
Начальное условие
-
Начальное напряжение
-
Температура.
Теперь рассмотрим добавление значений в базе данных для коэффициента площади (скажем, 2) и температуры (скажем, 22°C). Также оба этих параметра не должны добавляться как параметры компонента. Запись в поле Sim Parameters будет следующей:
!Area Factor=2|!Temperature=22
После того как вы разместили компонент из библиотеке базы данных, вы можете проверить, что информация, определённая для связи симуляции, действительно соответствует требованиям. Когда размещённый компонент выбран в рабочей области, выберите запись модели симуляции в области Parameters панели Properties, нажмите кнопку 
для доступа к диалогу Sim Model, где вы сможете проверить, что:
-
Файл модели найден, как и ожидалось. Когда он найден, вкладка Model File диалога отобразит содержимое файла.
-
Оставшаяся информация по симуляции из базы данных добавлена в диалог, как и ожидалось.
Значения, сохранённые в полях базы данных, будут использоваться для компонента, размещённого из библиотеке базы данных, при запуске симуляции. Однако обратите внимание: если вы откроете диалог Sim Model для модели симуляции компонента, размещённого из библиотеке базы данных, и нажмёте OK, то поля Sim Netlist и Sim Spice Prefix будут автоматически установлены для этого компонента на основе выбранного текста модели.
Параметры
Все остальные имена полей базы данных будут автоматически сопоставлены с параметрами проекта, используя те же имена. Например, если поле в базе данных называется Tolerance, то с ним будет сопоставлен параметр проекта с именем Tolerance. Вы можете изменить имя параметра проекта, щёлкнув в его ячейке и введя новое имя напрямую. Именно эти имена параметров проекта будут отображаться в области Parameters диалога свойств, связанного с компонентом, после его размещения на листе схемы.
У компонента в базе данных может быть большое количество полей данных, и не все из них вы захотите (или даже будете нуждаться) добавлять как параметры проекта к компоненту при размещении на листе схемы. Значительная часть этой информации может требоваться только при формировании ведомости материалов (BOM). Диалог Report Manager позволяет добавлять параметрическую информацию в BOM напрямую из связанной базы данных — это позволяет уменьшить объём информации, которая «переносится» вместе с исходными документами схемы. Дополнительные сведения см. в разделе Preparing a BOM in the Report Manager.
Для полей, которые вы явно не хотите сопоставлять из базы данных, установите значение Design Parameter в [None]. Несопоставленные поля базы данных на вкладке отличаются значком красного крестика (
). Сопоставленные поля базы данных отличаются значком зелёной галочки (
).
Настройте сопоставление параметров по необходимости. Установите [None], чтобы предотвратить сопоставление параметра из базы данных с размещённым компонентом.
Несопоставленные параметры при необходимости могут быть включены непосредственно в BOM.
Чтобы быстро повторно сопоставить несопоставленное поле, щёлкните внутри строки этого поля и используйте сочетание клавиш Ctrl+D. Обратите внимание: для сопоставлений моделей вам потребуется вручную выбрать значение из соответствующего выпадающего списка Design Parameter.
Параметры обновления параметров
Оставшиеся столбцы на вкладке Field Mappings позволяют указать действия, выполняемые с параметрами при первом размещении компонента из библиотеке базы данных или при обновлении компонента после его размещения с помощью команды Tools » Update Parameters From Database.
Четыре столбца следующие:
-
Update Values - ячейка в этом столбце используется для определения действия, которое следует выполнить, если параметр существует и на листе схемы, и в базе данных, но значения в данный момент различаются. Выберите: обновить параметр размещённого компонента значением, сохранённым в базе данных (Update), или не обновлять вовсе (Do not update). Эта опция учитывается при использовании команды Update Parameters From Database после размещения компонента.
-
Add To Design - ячейка в этом столбце используется для определения действия, которое следует выполнить, если параметр найден в базе данных, но отсутствует у размещённого компонента. Вы можете выбрать: добавить параметр (Add), не добавлять параметр (Do not add) или добавлять параметр только если ему назначено значение в базе данных (Add only if not blank in database). Эта опция учитывается как при первоначальном размещении компонента из библиотеке базы данных, так и при использовании команды Update Parameters From Database после размещения компонента.
-
Visible On Add - флажок в этом столбце используется для определения, будет ли вновь добавленный параметр, появившийся в результате первоначального размещения или обновления после размещения, видимым для компонента на листе схемы (включено) или нет (выключено).
-
Remove From Design - ячейка в этом столбце используется для определения действия, которое следует выполнить, если параметр обнаружен у размещённого компонента, но либо отсутствует в базе данных, либо присутствует, но не имеет значения. Вы можете выбрать: не удалять параметр вовсе (Do not remove) или удалять его только если ему не назначено значение в базе данных (Remove only if blank in database). Эта опция учитывается при использовании команды Update Parameters From Database после размещения компонента.
Изначально поля Update Values, Add To Design и Remove From Design — для каждого сопоставленного поля базы данных — будут установлены в значение Default, а опция Visible On Add будет отключена, как показано на следующем изображении.
Начальные (по умолчанию) параметры обновления параметров.
Судя по изображению, можно выделить четыре важных момента относительно параметров обновления:
-
Несопоставленные поля базы данных не будут иметь связанных параметров обновления.
-
Сопоставления на основе атрибутов и моделей (записи с квадратными скобками в столбце Design Parameter) не будут иметь связанных параметров обновления, поскольку это не параметры проекта.
-
Ключевое поле (например, Part Number на изображении) не будет иметь связанных параметров обновления. Это поле используется исключительно для целей сопоставления параметров.
-
Значение Default приводит к тому, что параметр обновления следует соответствующему определению по умолчанию, заданному на вкладке Default Actions диалогового окна Database Library Options (Tools » Options из главного меню или Options из контекстного меню (по правому щелчку) вкладки Table Browser ). К этому диалоговому окну также можно перейти, нажав кнопку Options в области Field Settings окна просмотра документа.
Задайте параметры обновления по умолчанию в одном центральном месте для DbLib. Наведите курсор на изображение, чтобы увидеть эквивалент для SVNDbLib.
Четвёртый пункт полезен тем, что позволяет задавать параметры обновления из центрального места, а затем ссылаться на это место при определении параметров обновления для каждого сопоставленного поля. Именно поэтому запись Default автоматически подставляется в соответствующие поля обновления при сопоставлении поля базы данных с параметром проекта.
Если вы хотите переопределить значение по умолчанию для параметра обновления, щёлкните внутри соответствующего поля обновления на вкладке Field Mappings, затем щёлкните ещё раз, чтобы открыть раскрывающийся список с доступными вариантами обновления.
Параметры обновления можно при необходимости переопределять вручную.
Таким образом, вы получаете полный контроль над тем, как обновляются параметры в проекте. Вы можете установить для всех полей значение Default и принимать необходимые решения об обновлении в диалоговом окне Database Library Options, задавать каждое поле обновления индивидуально или использовать сочетание обоих подходов — решение полностью за вами. Для размещённых компонентов обновление (при выполнении) осуществляется с использованием диалогового окна Engineering Change Order. Если на этом этапе есть обновления, которые вы предпочли бы не выполнять, вы можете исключить эти конкретные изменения — получая финальное и решающее слово в том, какие параметры проекта будут обновлены.
Указание расположений библиотек символов и моделей
Когда вы размещаете компонент из библиотек базы данных, его символ — заданный сопоставлением [Library Ref] — извлекается из указанной библиотеки схем (*.SchLib). Аналогично, любые ссылки на модели (посадочное место, PCB3D, симуляция), заданные в базе данных, будут находиться в соответствующих файлах PCB Library (*.PcbLib), PCB3D Library (*.PCB3DLib) и Simulation Model (*.mdl, *.ckt). Пути к этим файлам можно явно указать в базе данных следующим образом:
-
Ввести абсолютный путь к файлу.
-
Ввести относительный путь к файлу.
Если в вашей базе данных определены поля для информации о путях, эти поля нужно сопоставить с соответствующими параметрами проекта — [Library Path], [Footprint Path], [PCB3D Path], [Sim File] и т. д. (см. Model and Parameter Mapping).
Ввод путей — даже относительных — в таблицу базы данных может быть несколько ограничивающим. Если вы переместите библиотеку или файл модели, вам придётся соответствующим образом обновить таблицу базы данных. Чтобы дать вам больше свободы, предусмотрена возможность задавать информацию для поиска библиотек непосредственно в файле DbLib/SVNDbLib. Это позволяет указывать в базе данных только имя исходной библиотеки или файла модели — либо не задавать его вовсе.
Using Search Paths with a large number of symbol/model files — хотя пути поиска обеспечивают большую гибкость и простоту настройки того, как находятся символы и модели, этот подход не рекомендуется, когда в месте поиска присутствует большое количество файлов символов или моделей. В зависимости от используемой схемы именования файлов Search Paths могут требовать, чтобы каждый файл библиотеки/модели, находящийся по этому пути, просматривался каждый раз, когда требуется символ/модель — например, при просмотре компонентов или при переносе проекта со схемы на плату.
Для Database Library
Для DbLib пути поиска библиотек задаются на вкладке Symbol and Model Search Paths диалогового окна Database Library Options (Tools » Options). К этому диалоговому окну также можно перейти, нажав кнопку Options в области Field Settings окна просмотра документа.
Задание путей поиска для библиотек символов и моделей.
Чтобы добавить путь в список:
-
Либо введите путь напрямую в поле под областью Library Search Paths, либо нажмите кнопку
, чтобы открыть диалоговое окно Browse for Folder, где можно выбрать каталог, в котором находятся нужные файлы библиотек/моделей.
-
Можно добавить путь как полный, так и относительный (относительно расположения файла DbLib). Это настраивается параметром Add/Update As Relative Path.
-
После указания нужного пути добавьте его в список путей поиска, нажав кнопку Add .
-
Продолжайте добавлять дополнительные пути поиска по мере необходимости.
При прямом вводе, если вы укажете неверный путь (например, к несуществующей папке), запись всё равно можно добавить, но в списке она будет отображаться серым цветом, что указывает на недействительный путь поиска. Если вы обнаружили, что ввели путь ошибочно, можно выбрать его в списке и либо нажать кнопку Remove , либо изменить определение пути и нажать кнопку Update .
Пути поиска библиотек определяют, где могут быть найдены файлы библиотек и моделей при размещении из библиотеки базы данных и при поиске модели после размещения. Конкретная используемая модель будет зависеть от того, как настроены пути поиска, и добавляли ли вы конкретную информацию о библиотеке в базу данных. Поиск выполняется в следующем порядке:
-
Если в сопоставленном поле пути для символа или модели указан полный путь, используется этот файл библиотеки/модели и извлекается символ или модель, заданные в соответствующем поле ссылки.
-
Если в сопоставленном поле пути для символа или модели указан относительный путь, используется этот файл библиотеки/модели и извлекается символ или модель, заданные в соответствующем поле ссылки.
-
Если в сопоставленном поле пути для символа или модели указано только имя файла библиотеки/модели, используются пути поиска, чтобы найти первый файл библиотеки/модели, совпадающий с указанным именем и содержащий совпадение для символа или модели, заданных в соответствующем поле ссылки.
-
Если в базе данных отсутствует информация о файле библиотеки/модели, используются пути поиска, чтобы найти первый файл библиотеки/модели, содержащий совпадение для символа или модели, заданных в соответствующем поле ссылки.
Для SVN Database Library
Для SVNDbLib базовые каталоги в репозитории Subversion, в которых находятся символы и модели посадочных мест, задаются на вкладке SVN Repository диалогового окна Database Library Options (Tools » Options). К этому диалоговому окну также можно перейти, нажав кнопку Options в области Field Settings окна просмотра документа.
Задание базовых каталогов репозитория для символов и посадочных мест.
Используйте доступные поля в области Models Location, чтобы указать базовый каталог для символов и посадочных мест. Нажмите кнопку 
справа от поля, чтобы открыть диалоговое окно Browse for directory — окно в связанный репозиторий. В этом диалоговом окне выберите нужную папку.
Выбор соответствующего каталога в связанном SVN-репозитории.
Важно подчеркнуть, что символы и посадочные места должны находиться внутри указанных базовых каталогов репозитория. Разумеется, они могут располагаться в подпапках этих каталогов, и пути, заданные для символов и посадочных мест, могут указывать на один и тот же каталог в репозитории.
Расположения моделей определяют, где могут быть найдены файлы библиотек и моделей при размещении из библиотеки базы данных с контролем версий и при поиске модели после размещения. Конкретный используемый символ схемы и модель(и) посадочного места будут зависеть от того, как настроены эти расположения, и добавляли ли вы конкретную информацию о библиотеке в базу данных. Поиск выполняется в следующем порядке:
-
Если в сопоставленном поле пути для символа или модели посадочного места указан полный путь (например, http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), используется этот файл библиотеки и извлекается символ или посадочное место, заданные в соответствующем поле ссылки.
-
Если в сопоставленном поле пути для символа или модели посадочного места указан относительный путь (относительно корня репозитория) (например, /ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), используется этот файл библиотеки и извлекается символ или посадочное место, заданные в соответствующем поле ссылки. URL репозитория, заданный в области Repository Server Connection диалогового окна, будет добавлен в начало введённого пути, чтобы получить абсолютный адрес.
-
Если в сопоставленном поле пути для символа или модели посадочного места указано только имя файла библиотеки (например, Capacitor_NonPolarized.SchLib), используются заданные расположения моделей в репозитории, чтобы найти первый файл библиотеки, совпадающий с указанным именем и содержащий совпадение для символа или модели посадочного места, заданных в соответствующем поле ссылки.
При поиске совпадения символа/модели «сплющенные» пути папок в базовом каталоге символов или посадочных мест сортируются и просматриваются в алфавитном порядке. Если используется
Library Splitter Wizard, всегда будет соответствующая библиотека с именем фактического символа/посадочного места.
-
Если в базе данных отсутствует информация о файле библиотеки, используются заданные расположения моделей, чтобы найти первый файл библиотеки, содержащий совпадение для символа или модели посадочного места, заданных в соответствующем поле ссылки.
При поиске символа/посадочного места система сначала попытается найти первую библиотеку, названную так же, как сам символ или посадочное место. Например, если логическое имя символа в базе данных (заданное сопоставлением [Library Ref]) — Capacitor_NonPolarized, система будет искать первый файл с именем Capacitor_NonPolarized.SchLib и искать символ внутри этого файла. Если символ/посадочное место таким образом найти не удаётся, система будет искать совпадение во всех библиотеках.
Локализовано с помощью ИИ