Librerie di database

Altium Designer consente di posizionare i componenti direttamente da un database aziendale, creando e utilizzando un Database Library. Il posizionamento avviene dal pannello Components che, dopo l'installazione della libreria di database, consente di esplorare il database.

Dopo il posizionamento, le informazioni sui parametri di progetto possono essere sincronizzate tra i componenti posizionati e i corrispondenti record collegati nel database, utilizzando il comando Tools » Update Parameters From Database. Gli aggiornamenti completi dei componenti, inclusi il simbolo grafico, i riferimenti ai modelli e i parametri, possono essere eseguiti utilizzando il comando Tools » Update From Libraries. Le informazioni parametriche del database possono anche essere incluse nella distinta base (BOM) finale, pronta per l'approvvigionamento dei componenti.

Posizionamento diretto: oltre il semplice collegamento

Altium Designer offre tre metodi per collegare un componente a un database, utilizzando rispettivamente un file Database Link (*.DbLink), un file Database Library (*.DbLib) o un file SVN Database Library (*.SVNDbLib). L'approccio DbLink offre un modo efficiente per collegare e mantenere sincronizzati i componenti utilizzati nel progetto (o nelle librerie) con i dati inseriti nel database. L'approccio DbLib/SVNDbLib unisce a questa comprovata efficienza di collegamento la libertà di posizionare un componente direttamente dal database, creando in pratica il componente in modo dinamico a partire dalle informazioni memorizzate nel record corrispondente del database.

Prima di approfondire la funzionalità delle librerie di database, vale la pena illustrare le differenze tra questi metodi in termini di modalità di utilizzo.

Collegamento tramite un file Database Link

Related page: Collegamento dei componenti esistenti al database aziendale

• Con questo metodo, il file Database Link (*.DbLink) definisce il collegamento tra il componente dello schema e un record corrispondente in un database. La corrispondenza del record viene stabilita tramite campi chiave: può trattarsi di un singolo campo chiave (ad esempio un codice componente) o di più campi chiave (definendo una clausola Where).
• Con questo metodo di collegamento, le informazioni sui modelli e sui parametri del componente devono essere predefinite nel componente di libreria di Altium Designer. La definizione del componente di libreria deve inoltre includere le informazioni necessarie sui campi chiave. Una volta definito tutto questo, aggiungi un file Database Link al pacchetto di librerie o al progetto; potrai quindi sincronizzare le informazioni del componente (parametri) con il contenuto dei campi del database.
• Sebbene ogni componente fisico definito da ciascun record del database non debba necessariamente corrispondere a un componente di libreria univoco di Altium Designer — più componenti del database possono condividere lo stesso simbolo — questo metodo di collegamento viene generalmente utilizzato secondo una corrispondenza «un record del database per un componente di Altium Designer». Il componente univoco di Altium Designer può essere un'istanza posizionata su un foglio schematico oppure un componente univoco in una libreria di componenti.
• Con il collegamento al database di tipo DbLink, il file Database Link viene incluso nel pacchetto di librerie o nel progetto.

Collegamento tramite un file Database Library

