Gestione delle librerie disponibili basate su database e su file
In Altium Designer, i componenti delle librerie basate su database e su file possono essere posizionati solo da librerie attualmente disponibili. Queste includono:
-
Libraries in the current project – se una libreria fa parte del progetto, i suoi componenti sono automaticamente disponibili per il posizionamento all'interno di quel progetto.
-
Installed libraries – queste librerie sono state installate in Altium Designer; i loro componenti sono disponibili per l'uso in qualsiasi progetto aperto.
-
Libraries on a defined search path – è anche possibile definire un percorso di ricerca verso una cartella con più librerie. Poiché tutti i file nel percorso di ricerca vengono esaminati ogni volta che viene scelto un nuovo componente in un pannello, questo approccio è consigliato solo per librerie piccole con definizioni di modello semplici, come i modelli di simulazione. I percorsi di ricerca non sono consigliati per modelli complessi, come le impronte che includono modelli 3D.
Per gestire le librerie disponibili basate su database e su file, è possibile utilizzare la finestra di dialogo Libraries Preferences, a cui si accede facendo clic sul pulsante 
nella parte superiore del pannello Components e selezionando Libraries Preferences dal menu.
La finestra di dialogo Libraries Preferences dispone di tre schede. Tutte le librerie e le posizioni dei modelli definite in queste schede vengono raccolte per comporre l'elenco delle librerie disponibili. Quando viene eseguita un'azione che richiede la ricerca di un modello, ad esempio il trasferimento del progetto dallo schema al layout PCB, le librerie vengono cercate nell'ordine delle schede e poi, all'interno di ciascuna scheda, nell'ordine in cui librerie/modelli sono elencati. Non appena viene individuato il modello corretto, il processo di ricerca si interrompe.
Librerie di progetto
Le librerie che fanno parte del progetto attivo sono elencate nella scheda Project della finestra di dialogo Libraries Preferences quando quel progetto è il progetto attivo nel software. Il vantaggio delle librerie di progetto è che i modelli/le librerie diventano automaticamente disponibili ogni volta che il progetto viene aperto. Lo svantaggio è che, se i modelli/le librerie non sono memorizzati nella stessa struttura di cartelle del progetto dei file di progettazione, possono essere facilmente dimenticati se i file del progetto vengono spostati.
La scheda Project fornisce un elenco delle librerie disponibili nel progetto corrente.
Qualsiasi libreria può essere una libreria di progetto; non è necessario che sia memorizzata nella cartella del progetto. Per includere librerie nel progetto, fare clic con il pulsante destro del mouse sul nome del progetto nel pannello Projects e selezionare il comando Add Existing to Project.
Librerie installate
Le librerie e i modelli resi disponibili nell'installazione del software sono denominati librerie installate. Questi sono elencati nella scheda Installed della finestra di dialogo Libraries Preferences.
Questo elenco è un'impostazione dell'ambiente. Qualsiasi libreria aggiunta all'elenco sarà disponibile per tutti i progetti e l'elenco viene mantenuto tra una sessione di progettazione e l'altra. Le librerie di progetto possono essere aggiunte a questo elenco, ma inizialmente non ne fanno parte.
Le librerie installate possono essere elencate utilizzando un percorso assoluto o un percorso relativo all'impostazione Library Path Relative To. Il vantaggio dell'uso di un percorso relativo è che consente di creare un sottoambiente comune su più PC, permettendo di spostare facilmente i file di progettazione tra di essi. Inoltre, le librerie installate possono essere temporaneamente disattivate deselezionando la casella di controllo Activated, invece di rimuoverle.
Solo le librerie Activated sono accessibili dal pannello Components.
La scheda Installed elenca le librerie rese disponibili in questa installazione di Altium Designer.
Quando si è connessi a un Workspace Altium 365, viene inoltre presentato un riepilogo dello stato di integrità della Workspace Library. Questo mostra, a colpo d'occhio, il numero di componenti completamente integri e il numero di componenti che presentano almeno un problema. Fare clic sul controllo See Details per aprire la pagina Components dell'interfaccia browser del Workspace nel browser web predefinito.
Quando si è connessi a un Workspace Altium 365, è possibile importare nel Workspace una libreria installata attualmente selezionata nell'area griglia della finestra di dialogo facendo clic su
Import nella colonna più a destra. Si aprirà il
Library Importer in modalità semplice con la libreria selezionata caricata.
Percorso di ricerca
La scheda Search Path presenta un elenco di librerie individuate in base alle impostazioni di percorso definite nella scheda Search Paths della finestra di dialogo Project Options, a cui si accede facendo clic sul pulsante Paths. Ogni percorso di ricerca definisce una cartella e può includere sottocartelle se l'opzione Recursive è abilitata (disponibile nella scheda Search Paths della finestra di dialogo Project Options dopo l'aggiunta di un percorso). Tutti i file di modello e di libreria trovati nel percorso di ricerca saranno disponibili. I percorsi di ricerca vengono salvati con il progetto.
Fare clic sul pulsante Refresh per aggiornare l'elenco in base ai percorsi di ricerca più recenti (definiti nella scheda Search Paths della finestra di dialogo Project Options ).
La scheda Search Path elenca le librerie trovate nei percorsi di ricerca definiti.
La scheda Search Paths della finestra di dialogo Project Options è disponibile quando l'opzione UI.ProjectOptions.SearchPaths è abilitata nella finestra di dialogo Advanced Settings.
Il recupero dei modelli tramite percorsi di ricerca può essere lento se nelle cartelle del percorso di ricerca è presente un numero elevato di file. Per questo motivo, non è consigliato utilizzare questo approccio per le librerie PCB, poiché possono essere file di grandi dimensioni contenenti molte impronte. La funzionalità è stata sviluppata per fornire un modo per fare riferimento ai modelli di simulazione e di integrità del segnale disponibili.
Sebbene il software offra flessibilità e controllo sulle posizioni specifiche di modelli/librerie, richiede l'uso dell'estensione file corretta per ciascun tipo di modello. Ad esempio, un'impronta verrà trovata solo se si trova in un file con estensione .Lib o .PcbLib. Analogamente, un file SPICE *.SUBCKT verrà trovato solo se si trova in un file .ckt e un file SPICE *.MODEL verrà trovato solo se si trova in un file .mdl. Ogni volta che la ricerca di un modello non produce alcuna corrispondenza, viene visualizzato un errore nel pannello Messages.
Browsing the Database Components
Una volta che il file DbLib/SVNDbLib è stato aggiunto all'elenco delle librerie disponibili basate su file, i componenti nel database diventano disponibili per la consultazione nel pannello Components. Sebbene venga aggiunto un solo file DbLib/SVNDbLib, ogni tabella nel database collegato verrà presentata come se fosse una libreria distinta.
Ricordare che se il database di destinazione è stato creato utilizzando più file di fogli di calcolo Excel (*.xls), a causa delle limitazioni del driver ODBC, il numero di fogli che possono essere collegati è limitato a 64.
L'elenco a discesa superiore nel pannello verrà popolato con voci nella forma:
-
<LibraryName>.DbLib - <TableName> o <LibraryName>.SVNDbLib - <TableName> ----dove il database contiene tabelle
-
<LibraryName>.DbLib - <SheetName>$ o <LibraryName>.SVNDbLib - <SheetName>$ ----dove il database è composto da fogli in un foglio di calcolo Excel.
Esempio di un DbLib caricato con tre tabelle, un altro con una tabella e un SVNDbLib con una tabella.
Ogni voce di componente nel pannello corrisponde a un record in quella particolare tabella del database. Di fatto, durante la consultazione delle librerie database caricate, il pannello Components si comporta come un browser diretto del database. Le informazioni su simboli e modelli vengono popolate dalle librerie di simboli e modelli sottostanti indicate dai campi pertinenti del database (e in combinazione con i percorsi/posizioni di ricerca definiti).
Consultazione dei componenti in un database esterno collegato tramite una libreria database.
Per impostazione predefinita, nella regione di elenco dei componenti del pannello vengono visualizzati solo i campi Part Number e Library Ref. Per "esporre" altri campi nella tabella del database, fare clic con il pulsante destro del mouse nella regione e scegliere Select Columns dal menu contestuale. Questo consente di accedere alla finestra di dialogo Select Columns, nella quale è possibile abilitare la visualizzazione di uno qualsiasi dei campi aggiuntivi in quella tabella.
Cache locale di simboli e modelli utilizzati dalle librerie database SVN
Quando un file SVNDbLib viene aggiunto all'elenco delle librerie disponibili, le librerie di simboli e modelli nel repository vengono memorizzate nella cache in una cartella temporanea locale al computer del progettista. Quando un'azione nel software richiede l'uso di un simbolo schematico o di un modello, quel simbolo/modello viene recuperato dalla cache locale.
Aggiornamento automatico della cache
Le librerie nella cache verranno aggiornate automaticamente con le versioni più recenti dal repository di controllo del codice sorgente quando viene eseguita una delle seguenti azioni nel software:
-
Posizionamento di un componente da un file SVNDbLib installato (dal pannello Components).
-
Esecuzione di un trasferimento del progetto (ovvero aggiornamento del PCB).
-
Uso del comando Tools » Update From Libraries nello Schematic Editor.
-
Uso del comando Tools » Update From PCB Libraries nel PCB Editor.
Sebbene l'aggiornamento sia automatico, può essere controllato tramite l'opzione Do not check files more often than xx minutes nella pagina Data Management - SVN Libraries della finestra di dialogo Preferences. Questa opzione fornisce essenzialmente un "timer di aggiornamento" per la cache locale. Se è trascorso il tempo specificato dall'ultima volta che la cache è stata aggiornata, la cache verrà aggiornata automaticamente quando viene eseguita una delle azioni elencate. Se un'azione viene eseguita entro questo intervallo di tempo, verrà utilizzato il contenuto corrente della cache, che potrebbe non essere aggiornato rispetto al contenuto del repository.
Forzare manualmente un aggiornamento della cache
Potrebbero esserci momenti in cui desideri forzare un aggiornamento della cache locale, per assicurarti di avere le librerie più aggiornate attualmente archiviate nel repository di controllo del codice sorgente. Ad esempio, quando ti prepari a trasferire il progetto dallo schema al PCB.
Puoi forzare manualmente un aggiornamento della cache utilizzando uno dei seguenti metodi:
-
Utilizzando uno dei Refresh comandi disponibili dal menu contestuale accessibile con il clic destro nel pannello Components.
-
Disinstallando e reinstallando il file SVNDbLib nell'elenco delle librerie disponibili.
Ogni volta che riavvii Altium Designer, la cache locale verrà aggiornata automaticamente con le librerie più recenti archiviate nel repository SVN.
Ricerca di componenti nelle librerie basate su database e su file
Per facilitare l'individuazione di un componente nelle librerie basate su file (sia installate sia non attualmente installate) e nelle librerie database, Altium Designer include una funzione di ricerca delle librerie.
È possibile cercare un componente nelle librerie database e basate su file utilizzando il campo Search del ComponentspannelloEnter. Inserisci una stringa e premi Enter per cercare tale stringa nella libreria corrente, in qualsiasi punto dei parametri visibili del componente.
Puoi eseguire una ricerca direttamente nel Componentspannello.
La finestra di dialogo File-based Libraries Search consente ricerche più dettagliate. Vi si accede facendo clic sul pulsante nel Componentspannello e selezionando File-based Libraries Search dal menu. La metà superiore della finestra di dialogo viene utilizzata per definire what stai cercando; la metà inferiore viene utilizzata per definire where cercare.
Cerca nelle librerie installate (Available libraries) oppure nelle librerie sul disco rigido (Libraries on path).Il processo di ricerca può essere riassunto come segue:
-
La ricerca viene eseguita definendo Filters che vengono applicati a tutte le librerie ricercabili in base alle impostazioni correnti di Scope della ricerca.
-
Il Scope include il tipo di librerie da cercare. È possibile cercare un solo tipo alla volta.
-
Per abilitare la ricerca dei componenti database, imposta il campo Search in su Database Components e seleziona la Table richiesta. Nota che i Fields disponibili elencati nel menu a discesa sopra cambieranno per riflettere le intestazioni di colonna disponibili nella tabella scelta. Le restanti opzioni nella finestra di dialogo diventano disattivate, poiché non sono pertinenti durante la ricerca nelle librerie database.
-
Il Scope definisce quali librerie verranno cercate: o le librerie a cui il software ha attualmente accesso (Available libraries) oppure tutte le librerie all'interno di una cartella (Libraries on path).
-
Quando si cercano librerie in un percorso, la destinazione è una cartella specifica e può anche Include Subdirectories.
-
Puoi anche cercare all'interno dei risultati della ricerca impostando Scope su Refine last search.
-
Fai clic su Clear per cancellare i parametri di ricerca immessi.
Impostazione del filtro di ricerca
L'area Filters viene utilizzata per definire le stringhe di testo da applicare alla ricerca. Ci sono tre aree da configurare:
-
Field – questo è l'attributo del componente che deve essere cercato. Può essere qualsiasi attributo del componente o del footprint, inclusi Name, Description, Comment, Footprint o qualsiasi parametro aggiunto a un componente. Seleziona un campo disponibile dal menu a discesa oppure inserisci un campo nella casella di testo.
-
Operator – definisce come viene determinata una corrispondenza. Questo può avvenire quando il valore equals, contains, starts with oppure ends with. Nota che equals richiedono una corrispondenza esatta della stringa, quindi dovrebbero essere usati solo quando sei certo che la stringa di ricerca sia corretta e completa.
-
Value – i caratteri da cercare nel Field scelto, con corrispondenza determinata in base al Operator selezionato. Seleziona un valore disponibile dal menu a discesa oppure inserisci un valore nel campo di testo.
Per impostazione predefinita, sono presenti tre vincoli di filtro; puoi aggiungere fino a sette righe aggiuntive per un totale di 10 righe utilizzando il controllo Add Row. L'ultima riga di vincolo del filtro aggiunta può essere rimossa utilizzando Remove Row. Puoi rimuovere le righe non utilizzate.
Impostazione dell'ambito
Esistono essenzialmente due approcci alla ricerca:
-
Librerie attualmente disponibili – questo è l'elenco delle librerie mostrato nel menu a discesa nella parte superiore del Components pannello.
-
Librerie archiviate in una cartella specifica insieme alle sottodirectory, se l'opzione è abilitata.
La ricerca restituirà tutti gli elementi del tipo di ricerca scelto nel menu a discesa Search in (Components/Footprints/3D Models/Database Components) trovati in tutte le librerie che rientrano nell'Scope definito:
-
Available libraries - abilita per cercare i tipi di modello specificati solo nelle librerie disponibili.
-
Libraries on path - abilita per cercare i tipi di modello specificati nelle librerie disponibili in una o più cartelle specificate. Nell'area Path della finestra di dialogo, che diventa disponibile con l'opzione di ambito Libraries on path selezionata, puoi definire il percorso, includere le sottodirectory e includere la maschera del file di libreria per specificare e restringere i criteri di ricerca:
-
Path - modifica per definire la cartella in cui cercare le librerie oppure fai clic sull'icona di sfoglia alla fine del campo per cercare una cartella.
-
Include Subdirectories - abilita se desideri cercare le librerie nel percorso specificato e nei relativi sottopercorsi.
-
File Mask - inserisci la stringa della maschera file oppure scegli una delle maschere file esistenti dall'elenco a discesa. La ricerca viene filtrata in base agli elementi che corrispondono alla stringa. Puoi usare il carattere jolly * (qualsiasi carattere) nella stringa. Ad esempio, digita * per cercare tutti i file e digita M per cercare tutti i file che iniziano con la lettera M.
Abilita Refine last search per definire ulteriormente i criteri di una query di ricerca a partire dall'elenco dei risultati della query ottenuti dalla ricerca precedente. Ad esempio, se hai cercato footprint PCB con un nome basato su DIP e vuoi cercare e restituire solo quei footprint con un'altezza definita inferiore a 100 mil, abilita questa opzione. Inserisci quindi la nuova espressione di query e fai clic su Search. Il sottoinsieme dei risultati della query precedente verrà visualizzato come nuovo elenco Query Results nel Components pannello.
Ad esempio, se vuoi trovare un componente che ritieni si trovi in una libreria all'interno di cartelle specifiche sul disco rigido e tale libreria non è attualmente elencata in Available File-based Libraries, definisci la ricerca come segue:
-
Nell'area Scope, imposta Search in su Components e seleziona Libraries on path.
-
Nell'area Path, imposta Path in modo che punti alla cartella contenente il documento di libreria che desideri cercare.
-
Fai clic su Search. I risultati vengono visualizzati nel Componentspannello durante l'esecuzione della ricerca.
Puoi posizionare solo componenti provenienti da librerie installate in Altium Designer. Se tenti di posizionare un componente da una libreria che non è attualmente installata, dovrai confermarne l'installazione.
Modalità di ricerca avanzata
La ricerca nelle librerie viene in realtà eseguita utilizzando query. Nella finestra di dialogo File-based Libraries Search, passa alla modalità Advanced per esaminare la query.
Nella modalità Advanced della finestra di dialogo, puoi anche creare le tue query utilizzando le parole chiave del linguaggio di query per eseguire una ricerca basata su query. Fai riferimento alla sezione seguente per saperne di più sulle parole chiave disponibili del linguaggio di query.
Utilizza i seguenti controlli aggiuntivi quando è selezionata la modalità Advanced:
-
Helper - fai clic per aprire la finestra di dialogo Query Helper e creare facilmente una query di ricerca nelle librerie con funzioni di libreria predefinite e funzioni di sistema. Puoi anche usare i pulsanti History e Favorites per scegliere una query di libreria applicata di recente o predefinita.
-
History - fai clic per aprire la finestra di dialogo Expression Manager per scegliere una delle espressioni di query applicate in precedenza da utilizzare per la ricerca nelle librerie. Puoi anche usare il pulsante Favorites per utilizzare una query predefinita per una ricerca di libreria specificata.
-
Favorites - fai clic per aprire la finestra di dialogo Expression Manager per scegliere una delle tue espressioni di query preferite da utilizzare in una ricerca di libreria. Puoi anche modificare l'elenco Favorites rimuovendo, rinominando o copiando espressioni dall'elenco History.
Quando si esegue una ricerca tra Database Components, la modalità Advanced ti consentirà di eseguire una ricerca SQL tramite query. Questo livello di ricerca offre una ricerca "fine" basata su un'espressione di query specificata, in cui puoi inserire direttamente una query SQL nella sezione editor della query della finestra di dialogo.
Fai clic su Advanced per accedere a una potente ricerca tramite query basata su SQL. Fai nuovamente clic su Advanced per tornare alla ricerca semplice.
Funzioni di query per componenti e librerie
Funzioni di query per componenti e librerie nella finestra di dialogo Query Helper
Alla base degli editor schematico e PCB di Altium Designer c'è un potente motore di query. Inserendo query in questo motore, puoi definire logicamente con precisione gli oggetti richiesti.
Una query è una stringa che inserisci utilizzando parole chiave e sintassi specifiche, che restituirà gli oggetti di destinazione. Sono disponibili molte parole chiave, che ti consentono di individuare gli oggetti in base al loro tipo, alle loro proprietà o a entrambi.
Le sezioni seguenti descrivono in dettaglio le parole chiave del linguaggio di query disponibili durante la ricerca di componenti basati su database e su file in Altium Designer. Per assistenza su una specifica parola chiave di query, utilizzare le seguenti sezioni comprimibili oppure evidenziare (o fare clic all'interno di) una determinata parola chiave - nel Query Helper.
Per accedere alle funzioni di query di componenti e librerie, fare clic sul pulsante
Helper presente nella finestra di dialogo
Ricerca librerie basate su file.
Componenti
ComponentType
Riepilogo
Restituisce tutti i componenti la cui proprietà Component Type è conforme alla Query.
Sintassi
ComponentType = ComponentType_String
ComponentType_String deve essere una delle stringhe del seguente elenco:
-
'Graphical'
-
'Jumper'
-
'Mechanical'
-
'Net Tie'
-
'Net Tie (In BOM)'
-
'Standard'
-
'Standard (No BOM)'
Esempio di utilizzo
ComponentType = 'Graphical'
Restituisce tutti i componenti la cui proprietà Component Type è Graphical.
ComponentType = 'Standard'
Restituisce tutti i componenti la cui proprietà Component Type è Standard.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo Ricerca librerie file.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib - disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella lista Query Results, nel pannello Components.
-
I caratteri di apice singolo (') all'inizio e alla fine di ComponentType_String sono obbligatori.
Designator
Riepilogo
Restituisce tutti i componenti la cui proprietà Designator è conforme alla Query.
Sintassi
Designator : String
Esempio di utilizzo
Designator = 'U2'
Restituisce tutti i componenti la cui proprietà Designator è U2.
Designator Like '*Channel*'
Restituisce tutti i componenti la cui proprietà Designator include Channel.
Designator <> 'C*'
Restituisce tutti i componenti tranne quelli la cui proprietà except inizia con C.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo Ricerca librerie file.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib - disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella lista Query Results nel pannello Components.
HasModel
Riepilogo
Restituisce ogni componente collegato a (o che fa riferimento a) un modello di dominio le cui proprietà sono conformi alla Query.
Ogni componente può essere collegato a modelli di tipo Footprint, Simulation, PCB3D, Ibis e Signal Integrity. È possibile collegare un componente a più modelli dello stesso tipo, ma solo un modello di ciascun tipo può essere selezionato come Current Model del componente.
Sintassi
HasModel(ModelType : String,ModelName : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
La stringa ModelType specifica la proprietà Type di un modello collegato e deve essere una delle stringhe del seguente elenco:
-
'PCB3DLIB' - utilizzare questa stringa per indirizzare un modello collegato la cui proprietà Type è PCB3D.
-
'PCBLIB' - utilizzare questa stringa per indirizzare un modello collegato la cui proprietà Type è Footprint.
-
'IBIS' - utilizzare questa stringa per indirizzare un modello collegato la cui proprietà Type è Ibis Model.
-
'SI' - utilizzare questa stringa per indirizzare un modello collegato la cui proprietà Type è Signal Integrity.
-
'SIM' - utilizzare questa stringa per indirizzare un modello collegato la cui proprietà Type è Simulation.
La stringa ModelName specifica la proprietà Name di un modello collegato.
Il parametro CurrentModelOnly specifica se il modello collegato debba o meno essere un Modello corrente di ciascun componente. Quando è False, il modello collegato non deve necessariamente essere un Modello corrente (ma può comunque esserlo); quando è True, il modello collegato deve essere un Modello corrente.
Esempio di utilizzo
HasModel('PCBLIB','SOIC14',False)
HasModel('PCBLIB','SOIC14',False) = True
HasModel('PCBLIB','SOIC14',False) = 'True'
Restituisce tutti i componenti collegati a un modello Footprint la cui proprietà Name è SOIC14; tale modello non deve necessariamente essere il Modello Footprint corrente di ciascun componente (ma può esserlo).
HasModel('PCBLIB','DIP14',True)
HasModel('PCBLIB','DIP14',True) = True
HasModel('PCBLIB','DIP14',True) = 'True'
Restituisce tutti i componenti collegati a un modello Footprint la cui proprietà Name è DIP14; tale modello deve essere il Modello Footprint corrente del componente.
HasModel('SI','RES1',False)
HasModel('SI','RES1',False) = True
HasModel('SI','RES1',False) = 'True'
Restituisce tutti i componenti collegati a un modello Signal Integrity la cui proprietà Name è RES1; tale modello non deve necessariamente essere il Modello Signal Integrity corrente di ciascun componente (ma può esserlo).
HasModel('SIM','RESISTOR',True)
HasModel('SIM','RESISTOR',True) = True
HasModel('SIM','RESISTOR',True) = 'True'
Restituisce tutti i componenti collegati a un modello Simulation la cui proprietà Name è RESISTOR; tale modello deve essere il Modello Simulation corrente del componente.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo Ricerca librerie file.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib - disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella lista Query Results nel pannello Components.
HasModelParameter
Riepilogo
Restituisce ogni componente collegato a (o che fa riferimento a) un modello di dominio contenente un oggetto parametro le cui proprietà Parameter Name e Value sono conformi alla Query.
Ogni componente può essere collegato a modelli di tipo Footprint, Simulation, PCB3D, Ibis e Signal Integrity. È possibile collegare un componente a più modelli dello stesso tipo, ma solo un modello di ciascun tipo può essere selezionato come Current Model del componente.
Sintassi
HasModelParameter(Parameter Name : String,Value : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
Il parametro CurrentModelOnly specifica se il modello collegato (che contiene un parametro conforme) debba o meno essere un Modello corrente di ciascun componente. Quando è False, il modello collegato non deve necessariamente essere un Modello corrente (ma può comunque esserlo); quando è True, il modello collegato deve essere un Modello corrente.
Esempio di utilizzo
HasModelParameter('Inductance A','1mH',False)
HasModelParameter('Inductance A','1mH',False) = True
HasModelParameter('Inductance A','1mH',False) = 'True'
Restituisce tutti i componenti collegati a un modello che contiene un oggetto parametro la cui proprietà Parameter Name è Inductance A e la cui proprietà Value è 1mH. Tale modello non deve necessariamente essere un Modello corrente di ciascun componente (ma può esserlo).
HasModelParameter('Coupling Factor','0.999',True)
HasModelParameter('Coupling Factor','0.999',True) = True
HasModelParameter('Coupling Factor','0.999',True) = 'True'
Restituisce tutti i componenti collegati a un modello che contiene un oggetto parametro la cui proprietà Parameter Name è Coupling Factor e la cui proprietà Value è 0.999. Tale modello deve essere un Modello corrente del componente.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo Ricerca librerie file.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib - disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella lista Query Results nel pannello Components.
LibReference
Riepilogo
Restituisce tutti i componenti la cui proprietà Library Reference è conforme alla Query.
Sintassi
LibReference : String
Esempio di utilizzo
LibReference = 'LM833'
Restituisce tutti i componenti la cui proprietà Library Reference è LM833.
LibReference Like 'C*'
Restituisce tutti i componenti la cui proprietà Library Reference inizia con C.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo Ricerca librerie file.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib - disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella lista Query Results nel pannello Components.
PartCount
Riepilogo
Restituisce tutti i componenti la cui proprietà Part Count è conforme alla Query.
Sintassi
PartCount : Number
Esempio di utilizzo
PartCount = 2
Restituisce tutti i componenti il cui Part Count è 2.
PartCount > 4
Restituisce tutti i componenti il cui Part Count è maggiore di 4 (ovvero tutti i componenti multipart contenenti più di quattro sotto-parti).
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo Ricerca librerie file.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib - disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
PinCount
Riepilogo
Restituisce tutti i componenti la cui proprietà Pin Count soddisfa la Query.
Sintassi
PinCount : Number
Esempio di utilizzo
PinCount = 2
Restituisce tutti i componenti il cui Pin Count è 2.
PinCount > 14
Restituisce tutti i componenti il cui Pin Count è maggiore di 14.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib, disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
Tutti
Description
Riepilogo
Restituisce tutti i componenti o footprint la cui proprietà Description soddisfa la Query.
Sintassi
Description : String
Esempio di utilizzo
Description = 'TTL-RS232 DRIVER'
Restituisce tutti i componenti o footprint la cui proprietà Description è TTL-RS232 DRIVER.
Description Like '*RS485*'
Restituisce tutti i componenti o footprint la cui proprietà Description include RS485.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
HasParameter
Riepilogo
Restituisce tutti i componenti che contengono un oggetto parametro le cui proprietà Parameter Name e Value soddisfano la Query.
Sintassi
HasParameter(Parameter Name : String,Value : String) : Boolean/Boolean_String
Esempio di utilizzo
HasParameter('Comment','1K')
HasParameter('Comment','1K') = True
HasParameter('Comment','1K') = 'True'
Restituisce tutti i componenti che contengono un oggetto parametro la cui proprietà Parameter Name è Comment e la cui proprietà Value è 1K.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
LibraryName
Riepilogo
Restituisce tutti i componenti o footprint il cui nome della libreria padre soddisfa la Query.
Sintassi
LibraryName : String
Esempio di utilizzo
LibraryName = 'Miscellaneous Devices.SchLib'
Restituisce tutti i componenti la cui libreria padre è Miscellaneous Devices.SchLib.
LibraryName Like 'Miscellaneous*.IntLib'
Restituisce tutti i componenti o footprint il cui nome della libreria padre inizia con Miscellaneous e termina con .IntLib.
LibraryName Like '*Vishay*'
Restituisce tutti i componenti il cui nome della libreria padre contiene Vishay.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib, IntLib e DbLib, disponibili o lungo un percorso di ricerca definito. Durante la ricerca dei footprint, verranno interrogate tutte le librerie PcbLib e IntLib.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
LibraryPath
Riepilogo
Restituisce tutti i componenti o footprint che risiedono nella libreria specificata come parte della Query.
Sintassi
LibraryPath : String
Esempio di utilizzo
LibraryPath = 'C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Restituisce tutti i componenti la cui libreria padre è MyExampleLibrary.SchLib e dove tale libreria risiede nella cartella C:\Documents\Altium\Library.
LibraryPath Like ' C:\Documents\Altium\Library\Miscellaneous*.IntLib'
Restituisce tutti i componenti o footprint il cui nome della libreria padre inizia con Miscellaneous e termina con .IntLib, e dove tale libreria risiede nella cartella C:\Documents\Altium\Library.
LibraryPath = 'C:\Test Projects\Example DBLib\VishayCapacitor.DBLib'
Restituisce tutti i componenti la cui libreria padre è VishayCapacitor.DBLib e dove tale libreria risiede nella cartella C:\Test Projects\Example DBLib.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib, IntLib e DbLib disponibili lungo il percorso libreria definito. Durante la ricerca dei footprint, verranno interrogate tutte le librerie PcbLib e IntLib.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
Name
Riepilogo
Restituisce tutti i componenti o footprint il cui nome soddisfa la Query.
Sintassi
Name : String
Esempio di utilizzo
Name = 'Res1'
Restituisce tutti i componenti o footprint il cui nome è Res1.
Name Like 'DIP*'
Restituisce tutti i componenti o footprint il cui nome inizia con DIP.
Name Like '*33*'
Restituisce tutti i componenti o footprint il cui nome contiene 33.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei componenti, verranno interrogate tutte le librerie SchLib e IntLib, disponibili o lungo un percorso di ricerca definito. Durante la ricerca dei footprint, verranno interrogate tutte le librerie PcbLib e IntLib.
-
Tutti i risultati sono elencati nella Query Resultslista, di nuovo nel pannello Components.
-
Il nome di un componente schematico viene verificato rispetto alla sua proprietà Design Item ID e il nome di un PCB Footprint viene verificato rispetto alla sua proprietà Footprint .
SourceLibraryName
Riepilogo
Restituisce tutti i componenti o footprint il cui nome della libreria sorgente padre soddisfa la Query.
Sintassi
SourceLibraryName : String
Esempio di utilizzo
SourceLibraryName = 'Miscellaneous Devices.SchLib'
Restituisce tutti i componenti la cui libreria sorgente padre è Miscellaneous Devices.SchLib.
SourceLibraryName = 'Miscellaneous Devices.PcbLib '
Restituisce tutti i footprint la cui libreria sorgente padre è Miscellaneous Devices.PcbLib.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei componenti, verranno interrogate solo le librerie schematiche sorgente, disponibili o lungo un percorso di ricerca definito. Durante la ricerca dei footprint verranno interrogate solo le librerie PCB.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
SourceLibraryPath
Riepilogo
Restituisce tutti i componenti o footprint che risiedono nella libreria sorgente specificata come parte della Query.
Sintassi
SourceLibraryPath : String
Esempio di utilizzo
SourceLibraryPath = ' C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Restituisce tutti i componenti la cui libreria sorgente padre è MyExampleLibrary.SchLib e dove tale libreria risiede nella cartella C:\Documents\Altium\Library.
SourceLibraryPath = ' C:\Documents\Altium\Library\Miscellaneous Devices.PcbLib'
Restituisce tutti i footprint la cui libreria sorgente padre è Miscellaneous Devices.PcbLib e dove tale libreria risiede nella cartella C:\Documents\Altium\Library.
SourceLibraryPath Like ' C:\Documents\Altium\Library\*'
Restituisce tutti i componenti o footprint la cui libreria sorgente padre risiede nella cartella C:\Documents\Altium\Library.
Note
-
Le entità restituite, Componenti o Footprint, dipendono dall'ambito scelto, definito utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei componenti, verranno interrogate solo le librerie schematiche disponibili lungo il percorso libreria definito. Durante la ricerca dei footprint verranno interrogate solo le librerie PCB.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
Footprint
Height
Riepilogo
Restituisce tutti i footprint la cui proprietà Height soddisfa la Query.
Sintassi
Height : Number
Number seguirà le unità di misura attualmente utilizzate per la libreria, Imperiali (mil; 1mil = 0.001inch) o Metriche (mm; 1mm = 0.001meter).
Esempio di utilizzo
Height = 300
Restituisce tutti i footprint che hanno una proprietà Height uguale a 300 unità di misura correnti.
Height >= 5.08
Restituisce tutti i footprint che hanno una proprietà Height maggiore o uguale a 5.08 unità di misura correnti.
Height <> 550
Restituisce tutti i footprint che hanno una proprietà Height che è not uguale a 550 unità di misura correnti.
Note
-
Assicurarsi che l'ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Durante la ricerca dei footprint, verranno interrogate tutte le librerie PcbLib e IntLib, disponibili o lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
PadCount
Riepilogo
Restituisce tutti i footprint la cui proprietà Pad Count soddisfa la Query.
Sintassi
PadCount : Number
Esempio di utilizzo
PadCount = 2
Restituisce tutti i footprint il cui Pad Count è 2.
PadCount > 14
Restituisce tutti i footprint il cui Pad Count è maggiore di 14.
Note
-
Assicurati che l’ambito della ricerca sia impostato su Components utilizzando il campo Search in nella finestra di dialogo File Libraries Search.
-
Quando si cercano footprint, verranno esaminate tutte le librerie PcbLib e IntLib disponibili o presenti lungo un percorso di ricerca definito.
-
Tutti i risultati sono elencati nella Query Resultslista nel pannello Components.
Localizzato tramite A