Bibliotecas de banco de dados

O Altium Designer permite inserir componentes diretamente de um banco de dados da empresa, criando e usando um Database Library. A inserção é realizada pelo painel Components, que, após a instalação da biblioteca de banco de dados, funciona como um navegador do seu banco de dados.

Após a inserção, as informações dos parâmetros do projeto podem ser sincronizadas entre os componentes inseridos e seus respectivos registros vinculados no banco de dados usando o comando Tools » Update Parameters From Database. Atualizações completas dos componentes — incluindo o símbolo gráfico, as referências de modelos e os parâmetros — podem ser realizadas usando o comando Tools » Update From Libraries. As informações paramétricas do banco de dados também podem ser incluídas na Lista de Materiais (BOM) final, pronta para a aquisição de componentes.

Inserção Direta — Além da Simples Vinculação

O Altium Designer oferece três métodos para vincular um componente a um banco de dados: usando um arquivo Database Link (*.DbLink), um arquivo Database Library (*.DbLib) ou um arquivo SVN Database Library (*.SVNDbLib), respectivamente. A abordagem DbLink oferece uma maneira eficiente de vincular e manter os componentes usados no seu projeto (ou nas bibliotecas) sincronizados com os dados inseridos no banco de dados. A abordagem DbLib/SVNDbLib aproveita essa eficiência comprovada de vinculação e acrescenta a liberdade de inserir um componente diretamente do banco de dados — essencialmente, criando o componente dinamicamente a partir das informações armazenadas para ele no registro correspondente do banco de dados.

Antes de nos aprofundarmos no recurso de biblioteca de banco de dados, vale a pena discutir as diferenças entre esses métodos quanto à forma de usá-los.

Vinculação usando um arquivo Database Link

Related page: Vinculação de Componentes Existentes ao Banco de Dados da Sua Empresa

• Neste método, o arquivo Database Link (*.DbLink) define o vínculo entre o componente do esquemático e um registro correspondente em um banco de dados. A correspondência do registro é estabelecida pela vinculação de campos-chave, que pode usar um único campo-chave (por exemplo, um código de peça) ou vários campos-chave (definindo uma cláusula Where).
• Neste método de vinculação, as informações de modelos e parâmetros do componente devem ser predefinidas como parte do componente de biblioteca do Altium Designer. O componente de biblioteca também deve incluir as informações necessárias dos campos-chave como parte de sua definição. Depois de definir isso, você adiciona um arquivo Database Link ao seu Pacote de Bibliotecas ou projeto e pode, então, sincronizar as informações do componente (parâmetros) com o conteúdo dos campos no banco de dados.
• Embora cada componente físico definido por cada registro do banco de dados não precise corresponder a um componente exclusivo da biblioteca do Altium Designer — muitos componentes do banco de dados podem compartilhar o mesmo símbolo de componente —, esse método de vinculação normalmente é usado com uma relação de "um registro de banco de dados para um componente do Altium Designer". O componente exclusivo do Altium Designer pode ser uma instância inserida em uma folha de esquemático ou um componente exclusivo em uma biblioteca de componentes.
• Na vinculação ao banco de dados do tipo DbLink, você inclui o arquivo Database Link no pacote de bibliotecas ou no projeto.

Vinculação usando um arquivo Database Library

• Neste método, o arquivo Database Library (*.DbLib) também define o vínculo entre o componente do esquemático e um registro correspondente em um banco de dados. Novamente, a correspondência do registro é estabelecida pela vinculação de campos-chave, que pode usar um único campo-chave (por exemplo, um código de peça) ou vários campos-chave (definindo uma cláusula Where).
• A principal diferença neste método de vinculação é que as informações de símbolo, modelos e parâmetros de um componente são armazenadas como parte da definição do registro desse componente no banco de dados externo. O componente do esquemático referenciado (armazenado em uma biblioteca de componentes subjacente (*.SchLib)) é apenas o símbolo; ele não possui modelos vinculados nem parâmetros de projeto definidos.
• Quando o componente é inserido, suas informações de parâmetros e modelos são criadas dinamicamente, usando os campos correspondentes no registro associado do banco de dados e de acordo com o mapeamento definido. Um ou mais desses parâmetros serão usados para manter um vínculo contínuo com o banco de dados, conforme os critérios de correspondência definidos, permitindo a sincronização futura após a inserção.
• Como cria componentes dinamicamente no momento da inserção, esse método de vinculação é especialmente adequado para uma relação de "vários registros de banco de dados para um componente do Altium Designer".
• Ao contrário da vinculação ao banco de dados do tipo DbLink, na qual o arquivo DbLink deve ser incluído no pacote de bibliotecas (ou no projeto), o arquivo DbLib/SVNDbLib não precisa ser adicionado ao projeto. A biblioteca de banco de dados (DbLib) é incluída nas Bibliotecas Disponíveis Baseadas em Arquivos, acessíveis pelo painel Components. Lembre-se de que as Bibliotecas Disponíveis Baseadas em Arquivos podem incluir Bibliotecas do Projeto, Bibliotecas Instaladas ou bibliotecas encontradas nos caminhos de pesquisa especificados.
• Normalmente, os arquivos DbLib/SVNDbLib são configurados com uma organização voltada a bibliotecas. Por exemplo, você pode ter um arquivo para todos os resistores detalhados no banco de dados da sua empresa, outro para capacitores e assim por diante.

