Automatiser les tâches de conception avec des scripts

Les scripts constituent un moyen puissant d’accroître vos possibilités et votre productivité avec Altium Designer. Un script contient un ensemble d’instructions (commandes automatisées) qui sont interprétées lors de son exécution dans Altium Designer. Les scripts peuvent être écrits dans plusieurs langages, intégrer des boîtes de dialogue sophistiquées et être débogués dans Altium Designer. Ils vous permettent d’atteindre vos objectifs de conception avec un minimum d’interventions de l’utilisateur et moins de frappes au clavier et de clics de souris.

Les scripts vous permettent d’automatiser des tâches répétitives et d’effectuer des modifications que les commandes existantes d’Altium Designer ne permettent pas de réaliser. Par exemple, vous pouvez utiliser un script pour rechercher et mettre à jour des repères de positionnement dans un document PCB, ou pour exporter une netlist personnalisée.

Les scripts peuvent être enregistrés dans un projet de scripts ou dans un projet de conception. Plusieurs langages de script sont disponibles pour écrire des scripts dans Altium Designer.

Présentation et configuration du système de scripts

Le système de scripts d’Altium Designer fournit tous les outils et toutes les fonctionnalités nécessaires pour créer des scripts qui automatisent des tâches dans le logiciel.

Les scripts peuvent être écrits pour automatiser des tâches répétitives ou enrichir une fonctionnalité d’Altium Designer. Le système de scripts se compose de deux parties principales : l’éditeur et le débogueur. L’éditeur de scripts, le débogueur et les panneaux dédiés aux scripts fonctionnent ensemble pour vous aider à écrire et à déboguer facilement vos scripts. Un script peut être exécuté directement depuis l’éditeur de scripts ou associé à un menu, à une barre d’outils ou à un raccourci clavier afin de pouvoir être appliqué à tout moment au document actif, par exemple un PCB.

► En savoir plus sur le système de scripts dans Altium Designer

Création et stockage des scripts

Les scripts Altium Designer sont généralement créés et stockés dans un projet de scripts (*.PrjScr), mais ils peuvent être ajoutés à tout type de projet ou y être stockés.

Pour commencer à écrire des scripts, créez d’abord un projet de scripts, puis ajoutez-y des fichiers de script.

Un projet de scripts vous aide à gérer vos scripts. Vous pouvez le créer en sélectionnant File » New » Project » Script Project dans les menus principaux. Le nouveau projet apparaîtra dans le panneau Projects. Pour ajouter un script au projet, cliquez avec le bouton droit sur le nom du projet et sélectionnez Add New to Project dans le menu contextuel.

Lors de la création d’un script, vous avez le choix entre deux types de scripts, selon les besoins de votre projet : les unités de script et les formulaires de script. Les unités de script vous permettent d’écrire des procédures et des fonctions autonomes. Les formulaires de script vous permettent de créer des boîtes de dialogue avec des contrôles et des gestionnaires d’événements, ainsi que des procédures et des fonctions.

► En savoir plus sur la création et le stockage des scripts dans Altium Designer

Écriture de scripts

Plusieurs concepts et termes essentiels s’appliquent à l’écriture de scripts :

• Les processus sont des chaînes de commande que vous pouvez utiliser pour exécuter des commandes dans les scripts.

• Les composants sont des objets de contrôle visuels du panneau Tool Palette que vous pouvez faire glisser et déposer sur un formulaire de script pour manipuler la conception.

• Un composant placé sur un formulaire de script possède des méthodes, des propriétés et des événements.

• Les interfaces d’objets sont des interfaces particulières que vous pouvez utiliser pour extraire et modifier les données des documents de conception depuis vos scripts.

Le langage de script par défaut est DelphiScript (*.pas). Le moteur de scripts lui-même est écrit en Embarcadero Delphi, et le panneau Tool Palette repose sur la VCL (Visual Component Library) de Delphi.

► En savoir plus sur l’écriture de scripts dans Altium Designer

Outils d’édition et de débogage des scripts

Le système de scripts d’Altium Designer se compose de deux parties principales : l’éditeur et le débogueur. L’éditeur propose diverses fonctionnalités d’aide à l’écriture et d’inspection du code des scripts, tandis que le débogueur donne accès aux composants des scripts et aux fonctionnalités de débogage. Les outils de l’éditeur de scripts constituent un atout essentiel pour le débogage des scripts.

Le système de scripts propose divers outils pour faciliter le débogage. Vous pouvez notamment définir plusieurs points d’arrêt dans un script, utiliser le panneau Watch List pour surveiller la valeur des variables, utiliser des signets pour naviguer plus efficacement et recourir aux fonctions de pas à pas détaillé et de pas à pas principal pour suivre l’exécution des scripts.

