Modifying Symbols & Footprints

Outre la maintenance du contenu de la base de données elle-même, il est également nécessaire de maintenir les symboles et modèles référencés, lorsque cela s’avère nécessaire. Cela implique d’apporter des modifications aux symboles schématiques et au(x) modèle(s) d’empreinte. Et, pour une bibliothèque de base de données standard (DbLib), aux définitions dans les fichiers de modèles de simulation.

Les deux types de bibliothèques de base de données — standard et sous contrôle de version — permettent d’accéder au symbole et au modèle d’empreinte référencés pour les modifier, directement depuis la vue principale du document DbLib/SVNDbLib lorsqu’il est ouvert comme document actif. Les sections suivantes expliquent comment procéder, ce qui est un peu plus complexe, mais aussi un peu plus puissant, lors de l’utilisation d’une SVNDbLib.

Lors de l’utilisation d’une DbLib

Pour ouvrir en modification le fichier de bibliothèque du symbole/modèle d’empreinte référencé d’un composant, cliquez avec le bouton droit sur l’entrée du composant dans le Table Browser, puis sélectionnez la commande appropriée — soit Open Symbol, soit Open Footprint — dans le menu contextuel. Le fichier de bibliothèque applicable sera ouvert et le symbole/l’empreinte sera présenté comme entité active dans l’espace de conception, prêt à être modifié.

Une fois les modifications effectuées selon les besoins, enregistrez le fichier de bibliothèque.

Exemple d’accès au symbole référencé d’un composant de base de données, directement depuis la DbLib.

Lors de l’utilisation d’une SVNDbLib

Comme indiqué, la possibilité d’accéder aux symboles et modèles référencés par les composants de base de données et de les modifier via un fichier SVNDbLib est un peu plus complexe, mais aussi plus puissante. Les modifications sont apportées à des copies de travail locales des bibliothèques stockées dans le dépôt SVN.

Spécification d’un espace de travail local

Pour modifier les symboles de composants et les modèles d’empreinte, vous devrez extraire les fichiers du dépôt vers un répertoire de travail local. Spécifiez le répertoire requis à utiliser dans la page Data Management - SVN Libraries page de la boîte de dialogue Preferences. Un emplacement de dossier de travail par défaut est défini — \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Modifiez-le selon vos besoins soit en cliquant sur le bouton  pour parcourir jusqu’à un dossier existant, soit en saisissant directement le chemin du dossier.

Spécification d’un répertoire de travail local.

Pour extraire rapidement toutes les bibliothèques de symboles et de modèles d’empreinte du dépôt vers le dossier de travail local désigné, exécutez la commande Check Out All Working Folders depuis le menu principal Tools de l’éditeur SVNDatabaseLib. Les dossiers extraits seront ceux spécifiés dans la zone Models Location, dans l’onglet SVN Repository de la boîte de dialogue Database Library Options dialog.

Exemple des symboles et empreintes — stockés dans le dépôt SVN et spécifiés dans le cadre du Database Library Options — extraits vers un dossier de travail local.

Apporter des modifications

Une fois les bibliothèques de symboles et de modèles d’empreinte extraites vers votre dossier de travail local désigné, vous pouvez alors les modifier selon les besoins. Cela implique de modifier la copie locale des symboles schématiques et des modèles d’empreinte, puis de valider ces modifications dans le dépôt SVN.

Comme avec une DbLib, les méthodes suivantes sont disponibles pour accéder à un symbole/modèle en modification :

• Dans le document SVNDbLib, cliquez avec le bouton droit sur l’entrée du composant dans le Table Browser, puis sélectionnez la commande appropriée — soit Open Symbol, soit Open Footprint — dans le menu contextuel.

• Si la SVNDbLib est ajoutée à la liste Available File-based Libraries, vous pouvez accéder directement aux commandes de modification via le Components panel. Sélectionnez l’entrée de composant requise, puis utilisez la commande Edit Symbol (dans le menu contextuel accessible par clic droit pour la zone Components ) ou la commande Edit Footprint (dans le menu contextuel accessible par clic droit pour la zone Models ), respectivement.
• Utilisez la commande File » Open de l’éditeur de bibliothèque pour parcourir et ouvrir la bibliothèque requise (dans votre dossier de travail local).
• Faites glisser-déposer le fichier de bibliothèque (dans votre dossier de travail local) depuis l’Explorateur Windows directement dans Altium Designer.

Dans chaque cas, une fois les modifications effectuées selon les besoins, enregistrez le fichier de bibliothèque.

