Integrated Libraries

Интегрированные библиотеки отражают модель Integrated Component в Altium Designer. В этой модели компонент более высокого уровня описывается в рамках условного графического обозначения (УГО) в файле библиотеки схем (*.SchLib). Остальные модели связываются с символом, а параметры компонента добавляются к символу. Все исходные библиотеки — символ и связанные модели — определяются в проекте Integrated Library Package, который затем компилируется в один файл — Integrated Library или IntLib.

В этом документе рассматриваются различные способы создания интегрированной библиотеки, а также размещение компонентов из такой библиотеки и внесение в неё изменений.

Преимущества интегрированных библиотек

Ключевые преимущества компиляции в интегрированную библиотеку:

• Вся информация о компонентах доступна в одном переносимом файле. Поскольку все модели упакованы в интегрированную библиотеку, проекту требуется только один файл, который нужно иметь под рукой или переносить при перемещении проекта. Такая переносимость бесценна, если вы распределяете работу между разными рабочими станциями или хотите делиться своими разработками с другими.
• Если компонент размещается на схеме проекта из интегрированной библиотеки, Altium Designer гарантированно найдёт правильную модель, если сможет просто обнаружить интегрированную библиотеку, из которой этот компонент был взят (т. е. не нужно «жонглировать» раздельными файлами библиотек и моделей, где ссылки на модели могут быть очень «хрупкими» и легко ломаются при повседневных задачах управления, таких как переименование папок на жёстком диске).
• С точки зрения безопасности интегрированные библиотеки надёжны. После генерации их нельзя изменить. Фактически обновление интегрированной библиотеки означает её полную замену. Вам нужно целенаправленно открыть исходный пакет библиотек, обновить исходные документы, а затем перекомпилировать.
• Эти библиотеки также проверяются на целостность при компиляции. Это означает, что проверяется не только доступность, но и корректность сопоставления выводов. Даже если вы хотите остаться на раздельных файлах библиотек, рекомендуется компилировать ваши библиотеки схем в пакете интегрированной библиотеки хотя бы для того, чтобы убедиться, что исходные компоненты корректно сопоставятся с целевыми моделями. Убедившись в этом, вы можете игнорировать созданную интегрированную библиотеку и продолжать размещать компоненты напрямую из библиотек схем.

Создание IntLib с помощью пакета библиотек

Пакет интегрированной библиотеки (*.LibPkg) — это тип проекта Altium Designer, используемый для объединения набора проектных документов, необходимых для создания интегрированной библиотеки. УГО рисуются в редакторе библиотек схем, и для каждого задаются ссылки/привязки к моделям, а также любая параметрическая информация. Всё это хранится в одном или нескольких файлах библиотек схем. Ссылочные модели могут включать посадочные места PCB, модели схемотехнического моделирования и модели целостности сигналов.

Единственный документ, который обязательно нужно добавить в пакет интегрированной библиотеки, — это библиотека схем (или библиотеки). Файлы, содержащие 2D/3D-модели компонентов для PCB и модели/подсхемы для симуляции, могут находиться в любом допустимом месте поиска в рамках проекта, в файлах из списка Installed Libraries или по путям поиска, заданным для пакета.

Затем пакет библиотек компилируется в единый файл интегрированной библиотеки (*.IntLib).

В итоге создание интегрированной библиотеки по сути состоит из четырёх шагов:

1. Создать исходный пакет библиотек.

2. Создать и добавить требуемые исходные файлы библиотек схем.

3. Создать и добавить (или указать) требуемые файлы доменных моделей.

4. Скомпилировать пакет библиотек, чтобы получить файл интегрированной библиотеки.

Создание исходного пакета библиотек

Создайте новый пакет интегрированной библиотеки, выбрав команду File » New » Library в главном меню, затем выбрав опцию Integrated Library в области File диалогового окна New Library, которое откроется. После нажатия Create новый «пустой» проект пакета библиотек будет добавлен в панель Projects и изначально не будет содержать никаких документов.

Создание и добавление исходной библиотеки схем

Создайте исходную библиотеку схем (*.SchLib), содержащую требуемые компоненты. Для каждого компонента добавьте необходимые ссылки на модели и параметрическую информацию. Есть два способа создать исходную библиотеку схем:

