Modificando símbolos e footprints

Além de manter o conteúdo do próprio banco de dados, também é necessário manter os símbolos e modelos referenciados, conforme a necessidade. Isso envolve modificar os símbolos esquemáticos e os modelos de footprint. E, no caso de uma biblioteca de banco de dados padrão (DbLib), as definições nos arquivos de modelos de simulação.

Ambos os tipos de biblioteca de banco de dados — padrão e com controle de versão — permitem acessar o símbolo e o modelo de footprint referenciados para edição, diretamente na visualização principal do documento DbLib/SVNDbLib, quando ele está aberto como documento ativo. As seções a seguir mostram como fazer isso, um processo um pouco mais complexo, mas também mais poderoso, ao usar uma SVNDbLib.

Ao usar uma DbLib

Para abrir o arquivo de biblioteca do símbolo/modelo de footprint referenciado de um componente para edição, clique com o botão direito do mouse na entrada do componente em Table Browser e selecione o comando apropriado — Open Symbol ou Open Footprint — no menu de contexto. O arquivo de biblioteca correspondente será aberto, e o símbolo/footprint será apresentado como a entidade ativa no espaço de projeto, pronto para ser editado.

Após fazer as alterações necessárias, salve o arquivo de biblioteca.

Exemplo de acesso ao símbolo referenciado de um componente do banco de dados, diretamente pela DbLib.

Ao usar uma SVNDbLib

Como mencionado, a capacidade de acessar e editar os símbolos e modelos referenciados por componentes do banco de dados e acessados por meio de um arquivo SVNDbLib é um pouco mais complexa, mas também mais poderosa. As modificações são feitas em cópias de trabalho locais das bibliotecas armazenadas no repositório SVN.

Especificação de um espaço de trabalho local

Para modificar os símbolos dos componentes e os modelos de footprint, você precisará fazer o checkout dos arquivos do repositório para um diretório de trabalho local. Especifique o diretório a ser usado na página Gerenciamento de dados - Bibliotecas SVN da caixa de diálogo Preferences. Um local padrão para a pasta de trabalho está definido — \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Altere-o conforme necessário clicando no botão  para procurar uma pasta existente ou inserindo diretamente o caminho da pasta.

Especificação de um diretório de trabalho local.

Para fazer rapidamente o checkout de todas as bibliotecas de símbolos e modelos de footprint do repositório para a pasta de trabalho local designada, execute o comando Check Out All Working Folders no menu principal Tools do editor SVNDatabaseLib. As pastas cujo checkout será realizado serão aquelas especificadas na região Models Location, na guia SVN Repository da caixa de diálogo Opções da biblioteca de banco de dados.

Exemplo de símbolos e footprints — armazenados no repositório SVN e especificados como parte de Database Library Options — cujo checkout foi realizado para uma pasta de trabalho local.

Como fazer alterações

Após fazer o checkout das bibliotecas de símbolos e modelos de footprint para a pasta de trabalho local designada, você poderá fazer modificações conforme necessário. Isso envolve modificar a cópia local dos símbolos esquemáticos e modelos de footprint e, em seguida, fazer o commit dessas alterações no repositório SVN.

Assim como em uma DbLib, estão disponíveis os seguintes métodos para acessar um símbolo/modelo para edição:

• No documento SVNDbLib, clique com o botão direito do mouse na entrada do componente em Table Browser e selecione o comando apropriado — Open Symbol ou Open Footprint — no menu de contexto.

• Se a SVNDbLib for adicionada à lista de bibliotecas baseadas em arquivos disponíveis, você poderá acessar os comandos de edição diretamente pelo painel Componentes. Selecione a entrada do componente desejado e use o comando Edit Symbol (no menu de contexto exibido ao clicar com o botão direito do mouse na região Components ) ou o comando Edit Footprint (no menu de contexto exibido ao clicar com o botão direito do mouse na região Models ), respectivamente.
• Use o comando File » Open do editor de bibliotecas para localizar e abrir a biblioteca necessária (na sua pasta de trabalho local).
• Arraste e solte o arquivo de biblioteca (na sua pasta de trabalho local) do Explorador de Arquivos do Windows diretamente no Altium Designer.

Em cada caso, após fazer as alterações necessárias, salve o arquivo de biblioteca.

