Creating & Defining the Database Library

La struttura portante della funzionalità di libreria database è il file di libreria database. Questo è disponibile in due forme, a seconda che si utilizzi una libreria database standard oppure una libreria database con controllo di versione:

• Standard Database Library - il file Database Library. Questo file viene creato e gestito utilizzando il DatabaseLib Editor di Altium Designer. Questo editor diventa disponibile quando il documento attivo nella finestra principale di progettazione è un file *.DbLib.
• Version-Controlled Database Library - il file SVN Database Library. Questo file viene creato e gestito utilizzando l'SVNDatabaseLib Editor di Altium Designer. Questo editor diventa disponibile quando il documento attivo nella finestra principale di progettazione è un file *.SVNDbLib.

Esempio di file DbLib aperto nel DatabaseLib Editor. Passare il cursore sull'immagine per vedere un esempio di file SVNDbLib aperto nell'SVNDatabaseLib Editor.

Creare un nuovo file di questi tipi scegliendo il comando File » New » Library dai menu principali e selezionando l'opzione Database Library oppure SVN Database Library dalla sezione Database della finestra di dialogo New Library che si apre.

Connessione a un database esterno

La tabella e i dati di mappatura appariranno nella finestra di visualizzazione principale dell'Editor solo dopo che il file Database Library/SVN Database Library attivo sarà stato connesso correttamente al database esterno richiesto. La connessione viene definita utilizzando i controlli forniti nella sezione Source of Connection.

Specificare la connessione al database esterno tramite un file DbLib. Passare il cursore sull'immagine per vedere la connessione tramite un file SVNDbLib.

È possibile connettersi a qualsiasi database che fornisca supporto OLE DB. Le opzioni fornite in questa sezione utilizzano ciascuna una stringa di connessione OLE DB per connettersi al database di destinazione. Alcuni database potrebbero non offrire supporto OLE DB. Tuttavia, praticamente tutti i sistemi di gestione di database oggi in uso possono essere accessibili tramite l'interfaccia Open Database Connectivity (ODBC). La funzionalità di collegamento al database utilizza il provider ODBC di Microsoft, che consente a un ADO (ActiveX Data Object) di connettersi a qualsiasi origine dati ODBC. Il risultato è che è possibile connettersi a qualsiasi database ODBC. Il provider OLE DB per il database ODBC viene specificato come parte della stringa di connessione.

La connessione può anche essere definita nella scheda Connection della finestra di dialogo Database Connection, accessibile scegliendo il comando Tools » Database Connection dai menu principali oppure facendo clic sul pulsante Advanced (a destra del pulsante Connect , nella parte inferiore della sezione).

Connessione rapida a database Access ed Excel

L'opzione Select Database Type offre un metodo rapido per creare una stringa di connessione quando il database di destinazione è stato creato utilizzando Microsoft Access o Microsoft Excel. Utilizzando questa opzione, selezionare il tipo di database e quindi individuare e selezionare il file di database richiesto. La stringa di connessione corrispondente verrà composta automaticamente e inserita nel campo dell'opzione Use Connection String.

Creazione di una stringa di connessione

Se il database aziendale non è basato su Access o Excel e si desidera creare esplicitamente la stringa di connessione, abilitare l'opzione Use Connection String e quindi fare clic sul pulsante Build associato a destra. Verrà visualizzata la finestra di dialogo Data Link Properties.

Creazione di una stringa di connessione tramite la finestra di dialogo Data Link Properties.

La finestra di dialogo si apre nella scheda Connection . Il provider OLE DB Microsoft Office <Version> Access Database Engine OLE DB Provider è impostato per impostazione predefinita nella scheda Provider della finestra di dialogo. Questa è l'impostazione predefinita del provider per i nuovi file Database Library/SVN Database Library ed è utilizzata anche per connettersi ai file di database Access (*.mdb). Modificare il provider secondo necessità.

Dalla scheda Connection immettere il nome (incluso il percorso) del database a cui si desidera connettersi.

Se il database richiede autorizzazioni di accesso, inserirle secondo necessità, insieme a qualsiasi altra impostazione avanzata disponibile nella scheda Advanced della finestra di dialogo. La scheda All fornisce un elenco riepilogativo delle opzioni di collegamento definite, nonché opzioni estese relative al provider OLE DB scelto. Le opzioni possono essere modificate secondo necessità da questa scheda.

Una volta definite le opzioni di collegamento, è possibile verificare l'avvenuta connessione facendo clic sul pulsante Test Connection (nella scheda Connection ). Una connessione riuscita produrrà una finestra di dialogo di conferma.

Specificare un file Data Link

Se l'origine dati a cui si desidera connettersi è descritta utilizzando un file Microsoft Data Link (*.udl), abilitare la terza delle opzioni di connessione - Use Data Link File - e fare clic sul pulsante Browse associato per individuare il file richiesto. Un file Data Link è essenzialmente un contenitore per una stringa di connessione.

Procedere con la connessione

Dopo aver definito la connessione al database esterno, il testo del pulsante Connect diventerà in grassetto, a indicare che è possibile procedere con la connessione. Se i dettagli della connessione sono corretti, le informazioni di tabella e mappatura per il database di destinazione verranno caricate nel file Database Library/SVN Database Library. Il testo sul pulsante Connect cambierà in Connected e il pulsante verrà disattivato.

