方法剪辑：技巧和窍门

在 PSTrace 中编辑您的第一个脚本

PSTrace软件可控制所有PalmSens仪器。现在，让我们将支持 MethodSCRIPT 的仪器连接到电脑，然后启动 PSTrace。

1. 在 PSTrace 中连接仪器
2. 选择一种技术并设置参数。例如 LSV 从 -0.5 V 到 0.5V。
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

如果看不到显示 MethodSCRIPT 按钮，请进入工具 -> 常规设置 -> 显示 MethodSCRIPT 编辑器启用它，如下图所示。

使用拖放功能创建MethodSCRIPT

利用 直观的拖放界面，你可以通过选择命令、按正确顺序排列命令并即时查看脚本结构来构建完整的方法。这种可视化工作流程加快了方法开发速度，减少了错误，并能帮助你更快地完成从构思到测量的过程，而无需手动编写代码。

可视化 MethodSCRIPT 编辑器在 PSTrace 5.13 及更高版本中。

使用记事本++编辑代码

你可以使用任何文本编辑器修改 MethodSCRIPT 代码。如果你偏爱 Notepad++，可以使用 MethodSCRIPT XML 文件获得正确的语法高亮显示。

要在记事本++中高亮显示以.mscr结尾的 MethodSCRIPT 文件，请按以下步骤操作：

1. 下载并解压 MethodSCRIPT XML 文件。
2. 在记事本++中，选择语言、用户定义语言、定义语言、导入。
3. 选择 MethodSCRIPT_vx.x.xml 文件。
4. 重新启动记事本++

您打开的每个 .mscr 文件都会自动加载正确的语法高亮显示。

使用 Visual Studio Code 编辑脚本

另外，你也可以使用 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 的 COM 端口（对于 EmStat4 LR 或 HR）。
7. 为基于 EmStat Pico 的恒电位仪选择230400比特/秒的速度，为基于 EmStat4 的恒电位仪选择921600比特/秒的速度。
8. 保存设置

要通过 Tera Term 输入脚本，请使用鼠标右键从剪贴板粘贴脚本。手动键入命令只适用于短命令。输入长命令甚至脚本都会引发超时错误 0009。下面是在 TeraTerm 中从剪贴板粘贴 hello world 脚本的示例。注意 "hello world "后面的两行新内容，可以按两次回车键：

错误处理

可能会出现阻止执行 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