Updating Components from Database and File-based Libraries

Já colocou componentes no esquema, talvez até já os tenha ligado por completo, compilado e levado o design para a fase de layout da placa. Muito provavelmente, chegará o momento em que será necessária uma alteração a um componente — adicionar um novo parâmetro, alterar uma ligação de modelo, ou talvez modificar um símbolo ou footprint ao nível gráfico.

O local lógico para efetuar uma alteração é na origem. A natureza dessa origem depende da forma como o componente foi colocado:

• From an Integrated Library - as bibliotecas de origem são extraídas, a alteração é efetuada e o pacote de biblioteca integrada é compilado para gerar a biblioteca integrada revista.
• From a Database Library - no caso de um parâmetro ou de uma referência de símbolo/modelo, a alteração é efetuada no registo correspondente ao componente na base de dados externa associada. Se a alteração for gráfica (a um símbolo ou modelo), é realizada na biblioteca de origem referenciada.
• From a Schematic/PCB Library - a alteração é efetuada no componente ou footprint na biblioteca correspondente a partir da qual o componente/footprint foi colocado.

Também poderá ter associado um componente colocado a uma base de dados externa através de um ficheiro Database Link (*.DBLink). As alterações ao símbolo e ao modelo são efetuadas nas bibliotecas de origem. No caso dos parâmetros, as alterações são feitas na base de dados.

Depois de efetuadas, as alterações têm de ser propagadas para o design. A Altium disponibiliza uma variedade de ferramentas de atualização que lhe permitem transferir, de forma rápida e eficiente, alterações de componentes para os seus componentes do Altium Designer. Este documento descreve essas ferramentas — ferramentas que lhe permitem manter sempre a sincronização entre a origem do componente e as instâncias colocadas desses componentes.

Atualizar Parâmetros a Partir de uma Base de Dados

No contexto desta ferramenta, o termo 'componente do Altium Designer' é usado para descrever uma instância de componente colocada numa folha esquemática ou um componente numa biblioteca esquemática de origem. O Altium Designer disponibiliza uma ferramenta para atualizar os parâmetros dos componentes do Altium Designer com informação armazenada numa base de dados externa. Os componentes têm de estar associados aos registos de componentes correspondentes na base de dados externa para que a atualização seja possível. A associação é efetuada através da utilização de um ficheiro de ligação intermédio, que pode ser um dos seguintes:

• Database Link ficheiro (*.DBLink) - utilizado ao associar componentes já colocados a uma base de dados externa ou, mais tipicamente, componentes definidos numa biblioteca esquemática de origem.
• Database Library ficheiro (*.DBLib) - utilizado ao colocar componentes diretamente numa folha esquemática a partir de uma base de dados externa.
• SVN Database Library ficheiro (*.SVNDBLib) - igual ao de um *.DBLib, mas com as bibliotecas de símbolos e modelos armazenadas sob controlo de versões.

As atualizações são executadas a partir do Schematic Editor escolhendo o comando Tools » Update Parameters From Database disponível nos menus principais. Ao iniciar este comando, será aberta a caixa de diálogo Update Parameters From Database. Utilize esta caixa de diálogo para escolher que documentos esquemáticos e tipos de componentes pretende incluir na atualização.

A caixa de diálogo Update Parameters From Database

Depois de definir o âmbito da atualização, clique em OK. Será feita uma consulta à base de dados externa para componentes correspondentes. Se existirem diferenças de parâmetros entre os componentes do Altium Designer e os registos correspondentes na base de dados, abre-se a caixa de diálogo Select Parameter Changes.

A caixa de diálogo Select Parameter Changes

Esta caixa de diálogo lista todos os parâmetros que existem nos registos da base de dados para componentes do Altium Designer associados e abrangidos pelo âmbito da atualização. Quaisquer parâmetros definidos para um componente do Altium Designer mas que não sejam um campo numa tabela da base de dados não aparecerão listados. Por exemplo, poderá ter colocado um componente diretamente a partir de uma base de dados utilizando a funcionalidade de biblioteca de base de dados e depois ter adicionado um ou mais parâmetros após a colocação.

Apenas são listados os parâmetros que estão mapeados entre a base de dados externa e a instância do componente colocado. O mapeamento de parâmetros é efetuado no separador Field Mappings do ficheiro de ligação intermédio.

A caixa de diálogo mostrará inicialmente as atualizações propostas para colocar os parâmetros do componente do Altium Designer em sincronização com os da base de dados, com base nas ações de atualização que definiu no ficheiro de ligação intermédio (DBLink, DBLib, SVNDBLib).