• Anche con questo metodo, il file Database Library (*.DbLib) definisce il collegamento tra il componente dello schema e un record corrispondente in un database. Anche in questo caso, la corrispondenza del record viene stabilita tramite campi chiave: può trattarsi di un singolo campo chiave (ad esempio un codice componente) o di più campi chiave (definendo una clausola Where).
• La differenza principale di questo metodo di collegamento è che le informazioni sul simbolo, sui modelli e sui parametri del componente sono memorizzate nella definizione del record relativo a quel componente nel database esterno. Il componente schematico a cui si fa riferimento (memorizzato in una libreria di componenti sottostante (*.SchLib)) è soltanto il simbolo: non ha modelli collegati né parametri di progetto definiti.
• Quando il componente viene posizionato, le informazioni sui suoi parametri e modelli vengono create al momento, utilizzando i campi corrispondenti del record del database e in base alla mappatura definita. Uno o più di questi parametri verranno quindi utilizzati per mantenere un collegamento con il database, secondo i criteri di corrispondenza definiti, consentendo la sincronizzazione anche dopo il posizionamento.
• Questo metodo di collegamento, grazie alla creazione dinamica dei componenti al momento del posizionamento, si presta molto bene a un utilizzo secondo una corrispondenza «più record del database per un componente di Altium Designer».
• A differenza del collegamento al database di tipo DbLink, in cui il file DbLink deve essere incluso nel pacchetto di librerie (o nel progetto), il file DbLib/SVNDbLib non deve necessariamente essere aggiunto al progetto. La libreria di database (DbLib) è inclusa nelle librerie basate su file disponibili, accessibili dal pannello Components. Ricorda che le librerie basate su file disponibili possono comprendere librerie di progetto, librerie installate o librerie individuate nei percorsi di ricerca specificati.
• In genere, i file DbLib/SVNDbLib vengono configurati in modo da organizzare i componenti in librerie. Ad esempio, potresti averne uno per tutti i resistori presenti nel database aziendale, un altro per i condensatori e così via.

DbLib e SVNDbLib a confronto

Una libreria SVN Database Library è un'estensione del modello Database Library, con la differenza che il simbolo e i modelli sorgente sono sottoposti al controllo di versione.

Le librerie sorgente vengono create, ampliate e gestite all'interno di un repository basato su Subversion. Il collegamento al repository e al database esterno viene definito all'interno di un file SVN Database Library (*.SVNDbLib). Poiché questo approccio è un'estensione di Database Library, viene spesso indicato come Version-Controlled Database Library.

Responsabile delle librerie o progettista?

Esistono essenzialmente due modalità per lavorare con una libreria database sottoposta a controllo di versione: come Librarian oppure come Designer.

In qualità di responsabile delle librerie, non dovrai soltanto configurare e gestire il repository esterno di controllo del codice sorgente per le librerie di simboli e modelli, ma sarai anche responsabile della configurazione del file SVN Database Library. Questo comporta:

• La connessione al database esterno dei componenti.
• La definizione della mappatura tra i record del database e i parametri/modelli dei componenti.
• La specificazione del collegamento al repository SVN in cui sono archiviate le librerie di simboli e modelli.

In qualità di progettista, utilizzerai il file SVNDbLib generato dal responsabile delle librerie e lo renderai disponibile nel pannello Components, aggiungendolo all'elenco Available File-based Libraries, per poter esplorare e posizionare i componenti del database.

L'impiego di questi ruoli varia da un'azienda all'altra. Un'azienda di grandi dimensioni potrebbe disporre di un centro dedicato alle librerie che, nel ruolo di responsabile delle librerie, si occupa esclusivamente della configurazione e della manutenzione delle librerie di simboli e modelli nel repository di controllo del codice sorgente e della generazione dei file SVN Database Library. I file SVNDbLib verranno quindi messi a disposizione dei progettisti dell'azienda, che installeranno e utilizzeranno i file di libreria da cui prelevare i componenti da posizionare nei propri progetti.

In un'azienda più piccola, entrambi i ruoli potrebbero essere ricoperti dalla stessa persona. Questa persona non solo configurerà e gestirà il repository delle librerie, ma utilizzerà anche i file SVNDbLib definiti nel proprio lavoro di progettazione.

Il repository di controllo del codice sorgente

Related article: Utilizzo del controllo di versione esterno

I file delle librerie di simboli e modelli devono essere aggiunti a un repository Subversion (SVN). Altium Designer include un provider di controllo di versione SVN, che può essere abilitato e configurato nella pagina Data Management - Version Control della finestra di dialogo Preferences. Una volta abilitato il provider di controllo di versione SVN, è possibile creare un repository nella pagina Data Management - Design Repositories della finestra di dialogo Preferences.