DbLib versus SVNDbLib

Uma Biblioteca de Banco de Dados SVN é uma extensão do modelo de Biblioteca de Banco de Dados, com a diferença de que o símbolo e os modelos de origem são armazenados sob controle de versão.

As bibliotecas de origem são criadas, ampliadas e mantidas em um repositório baseado em Subversion. O vínculo com o repositório e com o banco de dados externo é definido em um arquivo SVN Database Library (*.SVNDbLib). E, como essa abordagem é uma extensão da Biblioteca de Banco de Dados, ela costuma ser chamada de Version-Controlled Database Library.

Bibliotecário ou Projetista?

Existem essencialmente dois modos de trabalhar com uma biblioteca de banco de dados sob controle de versão — como Librarian ou como Designer.

Como bibliotecário, você precisará não apenas configurar e manter o repositório externo de controle de versão das bibliotecas de símbolos e modelos, mas também será responsável por configurar o arquivo de biblioteca de banco de dados SVN. Isso envolve:

• Conectar-se ao banco de dados externo de componentes.
• Definir o mapeamento dos registros do banco de dados para os parâmetros/modelos dos componentes.
• Especificar o vínculo com o repositório SVN no qual as bibliotecas de símbolos e modelos são armazenadas.

Como projetista, você utilizará o arquivo SVNDbLib gerado pelo bibliotecário e o disponibilizará no painel Components — adicionando-o à lista de bibliotecas baseadas em arquivos disponíveis — para poder navegar pelos componentes do banco de dados e inseri-los no projeto.

A utilização dessas funções varia de empresa para empresa. Uma empresa maior pode ter um centro dedicado a bibliotecas que, na função de bibliotecário, se encarrega exclusivamente da configuração e manutenção das bibliotecas de símbolos e modelos no repositório de controle de versão e da geração dos arquivos de biblioteca de banco de dados SVN. Os arquivos SVNDbLib são então disponibilizados aos projetistas da empresa, que instalam e utilizam os arquivos de biblioteca para inserir componentes em seus projetos.

Em uma empresa menor, ambas as funções podem ser desempenhadas pela mesma pessoa. Essa pessoa não apenas configura e mantém o repositório de bibliotecas, mas também utiliza os arquivos SVNDbLib definidos em seu trabalho de projeto.

O repositório de controle de versão

Related article: Como usar o controle de versão externo

Os arquivos de biblioteca de símbolos e modelos precisam ser adicionados a um repositório Subversion (SVN). O Altium Designer inclui um provedor de controle de versão SVN, que é habilitado e configurado na página Data Management - Version Control da caixa de diálogo Preferences. Depois que o provedor de controle de versão SVN for habilitado, um repositório poderá ser criado na página Data Management - Design Repositories da caixa de diálogo Preferences.

Os repositórios SVN também podem ser criados e gerenciados fora do Altium Designer usando um cliente e um servidor SVN externos, como o TortoiseSVN. É possível conectar-se a um repositório existente na Data Management - Design Repositories página da caixa de diálogo Preferences.

Um ponto importante ao adicionar arquivos ao repositório é que cada símbolo e modelo must be stored in its own library file. Em uma biblioteca comum — que pode conter qualquer quantidade de símbolos/modelos —, alterar uma única entrada faria com que todas fossem marcadas pelo sistema de controle de versão como modificadas. Manter um símbolo/modelo por arquivo de biblioteca é adequado ao funcionamento do controle de versão, permitindo acompanhar exatamente o que foi modificado e o que não foi.

Para os fins deste documento, considera-se que o repositório já foi criado.

Como usar o assistente de divisão de bibliotecas

Se as bibliotecas de símbolos e modelos estiverem sendo criadas do zero, não haverá dificuldade em garantir apenas um símbolo/modelo por arquivo. No entanto, normalmente as bibliotecas de origem já existem. Para simplificar a tarefa de separar essas bibliotecas em arquivos com uma única entidade para adicioná-los ao repositório SVN, o Altium Designer oferece uma ferramenta de divisão — o Library Splitter Wizard. O assistente permite dividir rapidamente bibliotecas de esquemáticos (*.SchLib) e de PCB (*.PcbLib) com vários componentes em bibliotecas de componentes individuais. O assistente pode ser acessado pelo menu Tools no Editor de Bibliotecas de Esquemáticos, no Editor de Bibliotecas de PCB e no Editor de Bibliotecas de Banco de Dados SVN.

Divida as bibliotecas de origem em arquivos com um símbolo/modelo cada, usando o Library Splitter Wizard.

A configuração do processo de divisão envolve as seguintes etapas:

1. Adicionar os arquivos de biblioteca de origem que você deseja dividir (eles não precisam estar na mesma pasta). Use a página Libraries to Split para escolher as bibliotecas de esquemáticos ou de PCB que deseja dividir. Clique no botão Add para abrir uma caixa de diálogo na qual você pode localizar e adicionar as bibliotecas desejadas à lista. As bibliotecas adicionadas serão divididas em bibliotecas de componentes individuais posteriormente no assistente. As bibliotecas de origem não precisam estar na mesma pasta. Use o botão Remove para excluir uma biblioteca selecionada da lista.

   

2. Especificar o diretório de saída. A página Output Directories é usada para definir os diretórios de saída das bibliotecas de componentes individuais. O Output Directory listado é o caminho no qual as bibliotecas divididas serão colocadas. Clique em Change Output Directory para atualizar o diretório listado e selecionado, se necessário. Uma caixa de diálogo é aberta, na qual você pode localizar e selecionar a nova pasta para o diretório de saída.

   Por padrão, o diretório de saída será definido como o mesmo diretório em que a biblioteca de origem está armazenada. É preciso ter cuidado se todas as bibliotecas de origem estiverem armazenadas na mesma pasta. Se os diretórios de saída não forem especificados e permanecerem com seus valores padrão — apontando para a mesma pasta de origem —, você poderá acabar com uma grande mistura de bibliotecas de símbolos e modelos individuais. Separar esses arquivos ao criar a estrutura do repositório pode consumir muito tempo.

   

   Como os arquivos 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 desejada no repositório para os arquivos de símbolos/modelos. Depois de definir a estrutura, copie as bibliotecas de origem para suas respectivas pastas dentro dessa estrutura. Assim, você poderá manter as configurações padrão do diretório de saída de cada biblioteca de origem. Após a divisão, os arquivos de biblioteca individuais gerados já estarão nos locais corretos. Em seguida, você poderá excluir a biblioteca de origem original de cada pasta e adicionar as pastas ao repositório usando o cliente SVN escolhido.

3. Configurar opções adicionais para controlar como as bibliotecas de origem são divididas. Para uma biblioteca de componentes de esquemáticos, essas opções incluem a possibilidade de remover as informações de parâmetros e/ou modelos de cada componente, deixando apenas o símbolo.

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

   Você pode controlar como as bibliotecas são divididas usando a página Options . Use a lista suspensa (mostrada na imagem acima) para selecionar como os novos arquivos serão tratados. A escolha de Overwrite Existing Files (padrão) fará com que todos os arquivos recém-criados substituam os arquivos existentes. Se Append Incrementing Number To File Names for escolhido, o divisor de bibliotecas examinará todos os diretórios de saída selecionados na página anterior (Output Directories) e criará uma lista de arquivos a serem protegidos para que não sejam sobrescritos. As novas bibliotecas de componentes com o mesmo nome receberão o sufixo "_#Increment Number".

4. Após a especificação das bibliotecas de origem e das opções, o assistente realizará uma análise cujo resultado será o conjunto de bibliotecas de símbolo/modelo único que serão criadas, listadas para sua revisão. Será exibido o nome de cada biblioteca resultante da divisão a ser gerada, bem como o nome real do componente esquemático/modelo de footprint contido nessa biblioteca. A biblioteca de origem também será listada. O nome usado para uma biblioteca será o mesmo usado para o componente/modelo que a compõe.

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

   

   As bibliotecas de componentes que serão criadas podem ser revisadas na página Review. Os campos Splitted Library Name, Component Name e Source Library são listados para mostrar os novos arquivos que serão criados durante o processo de divisão. Uma lista suspensa com os dados de cada coluna pode ser acessada facilmente clicando na seta para baixo à direita de cada coluna. Esse recurso é especialmente útil ao revisar arquivos de bibliotecas extremamente grandes.

5. Revise a lista de bibliotecas a serem criadas e clique em Next para prosseguir com o processo de divisão e, por fim, obter as bibliotecas que serão adicionadas ao repositório de controle de versão. Após concluir o assistente com sucesso, clique em Finish para fechar.

   

Como usar o Assistente de Conversão de Bibliotecas de Banco de Dados SVN

Outra abordagem para converter bibliotecas existentes em uma biblioteca de banco de dados do tipo SVN é o Assistente de Conversão de Bibliotecas de Banco de Dados SVN. Esse assistente converte bibliotecas de esquemáticos, de PCB, de banco de dados e integradas em bibliotecas de banco de dados SVN. O assistente oferece diversas opções relacionadas à conversão, incluindo como as bibliotecas de origem devem ser divididas, em quais diretórios de qual repositório elas devem ser armazenadas e o diretório de saída para os arquivos SVNDbLib e de banco de dados MDB criados. 

O assistente pode ser acessado pelo menu Tools ao editar um documento de biblioteca de PCB ou de esquemáticos.

O assistente divide as bibliotecas de símbolos e footprints, faz o check-in delas em um repositório e cria os arquivos SVNDbLib e de banco de dados do Access.

Próximos passos

Consulte as páginas a seguir para saber mais sobre os diferentes aspectos do trabalho com bibliotecas de banco de dados:

• Como criar e definir a biblioteca de banco de dados
• Como modificar uma tabela de banco de dados
• Como modificar símbolos e footprints