Automatizzare le attività di progettazione con gli script

Lo scripting offre un metodo potente per ampliare le tue capacità e aumentare la produttività con Altium Designer. Uno script contiene una serie di istruzioni (comandi automatizzati) che vengono interpretate durante la sua esecuzione in Altium Designer. Gli script possono essere scritti in diversi linguaggi, corredati di finestre di dialogo sofisticate e sottoposti a debug all'interno di Altium Designer. Puoi utilizzare gli script per raggiungere i tuoi obiettivi di progettazione con un intervento minimo da parte dell'utente e un minor numero di pressioni dei tasti e clic del mouse.

Con gli script puoi automatizzare attività ripetitive ed effettuare modifiche non disponibili tramite i comandi esistenti in Altium Designer. Ad esempio, puoi utilizzare uno script per cercare e aggiornare i riferimenti fiduciali in un documento PCB o per esportare una netlist personalizzata.

Gli script possono essere salvati in un progetto di script o in un progetto di progettazione. In Altium Designer sono disponibili diversi linguaggi per la scrittura degli script.

Panoramica e configurazione del sistema di scripting

Il sistema di scripting di Altium Designer fornisce tutti gli strumenti e le funzionalità necessari per creare script che automatizzano le attività nel software.

Gli script possono essere scritti per automatizzare attività ripetitive o potenziare una funzionalità di Altium Designer. Il sistema di scripting è composto da due parti principali: l'editor e il debugger. L'editor di script, il debugger e i pannelli di scripting lavorano insieme per aiutarti a scrivere ed eseguire il debug degli script con facilità. Uno script può essere eseguito direttamente dall'editor di script oppure assegnato a un menu, a una barra degli strumenti o a un tasto di scelta rapida, in modo da poterlo applicare in qualsiasi momento al documento corrente, ad esempio un PCB.

► Scopri di più sul sistema di scripting in Altium Designer

Creazione e archiviazione degli script

Gli script di Altium Designer vengono generalmente creati e archiviati in un progetto di script (*.PrjScr), ma possono essere aggiunti o archiviati in qualsiasi tipo di progetto.

Per iniziare a scrivere script, crea un nuovo progetto di script e aggiungi i file di script al progetto.

Un progetto di script ti aiuta a gestire gli script e può essere creato selezionando File » New » Project » Script Project dai menu principali. Il nuovo progetto verrà elencato nel pannello Projects. Per aggiungere un nuovo script al progetto, fai clic con il pulsante destro del mouse sul nome del progetto e seleziona Add New to Project dal menu contestuale.

Quando crei un nuovo script, puoi scegliere tra due tipi di script in base ai requisiti del progetto: unità di script e moduli di script. Le unità di script consentono di scrivere procedure e funzioni autonome. I moduli di script consentono di creare finestre di dialogo con controlli e gestori di eventi, oltre a procedure e funzioni.

► Scopri di più sulla creazione e archiviazione degli script in Altium Designer

Scrittura degli script

Alla scrittura degli script si applicano diversi concetti e termini fondamentali:

• I processi sono stringhe di comando che puoi utilizzare per eseguire comandi negli script.

• I componenti sono oggetti di controllo visivi presenti nel pannello Tool Palette, che puoi trascinare e rilasciare su un modulo di script per intervenire sul progetto.

• Un componente inserito in un modulo di script dispone di metodi, proprietà ed eventi.

• Le interfacce degli oggetti sono interfacce speciali che puoi utilizzare per estrarre e modificare, tramite gli script, i dati dei documenti di progettazione.

Il linguaggio di scripting predefinito è DelphiScript (*.pas). Il motore di scripting stesso è scritto in Embarcadero Delphi e il pannello Tool Palette è basato sulla VCL (Visual Component Library) di Delphi.

► Scopri di più sulla scrittura degli script in Altium Designer

Strumenti di modifica e debug degli script

Il sistema di scripting di Altium Designer è composto da due parti principali: l'editor e il debugger. L'editor offre una serie di funzionalità di assistenza alla scrittura e di analisi del codice degli script, mentre il debugger consente di accedere ai componenti degli script e alle funzionalità di debug. Gli strumenti dell'editor di script sono una risorsa fondamentale per il debug degli script.

Il sistema di scripting offre diversi strumenti per facilitare il debug degli script. Tra questi figurano l'impostazione di più punti di interruzione in uno script, l'uso del pannello Watch List per monitorare il valore delle variabili, l'uso dei segnalibri per spostarsi più rapidamente e le funzionalità di esecuzione passo passo con o senza ingresso nelle procedure per seguire il flusso degli script.