I repository SVN possono anche essere creati e gestiti al di fuori di Altium Designer utilizzando un client e un server SVN esterni, come TortoiseSVN. È possibile connettersi a un repository esistente nella Data Management - Design Repositories della finestra di dialogo Preferences.

Un aspetto importante da tenere presente quando si aggiungono file al repository è che ogni simbolo e modello must be stored in its own library file. In una libreria normale, che può contenere un numero qualsiasi di simboli/modelli, la modifica di una singola voce comporterebbe la segnalazione di tutte le voci come modificate da parte del sistema di controllo di versione. Avere un solo simbolo/modello per file di libreria è coerente con il funzionamento del controllo di versione e consente di tenere traccia con precisione di ciò che è stato modificato e di ciò che non lo è stato.

Ai fini di questo documento, si presume che il repository sia già stato creato.

Utilizzo della procedura guidata Library Splitter

Se le librerie di simboli e modelli vengono create da zero, è semplice assicurarsi che ogni file contenga un solo simbolo/modello. In genere, tuttavia, le librerie sorgenti esistono già. Per semplificare la suddivisione di queste librerie in file contenenti una singola entità da aggiungere al repository SVN, Altium Designer mette a disposizione uno strumento di suddivisione: Library Splitter Wizard. La procedura guidata consente di suddividere rapidamente le librerie schematiche (*.SchLib) e PCB (*.PcbLib) contenenti più componenti in librerie di singoli componenti. La procedura guidata è accessibile dal menu Tools dell'editor delle librerie schematiche, dell'editor delle librerie PCB e dell'editor SVN Database Library.

Suddividi le librerie sorgenti in file contenenti un solo simbolo/modello utilizzando Library Splitter Wizard.

La configurazione del processo di suddivisione prevede i seguenti passaggi:

1. Aggiunta dei file di libreria sorgente che desideri suddividere (non devono necessariamente trovarsi nella stessa cartella). Utilizza la pagina Libraries to Split per scegliere le librerie schematiche o PCB da suddividere. Fai clic sul pulsante Add per accedere a una finestra di dialogo in cui individuare e aggiungere all'elenco le librerie desiderate. Le librerie aggiunte verranno suddivise in librerie di singoli componenti in una fase successiva della procedura guidata. Le librerie sorgenti non devono necessariamente trovarsi nella stessa cartella. Utilizza il pulsante Remove per eliminare dall'elenco una libreria selezionata.

   

2. Specifica della directory di output. La pagina Output Directories consente di impostare le directory di output per le librerie di singoli componenti. Il valore Output Directory elencato indica il percorso in cui verranno collocate le librerie suddivise. Se necessario, fai clic su Change Output Directory per aggiornare la directory elencata e selezionata. Si apre una finestra di dialogo in cui puoi individuare e selezionare la nuova cartella per la directory di output.

   Per impostazione predefinita, la directory di output corrisponde alla directory in cui è archiviata la libreria sorgente. Occorre prestare attenzione se tutte le librerie sorgenti originali sono archiviate nella stessa cartella sorgente. Se le directory di output non vengono specificate e vengono lasciate ai valori predefiniti, che puntano alla stessa cartella sorgente, potresti ritrovarti con un insieme molto ampio di librerie di singoli simboli e modelli mescolate tra loro. Esaminarle durante la creazione della struttura del repository potrebbe richiedere molto tempo.

   

   Poiché i file di libreria risultanti dalla suddivisione verranno aggiunti al repository SVN, può essere utile creare localmente sul disco rigido la struttura di cartelle desiderata nel repository per i file di simboli e modelli. Una volta definita la struttura, copia le librerie sorgenti nelle rispettive cartelle al suo interno. Puoi quindi lasciare le impostazioni della directory di output di ogni libreria sorgente ai valori predefiniti. Dopo la suddivisione, i singoli file di libreria generati si troveranno già nelle posizioni corrette. Potrai quindi eliminare la libreria sorgente originale da ogni cartella e aggiungere le cartelle al repository utilizzando il client SVN che hai scelto.

