Обновление компонентов из библиотек на основе базы данных и файловых библиотек

Вы разместили компоненты на схеме, возможно, даже полностью соединили их, скомпилировали проект и перешли к этапу трассировки платы. Вполне вероятно, что в какой-то момент потребуется изменить компонент — добавить новый параметр, изменить ссылку на модель или, возможно, внести изменение в символ или посадочное место на графическом уровне.

Логичнее всего вносить изменения в исходный источник. Характер этого источника зависит от того, каким образом был размещен компонент:

• From an Integrated Library - извлекаются исходные библиотеки, в них вносится изменение, после чего компилируется пакет интегрированной библиотеки для создания обновленной интегрированной библиотеки.
• From a Database Library - для параметра или ссылки на символ/модель изменение вносится в соответствующую запись компонента во внешней подключенной базе данных. Если изменение графическое (в символе или модели), оно выполняется в соответствующей исходной библиотеке.
• From a Schematic/PCB Library - изменение вносится в компонент или посадочное место в соответствующей библиотеке, из которой был размещен компонент/посадочное место.

will Также вы могли связать размещенный компонент с внешней базой данных с помощью файла Database Link (*.DBLink). Изменения символов и моделей вносятся в исходных библиотеках. Для параметров изменения вносятся в базе данных.

После внесения изменений их необходимо передать в проект. Altium Designer предоставляет различные инструменты обновления, позволяющие быстро и эффективно передавать изменения компонентов в компоненты Altium Designer. В этом документе описаны эти инструменты, то есть средства, которые позволяют всегда сохранять синхронизацию между источником компонента и размещенными экземплярами этих компонентов.

Обновление параметров из базы данных

В контексте этого инструмента термин «компонент Altium Designer» используется для обозначения экземпляра компонента, размещенного на листе схемы, или компонента в исходной библиотеке схем. Altium Designer предоставляет инструмент для обновления параметров компонентов Altium Designer данными, хранящимися во внешней базе данных. Чтобы обновление было возможным, компоненты должны быть связаны с соответствующими записями компонентов во внешней базе данных. Связывание выполняется с помощью промежуточного файла связи, которым может быть один из следующих:

• Database Link файл (*.DBLink) - используется при связывании уже размещенных компонентов с внешней базой данных или, что более типично, определенных компонентов в исходной библиотеке схем.
• Database Library файл (*.DBLib) - используется при прямом размещении компонентов на лист схемы из внешней базы данных.
• SVN Database Library файл (*.SVNDBLib) - то же самое, что и для *.DBLib, но с библиотеками символов и моделей, хранящимися под управлением версий.

Обновление выполняется из редактора схем путем выбора команды Tools » Update Parameters From Database, доступной в главном меню. При запуске этой команды откроется диалог Update Parameters From Database. Используйте этот диалог для выбора, какие документы схем и какие типы компонентов вы хотите включить в обновление.

Диалог Update Parameters From Database

После определения области обновления нажмите OK. Будет выполнен запрос к внешней базе данных для поиска соответствующих компонентов. Если между параметрами компонентов Altium Designer и соответствующими записями в базе данных есть различия, откроется диалог Select Parameter Changes. Если различий не найдено, откроется диалог с соответствующим сообщением.

Диалог Select Parameter Changes

В этом диалоге перечислены все параметры, существующие в записях базы данных для связанных компонентов Altium Designer, попадающих в область обновления. Любые параметры, определенные для компонента Altium Designer, но не являющиеся полем в таблице базы данных, в списке отображаться не будут. Например, вы могли разместить компонент напрямую из базы данных с помощью функции библиотеки базы данных, а затем добавить один или несколько параметров после размещения.

Перечисляются только те параметры, которые сопоставлены между внешней базой данных и экземпляром размещенного компонента. Сопоставление параметров выполняется на вкладке Field Mappings промежуточного файла связи.

Изначально в диалоге будут показаны предлагаемые обновления, приводящие параметры компонентов Altium Designer в соответствие с параметрами в базе данных на основе действий обновления, определенных вами в промежуточном файле связи (*.DbLink, *.DbLib или *.SvnDbLib).

Различия параметров обозначаются уникальным значком, вставленным в соответствующую ячейку. Например, синий треугольник в углу ячейки означает, что обнаружено различие между значением параметра в компоненте Altium Designer и тем же параметром в связанной записи базы данных.