Se si verifica un problema con i dettagli della connessione, ad esempio una stringa di connessione costruita in modo errato oppure un percorso inserito erroneamente, la connessione non riuscirà e verrà visualizzato un messaggio che segnala questo fatto. Controllare le impostazioni di connessione e fare nuovamente clic sul pulsante Connect .

Esempi di segnalazione di errore di connessione in una libreria database.

Dopo la connessione iniziale riuscita e dopo aver salvato il file Database Library/SVN Database Library, la connessione verrà effettuata automaticamente ogni volta che il file viene aperto, a condizione che la posizione e il nome file del database di destinazione non vengano modificati.

Specificare il collegamento al repository di controllo versione (solo SVNDbLib)

Con un DbLib, le librerie di simboli e modelli sono memorizzate sul disco rigido o su un altro supporto locale/di rete. Ricordare che per un SVNDbLib queste librerie sono memorizzate sotto controllo di versione in un repository Subversion. Come parte del file SVNDbLib, è necessario definire il collegamento a questo repository. La connessione al repository SVN viene definita nella scheda SVN Repository della finestra di dialogo Database Library Options (Tools » Options). È possibile accedere a questa finestra di dialogo anche facendo clic sul pulsante Options nella sezione Field Settings della vista documento.

Esempio di connessione a un repository SVN basato su file.

Elenco delle tabelle del database

Dopo la connessione riuscita al database esterno, verranno caricati i dati di tabella e mappatura. Il lato sinistro del documento DbLib/SVNDbLib elenca tutte le tabelle esistenti nel database connesso.

Tabelle esistenti nel database connesso.

L'opzione Enable accanto a ciascuna voce di tabella consente di controllare se quella tabella debba o meno far parte della libreria database risultante. Quando la libreria database viene aggiunta all'elenco delle Available File-based Libraries per la consultazione nel pannello Components panel, ogni tabella apparirà come un'entità di libreria separata. Quindi, sebbene in termini reali venga aggiunta una sola libreria database, dal punto di vista del pannello Components è come se fossero state aggiunte più librerie distinte. Per ulteriori informazioni, vedere Ricerca di componenti nelle librerie basate su file e database.

Quando si fa clic su una voce della tabella nell’elenco, la relativa icona cambia da  a  per distinguerla come tabella attualmente attiva. La tabella, con tutti i suoi dati, viene visualizzata nella scheda Table Browser del documento. Si tratta di una vista modificabile della tabella, che consente di consultare rapidamente il contenuto ed effettuare modifiche quando necessario, senza dover avviare il database esterno stesso.

Esplorazione di una tabella sorgente nel database connesso.

Per ingrandire l’area del Browser tabelle (come mostrato nell’illustrazione sopra), comprimere l’intera area superiore (impostazioni di connessione e dei campi) facendo clic sul controllo , nell’angolo in alto a destra della vista documento. Fare clic su  per espandere. La tabella supporta inoltre le consuete funzionalità di raggruppamento, ordinamento e filtro.

Specifica dei criteri di corrispondenza

Dopo che un componente è stato posizionato dal database esterno, deve esserci un modo per mantenere il collegamento tra quel componente posizionato e il record del database le cui informazioni sono state usate per crearlo. In sostanza, i due devono essere messi in corrispondenza.

Quando un componente viene posizionato, le sue informazioni sui parametri vengono create al volo usando i campi corrispondenti nel record del database. Il collegamento successivo al posizionamento tra il componente schematico e il record del database viene stabilito usando uno o più di questi parametri. L’area Field Settings del documento consente di definire i criteri di corrispondenza: una semplice ricerca con chiave singola oppure una corrispondenza più avanzata tramite una clausola Where.

Controllo dei criteri di corrispondenza successivi al posizionamento.

Ricerca con chiave singola

Se l’opzione Single key lookup è abilitata (impostazione predefinita), i campi Database field e Part parameter diventano disponibili. Il primo elenca tutti i nomi di campo disponibili (intestazioni di colonna) nella tabella attiva del database. Poiché i parametri di un componente schematico vengono aggiunti durante il posizionamento, il campo Part parameter rifletterà il campo del database scelto.

In genere, il campo chiave di ricerca utilizzato è qualcosa che identifica in modo univoco ciascun componente nel database esterno, ad esempio un codice parte. Il campo di ricerca scelto è contraddistinto nella scheda Field Mappings del documento dalla voce Design Parameter mostrata in grigio.

Mappatura a chiave singola tramite codice parte.

Quando si usa la funzionalità Update Parameters From Database in una fase successiva al posizionamento, le informazioni vengono lette dal parametro chiave scelto nei componenti schematici posizionati e quindi cercate nel campo scelto (chiave) del database, in tutte le tabelle abilitate. Quando viene trovata una corrispondenza, le informazioni dalle altre celle di quel record della tabella padre possono quindi essere riportate nei parametri mappati del componente schematico.

Corrispondenza avanzata - la clausola Where

Sebbene l’opzione Single key lookup funzioni bene se esiste un numero parte/ID univoco su cui effettuare la corrispondenza, non è altrettanto efficace quando si esegue la corrispondenza tramite un parametro non univoco, come capacità o resistenza. In questo caso dovrebbe essere usata la più avanzata clausola Where, che consente di specificare una corrispondenza con più chiavi per collegare il componente schematico al record del database sorgente.

