Atualizando componentes a partir de bibliotecas baseadas em banco de dados e em arquivos

Você posicionou componentes no esquemático, talvez até tenha concluído todas as conexões e a compilação, e levado o projeto à etapa de layout da placa. Muito provavelmente, chegará um momento em que será necessário alterar um componente — adicionar um novo parâmetro, alterar um vínculo de modelo ou talvez modificar graficamente um símbolo ou footprint.

O lugar mais lógico para fazer uma alteração é na origem. A natureza dessa origem depende de como o componente foi posicionado:

• From an Integrated Library - as bibliotecas de origem são extraídas, a alteração é feita e o pacote de biblioteca integrada é compilado para gerar a biblioteca integrada revisada.
• From a Database Library - para um parâmetro ou uma referência de símbolo/modelo, a alteração é feita no registro correspondente ao componente no banco de dados externo vinculado. Se a alteração for gráfica (em um símbolo ou modelo), ela será realizada na biblioteca de origem referenciada.
• From a Schematic/PCB Library - a alteração é feita no componente ou footprint na biblioteca correspondente a partir da qual o componente/footprint foi posicionado.

Você também pode ter vinculado um componente posicionado a um banco de dados externo usando um arquivo Database Link (*.DBLink). As alterações de símbolos e modelos são feitas nas bibliotecas de origem. Para os parâmetros, as alterações são feitas no banco de dados.

Depois de feitas, as alterações precisam ser propagadas para o projeto. O Altium Designer oferece diversas ferramentas de atualização que permitem transferir alterações de componentes para os seus componentes do Altium Designer de forma rápida e eficiente. Este documento detalha essas ferramentas, ou seja, ferramentas que permitem manter a sincronização entre a origem dos componentes e as instâncias desses componentes posicionadas no projeto.

Atualização de parâmetros a partir de um banco de dados

No contexto desta ferramenta, o termo “componente do Altium Designer” é usado para descrever uma instância de componente posicionada em uma folha de esquemático ou um componente em uma biblioteca de esquemáticos de origem. O Altium Designer oferece uma ferramenta para atualizar os parâmetros dos componentes do Altium Designer com informações armazenadas em um banco de dados externo. Os componentes devem estar vinculados aos registros de componentes correspondentes no banco de dados externo para que a atualização seja possível. A vinculação é realizada por meio de um arquivo intermediário, que pode ser um dos seguintes:

• Database Link arquivo (*.DBLink) - usado ao vincular componentes existentes já posicionados a um banco de dados externo ou, mais comumente, componentes definidos em uma biblioteca de esquemáticos de origem.
• Database Library arquivo (*.DBLib) - usado ao posicionar componentes diretamente em uma folha de esquemático a partir de um banco de dados externo.
• SVN Database Library arquivo (*.SVNDBLib) - o mesmo que para um *.DBLib, mas com bibliotecas de símbolos e modelos armazenadas sob controle de versão.

As atualizações são realizadas no editor de esquemáticos escolhendo o comando Tools » Update Parameters From Database, disponível nos menus principais. Ao executar esse comando, a caixa de diálogo Update Parameters From Database será aberta. Use essa caixa de diálogo para escolher quais documentos de esquemático e tipos de componentes deseja incluir na atualização.

A caixa de diálogo Update Parameters From Database

Depois de definir o escopo da atualização, clique em OK. O banco de dados externo será consultado em busca de componentes correspondentes. Se houver diferenças de parâmetros entre os componentes do Altium Designer e os registros correspondentes no banco de dados, a caixa de diálogo Select Parameter Changes será aberta. Se nenhuma diferença for encontrada, uma caixa de diálogo será aberta informando isso.

A caixa de diálogo Select Parameter Changes

Esta caixa de diálogo lista todos os parâmetros existentes nos registros do banco de dados para os componentes vinculados do Altium Designer que estão no escopo da atualização. Quaisquer parâmetros definidos para um componente do Altium Designer que não sejam um campo em uma tabela do banco de dados não serão listados. Por exemplo, você pode ter inserido um componente diretamente de um banco de dados usando o recurso de biblioteca de banco de dados e depois adicionado um ou mais parâmetros após a inserção.