Полный список всех доступных состояний ячеек приведен в диалоге Select Parameter Changes на этой странице, в разделе Parameter Update States.

Элементы управления, предусмотренные в диалоге Select Parameter Changes, позволяют полностью контролировать, какие обновления выполнять, а какие отклонять. Вы можете отклонить обновления для всех параметров выбранного компонента или для отдельных параметров этого компонента. Чтобы отклонить предлагаемое обновление для конкретного параметра, выберите соответствующую ячейку и нажмите кнопку Reject Selected. Чтобы вернуть обновление, нажмите кнопку Update Selected.

Когда вас устроит решение по обновлению, нажмите кнопку Accept Changes (Create ECO). Используйте открывшийся диалог Engineering Change Order, чтобы проверить, а затем выполнить соответствующие обновления. Если вы поймете, что какое-то обновление действительно не нужно выполнять, отключите соответствующую запись change order.

Диалог Engineering Change Order

Двойная синхронизация

У вас может быть существующий проект, в котором большинство размещенных компонентов связано с внешней базой данных с помощью файла DbLink. Изменения в проекте могут привести к добавлению дополнительных схемных узлов, компоненты для которых могут быть размещены с использованием функции Database Library. Связанный файл DbLib/SVNDbLib вполне может указывать на другую внешнюю базу данных.

При использовании команды Update Parameters From Database запрос всех связанных параметров размещенных компонентов будет выполняться по всем подключенным базам данных независимо от использованного метода связи, а обнаруженные различия для этих параметров будут отображаться в диалоге Select Parameter Changes dialog.

Обновление компонентов схемы из библиотек

Altium Designer предоставляет инструмент для обновления компонентов, размещенных на листе схемы, измененной информацией из исходной библиотеки. Сюда входят библиотеки компонентов схем (*.SchLib), интегрированные библиотеки (*.IntLib) и библиотеки баз данных (*.DBLib, *.SVNDBLib).

Хотя файлы DBLib и SVNDBLib представлены как библиотеки на панели Components panel, они являются лишь источником подключения и сопоставления полей, а не библиотеками в истинном смысле слова. Функция обновления передает изменения параметров, ссылок на символы и модели из внешней базы данных, а также графические изменения, выполненные в связанных библиотеках символов и моделей.

Функция обновления позволяет передавать изменения параметров, а также модельной и графической информации.

Обновление выполняется из документа схемы путем выбора команды Tools » Update From Libraries, доступной в главном меню. При запуске этой команды откроется диалог Update From Library. Команда Update From Libraries обновляет все компоненты на листе схемы измененной информацией из исходной библиотеки.

Обновление также выполняется из документа схемы путем выбора команды Tools » Update Selected From Libraries, доступной в главном меню. Команда Update Selected From Libraries обновляет только выбранные компоненты на листе схемы измененной информацией из исходной библиотеки.

Диалог Update From Library

Определение области обновления

Первая страница диалога посвящена области обновления, то есть тому, какие исходные документы схем должны быть включены в обновление и какие конкретные типы компонентов в них содержатся.

Область Schematic Sheets загрузит все возможные документы схем, к которым можно применить обновление. Это может быть как отдельный автономный документ схемы, так и все листы схем в активном проекте. Включите те документы, компоненты которых должны учитываться при обновлении.

По мере включения/отключения элементов в списке Schematic Sheets с помощью флажков или команд All On / All Off из контекстного меню, входящие в них физические компоненты будут перечислены в области Component Types диалога. Для каждого компонента указываются:

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

Включение компонентов в список зависит от параметров, доступных в нижней левой части страницы. Используйте поле Show, чтобы определить типы компонентов, включаемых в обновление. По умолчанию выбрано All Components, но можно выбрать обновление только:

• Standard Components - компонентов, размещенных из библиотеки схем или интегрированной библиотеки.
• Database Components - компонентов, размещенных из внешней базы данных с использованием DBLib или SVNDBLib.

Поле Show диалога Update From Library

Изначально все типы компонентов включены в обновление. Отключите те, которые вы точно не хотите обновлять. Либо заранее выберите непосредственно на листе(ах) схемы именно те компоненты, которые хотите обновить, а затем включите параметр Selected Parts Only. В списке будут отображаться только компоненты из вашего выбора. Также можно использовать команды All On / All Off из контекстного меню.