No entanto, a principal interface entre as pastas e os arquivos cujo checkout foi realizado para a pasta de trabalho local e o próprio repositório é o painel Gerenciador de armazenamento. Quando o arquivo SVNDbLib é o documento ativo, o painel Storage Manager é preenchido com as pastas de símbolos e modelos cujo checkout foi realizado para a pasta de trabalho local. As pastas listadas serão exatamente aquelas especificadas na região Model Locations, na guia SVN Repository da caixa de diálogo Database Library Options.

O painel Storage Manager reflete a pasta de trabalho local — desde que o arquivo SVNDbLib seja o documento ativo no Altium Designer.

Para abrir um arquivo de biblioteca para edição, clique com o botão direito do mouse na sua entrada na região All Files do painel e escolha Open no menu de contexto exibido. Faça as alterações necessárias e salve o arquivo normalmente usando o comando padrão Save do editor associado.

Como fazer o commit das alterações no repositório

Panel page: Gerenciador de armazenamento

Embora existam diferentes maneiras de abrir uma biblioteca para edição, o commit de quaisquer alterações feitas — a partir de within Altium Designer — só pode ser realizado por meio do painel Gerenciador de armazenamento.

Um dos pontos mais importantes a lembrar ao usar o painel Storage Manager é atualizar o status do vínculo entre as pastas e os arquivos de trabalho locais (exibidos no painel) e as pastas e os arquivos correspondentes no repositório de controle de versão. Para uma biblioteca selecionada individualmente, isso é feito usando o comando Refresh, disponível no menu de contexto da região All Files do painel. Para atualizar rapidamente o status de uma pasta inteira, use o atalho de teclado Ctrl+F5.

Os status pertinentes ao trabalho com as bibliotecas locais de símbolos e modelos são:

Ícone	Status	Descrição
	No modification	A cópia local da biblioteca é idêntica à do repositório. Você pode abrir o arquivo e fazer modificações livremente.
	Out of date	A cópia local do arquivo (na pasta de trabalho) é mais antiga que sua versão correspondente no repositório e, portanto, está desatualizada. Você precisará obter a versão mais recente do arquivo no repositório — atualizando sua própria cópia de trabalho local — antes de poder modificar e enviar suas próprias alterações. Use o comando Update (no menu de contexto acessado com o botão direito do mouse) para obter o arquivo mais recente do repositório.
	Modified	A cópia local do arquivo foi modificada no Altium Designer e salva na pasta de trabalho. Para enviar suas alterações locais ao repositório, clique com o botão direito do mouse na entrada do arquivo e escolha o comando Commit no menu de contexto. Após o envio ao repositório, o status retornará para No modification.
	Conflict	O arquivo foi enviado por outro usuário do Altium Designer antes de você enviar sua própria versão editada e salva desse arquivo. Use o comando Update ou Resolve para determinar qual versão do arquivo se tornará a revisão mais recente no repositório.
	Locked	O arquivo foi bloqueado por você ou por outro usuário. Um arquivo bloqueado não pode ser atualizado para uma nova revisão no repositório por outro usuário (a menos que seu desbloqueio seja forçado). Esse estado pode estar associado a outros ícones, como os de Modified  ou No Modification , quando essas condições de status também se aplicarem.

Comparação física de revisões

A comparação física pode ser realizada entre quaisquer duas revisões do mesmo símbolo (biblioteca de modelos). Isso permite visualizar claramente as alterações feitas entre revisões consecutivas ou não consecutivas do arquivo.

No painel Storage Manager, a comparação é realizada a partir da região VCS Revisions, na parte inferior do painel.

O painel Storage Manager apresenta duas visualizações do histórico de um arquivo selecionado, com regiões separadas para as revisões do VCS e o histórico local.

A comparação pode ser feita entre quaisquer duas revisões. Usando a técnica de seleção Ctrl+click do Windows, selecione as duas revisões da biblioteca que deseja comparar na região VCS Revisions do painel, clique com o botão direito do mouse e escolha Compare.

Assim que o comando Compare for acionado, as duas revisões selecionadas do documento serão abertas lado a lado na área de trabalho, a comparação gráfica será realizada e todas as diferenças detectadas entre elas serão listadas no painel Differences.

Comparação gráfica diretamente no espaço de projeto do editor de bibliotecas.