Database Libraries

Altium Designer offre la possibilità di posizionare componenti direttamente da un database aziendale, creando e utilizzando un Database Library. Il posizionamento viene eseguito dal pannello Components che, dopo l'installazione della libreria di database, funge da browser del tuo 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 del componente, inclusi il simbolo grafico, i riferimenti ai modelli e i parametri, possono essere eseguiti utilizzando il comando Tools » Update From Libraries. Le informazioni parametriche dal database possono anche essere incluse nella distinta base finale (BOM), pronte per l'approvvigionamento dei componenti.

Posizionamento diretto - Oltre il semplice collegamento

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

Prima di approfondire ulteriormente la funzionalità delle database library, vale la pena discutere le differenze tra questi metodi per quanto riguarda il modo in cui vengono utilizzati.

Collegamento tramite un file Database Link

Related page: Collegamento dei componenti esistenti al database aziendale

• Utilizzando questo metodo, il file Database Link (*.DbLink) definisce il collegamento tra il componente schematico e un record corrispondente in un database. La corrispondenza del record viene stabilita tramite il collegamento dei campi chiave, che può essere un singolo campo chiave (ad esempio un codice componente), oppure più campi chiave (definendo una clausola Where).
• Con questo metodo di collegamento, le informazioni su modello e parametri del componente devono essere predefinite come parte del componente di libreria di Altium Designer. Il componente di libreria deve inoltre includere le necessarie informazioni del campo chiave come parte della propria definizione. Una volta definito questo, aggiungi un file Database Link al tuo pacchetto di librerie o al progetto di progettazione, quindi puoi sincronizzare le informazioni del componente (parametri) con il contenuto dei campi nel database.
• Sebbene ogni componente fisico definito da ciascun record del database non debba necessariamente corrispondere a un componente di libreria univoco di Altium Designer - molti componenti del database possono condividere lo stesso simbolo di componente - questo metodo di collegamento verrebbe tipicamente utilizzato secondo una logica "un record di database-per-un componente Altium Designer". Il componente Altium Designer univoco può essere sia un'istanza posizionata su un foglio schematico, sia un componente univoco in una libreria di componenti.
• Con il collegamento al database in stile DbLink, includi il file Database Link nel pacchetto di librerie o nel progetto di progettazione.

Collegamento tramite un file Database Library

• Utilizzando questo metodo, anche il file Database Library (*.DbLib) definisce il collegamento tra il componente schematico e un record corrispondente in un database. Anche in questo caso, la corrispondenza del record viene stabilita tramite il collegamento dei campi chiave, che può essere un singolo campo chiave (ad esempio un codice componente), oppure più campi chiave (definendo una clausola Where).
• La differenza fondamentale con questo metodo di collegamento è che il simbolo del componente, il modello e le informazioni sui parametri di un componente sono memorizzati come parte della definizione del record di quel componente nel database esterno. Il componente schematico di riferimento (memorizzato in una libreria di componenti sottostante (*.SchLib)) è solo il simbolo; non ha modelli collegati né parametri di progetto definiti.
• Quando il componente viene posizionato, le sue informazioni su parametri e modelli vengono create al volo utilizzando i campi corrispondenti nel record del database associato e in conformità alla mappatura definita. Uno o più di questi parametri verranno quindi utilizzati per mantenere un collegamento continuo al database, secondo i criteri di corrispondenza definiti, consentendo sincronizzazioni future dopo il posizionamento.
• Questo metodo di collegamento, grazie alla creazione dinamica dei componenti al momento del posizionamento, si presta molto bene a essere utilizzato secondo una logica "molti record di database-per-un componente Altium Designer".
• A differenza del collegamento al database in stile DbLink, in cui il file DbLink deve essere incluso nel pacchetto di librerie (o nel progetto di progettazione), il file DbLib/SVNDbLib non deve essere aggiunto al progetto. La database library (DbLib) è inclusa nelle Available File-based Libraries - accessibili dal pannello Components. Ricorda che le Available File-based Libraries possono essere costituite da Project Libraries, Installed Libraries o librerie trovate lungo percorsi di ricerca specificati.
• Tipicamente configurerai i file DbLib/SVNDbLib in modo orientato alla libreria. Ad esempio, potresti averne uno per tutte le resistenze dettagliate nel database aziendale, un altro per i condensatori e così via.

