Modification des symboles et des empreintes

Outre la maintenance du contenu de la base de données elle-même, il est également nécessaire de mettre à jour les symboles et les modèles référencés, selon les besoins. Cela implique de modifier les symboles schématiques et le ou les modèles d’empreinte. Et, pour une bibliothèque de base de données standard (DbLib), les définitions des 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, lorsque celui-ci est le document actif. Les sections suivantes expliquent comment procéder, une opération un peu plus complexe, mais aussi plus puissante, avec une SVNDbLib.

Utilisation d’une DbLib

Pour ouvrir le fichier de bibliothèque contenant le symbole ou le modèle d’empreinte référencé d’un composant afin de le modifier, faites un clic droit sur l’entrée du composant dans Table Browser, puis sélectionnez la commande appropriée — Open Symbol ou Open Footprint — dans le menu contextuel. Le fichier de bibliothèque correspondant s’ouvre et le symbole ou l’empreinte apparaît comme entité active dans l’espace de conception, prêt à être modifié.

Une fois les modifications nécessaires effectuées, 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.

Utilisation d’une SVNDbLib

Comme indiqué précédemment, l’accès et la modification des symboles et modèles référencés par les composants de base de données via un fichier SVNDbLib sont un peu plus complexes, mais aussi plus puissants. Les modifications sont effectuées sur des copies de travail locales des bibliothèques stockées dans le dépôt SVN.

Définition d’un espace de travail local

Pour modifier les symboles et les modèles d’empreinte des composants, vous devez extraire les fichiers du dépôt vers un répertoire de travail local. Indiquez le répertoire à utiliser sur la page Data Management - SVN Libraries de la boîte de dialogue Preferences. Un emplacement par défaut est défini pour le dossier de travail : \Users\<ProfileName>\Documents\My Designs\SVNDBlib Working Folder. Modifiez-le si nécessaire en cliquant sur le bouton  pour rechercher un dossier existant, ou en saisissant directement le chemin du dossier.

Définition 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 sont ceux indiqués dans la zone Models Location, sous l’onglet SVN Repository de la boîte de dialogue Database Library Options.

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

Modification des fichiers

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

Comme avec une DbLib, les méthodes suivantes permettent d’accéder à un symbole ou à un modèle pour le modifier :

• Dans le document SVNDbLib, faites un clic droit sur l’entrée du composant dans Table Browser, puis sélectionnez la commande appropriée — Open Symbol ou Open Footprint — dans le menu contextuel.

• Si la SVNDbLib est ajoutée à la liste des bibliothèques disponibles basées sur des fichiers, vous pouvez accéder aux commandes de modification directement depuis le panneau Components. Sélectionnez l’entrée du composant souhaité, puis utilisez respectivement la commande Edit Symbol (dans le menu contextuel accessible par clic droit dans la zone Components ) ou la commande Edit Footprint (dans le menu contextuel accessible par clic droit dans la zone Models ).
• Utilisez la commande File » Open de l’éditeur de bibliothèque pour rechercher et ouvrir la bibliothèque souhaitée (dans votre dossier de travail local).
• Faites glisser le fichier de bibliothèque (situé dans votre dossier de travail local) depuis l’Explorateur Windows directement dans Altium Designer.

Dans tous les cas, une fois les modifications nécessaires effectuées, 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 panneau Storage Manager. Lorsque le fichier SVNDbLib est le document actif, le panneau Storage Manager affiche les dossiers de symboles et de modèles extraits vers le dossier de travail local. Les dossiers affichés sont précisément ceux indiqués dans la zone Model Locations, sous l’onglet SVN Repository de la boîte de dialogue Database Library Options.

Le panneau Storage Manager reflète le contenu du dossier de travail local, à condition que le fichier SVNDbLib soit le document actif dans Altium Designer.

Pour ouvrir un fichier de bibliothèque afin de le modifier, faites un clic droit sur son entrée dans la zone All Files du panneau, puis choisissez Open dans le menu contextuel qui apparaît. Effectuez les modifications nécessaires et enregistrez le fichier comme d’habitude à 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 plusieurs façons d’ouvrir une bibliothèque pour la modifier, la validation des modifications effectuées — depuis within Altium Designer — ne peut se faire que via le panneau Storage Manager.

Lors de l’utilisation du panneau Storage Manager , l’un des points les plus importants à retenir est d’actualiser l’état du lien entre les dossiers/fichiers de travail locaux (affichés dans le panneau) et les dossiers/fichiers correspondants dans le dépôt de contrôle de version. Pour une bibliothèque sélectionnée individuellement, cette opération s’effectue à l’aide de la commande Refresh, accessible depuis le menu contextuel de la zone All Files du panneau. Pour actualiser rapidement l’état d’un dossier entier, utilisez le raccourci clavier Ctrl+F5.

Les états relatifs à l’utilisation des bibliothèques locales de symboles et de modèles sont les suivants :

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 antérieure à celle du dépôt et n’est donc plus à jour. Vous devez récupérer la dernière version du fichier depuis le dépôt, afin de mettre à jour votre copie de travail locale, avant de pouvoir modifier le fichier et enregistrer vos propres modifications dans le dépôt. Utilisez la commande Update (dans le menu contextuel accessible par clic droit) pour récupérer le fichier le plus récent 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 vers le dépôt, faites un clic droit sur l’entrée du fichier et choisissez la commande Commit dans le menu contextuel. Une fois le fichier enregistré dans le dépôt, son état redevient No modification.
	Conflict	Le fichier a été enregistré dans le dépôt par un autre utilisateur d’Altium Designer avant que vous n’y enregistriez votre propre version modifiée et sauvegardée. 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 autre utilisateur ne peut pas mettre à jour un fichier verrouillé vers une nouvelle révision dans le dépôt (à moins de forcer son déverrouillage). Cet état peut être associé à d’autres icônes, telles que celles de Modified  ou No Modification , lorsque ces états s’appliquent également.

Comparaison physique des révisions

Une comparaison physique peut être effectuée entre deux révisions quelconques d’un même symbole (bibliothèque de modèles). Elle permet de visualiser clairement les modifications apportées entre des révisions consécutives ou non 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 du système de contrôle de version et l’historique local.

La comparaison peut être effectuée entre deux révisions quelconques. À l’aide de la méthode de sélection Windows Ctrl+click, sélectionnez les deux révisions de la bibliothèque que vous souhaitez comparer dans la zone VCS Revisions du panneau, faites un clic droit et choisissez Compare.

Une fois la commande Compare exécutée, les deux révisions sélectionnées du document 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.