메소드스크립트: 팁과 요령

PSTrace에서 첫 번째 스크립트 편집

소프트웨어 PSTrace는 모든 PalmSens 기기를 제어합니다. 이제 MethodSCRIPT를 지원하는 기기를 컴퓨터에 연결하고 PSTrace를 시작하세요.

1. PSTrace에서 기기 연결
2. 기술을 선택하고 매개변수를 설정합니다. 예: -0.5V ~ 0.5V의 LSV.
3. 하단의 '메소드 스크립트 표시'를 클릭합니다.
4. 예를 들어 스캔 속도를 0.1V/s에서 0.2V/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

메소드스크립트 표시 버튼이 보이지 않는다면 아래 이미지와 같이 도구 -> 일반 설정 -> 메소드스크립트 편집기 표시로 이동하여 활성화하세요.

드래그 앤 드롭을 사용하여 메소드스크립트 생성하기

직관적인 드래그 앤 드롭 인터페이스를 통해 명령을 선택하고 올바른 순서로 정렬하고 스크립트의 구조를 즉시 확인하여 완벽한 메서드를 구축할 수 있습니다. 이 시각적 워크플로는 코드를 수동으로 작성할 필요 없이 메서드 개발 속도를 높이고 오류를 줄이며 아이디어에서 측정까지 더 빠르게 진행할 수 있도록 도와줍니다.

시각적 메소드스크립트 에디터는 PSTrace 5.13 이상에 있습니다.

메모장++을 사용하여 코드 편집

모든 텍스트 편집기를 사용하여 MethodSCRIPT 코드를 변경할 수 있습니다. 메모장 ++를 선호하는 경우 MethodSCRIPT XML 파일을 사용하여 올바른 구문 강조 표시를 얻을 수 있습니다.

메모장++에서 .mscr로 끝나는 MethodSCRIPT 파일에 하이라이트를 적용하려면 다음 단계를 따르세요:

1. MethodSCRIPT XML 파일을 다운로드하여 압축을 풉니다 .
2. 메모장++에서 언어, 사용자 정의 언어, 언어 정의, 가져오기를 선택합니다.
3. MethodSCRIPT_vx.x.xml 파일을 선택합니다.
4. 메모장 다시 시작++

여는 모든 .mscr 파일은 올바른 구문이 강조 표시된 상태로 자동으로 로드됩니다.

Visual Studio 코드를 사용하여 스크립트 편집

또는 Visual Studio Code로 스크립트를 편집할 수도 있습니다. 이 MethodSCRIPT 플러그인을 사용하여 MethodSCRIPT 파일에 대한 구문 강조 표시, IntelliSense, 유효성 검사 및 코드 서식을 지정할 수 있습니다.

메서드 스크립트 명령어 알아보기

스크립트는 미리 정의된 일련의 명령으로 구성됩니다. 각 명령은 명령 문자열로 시작하고 그 뒤에 미리 정의된 수의 인수가 이어집니다. 인수는 ' '(공백) 문자로 구분됩니다. 각 명령은 '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 문서를 참조하세요.

온라인 편집기로 스크립트 작성 및 디버그

온라인 메소드스크립트 편집기를 사용하면 설치 없이 브라우저에서직접 메소드스크립트를 빠르게 생성하고 편집할 수 있습니다. 브라우저에서 직접 스크립트를 실행하거나 PSTrace 메소드스크립트 에디터로 복사하세요. 이렇게 하면 MethodSCRIPT가 올바르게 실행되는지 또는 오류가 있는지 피드백을 받을 수 있습니다.

테라 텀으로 스크립트 디버그

온라인 에디터의 경우, TeraTerm을 사용하여 디버깅할 수도 있습니다. 스크립트를 디버깅할 때 어느 줄에 오류가 있는지 등 즉각적인 피드백을 받고 싶을 때가 있습니다. MethodSCRIPT를 지원하는 PalmSens 기기는 직렬 연결을 통해 통신할 수 있습니다. Tera Term은 오픈 소스 무료 터미널 에뮬레이터 프로그램입니다. 직렬 통신에 자주 사용됩니다. 이 직렬 통신을 통해 메소드스크립트 명령을 전송하고 메소드스크립트 인터프리터의 응답을 확인할 수 있습니다.

TeraTerm을 설정하려면:

1. TeraTerm 다운로드
2. LF: 라인 피드 수신 및 전송을 위해 단말기를 설정합니다.
3. 로컬 에코 사용
4. Consolas 글꼴, 일반 스타일, 크기 10을 선택합니다.
5. 기기 연결
6. 직렬 포트 설정으로 장치 인스턴스 ID에 FTDI가 있는 COM 포트(EmStat Pico의 경우) 또는 장치 친화적 이름에 EmStat4가 표시된 포트(EmStat4 LR 또는 HR의 경우)를 선택합니다.
7. EmStat Pico 기반 포텐셔너리의 경우 230400비트/s를, EmStat4 기반 포텐셔너리의 경우 921600비트/s를 속도로 선택합니다.
8. 설정 저장

테라 텀을 통해 스크립트를 입력하려면 마우스 오른쪽 버튼을 사용하여 클립보드에서 스크립트를 붙여넣으세요. 수동으로 명령을 입력하는 것은 짧은 명령에 대해서만 가능합니다. 긴 명령이나 스크립트를 입력하면 시간 초과 오류 0009가 발생합니다. 다음은 TeraTerm의 클립보드에서 헬로 월드 스크립트를 붙여넣는 예제입니다. "hello world" 뒤에 새로 추가된 두 줄에 주목하세요. 이 줄은 엔터키를 두 번 누르면 됩니다:

오류 처리

메소드 스크립트 실행을 방해하는 오류가 발생할 수 있습니다. 이러한 오류는 스크립트 파싱 중 또는 스크립트 실행 중(런타임)에 발생할 수 있습니다.

오류 형식

• 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.5V에서 0.5V까지 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