MethodSCRIPT : Conseils et astuces

Editez votre premier script dans PSTrace

Le logiciel PSTrace contrôle tous les instruments PalmSens. Connectons maintenant un instrument qui supporte MethodSCRIPT à votre ordinateur, et démarrons PSTrace.

1. Connectez votre instrument à PSTrace
2. Sélectionnez une technique et définissez les paramètres. Par exemple LSV de -0,5 V à 0,5 V.
3. Cliquez sur "Show MethodSCRIPT" en bas de page.
4. Modifier un paramètre, par exemple doubler la vitesse de balayage de 0,1 V/s à 0,2 V/s.
5. Copier le script dans le presse-papiers.

Le code résultant ressemblera à ceci :

e
var c
var p
set_pgstat_chan 1
set_pgstat_mode 0
set_pgstat_chan 0
set_pgstat_mode 2
set_max_bandwidth 40
set_range_minmax da -500m 500m
set_range ba 590u
set_autoranging ba 59n 590u
set_e -500m
cell_on
meas_loop_lsv p c -500m 500m 10m 100m
pck_start
pck_add p
pck_add c
pck_end
endloop
on_finished:
cell_off

Si vous ne voyez pas le bouton Afficher la méthodeSCRIPT, activez-le en allant dans Outils -> Paramètres généraux -> Afficher l'éditeur de la méthodeSCRIPT, comme indiqué dans l'image ci-dessous.

Créer des MethodSCRIPTs en utilisant le Drag 'n Drop

Grâce à une interface intuitive de type "glisser-déposer", vous pouvez élaborer des méthodes complètes en sélectionnant des commandes, en les plaçant dans le bon ordre et en visualisant instantanément la structure de votre script. Ce flux de travail visuel accélère le développement des méthodes, réduit les erreurs et vous aide à passer plus rapidement de l'idée à la mesure, sans avoir à écrire manuellement le code.

L'éditeur visuel MethodSCRIPT est disponible à partir de PSTrace 5.13.

Modifiez votre code à l'aide de Notepad++

Vous pouvez utiliser n'importe quel éditeur de texte pour modifier le code MethodSCRIPT. Si vous préférez Notepad++, vous pouvez obtenir une coloration syntaxique correcte en utilisant le fichier XML MethodSCRIPT.

Pour obtenir la mise en évidence des fichiers MethodSCRIPT se terminant par .mscr dans Notepad++, veuillez suivre les étapes suivantes :

1. Téléchargez et décompressez le fichier XML de MethodSCRIPT.
2. Dans Notepad++, sélectionnez Langue, Langue définie par l'utilisateur, Définir votre langue, Importer.
3. Sélectionnez le fichier MethodSCRIPT_vx.x.xml.
4. Redémarrer Notepad++

Chaque fichier .mscr que vous ouvrez se chargera automatiquement avec la coloration syntaxique correcte.

Modifiez votre script avec Visual Studio Code

Vous pouvez également éditer votre script avec Visual Studio Code. Vous pouvez obtenir la coloration syntaxique, IntelliSense, la validation et le formatage du code pour les fichiers MethodSCRIPT en utilisant ce plugin MethodSCRIPT.

Apprendre les commandes MethodSCRIPT

Le script consiste en une série de commandes prédéfinies. Chaque commande commence par la chaîne de commande, suivie d'un nombre prédéfini d'arguments. Les arguments sont séparés par un ' ' (espace). Chaque commande est terminée par le caractère 'n' (nouvelle ligne). Le 'n' est omis dans la plupart des exemples. Chaque ligne est limitée à un maximum de 128 caractères. Il est possible d'ajouter des commentaires en faisant en sorte que le premier caractère non blanc de la ligne soit "#".

Pour envoyer un script à l'appareil, envoyez d'abord "en". L'appareil passe alors en mode MethodSCRIPT. Pour mettre fin au script, ajoutez une ligne contenant uniquement un "n". Les exemples suivants envoient hello world.

e
#This is a comment
send_string "hello world"

La réponse à ce script sera :

en ← Ack of the execute script cmd ‘e’
Thello worldn ← Reply of the “send_string “hello world”” cmd
n ← End of script

Pour toutes les commandes, veuillez consulter la documentation de MethodSCRIPT.

Ecrire et déboguer votre script avec l'éditeur en ligne

Notre éditeur MethodSCRIPT en ligne vous permet de créer et d'éditer rapidement des MethodSCRIPT directement dans votre navigateur - aucuneinstallation n'est nécessaire. Exécutez le script directement depuis votre navigateur, ou copiez-le dans l'éditeur PSTrace MethodSCRIPT. Celui-ci vous indiquera si le MethodSCRIPT s'exécute correctement ou s'il contient des erreurs.