► En savoir plus sur les outils d’édition de scripts dans Altium Designer

► En savoir plus sur le débogage des scripts dans Altium Designer

Exécution des scripts

Le système de scripts d’Altium Designer permet de créer des tâches automatisées sophistiquées pour Altium Designer, mais les scripts ainsi créés doivent aussi être facilement accessibles pendant le processus de conception. Par exemple, un script créé pour effectuer un ensemble complexe d’opérations lors de l’édition d’un PCB doit être directement accessible dans l’éditeur PCB lui-même, où il peut être exécuté en un ou deux clics.

Altium Designer le permet en offrant la possibilité d’associer un script à un lanceur de processus, et donc à une commande qui peut être affectée à un menu, à une barre d’outils et à un raccourci clavier.

Lorsqu’un script est ouvert dans l’éditeur de scripts, il peut être exécuté à l’aide de la commande Run de l’éditeur. Cela nécessite que le projet de scripts soit ouvert dans Altium Designer, ce qui n’est pas une méthode pratique pour accéder à un script nécessaire pendant la conception d’un PCB, par exemple. Vous pouvez également utiliser la boîte de dialogue Select Item To Run (File » Run Script) pour rechercher un script sur votre disque dur local ou dans un Workspace connecté, puis exécuter le processus souhaité. Le script reste chargé pendant la session en cours.

Une méthode plus adaptée pour accéder à un script fréquemment utilisé consiste à installer le projet en tant que projet global depuis la page Scripting System – Global Projects de la boîte de dialogue Preferences. Dans ce cas, le projet est automatiquement chargé au démarrage d’Altium Designer et peut être exécuté à tout moment via la commande File » Run Script.

► En savoir plus sur l’exécution des scripts dans Altium Designer

Composants graphiques des scripts

Les composants visuels de formulaire utilisables dans les scripts Altium Designer sont principalement dérivés de la bibliothèque Visual Component Library (VCL) d’Embarcadero, qui regroupe des composants visuels prédéfinis pour le développement d’applications Windows dans les langages Delphi et C++.

Développées sous la forme d’une bibliothèque de classes visuelles, les classes VCL descendent de l’objet TComponent (lui-même descendant de l’objet racine TObject) dans une hiérarchie d’objets linéaire. Ainsi, un composant de script courant, tel que l’objet TButton, hérite des propriétés, des méthodes et des événements de ses objets parents. Dans ce cas, la hiérarchie des classes est la suivante : TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Notez que les composants qui descendent de l’objet TControl sont généralement des composants visuels (contrôles), et que les composants courants qui descendent de TWinControl sont principalement des encapsulations de l’API Windows.

Lors de la création d’un formulaire dans l’éditeur de scripts d’Altium Designer, les composants sont accessibles depuis le panneau Tool Palette. Les formulaires de script sont associés à un fichier *.DFM, qui contient les détails de la configuration du formulaire, l’emplacement de ses composants et d’autres attributs ; ce fichier se trouve dans le dossier hébergeant le projet de scripts. Altium Designer permet d’utiliser les composants avec DelphiScript ou VBScript lors de la conception de formulaires de script.

► En savoir plus sur les composants graphiques des scripts dans Altium Designer

Exemples de scripts

Pour mieux comprendre les aspects généraux du système de scripts et l’utilisation de Delphi et des modèles objets X2 dans les scripts, deux exemples de projets sont examinés sous l’angle de leurs fonctionnalités : un script de copie du contour de carte et un script de génération de netlist. Les scripts Board Outline Copier et Netlister sont développés à l’aide des modèles objets X2 pour illustrer les capacités du système de scripts d’Altium Designer.

Ces scripts existants sont disponibles dans les exemples à télécharger fournis par Altium. Notez que cette archive ZIP a été créée lors du lancement d’Altium Designer 10. Le dossier Scripts de l’archive ZIP contient des sous-dossiers organisés par langage de script.

Notez qu’un large éventail de scripts utiles est disponible dans la collection GitHub d’Altium Designer.

► En savoir plus sur l’analyse d’exemples de scripts dans Altium Designer

► En savoir plus sur le guide de référence des exemples de scripts pour Altium Designer

Prise en charge des langages de script

Les scripts pour Altium Designer peuvent être écrits dans plusieurs langages de script. Notez que le langage principal, et celui auquel la documentation sur les scripts fait le plus souvent référence, est DelphiScript, qui est étroitement lié à Embarcadero Delphi™.

► En savoir plus sur la prise en charge des langages de script dans Altium Designer