• С нуля — используя команду File » New » Library в главном меню и выбрав опцию Schematic Library в области File диалогового окна New Library. Создавайте новые компоненты в редакторе УГО или копируйте компоненты из других открытых библиотек схем.
• Щёлкнув правой кнопкой по записи пакета библиотек в панели Projects и затем выбрав команду Add New to Project » Schematic Library в контекстном меню.
• Из компонентов, которые уже размещены на схемных документах проекта, используя команду Design » Make Schematic Library.

Когда исходная библиотека (или библиотеки) схем подготовлена, добавьте её в пакет библиотек одним из следующих способов:

• Используя команду Project » Add Existing to Project.
• Щёлкнув правой кнопкой по записи пакета библиотек в панели Projects и затем выбрав команду Add Existing to Project в контекстном меню.

Исходная SchLib добавлена в пакет библиотек.

Создание и добавление файлов доменных моделей

Создайте модели, на которые ссылаются компоненты схем, в соответствующих файлах: 2D/3D-модели компонентов PCB — в библиотеке PCB (*.PcbLib), модели симуляции и подсхемы — в файлах Model (*.Mdl) и Subcircuit (*.Ckt). Самой важной моделью, разумеется, будет 2D/3D-модель компонента для PCB, которую, как и её аналог в библиотеке схем, можно создать двумя способами:

• Используя команду File » New » Library в главном меню и выбрав опцию PCB Library в области File диалогового окна New Library. Создавайте новые 2D-посадочные места (и добавляйте информацию о 3D-теле) в редакторе посадочных мест PCB или копируйте компоненты из других открытых библиотек PCB.
• Щёлкнув правой кнопкой по записи пакета библиотек в панели Projects и затем выбрав команду Add New to Project » PCB Library в контекстном меню.
• Из 2D/3D-моделей компонентов PCB, которые уже размещены на документе PCB, используя команду Design » Make PCB Library.

Указание, где искать модели

После определения файлов моделей их нужно сделать доступными для пакета библиотек, чтобы их можно было легко находить при необходимости — помните, модели задаются ссылками (привязываются) в компонентах схем. В Altium Designer есть стандартная система предоставления доступа к моделям, независимо от того, создаёте ли вы пакет интегрированной библиотеки или работаете над схемой. Есть три способа сделать модели доступными:

• Добавить библиотеку/модель в проект.
• Установить библиотеку/модель в список Installed Library. В этом случае она будет доступна всем проектам.
• Задать путь поиска к библиотеке/модели.

У каждого способа есть свои преимущества, поэтому выбирайте тот, который лучше соответствует вашим рабочим практикам. Разные типы моделей также лучше сочетаются с разными подходами. Например, вы можете не хотеть видеть большое количество моделей симуляции в панели Projects при открытии пакета библиотек, но при этом вам может быть удобно видеть библиотеки 2D/3D-моделей компонентов PCB. В таком случае задайте путь поиска к папке, где хранятся модели симуляции, а библиотеку PCB добавьте в пакет интегрированной библиотеки.

В совокупности эти три способа доступности моделей формируют Libraries Preferences (доступно проекту) и все они могут быть определены в диалоговом окне Libraries Preferences, которое открывается нажатием в правом верхнем углу панели Components и последующим выбором команды Libraries Preferences.

Задайте доступность моделей в диалоговом окне Libraries Preferences .

Библиотеку PCB (и другие файлы моделей при необходимости) также можно добавить в пакет библиотек напрямую с помощью команды Add Existing to Project, доступной из главного меню Project или из меню правой кнопки мыши, связанного с записью пакета библиотек в панели Projects.

Исходная PcbLib добавлена в пакет библиотек.

Задание путей поиска к файлам моделей на вкладке Search Path диалогового окна Libraries Preferences открывает вкладку Search Paths диалогового окна Options for Integrated Library (Project » Project Options). Добавьте один или несколько путей по мере необходимости, помня, что поиск моделей по этим путям выполняется в порядке сверху вниз. Нажмите кнопку Refresh List, чтобы убедиться, что требуемые файлы моделей действительно находятся, и при необходимости скорректируйте путь.

Пример заданного пути поиска, по которому будет найден требуемый файл модели PcbLib.

Компиляция и проверка пакета библиотек

После добавления исходных библиотек в пакет библиотек и задания (при необходимости) путей к файлам моделей пакет можно скомпилировать, чтобы в итоге сформировать интегрированную библиотеку. Как и в любом другом проекте, компилятор пакета интегрированной библиотеки сформирует список предупреждений и/или ошибок, например предупреждение о моделях, которые не были найдены. Кроме того, можно проверить ошибки сопоставления выводов, например когда инструкции сопоставления указывают на площадки 1 и 2, а фактический футпринт содержит площадки A и K.

