Creating & Defining the Database Library

La fonctionnalité de bibliothèque de base de données repose sur le fichier de bibliothèque de base de données. Celui-ci existe sous deux formes, selon que vous utilisez une bibliothèque de base de données standard ou une bibliothèque de base de données sous contrôle de version :

• Standard Database Library - le fichier Database Library. Ce fichier est créé et géré à l’aide de l’éditeur DatabaseLib d’Altium Designer. Cet éditeur devient disponible lorsque le document actif dans la fenêtre principale de conception est un fichier *.DbLib.
• Version-Controlled Database Library - le fichier SVN Database Library. Ce fichier est créé et géré à l’aide de l’éditeur SVNDatabaseLib d’Altium Designer. Cet éditeur devient disponible lorsque le document actif dans la fenêtre principale de conception est un fichier *.SVNDbLib.

Exemple de fichier DbLib ouvert dans l’éditeur DatabaseLib. Survolez l’image pour voir un exemple de fichier SVNDbLib ouvert dans l’éditeur SVNDatabaseLib.

Créez un nouveau fichier de l’un de ces types en choisissant la commande File » New » Library dans les menus principaux, puis en sélectionnant l’option Database Library ou SVN Database Library dans la zone Database de la boîte de dialogue New Library qui s’ouvre.

Connexion à une base de données externe

Les données de table et de mappage n’apparaîtront dans la fenêtre d’affichage principale d’un éditeur qu’après la connexion réussie du fichier Database Library/SVN Database Library actif à la base de données externe requise. La connexion est définie à l’aide des contrôles fournis dans la zone Source of Connection.

Spécification de la connexion à la base de données externe via un fichier DbLib. Survolez l’image pour voir la connexion via un fichier SVNDbLib.

Toute base de données prenant en charge OLE DB peut être connectée. Les options fournies dans cette zone utilisent chacune une chaîne de connexion OLE DB pour se connecter à la base de données cible. Certaines bases de données peuvent ne pas offrir la prise en charge d’OLE DB. Cependant, pratiquement tous les systèmes de gestion de bases de données utilisés aujourd’hui sont accessibles via l’interface Open Database Connectivity (ODBC). La fonctionnalité de liaison à la base de données utilise le fournisseur ODBC de Microsoft, qui permet à un objet ADO (ActiveX Data Object) de se connecter à toute source de données ODBC. Il en résulte que toute base de données ODBC peut être connectée. Le fournisseur OLE DB pour la base de données ODBC est spécifié dans la chaîne de connexion.

La connexion peut également être définie dans l’onglet Connection de la boîte de dialogue Database Connection, accessible en choisissant la commande Tools » Database Connection dans les menus principaux, ou en cliquant sur le bouton Advanced (à droite du bouton Connect , en bas de la zone).

Connexion rapide aux bases de données Access et Excel

L’option Select Database Type offre une méthode accélérée de création d’une chaîne de connexion lorsque la base de données cible a été créée avec Microsoft Access ou Microsoft Excel. Avec cette option, sélectionnez le type de base de données, puis recherchez et sélectionnez le fichier de base de données requis. La chaîne de connexion correspondante sera automatiquement composée et saisie dans le champ de l’option Use Connection String.

Création d’une chaîne de connexion

Si la base de données de votre entreprise n’est pas basée sur Access ou Excel, et que vous souhaitez créer explicitement la chaîne de connexion, activez l’option Use Connection String puis cliquez sur le bouton Build associé à droite. La boîte de dialogue Data Link Properties apparaîtra.

Création d’une chaîne de connexion via la boîte de dialogue Data Link Properties.

La boîte de dialogue s’ouvre sur l’onglet Connection . Le fournisseur OLE DB Microsoft Office <Version> Access Database Engine OLE DB Provider est défini par défaut dans l’onglet Provider de la boîte de dialogue. Il s’agit du paramètre de fournisseur par défaut pour les nouveaux fichiers Database Library/SVN Database Library et il est également utilisé pour se connecter aux fichiers de base de données Access (*.mdb). Modifiez le fournisseur si nécessaire.

Depuis l’onglet Connection , saisissez le nom (y compris le chemin) de la base de données à laquelle vous souhaitez vous connecter.

Si votre base de données nécessite une autorisation de connexion, saisissez-la selon les besoins, ainsi que tout autre paramètre avancé disponible dans l’onglet Advanced de la boîte de dialogue. L’onglet All fournit une liste récapitulative des options de liaison définies, ainsi que des options étendues liées au fournisseur OLE DB choisi. Les options peuvent être modifiées selon les besoins depuis cet onglet.

Une fois les options de liaison définies, vous pouvez vérifier que la connexion a réussi en cliquant sur le bouton Test Connection (dans l’onglet Connection ). En cas de réussite, une boîte de dialogue de confirmation apparaîtra.

Spécification d’un fichier Data Link

Si la source de données à laquelle vous souhaitez vous connecter est décrite à l’aide d’un fichier Microsoft Data Link (*.udl), activez la troisième option de connexion - Use Data Link File - puis cliquez sur le bouton Browse associé pour localiser le fichier requis. Un fichier Data Link est essentiellement un conteneur de stockage pour une chaîne de connexion.

Poursuite de la connexion

Après avoir défini la connexion à la base de données externe, le texte du bouton Connect apparaîtra en gras, indiquant que vous pouvez poursuivre la connexion. Si les détails de connexion sont corrects, les informations de table et de mappage de la base de données cible seront chargées dans le fichier Database Library/SVN Database Library. Le texte du bouton Connect deviendra Connected et le bouton sera grisé.