Nella sua forma più semplice, la clausola Where (scritta usando la sintassi SQL) riflette le voci scelte che definiscono la ricerca con chiave singola. Ad esempio, se Database field è stato scelto come Part Number - il valore predefinito - anche il campo Part parameter verrebbe impostato automaticamente su Part Number e la voce per la clausola Where sarebbe:

[Part Number] = '{Part Number}'

Le parentesi quadre attorno al campo del database (colonna della tabella) sono caratteri di quoting, come specificato nella scheda Advanced della finestra di dialogo Database Connection dialog. È possibile accedere a questa finestra di dialogo facendo clic sul pulsante Advanced nell’area Source of Connection del documento oppure dal menu principale Tools .

La scheda Advanced della finestra di dialogo Database Connection fornisce opzioni SQL aggiuntive per il quoting
delle tabelle, o per l’uso dei nomi di schema delle tabelle, in una clausola Where costruita.

Le parentesi graffe indicano che la voce a cui si fa riferimento è un parametro di progetto. Gli apici singoli vengono usati per specificare che il parametro di progetto deve essere trattato come una stringa, anziché come un numero (senza apici). La corrispondenza del tipo è molto importante, poiché SQL è sensibile ai tipi. Il parametro di progetto dovrebbe essere dello stesso tipo della colonna nel database.

Usando la sintassi SQL standard, la clausola Where può quindi essere estesa per effettuare la corrispondenza usando più voci Database field/Part parameter, ad esempio:

[Capacitance] = '{Capacitance}' AND [Tolerance] = {Tolerance} AND [Manufacturer] = '{Manufacturer}'

In questo caso verrebbe collegato un singolo record nella tabella pertinente del database, usando tre diversi parametri di progetto. Si noti che la voce per il parametro di progetto Tolerance non è racchiusa tra apici. Ciò significa che il tipo di colonna nella tabella associata del database è Number e non String.

Usando la sintassi SQL standard, è teoricamente possibile rendere la clausola Where semplice o complessa quanto si desidera.

Mappatura dei campi del database ai parametri di progetto

I parametri di progetto per un componente posizionato da una libreria di database vengono creati/aggiunti al momento del posizionamento. Quali parametri vengano effettivamente creati e le opzioni usate per aggiornare le relative informazioni dopo il posizionamento, usando il comando Tools » Update Parameters From Database, sono determinati dalle informazioni di mappatura e aggiornamento specificate nel file Database Library/SVN Database Library. Queste impostazioni vengono eseguite nella scheda Field Mappings della vista documento principale.

Specificare le opzioni di mappatura dei parametri e di aggiornamento nella scheda Field Mappings del documento DbLib/SVNDbLib.

Mappatura di modelli e parametri

Le prime due colonne (da sinistra) nella scheda Field Mappings vengono usate per controllare quali informazioni del database devono essere mappate agli attributi, ai modelli e ai parametri del componente.

• Database Field Name - questa colonna elenca tutti i nomi di campo (colonna) nella tabella attualmente attiva del database.
• Design Parameter - questa colonna definisce come deve essere usato ciascun campo corrispondente nel database. Può trattarsi della sorgente del simbolo o del modello footprint di un componente (sarà racchiuso tra parentesi quadre), oppure dell’inclusione come parametro del componente (in questo caso non sarà racchiuso tra parentesi).

La mappatura iniziale viene eseguita automaticamente al momento della connessione al database, con tutti i campi del database mappati.

Attributi e modelli

Se il nome del campo del database è uno dei seguenti nomi riservati, la voce di mappatura attributo/modello corrispondente verrà impostata automaticamente nel campo Design Parameter:

• Description → [Description]
• Footprint Ref → [Footprint Ref]
• Footprint Path → [Footprint Path]
• Footprint Ref n → [Footprint Ref n]
• Footprint Path n → [Footprint Path n]

• Library Ref → [Library Ref]
• Library Path → [Library Path]
• Orcad Footprint → [Orcad Footprint]
• Orcad Library → [Orcad Library]

• PCB3D Ref → [PCB3D Ref]

• PCB3D Path → [PCB3D Path]

  • I riferimenti a PCB3D si riferiscono al visualizzatore 3D legacy; non dovrebbero essere usati per nuovi progetti. Il motore 3D nativo dell’editor PCB può eseguire il rendering dei corpi dei componenti e dei file di modello 3D importati associati ai footprint dei componenti.
  • Le mappature dei modelli PCB3D possono essere definite in un file SVNDbLib, tuttavia l’archiviazione delle librerie di modelli PCB3D nel repository Subversion non è supportata.
• Sim Description → [Sim Description]
• Sim Excluded Parts → [Sim Excluded Parts]
• Sim File → [Sim File]
• Sim Kind → [Sim Kind]
• Sim Model Name → [Sim Model Name]
• Sim Netlist → [Sim Netlist]
• Sim Parameters → [Sim Parameters]
• Sim Port Map → [Sim Port Map]
• Sim Spice Prefix → [Sim Spice Prefix]

• Sim SubKind → [Sim SubKind]

  Fare riferimento alla sezione Simulation Model Mapping qui sotto per ulteriori dettagli sui campi relativi ai modelli di simulazione.
  Per un componente in un database esterno può essere definito un solo collegamento a un modello di simulazione. In genere ci sarà sempre e solo un singolo modello di simulazione collegato a un componente. Se si desidera impostare più collegamenti a modelli di simulazione, gli altri collegamenti dovranno essere definiti e memorizzati con quel componente nel file della libreria schematica sorgente.
  I modelli di simulazione collegati sono supportati per una libreria di database con controllo di versione (SVNDbLib), tuttavia l’archiviazione dei file dei modelli di simulazione nel repository Subversion non è supportata.

