Modifying Symbols & Footprints

Oltre a mantenere il contenuto all'interno del database stesso, è necessario anche mantenere i simboli e i modelli referenziati, quando necessario. Ciò comporta la modifica dei simboli schematici e dei modelli di footprint. E, per una libreria di database standard (DbLib), delle definizioni nei file dei modelli di simulazione.

Entrambi i tipi di libreria di database, standard e con controllo di versione, consentono di accedere al simbolo e al modello di footprint referenziati per modificarli direttamente dalla vista principale del documento DbLib/SVNDbLib quando questo è aperto come documento attivo. Le sezioni seguenti illustrano come farlo; l'operazione è leggermente più articolata, ma anche un po' più potente, quando si utilizza un'SVNDbLib.

Quando si utilizza una DbLib

Per aprire in modifica il file di libreria del simbolo/modello di footprint referenziato da un componente, fare clic con il pulsante destro sulla voce del componente nel Table Browser, quindi selezionare il comando appropriato, Open Symbol oppure Open Footprint, dal menu contestuale. Verrà aperto il file di libreria applicabile e il simbolo/footprint verrà presentato come entità attiva nello spazio di progettazione, pronto per essere modificato.

Una volta apportate le modifiche necessarie, salvare il file di libreria.

Esempio di accesso al simbolo referenziato di un componente di database direttamente dall'interno della DbLib.

Quando si utilizza un'SVNDbLib

Come accennato, la possibilità di accedere e modificare i simboli e i modelli referenziati dai componenti di database, e accessibili tramite un file SVNDbLib, è un po' più complessa, ma anche più potente. Le modifiche vengono apportate a copie di lavoro locali delle librerie archiviate nel repository SVN.

Specificare un'area di lavoro locale

Per modificare i simboli dei componenti e i modelli di footprint, sarà necessario estrarre i file dal repository in una directory di lavoro locale. Specificare la directory richiesta nella pagina Data Management - SVN Libraries page della finestra di dialogo Preferences. È definita una posizione predefinita per la cartella di lavoro: \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Modificarla secondo necessità facendo clic sul pulsante  per cercare una cartella esistente oppure inserendo direttamente il percorso della cartella.

Specificare una directory di lavoro locale.

Per estrarre rapidamente tutte le librerie di simboli e modelli di footprint dal repository nella cartella di lavoro locale designata, eseguire il comando Check Out All Working Folders dal menu principale Tools dell'editor SVNDatabaseLib. Le cartelle estratte saranno quelle specificate nell'area Models Location, nella scheda SVN Repository della finestra di dialogo Database Library Options dialog.

Un esempio dei simboli e dei footprint, archiviati nel repository SVN e specificati come parte di Database Library Options, estratti in una cartella di lavoro locale.

Apportare modifiche

Una volta che le librerie dei simboli e dei modelli di footprint sono state estratte nella cartella di lavoro locale designata, è possibile apportare modifiche quando necessario. Ciò comporta la modifica della copia locale dei simboli schematici e dei modelli di footprint, quindi il commit di tali modifiche nel repository SVN.

Come per una DbLib, sono disponibili i seguenti metodi per accedere a un simbolo/modello da modificare:

• All'interno del documento SVNDbLib, fare clic con il pulsante destro sulla voce del componente nel Table Browser, quindi selezionare il comando appropriato, Open Symbol oppure Open Footprint, dal menu contestuale.

• Se l'SVNDbLib viene aggiunta all'elenco Available File-based Libraries, è possibile accedere direttamente ai comandi di modifica tramite il Components panel. Selezionare la voce del componente richiesta, quindi usare rispettivamente il comando Edit Symbol (nel menu contestuale accessibile con il pulsante destro per l'area Components ) oppure il comando Edit Footprint (nel menu contestuale accessibile con il pulsante destro per l'area Models ).
• Usare il comando File » Open dell'editor di libreria per individuare e aprire la libreria richiesta (nella cartella di lavoro locale).
• Trascinare il file di libreria (nella cartella di lavoro locale) da Esplora risorse di Windows direttamente in Altium Designer.

In ogni caso, una volta apportate le modifiche necessarie, salvare il file di libreria.