Используйте параметр Include Variants, чтобы включить варианты, и/или параметр Update to Latest Revision, чтобы обновить компоненты, размещенные из библиотеки Workspace, до последних доступных редакций. Используйте эти параметры для обновления параметров альтернативных компонентов.

Главное, что следует помнить: вы всегда полностью контролируете, что именно будет включено в обновление.

Определение действий обновления по умолчанию

Область Settings страницы позволяет определить уровень обновления по умолчанию. Заданные здесь действия обновления по умолчанию будут применены ко всем экземплярам компонентов включенных типов.

Область Actions диалога Update From Library

Самая простая форма обновления — полностью заменить компоненты на листе(ах) схемы теми, которые определены в исходной библиотеке — Fully replace symbols on sheet with those from library. Графические атрибуты, параметры и ссылки на модели обновляются напрямую информацией, существующей в исходной библиотеке. Когда выбран этот параметр, становятся доступными следующие параметры. Выберите все применимые:

• Update designator lock field (show image)
• Update part ID lock field (show image)
• Preserve parameter locations
• Preserve parameter visibility

Полная замена (Fully replace symbols on sheet with those from library) включена по умолчанию. Если вам нужен более точный контроль над тем, что обновляется, переключитесь на Replace selected attributes of symbols on sheets. Станут доступны отдельные параметры обновления (Update graphical attributes, Update parameters, Update models), которые можно включать или исключать по мере необходимости.

Определения на первой странице диалога Update From Library и диалога Library Update Settings являются постоянными. Они сохраняются в файле проекта при сохранении.

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

Открытие диалога Library Update Settings

После определения области обновления и действий по умолчанию нажмите Finish, затем просмотрите и выполните изменения, которые будут реализованы в последующем сгенерированном Engineering Change Order. Если перед генерацией ECO вы хотите дополнительно уточнить обновление для каждого компонента отдельно, нажмите Next, чтобы перейти ко второй странице диалога, описанной в следующем разделе.

Управление обновлением по экземпляру компонента

Определения на второй странице диалога Update From Library не сохраняются. Они будут потеряны, если вы вернетесь на первую страницу или закроете диалог.

На второй странице диалога Update From Library отображается подробная таблица, в которой перечислены все экземпляры компонентов, участвующие в предполагаемом процессе обновления. На предыдущей странице диалога можно было указать на общем уровне, какие типы физических компонентов включать в обновление. Эта страница позволяет точно настроить, какие именно экземпляры компонентов этих типов будут обновлены.

Вторая страница диалога Update From Library

Таблица разделена на три области:

• Schematic Parts — в этой области перечислены Designator, Comment, Physical Component и Logical Symbol для каждого размещенного компонента на листе(ах) схемы. Установите флажок Update , чтобы обновить выбранный компонент.
• Library Components — в этой области перечислены Physical Component, Logical Symbol, Library Name и Life Cycle State компонента библиотеки для каждой указанной части схемы. Обычно это та же исходная библиотека, из которой компонент был изначально размещен, однако у вас есть возможность полностью заменить компонент на другой из той же или другой библиотеки. Компоненты, которые не удается найти в доступных в данный момент библиотеках, перечисляются как <Not Found>.
• Actions — конкретные действия обновления, необходимые для каждого экземпляра компонента, для которого установлен флажок Update . Изначально они задаются в соответствии с параметрами действий по умолчанию, определенными на первой странице диалога. Щелкните флажок, чтобы включить/отключить действие для выбранного компонента, или используйте команды контекстного меню.
  • Full Replace — установите флажок, чтобы выполнить полную замену выбранного элемента(ов).
  • Graphical — установите флажок, чтобы выполнить графическое обновление выбранного элемента(ов).
  • Parameters — установите флажок, чтобы обновить параметры выбранного элемента(ов). Если есть хотя бы один компонент с установленным этим флажком, вы можете нажать кнопку Parameters Changes, чтобы выборочно управлять изменениями на уровне параметров — узнать больше.
  • Models — установите флажок, чтобы обновить модели выбранного элемента(ов).

Для каждого компонента запись для компонента исходной библиотеки изначально будет той, которая использовалась для первоначального размещения экземпляра компонента. Эта информация берется из области Library Link панели Properties размещенного компонента.

Указание альтернативного компонента

