MethodSCRIPT: Tipps & Tricks

Bearbeiten Sie Ihr erstes Skript in PSTrace

Die Software PSTrace steuert alle PalmSens. Schließen Sie nun ein Gerät, das MethodSCRIPT unterstützt, an Ihren Computer an und starten Sie PSTrace.

1. Schließen Sie Ihr Messgerät an PSTrace an
2. Wählen Sie eine Technik aus und legen Sie die Parameter fest. Zum Beispiel LSV von -0,5 V bis 0,5 V.
3. Klicken Sie unten auf „MethodSCRIPT anzeigen“
4. Bearbeiten Sie eine Einstellung, beispielsweise indem Sie die Scanrate von 0,1 V/s auf 0,2 V/s verdoppeln.
5. Skript in die Zwischenablage kopieren.

Der resultierende Code sieht dann wie folgt aus:

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

Falls die Schaltfläche „MethodSCRIPT anzeigen“ nicht sichtbar ist, aktivieren Sie sie bitte unter „Extras“ –> „Allgemeine Einstellungen“ –> „MethodSCRIPT-Editor anzeigen“, wie in der Abbildung unten gezeigt.

MethodSCRIPTs mit Drag 'n Drop erstellen

Mit einer intuitiven Drag-and-Drop-Schnittstelle können Sie komplette Methoden erstellen, indem Sie Befehle auswählen, sie in der richtigen Reihenfolge anordnen und sofort die Struktur Ihres Skripts sehen. Dieser visuelle Arbeitsablauf beschleunigt die Methodenentwicklung, reduziert Fehler und hilft Ihnen, schneller von der Idee zur Messung zu gelangen, ohne dass Sie den Code manuell schreiben müssen.

Der visuelle MethodSCRIPT-Editor ist in PSTrace 5.13 und höher enthalten.

Bearbeiten Sie Ihren Code mit Notepad++

Sie können jeden Texteditor verwenden, um den MethodSCRIPT-Code zu ändern. Wenn Sie Notepad++ bevorzugen, können Sie die korrekte Syntaxhervorhebung mit Hilfe der XML-Datei von MethodSCRIPT erreichen.

Um in Notepad++ die Syntaxhervorhebung für MethodSCRIPT-Dateien mit der Endung .mscr zu aktivieren, führen Sie bitte die folgenden Schritte aus:

1. Laden Sie die XML-Datei MethodSCRIPT herunter und entpacken Sie sie .
2. Wählen Sie in Notepad++ „Sprache“, „Benutzerdefinierte Sprache“, „Sprache definieren“ und „Importieren“.
3. Wählen Sie die Datei MethodSCRIPT_vx.x.xml.
4. Notepad++ neu starten

Jede .mscr-Datei, die Sie öffnen, wird automatisch mit der richtigen Syntaxhervorhebung geladen.

Bearbeiten Sie Ihr Skript mit Visual Studio Code

Alternativ können Sie Ihr Skript auch mit Visual Studio Code bearbeiten. Mit dem MethodSCRIPT-Plugin erhalten Sie Syntax-Hervorhebung, IntelliSense, Validierung und Code-Formatierung für MethodSCRIPT-Dateien.

Lernen Sie die MethodSCRIPT-Befehle kennen

Das Skript besteht aus einer Reihe von vordefinierten Befehlen. Jeder Befehl beginnt mit dem Befehlsstring, gefolgt von einer vordefinierten Anzahl von Argumenten. Die Argumente werden durch ein ' ' (Leerzeichen) getrennt. Jeder Befehl wird durch ein 'n' (Zeilenumbruch) abgeschlossen. In den meisten Beispielen wird das 'n' weggelassen. Jede Zeile ist auf maximal 128 Zeichen begrenzt. Kommentare können hinzugefügt werden, indem das erste Zeichen in der Zeile, das kein Leerzeichen ist, '#' ist.

Um ein Skript an das Gerät zu senden, senden Sie zunächst "en". Dadurch wird das Gerät in den MethodSCRIPT-Modus versetzt. Um das Skript zu beenden, fügen Sie eine Zeile hinzu, die nur ein "n" enthält. Die folgenden Beispiele senden "hello world".

e
#This is a comment
send_string "hello world"

Die Ausgabe dieses Skripts lautet:

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

Für alle Befehle lesen Sie bitte die MethodSCRIPT-Dokumentation.

Schreiben und debuggen Sie Ihr Skript mit dem Online-Editor