Tuttavia, l'interfaccia principale tra le cartelle e i file estratti nella cartella di lavoro locale e il repository stesso è il Storage Manager panel. Quando il file SVNDbLib è il documento attivo, il Storage Manager panel mostrerà le cartelle di simboli e modelli estratte nella cartella di lavoro locale. Le cartelle elencate saranno esattamente quelle specificate nell'area Model Locations, nella scheda SVN Repository della finestra di dialogo Database Library Options.

Il pannello Storage Manager riflette la cartella di lavoro locale, a condizione che il file SVNDbLib sia il documento attivo in Altium Designer.

Per aprire un file di libreria in modifica, fare clic con il pulsante destro sulla relativa voce nell'area All Files del pannello e scegliere Open dal menu contestuale visualizzato. Apportare le modifiche necessarie e salvare il file normalmente utilizzando il comando standard Save dell'editor associato.

Eseguire il commit delle modifiche nel repository

Panel page: Storage Manager

Sebbene esistano diversi modi per aprire una libreria per la modifica, il commit di eventuali modifiche apportate, da within Altium Designer, può essere eseguito solo tramite il Storage Manager panel.

Una delle cose più importanti da ricordare quando si utilizza il Storage Manager panel è aggiornare lo stato del collegamento tra le cartelle/i file della copia di lavoro locale (visualizzati nel pannello) e le cartelle/i file corrispondenti nel repository di controllo del codice sorgente. Per una singola libreria selezionata, ciò si ottiene usando il comando Refresh, disponibile dal menu contestuale accessibile con il pulsante destro nell'area All Files del pannello. Per aggiornare rapidamente lo stato di un'intera cartella, usare la scorciatoia da tastiera Ctrl+F5.

Le voci di stato pertinenti per il lavoro con le librerie locali di simboli e modelli sono:

Icona	Stato	Descrizione
	No modification	La copia locale della libreria è identica a quella nel repository. È possibile aprire liberamente il file e apportare modifiche.
	Out of date	La copia locale del file (nella cartella di lavoro) è più vecchia della controparte nel repository ed è quindi non aggiornata. Sarà necessario ottenere dal repository la versione più recente del file, aggiornando la propria copia di lavoro locale, prima di poter modificare ed eseguire il commit delle proprie modifiche. Usare il comando Update (nel menu contestuale accessibile con il pulsante destro) per recuperare dal repository il file più recente.
	Modified	La copia locale del file è stata modificata in Altium Designer e salvata nella cartella di lavoro. Per inviare le modifiche locali al repository, fare clic con il pulsante destro sulla voce del file e scegliere il comando Commit dal menu contestuale. Una volta archiviato nel repository, lo stato tornerà a No modification.
	Conflict	Il file è stato sottoposto a commit da un altro utente di Altium Designer prima che l'utente eseguisse il commit della propria versione modificata e salvata del file. Usare il comando Update o Resolve per determinare quale versione del file diventerà la revisione più recente nel repository.
	Locked	Il file è stato bloccato da voi o da un altro utente. Un file bloccato non può essere aggiornato a una nuova revisione nel repository da un altro utente (a meno che non venga forzatamente sbloccato). Questo stato può essere associato ad altre icone, come quelle per Modified  o No Modification , quando si applicano anche tali condizioni di stato.

Confronto fisico delle revisioni

Il confronto fisico può essere eseguito tra due qualsiasi revisioni dello stesso simbolo (libreria di modelli). Questo consente di vedere chiaramente, in modo visivo, le modifiche che sono state apportate, tra revisioni consecutive o non consecutive del file.

Nel pannello Storage Manager, il confronto viene eseguito dalla regione VCS Revisions nella parte inferiore del pannello.

Il Storage Managerpannello presenta due viste della cronologia di un file selezionato, con regioni separate per le Revisioni VCS e la Cronologia locale.

Il confronto può essere effettuato tra due qualsiasi revisioni. Utilizzando la tecnica di selezione di Windows, selezionare le due revisioni della libreria che si desidera confrontare nella regione VCS Revisions del pannello, fare clic con il pulsante destro del mouse e scegliere Compare.

Una volta richiamato il comando Compare , le due revisioni del documento selezionate verranno aperte affiancate nell'area di lavoro, verrà eseguito il confronto grafico e tutte le differenze rilevate tra le due saranno elencate nel pannello Differences.

Confronto grafico direttamente nello spazio di progettazione dell'editor di libreria.