Bibliotecas de banco de dados

O Altium Designer oferece a capacidade de colocar componentes diretamente a partir de uma base de dados da empresa, através da criação e utilização de uma Database Library. A colocação é efetuada a partir do painel Components que, após a instalação da biblioteca de base de dados, funciona como um navegador da sua base de dados.

Após a colocação, a informação dos parâmetros de desenho pode ser sincronizada entre os componentes colocados e os respetivos registos ligados na base de dados, utilizando o comando Tools » Update Parameters From Database. As atualizações completas do componente — incluindo o símbolo gráfico, as referências de modelo e os parâmetros — podem ser executadas com o comando Tools » Update From Libraries. A informação paramétrica da base de dados também pode ser incluída na Lista de Materiais (BOM) final, pronta para a aquisição de componentes.

Colocação Direta - Muito Além da Simples Ligação

O Altium Designer disponibiliza três métodos de ligação entre um componente e uma base de dados — utilizando, respetivamente, um ficheiro Database Link (*.DbLink), um ficheiro Database Library (*.DbLib) ou um ficheiro SVN Database Library (*.SVNDbLib). A abordagem DbLink fornece um meio eficiente de ligar e manter sincronizados com os dados introduzidos na base de dados os componentes utilizados no seu desenho (ou bibliotecas). A abordagem DbLib/SVNDbLib pega nesta comprovada eficiência de ligação e acrescenta-lhe a liberdade de poder colocar um componente diretamente a partir da base de dados — criando, na prática, o componente dinamicamente a partir da informação armazenada no registo correspondente da base de dados.

Antes de entrar mais a fundo na funcionalidade de biblioteca de base de dados, vale a pena discutir as diferenças entre estes métodos no que diz respeito à forma como são utilizados.

Ligação através de um ficheiro Database Link

Related page: Ligar Componentes Existentes à Base de Dados da Sua Empresa

• Utilizando este método, o ficheiro Database Link (*.DbLink) define a ligação entre o componente esquemático e um registo correspondente numa base de dados. A correspondência do registo é estabelecida por ligação de campo-chave, que pode ser um único campo-chave (por exemplo, um número de peça) ou vários campos-chave (através da definição de uma cláusula Where).
• Com este método de ligação, a informação de modelo e parâmetros do componente tem de estar previamente definida como parte do componente de biblioteca do Altium Designer. O componente de biblioteca também tem de incluir a informação necessária do campo-chave como parte da sua definição. Depois de isto estar definido, adiciona um ficheiro Database Link ao seu Package de Biblioteca, ou projeto de desenho, e depois poderá sincronizar a informação do componente (parâmetros) com o conteúdo dos campos da base de dados.
• Embora cada componente físico definido por cada registo da base de dados não precise de corresponder a um componente único de biblioteca do Altium Designer — muitos componentes da base de dados podem partilhar o mesmo símbolo de componente — este método de ligação seria normalmente utilizado numa lógica de "um registo da base de dados para um componente do Altium Designer". O componente único do Altium Designer pode ser uma instância colocada numa folha esquemática ou um componente único numa biblioteca de componentes.
• Com a ligação a bases de dados no estilo DbLink, inclui o ficheiro Database Link com o package da biblioteca ou com o projeto de desenho.

Ligação através de um ficheiro Database Library