Mit unserem Online-Editor für MethodSCRIPT können Sie schnell MethodSCRIPT direkt in Ihrem Browsererstellen und bearbeiten - eineInstallation ist nichterforderlich. Führen Sie das Skript direkt in Ihrem Browser aus, oder kopieren Sie es in den PSTrace MethodSCRIPT Editor. So erhalten Sie eine Rückmeldung, ob das MethodSCRIPT korrekt ausgeführt wird oder ob es Fehler enthält.

Debuggen Sie Ihr Skript mit Tera Term

Alternativ zum Online-Editor können Sie auch mit TeraTerm debuggen. Wenn Sie Ihr Skript debuggen, möchten Sie eine sofortige Rückmeldung erhalten: in welcher Zeile liegt ein Fehler vor? Die PalmSens , die MethodSCRIPT unterstützen, können über eine serielle Verbindung kommunizieren. Tera Term ist ein kostenloses Open-Source-Terminal-Emulator-Programm. Es wird häufig für die serielle Kommunikation verwendet. Über diese serielle Kommunikation können Sie Ihre MethodSCRIPT-Befehle senden und die Antwort des MethodSCRIPT-Interpreters sehen.

So richten Sie TeraTerm ein:

1. TeraTerm herunterladen
2. Richten Sie das Terminal so ein, dass es LF: Zeilenvorschub empfängt und sendet.
3. Lokales Echo einschalten
4. Wählen Sie die Schriftart „Consolas“, Schriftart „Regular“, Schriftgröße 10
5. Verbinden Sie Ihr Instrument
6. Wählen Sie als serielle Schnittstelle einen COM-Port aus, dessen Geräteinstanz-ID „FTDI“ enthält (im Fall von EmStat Pico) oder dessen benutzerfreundlicher Name „EmStat4“ ( für EmStat4 LR oder HR) lautet.
7. Wählen Sie als Übertragungsrate 230. 400 Bit/s für die auf EmStat Pico basierenden Potentiostaten und 921. 600 Bit/s für die auf EmStat4 basierenden Potentiostaten.
8. Speichern Sie die Einstellungen

Um Skripte über Tera Term einzugeben, fügen Sie diese bitte mit der rechten Maustaste aus der Zwischenablage ein. Das manuelle Eingeben von Befehlen ist nur bei kurzen Befehlen möglich. Das Eingeben langer Befehle oder gar Skripte löst einen Timeout-Fehler 0009 aus. Hier ist ein Beispiel für das Einfügen des „Hello World“-Skripts aus der Zwischenablage in TeraTerm. Beachten Sie die beiden neuen Zeilen nach „hello world“, für die Sie zweimal die Eingabetaste drücken können:

Fehlerbehandlung

Es können Fehler auftreten, die die Ausführung des MethodSCRIPT verhindern. Diese Fehler können entweder beim Parsen des Skripts oder während der Ausführung des Skripts (zur Laufzeit) auftreten.

Fehlerformat

• XXXX = Der Fehlercode, siehe Tabelle unten, wobei:
• L = Zeilennummer, beginnend bei 1
• C = Zeilenzeichen-Nummer, beginnend bei 1 (nur während der Analyse sichtbar)

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

Kommentarzeilen werden nur beim Parsen berücksichtigt

Die angezeigte Zeilennummer bei Laufzeitfehlern berücksichtigt keine Kommentarzeilen. Bei Parsing-Fehlern werden die Kommentarzeilen hingegen berücksichtigt.

Behebung des Fehlers

Sollte ein Fehler auftreten, suchen Sie die Fehlerbeschreibung in dieser Fehlercodetabelle. Anhand der Fehlerbeschreibung und der Zeilennummer können Sie den fehlerhaften Befehl ausfindig machen. Die MethodSCRIPT-Dokumentation enthält Beispiele zur Verwendung der einzelnen Befehle.

Visualisieren Sie die Ergebnisse in PSTrace

PSTrace kann Ströme und Spannungen visualisieren. Jedes Datenpaket, das PSTrace empfängt, kann aus Zeit, Spannung und einem Strom bestehen. Wenn Sie in TeraTerm überprüft haben, dass Ihr Skript fehlerfrei ist und Datenpakete zurücksendet, ist es an der Zeit, das MethodSCRIPT in den PSTrace-Editor zu kopieren.

SWV Beispielskript

Mit diesem Skript wird eine SWV-Messung von -0,5 V bis 0,5 V durchgeführt.

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