Перед запуском компиляции разумно просмотреть и соответствующим образом настроить условия выдачи сообщений об ошибках на вкладке Error Reporting tab диалогового окна Options for Integrated Library.

Рекомендуется заранее, до компиляции пакета библиотек, настроить параметры отчётности об ошибках и уровни серьёзности так, как требуется.

Чтобы выполнить компиляцию, используйте команду Compile Integrated Library либо из главного меню Project, либо из контекстного меню, связанного с записью пакета библиотек в панели Projects panel. Исходные библиотеки и файлы моделей компилируются в интегрированную библиотеку с именем, соответствующим исходному пакету библиотек (<LibraryPackageName>.IntLib). Компилятор проверит нарушения, а найденные ошибки или предупреждения будут перечислены в панели Messages. Исправьте проблемы в исходных библиотеках и затем выполните компиляцию повторно.

Примеры ошибок, отмеченных компилятором при компиляции пакета интегрированной библиотеки.

Интегрированная библиотека сохраняется в выходной папке, указанной на вкладке Options tab диалогового окна Options for Integrated Library (по умолчанию это подпапка в расположении проекта: \Project Outputs for <ProjectName>). Если параметр Open outputs after compile включён на вкладке Options диалогового окна Options for Integrated Library, интегрированная библиотека автоматически добавляется на вкладку Installed диалогового окна Libraries Preferences  и на страницу Data Management – File-based Libraries page диалогового окна Preferences.

Скомпилированная интегрированная библиотека добавляется на вкладку Installed диалогового окна Libraries Preferences .

Создание IntLib из документов проекта

Интегрированную библиотеку также можно создать напрямую из составляющих документов проекта (исходных документов схем и документа PCB). Это полезно, если вы хотите создать и повторно использовать рабочую библиотеку или архив завершённого проекта. Используйте команду Make Integrated Library, доступную из главного меню Design как в редакторе схем, так и в редакторе PCB.

Процесс по сути включает:

1. Открытие всех исходных документов схем и создание библиотеки схем.
2. Создание PCB-библиотеки на основе документа PCB.
3. Компиляцию этих библиотек в интегрированную библиотеку с именем по проекту (<ProjectName>.IntLib).

IntLib добавляется в проект (в разделе Libraries\Compiled Libraries панели Projects panel), добавляется в установленные библиотеки (как часть Available File-based Libraries, доступной для любого проекта) и становится доступной через панель Components panel.

Упрощённое создание интегрированной библиотеки напрямую из документов схемы и PCB в активном проекте.

Создание IntLib из библиотеки базы данных

Related page: Библиотеки баз данных

Библиотеки баз данных Altium Designer — идеальный выбор, если вы хотите, чтобы компоненты Altium Designer были тесно связаны с корпоративной базой данных. Если проект должен покинуть пределы вашей компании или если вы предпочитаете, чтобы разработчики работали из защищённых интегрированных библиотек, это легко реализовать. Altium Designer предоставляет возможность компилировать интегрированную библиотеку напрямую из библиотеки базы данных: либо из стандартной библиотеки базы данных (DbLib), либо из библиотеки базы данных SVN с контролем версий (SVNDbLib). Таким образом, ваши библиотекари CAD могут продолжать использовать библиотеки баз данных, а разработчики — регулярно пересоздаваемые интегрированные библиотеки, работая, по сути, в «офлайн»-режиме.

Преобразование выполняется с помощью мастера Offline Integrated Library Maker wizard. Процесс выполняется для каждой таблицы базы данных отдельно, с полным контролем над тем, какие таблицы базы данных учитываются. Для каждой включённой таблицы будет сгенерирована отдельная интегрированная библиотека.

Преобразуйте ваши библиотеки баз данных (DbLib или SVNDbLib) в «офлайн» интегрированные библиотеки с помощью Offline Integrated Library Maker.

Процесс включает следующие шаги:

1. Открыв файл Database Library (*.DbLib) или файл SVN Database Library (*.SVNDbLib), который вы хотите преобразовать, как активный документ, выберите команду Tools » Offline Integrated Library Maker в главных меню, чтобы открыть Offline Integrated Library Maker.
2. На странице Library to Convert укажите DbLib или SVNDbLib для обработки. Активная библиотека, из которой был вызван Offline Integrated Library Maker, по умолчанию будет указана как библиотека для преобразования. При необходимости вы можете свободно найти и выбрать другую библиотеку базы данных.
3. На странице Options укажите, какие таблицы связанной базы данных следует включить в преобразование. По умолчанию в преобразование включаются все таблицы базы данных. Чтобы исключить таблицу, убедитесь, что соответствующий параметр Convert отключён. Эта страница Offline Integrated Library Maker также позволяет указать выходной каталог, в котором будут храниться сгенерированные интегрированные библиотеки. Введите путь к этому базовому каталогу напрямую или нажмите значок  справа от поля, чтобы открыть диалоговое окно, в котором можно найти и выбрать нужный каталог. Сгенерированный результат (интегрированная библиотека) для каждой включённой таблицы базы данных будет сохранён в собственной подпапке внутри указанного выходного каталога; имя подпапки формируется по имени таблицы.
4. После выбора библиотеки базы данных и настройки связанных параметров преобразования нажмите Next, чтобы запустить преобразование. Будет показана полоса прогресса, а также информация о текущей таблице базы данных, которая преобразуется. Помните, что процесс преобразования выполняется для каждой таблицы базы данных, которую вы указали для конвертации. Ниже приведена, по сути, детализация этого процесса:
   1. Создаётся пакет интегрированной библиотеки (*.LibPkg) и открывается в панели Projects panel. Пакет именуется по имени таблицы. Например, для таблицы с именем Capacitor - Ceramic получится Capacitor - Ceramic.LibPkg.
   2. Создаётся документ библиотеки схем и добавляется в LibPkg. Библиотека схем также именуется по имени таблицы (например, Capacitor - Ceramic.SchLib).
   3. Затем обрабатывается каждая запись таблицы и строится соответствующий компонент Altium Designer. Для этого связанный символ схемы извлекается из соответствующей исходной библиотеки и добавляется как компонент в новый документ библиотеки схем. Затем к этому компоненту добавляются параметры и информация о связях моделей, определённые в записи.
   4. Связанные модели футпринтов для записи извлекаются и добавляются в документ PCB-библиотеки. Этот документ также именуется по таблице (например, Capacitor - Ceramic.PcbLib). Затем документ PCB-библиотеки добавляется в LibPkg.
   5. Если исходная библиотека — DbLib, и в записи базы данных определены ссылки на модели PCB3D и/или Simulation, то соответствующая библиотека PCB3D и файлы моделей Simulation также добавляются в LibPkg. Расположение таких моделей остаётся неизменным. Полный путь к модели указывается как часть соответствующей ссылки на модель.
   6. Затем LibPkg компилируется, формируя интегрированную библиотеку (например, Capacitor - Ceramic.IntLib), которая после этого добавляется в установленные библиотеки Altium Designer.

Результаты процесса преобразования — проекты пакетов библиотек с входящими документами символов и моделей футпринтов и скомпилированные IntLib, которые также добавляются как установленные библиотеки.

Создание IntLib через получение компонентов

Related page: Получение данных Workspace с помощью Content Cart

У вас также есть возможность получать компоненты из вашего Workspace в интегрированную библиотеку (Integrated Library, *.IntLib). При размещении компонентов из такой интегрированной библиотеки фактические ссылки ведут обратно к компонентам в Workspace. Это позволяет эффективно использовать компоненты Workspace вашей компании в офлайн-режиме, при этом гарантируя, что проект сохраняет реальную связь с этими компонентами в исходном Workspace.

В диалоговом окне Content Cart dialog процесс получения IntLib выглядит следующим образом:

1. Нажмите ссылку Select target server и выберите IntLib file в меню.

   
   Задайте в качестве цели для Content Cart файл IntLib.

2. Укажите имя и расположение для создаваемого файла IntLib. По умолчанию файл будет назван в формате Integrated_Library - <Date> - <Time>.IntLib и создан в расположении \Users\Public\Documents\Altium\AD<Solution/Version>\Library\ExportCmpLib. При необходимости измените это через диалог Save As — он открывается нажатием ссылки Change.

   
   Примите папку назначения и имя файла по умолчанию или измените их при необходимости.

