方法SCRIPT：ヒントとコツ

PSTrace で最初のスクリプトを編集する

ソフトウェア PSTraceは全てのPalmSens計測器をコントロールします。それでは、MethodSCRIPT をサポートする測定器をコンピュータに接続し、PSTrace を起動してみましょう。

1. PSTrace で計測器を接続する
2. テクニックを選択し、パラメータを設定します。例えば LSV は -0.5 V から 0.5 V です。
3. 下部にある "MethodSCRIPTを表示 "をクリックします。
4. 設定を編集します、例えばスキャンレートを0.1 V/sから0.2 V/sに倍増します。
5. スクリプトをクリップボードにコピーします。

結果のコードは次のようになります：

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

もし、Show MethodSCRIPT ボタンが表示されない場合は、下の画像のように tools -> general settings -> Show MethodSCRIPT editor で有効にしてください。

ドラッグ＆ドロップでMethodSCRIPTを作成する

直感的なドラッグ＆ドロップインターフェースにより、コマンドを選択し、正しい順序で並べ、スクリプトの構造を即座に確認することで、完全なメソッドを構築することができます。この視覚的なワークフローは、メソッド開発をスピードアップし、エラーを削減し、手作業でコードを記述することなく、アイデアから測定までを迅速に行うことができます。

Visual MethodSCRIPT Editor は PSTrace 5.13 以降に搭載されています。

メモ帳++を使ってコードを編集する

MethodSCRIPT のコードを変更するにはどのテキストエディタを使っても構いません。メモ帳++ を好むなら、MethodSCRIPT XML ファイルを使用することで正しいシンタックスハイライトを得ることができます。

メモ帳++で.mscrで終わる MethodSCRIPT ファイルのハイライトを表示するには、以下の手順に従ってください：

1. MethodSCRIPT XML ファイルをダウンロードして解凍してください。
2. メモ帳++で、言語、ユーザー定義言語、言語の定義、インポートを選択します。
3. MethodSCRIPT_vx.x.xml ファイルを選択します。
4. メモ帳++を再起動する

.mscrファイルを開くと、自動的に正しいシンタックスハイライトで読み込まれます。

Visual Studio Code を使ってスクリプトを編集する

この MethodSCRIPT プラグインを使うと、MethodSCRIPT ファイルのシンタックスハイライト、インテリセンス、検証、コードフォーマットができます。

MethodSCRIPT コマンドを学ぶ

スクリプトは一連の定義済みコマンドで構成されています。各コマンドはコマンド文字列で始まり、その後にあらかじめ定義された数の引数が続きます。引数は ' '（スペース）文字で区切られます。各コマンドは'n'（改行）文字で終了する。ほとんどの例では'n'は省略されている。各行の最大文字数は128文字である。行の最初の空白以外の文字を'#'にすることで、コメントを追加することができる。

デバイスにスクリプトを送信するには、まず "en" を送信します。これでデバイスは MethodSCRIPT モードになります。スクリプトを終了するには、'n' だけを含む行を追加します。以下の例では hello world を送信しています。

e
#This is a comment
send_string "hello world"

このスクリプトへの応答は

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

全てのコマンドは MethodSCRIPT のドキュメントを参照してください。

オンラインエディタでスクリプトを書き、デバッグする

私たちの オンライン MethodSCRIPT エディタを使えば、インストール不要で、ブラウザで直接 MethodSCRIPT を素早く作成・編集できます。ブラウザから直接スクリプトを実行するか、PSTrace MethodSCRIPT エディタにコピーしてください。これにより、MethodSCRIPT が正しく実行されるか、エラーが含まれているかどうかがフィードバックされます。

Tera Term でスクリプトをデバッグする

オンラインエディターの代わりに、TeraTerm を使ってデバッグすることができます。スクリプトをデバッグする際、どの行でエラーが発生したのか即座にフィードバックを得たいでしょう。MethodSCRIPTをサポートするPalmSens機器は、シリアル接続で通信できます。Tera Termはオープンソースでフリーのターミナルエミュレータプログラムです。シリアル通信によく使われます。このシリアル通信を介して、MethodSCRIPT コマンドを送信し、MethodSCRIPT インタープリタの応答を見ることができます。

TeraTermをセットアップする：

1. TeraTermをダウンロード
2. 端末で LF: 改行コードを送受信するように設定します。
3. ローカルエコーを有効にする
4. Consolasフォント、レギュラースタイル、サイズ10を選択します。
5. 測定器を接続する
6. シリアルポートのセットアップとして、デバイスインスタンスIDに FTDIを含むCOMポート（EmStat Picoの場合）、またはデバイスフレンドリー名に EmStat4 （EmStat4 LRまたはHRの場合）を示すCOMポートを選択します。
7. EmStat Pico ベースのポテンショスタットでは速度として230400bit/s を選択し、EmStat4 ベースのポテンショスタットでは921600bit/s を選択します。
8. セットアップを保存する

Tera Term でスクリプトを入力するには、マウスの右ボタンでクリップボードからスクリプトを貼り付けてください。手動でコマンドを入力できるのは短いコマンドだけです。長いコマンドやスクリプトを入力すると、タイムアウトエラー 0009 が発生します。これはhello worldスクリプトをクリップボードからTeraTermに貼り付けた例です。hello world "の後に2行の改行があることに注意してください：

エラー処理

MethodSCRIPT の実行を妨げるエラーが発生することがあります。これらのエラーはスクリプトのパース中またはスクリプトの実行中（ランタイム）に発生する可能性があります。

エラーフォーマット

• XXXX = エラーコード：
• L = 行番号、1から始まる
• C = 行の文字番号、1 から始まる (解析中にのみ表示される)

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

コメント行は解析時にのみカウントされる

実行時エラーの報告行数はコメント行をカウントしません。解析エラーの場合、コメント行はカウントされます。

エラーの解決

エラーに遭遇したら、下の表でエラーの説明を調べて下さい。エラーの説明と行番号を組み合わせると、間違ったコマンドを見つけるのに役立ちます。MethodSCRIPT のドキュメントには、各コマンドの使用例が記載されています。

エラー説明表

PSTrace で結果を可視化する

PSTraceは電流と電圧を可視化することができます。PSTrace が受信するデータの各パッケージは、時間、電圧、電流で構成されています。TeraTerm でスクリプトにエラーがなく、データパッケージを送り返すことを確認したら、MethodSCRIPT を PSTrace エディタにコピーします。

SWV スクリプト例

このスクリプトは -0.5 V から 0.5 V の SWV 測定を行います。

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