En cas de problème avec les détails de connexion, par exemple si une chaîne de connexion est construite incorrectement ou si un chemin est saisi de manière erronée, la connexion échouera et un message apparaîtra pour vous en avertir. Vérifiez vos paramètres de connexion et cliquez à nouveau sur le bouton Connect .

Exemples de signalement d’un échec de connexion dans une bibliothèque de base de données.

Après une première connexion réussie, et après l’enregistrement du fichier Database Library/SVN Database Library, la connexion sera établie automatiquement à chaque ouverture du fichier, à condition que l’emplacement et le nom du fichier de la base de données cible ne soient pas modifiés.

Spécification du lien vers le dépôt de contrôle de version (SVNDbLib uniquement)

Avec une DbLib, les bibliothèques de symboles et de modèles sont stockées sur votre disque dur ou sur un autre support local/réseau. N’oubliez pas que, pour une SVNDbLib, ces bibliothèques sont stockées sous contrôle de version dans un dépôt Subversion. Dans le cadre du fichier SVNDbLib, vous devez définir le lien vers ce dépôt. La connexion au dépôt SVN est définie dans l’onglet SVN Repository de la boîte de dialogue Database Library Options (Tools » Options). Cette boîte de dialogue est également accessible en cliquant sur le bouton Options dans la zone Field Settings de la vue du document.

Exemple de connexion à un dépôt SVN basé sur des fichiers.

Liste des tables de la base de données

Après une connexion réussie à la base de données externe, les données de table et de mappage seront chargées. La partie gauche du document DbLib/SVNDbLib répertorie toutes les tables existant dans la base de données connectée.

Tables existant dans la base de données connectée.

L’option Enable à côté de chaque entrée de table vous permet de contrôler si cette table doit ou non faire partie de la bibliothèque de base de données résultante. Lorsque la bibliothèque de base de données est ajoutée à la liste des bibliothèques basées sur des fichiers disponibles pour la navigation dans le panneau Components, chaque table apparaît comme une entité de bibliothèque distincte. Ainsi, bien qu’une seule bibliothèque de base de données soit réellement ajoutée, du point de vue du panneau Components , c’est comme si vous aviez ajouté plusieurs bibliothèques distinctes. Pour plus d’informations, voir Recherche de composants dans les bibliothèques basées sur des fichiers et les bibliothèques de base de données.

Lorsque vous cliquez sur une entrée de table dans la liste, son icône passe de  à  afin de l’identifier comme la table actuellement active. La table — avec toutes ses données — apparaît dans l’onglet Table Browser du document. Il s’agit d’une vue modifiable de la table, qui vous permet de consulter rapidement son contenu et de le modifier si nécessaire, sans avoir à lancer la base de données externe elle-même.

Parcourir une table source dans la base de données connectée.

Pour agrandir la zone du navigateur de tables (comme illustré ci-dessus), réduisez toute la zone située au-dessus (paramètres de connexion et de champs) en cliquant sur le contrôle , en haut à droite de la vue du document. Cliquez sur  pour développer à nouveau. La table prend également en charge les fonctions habituelles de regroupement, de tri et de filtrage.

Spécification des critères de correspondance

Après qu’un composant a été placé depuis la base de données externe, il doit exister un moyen de conserver le lien entre ce composant placé et l’enregistrement de base de données dont les informations ont servi à le créer. En substance, les deux doivent être mis en correspondance.

Lorsqu’un composant est placé, ses informations de paramètres sont créées à la volée à partir des champs correspondants de l’enregistrement de base de données. Le lien post-placement entre le composant schématique et l’enregistrement de base de données est établi à l’aide d’un ou plusieurs de ces paramètres. La zone Field Settings du document vous permet de définir les critères de correspondance — soit une recherche simple sur clé unique, soit une correspondance plus avancée à l’aide d’une clause Where.

Contrôle des critères de correspondance post-placement.

Recherche sur clé unique

Si l’option Single key lookup est activée (par défaut), les champs Database field et Part parameter deviennent disponibles. Le premier répertorie tous les noms de champs disponibles (en-têtes de colonnes) dans la table active de la base de données. Comme les paramètres d’un composant schématique sont ajoutés lors de son placement, le champ Part parameter reflétera le champ de base de données choisi.

En général, le champ de clé de recherche utilisé est un élément qui identifie de manière unique chaque composant dans la base de données externe, tel qu’une référence pièce. Le champ de recherche choisi est distingué dans l’onglet Field Mappings du document par l’entrée Design Parameter affichée en grisé.

Mappage sur clé unique par référence pièce.

Lors de l’utilisation de la fonctionnalité Update Parameters From Database à un moment quelconque après le placement, les informations sont lues à partir du paramètre de clé choisi dans les composants schématiques placés, puis recherchées dans le champ (clé) choisi de la base de données — dans toutes les tables activées. Lorsqu’une correspondance est trouvée, les informations des autres cellules de cet enregistrement de la table parente peuvent alors être retransférées vers les paramètres mappés du composant schématique.

Correspondance avancée — la clause Where

Bien que l’option Single key lookup fonctionne bien s’il existe un numéro de pièce/ID unique sur lequel effectuer la correspondance, elle est moins efficace lorsqu’on effectue la correspondance à partir d’un paramètre non unique, tel que la capacité ou la résistance. Dans ce cas, il convient d’utiliser la clause Where plus avancée, qui vous permet de spécifier une correspondance sur plusieurs clés afin de relier le composant schématique à son enregistrement source dans la base de données.