Queste mappature definiscono le informazioni sugli attributi e sui modelli del componente. Quando il componente viene posizionato, il simbolo schematico specificato dal campo [Library Ref] del record di database corrispondente verrà estratto dalla libreria schematica specificata. Analogamente, le informazioni sul footprint PCB e sul modello di simulazione memorizzate nel record verranno aggiunte al componente rispettivamente come footprint collegato e modello di simulazione collegato.

La voce [Library Ref] deve esistere nella colonna Design Parameter ed essere mappata al Database Field Name che specifica il simbolo schematico, per poter posizionare un componente dalla Database Library/SVN Database Library su uno schema. Se la tabella del database contiene il riferimento al simbolo sotto un diverso Database Field Name, ad esempio SCH Symbol, sarà necessario impostare manualmente la voce Design Parameter associata per questo campo su [Library Ref], utilizzando l'elenco a discesa disponibile per quella cella.

Analogamente, se le informazioni di riferimento del modello vengono immesse nel database usando una denominazione dei campi diversa, sarà necessario eseguire la mappatura manualmente scegliendo la voce Design Parameter appropriata ([Footprint Ref], [Footprint Ref n], [PCB3D Ref], [Sim Model Name] e così via) dall'elenco a discesa, per ciascun campo a turno.

Per definire le informazioni su simbolo e modello per un componente al momento del posizionamento, i campi di riferimento del simbolo e del modello nel database sono le entità di mappatura cruciali
- assicurarsi che nella mappatura definita siano presenti un simbolo e almeno un riferimento a un footprint PCB.

Mappatura del modello di simulazione

Questa sezione discute ciascuno dei campi del database che possono essere aggiunti a una tabella di database esterna per definire il collegamento al modello di simulazione, che verrà creato al momento del posizionamento del componente.

• Sim Model Name – il nome del modello che si desidera utilizzare. Dopo il posizionamento del componente, queste informazioni appariranno nel campo Model Name della finestra di dialogo Sim Model.

  Quando si mappano i campi del database ai parametri di progetto nel file DBLib, il campo Sim Model Name è analogo ai campi Footprint Ref, Library Ref, ecc.
• Sim Description – una descrizione del modello collegato. Queste informazioni sono facoltative e non influiscono sul funzionamento del collegamento al modello di simulazione.

• Sim File – un particolare file di modello in cui trovare il modello di simulazione specificato nel campo Sim Model Name. Esistono diversi modi in cui questo campo può essere utilizzato:

  • È possibile immettere un percorso assoluto a un file di modello (ad esempio, C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl). Il modello specificato nel campo Sim Model Name verrà cercato all'interno di questo file e utilizzato se trovato.
  • È possibile immettere un percorso relativo (relativo al file DbLib) a un file di modello (ad esempio, Libraries\JAS33.mdl). Il modello specificato nel campo Sim Model Name verrà cercato all'interno di questo file e utilizzato se trovato.
  • È possibile immettere solo il nome file del modello (ad esempio, JAS33.mdl). I percorsi di ricerca definiti come parte del file DbLib verranno utilizzati per individuare il primo file di modello che corrisponde al nome specificato e che contiene una corrispondenza per il modello specificato nel campo Sim Model Name.
  • È possibile lasciare il campo vuoto. I percorsi di ricerca definiti come parte del file DbLib verranno utilizzati per individuare il primo file di modello contenente una corrispondenza per il modello specificato nel campo Sim Model Name.
  I percorsi di ricerca sono definiti per il file DbLib dalla scheda Symbol & Model Search Paths della finestra di dialogo Database Library Options (Tools » Options).
• Sim Kind – la categoria padre del modello collegato.
• Sim SubKind – il tipo di modello collegato.

