Gestion des bibliothèques de bases de données et de fichiers disponibles
Dans Altium Designer, les composants de bibliothèques de bases de données et de bibliothèques basées sur des fichiers ne peuvent être placés qu’à partir de bibliothèques actuellement disponibles. Cela inclut :
-
Libraries in the current project – si une bibliothèque fait partie du projet, ses composants sont automatiquement disponibles pour placement dans ce projet.
-
Installed libraries – ces bibliothèques ont été installées dans Altium Designer ; leurs composants sont disponibles pour utilisation dans tout projet ouvert.
-
Libraries on a defined search path – il est également possible de définir un chemin de recherche vers un dossier contenant plusieurs bibliothèques. Comme tous les fichiers du chemin de recherche sont parcourus chaque fois qu’un nouveau composant est choisi dans un panneau, cette approche n’est recommandée que pour de petites bibliothèques avec des définitions de modèles simples, telles que les modèles de simulation. Les chemins de recherche ne sont pas recommandés pour les modèles complexes, tels que les empreintes incluant des modèles 3D.
Pour gérer les bibliothèques de bases de données et de fichiers disponibles, vous pouvez utiliser la boîte de dialogue Libraries Preferences, accessible en cliquant sur le bouton 
en haut du panneau Components puis en sélectionnant Libraries Preferences dans le menu.
La boîte de dialogue Libraries Preferences comporte trois onglets. Toutes les bibliothèques et tous les emplacements de modèles définis dans ces onglets sont regroupés pour constituer votre liste de bibliothèques disponibles. Lorsqu’une action nécessitant la recherche d’un modèle est exécutée, comme le transfert de la conception du schéma vers le routage PCB, les bibliothèques sont parcourues dans l’ordre des onglets, puis, dans chaque onglet, dans l’ordre d’affichage des bibliothèques/modèles. Dès que le modèle correct est localisé, le processus de recherche s’arrête.
Bibliothèques du projet
Les bibliothèques faisant partie du projet actif sont répertoriées dans l’onglet Project de la boîte de dialogue Libraries Preferences lorsque ce projet est le projet actif dans le logiciel. L’avantage des bibliothèques de projet est que les modèles/bibliothèques deviennent automatiquement disponibles chaque fois que le projet est ouvert. L’inconvénient est que si les modèles/bibliothèques ne sont pas stockés dans la même arborescence de dossiers que les fichiers de conception, ils peuvent facilement être oubliés si les fichiers du projet sont déplacés.
L’onglet Project fournit une liste des bibliothèques disponibles dans le projet actuel.
Toute bibliothèque peut être une bibliothèque de projet ; elle n’a pas besoin d’être stockée dans le dossier du projet. Pour inclure des bibliothèques dans le projet, cliquez avec le bouton droit sur le nom du projet dans le panneau Projects et sélectionnez la commande Add Existing to Project.
Bibliothèques installées
Les bibliothèques et modèles rendus disponibles dans votre installation du logiciel sont appelés bibliothèques installées. Ils sont répertoriés dans l’onglet Installed de la boîte de dialogue Libraries Preferences.
Cette liste est un paramètre d’environnement. Toute bibliothèque ajoutée à cette liste sera disponible pour tous les projets, et la liste est conservée d’une session de conception à l’autre. Les bibliothèques de projet peuvent être ajoutées à cette liste, mais n’en font pas partie initialement.
Les bibliothèques installées peuvent être répertoriées à l’aide d’un chemin absolu ou d’un chemin relatif au paramètre Library Path Relative To. L’avantage de l’utilisation d’un chemin relatif est qu’elle permet de créer un sous-environnement commun sur plusieurs PC, ce qui vous permet de déplacer facilement les fichiers de conception entre eux. De plus, les bibliothèques installées peuvent être temporairement désactivées en décochant la case Activated, plutôt qu’en les supprimant.
Seules les bibliothèques Activated sont accessibles depuis le panneau Components.
L’onglet Installed répertorie les bibliothèques qui ont été rendues disponibles dans cette installation d’Altium Designer.
Lorsque vous êtes connecté à un Workspace Altium 365, un résumé de l’état de santé de votre bibliothèque Workspace vous est également présenté. Il affiche, en un coup d’œil, le nombre de composants entièrement sains et le nombre de composants présentant au moins un problème. Cliquez sur le contrôle See Details pour ouvrir la page Components de l’interface navigateur du Workspace dans votre navigateur web par défaut.
Lorsque vous êtes connecté à un Workspace Altium 365, vous pouvez importer dans le Workspace une bibliothèque installée actuellement sélectionnée dans la zone de grille de la boîte de dialogue en cliquant sur
Import dans la colonne la plus à droite. Le
Library Importer in its Simple mode s’ouvrira avec la bibliothèque sélectionnée chargée.
Chemin de recherche
L’onglet Search Path présente une liste des bibliothèques qui ont été localisées selon les paramètres de chemin définis dans l’onglet Search Paths tab of the Project Options dialog, accessible en cliquant sur le bouton Paths. Chaque chemin de recherche définit un dossier et peut inclure des sous-dossiers si l’option Recursive est activée (disponible dans l’onglet Search Paths de la boîte de dialogue Project Options après l’ajout d’un chemin). Tous les fichiers de modèles et de bibliothèques trouvés sur le chemin de recherche seront disponibles. Les chemins de recherche sont enregistrés avec le projet.
Cliquez sur le bouton Refresh pour actualiser la liste en fonction des derniers chemins de recherche (définis dans l’onglet Search Paths de la boîte de dialogue Project Options ).
L’onglet Search Path répertorie les bibliothèques trouvées dans les chemins de recherche définis.
L’onglet Search Paths de la boîte de dialogue Project Options est disponible lorsque l’option UI.ProjectOptions.SearchPaths est activée dans la boîte de dialogue Advanced Settings dialog.
La récupération des modèles à l’aide de chemins de recherche peut être lente s’il y a un grand nombre de fichiers dans le(s) dossier(s) du chemin de recherche. Pour cette raison, il n’est pas recommandé d’utiliser cette approche pour les bibliothèques PCB, car elles peuvent être de gros fichiers contenant de nombreuses empreintes. Cette fonctionnalité a été développée pour fournir un moyen de référencer les modèles de simulation et d’intégrité du signal disponibles.
Bien que le logiciel offre de la flexibilité et du contrôle sur les emplacements spécifiques des modèles/bibliothèques, il exige que l’extension de fichier correcte soit utilisée pour chaque type de modèle. Par exemple, une empreinte ne sera trouvée que si elle se trouve dans un fichier avec une extension .Lib ou .PcbLib. De même, un SPICE *.SUBCKT ne sera trouvé que s’il se trouve dans un fichier .ckt et un SPICE *.MODEL ne sera trouvé que s’il se trouve dans un fichier .mdl. Lorsqu’une recherche de modèle ne donne aucun résultat, une erreur apparaît dans le panneau Messages.
Browsing the Database Components
Une fois le fichier DbLib/SVNDbLib ajouté à la liste des bibliothèques basées sur des fichiers disponibles, les composants de la base de données deviennent disponibles pour consultation dans le panneau Components. Bien qu’un seul fichier DbLib/SVNDbLib soit ajouté, chaque table de la base de données liée se présente comme s’il s’agissait d’une bibliothèque distincte.
N’oubliez pas que si la base de données cible a été créée à l’aide de plusieurs fichiers de feuille de calcul Excel (*.xls), en raison des limitations du pilote ODBC, le nombre de feuilles pouvant être connectées est limité à 64.
La liste déroulante supérieure du panneau se remplira avec des entrées de la forme :
-
<LibraryName>.DbLib - <TableName> ou <LibraryName>.SVNDbLib - <TableName> ----lorsque votre base de données comporte des tables
-
<LibraryName>.DbLib - <SheetName>$ ou <LibraryName>.SVNDbLib - <SheetName>$ ----lorsque votre base de données est constituée de feuilles dans une feuille de calcul Excel.
Exemple d’un DbLib chargé avec trois tables, d’un autre avec une table, et d’un SVNDbLib avec une table.
Chaque entrée de composant dans le panneau correspond à un enregistrement dans cette table particulière de la base de données. En fait, lors de la consultation des bibliothèques de bases de données chargées, le panneau Components se comporte comme un navigateur direct de base de données. Les informations de symbole et de modèle sont renseignées à partir des bibliothèques de symboles et de modèles sous-jacentes pointées par les champs pertinents de la base de données (et conjointement avec les chemins/emplacements de recherche définis).
Consultation des composants dans une base de données externe liée via une bibliothèque de base de données.
Par défaut, seuls les champs Part Number et Library Ref sont affichés dans la zone de liste des composants du panneau. Pour « exposer » d’autres champs de la table de base de données, cliquez avec le bouton droit dans la zone et choisissez Select Columns dans le menu contextuel. Cela vous donnera accès à la boîte de dialogue Select Columns dialog, dans laquelle vous pouvez activer l’affichage de n’importe lequel des champs supplémentaires de cette table.
Mise en cache locale des symboles et modèles utilisés par les bibliothèques de base de données SVN
Lorsqu’un fichier SVNDbLib est ajouté à la liste des bibliothèques disponibles, les bibliothèques de symboles et de modèles du dépôt sont mises en cache dans un dossier temporaire local sur l’ordinateur exécutant Designer. Lorsqu’une action dans le logiciel nécessite l’utilisation d’un symbole schématique ou d’un modèle, ce symbole/modèle est récupéré depuis le cache local.
Mise à jour automatique du cache
Les bibliothèques du cache seront automatiquement mises à jour avec la dernière version du dépôt de contrôle de source lors de l’exécution de l’une des actions suivantes dans le logiciel :
-
Placement d’un composant à partir d’un fichier SVNDbLib installé (depuis le panneau Components panel).
-
Exécution d’un transfert de conception (c’est-à-dire mise à jour du PCB).
-
Utilisation de la commande Tools » Update From Libraries dans l’éditeur de schémas.
-
Utilisation de la commande Tools » Update From PCB Libraries dans l’éditeur PCe PCB.
Bien que la mise à jour soit automatique, elle peut être contrôlée à l’aide de l’option Do not check files more often than xx minutes dans la page Data Management - SVN Libraries page de la boîte de dialogue Preferences. Cette option fournit essentiellement un « minuteur de mise à jour » pour le cache local. Si le délai spécifié s’est écoulé depuis la dernière mise à jour du cache, alors le cache sera automatiquement mis à jour lorsqu’une des actions listées sera exécutée. Si une action est exécutée dans cet intervalle, le contenu actuel du cache sera utilisé, ce qui peut être obsolète par rapport au contenu du dépôt.
Forcer manuellement une mise à jour du cache
Il peut arriver que vous souhaitiez forcer une mise à jour du cache local, afin de vous assurer que vous disposez des bibliothèques les plus récentes actuellement stockées dans le dépôt de contrôle de source. Par exemple, lors de la préparation du transfert de la conception du schéma vers le PCB.
Vous pouvez forcer manuellement une mise à jour du cache à l’aide de l’une des méthodes suivantes :
-
En utilisant l’une des Refresh commandes disponibles dans le menu contextuel accessible par clic droit du panneau Components.
-
Désinstaller puis réinstaller le fichier SVNDbLib dans la liste des bibliothèques disponibles.
Chaque fois que vous redémarrez Altium Designer, le cache local est automatiquement actualisé avec les bibliothèques les plus récentes stockées dans le dépôt SVN.
Recherche de composants dans les bibliothèques de base de données et basées sur des fichiers
Pour vous aider à trouver un composant dans les bibliothèques basées sur des fichiers (installées ou non actuellement installées) et les bibliothèques de base de données, Altium Designer inclut une fonction de recherche de bibliothèque.
La recherche d’un composant dans les bibliothèques de base de données et basées sur des fichiers est possible à l’aide du champ Search du panneau Components. Saisissez une chaîne et appuyez sur Enter pour rechercher cette chaîne dans la bibliothèque active, n’importe où dans les paramètres visibles du composant.
Vous pouvez effectuer une recherche directement dans le panneau Components.
La boîte de dialogue File-based Libraries Search permet une recherche plus détaillée. Elle est accessible en cliquant sur le bouton dans le panneau Components, puis en sélectionnant File-based Libraries Search dans le menu. La moitié supérieure de la boîte de dialogue sert à définir what vous recherchez ; la moitié inférieure sert à définir where rechercher.
Effectuez une recherche dans les bibliothèques installées (Available libraries) ou dans les bibliothèques présentes sur le disque dur (Libraries on path).Le processus de recherche peut être résumé comme suit :
-
La recherche s’effectue en définissant des Filters qui sont appliqués à toutes les bibliothèques pouvant être interrogées selon les paramètres actuels de Scope de recherche.
-
Le Scope inclut le type de bibliothèques à rechercher. Un seul type peut être recherché à la fois.
-
Pour activer la recherche de composants de base de données, définissez le champ Search in sur Database Components et sélectionnez le Table requis. Notez que les Fields disponibles listés dans la liste déroulante ci-dessus changeront pour refléter les en-têtes de colonnes disponibles dans la table choisie. Les autres options de la boîte de dialogue deviennent grisées, car elles ne sont pas pertinentes lors de la recherche dans des bibliothèques de base de données.
-
Le Scope définit quelles bibliothèques seront recherchées : soit les bibliothèques auxquelles le logiciel a actuellement accès (Available libraries), soit toutes les bibliothèques d’un dossier (Libraries on path).
-
Lors de la recherche de bibliothèques sur un chemin, la cible est un dossier spécifique et peut également Include Subdirectories.
-
Vous pouvez également effectuer une recherche dans les résultats de recherche en définissant le Scope sur Refine last search.
-
Cliquez sur Clear pour effacer les paramètres de recherche saisis.
Définition du filtre de recherche
La zone Filters sert à définir les chaînes de texte à appliquer à la recherche. Trois zones sont à configurer :
-
Field – il s’agit de l’attribut du composant à rechercher. Il peut s’agir de n’importe quel attribut de composant ou d’empreinte, y compris le nom, la description, le commentaire, l’empreinte ou tout paramètre ajouté à un composant. Sélectionnez un champ disponible dans la liste déroulante ou saisissez un champ dans la zone de texte.
-
Operator – définit comment une correspondance est déterminée. Cela peut être lorsque la valeur equals, contains, starts with ou ends with. Notez que equals exige une correspondance exacte de chaîne ; il ne doit donc être utilisé que si vous êtes certain que la chaîne de recherche est correcte et complète.
-
Value – les caractères à rechercher dans le Field choisi, avec une correspondance selon le Operator choisi. Sélectionnez une valeur disponible dans la liste déroulante ou saisissez une valeur dans le champ de texte.
Par défaut, il existe trois contraintes de filtre ; vous pouvez ajouter jusqu’à sept lignes supplémentaires pour un total de 10 lignes à l’aide du contrôle Add Row. La dernière ligne de contrainte de filtre ajoutée peut être supprimée à l’aide de Remove Row. Vous pouvez supprimer les lignes inutilisées.
Définition de la portée
Il existe essentiellement deux approches de recherche :
-
Bibliothèques actuellement disponibles – il s’agit de la liste des bibliothèques affichée dans la liste déroulante en haut du panneau Components .
-
Bibliothèques stockées dans un dossier spécifique, ainsi que dans les sous-répertoires si l’option est activée.
La recherche renverra tous les éléments du type de recherche choisi dans la liste déroulante Search in (Components/Footprints/3D Models/Database Components) trouvés dans toutes les bibliothèques relevant de la Scope définie :
-
Available libraries - activez cette option pour rechercher les types de modèles spécifiés uniquement dans les bibliothèques disponibles.
-
Libraries on path - activez cette option pour rechercher les types de modèles spécifiés dans les bibliothèques disponibles d’un ou plusieurs dossiers spécifiés. Dans la zone Path de la boîte de dialogue, qui devient disponible lorsque l’option de portée Libraries on path est sélectionnée, vous pouvez définir le chemin, inclure les sous-répertoires et inclure le masque de fichier de bibliothèque afin de préciser et d’affiner les critères de recherche :
-
Path - modifiez ce champ pour définir le dossier dans lequel les bibliothèques peuvent être recherchées, ou cliquez sur l’icône de parcours à la fin du champ pour rechercher un dossier.
-
Include Subdirectories - activez cette option si vous souhaitez rechercher des bibliothèques à partir du chemin spécifié et de ses sous-chemins.
-
File Mask - saisissez la chaîne de masque de fichier ou choisissez l’un des masques de fichier existants dans la liste déroulante. La recherche est filtrée selon les éléments qui correspondent à la chaîne. Vous pouvez utiliser le caractère générique * (n’importe quel caractère) dans la chaîne. Par exemple, saisissez * pour rechercher tous les fichiers et saisissez M pour rechercher tous les fichiers commençant par la lettre M.
Activez Refine last search pour définir plus précisément un critère de requête de recherche à partir de la liste des résultats de requête obtenus lors de la recherche précédente. Par exemple, si vous avez recherché des empreintes PCB dont le nom est basé sur DIP et que vous souhaitez rechercher et renvoyer uniquement celles dont la hauteur définie est inférieure à 100 mil, activez cette option. Saisissez la nouvelle expression de requête puis cliquez sur Search. Le sous-ensemble des résultats de la requête précédente sera affiché comme nouvelle liste de résultats de requête dans le panneau Components.
Par exemple, si vous souhaitez trouver un composant qui, selon vous, se trouve dans une bibliothèque située dans des dossiers spécifiques du disque dur et que cette bibliothèque n’est pas actuellement répertoriée dans Available File-based Libraries, définissez la recherche comme suit :
-
Dans la zone Scope, définissez Search in sur Components et sélectionnez Libraries on path.
-
Dans la zone Path, définissez le Path de manière à pointer vers le dossier contenant le document de bibliothèque que vous souhaitez rechercher.
-
Cliquez sur Search. Les résultats s’affichent dans le panneau Components au fur et à mesure de la recherche.
Vous ne pouvez placer des composants qu’à partir de bibliothèques installées dans Altium Designer. Si vous tentez de placer un composant à partir d’une bibliothèque qui n’est pas actuellement installée, vous devrez confirmer son installation.
Mode de recherche avancé
La recherche dans les bibliothèques est en réalité effectuée à l’aide de requêtes. Dans la boîte de dialogue File-based Libraries Search, passez en mode Advanced pour examiner la requête.
Dans le mode Advanced de la boîte de dialogue, vous pouvez également créer vos propres requêtes à l’aide des mots-clés du langage de requête afin d’effectuer une recherche basée sur des requêtes. Reportez-vous à la section ci-dessous pour en savoir plus sur les mots-clés disponibles du langage de requête.
Utilisez les contrôles supplémentaires suivants lorsque le mode Advanced est sélectionné :
-
Helper - cliquez pour ouvrir la boîte de dialogue Query Helper afin de créer facilement une requête de recherche de bibliothèque à l’aide de fonctions de bibliothèque prédéfinies et de fonctions système. Vous pouvez également utiliser les boutons History et Favorites pour choisir une requête de bibliothèque récemment appliquée ou prédéfinie.
-
History - cliquez pour ouvrir la boîte de dialogue Expression Manager afin de choisir l’une des expressions de requête précédemment appliquées à utiliser pour la recherche de bibliothèque. Vous pouvez également utiliser le bouton Favorites pour utiliser une requête prédéfinie pour une recherche de bibliothèque spécifiée.
-
Favorites - cliquez pour ouvrir la boîte de dialogue Expression Manager afin de choisir l’une de vos expressions de requête favorites à utiliser dans une recherche de bibliothèque. Vous pouvez également modifier la liste Favorites en supprimant, renommant ou copiant des expressions depuis la liste History.
Lors de la recherche parmi Database Components, le mode Advanced vous permettra d’effectuer une recherche par requête SQL. Ce niveau de recherche offre une recherche « fine » basée sur une expression de requête spécifiée, où vous pouvez saisir directement une requête SQL dans la section d’édition de requête de la boîte de dialogue.
Cliquez sur Advanced pour accéder à une puissante recherche par requête basée sur SQL. Cliquez de nouveau sur Advanced pour revenir à la recherche simple.
Fonctions de requête de composant et de bibliothèque
Fonctions de requête de composant et de bibliothèque dans la boîte de dialogue Query Helper
À la base des éditeurs de schémas et de PCB d’Altium Designer se trouve un puissant moteur de requête. En saisissant des requêtes dans ce moteur, vous pouvez définir logiquement avec précision les objets dont vous avez besoin.
Une requête est une chaîne que vous saisissez à l’aide de mots-clés et d’une syntaxe spécifiques, qui renverra les objets ciblés. De nombreux mots-clés sont disponibles, vous permettant de cibler des objets par leur type, leurs propriétés, ou les deux.
Les sections ci-dessous détaillent les mots-clés du langage de requête disponibles lors de la recherche de composants de base de données et de composants basés sur des fichiers dans Altium Designer. Pour obtenir de l’aide sur un mot-clé de requête spécifique, utilisez les sections repliables suivantes ou surlignez (ou cliquez dans) n’importe quel mot-clé donné - dans le Query Helper.
Pour accéder aux fonctions de requête des composants et des bibliothèques, cliquez sur le bouton
Helper situé dans la boîte de dialogue
File-based Libraries Search dialog.
Composants
ComponentType
Résumé
Renvoie tous les composants dont la propriété Component Type est conforme à la requête.
Syntaxe
ComponentType = ComponentType_String
ComponentType_String doit être l’une des chaînes de la liste suivante :
-
'Graphical'
-
'Jumper'
-
'Mechanical'
-
'Net Tie'
-
'Net Tie (In BOM)'
-
'Standard'
-
'Standard (No BOM)'
Exemple d’utilisation
ComponentType = 'Graphical'
Renvoie tous les composants dont le Component Type est Graphical.
ComponentType = 'Standard'
Renvoie tous les composants dont le Component Type est Standard.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search dialog.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib - disponibles ou situées le long d’un chemin de recherche défini - seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results, de retour dans le panneau Components.
-
Les apostrophes (') au début et à la fin de ComponentType_String sont obligatoires.
Designator
Résumé
Renvoie tous les composants dont la propriété Designator est conforme à la requête.
Syntaxe
Designator : String
Exemple d’utilisation
Designator = 'U2'
Renvoie tous les composants dont la propriété Designator est U2.
Designator Like '*Channel*'
Renvoie tous les composants dont la propriété Designator inclut Channel.
Designator <> 'C*'
Renvoie tous les composants except sauf ceux dont la propriété Designator commence par C.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search dialog.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib - disponibles ou situées le long d’un chemin de recherche défini - seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
HasModel
Résumé
Renvoie chaque composant lié à (ou référençant) un modèle de domaine dont les propriétés sont conformes à la requête.
Chaque composant peut être lié à des modèles de type Footprint, Simulation, PCB3D, Ibis et Signal Integrity. Il est possible de lier un composant à plusieurs modèles du même type, mais un seul modèle de chaque type peut être sélectionné comme Current Model du composant.
Syntaxe
HasModel(ModelType : String,ModelName : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
La chaîne ModelType spécifie la propriété Type d’un modèle lié et doit être l’une des chaînes de la liste suivante :
-
'PCB3DLIB' - utilisez cette chaîne pour cibler un modèle lié dont la propriété Type est PCB3D.
-
'PCBLIB' - utilisez cette chaîne pour cibler un modèle lié dont la propriété Type est Footprint.
-
'IBIS' - utilisez cette chaîne pour cibler un modèle lié dont la propriété Type est Ibis Model.
-
'SI' - utilisez cette chaîne pour cibler un modèle lié dont la propriété Type est Signal Integrity.
-
'SIM' - utilisez cette chaîne pour cibler un modèle lié dont la propriété Type est Simulation.
La chaîne ModelName spécifie la propriété Name d’un modèle lié.
Le paramètre CurrentModelOnly indique si le modèle lié doit ou non être un modèle courant de chaque composant. Lorsque cette valeur est False, le modèle lié n’a pas besoin d’être un modèle courant (mais il peut tout de même l’être) ; lorsque cette valeur est True, le modèle lié doit être un modèle courant.
Exemple d’utilisation
HasModel('PCBLIB','SOIC14',False)
HasModel('PCBLIB','SOIC14',False) = True
HasModel('PCBLIB','SOIC14',False) = 'True'
Renvoie tous les composants liés à un modèle Footprint dont la propriété Name est SOIC14 ; ce modèle n’a pas besoin d’être le modèle Footprint courant de chaque composant (mais il peut l’être).
HasModel('PCBLIB','DIP14',True)
HasModel('PCBLIB','DIP14',True) = True
HasModel('PCBLIB','DIP14',True) = 'True'
Renvoie tous les composants liés à un modèle Footprint dont la propriété Name est DIP14 ; ce modèle doit être le modèle Footprint courant du composant.
HasModel('SI','RES1',False)
HasModel('SI','RES1',False) = True
HasModel('SI','RES1',False) = 'True'
Renvoie tous les composants liés à un modèle Signal Integrity dont la propriété Name est RES1 ; ce modèle n’a pas besoin d’être le modèle Signal Integrity courant de chaque composant (mais il peut l’être).
HasModel('SIM','RESISTOR',True)
HasModel('SIM','RESISTOR',True) = True
HasModel('SIM','RESISTOR',True) = 'True'
Renvoie tous les composants liés à un modèle Simulation dont la propriété Name est RESISTOR ; ce modèle doit être le modèle Simulation courant du composant.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search dialog.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib - disponibles ou situées le long d’un chemin de recherche défini - seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
HasModelParameter
Résumé
Renvoie chaque composant lié à (ou référençant) un modèle de domaine contenant un objet paramètre dont les propriétés Parameter Name et Value sont conformes à la requête.
Chaque composant peut être lié à des modèles de type Footprint, Simulation, PCB3D, Ibis et Signal Integrity. Il est possible de lier un composant à plusieurs modèles du même type, mais un seul modèle de chaque type peut être sélectionné comme Current Model du composant.
Syntaxe
HasModelParameter(Parameter Name : String,Value : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String
Le paramètre CurrentModelOnly indique si le modèle lié (qui contient un paramètre conforme) doit ou non être un modèle courant de chaque composant. Lorsque cette valeur est False, le modèle lié n’a pas besoin d’être un modèle courant (mais il peut tout de même l’être) ; lorsque cette valeur est True, le modèle lié doit être un modèle courant.
Exemple d’utilisation
HasModelParameter('Inductance A','1mH',False)
HasModelParameter('Inductance A','1mH',False) = True
HasModelParameter('Inductance A','1mH',False) = 'True'
Renvoie tous les composants liés à un modèle contenant un objet paramètre dont la propriété Parameter Name est Inductance A, et dont la propriété Value est 1mH. Ce modèle n’a pas besoin d’être un modèle courant de chaque composant (mais il peut l’être).
HasModelParameter('Coupling Factor','0.999',True)
HasModelParameter('Coupling Factor','0.999',True) = True
HasModelParameter('Coupling Factor','0.999',True) = 'True'
Renvoie tous les composants liés à un modèle contenant un objet paramètre dont la propriété Parameter Name est Coupling Factor, et dont la propriété Value est 0.999. Ce modèle doit être un modèle courant du composant.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search dialog.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib - disponibles ou situées le long d’un chemin de recherche défini - seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
LibReference
Résumé
Renvoie tous les composants dont la propriété Library Reference est conforme à la requête.
Syntaxe
LibReference : String
Exemple d’utilisation
LibReference = 'LM833'
Renvoie tous les composants dont la propriété Library Reference est LM833.
LibReference Like 'C*'
Renvoie tous les composants dont la propriété Library Reference commence par C.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search dialog.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib - disponibles ou situées le long d’un chemin de recherche défini - seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
PartCount
Résumé
Renvoie tous les composants dont la propriété Part Count est conforme à la requête.
Syntaxe
PartCount : Number
Exemple d’utilisation
PartCount = 2
Renvoie tous les composants dont le Part Count est 2.
PartCount > 4
Renvoie tous les composants dont le Part Count est supérieur à 4 (c’est-à-dire tous les composants multiparties contenant plus de quatre sous-parties).
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search dialog.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib - disponibles ou situées le long d’un chemin de recherche défini - seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results dans le panneau Components.
PinCount
Résumé
Renvoie tous les composants dont la propriété Pin Count est conforme à la requête.
Syntaxe
PinCount : Number
Exemple d'utilisation
PinCount = 2
Renvoie tous les composants dont Pin Count est 2.
PinCount > 14
Renvoie tous les composants dont Pin Count est supérieur à 14.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib — disponibles ou situées sur un chemin de recherche défini — seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
Tous
Description
Résumé
Renvoie tous les composants ou empreintes dont la propriété Description est conforme à la requête.
Syntaxe
Description : String
Exemple d'utilisation
Description = 'TTL-RS232 DRIVER'
Renvoie tous les composants ou empreintes dont la propriété Description est TTL-RS232 DRIVER.
Description Like '*RS485*'
Renvoie tous les composants ou empreintes dont la propriété Description inclut RS485.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
HasParameter
Résumé
Renvoie tous les composants contenant un objet paramètre dont les propriétés Parameter Name et Value sont conformes à la requête.
Syntaxe
HasParameter(Parameter Name : String,Value : String) : Boolean/Boolean_String
Exemple d'utilisation
HasParameter('Comment','1K')
HasParameter('Comment','1K') = True
HasParameter('Comment','1K') = 'True'
Renvoie tous les composants qui contiennent un objet paramètre dont la propriété Parameter Name est Comment, et dont la propriété Value est 1K.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
LibraryName
Résumé
Renvoie tous les composants ou empreintes dont le nom de la bibliothèque parente est conforme à la requête.
Syntaxe
LibraryName : String
Exemple d'utilisation
LibraryName = 'Miscellaneous Devices.SchLib'
Renvoie tous les composants dont la bibliothèque parente est Miscellaneous Devices.SchLib.
LibraryName Like 'Miscellaneous*.IntLib'
Renvoie tous les composants ou empreintes dont le nom de la bibliothèque parente commence par Miscellaneous et se termine par .IntLib.
LibraryName Like '*Vishay*'
Renvoie tous les composants dont le nom de la bibliothèque parente contient Vishay.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib, IntLib et DbLib — disponibles ou situées sur un chemin de recherche défini — seront interrogées. Lors de la recherche d'empreintes, toutes les bibliothèques PcbLib et IntLib seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
LibraryPath
Résumé
Renvoie tous les composants ou empreintes qui résident dans la bibliothèque spécifiée dans le cadre de la requête.
Syntaxe
LibraryPath : String
Exemple d'utilisation
LibraryPath = 'C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Renvoie tous les composants dont la bibliothèque parente est MyExampleLibrary.SchLib, et où cette bibliothèque réside dans le dossier C:\Documents\Altium\Library.
LibraryPath Like ' C:\Documents\Altium\Library\Miscellaneous*.IntLib'
Renvoie tous les composants ou empreintes dont le nom de la bibliothèque parente commence par Miscellaneous et se termine par .IntLib, et où cette bibliothèque réside dans le dossier C:\Documents\Altium\Library.
LibraryPath = 'C:\Test Projects\Example DBLib\VishayCapacitor.DBLib'
Renvoie tous les composants dont la bibliothèque parente est VishayCapacitor.DBLib, et où cette bibliothèque réside dans le dossier C:\Test Projects\Example DBLib.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib, IntLib et DbLib — disponibles sur le chemin de bibliothèque défini — seront interrogées. Lors de la recherche d'empreintes, toutes les bibliothèques PcbLib et IntLib seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
Name
Résumé
Renvoie tous les composants ou empreintes dont le nom est conforme à la requête.
Syntaxe
Name : String
Exemple d'utilisation
Name = 'Res1'
Renvoie tous les composants ou empreintes dont le nom est Res1.
Name Like 'DIP*'
Renvoie tous les composants ou empreintes dont le nom commence par DIP.
Name Like '*33*'
Renvoie tous les composants ou empreintes dont le nom contient 33.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche de composants, toutes les bibliothèques SchLib et IntLib — disponibles ou situées sur un chemin de recherche défini — seront interrogées. Lors de la recherche d'empreintes, toutes les bibliothèques PcbLib et IntLib seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results, de retour dans le panneau Components.
-
Le nom d'un composant schématique est vérifié par rapport à sa propriété Design Item ID, et le nom d'une empreinte PCB est vérifié par rapport à sa propriété Footprint .
SourceLibraryName
Résumé
Renvoie tous les composants ou empreintes dont le nom de la bibliothèque source parente est conforme à la requête.
Syntaxe
SourceLibraryName : String
Exemple d'utilisation
SourceLibraryName = 'Miscellaneous Devices.SchLib'
Renvoie tous les composants dont la bibliothèque source parente est Miscellaneous Devices.SchLib.
SourceLibraryName = 'Miscellaneous Devices.PcbLib '
Renvoie toutes les empreintes dont la bibliothèque source parente est Miscellaneous Devices.PcbLib.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche de composants, seules les bibliothèques schématiques source — disponibles ou situées sur un chemin de recherche défini — seront interrogées. Seules les bibliothèques PCB seront interrogées lors de la recherche d'empreintes.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
SourceLibraryPath
Résumé
Renvoie tous les composants ou empreintes qui résident dans la bibliothèque source spécifiée dans le cadre de la requête.
Syntaxe
SourceLibraryPath : String
Exemple d'utilisation
SourceLibraryPath = ' C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
Renvoie tous les composants dont la bibliothèque source parente est MyExampleLibrary.SchLib, et où cette bibliothèque réside dans le dossier C:\Documents\Altium\Library.
SourceLibraryPath = ' C:\Documents\Altium\Library\Miscellaneous Devices.PcbLib'
Renvoie toutes les empreintes dont la bibliothèque source parente est Miscellaneous Devices.PcbLib, et où cette bibliothèque réside dans le dossier C:\Documents\Altium\Library.
SourceLibraryPath Like ' C:\Documents\Altium\Library\*'
Renvoie tous les composants ou empreintes dont la bibliothèque source parente réside dans le dossier C:\Documents\Altium\Library.
Remarques
-
Les entités renvoyées, composants ou empreintes, dépendent de la portée choisie, définie à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche de composants, seules les bibliothèques schématiques — disponibles sur le chemin de bibliothèque défini — seront interrogées. Seules les bibliothèques PCB seront interrogées lors de la recherche d'empreintes.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
Empreintes
Height
Résumé
Renvoie toutes les empreintes dont la propriété Height est conforme à la requête.
Syntaxe
Height : Number
Number suivra les unités de mesure actuellement utilisées pour la bibliothèque — soit impériales (mil ; 1 mil = 0,001 pouce), soit métriques (mm ; 1 mm = 0,001 mètre).
Exemple d'utilisation
Height = 300
Renvoie toutes les empreintes ayant une propriété Height égale à 300 unités de mesure actuelles.
Height >= 5.08
Renvoie toutes les empreintes ayant une propriété Height supérieure ou égale à 5.08 unités de mesure actuelles.
Height <> 550
Renvoie toutes les empreintes ayant une propriété Height qui est not égale à 550 unités de mesure actuelles.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l'aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche d'empreintes, toutes les bibliothèques PcbLib et IntLib — disponibles ou situées sur un chemin de recherche défini — seront interrogées.
-
Tous les résultats sont répertoriés dans la liste Query Results du panneau Components.
PadCount
Résumé
Renvoie toutes les empreintes dont la propriété Pad Count est conforme à la requête.
Syntaxe
PadCount : Number
Exemple d'utilisation
PadCount = 2
Renvoie toutes les empreintes dont Pad Count est 2.
PadCount > 14
Renvoie toutes les empreintes dont Pad Count est supérieur à 14.
Remarques
-
Assurez-vous que la portée de la recherche est définie sur Components à l’aide du champ Search in dans la boîte de dialogue File Libraries Search.
-
Lors de la recherche d’empreintes, toutes les bibliothèques PcbLib et IntLib — disponibles ou situées sur un chemin de recherche défini — seront examinées.
-
Tous les résultats sont répertoriés dans la Query Resultsliste du panneau Components.
AI-localized