As diferenças de parâmetros são distinguidas através da utilização de um ícone exclusivo inserido na célula relevante. Por exemplo, um triângulo azul no canto de uma célula significa que foi detetada uma diferença entre o valor de um parâmetro no componente do Altium Designer e o mesmo parâmetro no registo associado da base de dados.

Haverá uma listagem completa de todos os estados de célula disponíveis na caixa de diálogo Select Parameter Changes mais adiante nesta página na secção Estados de Atualização de Parâmetros.

Os controlos disponibilizados na caixa de diálogo Select Parameter Changes permitem-lhe controlar totalmente com que atualizações pretende prosseguir e quais rejeitar. Pode rejeitar atualizações a todos os parâmetros de um componente selecionado ou a parâmetros específicos desse componente. Para rejeitar uma atualização proposta para um parâmetro específico, selecione a célula relevante e clique no botão Reject Selected. Para repor a atualização, clique no botão Update Selected.

Quando estiver satisfeito com a solução de atualização, clique no botão Accept Changes (Create ECO). Utilize a caixa de diálogo Engineering Change Order que se abre para validar e depois executar as atualizações em conformidade. Se se aperceber de que existe uma atualização com a qual realmente não pretende prosseguir, desative a entrada da ordem de alteração aplicável.

A caixa de diálogo Engineering Change Order

Sincronização Dupla

Pode ter um projeto de design existente em que a maioria das peças colocadas tenha sido ligada a uma base de dados externa através de um ficheiro DbLink. As alterações ao design podem resultar em circuitaria adicional, cujos componentes podem ser colocados usando a funcionalidade Database Library. O ficheiro DbLib/SVNDbLib associado pode, muito plausivelmente, apontar para uma base de dados externa diferente.

Ao utilizar o comando Update Parameters From Database, todos os parâmetros ligados para componentes colocados serão consultados - em todas as bases de dados ligadas, independentemente do método de ligação utilizado - e as diferenças detetadas nesses parâmetros serão apresentadas na caixa de diálogo Select Parameter Changes dialog.

Atualização de Componentes de Esquemático a partir de Bibliotecas

O Altium Designer disponibiliza uma ferramenta para atualizar componentes colocados numa folha esquemática com informação modificada a partir de uma biblioteca de origem. Isto inclui Bibliotecas de Componentes Esquemáticos (*.SchLib), Bibliotecas Integradas (*.IntLib) e Bibliotecas de Base de Dados (*.DBLib, *.SVNDBLib).

Embora os ficheiros DBLib e SVNDBLib sejam apresentados como bibliotecas no painel Components panel, são apenas uma fonte de ligação e mapeamento de campos e não bibliotecas no verdadeiro sentido da palavra. A funcionalidade de atualização propaga alterações a parâmetros, referências de símbolos e de modelos na base de dados externa, bem como modificações gráficas efetuadas nas bibliotecas de símbolos e modelos referenciadas.

A funcionalidade de atualização permite-lhe propagar alterações a parâmetros, bem como a informação de modelos e gráfica.

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

As atualizações também são efetuadas a partir do documento 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 esquemática com informação modificada proveniente de uma biblioteca de origem.

A caixa de diálogo Update From Library

Definir o Âmbito da Atualização

A primeira página da caixa de diálogo trata do âmbito da atualização - que documentos esquemáticos de origem devem ser incluídos na atualização e os tipos específicos de componentes neles contidos.

A região Schematic Sheets da caixa de diálogo carregará todos os documentos esquemáticos possíveis aos quais a atualização pode ser aplicada. Pode tratar-se de um único documento esquemático livre ou de todas as folhas esquemáticas dentro do projeto ativo. Ative os documentos cujos componentes pretende que sejam considerados na atualização.

À medida que ativa/desativa entradas na lista Schematic Sheets utilizando caixas de verificação ou os comandos All On / All Off no menu de clique direito, os componentes físicos constituintes serão listados na região Component Types da caixa de diálogo. Cada componente é listado em termos de:

• Nome do componente físico
• Símbolo lógico associado
• Biblioteca de origem a partir da qual foi colocado
• Número de instâncias atualmente colocadas em todos os documentos esquemáticos ativados.

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

• Standard Components - os colocados a partir de uma biblioteca esquemática ou biblioteca integrada.
• Database Components - os colocados a partir de uma base de dados externa usando uma DBLib ou SVNDBLib.

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