Déboguer votre script avec Tera Term

Alternativement à l'éditeur en ligne, vous pouvez déboguer en utilisant TeraTerm. Lorsque vous déboguez votre script, vous souhaitez obtenir un retour d'information immédiat : sur quelle ligne y a-t-il une erreur ? Les instruments PalmSens qui supportent MethodSCRIPT peuvent communiquer via une connexion série. Tera Term est un programme d'émulation de terminal libre et gratuit. Il est souvent utilisé pour la communication série. Via cette communication série, vous pouvez envoyer vos commandes MethodSCRIPT et voir la réponse de l'interpréteur MethodSCRIPT.

Pour configurer TeraTerm :

1. Télécharger TeraTerm
2. Configurer le terminal pour qu'il reçoive et transmette LF: line feed (saut de ligne).
3. Activer l'écho local
4. Sélectionnez la police Consolas, style régulier, taille 10
5. Connectez votre instrument
6. Pour la configuration du port série, sélectionnez un port COM avec FTDI dans l'ID de l'instance de l'appareil (dans le cas de l'EmStat Pico) ou un qui indique EmStat4 (pour l'EmStat4 LR ou HR) dans le nom de l'instance de l'appareil (device friendly name).
7. Choisissez 230400 bit/s comme vitesse pour les potentiostats basés sur EmStat Pico, et 921600 bit/s pour les potentiostats basés sur EmStat4.
8. Sauvegarder la configuration

Pour saisir des scripts via Tera Term, veuillez coller des scripts à partir du presse-papiers en utilisant le bouton droit de la souris. La saisie manuelle des commandes n'est possible que pour les commandes courtes. La saisie de commandes longues ou même de scripts déclenchera une erreur de dépassement de délai 0009. Voici un exemple de collage du script hello world depuis le presse-papiers dans TeraTerm. Notez les deux nouvelles lignes après "hello world", pour lesquelles vous pouvez appuyer deux fois sur la touche Entrée :

Gestion des erreurs

Des erreurs peuvent se produire et empêcher l'exécution de la méthodeSCRIPT. Ces erreurs peuvent survenir soit lors de l'analyse du script, soit lors de l'exécution du script (runtime).

Format d'erreur

• XXXX = Le code d'erreur, voir le tableau ci-dessous, où :
• L = Numéro de ligne, à partir de 1
• C = Numéro du caractère de la ligne, commençant à 1 (visible uniquement lors de l'analyse)

#Error during parsing
!XXXX: Line L, Col Cn
#Error during runtime
!XXXX: Line Ln

Les lignes de commentaires ne sont prises en compte que lors de l'analyse

Le numéro de ligne indiqué pour les erreurs d'exécution ne tient pas compte des lignes de commentaire. Pour les erreurs d'analyse, les lignes de commentaires sont prises en compte.

Résolution de l'erreur

Si vous rencontrez une erreur, consultez la description de celle-ci dans ce tableau des codes d'erreur. La description de l'erreur, associée au numéro de ligne, vous aidera à identifier la commande incorrecte. La documentation de MethodSCRIPT vous guidera à l'aide d'exemples illustrant l'utilisation de chaque commande.

Visualiser les résultats dans PSTrace

PSTrace peut visualiser les courants et les tensions. Chaque paquet de données reçu par PSTrace peut se composer du temps, de la tension et du courant. Si vous avez vérifié dans TeraTerm que votre script ne contient pas d'erreurs et renvoie des paquets de données, il est temps de copier le MethodSCRIPT dans l'éditeur PSTrace.

SWV Exemple de script

Ce script effectue une mesure de SWV de -0,5 V à 0,5 V.

e
var c
var p
var f
var g
set_pgstat_chan 0
set_pgstat_mode 2
# Set maximum required bandwidth based on frequency * 4,
# however since SWV measures 2 datapoints, we have to multiply the
# bandwidth by 2 as well
set_max_bandwidth 80
# Set potential window.
# The max expected potential for SWV is EEnd + EAmp * 2 – EStep.
# This measurement would also work without this command since it
# stays within the default potential window of -1.1 V to 1.1V
set_pot_range -500m 690m
# Set current range for a maximum expected current of 2 uA
set_cr 2u
# Disable autoranging
set_autoranging 2u 2u
# Turn cell on for measurement
cell_on
# Perform SWV
meas_loop_swv p c f g -500m 500m 10m 100m 10
   # Send package with set potential, 
   # ”forward current – reverse current”,
   # ”forward current”
   # ”reverse current”
   pck_start
   pck_add p
   pck_add c
   pck_add f
   pck_add g
   pck_end
endloop
# Turn off cell when done or aborted
on_finished:
cell_off