• Sim Netlist – le informazioni del modello di netlist, in conformità con il tipo di modello collegato. Questo campo diventa particolarmente importante se si sta specificando un proprio modello di netlist e si è impostato il campo Sim SubKind su Generic Editor, ottenendo così un maggiore controllo su quali informazioni vengono inserite nella netlist.

  Questo campo deve essere definito e non lasciato vuoto, altrimenti non verrà creata alcuna voce per il modello nella netlist di simulazione e la parte non verrà simulata quando posizionata dalla libreria di database.
  Netlist Template Syntax

  Quando si definisce il modello di netlist, le informazioni immesse devono essere conformi ai requisiti di SPICE e alle regole di sintassi descritte di seguito.

  I caratteri immessi nel modello vengono scritti nella netlist SPICE alla lettera, ad eccezione dei seguenti caratteri speciali:

  %	segno di percentuale
  @	chiocciola
  &	e commerciale
  ?	punto interrogativo
  ~	tilde
  #	cancelletto

  Questi caratteri vengono tradotti durante la creazione della netlist, come mostrato nella tabella seguente:

  Sintassi nel modello di netlist...	Il netlister sostituisce con...
  @<param>	Valore di <param>.  Viene generato un errore se un parametro con questo nome non esiste o se non gli è assegnato alcun valore.
  &<param>	Valore di <param>.  Non viene generato alcun errore se il parametro non è definito.
  ?<param>s...s	Testo tra i separatori s...s se <param> è definito.
  ?<param>s...ss...s	Testo tra il primo gruppo di separatori s...s se <param> è definito, altrimenti quello tra il secondo gruppo di separatori s...s.
  ~<param>s...s	Testo tra i separatori s...s se <param> NON è definito.
  ~<param>s...ss...s	Testo tra il primo gruppo di separatori s...s se <param> NON è definito, altrimenti quello tra il secondo gruppo di separatori s...s.
  #<param>s...s	Testo tra i separatori s...s se <param> è definito, ma ignora il resto del modello se <param> NON è definito.
  #s...s	Testo tra i separatori s...s se c'è del testo da inserire nella netlist XSpice dalle voci successive nel modello di netlist.
  %<pin id>	Il nome della net a cui è collegato il pin schematico mappato a <pin id>.
  %%	Un carattere percentuale letterale.

  Nella tabella sopra,

  • s rappresenta un carattere separatore (, . ; / |).
  • <param> si riferisce al nome di un parametro.

  Se il nome del parametro contiene caratteri non alfanumerici, deve essere racchiuso tra virgolette doppie. Ad esempio:

  @"DC Magnitude" - qui vengono usate le virgolette doppie perché il nome contiene uno spazio.
  &"Init_Cond" - qui vengono usate le virgolette doppie perché il nome contiene un trattino basso.

  Le virgolette doppie devono essere usate anche quando si desidera aggiungere un prefisso alfanumerico al nome di un parametro. Ad esempio:

  @"DESIGNATOR"A - l'uso delle virgolette doppie garantisce che A venga aggiunta al designatore del componente.

  Di seguito sono riportati esempi delle voci di sintassi con caratteri speciali nella tabella precedente. In ciascun caso vengono fornite informazioni su come la voce di sintassi viene tradotta dal Netlister.

  @"AC Phase"

  Il nome del parametro AC Phase è racchiuso tra parentesi graffe a causa dello spazio. Questo verrà sostituito nella netlist con il valore del parametro AC Phase. Se non esiste un parametro con questo nome, o se il suo valore è vuoto, verrà generato un errore.

  &Area

  Se esiste un parametro denominato Area e ha un valore, allora il suo valore verrà inserito nella netlist. Se il parametro non è definito (cioè non esiste oppure non gli è assegnato alcun valore), non verrà scritto nulla nella netlist, ma non verrà generato alcun errore. Questo può essere usato per parametri facoltativi.

  ?IC|IC=@IC|

  Se il parametro denominato IC è definito, allora il testo all'interno dei separatori || verrà inserito nella netlist. Ad esempio, se il parametro IC avesse valore 0.5, allora IC=0.5 verrebbe inserito nella netlist al posto di questa voce. Se il parametro non è definito, non verrà inserito nulla nella netlist.

  ?IC/IC=@IC//IC=0/

  Questo è uguale all'esempio precedente, tranne per il fatto che se il parametro IC non è definito allora IC=0 verrà inserito nella netlist. Si noti inoltre che è stato usato un carattere separatore diverso.

  ~VALUE/1k/

  Se un parametro denominato VALUE NON è definito, allora il testo 1k verrà inserito nella netlist.

  ~VALUE/1k//@VALUE/

  Questo è uguale all'esempio precedente, tranne per il fatto che se il parametro VALUE è definito, allora il suo valore testuale verrà inserito nella netlist.

  #"AC Magnitude"|AC@"AC Magnitude"|@"AC Phase"

  Questo esempio può essere visto nel modello di netlist predefinito per la sorgente di tensione sinusoidale.

  Se il parametro AC Magnitude è stato definito, allora il contenuto dei separatori viene valutato e inserito nella netlist. Anche tutte le voci successive nella netlist vengono valutate e inserite nella netlist (in questo caso @"AC Phase").

  Se, ad esempio, AC Magnitude=1 e AC Phase=0, allora AC 1 0 verrà inserito nella netlist. Se invece AC Phase non fosse definito, verrebbe generato un errore.

  Se il parametro AC Magnitude non è definito, allora nulla di ciò che segue la voce #"AC Magnitude" nel modello di netlist verrà inserito nella netlist.

  #|PARAMS:|?Resistance|Resistance=Resistance|?Current|Current=@Current|

  Questo esempio può essere visto nel modello di netlist predefinito per un sottocircuito parametrizzato (vedere F1 in Fuse.PrjPcb).

  Se i parametri Resistance e Current sono entrambi non definiti, non verrà inserito alcun testo nella netlist dopo la voce #|PARAMS:|, quindi anche il testo nei separatori verrà omesso.

  Se, ad esempio, i parametri hanno i valori Resistance=1k e Current=5mA, questo produrrà del testo dopo la voce #|PARAMS:| e PARAMS: Resistance=1k Current=5mA sarà la voce inserita nella netlist.

  @DESIGNATOR%1%2@VALUE

  Questo esempio serve a dimostrare l’uso del carattere %.

  Se, ad esempio, i parametri hanno i valori DESIGNATOR=R1 e VALUE=1k, e i pin sono mappati nella regione Pin Mapping della finestra di dialogo Sim Model secondo la tabella seguente:

  Pin schematico	Pin del modello	Nome della net a cui è collegato il pin schematico
  1 (N+)	1 (1)	GND
  2 (N-)	2 (2)	OUT

  Allora il testo R1 GND OUT 1k verrà inserito nella netlist SPICE per questo componente.