• Utilizando este método, o ficheiro Database Library (*.DbLib) também define a ligação entre o componente esquemático e um registo correspondente numa base de dados. Mais uma vez, a correspondência do registo é estabelecida por ligação de campo-chave, que pode ser um único campo-chave (por exemplo, um número de peça) ou vários campos-chave (através da definição de uma cláusula Where).
• A principal diferença neste método de ligação é que a informação do símbolo do componente, do modelo e dos parâmetros de um componente é armazenada como parte da definição do registo desse componente na base de dados externa. O componente esquemático referenciado (armazenado numa biblioteca de componentes subjacente (*.SchLib)) é apenas o símbolo; não tem modelos associados nem parâmetros de desenho definidos.
• Quando o componente é colocado, a sua informação de parâmetros e de modelo é criada em tempo real, utilizando os campos correspondentes no registo da base de dados coincidente e de acordo com o mapeamento definido. Um ou mais destes parâmetros serão depois utilizados para manter uma ligação contínua à base de dados, conforme os critérios de correspondência definidos, permitindo sincronização futura após a colocação.
• Este método de ligação, devido à sua criação dinâmica de componentes no momento da colocação, presta-se muito bem a ser utilizado numa lógica de "muitos registos da base de dados para um componente do Altium Designer".
• Ao contrário do estilo DbLink de ligação a bases de dados, em que o ficheiro DbLink tem de ser incluído com o package da biblioteca (ou projeto de desenho), o ficheiro DbLib/SVNDbLib não precisa de ser adicionado ao projeto. A biblioteca de base de dados (DbLib) é incluída nas Bibliotecas Disponíveis Baseadas em Ficheiros — acessíveis através do painel Components. Lembre-se de que as Bibliotecas Disponíveis Baseadas em Ficheiros podem consistir em Bibliotecas de Projeto, Bibliotecas Instaladas ou bibliotecas encontradas ao longo de caminhos de pesquisa especificados.
• Normalmente, configuraria os ficheiros DbLib/SVNDbLib numa lógica orientada para bibliotecas. Por exemplo, poderá ter um para todas as resistências detalhadas na base de dados da sua empresa, outro para condensadores, e assim sucessivamente.

DbLib vs SVNDbLib

Uma SVN Database Library é uma extensão do modelo Database Library, com a diferença de que o símbolo de origem e os modelos são armazenados sob controlo de versões.

As bibliotecas de origem são criadas, complementadas e mantidas dentro de um repositório baseado em Subversion. A ligação ao repositório, e à base de dados externa, é definida num ficheiro SVN Database Library (*.SVNDbLib). E, uma vez que esta abordagem é uma extensão da Database Library, é frequentemente referida como uma Version-Controlled Database Library.

Bibliotecário ou Designer?

Existem essencialmente dois modos em que pode trabalhar com uma biblioteca de base de dados sob controlo de versões — como Librarian ou como Designer.

Como Bibliotecário, não só terá de configurar e manter o repositório externo de controlo de origem das bibliotecas de símbolos e modelos, como também será responsável por configurar o ficheiro SVN Database Library. Isto implica:

• Ligar à base de dados externa de componentes.
• Definir o mapeamento entre registos da base de dados e parâmetros/modelos dos componentes.
• Especificar a ligação ao repositório SVN no qual as bibliotecas de símbolos e modelos estão armazenadas.

Como Designer, utilizará o ficheiro SVNDbLib gerado pelo Bibliotecário e torná-lo-á disponível no painel Components — adicionando-o à lista de Bibliotecas Disponíveis Baseadas em Ficheiros — para poder navegar e colocar os componentes da base de dados.

A utilização destes papéis varia de empresa para empresa. Uma empresa maior pode ter um centro de bibliotecas dedicado que, no papel de Bibliotecário, estará exclusivamente envolvido na configuração e manutenção das bibliotecas de símbolos e modelos no repositório de controlo de origem e na geração do(s) ficheiro(s) SVN Database Library. O(s) ficheiro(s) SVNDbLib será(ão) então disponibilizado(s) ao(s) Designer(s) dessa empresa, que instalarão e utilizarão os ficheiros de biblioteca a partir dos quais colocarão os componentes nos seus desenhos.

Numa empresa mais pequena, ambos os papéis podem ser desempenhados pela mesma pessoa. Essa pessoa não só configurará e manterá o repositório de bibliotecas, como também utilizará o(s) SVNDbLib definido(s) no seu trabalho de desenho.

O Repositório de Controlo de Origem

Related article: Utilização de Controlo de Versões Externo

Os ficheiros de biblioteca de símbolos e modelos têm de ser adicionados a um repositório Subversion (SVN). O Altium Designer inclui um Fornecedor de Controlo de Versões SVN, que é ativado e configurado na página Data Management - Version Control page da caixa de diálogo Preferences. Depois de o Fornecedor de Controlo de Versões SVN estar ativado, pode ser criado um repositório na página Data Management - Design Repositories da caixa de diálogo Preferences.