Обычно обновление предполагает передачу изменений, внесенных в исходный физический компонент в исходной библиотеке, размещенному(ым) экземпляру(ам) того же физического компонента на листе(ах) схемы. Однако могут быть случаи, когда вы захотите полностью заменить физический компонент, размещенный в проекте. Это можно легко указать как часть обновления.

Вы можете указать альтернативный компонент для экземпляра компонента, напрямую отредактировав соответствующее поле Physical Component в области Library Components). Если указанный физический компонент не существует ни в одной из библиотек, добавленных в настоящее время в список Available Filed-based Libraries проекта, в поля Logical Symbol и Library Name будет введено значение <Not Found>. В этом случае обновление для данного экземпляра компонента будет невозможно.

При поиске компонента базы данных поиск может выполняться только по загруженным в данный момент файлам DBLib и SVNDBLib (Available Filed-based Libraries). Поиск компонентов базы данных по заданному пути поиска невозможен.

Либо выберите экземпляр компонента в таблице, затем нажмите кнопку Choose Component. Откроется диалог Replace Component, в котором можно найти требуемый компонент для замены в любой из доступных в данный момент библиотек.

Доступ к диалогу Replace Component (File-based)

Когда выбран допустимый компонент, соответствующая информация о нем будет внесена в область Library Components страницы и заменит исходный компонент библиотеки.

Если вы хотите вернуться к исходной библиотеке и сохранить исходный физический компонент, выберите экземпляр компонента в таблице, затем нажмите кнопку Return Selected to Default.

Управление изменениями параметров

Изменения на уровне отдельных параметров для экземпляра компонента будут показаны только если параметр Full Replace отключен, а параметр Parameters включен в области Actions страницы. Если вы хотите просмотреть отдельные изменения параметров, предлагаемые обновлением, нажмите кнопку Parameters Changes. Откроется диалог Select Parameter Changes, в котором будут сведены изменения параметров для тех экземпляров компонентов, у которых включено действие обновления параметров. На иллюстрации ниже обратите внимание, что для экземпляров компонентов C1, C3, C7 и C10 действие обновления параметров отключено, поэтому они не отображаются в диалоге.

Доступ к диалогу Select Parameter Changes

Как и в инструменте Update Parameters From Database, в диалоге будут перечислены все сопоставленные параметры для тех экземпляров компонентов, которые связаны с внешней базой данных. Кроме того, будут перечислены все параметры, найденные в размещенных экземплярах компонентов, участвующих в обновлении параметров. Это ключевое различие при доступе к диалогу Select Parameter Changes из двух инструментов обновления.

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

• области Parameter Settings диалога Library Update Settings dialog, когда источником обновления является схематическая или интегрированная библиотека.
• промежуточном файле связи (*.DBLink, *.DBLib, *.SVNDBLib), когда источником обновления является база данных.

Различия параметров выделяются с помощью уникального значка, вставляемого в соответствующую ячейку. Полный список всех возможных состояний ячеек см. в следующем разделе (Parameter Update States).

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

Состояния обновления параметров

Существует ряд различных состояний обновления, в которые может быть переведена ячейка в диалоге Select Parameter Changes, в зависимости от точно обнаруженных различий между размещенными компонентами и исходной библиотекой/базой данных, а также указанных применимых действий по обновлению параметров. В следующей таблице перечислены возможные состояния ячеек.