Somente os parâmetros mapeados entre o banco de dados externo e a instância do componente inserido são listados. O mapeamento de parâmetros é realizado na aba Field Mappings do arquivo de vínculo intermediário.

A caixa de diálogo mostrará inicialmente as atualizações propostas para sincronizar os parâmetros dos componentes do Altium Designer com os do banco de dados, com base nas ações de atualização definidas no arquivo de vínculo intermediário (*.DbLink, *.DbLib ou *.SvnDbLib).

As diferenças entre parâmetros são identificadas por um ícone específico inserido na célula correspondente. Por exemplo, um triângulo azul no canto de uma célula significa que foi detectada uma diferença entre o valor de um parâmetro no componente do Altium Designer e o mesmo parâmetro no registro vinculado do banco de dados.

Há uma lista completa de todos os estados de célula disponíveis na caixa de diálogo Select Parameter Changes nesta página, na seção Estados de atualização de parâmetros.

Os controles disponíveis na caixa de diálogo Select Parameter Changes permitem controlar totalmente quais atualizações devem ser realizadas e quais devem ser rejeitadas. Você pode rejeitar as atualizações de todos os parâmetros de um componente selecionado ou de parâmetros específicos desse componente. Para rejeitar uma atualização proposta para um parâmetro específico, selecione a célula correspondente e clique no botão Reject Selected. Para restabelecer a atualização, clique no botão Update Selected.

Quando estiver satisfeito com a proposta de atualização, clique no botão Accept Changes (Create ECO). Use a caixa de diálogo Engineering Change Order que será aberta para validar e, em seguida, executar as atualizações correspondentes. Se perceber que há uma atualização que realmente não deseja realizar, desabilite a entrada da ordem de alteração correspondente.

A caixa de diálogo Engineering Change Order

Sincronização dupla

Você pode ter um projeto existente no qual a maioria das peças inseridas foi vinculada a um banco de dados externo por meio de um arquivo DbLink. Alterações no projeto podem resultar em circuitos adicionais, cujos componentes podem ser inseridos usando o recurso Biblioteca de banco de dados. O arquivo DbLib/SVNDbLib associado pode perfeitamente apontar para um banco de dados externo diferente.

Ao usar o comando Update Parameters From Database, todos os parâmetros vinculados dos componentes inseridos serão consultados em todos os bancos de dados vinculados, independentemente do método de vinculação utilizado, e as diferenças detectadas para esses parâmetros serão exibidas na caixa de diálogo Selecionar alterações de parâmetros.

Atualização de componentes do esquemático a partir de bibliotecas

O Altium Designer fornece uma ferramenta para atualizar componentes inseridos em uma folha de esquemático com informações modificadas de uma biblioteca de origem. Isso inclui bibliotecas de componentes de esquemático (*.SchLib), bibliotecas integradas (*.IntLib) e bibliotecas de banco de dados (*.DBLib, *.SVNDBLib).

Embora os arquivos DBLib e SVNDBLib sejam apresentados como bibliotecas no painel Components, eles são apenas uma fonte de conexão e mapeamento de campos, e não bibliotecas no verdadeiro sentido da palavra. O recurso de atualização transfere as alterações feitas nos parâmetros e nas referências a símbolos e modelos no banco de dados externo, bem como as modificações gráficas feitas nas bibliotecas de símbolos e modelos referenciadas.

O recurso de atualização permite transferir alterações de parâmetros, bem como informações gráficas e de modelos.

As atualizações são realizadas a partir do documento de esquemático, escolhendo o comando Tools » Update From Libraries disponível nos menus principais. Ao executar esse comando, a caixa de diálogo Update From Library será aberta. O comando Update From Libraries atualiza todos os componentes da folha de esquemático com informações modificadas de uma biblioteca de origem.

As atualizações também são realizadas a partir do documento de esquemático, escolhendo o comando Tools » Update Selected From Libraries disponível nos menus principais. O comando Update Selected From Libraries atualiza apenas os componentes selecionados na folha de esquemático com informações modificadas de uma biblioteca de origem.

A caixa de diálogo Update From Library

Definição do escopo da atualização

A primeira página da caixa de diálogo trata do escopo da atualização, ou seja, quais documentos de esquemático de origem devem ser incluídos na atualização e os tipos específicos de componentes contidos neles.