Os repositórios SVN também podem ser criados e geridos fora do Altium Designer utilizando um cliente e servidor SVN externos, como o TortoiseSVN. Um repositório existente pode ser ligado na página Data Management - Design Repositories da caixa de diálogo Preferences.

Um aspeto importante a ter em conta ao adicionar ficheiros ao repositório é que cada símbolo e modelo must be stored in its own library file. Numa biblioteca normal — que pode conter qualquer número de símbolos/modelos — a alteração de uma única entrada faria com que todos fossem assinalados pelo sistema de controlo de versões como tendo sido modificados. Ter um símbolo/modelo por ficheiro de biblioteca adapta-se à natureza do controlo de versões, permitindo-lhe acompanhar exatamente o que foi modificado e o que não foi.

Para efeitos deste documento, assume-se que o repositório já foi criado.

Utilizar o Assistente de Divisão de Bibliotecas

Se as bibliotecas para os símbolos e modelos estiverem a ser criadas de novo, não há problema em garantir apenas um símbolo/modelo por ficheiro. No entanto, normalmente, as bibliotecas de origem já existirão. Para simplificar a tarefa de separar estas bibliotecas em ficheiros de entidade única para adição ao repositório SVN, o Altium Designer disponibiliza uma ferramenta de divisão — o Library Splitter Wizard. O assistente permite-lhe dividir rapidamente bibliotecas esquemáticas multi-componente (*.SchLib) e bibliotecas PCB (*.PcbLib) em bibliotecas de componentes individuais. O assistente está acessível a partir do menu Tools no Editor de Bibliotecas Esquemáticas, no Editor de Bibliotecas PCB e no Editor de Bibliotecas de Base de Dados SVN.

Divida as bibliotecas de origem em um símbolo/modelo por ficheiro, utilizando o Library Splitter Wizard.

A configuração do processo de divisão envolve os seguintes passos:

1. Adicionar os ficheiros de biblioteca de origem necessários que pretende dividir (estes não precisam de estar na mesma pasta). Utilize a página Libraries to Split para escolher a(s) biblioteca(s) esquemática(s) ou PCB que pretende dividir. Clique no botão Add para aceder a uma caixa de diálogo onde pode procurar e adicionar a(s) biblioteca(s) pretendida(s) à lista. As bibliotecas adicionadas serão posteriormente divididas em bibliotecas de componentes individuais no Assistente. As bibliotecas de origem não precisam de existir na mesma pasta. Utilize o botão Remove para eliminar uma biblioteca selecionada da lista.

   

2. Especificar a diretoria de saída. A página Output Directories é utilizada para definir a(s) diretoria(s) de saída para as bibliotecas de componentes individuais. A Output Directory listada é o caminho onde as bibliotecas divididas serão colocadas. Clique em Change Output Directory para atualizar a diretoria listada e selecionada, se necessário. Abre-se uma caixa de diálogo onde pode procurar e selecionar a pasta atualizada para a diretoria de saída.

   Por predefinição, a diretoria de saída será definida para a mesma diretoria em que a biblioteca de origem está armazenada. Deve ter-se cuidado se as bibliotecas de origem originais estiverem todas armazenadas na mesma pasta de diretoria de origem. Se as diretorias de saída não forem especificadas e forem deixadas com os valores predefinidos — apontando para a mesma pasta de diretoria de origem — poderá acabar com uma mistura muito grande de bibliotecas de símbolo e modelo individuais. Filtrar estas bibliotecas ao criar a estrutura do repositório poderá revelar-se muito moroso.

   

   Como os ficheiros de biblioteca divididos serão adicionados ao repositório SVN, pode ser uma boa ideia configurar localmente no disco rígido a estrutura de pastas que pretende ter no repositório — em termos dos ficheiros de símbolo/modelo. Depois de a estrutura estar definida, copie as bibliotecas de origem para as respetivas pastas dentro dessa estrutura. Depois, pode simplesmente deixar as definições da diretoria de saída de cada biblioteca de origem com os valores predefinidos. Após a divisão, os ficheiros de biblioteca individual gerados já estarão nas localizações corretas. Poderá então eliminar a biblioteca de origem original de cada pasta e adicionar as pastas ao repositório, utilizando o cliente SVN que tiver decidido usar.