Dans sa forme la plus simple, la clause Where (écrite en syntaxe SQL) reflète les entrées choisies qui définissent la recherche sur clé unique. Par exemple, si Database field a été choisi comme étant Part Number — la valeur par défaut — le champ Part parameter serait automatiquement défini sur Part Number également, et l’entrée de la clause Where serait :

[Part Number] = '{Part Number}'

Les crochets autour du champ de base de données (colonne de table) sont des caractères de guillemet, tels que spécifiés dans l’onglet Advanced de la boîte de dialogue Database Connection dialog. Accédez à cette boîte de dialogue soit en cliquant sur le bouton Advanced dans la zone Source of Connection du document, soit depuis le menu principal Tools .

L’onglet Advanced de la boîte de dialogue Database Connection fournit des options SQL supplémentaires pour mettre entre guillemets
les tables, ou utiliser des noms de schéma de table, dans une clause Where construite.

Les accolades indiquent que l’entrée référencée est un paramètre de conception. Les guillemets simples sont utilisés pour indiquer que le paramètre de conception doit être traité comme une chaîne, et non comme un nombre (sans guillemets). La correspondance de type est très importante, car SQL est sensible aux types. Le paramètre de conception doit être du même type que la colonne dans la base de données.

En utilisant la syntaxe SQL standard, la clause Where peut ensuite être étendue pour effectuer une correspondance à l’aide de plusieurs entrées Database field/Part parameter, par exemple :

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

Dans ce cas, un seul enregistrement de la table concernée de la base de données serait lié à l’aide de trois paramètres de conception différents. Notez que l’entrée du paramètre de conception Tolerance n’est pas entre guillemets. Cela signifie que le type de colonne dans la table associée de la base de données est Number et non String.

En utilisant la syntaxe SQL standard, vous pouvez concevoir la clause Where aussi simple ou aussi complexe que vous le souhaitez.

Mappage des champs de base de données vers les paramètres de conception

Les paramètres de conception d’un composant placé depuis une bibliothèque de base de données sont créés/ajoutés au moment du placement. Les paramètres effectivement créés, ainsi que les options utilisées pour mettre à jour leurs informations après le placement — à l’aide de la commande Tools » Update Parameters From Database — sont déterminés par les informations de mappage et de mise à jour spécifiées dans le fichier Database Library/SVN Database Library. Ces réglages sont effectués dans l’onglet Field Mappings de la vue principale du document.

Spécifiez les options de mappage des paramètres et de mise à jour dans l’onglet Field Mappings du document DbLib/SVNDbLib.

Mappage des modèles et des paramètres

Les deux premières colonnes (à partir de la gauche) de l’onglet Field Mappings servent à contrôler quelles informations de la base de données doivent être mappées vers les attributs, modèles et paramètres du composant.

• Database Field Name - cette colonne répertorie tous les noms de champs (colonnes) de la table actuellement active de la base de données.
• Design Parameter - cette colonne définit comment chaque champ correspondant de la base de données doit être utilisé. Cela peut servir à fournir le symbole ou le modèle d’empreinte du composant (il sera placé entre crochets), ou à être inclus comme paramètre du composant (dans ce cas, il n’est pas placé entre crochets).

Le mappage initial est effectué automatiquement lors de la connexion à la base de données, avec tous les champs de base de données mappés.

Attributs et modèles

Si le nom du champ de base de données correspond à l’un des noms réservés suivants, l’entrée de mappage attribut/modèle correspondante sera automatiquement définie dans le champ 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]

  • Les références à PCB3D concernent l’ancien visualiseur 3D ; elles ne doivent pas être utilisées pour les nouvelles conceptions. Le moteur 3D natif de l’éditeur PCB peut restituer les corps de composants et les fichiers de modèles 3D importés associés aux empreintes de composants.
  • Les mappages de modèles PCB3D peuvent être définis dans un fichier SVNDbLib ; toutefois, le stockage des bibliothèques de modèles PCB3D dans le dépôt Subversion n’est pas pris en charge.
• 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]

  Reportez-vous à la section Simulation Model Mapping ci-dessous pour en savoir plus sur les champs liés aux modèles de simulation.
  Un seul lien de modèle de simulation peut être défini pour un composant dans une base de données externe. En général, il n’y aura qu’un seul modèle de simulation lié à un composant. Si vous souhaitez configurer plusieurs liens de modèles de simulation, les autres liens devront être définis et stockés avec ce composant dans le fichier de bibliothèque schématique source.
  Les modèles de simulation liés sont pris en charge pour une bibliothèque de base de données sous contrôle de version (SVNDbLib) ; toutefois, le stockage des fichiers de modèles de simulation dans le dépôt Subversion n’est pas pris en charge.

Ces mappages définissent les informations d’attribut et de modèle du composant. Lorsque le composant est placé, le symbole schématique spécifié par le champ [Library Ref] de l’enregistrement correspondant dans la base de données sera extrait de la bibliothèque schématique indiquée. De même, les informations d’empreinte PCB et de modèle de simulation stockées dans l’enregistrement seront ajoutées au composant en tant que modèles d’empreinte et de simulation liés respectivement.