Cependant, l’interface principale entre les dossiers et fichiers extraits vers le dossier de travail local et le dépôt lui-même est le Storage Manager panel. Lorsque le fichier SVNDbLib est le document actif, le Storage Manager panel affichera les dossiers de symboles et de modèles extraits vers le dossier de travail local. Les dossiers exacts listés seront ceux spécifiés dans la zone Model Locations, dans l’onglet SVN Repository de la boîte de dialogue Database Library Options.

Le Storage Manager panel reflète le dossier de travail local — à condition que le fichier SVNDbLib soit le document actif dans Altium Designer.

Pour ouvrir un fichier de bibliothèque en modification, cliquez avec le bouton droit sur son entrée dans la zone All Files du panneau, puis choisissez Open dans le menu contextuel qui apparaît. Apportez les modifications nécessaires et enregistrez le fichier normalement à l’aide de la commande standard Save de l’éditeur associé.

Validation des modifications dans le dépôt

Panel page: Storage Manager

Bien qu’il existe différentes façons d’ouvrir une bibliothèque pour la modifier, la validation de toute modification effectuée — depuis within Altium Designer — ne peut être réalisée que via le Storage Manager panel.

L’un des points les plus importants à retenir lors de l’utilisation du Storage Manager panel est d’actualiser l’état du lien entre les dossiers/fichiers du dossier de travail local (affichés dans le panneau) et les dossiers/fichiers correspondants dans le dépôt de contrôle de source. Pour une bibliothèque sélectionnée individuellement, cela se fait à l’aide de la commande Refresh, disponible dans le menu contextuel accessible par clic droit dans la zone All Files du panneau. Pour actualiser rapidement l’état d’un dossier entier, utilisez le raccourci clavier Ctrl+F5.

Les états pertinents pour le travail avec les bibliothèques locales de symboles et de modèles sont :

Icône	État	Description
	No modification	La copie locale de la bibliothèque est identique à celle du dépôt. Vous pouvez ouvrir le fichier et y apporter des modifications.
	Out of date	La copie locale du fichier (dans le dossier de travail) est plus ancienne que son équivalent dans le dépôt et est donc obsolète. Vous devrez récupérer la dernière version du fichier depuis le dépôt — en mettant à jour votre propre copie de travail locale — avant de pouvoir modifier et valider vos propres changements. Utilisez la commande Update (dans le menu contextuel accessible par clic droit) pour récupérer le dernier fichier depuis le dépôt.
	Modified	La copie locale du fichier a été modifiée dans Altium Designer et enregistrée dans le dossier de travail. Pour envoyer vos modifications locales dans le dépôt, cliquez avec le bouton droit sur l’entrée du fichier et choisissez la commande Commit dans le menu contextuel. Une fois validé dans le dépôt, l’état reviendra à No modification.
	Conflict	Le fichier a été validé par un autre utilisateur d’Altium Designer avant que vous n’ayez validé votre propre version modifiée et enregistrée de ce fichier. Utilisez la commande Update ou Resolve pour déterminer quelle version du fichier deviendra la dernière révision dans le dépôt.
	Locked	Le fichier a été verrouillé par vous-même ou par un autre utilisateur. Un fichier verrouillé ne peut pas être mis à jour vers une nouvelle révision dans le dépôt par un autre utilisateur (sauf si son déverrouillage est forcé). Cet état peut être associé à d’autres icônes, telles que celles de Modified  ou No Modification , lorsque ces conditions d’état s’appliquent également.

Comparaison physique des révisions

La comparaison physique peut être effectuée entre deux révisions quelconques d’un même symbole (bibliothèque de modèles). Cela vous permet de voir clairement, de manière visuelle, les modifications qui ont été apportées, entre des révisions consécutives ou non consécutives du fichier.

Dans le panneau Storage Manager, la comparaison s’effectue depuis la zone VCS Revisions située en bas du panneau.

Le panneau Storage Manager présente deux vues de l’historique du fichier sélectionné, avec des zones distinctes pour les révisions VCS et l’historique local.

La comparaison peut être effectuée entre deux révisions quelconques. En utilisant la technique de sélection de Windows Ctrl+click, sélectionnez les deux révisions de la bibliothèque que vous souhaitez comparer dans la zone VCS Revisions du panneau, cliquez avec le bouton droit, puis choisissez Compare.

Une fois la commande Compare invoquée, les deux révisions de document sélectionnées s’ouvrent côte à côte dans l’espace de travail, la comparaison graphique est effectuée, et toutes les différences détectées entre les deux sont répertoriées dans le panneau Differences.

Comparaison graphique directement dans l’espace de conception de l’éditeur de bibliothèque .