3. Configurazione delle opzioni aggiuntive per controllare la suddivisione delle librerie sorgenti. Nel caso di una libreria di componenti schematici, queste includono opzioni che consentono di rimuovere le informazioni sui parametri e/o sui modelli da ciascun componente, lasciando soltanto il simbolo.

    
   Due varianti della pagina Split Libraries: a sinistra, la pagina Split Libraries durante la conversione di un file .PCBLib . A destra, la pagina Split Libraries durante la conversione di un file .SCHLib .

   È possibile controllare la suddivisione delle librerie tramite la pagina Options . Utilizzare il menu a discesa (mostrato nell'immagine sopra) per selezionare come gestire i nuovi file. Scegliendo Overwrite Existing Files (impostazione predefinita), tutti i file appena creati sovrascriveranno quelli esistenti. Se si sceglie Append Incrementing Number To File Names , lo strumento di suddivisione delle librerie esaminerà tutte le directory di destinazione selezionate nella pagina precedente (Output Directories) e creerà un elenco di file da proteggere affinché non vengano sovrascritti. Ai nomi delle nuove librerie di componenti con lo stesso nome verrà aggiunto il suffisso "_#Increment Number".

4. Una volta specificate le librerie sorgente e le opzioni, la procedura guidata eseguirà un'analisi, il cui risultato sarà l'elenco delle librerie contenenti un singolo simbolo o modello che verranno create, da esaminare. Per ogni libreria risultante dalla suddivisione viene mostrato il nome, insieme al nome effettivo del componente schematico o del modello di footprint al suo interno. Viene indicata anche la libreria sorgente originale. Il nome utilizzato per ciascuna libreria sarà uguale a quello del componente o modello che contiene.

   Se nel nome del componente o modello sono stati utilizzati i seguenti caratteri, questi verranno sostituiti da un trattino basso durante la creazione del nome della libreria: '\', '/', '!', ''', '[', ']'.

   

   Le librerie di componenti che verranno create possono essere esaminate nella pagina Review. Vengono elencati Splitted Library Name, Component Name e Source Library per mostrare i nuovi file che verranno creati durante il processo di suddivisione. È possibile accedere facilmente a un elenco a discesa dei dati di ciascuna colonna facendo clic sulla freccia verso il basso sul lato destro della colonna. Questa funzione è particolarmente utile quando si esaminano i file di librerie di dimensioni molto grandi.

5. Esaminare l'elenco delle librerie da creare, quindi fare clic su Next per procedere con la suddivisione e ottenere le librerie da aggiungere al repository di controllo versione. Dopo aver completato correttamente la procedura guidata, fare clic su Finish per chiuderla.

   

Utilizzo della procedura guidata di conversione delle librerie database SVN

Un altro metodo per convertire le librerie esistenti in una libreria database di tipo SVN consiste nell'utilizzare la procedura guidata di conversione delle librerie database SVN. Questa procedura guidata converte le librerie schematiche, PCB, database e integrate in librerie database SVN. La procedura guidata offre diverse opzioni di conversione, tra cui la modalità di suddivisione delle librerie sorgente, le directory e il repository in cui memorizzarle e la directory di destinazione per il file SVNDbLib e il file database MDB creati. 

La procedura guidata è accessibile dal menu Tools durante la modifica di un documento di libreria PCB o schematica.

La procedura guidata suddivide le librerie di simboli e footprint e le archivia in un repository, quindi crea i file SVNDbLib e del database Access.

Come proseguire?

Consultare le pagine seguenti per approfondire i diversi aspetti dell'utilizzo delle librerie database:

• Creazione e definizione della libreria database
• Modifica di una tabella del database
• Modifica di simboli e footprint