L’entrée [Library Ref] doit exister dans la colonne Design Parameter et être mappée à Database Field Name, qui spécifie le symbole schématique, afin de pouvoir placer un composant depuis la Database Library/SVN Database Library sur un schéma. Si la table de base de données contient la référence du symbole sous un Database Field Name différent, par exemple SCH Symbol, vous devrez définir manuellement l’entrée Design Parameter associée pour ce champ sur [Library Ref], à l’aide de la liste déroulante disponible pour cette cellule.

De même, si les informations de référence de modèle sont saisies dans la base de données avec des noms de champs différents, vous devrez effectuer le mappage manuellement en choisissant l’entrée Design Parameter appropriée ([Footprint Ref], [Footprint Ref n], [PCB3D Ref], [Sim Model Name], etc.) dans la liste déroulante, pour chaque champ à son tour.

Afin de définir les informations de symbole et de modèle d’un composant lors de son placement, ce sont les champs de référence de symbole et de modèle dans la base de données qui constituent les entités de mappage essentielles
- assurez-vous qu’un symbole et au moins une référence d’empreinte PCB font partie du mappage défini.

Mappage du modèle de simulation

Cette section présente chacun des champs de base de données pouvant être ajoutés à une table de base de données externe afin de définir le lien du modèle de simulation, qui sera créé lors du placement du composant.

• Sim Model Name – le nom du modèle que vous souhaitez utiliser. Une fois le composant placé, cette information apparaîtra dans le champ Model Name de la boîte de dialogue Sim Model.

  Lors du mappage des champs de base de données vers les paramètres de conception dans le fichier DBLib, le champ Sim Model Name est analogue aux champs Footprint Ref, Library Ref, etc.
• Sim Description – une description du modèle lié. Cette information est facultative et n’affecte pas le fonctionnement du lien du modèle de simulation.

• Sim File – un fichier de modèle particulier dans lequel rechercher le modèle de simulation spécifié dans le champ Sim Model Name. Ce champ peut être utilisé de plusieurs façons :

  • Vous pouvez saisir un chemin absolu vers un fichier de modèle (par ex., C:\DbLibs\Switching Diodes\Libraries\JAS33.mdl). Le modèle spécifié dans le champ Sim Model Name sera recherché dans ce fichier et utilisé s’il est trouvé.
  • Vous pouvez saisir un chemin relatif (par rapport au fichier DbLib) vers un fichier de modèle (par ex., Libraries\JAS33.mdl). Le modèle spécifié dans le champ Sim Model Name sera recherché dans ce fichier et utilisé s’il est trouvé.
  • Vous pouvez saisir uniquement le nom du fichier de modèle (par ex., JAS33.mdl). Les chemins de recherche définis dans le fichier DbLib seront utilisés pour localiser le premier fichier de modèle correspondant au nom spécifié et contenant une correspondance pour le modèle spécifié dans le champ Sim Model Name.
  • Vous pouvez laisser le champ vide. Les chemins de recherche définis dans le fichier DbLib seront utilisés pour localiser le premier fichier de modèle contenant une correspondance pour le modèle spécifié dans le champ Sim Model Name.
  Les chemins de recherche sont définis pour le fichier DbLib depuis l’onglet Symbol & Model Search Paths de la boîte de dialogue Database Library Options (Tools » Options).
• Sim Kind – la catégorie parente du modèle lié.
• Sim SubKind – le type du modèle lié.