Todos os tipos de componentes estão inicialmente ativados para inclusão na atualização. Desative quaisquer tipos que definitivamente não pretenda atualizar. Em alternativa, selecione os componentes exatos que pretende atualizar - diretamente na(s) folha(s) esquemática(s) - antes de entrar na caixa de diálogo. Depois ative a opção Selected Parts Only. Apenas esses componentes da sua seleção aparecerão listados. Também pode usar os comandos All On / All Off no menu de clique direito.

Utilize a opção Include Variants para incluir variantes e/ou a opção Update to Latest Revision para atualizar componentes colocados a partir de uma Workspace Library para as revisões mais recentes disponíveis. Utilize estas opções para atualizar parâmetros de componentes alternativos.

O principal a recordar é que tem sempre controlo total sobre o que é incluído na atualização.

Definir Ações de Atualização por Predefinição

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

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

A forma mais simples de atualização é substituir completamente os componentes na(s) folha(s) esquemática(s) pelos definidos na biblioteca de origem - Fully replace symbols on sheet with those from library. Os atributos gráficos, parâmetros e ligações de modelo são todos atualizados diretamente com a informação que existe na biblioteca de origem. Quando esta opção está selecionada, as seguintes opções são ativadas. Selecione todas as aplicáveis:

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

A substituição completa (Fully replace symbols on sheet with those from library) está ativada por predefinição. Se pretender um pouco mais de controlo sobre o que é atualizado, altere para Replace selected attributes of symbols on sheets. As opções de atualização individuais (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 da caixa de diálogo Library Update Settings são persistentes. São armazenadas no ficheiro do projeto ao guardar.

Para ações de atualização de parâmetros e modelos, é disponibilizado ainda mais controlo através da caixa de diálogo Library Update Settings. Aceda a esta caixa de diálogo clicando no botão Advanced. Não só pode definir as ações de atualização globais predefinidas para parâmetros e modelos usando esta caixa de diálogo, como também controlar que parâmetros e modelos específicos são incluídos na atualização.

Aceder à caixa de diálogo Library Update Settings

Depois de definir o âmbito da atualização conforme necessário, e as ações predefinidas a executar, pode clicar em Finish, depois rever e executar as alterações a implementar na subsequente Engineering Change Order que é gerada. Se pretender refinar ainda mais a atualização numa base por componente, antes de gerar a ECO, clique em Next para aceder à segunda página da caixa de diálogo, detalhada na secção seguinte.

Controlar a 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. Serão perdidas se 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 grelha detalhada, listando todas as instâncias de componentes envolvidas no processo de atualização pretendido. A página anterior da caixa de diálogo permitiu-lhe especificar, a um nível geral, que tipos de componentes físicos são incluídos na atualização. Esta página permite-lhe ajustar com precisão exatamente que instâncias de componentes desses tipos são atualizadas.

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

A grelha está dividida em três regiões:

• Schematic Parts - esta área lista a Designator, Comment, Physical Component, e Logical Symbol de cada componente colocado na(s) folha(s) esquemática(s). Ative a Update caixa de seleção para atualizar o componente selecionado.
• Library Components - esta área lista a Physical Component, Logical Symbol, Library Name, e Life Cycle State do componente da biblioteca para cada peça esquemática listada. Normalmente, esta é a mesma biblioteca de origem a partir da qual o componente foi originalmente colocado, mas também tem a possibilidade de alterar completamente o componente para outro, na mesma biblioteca ou numa biblioteca diferente. Os componentes que não podem ser encontrados nas bibliotecas atualmente disponíveis são listados como <Not Found>.
• Actions - as ações de atualização específicas necessárias para cada instância de componente para a qual a caixa Update  está marcada. Estas serão inicialmente definidas de acordo com as definições de ação predefinidas na primeira página da caixa de diálogo. Clique na caixa de seleção para ativar/desativar a ação para o componente selecionado ou utilize os comandos do menu do botão direito.
  • Full Replace - marque a caixa para efetuar uma substituição completa do(s) item(ns) selecionado(s).
  • Graphical - marque a caixa para efetuar uma atualização gráfica do(s) item(ns) selecionado(s).
  • Parameters - marque a caixa para atualizar os parâmetros do(s) item(ns) selecionado(s). Se existir pelo menos um componente com esta caixa de seleção ativada, pode clicar no botão Parameters Changes para controlar seletivamente as alterações ao nível dos parâmetros - saiba mais.
  • Models - marque a caixa para atualizar os modelos do(s) item(ns) selecionado(s).

Para cada componente, a entrada para o componente da biblioteca de origem será inicialmente a utilizada para colocar a instância do componente em primeiro lugar. Esta informação é obtida da região Library Link do painel Properties do componente colocado.

Especificar um Componente Alternativo

Normalmente, a atualização envolverá a propagação das alterações efetuadas ao componente físico original na biblioteca de origem para a(s) instância(s) colocada(s) desse mesmo componente físico na(s) folha(s) esquemática(s). Poderão existir ocasiões em que pretenda alterar completamente o componente físico colocado no design. Isto pode ser facilmente especificado como parte da atualização.

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 Available Filed-based Libraries do projeto, a entrada <Not Found> será introduzida nos campos Logical Symbol e Library Name. Neste caso, a atualização não será possível para essa instância de componente.

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

Em alternativa, selecione uma instância de componente na grelha e depois clique no botão Choose Component. Surge a caixa de diálogo Replace Component, a partir da qual pode procurar o componente de substituição pretendido em qualquer uma das bibliotecas atualmente disponíveis.

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

Quando é escolhido um componente válido, a informação relevante para o componente escolhido será introduzida na região Library Components da página, substituindo o componente original da biblioteca de origem.

Se pretender reverter para a biblioteca de origem original - mantendo o componente físico original - selecione a instância de componente na grelha e depois clique no botão Return Selected to Default.

Controlar Alterações de Parâmetros

As alterações individuais ao nível dos parâmetros para uma instância de componente só serão apresentadas se a opção Full Replace estiver desativada e a opção Parameters estiver ativada na região Actions da página. Se pretender consultar 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 para as instâncias de componentes com uma ação de atualização de parâmetros ativada. Na ilustração abaixo, repare que as instâncias de componentes C1, C3, C7 e C10 têm a sua ação de atualização de parâmetros desativada e, por isso, não aparecem na caixa de diálogo.

Aceder à caixa de diálogo Select Parameter Changes

Tal como com a ferramenta Update Parameters From Database, a caixa de diálogo listará todos os parâmetros mapeados para as instâncias de componentes ligadas a uma base de dados externa. Além disso, todos os parâmetros encontrados nas instâncias de componentes colocadas envolvidas na atualização de parâmetros também serão listados. Esta é uma diferença fundamental ao aceder à caixa de diálogo Select Parameter Changes entre estas duas ferramentas de atualização.

Mais uma vez, a caixa de diálogo mostra as alterações propostas a efetuar para voltar a colocar os parâmetros dos componentes colocados em sincronização com os dos componentes na biblioteca de origem ou base de dados relevante. As atualizações propostas estão de acordo com as ações de atualização definidas em:

• A região Parameter Settings da caixa de diálogo Library Update Settings quando a origem da atualização é uma biblioteca esquemática ou integrada.
• O ficheiro de ligação intermédio (*.DBLink, *.DBLib, *.SVNDBLib) quando a origem da atualização é uma base de dados.

As diferenças de parâmetros são destacadas através da utilização de um ícone único inserido na célula relevante. Consulte a secção seguinte (Parameter Update States) para obter uma lista completa de todos os estados possíveis das células.

Utilize os controlos disponíveis na caixa de diálogo (botões ou menu do botão direito) para determinar com que alterações de parâmetros pretende prosseguir e quais pretende rejeitar, dando-lhe o poder de substituir as condições de atualização predefinidas ao nível de cada parâmetro individual. Lembre-se de que rejeitar uma atualização proposta numa célula significa que não pretende que sejam efetuadas quaisquer alterações a esse parâmetro para essa instância específica do componente na folha esquemática.

Estados de Atualização de Parâmetros

Existem vários estados de atualização diferentes em que uma célula na caixa de diálogo Select Parameter Changes pode ser colocada, dependendo das diferenças exatas detetadas entre os componentes colocados e a biblioteca/base de dados de origem, bem como das ações de atualização de parâmetros aplicáveis especificadas. A tabela seguinte apresenta os possíveis estados da célula.

Cell State	Description
	O componente do Altium Designer e o componente na biblioteca/base de dados possuem ambos o parâmetro, e o valor é o mesmo. A atualização não provocará alterações.
	O componente do Altium Designer e o componente na biblioteca/base de dados possuem ambos o parâmetro, mas não tem qualquer valor atribuído. A atualização não provocará alterações.
	O componente do Altium Designer e o componente na biblioteca/base de dados não possuem o parâmetro. A atualização não provocará alterações. Este estado também pode surgir se o parâmetro no componente Altium estiver impedido de ser incluído numa atualização através da desativação das opções Allow Synchronization With Library e/ou Allow Synchronization With Database no painel Properties associado.
	O componente do Altium Designer e o componente na biblioteca/base de dados possuem ambos o parâmetro, mas com valores diferentes. A atualização atribuirá o valor da base de dados.
	O componente do Altium Designer e o componente na biblioteca/base de dados possuem ambos o parâmetro. No componente do Altium Designer, tem um valor atribuído; na base de dados, não tem. A atualização atribuirá o valor da base de dados; neste caso, sem valor.
	O componente do Altium Designer não possui o parâmetro, mas o componente na biblioteca/base de dados possui-o. 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 na biblioteca/base de dados possui-o. A atualização adicionará o parâmetro ao componente do Altium Designer sem qualquer valor inicialmente atribuído.
	O componente do Altium Designer possui o parâmetro, mas o componente na biblioteca/base de dados não o possui. A atualização removerá o parâmetro do componente do Altium Designer. Note: Se a instância do componente estiver a ser atualizada a partir de uma base de dados externa e o mapeamento relevante entre campo da base de dados e parâmetro de projeto estiver definido para, o parâmetro será tratado como se não existisse no registo da base de dados, mesmo que exista.
	Existe uma diferença entre os valores do parâmetro do componente do Altium Designer e do componente na biblioteca/base de dados. A proposta de atualização para o valor na base de dados foi rejeitada, com base no valor atual da opção Update Values no documento de ligação à base de dados (ficheiro DbLink, DbLib ou SvnDbLib). Não ocorrerá qualquer alteração. Note que os comandos Update Selected e Update All nesta caixa de diálogo substituirão este estado e forçarão uma atualização.
	O componente do Altium Designer não possui o parâmetro, mas o componente na biblioteca/base de dados possui-o. 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 . Não ocorrerá qualquer alteração. Note que os comandos Update Selected e Update All nesta caixa de diálogo substituirão este estado e forçarão uma atualização.
	O componente do Altium Designer possui o parâmetro, mas o componente na biblioteca/base de dados não o possui. 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 ligação à base de dados (ficheiro DbLink, DbLib ou SvnDbLib). Não ocorrerá qualquer alteração. Note que os comandos Update Selected e Update All nesta caixa de diálogo substituirão este estado e forçarão uma atualização.

Aplicar Alterações Diretamente a Partir do Editor de Bibliotecas Esquemáticas

A atualização direta de componentes esquemáticos colocados pode ser efetuada a partir de uma biblioteca esquemática de origem. Este método de atualização é particularmente adequado para a atualização de componentes que foram colocados a partir de bibliotecas isoladas de componentes esquemáticos (*.SchLib) e quando essas bibliotecas fazem parte das bibliotecas baseadas em ficheiros disponíveis para o projeto.

As modificações efetuadas aos componentes numa biblioteca esquemática de origem são transmitidas para o(s) documento(s) esquemático(s) através do comando Tools » Update Schematics, disponível nos menus principais do Editor de Bibliotecas Esquemáticas. Em alternativa, as alterações aos componentes selecionados podem ser aplicadas selecionando esses componentes no painel SCH Library panel e utilizando o comando de atualização no menu do botão direito.

A partir de uma biblioteca esquemática de origem, as alterações podem ser aplicadas utilizando o menu do botão direito do painel SCH Library

Todas as instâncias do(s) componente(s) colocado(s) em todos os documentos esquemáticos abertos serão atualizadas, independentemente do projeto a que um documento pertença. Essencialmente, se um componente colocado tiver a mesma entrada no seu campo Physical Component que o componente da biblioteca, será atualizado. Será informado sobre quantos componentes (e em quantos documentos) foram modificados pelo processo de atualização. A atualização consiste numa substituição completa de cada instância existente do componente pela da biblioteca.

Verificar uma Atualização

Depois de atualizar os componentes esquemáticos colocados, os componentes da biblioteca esquemática ou os PCB Footprints, irá naturalmente querer verificar se a atualização decorreu conforme planeado. As secções seguintes mostram como pode verificar rapidamente se os parâmetros, as ligações de modelo e os atributos gráficos foram atualizados com sucesso.

Verificar Atualizações de Parâmetros

Pode verificar se os parâmetros foram atualizados corretamente executando a caixa de diálogo Parameter Table Editor dialog (Tools » Parameter Manager) ou analisando os parâmetros de um componente selecionado através do painel Properties panel.

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

Verificar Atualizações de Ligações de Modelo

As atualizações às ligações de modelo de um componente podem ser verificadas na região Models do painel Properties associado.

Verificar Atualizações Gráficas

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