A região Schematic Sheets carregará todos os documentos de esquemático aos quais a atualização pode ser aplicada. Pode ser um único documento de esquemático avulso ou todas as folhas de esquemático do projeto ativo. Habilite os documentos cujos componentes você deseja que sejam considerados na atualização.

À medida que você habilita/desabilita entradas na lista Schematic Sheets usando as caixas de seleção ou os comandos All On / All Off do menu de contexto, os componentes físicos correspondentes serão listados na região Component Types da caixa de diálogo. Cada componente é listado com as seguintes informações:

• Nome do componente físico
• Símbolo lógico associado
• Biblioteca de origem a partir da qual ele foi inserido
• Número de instâncias atualmente inseridas em todos os documentos de esquemático habilitados.

A inclusão de componentes na lista segue as opções disponíveis no canto inferior esquerdo da página. Use o campo Show para determinar os tipos de componentes incluídos na atualização. Por padrão, All Components está selecionado, mas você pode optar por atualizar apenas:

• Standard Components - aqueles inseridos a partir de uma biblioteca de esquemático ou de uma biblioteca integrada.
• Database Components - aqueles inseridos a partir de um banco de dados externo usando um DBLib ou SVNDBLib.

O campo Show da caixa de diálogo Update From Library

Todos os tipos de componentes estão inicialmente habilitados para inclusão na atualização. Desabilite aqueles que você definitivamente não deseja atualizar. Como alternativa, selecione os componentes exatos que deseja atualizar diretamente nas folhas de esquemático antes de abrir a caixa de diálogo. Em seguida, habilite a opção Selected Parts Only. Apenas os componentes da sua seleção serão listados. Você também pode usar os comandos All On / All Off do menu de contexto.

Use a opção Include Variants para incluir variantes e/ou a opção Update to Latest Revision para atualizar os componentes inseridos a partir de uma biblioteca do Workspace para as revisões mais recentes disponíveis. Use essas opções para atualizar os parâmetros de componentes alternativos.

O mais importante a lembrar é que você sempre tem controle total sobre o que é incluído na atualização.

Definição das ações padrão de atualização

A região Settings da página é onde você pode definir o nível padrão de atualização necessário. As ações padrão de atualização definidas aqui serão aplicadas a todas as instâncias dos componentes dos tipos habilitados.

A região Actions da caixa de diálogo Update From Library

A forma mais simples de atualização é substituir integralmente os componentes nas folhas de esquemático pelos componentes definidos na biblioteca de origem - Fully replace symbols on sheet with those from library. Os atributos gráficos, parâmetros e vínculos de modelos são todos atualizados diretamente com as informações existentes na biblioteca de origem. Quando essa opção é selecionada, as opções a seguir são habilitadas. Selecione todas as que se aplicam:

• Update designator lock field (mostrar imagem)
• Update part ID lock field (mostrar imagem)
• Preserve parameter locations
• Preserve parameter visibility

A substituição integral (Fully replace symbols on sheet with those from library) está habilitada por padrão. Se você quiser um pouco mais de controle sobre o que é atualizado, mude para Replace selected attributes of symbols on sheets. As opções individuais de atualização (Update graphical attributes, Update parameters, Update models) ficarão disponíveis para inclusão/exclusão conforme necessário.

As definições na primeira página da caixa de diálogo Update From Library e na caixa de diálogo Library Update Settings são persistentes. Elas são armazenadas no arquivo do projeto ao salvá-lo.

Para as ações de atualização de parâmetros e modelos, é possível ter mais controle na caixa de diálogo Library Update Settings. Acesse a caixa de diálogo clicando no botão Advanced. Nessa caixa de diálogo, você pode não apenas definir as ações padrão globais de atualização para parâmetros e modelos, mas também controlar quais parâmetros e modelos específicos serão incluídos na atualização.

Acesso à caixa de diálogo Library Update Settings

Depois de definir o escopo da atualização conforme necessário e as ações padrão a serem executadas, você pode clicar em Finish e, em seguida, revisar e executar as alterações a serem implementadas na ordem de alteração de engenharia (ECO) gerada. Se quiser refinar ainda mais a atualização por componente antes de gerar a ECO, clique em Next para acessar a segunda página da caixa de diálogo, detalhada na próxima seção.

Controle da atualização por instância de componente

