Modificando símbolos e footprints

Além de manter o conteúdo na própria base de dados, existe também a necessidade de manter os símbolos e modelos referenciados, sempre que necessário. Isto implica fazer alterações aos símbolos esquemáticos e ao(s) modelo(s) de footprint. E, no caso de uma biblioteca de base de dados padrão (DbLib), às definições nos ficheiros de modelos de simulação.

Ambos os tipos de biblioteca de base de dados - padrão e com controlo de versões - disponibilizam a capacidade de aceder ao símbolo e ao modelo de footprint referenciados para edição, diretamente a partir da vista principal do documento DbLib/SVNDbLib, quando este está aberto como documento ativo. As secções seguintes mostram como o fazer, o que é um pouco mais elaborado, mas também um pouco mais poderoso, quando se utiliza uma SVNDbLib.

Ao utilizar uma DbLib

Para abrir o ficheiro de biblioteca do símbolo/modelo de footprint referenciado de um componente para edição, clique com o botão direito na entrada do componente no Table Browser e, em seguida, selecione o comando apropriado - Open Symbol ou Open Footprint - no menu de contexto. O ficheiro de biblioteca aplicável será aberto e o símbolo/footprint será apresentado como a entidade ativa no espaço de design, pronto para efetuar as suas edições.

Depois de efetuadas as alterações necessárias, guarde o ficheiro da biblioteca.

Exemplo de acesso ao símbolo referenciado de um componente de base de dados, diretamente a partir da DbLib.

Ao utilizar uma SVNDbLib

Como referido, a capacidade de aceder e editar os símbolos e modelos referenciados por componentes de base de dados, e acedidos através de um ficheiro SVNDbLib, é um pouco mais complexa, mas também mais poderosa. As alterações são feitas em cópias de trabalho locais das bibliotecas armazenadas no repositório SVN.

Especificar um espaço de trabalho local

Para fazer alterações aos símbolos dos componentes e aos modelos de footprint, terá de extrair os ficheiros do repositório para um diretório de trabalho local. Especifique o diretório necessário a utilizar na página Data Management - SVN Libraries page da caixa de diálogo Preferences. É definida uma localização predefinida para a pasta de trabalho - \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Altere-a conforme necessário, clicando no botão  para procurar uma pasta existente, ou introduzindo diretamente o caminho para a pasta.

Especificar um diretório de trabalho local.

Para extrair rapidamente 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 a partir do menu principal Tools do editor SVNDatabaseLib. As pastas extraídas serão as especificadas na área Models Location, no separador SVN Repository da caixa de diálogo Database Library Options dialog.

Um exemplo dos símbolos e footprints - armazenados no repositório SVN e especificados como parte de Database Library Options - extraídos para uma pasta de trabalho local.

Efetuar alterações

Depois de as bibliotecas de símbolos e modelos de footprint terem sido extraídas para a pasta de trabalho local designada, poderá então fazer alterações sempre que necessário. Isto implica fazer alterações à cópia local dos símbolos esquemáticos e dos modelos de footprint e, depois, submeter essas alterações novamente ao repositório SVN.

Tal como numa DbLib, estão disponíveis os seguintes métodos para aceder a um símbolo/modelo para edição:

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

• Se a SVNDbLib for adicionada à lista Available File-based Libraries, pode aceder aos comandos de edição diretamente através do painel Components panel. Selecione a entrada de componente pretendida e, em seguida, utilize o comando Edit Symbol (no menu de contexto do botão direito para a área Components ) ou o comando Edit Footprint (no menu de contexto do botão direito para a área Models ), respetivamente.
• Utilize o comando File » Open do editor de bibliotecas para procurar e abrir a biblioteca pretendida (na sua pasta de trabalho local).
• Arraste e largue o ficheiro da biblioteca (na sua pasta de trabalho local) a partir do Windows Explorer diretamente para o Altium Designer.

Em cada caso, depois de efetuadas as alterações necessárias, guarde o ficheiro da biblioteca.

No entanto, a interface principal entre as pastas e ficheiros extraídos para a pasta de trabalho local e o próprio repositório é o painel Storage Manager panel. Quando o ficheiro SVNDbLib é o documento ativo, o Storage Manager panel será preenchido com as pastas de símbolos e modelos extraídas para a pasta de trabalho local. As pastas listadas em concreto serão as especificadas na área Model Locations, no separador SVN Repository da caixa de diálogo Database Library Options.

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

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

Submeter alterações ao repositório

Panel page: Storage Manager

Embora existam diferentes formas de abrir uma biblioteca para edição, a submissão de quaisquer alterações efetuadas - a partir do within Altium Designer - só pode ser realizada através do painel Storage Manager panel.

Uma das coisas mais importantes a lembrar ao utilizar o Storage Manager panel é atualizar o estado da ligação entre as pastas/ficheiros de trabalho locais (apresentados no painel) e as pastas/ficheiros correspondentes no repositório de controlo de origem. Para uma biblioteca selecionada individualmente, isto é conseguido utilizando o comando Refresh, disponível no menu do botão direito na área All Files do painel. Para atualizar rapidamente o estado de uma pasta inteira, utilize o atalho de teclado Ctrl+F5.

As entradas de estado relevantes para trabalhar com as bibliotecas locais de símbolos e modelos são:

Ícone	Estado	Descrição
	No modification	A cópia local da biblioteca é idêntica à do repositório. Pode abrir livremente o ficheiro e fazer alterações.
	Out of date	A cópia local do ficheiro (na pasta de trabalho) é mais antiga do que a sua equivalente no repositório e, por isso, está desatualizada. Terá de obter a versão mais recente do ficheiro a partir do repositório - atualizando a sua própria cópia de trabalho local - antes de poder modificar e submeter as suas próprias alterações. Utilize o comando Update (no menu de contexto do botão direito) para obter o ficheiro mais recente a partir do repositório.
	Modified	A cópia local do ficheiro foi modificada no Altium Designer e guardada na pasta de trabalho. Para enviar as suas alterações locais para o repositório, clique com o botão direito na entrada do ficheiro e escolha o comando Commit no menu de contexto. Depois de submetido ao repositório, o estado regressará a No modification.
	Conflict	O ficheiro foi submetido por outro utilizador do Altium Designer antes de ter submetido a sua própria versão editada e guardada desse ficheiro. Utilize o comando Update ou Resolve para determinar qual a versão do ficheiro que passará a ser a revisão mais recente no repositório.
	Locked	O ficheiro foi bloqueado por si ou por outro utilizador. Um ficheiro bloqueado não pode ser atualizado para uma nova revisão no repositório por outro utilizador (a menos que seja forçado o seu desbloqueio). Este estado pode estar associado a outros ícones, como os de Modified  ou No Modification , quando essas condições de estado também se aplicam.

Comparação física de revisões

A comparação física pode ser efetuada entre quaisquer duas revisões do mesmo símbolo (biblioteca de modelos). Isto permite-lhe ver claramente, de forma visual, as alterações que foram feitas — entre revisões consecutivas ou não consecutivas do ficheiro.

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 vistas do histórico de um ficheiro selecionado, com regiões separadas para as Revisões VCS e o Histórico Local.

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

Assim que o comando Compare for invocado, as duas revisões selecionadas do documento serão abertas lado a lado na área de trabalho, a comparação gráfica será efetuada e quaisquer diferenças detetadas entre ambas serão listadas no painel Differences.

Comparação gráfica diretamente no espaço de desenho do editor da biblioteca.