• Sim Netlist – les informations du modèle de netlist, conformément au type de modèle lié. Ce champ devient particulièrement important si vous spécifiez votre propre modèle de netlist et avez défini le champ Sim SubKind sur Generic Editor, ce qui vous donne davantage de contrôle sur les informations placées dans la netlist.

  Ce champ doit être défini et ne pas être laissé vide, sinon aucune entrée pour le modèle ne sera créée dans la netlist de simulation, et la pièce ne pourra pas être simulée lorsqu’elle est placée depuis la bibliothèque de base de données.
  Netlist Template Syntax

  Lors de la définition du modèle de netlist, les informations saisies doivent être conformes aux exigences de SPICE et aux règles de syntaxe décrites ci-dessous.

  Les caractères saisis dans le modèle sont écrits tels quels dans la netlist SPICE, à l’exception des caractères spéciaux suivants :

  %	signe pour cent
  @	arobase
  &	esperluette
  ?	point d’interrogation
  ~	tilde
  #	signe dièse

  Ces caractères sont traduits lors de la création de la netlist, comme indiqué dans le tableau suivant :

  Syntaxe dans le modèle de netlist...	Le générateur de netlist remplace par...
  @<param>	Valeur de <param>.  Une erreur est générée si un paramètre de ce nom n’existe pas ou si aucune valeur ne lui est attribuée.
  &<param>	Valeur de <param>.  Aucune erreur n’est générée si le paramètre n’est pas défini.
  ?<param>s...s	Texte entre les séparateurs s...s si <param> est défini.
  ?<param>s...ss...s	Texte entre les premiers séparateurs s...s si <param> est défini, sinon entre les seconds séparateurs s...s.
  ~<param>s...s	Texte entre les séparateurs s...s si <param> n’est PAS défini.
  ~<param>s...ss...s	Texte entre les premiers séparateurs s...s si <param> n’est PAS défini, sinon entre les seconds séparateurs s...s.
  #<param>s...s	Texte entre les séparateurs s...s si <param> est défini, mais le reste du modèle est ignoré si <param> n’est PAS défini.
  #s...s	Texte entre les séparateurs s...s s’il y a du texte à saisir dans la netlist XSpice à partir des entrées suivantes du modèle de netlist.
  %<pin id>	Le nom du net auquel est connectée la broche schématique mappée à <pin id>.
  %%	Un caractère pour cent littéral.

  Dans le tableau ci-dessus,

  • s représente un caractère séparateur (, . ; / |).
  • <param> désigne le nom d’un paramètre.

  Si le nom du paramètre contient des caractères non alphanumériques, il doit être placé entre guillemets doubles. Par exemple :

  @"DC Magnitude" - des guillemets doubles sont utilisés ici parce que le nom contient un espace.
  &"Init_Cond" - des guillemets doubles sont utilisés ici parce que le nom contient un trait de soulignement.

  Des guillemets doubles doivent également être utilisés lorsque vous souhaitez ajouter un préfixe alphanumérique à un nom de paramètre. Par exemple :

  @"DESIGNATOR"A - l’utilisation des guillemets doubles garantit que A est ajouté au désignateur du composant.

  Voici des exemples des entrées de syntaxe à caractères spéciaux du tableau précédent. Des informations sont fournies dans chaque cas sur la manière dont l’entrée de syntaxe est traduite par le générateur de netlist.

  @"AC Phase"

  Le nom de paramètre AC Phase est placé entre accolades en raison de l’espace. Il sera remplacé dans la netlist par la valeur du paramètre AC Phase. S’il n’existe pas de paramètre de ce nom, ou si sa valeur est vide, une erreur sera générée.

  &Area

  Si un paramètre nommé Area existe et possède une valeur, alors sa valeur sera saisie dans la netlist. Si le paramètre n’est pas défini (c’est-à-dire soit il n’existe pas, soit aucune valeur ne lui est attribuée), rien ne sera écrit dans la netlist, mais aucune erreur ne sera générée. Cela peut être utilisé pour des paramètres facultatifs.

  ?IC|IC=@IC|

  Si le paramètre nommé IC est défini, alors le texte entre les séparateurs || sera inséré dans la netlist. Par exemple, si le paramètre IC a la valeur 0.5, alors IC=0.5 sera inséré dans la netlist à la place de cette entrée. Si le paramètre n’est pas défini, rien ne sera inséré dans la netlist.

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

  Ceci est identique à l’exemple précédent, sauf que si le paramètre IC n’est pas défini, alors IC=0 sera inséré dans la netlist. Notez également qu’un caractère séparateur différent a été utilisé.

  ~VALUE/1k/

  Si un paramètre nommé VALUE n’est PAS défini, alors le texte 1k sera inséré dans la netlist.

  ~VALUE/1k//@VALUE/

  Ceci est identique à l’exemple précédent, sauf que si le paramètre VALUE est défini, alors sa valeur textuelle sera insérée dans la netlist.

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

  Cet exemple peut être vu dans le modèle de netlist prédéfini pour la source de tension sinusoïdale.

  Si le paramètre AC Magnitude a été défini, alors le contenu des séparateurs est évalué et inséré dans la netlist. Toutes les entrées suivantes de la netlist sont également évaluées et saisies dans la netlist (dans ce cas @"AC Phase").

  Si, par exemple, AC Magnitude=1 et AC Phase=0, alors AC 1 0 sera inséré dans la netlist. Si, en revanche, AC Phase n’est pas défini, une erreur sera générée.

  Si le paramètre AC Magnitude n’est pas défini, alors rien de ce qui suit l’entrée #"AC Magnitude" dans le modèle de netlist ne sera saisi dans la netlist.

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

  Cet exemple peut être vu dans le modèle de netlist prédéfini pour un sous-circuit paramétré (voir F1 dans Fuse.PrjPcb).

  Si les paramètres Resistance et Current sont tous deux non définis, aucun texte ne sera inséré dans la netlist après l’entrée #|PARAMS:| ; le texte des séparateurs sera donc également omis.

  Si, par exemple, les paramètres ont pour valeurs Resistance=1k et Current=5mA, cela produira du texte après l’entrée #|PARAMS:| et l’entrée ajoutée dans la netlist sera PARAMS: Resistance=1k Current=5mA.

  @DESIGNATOR%1%2@VALUE

  Cet exemple a pour but de démontrer l’utilisation du caractère %.

  Si, par exemple, les paramètres ont pour valeurs DESIGNATOR=R1 et VALUE=1k, et que les broches sont mappées dans la région Pin Mapping de la boîte de dialogue Sim Model conformément au tableau suivant :

  Broche du schéma	Broche du modèle	Nom du net auquel la broche du schéma est connectée
  1 (N+)	1 (1)	GND
  2 (N-)	2 (2)	OUT

  Le texte R1 GND OUT 1k sera alors placé dans la netlist SPICE pour ce composant.
• Sim Spice Prefix – le préfixe SPICE du type de modèle auquel vous établissez un lien.

• Sim Port Map – le mappage des broches du composant schématique vers les broches du modèle lié. Une fois le composant placé, ces informations apparaîtront dans la région Pin Mapping de la boîte de dialogue Sim Model.

  Chaque paire de broches doit être saisie au format suivant :

  (SchematicPinNumber:ModelPinNumber),

  chaque paire mappée étant séparée par une virgule.

  Par exemple, lors du mappage d’un modèle de simulation de diode où la broche 1 du schéma (anode) doit être mappée à la broche 1 du modèle (anode), et la broche 3 du schéma (cathode) doit être mappée à la broche 2 du modèle (cathode), cela doit être saisi dans le champ de base de données comme suit :

  (1:1),(3:2)