• Sim Spice Prefix – il prefisso SPICE per il tipo di modello a cui si sta effettuando il collegamento.

• Sim Port Map – la mappatura dei pin dal componente schematico ai pin del modello collegato. Dopo il posizionamento del componente, queste informazioni appariranno nella regione Pin Mapping della finestra di dialogo Sim Model.

  Ogni coppia di pin deve essere inserita nel seguente formato:

  (SchematicPinNumber:ModelPinNumber),

  con ogni coppia mappata separata da una virgola.

  Ad esempio, durante la mappatura di un modello di simulazione diodo in cui il pin schematico 1 (anodo) deve essere mappato al pin 1 del modello (anodo), e il pin schematico 3 (catodo) deve essere mappato al pin 2 del modello (catodo), questo verrebbe inserito nel campo del database come:

  (1:1),(3:2)

• Sim Excluded Parts – creare questo campo nel database se si desidera escludere dalla simulazione determinate parti di un componente multipart. Queste informazioni corrispondono all’opzione Exclude part from simulation nella regione Pin Mapping della finestra di dialogo Sim Model.

  Per impostazione predefinita, tutte le parti di un componente multipart sono incluse in una simulazione, quindi è necessario specificare solo le parti che si desidera escludere, tramite numero. Separare più parti nell’elenco di esclusione usando virgole. Ad esempio, se un componente ha quattro parti e non si desidera che le parti 2 e 4 siano incluse in alcuna simulazione, allora si inserirà quanto segue nel campo del database:

  2,4

• Sim Parameters – creare questo campo nel database se si desidera assegnare valori ai parametri di simulazione del modello. Si tratta di parametri che possono essere definiti a livello di componente, in contrapposizione ai parametri più avanzati che possono essere inclusi in un file di modello.

  Un parametro deve essere inserito nel seguente formato:

  ParameterName=Value,

  I parametri multipli devono essere separati dal carattere pipe (|).

  Si ricorderà che un parametro di simulazione a livello di componente può anche essere impostato come parametro del componente, comparendo nella regione Parameters della relativa finestra di dialogo Component Properties, con la possibilità di essere poi visualizzato sul foglio schematico. Per impostazione predefinita, una voce di parametro nel campo Sim Parameters verrà aggiunta automaticamente come parametro del componente. Se non si desidera che un parametro di simulazione venga aggiunto come parametro del componente, è sufficiente aggiungere un punto esclamativo come prefisso al nome del parametro (ad esempio, !Initial Voltage=100mV).

  Si consideri un modello diodo, che ha i seguenti quattro parametri a livello di componente:

  • Fattore di area
  • Condizione iniziale
  • Tensione iniziale
  • Temperatura.

  Ora si consideri l’aggiunta nel database di valori per il Fattore di area (ad esempio 2) e la Temperatura (ad esempio 22°C). Inoltre, nessuno di questi due deve essere aggiunto come parametro del componente. La voce nel campo Sim Parameters sarà:

  !Area Factor=2|!Temperature=22

Parametri

Tutti gli altri nomi di campo del database verranno mappati automaticamente ai parametri di progetto usando gli stessi nomi. Ad esempio, se un campo nel database si chiama Tolerance, verrà mappato a un parametro di progetto con il nome Tolerance. È possibile modificare il nome di un parametro di progetto facendo clic nella relativa cella e digitando direttamente il nuovo nome. Sono questi nomi dei parametri di progetto che appariranno nella regione Parameters della finestra di dialogo delle proprietà associata al componente, una volta che questo sarà stato posizionato su un foglio schematico.

È possibile che a un componente nel database siano associati molti campi dati, non tutti desiderati o necessari come parametri di progetto del componente quando viene posizionato su un foglio schematico. Gran parte di queste informazioni potrebbe essere richiesta solo durante la generazione di una distinta base. La finestra di dialogo Report Manager dialog consente di aggiungere informazioni sui parametri a una BOM direttamente da un database collegato, permettendo di ridurre la quantità di informazioni che vengono “trasportate” con i documenti sorgente dello schema. Per ulteriori informazioni, fare riferimento alla sezione Preparazione di una BOM nel Report Manager.

Per i campi che esplicitamente non si desidera mappare dal database, impostare la voce Design Parameter su [None]. I campi del database non mappati sono contraddistinti nella scheda dall’uso di un’icona con croce rossa (). I campi del database mappati sono contraddistinti da un’icona con segno di spunta verde ().

Configurare la mappatura dei parametri secondo necessità. Impostare su [None] per impedire che un parametro nel database venga mappato al componente posizionato. I parametri non mappati possono essere inclusi direttamente nella BOM, se necessario.

Opzioni di aggiornamento dei parametri

Le colonne rimanenti nella scheda Field Mappings consentono di specificare le azioni da eseguire sui parametri quando si posiziona un componente dalla libreria database per la prima volta, oppure quando si aggiorna un componente dopo che è stato posizionato usando il comando Tools » Update Parameters From Database.

Le quattro colonne sono le seguenti:

• Update Values - una cella in questa colonna viene usata per determinare l’azione da intraprendere se il parametro esiste sia sul foglio schematico sia nel database, ma i valori sono attualmente diversi. È possibile scegliere di aggiornare il parametro del componente posizionato con il valore memorizzato nel database (Update), oppure di non aggiornarlo affatto (Do not update). Questa opzione viene rispettata quando si usa il comando Update Parameters From Database, dopo che il componente è stato posizionato.
• Add To Design - una cella in questa colonna viene usata per determinare l’azione da intraprendere se il parametro viene trovato nel database, ma non esiste per il componente posizionato. È possibile scegliere di aggiungere il parametro (Add), di non aggiungerlo (Do not add), oppure di aggiungerlo solo se nel database gli è assegnato un valore (Add only if not blank in database). Questa opzione viene rispettata sia quando si posiziona inizialmente il componente dalla libreria database sia quando si usa il comando Update Parameters From Database, dopo che il componente è stato posizionato.
• Visible On Add - una casella di controllo in questa colonna viene usata per determinare se un parametro appena aggiunto, risultante dal posizionamento iniziale o da un aggiornamento successivo al posizionamento, venga reso visibile per il componente sul foglio schematico (abilitato) oppure no (disabilitato).
• Remove From Design - una cella in questa colonna viene usata per determinare l’azione da intraprendere se si rileva che il parametro esiste per il componente posizionato, ma o non è presente nel database, oppure lo è ma non ha alcun valore. È possibile scegliere di non rimuovere affatto il parametro (Do not remove), oppure di rimuoverlo solo se nel database non gli è assegnato alcun valore (Remove only if blank in database). Questa opzione viene rispettata quando si usa il comando Update Parameters From Database, dopo che il componente è stato posizionato.

Inizialmente, i campi Update Values, Add To Design e Remove From Design - per ogni campo del database mappato - saranno impostati sulla voce Default, e l’opzione Visible On Add sarà disabilitata, come illustrato nell’immagine seguente.

Opzioni iniziali (predefinite) di aggiornamento dei parametri.

Osservando l’immagine, ci sono quattro punti importanti da evidenziare riguardo alle opzioni di aggiornamento:

1. I campi del database non mappati non avranno opzioni di aggiornamento associate.
2. Le mappature basate su attributi e modelli (voci con parentesi quadre nella colonna Design Parameter) non avranno opzioni di aggiornamento associate, poiché non sono parametri di progetto.
3. Il campo chiave (ad esempio Part Number nell’immagine) non avrà opzioni di aggiornamento associate. Questo campo viene usato esclusivamente per finalità di corrispondenza dei parametri.
4. Un’impostazione di Default fa sì che un’opzione di aggiornamento segua la corrispondente definizione predefinita, come specificato nella scheda Default Actions della finestra di dialogo Database Library Options (Tools » Options dal menu principale oppure Options dal menu contestuale della scheda Table Browser). È possibile accedere a questa finestra di dialogo anche facendo clic sul pulsante Options nell’area Field Settings della vista documento.

Definisci le opzioni predefinite di aggiornamento dei parametri in una posizione centrale per una DbLib. Passa il cursore sull’immagine per vedere l’equivalente per una SVNDbLib.

Il quarto punto è vantaggioso perché consente di specificare le opzioni di aggiornamento da una posizione centrale e quindi fare riferimento a tale posizione quando si definiscono le opzioni di aggiornamento per ciascun campo mappato. Per questo motivo, la voce Default viene caricata automaticamente nei campi di aggiornamento pertinenti quando un campo del database viene mappato a un parametro di progetto.

Se desideri sovrascrivere l’impostazione predefinita per un’opzione di aggiornamento, fai clic all’interno del campo di aggiornamento pertinente, nella scheda Field Mappings, quindi fai nuovamente clic per accedere a un menu a discesa che fornisce le scelte di aggiornamento applicabili.

Le opzioni di aggiornamento dei parametri possono essere sovrascritte manualmente, se necessario.

In questo modo, hai il pieno controllo su come vengono aggiornati i parametri nel progetto. Puoi impostare tutti i campi su Default ed effettuare le decisioni di aggiornamento richieste dalla finestra di dialogo Database Library Options, impostare singolarmente ciascun campo di aggiornamento oppure usare una combinazione delle due modalità: la decisione spetta interamente a te, in base alle tue esigenze. Per i componenti posizionati, l’aggiornamento, quando eseguito, viene effettuato tramite una finestra di dialogo Engineering Change Order. Se in questa fase ci sono aggiornamenti che preferisci non eseguire, puoi scegliere di non includere tali modifiche specifiche, avendo così l’ultima e definitiva parola su quali parametri di progetto vengano aggiornati.

Specifica delle posizioni delle librerie di simboli e modelli

Quando posizioni un componente da una libreria di database, il suo simbolo, specificato dalla mappatura [Library Ref], viene estratto dalla libreria schematica specificata (*.SchLib). Analogamente, tutti i riferimenti ai modelli (footprint, PCB3D, simulazione) specificati nel database risiederanno nei file sottostanti di PCB Library (*.PcbLib), PCB3D Library (*.PCB3DLib) e Simulation Model (*.mdl, *.ckt). I percorsi verso questi file possono essere specificati esplicitamente nel database:

• Inserendo un percorso assoluto al file.
• Inserendo un percorso relativo al file.

Se hai definito nel database campi per le informazioni di percorso, questi campi devono essere mappati ai parametri di progetto appropriati: [Library Path], [Footprint Path], [PCB3D Path], [Sim File] e così via (vedi Model and Parameter Mapping).

