Modifica di simboli e footprint

Oltre a mantenere aggiornati i contenuti del database stesso, è necessario aggiornare, quando occorre, anche i simboli e i modelli a cui viene fatto riferimento. Ciò comporta la modifica dei simboli schematici e dei modelli di footprint. Nel caso di una libreria database standard (DbLib), anche delle definizioni nei file dei modelli di simulazione.

Entrambi i tipi di libreria database, standard e con controllo di versione, consentono di accedere al simbolo e al modello di footprint di riferimento per modificarli, direttamente dalla vista principale del documento DbLib/SVNDbLib, quando questo è aperto come documento attivo. Le sezioni seguenti illustrano come procedere: con una SVNDbLib, la procedura è leggermente più articolata, ma offre anche maggiori possibilità.

Utilizzo di una DbLib

Per aprire e modificare il file di libreria del simbolo o del modello di footprint a cui fa riferimento un componente, fai clic con il pulsante destro del mouse sulla voce del componente in Table Browser, quindi seleziona il comando appropriato, Open Symbol oppure Open Footprint, dal menu contestuale. Verrà aperto il file di libreria corrispondente e il simbolo o il footprint verrà visualizzato come entità attiva nell'area di progettazione, pronto per essere modificato.

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

Esempio di accesso al simbolo di riferimento di un componente del database direttamente dalla DbLib.

Utilizzo di una SVNDbLib

Come accennato, l'accesso e la modifica dei simboli e dei modelli a cui fanno riferimento i componenti del database tramite un file SVNDbLib sono leggermente più complessi, ma offrono anche maggiori possibilità. Le modifiche vengono apportate alle copie di lavoro locali delle librerie archiviate nel repository SVN.

Specifica di un'area di lavoro locale

Per modificare i simboli dei componenti e i modelli di footprint, devi eseguire il checkout dei file dal repository in una directory di lavoro locale. Specifica la directory da utilizzare nella pagina Data Management - SVN Libraries della finestra di dialogo Preferences. È definita una posizione predefinita per la cartella di lavoro: \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Modificala secondo necessità facendo clic sul pulsante  per selezionare una cartella esistente oppure inserendo direttamente il percorso della cartella.

Specifica di una directory di lavoro locale.

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

Esempio di simboli e footprint, archiviati nel repository SVN e specificati come parte di Database Library Options, di cui è stato eseguito il checkout in una cartella di lavoro locale.

Apportare modifiche

Una volta eseguito il checkout delle librerie di simboli e modelli di footprint nella cartella di lavoro locale designata, puoi modificarle quando necessario. Ciò comporta la modifica della copia locale dei simboli schematici e dei modelli di footprint, seguita dal commit di tali modifiche nel repository SVN.

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

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

• Se la SVNDbLib viene aggiunta all'elenco Available File-based Libraries, puoi accedere ai comandi di modifica direttamente tramite il pannello Components. Seleziona la voce del componente desiderato, quindi usa rispettivamente il comando Edit Symbol (nel menu contestuale accessibile con il pulsante destro del mouse nell'area Components ) oppure il comando Edit Footprint (nel menu contestuale accessibile con il pulsante destro del mouse nell'area Models ).
• Usa il comando File » Open dell'editor di librerie per individuare e aprire la libreria desiderata nella cartella di lavoro locale.
• Trascina il file di libreria presente nella cartella di lavoro locale da Esplora file di Windows direttamente in Altium Designer.

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

Tuttavia, l'interfaccia principale tra le cartelle e i file di cui è stato eseguito il checkout nella cartella di lavoro locale e il repository stesso è il pannello Storage Manager. Quando il file SVNDbLib è il documento attivo, il pannello Storage Manager viene popolato con le cartelle dei simboli e dei modelli di cui è stato eseguito il checkout nella cartella di lavoro locale. Le cartelle elencate sono esattamente quelle specificate nell'area Model Locations, nella scheda SVN Repository della finestra di dialogo Database Library Options.

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

Per aprire un file di libreria da modificare, fai clic con il pulsante destro del mouse sulla relativa voce nell'area All Files del pannello e scegli Open dal menu contestuale visualizzato. Apporta le modifiche necessarie e salva il file come di consueto, utilizzando il comando standard Save dell'editor associato.

Commit delle modifiche nel repository

Panel page: Storage Manager

Sebbene esistano diversi modi per aprire una libreria da modificare, il commit delle modifiche apportate da within Altium Designer può essere eseguito solo tramite il pannello Storage Manager.

Una delle cose più importanti da ricordare quando si utilizza il pannello Storage Manager è aggiornare lo stato del collegamento tra le cartelle e i file di lavoro locali (visualizzati nel pannello) e le cartelle e i file corrispondenti nel repository di controllo del codice sorgente. Per una singola libreria selezionata, questa operazione si esegue utilizzando il comando Refresh, disponibile nel menu accessibile con il clic destro nell'area All Files del pannello. Per aggiornare rapidamente lo stato di un'intera cartella, utilizzare la scorciatoia da tastiera Ctrl+F5.

Gli stati relativi all'utilizzo delle librerie locali di simboli e modelli sono:

Icona	Stato	Descrizione
	No modification	La copia locale della libreria è identica a quella presente nel repository. È possibile aprire il file e apportare modifiche.
	Out of date	La copia locale del file (nella cartella di lavoro) è precedente alla corrispondente copia nel repository ed è quindi obsoleta. Prima di poter modificare il file ed eseguire il commit delle proprie modifiche, è necessario recuperare la versione più recente dal repository, aggiornando la propria copia di lavoro locale. Utilizzare il comando Update (nel menu contestuale accessibile con il clic destro) per recuperare il file più recente dal repository.
	Modified	La copia locale del file è stata modificata in Altium Designer e salvata nella cartella di lavoro. Per trasferire le modifiche locali nel repository, fare clic con il pulsante destro del mouse sulla voce del file e scegliere il comando Commit dal menu contestuale. Una volta eseguito il commit nel repository, lo stato tornerà a No modification.
	Conflict	Un altro utente di Altium Designer ha eseguito il commit del file prima che venisse eseguito il commit della propria versione modificata e salvata. Utilizzare il comando Update o Resolve per determinare quale versione del file diventerà la revisione più recente nel repository.
	Locked	Il file è stato bloccato dall'utente corrente 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 ne venga forzato lo sblocco). Questo stato può essere associato ad altre icone, come quelle di Modified  o No Modification , quando si applicano anche queste condizioni di stato.

Confronto fisico delle revisioni

È possibile eseguire un confronto fisico tra due revisioni qualsiasi dello stesso simbolo (libreria di modelli). Ciò consente di visualizzare chiaramente le modifiche apportate tra revisioni consecutive o non consecutive del file.

Nel pannello Storage Manager, il confronto viene eseguito dall'area VCS Revisions nella parte inferiore del pannello.

Il pannello Storage Manager presenta due viste della cronologia di un file selezionato, con aree separate per le revisioni VCS e la cronologia locale.

È possibile confrontare due revisioni qualsiasi. Utilizzando la tecnica di selezione Ctrl+click di Windows, selezionare le due revisioni della libreria da confrontare nell'area 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 le eventuali differenze rilevate tra le due verranno elencate nel pannello Differences.

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