• Sim Excluded Parts – créez ce champ dans la base de données si vous souhaitez exclure certaines parties d’un composant multi-parties de la simulation. Ces informations correspondent à l’option Exclude part from simulation dans la région Pin Mapping de la boîte de dialogue Sim Model.

  Par défaut, toutes les parties d’un composant multi-parties sont incluses dans une simulation ; vous n’avez donc besoin de spécifier que les parties que vous souhaitez exclure, par numéro. Séparez plusieurs parties dans la liste d’exclusion à l’aide de virgules. Par exemple, si un composant comporte quatre parties et que vous ne souhaitez pas inclure les parties 2 et 4 dans une simulation, vous devez saisir ce qui suit dans le champ de base de données :

  2,4

• Sim Parameters – créez ce champ dans la base de données si vous souhaitez attribuer des valeurs aux paramètres de simulation du modèle. Il s’agit de paramètres pouvant être définis au niveau du composant, par opposition aux paramètres plus avancés pouvant être inclus dans un fichier de modèle.

  Un paramètre doit être saisi au format suivant :

  ParameterName=Value,

  Plusieurs paramètres doivent être séparés par le caractère pipe (|).

  Vous vous souvenez peut-être qu’un paramètre de simulation au niveau du composant peut également être défini comme paramètre de composant, apparaissant dans la région Parameters de la boîte de dialogue associée Component Properties, avec la possibilité d’être ensuite affiché sur la feuille de schéma. Par défaut, une entrée de paramètre dans le champ Sim Parameters sera automatiquement ajoutée comme paramètre de composant. Si vous ne souhaitez pas qu’un paramètre de simulation soit ajouté comme paramètre de composant, ajoutez simplement un point d’exclamation en préfixe au nom du paramètre (par exemple, !Initial Voltage=100mV).

  Prenons un modèle de diode, qui possède les quatre paramètres suivants au niveau du composant :

  • Facteur de surface
  • Condition de démarrage
  • Tension initiale
  • Température.

  Considérons maintenant l’ajout dans la base de données de valeurs pour le facteur de surface (par exemple 2) et la température (par exemple 22°C). De plus, aucun de ces deux paramètres ne doit être ajouté comme paramètre de composant. L’entrée dans le champ Sim Parameters serait :

  !Area Factor=2|!Temperature=22

Paramètres

Tous les autres noms de champs de base de données seront automatiquement mappés à des paramètres de conception portant les mêmes noms. Par exemple, si un champ de la base de données s’appelle Tolerance, un paramètre de conception nommé Tolerance lui sera mappé. Vous pouvez modifier le nom d’un paramètre de conception en cliquant dans sa cellule et en saisissant directement le nouveau nom. Ce sont ces noms de paramètres de conception qui apparaîtront dans la région Parameters de la boîte de dialogue de propriétés associée au composant, une fois celui-ci placé sur une feuille de schéma.

Il se peut qu’un grand nombre de champs de données soient associés à un composant dans la base de données, et que vous ne souhaitiez pas tous les ajouter, ni même en avoir besoin, comme paramètres de conception du composant lorsqu’il est placé sur une feuille de schéma. Une grande partie de ces informations peut n’être nécessaire qu’au moment de générer une nomenclature. La boîte de dialogue Report Manager dialog vous permet d’ajouter des informations de paramètres à une nomenclature directement depuis une base de données liée, ce qui vous permet de réduire la quantité d’informations « transportées » avec les documents source du schéma. Pour plus d’informations, reportez-vous à la section Preparing a BOM in the Report Manager.

Pour les champs que vous ne souhaitez explicitement pas mapper depuis la base de données, définissez l’entrée Design Parameter sur [None]. Les champs de base de données non mappés sont distingués dans l’onglet par l’utilisation d’une icône en forme de croix rouge (). Les champs de base de données mappés sont distingués par une icône en forme de coche verte ().

Configurez le mappage des paramètres selon vos besoins. Définissez sur [None] pour empêcher qu’un paramètre de la base de données soit mappé au composant placé. Les paramètres non mappés peuvent être inclus directement dans la nomenclature, si nécessaire.

Options de mise à jour des paramètres

Les colonnes restantes de l’onglet Field Mappings vous permettent de spécifier les actions à effectuer pour les paramètres lors du premier placement d’un composant depuis la bibliothèque de base de données, ou lors de la mise à jour d’un composant après son placement à l’aide de la commande Tools » Update Parameters From Database.

Les quatre colonnes sont les suivantes :

• Update Values - une cellule de cette colonne sert à déterminer l’action à entreprendre si le paramètre existe à la fois sur une feuille de schéma et dans la base de données, mais que les valeurs sont actuellement différentes. Choisissez de mettre à jour le paramètre du composant placé avec la valeur stockée dans la base de données (Update), ou de ne pas le mettre à jour du tout (Do not update). Cette option est respectée lors de l’utilisation de la commande Update Parameters From Database, après le placement du composant.
• Add To Design - une cellule de cette colonne sert à déterminer l’action à entreprendre si le paramètre est trouvé dans la base de données, mais n’existe pas pour le composant placé. Vous pouvez choisir d’ajouter le paramètre (Add), de ne pas l’ajouter (Do not add), ou de l’ajouter uniquement si une valeur lui est attribuée dans la base de données (Add only if not blank in database). Cette option est respectée à la fois lors du placement initial du composant depuis la bibliothèque de base de données et lors de l’utilisation de la commande Update Parameters From Database, après le placement du composant.
• Visible On Add - une case à cocher dans cette colonne sert à déterminer si un paramètre nouvellement ajouté, résultant du placement initial ou d’une mise à jour après placement, est rendu visible pour le composant sur la feuille de schéma (activé) ou non (désactivé).
• Remove From Design - une cellule de cette colonne sert à déterminer l’action à entreprendre s’il s’avère que le paramètre existe pour le composant placé, mais soit n’est pas présent dans la base de données, soit y est présent sans valeur. Vous pouvez choisir de ne pas supprimer le paramètre du tout (Do not remove), ou de le supprimer uniquement si aucune valeur ne lui est attribuée dans la base de données (Remove only if blank in database). Cette option est respectée lors de l’utilisation de la commande Update Parameters From Database, après le placement du composant.