Cell State	Description
	И компонент Altium Designer, и компонент в библиотеке/базе данных содержат этот параметр, и значение одинаково. Обновление не приведет к изменениям.
	И компонент Altium Designer, и компонент в библиотеке/базе данных содержат этот параметр, но ему не присвоено значение. Обновление не приведет к изменениям.
	Ни компонент Altium Designer, ни компонент в библиотеке/базе данных не содержат этот параметр. Обновление не приведет к изменениям. Это состояние также может появиться, если параметр в компоненте Altium запрещено включать в обновление путем отключения параметров Allow Synchronization With Library и/или Allow Synchronization With Database на связанной панели Properties.
	И компонент Altium Designer, и компонент в библиотеке/базе данных содержат этот параметр, но с разными значениями. Обновление присвоит значение из базы данных.
	И компонент Altium Designer, и компонент в библиотеке/базе данных содержат этот параметр. Для компонента Altium Designer значение задано, а в базе данных — нет. Обновление присвоит значение из базы данных; в данном случае — отсутствие значения.
	Компонент Altium Designer не содержит этот параметр, а компонент в библиотеке/базе данных содержит. Обновление добавит параметр в компонент Altium Designer со значением, показанным в ячейке.
	Компонент Altium Designer не содержит этот параметр, а компонент в библиотеке/базе данных содержит. Обновление добавит параметр в компонент Altium Designer без первоначально присвоенного значения.
	Компонент Altium Designer содержит этот параметр, а компонент в библиотеке/базе данных — нет. Обновление удалит параметр из компонента Altium Designer. Note: Если экземпляр компонента обновляется из внешней базы данных и соответствующее сопоставление полей базы данных с параметрами проекта настроено на , параметр будет рассматриваться так, как будто он отсутствует в записи базы данных, даже если это не так.
	Существует различие между значениями параметра у компонента Altium Designer и компонента в библиотеке/базе данных. Предложение обновить значение до значения из базы данных было отклонено на основании текущего значения параметра Update Values в документе связи с базой данных (файл DbLink, DbLib или SvnDbLib). Изменений не произойдет. Обратите внимание, что команды Update Selected и Update All в этом диалоге переопределяют это состояние и принудительно выполняют обновление.
	Компонент Altium Designer не содержит этот параметр, а компонент в библиотеке/базе данных содержит. Предлагаемое обновление для добавления параметра в компонент Altium Designer было отклонено на основании текущего значения параметра Add To Design . Изменений не произойдет. Обратите внимание, что команды Update Selected и Update All в этом диалоге переопределяют это состояние и принудительно выполняют обновление.
	Компонент Altium Designer содержит этот параметр, а компонент в библиотеке/базе данных — нет. Предлагаемое обновление для удаления параметра из компонента Altium Designer было отклонено на основании текущего значения параметра Remove From Design в документе связи с базой данных (файл DbLink, DbLib или SvnDbLib). Изменений не произойдет. Обратите внимание, что команды Update Selected и Update All в этом диалоге переопределяют это состояние и принудительно выполняют обновление.

Применение изменений непосредственно из редактора схематической библиотеки

Прямое обновление размещенных схематических компонентов можно выполнить из исходной схематической библиотеки. Этот метод обновления особенно подходит для обновления компонентов, размещенных из изолированных библиотек схематических компонентов (*.SchLib), и в тех случаях, когда эти библиотеки входят в состав доступных файловых библиотек проекта.

Изменения, внесенные в компоненты исходной схематической библиотеки, передаются в документ(ы) схемы с помощью команды Tools » Update Schematics, доступной в главном меню редактора Schematic Library Editor. Кроме того, изменения для выбранных компонентов можно применить, выбрав эти компоненты на панели SCH Library panel и используя команду обновления из контекстного меню.

Из исходной схематической библиотеки изменения можно применить через контекстное меню панели SCH Library

Все экземпляры размещенного(ых) компонента(ов) во всех открытых схематических документах будут обновлены независимо от проекта, к которому принадлежит документ. По сути, если у размещенного компонента в поле Physical Component указано то же значение, что и у библиотечного компонента, он будет обновлен. Вы получите уведомление о том, сколько компонентов (и в скольких документах) было изменено в процессе обновления. Обновление представляет собой полную замену каждого существующего экземпляра компонента на компонент из библиотеки.

Проверка обновления

После обновления размещенных схематических компонентов, компонентов схематической библиотеки или PCB Footprints, разумеется, потребуется убедиться, что обновление прошло так, как было запланировано. В следующих разделах рассматривается, как можно быстро проверить, что параметры, ссылки на модели и графические атрибуты были успешно обновлены.

Проверка обновлений параметров

Проверить, что параметры обновлены правильно, можно либо запустив диалог Parameter Table Editor dialog (Tools » Parameter Manager), либо просмотрев параметры выбранного компонента через панель Properties panel.

Ниже компоненты C1, C2 и C3 получили новый параметр TestParam со значением Test в рамках процесса обновления.

Диалог Parameter Table Editor

Проверка обновлений ссылок на модели

Обновления ссылок на модели для компонента можно проверить в области Models соответствующей панели Properties.

Проверка графических обновлений

Самый простой способ проверить графические обновления — сравнить компонент проекта на листе с компонентом в исходной библиотеке. Последний можно легко отобразить с помощью панели Components panel, что позволяет выполнить прямое сравнение бок о бок.