DbLib vs SVNDbLib

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

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

Bibliotecario o progettista?

Esistono essenzialmente due modalità in cui puoi lavorare con una database library sotto controllo di versione: come Librarian oppure come Designer.

Come Bibliotecario, non solo dovrai configurare e mantenere il repository esterno di controllo sorgente delle librerie di simboli e modelli, ma sarai anche responsabile della configurazione del file SVN Database Library. Questo comporta:

• Connessione al database esterno dei componenti.
• Definizione della mappatura tra record del database e parametri/modelli del componente.
• Specifica del collegamento al repository SVN in cui sono memorizzate le librerie di simboli e modelli.

Come Progettista, prenderai il file SVNDbLib generato dal Bibliotecario e lo renderai disponibile nel pannello Components - aggiungendolo all'elenco delle Available File-based Libraries - in modo da poter sfogliare e posizionare i componenti del database.

L'uso di questi ruoli varierà da azienda ad azienda. Un'azienda più grande potrebbe avere un centro librerie dedicato che, nel ruolo di Bibliotecario, si occuperà esclusivamente della configurazione e manutenzione delle librerie di simboli e modelli nel repository di controllo sorgente e della generazione dei file SVN Database Library. I file SVNDbLib verranno quindi resi disponibili ai Progettisti all'interno di quell'azienda, che installeranno e utilizzeranno i file di libreria da cui posizionare i componenti nei loro progetti.

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

Il repository di controllo sorgente

Related article: Utilizzo del controllo di versione esterno

I file di libreria di simboli e modelli devono essere aggiunti a un repository Subversion (SVN). Altium Designer include un provider di controllo versione SVN, che viene abilitato e configurato nella pagina Data Management - Version Control page della finestra di dialogo Preferences. Una volta abilitato il provider di controllo 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 pagina della finestra di dialogo Preferences.

Una cosa importante da notare 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 che il sistema di controllo versione contrassegni tutti gli elementi come modificati. Avere un solo simbolo/modello per file di libreria si adatta alla natura del controllo versione, consentendoti 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.

Uso del Library Splitter Wizard

Se le librerie per simboli e modelli vengono create ex novo, non c’è alcun problema nel garantire un solo simbolo/modello per file. In genere, tuttavia, le librerie sorgente esistono già. Per semplificare il compito di separare queste librerie in file a entità singola da aggiungere al repository SVN, Altium Designer fornisce uno strumento di suddivisione: il Library Splitter Wizard. La procedura guidata consente di suddividere rapidamente librerie schematiche multi-componente (*.SchLib) e librerie PCB (*.PcbLib) in librerie di componenti individuali. La procedura guidata è accessibile dal menu Tools nell’Editor di librerie schematiche, nell’Editor di librerie PCB e nell’Editor di librerie database SVN.

Suddividi le librerie sorgente in un simbolo/modello per file, utilizzando il Library Splitter Wizard.

La configurazione del processo di suddivisione prevede i seguenti passaggi:

1. Aggiunta dei file di libreria sorgente richiesti che desideri suddividere (non è necessario che risiedano nella stessa cartella). Usa la pagina Libraries to Split per scegliere le librerie schematiche o PCB che desideri suddividere. Fai clic sul pulsante Add per accedere a una finestra di dialogo da cui sfogliare e aggiungere le librerie desiderate all’elenco. Le librerie aggiunte verranno successivamente suddivise in librerie di componenti individuali nella procedura guidata. Le librerie sorgente non devono necessariamente trovarsi nella stessa cartella. Usa il pulsante Remove per eliminare una libreria selezionata dall’elenco.

   