L’inserimento dei percorsi, anche relativi, in una tabella di database può essere un po’ limitante. Se sposti la posizione di una libreria o di un file modello, dovrai aggiornare di conseguenza la tabella del database. Per offrirti maggiore libertà, puoi specificare le informazioni di ricerca delle librerie direttamente nel file DbLib/SVNDbLib. Questo ti consente di specificare nel database il nome della libreria sorgente o del file modello, oppure di non definirlo affatto.

Per una Database Library

Per una DbLib, i percorsi di ricerca delle librerie sono definiti nella scheda Symbol and Model Search Paths della finestra di dialogo Database Library Options (Tools » Options). È possibile accedere a questa finestra di dialogo anche facendo clic sul pulsante Options nell’area Field Settings della vista documento.

Specifica dei percorsi di ricerca per le librerie di simboli e modelli.

Per aggiungere un percorso all’elenco:

1. Inserisci direttamente il percorso nel campo sotto l’area Library Search Paths oppure fai clic sul pulsante  per accedere alla finestra di dialogo Browse for Folder, dalla quale puoi individuare la directory in cui risiedono i file di libreria/modello richiesti.
2. Puoi aggiungere sia un percorso completo sia un percorso relativo (relativo alla posizione del file DbLib). Controlla questo comportamento usando l’opzione Add/Update As Relative Path.
3. Dopo aver specificato il percorso richiesto, aggiungilo all’elenco dei percorsi di ricerca facendo clic sul pulsante Add .
4. Continua ad aggiungere ulteriori percorsi di ricerca secondo necessità.

I percorsi di ricerca delle librerie determinano dove possono essere trovati i file di libreria e modello quando si effettua il posizionamento dalla libreria di database e quando si cerca un modello dopo il posizionamento. Il modello specifico utilizzato dipenderà da come hai configurato i percorsi di ricerca delle librerie e dal fatto che tu abbia aggiunto informazioni specifiche sulla libreria nel database. La ricerca procederà nel seguente ordine:

1. Se nel campo di percorso mappato per il simbolo o il modello esiste un percorso completo, usa quel file di libreria/modello ed estrai il simbolo o il modello specificato nel campo di riferimento applicabile.
2. Se nel campo di percorso mappato per il simbolo o il modello esiste un percorso relativo, usa quel file di libreria/modello ed estrai il simbolo o il modello specificato nel campo di riferimento applicabile.
3. Se nel campo di percorso mappato per il simbolo o il modello esiste solo il nome di un file di libreria/modello, usa i percorsi di ricerca per individuare il primo file di libreria/modello che corrisponde al nome specificato e che contiene una corrispondenza per il simbolo o il modello specificato nel campo di riferimento applicabile.
4. Se nel database non esistono informazioni sul file di libreria/modello, usa i percorsi di ricerca per individuare il primo file di libreria/modello che contiene una corrispondenza per il simbolo o il modello specificato nel campo di riferimento applicabile.

Per una SVN Database Library

Per una SVNDbLib, le directory di base all’interno del repository Subversion, nelle quali risiedono i simboli e i modelli footprint, sono specificate nella scheda SVN Repository della finestra di dialogo Database Library Options (Tools » Options). È possibile accedere a questa finestra di dialogo anche facendo clic sul pulsante Options nell’area Field Settings della vista documento.

Specifica delle directory di base del repository per simboli e footprint.

Usa i campi disponibili nell’area Models Location per specificare la directory di base per simboli e footprint. Fai clic sul pulsante  a destra di un campo per accedere alla finestra di dialogo Browse for directory, una finestra sul repository collegato. Usa questa finestra di dialogo per selezionare la cartella richiesta.

Ricerca della directory pertinente nel repository SVN collegato.

Le posizioni dei modelli determinano dove possono essere trovati i file di libreria e modello quando si effettua il posizionamento dalla libreria di database con controllo di versione e quando si cerca un modello dopo il posizionamento. I simboli schematici specifici e i modelli footprint utilizzati dipenderanno da come hai configurato queste posizioni e dal fatto che tu abbia aggiunto informazioni specifiche sulla libreria nel database. La ricerca procederà nel seguente ordine:

1. Se nel campo di percorso mappato per il simbolo o il modello footprint esiste un percorso completo (ad esempio http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), usa quel file di libreria ed estrai il simbolo o il footprint specificato nel campo di riferimento applicabile.
2. Se nel campo di percorso mappato per il simbolo o il modello footprint esiste un percorso relativo (relativo alla radice del repository) (ad esempio /ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), usa quel file di libreria ed estrai il simbolo o il footprint specificato nel campo di riferimento applicabile. L’URL del repository, specificato nell’area Repository Server Connection della finestra di dialogo, verrà anteposto al percorso inserito per ottenere l’indirizzo assoluto.
3. Se nel campo di percorso mappato per il simbolo o il modello footprint esiste solo il nome di un file di libreria (ad esempio Capacitor_NonPolarized.SchLib), usa le posizioni dei modelli specificate nel repository per individuare il primo file di libreria che corrisponde al nome specificato e che contiene una corrispondenza per il simbolo o il modello footprint specificato nel campo di riferimento applicabile.

4. Se nel database non esistono informazioni sul file di libreria, usa le posizioni dei modelli specificate per individuare il primo file di libreria che contiene una corrispondenza per il simbolo o il modello footprint specificato nel campo di riferimento applicabile.