3. Configure opções adicionais para controlar a forma como as bibliotecas de origem são divididas. Estas incluem, para uma biblioteca de componentes esquemáticos, opções que lhe permitem remover a informação de parâmetros e/ou de modelos de cada componente constituinte — deixando apenas o símbolo simples.

    
   Duas iterações da página Split Libraries; à esquerda: a página Split Libraries ao converter um ficheiro .PCBLib . À direita: a página Split Libraries ao converter um ficheiro .SCHLib .

   Pode controlar a forma como as bibliotecas são divididas utilizando a página Options . Utilize a lista pendente (mostrada na imagem acima) para selecionar como os novos ficheiros são tratados. Escolher Overwrite Existing Files (predefinição) fará com que quaisquer ficheiros recém-criados substituam quaisquer ficheiros existentes. Se for escolhido Append Incrementing Number To File Names , o divisor de bibliotecas irá analisar todas as diretorias de saída selecionadas na página anterior (Output Directories) e criar uma lista de ficheiros a proteger, para que não sejam substituídos. As novas bibliotecas de componentes com o mesmo nome terão o sufixo "_#Increment Number" acrescentado.

4. Depois de especificadas as bibliotecas de origem e as opções, o assistente efetuará uma análise, cujo resultado é o conjunto de bibliotecas de símbolo/modelo único que serão criadas, listadas para sua revisão. É apresentado o nome de cada biblioteca dividida a gerar, bem como o nome real do componente esquemático/modelo de footprint dentro dessa biblioteca. A biblioteca de origem original também é listada. O nome utilizado para uma biblioteca será o mesmo que o utilizado para o componente/modelo constituinte.

   Se algum dos seguintes caracteres tiver sido utilizado no nome do componente/modelo, será substituído por um sublinhado ao criar o nome da biblioteca: '\', '/', '!', ''', '[', ']'.

   

   As bibliotecas de componentes que serão criadas podem ser revistas na página Review. O Splitted Library Name, Component Name e Source Library são listados para mostrar os novos ficheiros que serão criados durante o processo de divisão. Pode aceder facilmente a uma lista pendente dos dados em cada coluna clicando na seta para baixo no lado direito de cada coluna. Esta funcionalidade é especialmente útil ao rever ficheiros de bibliotecas extremamente grandes.

5. Reveja a lista de bibliotecas a criar e, em seguida, clique em Next para prosseguir com o processo de divisão e, por fim, obter as bibliotecas a adicionar ao repositório de controlo de código-fonte. Depois de concluir o Assistente com êxito, clique em Finish para fechar.

   

Utilizar o Assistente de Conversão de Bibliotecas de Base de Dados SVN

Outra abordagem para converter bibliotecas existentes numa biblioteca de base de dados do tipo SVN é o SVN Database Library Conversion Wizard. Este Assistente converte bibliotecas esquemáticas, PCB, de base de dados e integradas em bibliotecas de base de dados SVN. O Assistente tem várias opções relacionadas com a conversão, incluindo a forma como as bibliotecas de origem devem ser divididas, em que diretorias de que repositório devem ser armazenadas e a diretoria de saída para o ficheiro SVNDbLib criado e para o ficheiro de base de dados MDB. 

O assistente está acessível a partir do menu Tools ao editar um documento de biblioteca PCB ou esquemática.

O Assistente divide bibliotecas de símbolos e footprints e faz o check-in destas num repositório, além de criar os ficheiros SVNDbLib e da base de dados Access.

Para onde seguir?

Consulte as seguintes páginas para saber mais sobre diferentes aspetos do trabalho com bibliotecas de base de dados:

• Creating & Defining the Database Library
• Modifying a Database Table
• Modifying Symbols & Footprints