Initialement, les champs Update Values, Add To Design et Remove From Design — pour chaque champ de base de données mappé — seront définis sur l’entrée Default, et l’option Visible On Add sera désactivée, comme illustré dans l’image suivante.

Options initiales (par défaut) de mise à jour des paramètres.

En examinant l’image, il y a quatre points importants à noter concernant les options de mise à jour :

1. Les champs de base de données non mappés n’auront aucune option de mise à jour associée.
2. Les mappages basés sur des attributs et des modèles (entrées entre crochets dans la colonne Design Parameter) n’auront aucune option de mise à jour associée, car il ne s’agit pas de paramètres de conception.
3. Le champ clé (par exemple Part Number dans l’image) n’aura aucune option de mise à jour associée. Ce champ est utilisé uniquement à des fins de correspondance des paramètres.
4. Un paramètre défini sur Default fait qu’une option de mise à jour suit sa définition par défaut correspondante, telle que spécifiée dans l’onglet Default Actions de la boîte de dialogue Database Library Options (Tools » Options depuis les menus principaux ou Options depuis le menu contextuel de l’onglet Table Browser). Cette boîte de dialogue est également accessible en cliquant sur le bouton Options dans la zone Field Settings de la vue du document.

Définissez les options de mise à jour des paramètres par défaut dans un emplacement central pour une DbLib. Survolez l’image pour voir l’équivalent pour une SVNDbLib.

Le quatrième point est avantageux, car il vous permet de spécifier les options de mise à jour depuis un emplacement central, puis de pointer vers cet emplacement lors de la définition des options de mise à jour pour chaque champ mappé. C’est pourquoi l’entrée Default est chargée automatiquement dans les champs de mise à jour concernés lors du mappage d’un champ de base de données à un paramètre de conception.

Si vous souhaitez remplacer le paramètre par défaut d’une option de mise à jour, cliquez dans le champ de mise à jour concerné, dans l’onglet Field Mappings, puis cliquez à nouveau pour accéder à une liste déroulante proposant les choix de mise à jour applicables.

Les options de mise à jour des paramètres peuvent être remplacées manuellement, si nécessaire.

De cette manière, vous avez un contrôle total sur la façon dont les paramètres de la conception sont mis à jour. Vous pouvez définir tous les champs sur Default et prendre les décisions de mise à jour requises depuis la boîte de dialogue Database Library Options, définir chaque champ de mise à jour individuellement, ou utiliser un mélange des deux — la décision vous appartient entièrement, selon ce qui vous convient le mieux. Pour les composants placés, la mise à jour, lorsqu’elle est effectuée, se fait au moyen d’une boîte de dialogue Engineering Change Order. Si, à ce stade, certaines mises à jour ne doivent finalement pas être appliquées, vous pouvez choisir de ne pas inclure ces modifications particulières, ce qui vous donne le dernier mot quant aux paramètres de conception qui seront mis à jour.

Spécification des emplacements des bibliothèques de symboles et de modèles

Lorsque vous placez un composant à partir d’une bibliothèque de base de données, son symbole — spécifié par le mappage [Library Ref] — est extrait de la bibliothèque schématique spécifiée (*.SchLib). De même, toutes les références de modèle (empreinte, PCB3D, simulation) spécifiées dans la base de données se trouvent dans les fichiers sous-jacents de bibliothèque PCB (*.PcbLib), de bibliothèque PCB3D (*.PCB3DLib) et de modèle de simulation (*.mdl, *.ckt). Les chemins vers ces fichiers peuvent être spécifiés explicitement dans la base de données en :

• saisissant un chemin absolu vers le fichier.
• saisissant un chemin relatif vers le fichier.

Si vous avez défini dans votre base de données des champs pour les informations de chemin, ces champs doivent être mappés aux paramètres de conception appropriés — [Library Path], [Footprint Path], [PCB3D Path], [Sim File], etc. (reportez-vous à Mappage des modèles et des paramètres).

La saisie de chemins — même relatifs — dans une table de base de données peut être quelque peu restrictive. Si vous déplacez l’emplacement d’une bibliothèque ou d’un fichier de modèle, vous devrez mettre à jour la table de base de données en conséquence. Pour vous offrir davantage de liberté, vous pouvez spécifier les informations de recherche de bibliothèque directement dans le fichier DbLib/SVNDbLib lui-même. Cela vous permet de spécifier dans la base de données le nom de la bibliothèque source ou du fichier de modèle, ou même de ne pas le définir du tout.

Pour une bibliothèque de base de données

Pour une DbLib, les chemins de recherche des bibliothèques sont définis dans l’onglet Symbol and Model Search Paths de la boîte de dialogue Database Library Options (Tools » Options). Cette boîte de dialogue est également accessible en cliquant sur le bouton Options dans la zone Field Settings de la vue du document.