2. Specifica della directory di output. La pagina Output Directories viene utilizzata per impostare le directory di output per le librerie di componenti individuali. Il valore Output Directory elencato è il percorso in cui verranno collocate le librerie suddivise. Fai clic su Change Output Directory per aggiornare la directory elencata e selezionata, se necessario. Si apre una finestra di dialogo in cui puoi sfogliare e selezionare la cartella aggiornata per la directory di output.

   Per impostazione predefinita, la directory di output sarà impostata sulla stessa directory in cui è archiviata la libreria sorgente. Occorre prestare attenzione se le librerie sorgente originali sono tutte archiviate nella stessa cartella della directory sorgente. Se le directory di output non vengono specificate e vengono lasciate ai valori predefiniti, puntando quindi alla stessa cartella della directory sorgente, potresti ritrovarti con una miscela molto ampia di librerie contenenti singoli simboli e modelli. Passarle in rassegna durante la creazione della struttura del repository potrebbe richiedere molto tempo.

   

   Poiché i file di libreria suddivisi verranno aggiunti al repository SVN, può essere una buona idea impostare localmente sul disco rigido la struttura di cartelle che desideri nel repository, in termini di file simbolo/modello. Una volta definita la struttura, copia le librerie sorgente nelle rispettive cartelle all’interno di tale struttura. Potrai quindi semplicemente lasciare le impostazioni della directory di output di ciascuna libreria sorgente ai valori predefiniti. Dopo la suddivisione, i file di libreria singoli generati si troveranno già nelle posizioni corrette. Potrai quindi eliminare la libreria sorgente originale da ciascuna cartella e aggiungere le cartelle al repository utilizzando il client SVN che hai deciso di usare.

3. Configura opzioni aggiuntive per controllare il modo in cui le librerie sorgente vengono suddivise. Queste includono, per una libreria di componenti schematici, opzioni che consentono di rimuovere le informazioni sui parametri e/o sui modelli da ciascun componente costituente, lasciando solo il simbolo nudo.

    
   Due iterazioni 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 .

   Puoi controllare il modo in cui le librerie vengono suddivise utilizzando la pagina Options . Usa il menu a discesa (mostrato nell’immagine sopra) per selezionare come vengono gestiti i nuovi file. Scegliere Overwrite Existing Files (predefinito) farà sì che tutti i file appena creati sovrascrivano eventuali file esistenti. Se viene scelto Append Incrementing Number To File Names , il separatore di librerie eseguirà una scansione di tutte le directory di output selezionate nella pagina precedente (Output Directories) e creerà un elenco di file da proteggere in modo che non vengano sovrascritti. Alle 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’insieme delle librerie a simbolo/modello singolo che verranno create, elencate per la tua revisione. Verrà mostrato il nome di ciascuna libreria suddivisa da generare, così come il nome effettivo del componente schematico/modello footprint all’interno di quella libreria. Verrà inoltre elencata la libreria sorgente originale. Il nome utilizzato per una libreria sarà lo stesso usato per il componente/modello costituente.

   Se nel nome del componente/modello è stato utilizzato uno dei seguenti caratteri, esso verrà sostituito da un carattere di sottolineatura durante la creazione del nome della libreria: '\', '/', '!', ''', '[', ']'.

   

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

5. Esamina l’elenco delle librerie da creare e quindi fai clic su Next per procedere con il processo di suddivisione e ottenere infine le librerie da aggiungere al repository di controllo del codice sorgente. Dopo aver completato correttamente la procedura guidata, fai clic su Finish per chiudere.

   

Uso della procedura guidata di conversione della libreria database SVN

Un altro approccio per convertire librerie esistenti in una libreria database di tipo SVN è il SVN Database Library Conversion Wizard. Questa procedura guidata converte librerie schematiche, PCB, database e integrate in librerie database SVN. La procedura guidata dispone di numerose opzioni relative alla conversione, inclusi il modo in cui le librerie sorgente devono essere suddivise, in quali directory di quale repository devono essere archiviate e la directory di output per il file SVNDbLib creato e il file di database MDB. 

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, le archivia in un repository e crea i file SVNDbLib e Access database.

Dove andare ora?

Fai riferimento alle pagine seguenti per saperne di più sui diversi aspetti del lavoro con le librerie database:

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