3. Если нужно добавить дополнительные компоненты в тот же IntLib, нажмите ссылку Add More Items и выберите пункт Select, чтобы открыть диалог Choose Item ( «урезанную» версию панели Explorer panel). Здесь можно просмотреть исходный Workspace и выбрать дополнительные Items. Либо выберите пункт Add manually, чтобы открыть диалог Add new items. Этот диалог позволяет вставить внешний список требуемых элементов (по одному элементу в строке), после чего их можно искать в исходном Workspace по выбранному критерию поиска (GUID, Item ID, Name или MPN).

4. Когда всё готово, нажмите кнопку , чтобы запустить генерацию IntLib. Будет создан временный пакет Integrated Library Package (*.LibPkg), в который будут сгенерированы и добавлены исходные файлы SchLib (с символами, параметрами и ссылками на модели) и PcbLib (с моделями посадочных мест). Затем выполняется компиляция для получения файла IntLib, который будет создан в указанной папке. Информационное окно подтвердит успешное создание файла.

   
   Выгрузите cart в целевую папку, которая будет содержать требуемый файл Integrated Library.

После генерации IntLib добавляется в список Installed Libraries — часть Available File-based Libraries для программного обеспечения.

Размещение компонентов из интегрированной библиотеки

Размещение компонентов из интегрированной библиотеки выполняется с панели Components panel. Размещение можно выполнять из активного документа схемы или активного документа PCB. Размещение можно выполнить следующими способами:

• Выберите нужный файл *.IntLib в выпадающем списке панели Components, затем щёлкните правой кнопкой по компоненту, который нужно разместить, и выберите Place <ComponentName> в контекстном меню. Разместите компонент на документе схемы, затем щёлкните, чтобы установить.

• Нажмите и перетащите (drag-and-drop) нужный компонент в область проектирования.

Хотя библиотека схем (schematic library) и интегрированная библиотека могут содержать один и тот же компонент (со всеми теми же ссылками на модели), размещённые компоненты из каждой из этих библиотек будут вести себя по-разному при извлечении информации о моделях. Компоненты, размещённые из интегрированных библиотек, будут искать свои модели в исходной интегрированной библиотеке, тогда как компоненты, размещённые из библиотек схем, не будут иметь доступа к моделям, хранящимся в интегрированных библиотеках.

Изменение интегрированной библиотеки

Интегрированные библиотеки используются для размещения компонентов и не могут редактироваться напрямую. Чтобы внести изменения в интегрированную библиотеку, сначала внесите изменения в исходные библиотеки, затем перекомпилируйте пакет библиотек, чтобы сгенерировать новую интегрированную библиотеку, включающую эти изменения.

Чтобы изменить интегрированную библиотеку:

1. Откройте проект пакета исходных библиотек (source library package project) для нужной интегрированной библиотеки.
2. Откройте исходные библиотеки схем или моделей, которые требуется изменить.
3. Внесите необходимые изменения, сохраните изменённые библиотеки и закройте их.
4. Перекомпилируйте пакет библиотек. Свеже-сгенерированная интегрированная библиотека заменит более старую существующую версию.

Декомпиляция интегрированной библиотеки

Иногда может потребоваться доступ к исходным библиотекам внутри интегрированной библиотеки для внесения изменений, но по какой-либо причине нет доступа к исходному проекту пакета библиотек, с помощью которого это можно сделать. Здесь проявляется ещё одно преимущество единого переносимого файла интегрированной библиотеки. Хотя интегрированные библиотеки нельзя редактировать напрямую; их можно декомпилировать обратно в составляющие их исходные библиотеки символов и моделей.

Чтобы сделать это:

1. Откройте интегрированную библиотеку, содержащую исходные библиотеки, которые нужно изменить. Либо:
   1. Выберите команду File » Open, перейдите к интегрированной библиотеке в диалоге Choose Document to Open, затем нажмите Open.
   2. Перетащите файл IntLib из Windows File Explorer в окно Altium Designer.

2. В появившемся диалоге Open Integrated Library нажмите кнопку Extract .

Исходные библиотеки схем и моделей извлекаются и сохраняются в новой папке, названной по имени файла интегрированной библиотеки, в той папке, где находится исходная интегрированная библиотека. Затем создаётся пакет библиотек (<IntegratedLibraryFileName>.LibPkg), и исходные библиотеки схем и PCB добавляются в проект и отображаются на панели Projects panel. Файлы моделей симуляции и подцепей (sub-circuit) автоматически в проект не добавляются.

Извлечение исходных библиотек из интегрированной библиотеки — декомпиляция для получения проекта пакета библиотек.