As definições na segunda página da caixa de diálogo Update From Library não são persistentes. Elas serão perdidas se você voltar à primeira página ou fechar a caixa de diálogo.

A segunda página da caixa de diálogo Update From Library apresenta uma tabela detalhada que lista todas as instâncias de componentes envolvidas no processo de atualização pretendido. A página anterior da caixa de diálogo permitiu especificar, de forma geral, quais tipos de componentes físicos seriam incluídos na atualização. Esta página permite ajustar com precisão quais instâncias de componentes desses tipos serão atualizadas.

A segunda página da caixa de diálogo Update From Library

A tabela é dividida em três regiões:

• Schematic Parts - esta área lista Designator, Comment, Physical Component e Logical Symbol para cada componente inserido nas folhas de esquemático. Marque a caixa de seleção Update para atualizar o componente selecionado.
• Library Components - esta área lista Physical Component, Logical Symbol, Library Name e Life Cycle State do componente da biblioteca para cada componente do esquemático listado. Normalmente, essa é a mesma biblioteca de origem da qual o componente foi inserido originalmente, mas você pode substituir completamente o componente por outro, da mesma biblioteca ou de uma biblioteca diferente. Os componentes que não puderem ser encontrados nas bibliotecas atualmente disponíveis serão listados como <Not Found>.
• Actions - as ações de atualização específicas necessárias para cada instância de componente cuja caixa Update  esteja marcada. Elas serão inicialmente definidas de acordo com as configurações de ação padrão especificadas na primeira página da caixa de diálogo. Clique na caixa de seleção para habilitar/desabilitar a ação para o componente selecionado ou use os comandos do menu de contexto.
  • Full Replace - marque a caixa para realizar uma substituição completa dos itens selecionados.
  • Graphical - marque a caixa para realizar uma atualização gráfica dos itens selecionados.
  • Parameters - marque a caixa para atualizar os parâmetros dos itens selecionados. Se houver pelo menos um componente com esta caixa de seleção habilitada, você poderá clicar no botão Parameters Changes para controlar seletivamente as alterações no nível dos parâmetros - saiba mais.
  • Models - marque a caixa para atualizar os modelos dos itens selecionados.

Para cada componente, a entrada referente ao componente da biblioteca de origem será inicialmente aquela usada para inserir a instância do componente. Essas informações são obtidas da região Library Link do painel Properties do componente inserido.

Especificação de um componente alternativo

Normalmente, a atualização envolve transferir as alterações feitas no componente físico original da biblioteca de origem para as instâncias desse mesmo componente físico inseridas nas folhas de esquemático. Pode haver ocasiões em que você queira substituir completamente o componente físico inserido no projeto. Isso pode ser facilmente especificado como parte da atualização.

Você pode especificar um componente alternativo para uma instância de componente editando diretamente o campo Physical Component correspondente na região Library Components). Se o componente físico especificado não existir em nenhuma das bibliotecas atualmente adicionadas à lista de bibliotecas disponíveis baseadas em arquivos do projeto, a entrada <Not Found> será inserida nos campos Logical Symbol e Library Name. Nesse caso, não será possível atualizar essa instância de componente.

Ao pesquisar um componente de banco de dados, a pesquisa só pode abranger os arquivos DBLib e SVNDBLib atualmente carregados (Available Filed-based Libraries). Não é possível pesquisar componentes de banco de dados ao longo de um caminho de pesquisa especificado.

Como alternativa, selecione uma instância de componente na grade e clique no botão Choose Component. A caixa de diálogo Replace Component será aberta, permitindo pesquisar o componente de substituição desejado em qualquer uma das bibliotecas atualmente disponíveis.

Acesso à caixa de diálogo Replace Component (File-based)

Quando um componente válido for escolhido, as informações pertinentes ao componente escolhido serão inseridas na região Library Components da página, substituindo as informações do componente original da biblioteca de origem.

Se quiser voltar à biblioteca de origem original e manter o componente físico original, selecione a instância do componente na grade e clique no botão Return Selected to Default.

Controle das alterações de parâmetros