Spécification des chemins de recherche pour les bibliothèques de symboles et de modèles.

Pour ajouter un chemin à la liste :

1. Soit saisissez directement le chemin dans le champ situé sous la zone Library Search Paths, soit cliquez sur le bouton  pour accéder à la boîte de dialogue Browse for Folder, à partir de laquelle vous pouvez localiser le répertoire dans lequel se trouvent le ou les fichiers de bibliothèque/modèle requis.
2. Vous pouvez l’ajouter soit comme chemin complet, soit comme chemin relatif (par rapport à l’emplacement du fichier DbLib). Contrôlez cela à l’aide de l’option Add/Update As Relative Path.
3. Après avoir spécifié le chemin requis, ajoutez-le à la liste des chemins de recherche en cliquant sur le bouton Add .
4. Continuez à ajouter des chemins de recherche supplémentaires selon les besoins.

Les chemins de recherche des bibliothèques déterminent où les fichiers de bibliothèque et de modèle peuvent être trouvés lors du placement depuis la bibliothèque de base de données et lors de la recherche d’un modèle après placement. Le modèle spécifique utilisé dépendra de la manière dont vous avez configuré vos chemins de recherche de bibliothèque et du fait que vous ayez ajouté ou non des informations de bibliothèque spécifiques dans votre base de données. La recherche se déroulera dans l’ordre suivant :

1. Si un chemin complet existe dans le champ de chemin mappé pour le symbole ou le modèle, utilisez ce fichier de bibliothèque/modèle et extrayez le symbole ou le modèle spécifié dans le champ de référence applicable.
2. Si un chemin relatif existe dans le champ de chemin mappé pour le symbole ou le modèle, utilisez ce fichier de bibliothèque/modèle et extrayez le symbole ou le modèle spécifié dans le champ de référence applicable.
3. Si seul un nom de fichier de bibliothèque/modèle existe dans le champ de chemin mappé pour le symbole ou le modèle, utilisez les chemins de recherche pour localiser le premier fichier de bibliothèque/modèle correspondant au nom spécifié et contenant une correspondance pour le symbole ou le modèle spécifié dans le champ de référence applicable.
4. Si aucune information de fichier de bibliothèque/modèle n’existe dans la base de données, utilisez les chemins de recherche pour localiser le premier fichier de bibliothèque/modèle contenant une correspondance pour le symbole ou le modèle spécifié dans le champ de référence applicable.

Pour une bibliothèque de base de données SVN

Pour une SVNDbLib, les répertoires de base dans le dépôt Subversion — dans lesquels résident les symboles et les modèles d’empreinte — sont spécifiés dans l’onglet SVN Repository de la boîte de dialogue Database Library Options (Tools » Options). Cette boîte de dialogue est également accessible en cliquant sur le bouton Options dans la zone Field Settings de la vue du document.

Spécification des répertoires de base du dépôt pour les symboles et les empreintes.

Utilisez les champs disponibles dans la zone Models Location pour spécifier le répertoire de base des symboles et des empreintes. Cliquez sur le bouton  à droite d’un champ pour accéder à la boîte de dialogue Browse for directory — une fenêtre sur le dépôt lié. Utilisez cette boîte de dialogue pour sélectionner le dossier requis.

Parcourir le dépôt SVN lié pour trouver le répertoire approprié.

Les emplacements des modèles déterminent où les fichiers de bibliothèque et de modèle peuvent être trouvés lors du placement depuis la bibliothèque de base de données sous contrôle de version et lors de la recherche d’un modèle après placement. Les symboles schématiques et modèles d’empreinte spécifiques utilisés dépendront de la manière dont vous avez configuré ces emplacements, ainsi que du fait que vous ayez ajouté ou non des informations de bibliothèque spécifiques dans votre base de données. La recherche se déroulera dans l’ordre suivant :

1. Si un chemin complet existe dans le champ de chemin mappé pour le symbole ou le modèle d’empreinte (par exemple http://MyServer/svn/MyCompany/ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), utilisez ce fichier de bibliothèque et extrayez le symbole ou l’empreinte spécifié dans le champ de référence applicable.
2. Si un chemin relatif (par rapport à la racine du dépôt) existe dans le champ de chemin mappé pour le symbole ou le modèle d’empreinte (par exemple /ParentDirectory/SchematicSymbols/Capacitor_NonPolarized.SchLib), utilisez ce fichier de bibliothèque et extrayez le symbole ou l’empreinte spécifié dans le champ de référence applicable. L’URL du dépôt — spécifiée dans la zone Repository Server Connection de la boîte de dialogue — sera préfixée au chemin saisi afin d’obtenir l’adresse absolue.
3. Si seul un nom de fichier de bibliothèque existe dans le champ de chemin mappé pour le symbole ou le modèle d’empreinte (par exemple Capacitor_NonPolarized.SchLib), utilisez les emplacements de modèle spécifiés dans le dépôt pour localiser le premier fichier de bibliothèque correspondant au nom spécifié et contenant une correspondance pour le symbole ou le modèle d’empreinte spécifié dans le champ de référence applicable.

4. Si aucune information de fichier de bibliothèque n’existe dans la base de données, utilisez les emplacements de modèle spécifiés pour localiser le premier fichier de bibliothèque contenant une correspondance pour le symbole ou le modèle d’empreinte spécifié dans le champ de référence applicable.