► Scopri di più sugli strumenti di modifica degli script in Altium Designer

► Scopri di più sul debug degli script in Altium Designer

Esecuzione degli script

Sebbene il sistema di scripting di Altium Designer offra gli strumenti per creare attività automatizzate sofisticate per Altium Designer, gli script risultanti devono anche essere facilmente accessibili durante il processo di progettazione. Ad esempio, uno script creato per eseguire un insieme complesso di operazioni durante la modifica di un PCB dovrebbe essere immediatamente disponibile nell'editor PCB stesso, dove può essere eseguito con uno o due clic del mouse.

Altium Designer lo consente permettendo di assegnare uno script a un avviatore di processi e quindi a un comando che può essere associato a un menu, a una barra degli strumenti e a una scorciatoia.

Quando uno script è aperto nell'editor di script, può essere eseguito utilizzando il comando Run dell'editor. Questo richiede che il progetto di script sia aperto in Altium Designer, un approccio poco pratico per accedere, ad esempio, a uno script necessario durante la progettazione di un PCB. In alternativa, la finestra di dialogo Select Item To Run (File » Run Script) consente di individuare uno script sul disco rigido locale o in un Workspace connesso e quindi eseguire il processo desiderato. Lo script rimane caricato per la sessione corrente.

Un metodo più adatto per accedere a uno script utilizzato frequentemente consiste nell'installare il progetto come progetto globale dalla pagina Scripting System – Global Projects della finestra di dialogo Preferences. In questo caso, il progetto viene caricato automaticamente all'avvio di Altium Designer e può essere eseguito in qualsiasi momento tramite il comando File » Run Script.

► Scopri di più sull'esecuzione degli script in Altium Designer

Componenti grafici per lo scripting

I componenti visivi dei moduli disponibili per gli script di Altium Designer derivano principalmente dalla Visual Component Library (VCL) di Embarcadero, una raccolta di componenti visivi predefiniti per lo sviluppo di applicazioni Windows con i linguaggi Delphi e C++.

Sviluppata come libreria di classi visive, la VCL comprende classi che discendono dall'oggetto TComponent (a sua volta derivato dall'oggetto radice TObject) in una gerarchia lineare di oggetti. Pertanto, un comune componente di script, come l'oggetto TButton, eredita le proprietà, i metodi e gli eventi dai propri oggetti antenati. In questo caso, la gerarchia delle classi è: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.

Tieni presente che i componenti che discendono dall'oggetto TControl sono generalmente componenti visivi (controlli), mentre i componenti comuni che discendono da TWinControl sono per lo più wrapper dell'API di Windows.

Quando crei un modulo nell'editor di script di Altium Designer, puoi accedere ai componenti dal pannello Tool Palette. Ai moduli di script è associato un file *.DFM, che include i dettagli della configurazione del modulo, le posizioni dei suoi componenti e altri attributi; il file si trova nella cartella che ospita il progetto di script. Altium Designer consente di utilizzare i componenti sia con DelphiScript sia con VBScript durante la progettazione dei moduli di script.

► Scopri di più sui componenti grafici per lo scripting in Altium Designer

Esempi di script

Per approfondire gli aspetti generali del sistema di scripting e l'uso di Delphi e dei modelli a oggetti X2 negli script, vengono esaminati due progetti di esempio dal punto di vista funzionale: uno script per la copia del contorno della scheda e uno per la generazione della netlist. Gli script Board Outline Copier e Netlister sono sviluppati utilizzando i modelli a oggetti X2 per illustrare le funzionalità del sistema di scripting in Altium Designer.

Si tratta di script esistenti disponibili nel pacchetto di esempi scaricabile da Altium. Si noti che questo file ZIP è stato creato al momento del lancio di Altium Designer 10. La cartella Scripts all'interno del file ZIP contiene sottocartelle organizzate per linguaggio di scripting.

Si noti che è possibile trovare un'ampia gamma di script utili nella raccolta GitHub di Altium Designer.

► Scopri di più sull'analisi degli esempi di script in Altium Designer

► Scopri di più sulla guida di riferimento agli esempi di scripting per Altium Designer

Supporto dei linguaggi di scripting

Gli script per Altium Designer possono essere scritti in diversi linguaggi di scripting. Si noti che il linguaggio principale, nonché quello a cui si fa più spesso riferimento nella documentazione sullo scripting, è DelphiScript, strettamente correlato a Embarcadero Delphi™.

► Scopri di più sul supporto dei linguaggi di scripting in Altium Designer