As alterações individuais no nível dos parâmetros de uma instância de componente serão exibidas somente se a opção Full Replace estiver desabilitada e a opção Parameters estiver habilitada na região Actions da página. Se quiser examinar as alterações individuais de parâmetros propostas pela atualização, clique no botão Parameters Changes. A caixa de diálogo Select Parameter Changes será aberta, resumindo as alterações de parâmetros das instâncias de componentes com uma ação de atualização de parâmetros habilitada. Na ilustração abaixo, observe que as instâncias de componentes C1, C3, C7 e C10 estão com a ação de atualização de parâmetros desabilitada e, portanto, não aparecem na caixa de diálogo.

Acesso à caixa de diálogo Select Parameter Changes

Assim como na ferramenta Update Parameters From Database, a caixa de diálogo listará todos os parâmetros mapeados das instâncias de componentes vinculadas a um banco de dados externo. Além disso, todos os parâmetros encontrados nas instâncias de componentes inseridas envolvidas na atualização de parâmetros também serão listados. Essa é uma diferença importante ao acessar a caixa de diálogo Select Parameter Changes pelas duas ferramentas de atualização.

Novamente, a caixa de diálogo mostra as alterações propostas para sincronizar os parâmetros dos componentes inseridos com os dos componentes na biblioteca ou no banco de dados de origem correspondente. As atualizações propostas seguem as ações de atualização definidas em:

• A região Parameter Settings da caixa de diálogo Configurações de atualização de biblioteca, quando a origem da atualização é uma biblioteca de esquemáticos ou integrada.
• O arquivo de vinculação intermediário (*.DBLink, *.DBLib, *.SVNDBLib) quando a origem da atualização é um banco de dados.

As diferenças de parâmetros são destacadas por um ícone específico inserido na célula correspondente. Consulte a próxima seção (Parameter Update States) para obter uma lista completa de todos os estados possíveis das células.

Use os controles disponíveis na caixa de diálogo (botões ou menu de contexto) para determinar quais alterações de parâmetros aplicar e quais rejeitar, permitindo substituir as condições de atualização padrão no nível de cada parâmetro. Lembre-se de que rejeitar uma atualização proposta em uma célula significa que você não deseja que nenhuma alteração seja feita nesse parâmetro para aquela instância específica de componente na folha de esquemático.

Estados de atualização de parâmetros

Uma célula na caixa de diálogo Select Parameter Changes pode assumir vários estados de atualização diferentes, dependendo das diferenças exatas detectadas entre os componentes inseridos e a biblioteca ou o banco de dados de origem e das ações de atualização de parâmetros aplicáveis especificadas. A tabela a seguir lista os estados possíveis das células.

Cell State	Description
	Tanto o componente do Altium Designer quanto o componente da biblioteca/banco de dados possuem o parâmetro e seu valor é o mesmo. A atualização não causará nenhuma alteração.
	Tanto o componente do Altium Designer quanto o componente da biblioteca/banco de dados possuem o parâmetro, mas ele não tem um valor atribuído. A atualização não causará nenhuma alteração.
	Nem o componente do Altium Designer nem o componente da biblioteca/banco de dados possuem o parâmetro. A atualização não causará nenhuma alteração. Esse estado também pode aparecer se a inclusão do parâmetro do componente do Altium em uma atualização for impedida pela desativação das opções Allow Synchronization With Library e/ou Allow Synchronization With Database no painel Properties associado.
	Tanto o componente do Altium Designer quanto o componente da biblioteca/banco de dados possuem o parâmetro, mas com valores diferentes. A atualização atribuirá o valor do banco de dados.
	Tanto o componente do Altium Designer quanto o componente da biblioteca/banco de dados possuem o parâmetro. No componente do Altium Designer, ele tem um valor atribuído; no banco de dados, não. A atualização atribuirá o valor do banco de dados; neste caso, nenhum valor.
	O componente do Altium Designer não possui o parâmetro, mas o componente da biblioteca/banco de dados possui. A atualização adicionará o parâmetro ao componente do Altium Designer com o valor mostrado na célula.
	O componente do Altium Designer não possui o parâmetro, mas o componente da biblioteca/banco de dados possui. A atualização adicionará o parâmetro ao componente do Altium Designer sem um valor inicialmente atribuído.
	O componente do Altium Designer possui o parâmetro, mas o componente da biblioteca/banco de dados não. A atualização removerá o parâmetro do componente do Altium Designer. Note: Se a instância do componente estiver sendo atualizada a partir de um banco de dados externo e o mapeamento relevante entre o campo do banco de dados e o parâmetro do projeto estiver definido como, o parâmetro será tratado como se não existisse no registro do banco de dados, mesmo que exista.
	Há uma diferença entre os valores do parâmetro no componente do Altium Designer e no componente da biblioteca/banco de dados. A proposta de atualização para o valor do banco de dados foi rejeitada com base no valor atual da opção Update Values no documento de vinculação ao banco de dados (arquivo DbLink, DbLib ou SvnDbLib). Nenhuma alteração ocorrerá. Observe que os comandos Update Selected e Update All nesta caixa de diálogo substituirão esse estado e forçarão uma atualização.
	O componente do Altium Designer não possui o parâmetro, mas o componente da biblioteca/banco de dados possui. A atualização proposta para adicionar o parâmetro ao componente do Altium Designer foi rejeitada com base no valor atual da opção Add To Design . Nenhuma alteração ocorrerá. Observe que os comandos Update Selected e Update All nesta caixa de diálogo substituirão esse estado e forçarão uma atualização.
	O componente do Altium Designer possui o parâmetro, mas o componente da biblioteca/banco de dados não. A atualização proposta para remover o parâmetro do componente do Altium Designer foi rejeitada com base no valor atual da opção Remove From Design no documento de vinculação ao banco de dados (arquivo DbLink, DbLib ou SvnDbLib). Nenhuma alteração ocorrerá. Observe que os comandos Update Selected e Update All nesta caixa de diálogo substituirão esse estado e forçarão uma atualização.

Aplicação de alterações diretamente pelo Editor de Biblioteca de Esquemáticos

A atualização direta dos componentes inseridos no esquemático pode ser realizada a partir de uma biblioteca de esquemáticos de origem. Esse método de atualização é particularmente adequado para atualizar componentes que foram inseridos a partir de bibliotecas independentes de componentes de esquemático (*.SchLib), quando essas bibliotecas fazem parte das bibliotecas baseadas em arquivos disponíveis para o projeto.

As modificações feitas nos componentes de uma biblioteca de esquemáticos de origem são transferidas para os documentos de esquemático usando o comando Tools » Update Schematics disponível nos menus principais do Editor de Biblioteca de Esquemáticos. Como alternativa, as alterações nos componentes selecionados podem ser aplicadas selecionando esses componentes no painel SCH Library e usando o comando de atualização do menu de contexto.

A partir de uma biblioteca de esquemáticos de origem, as alterações podem ser aplicadas usando o menu de contexto do painel SCH Library

Todas as instâncias dos componentes inseridos em todos os documentos de esquemático abertos serão atualizadas, independentemente do projeto ao qual cada documento pertence. Essencialmente, se um componente inserido tiver a mesma entrada no campo Physical Component que o componente da biblioteca, ele será atualizado. Você será informado sobre quantos componentes (e em quantos documentos) foram modificados pelo processo de atualização. A atualização consiste na substituição completa de cada instância de componente existente pela instância da biblioteca.

Verificação de uma atualização

Após atualizar os componentes inseridos no esquemático, os componentes da biblioteca de esquemáticos ou os footprints de PCB, você certamente desejará verificar se a atualização ocorreu conforme o planejado. As seções a seguir mostram como verificar rapidamente se os parâmetros, os vínculos com modelos e os atributos gráficos foram atualizados com sucesso.

Verificação das atualizações de parâmetros

Você pode verificar se os parâmetros foram atualizados corretamente abrindo a caixa de diálogo Parameter Table Editor (Tools » Parameter Manager) ou consultando os parâmetros de um componente selecionado no painel Properties.

Abaixo, os componentes C1, C2 e C3 receberam, cada um, um novo parâmetro TestParam, com o valor Test, como parte de um processo de atualização.

A caixa de diálogo Parameter Table Editor

Verificação das atualizações de vínculos com modelos

As atualizações dos vínculos com modelos de um componente podem ser verificadas na região Models do painel Properties associado.

Verificação das atualizações gráficas

A maneira mais fácil de verificar as atualizações gráficas é comparar o componente do projeto na folha com o componente da biblioteca de origem. Este último pode ser facilmente exibido usando o painel Components, que permite uma comparação direta lado a lado.