MétodoSCRIPT: Consejos y trucos

Edita tu primer script en PSTrace

El software PSTrace controla todos los instrumentos PalmSens. Ahora conecte un instrumento que soporte MethodSCRIPT a su ordenador e inicie PSTrace.

1. Conecte su instrumento en PSTrace
2. Seleccione una técnica y ajuste los parámetros. Por ejemplo LSV de -0,5 V a 0,5 V.
3. Haga clic en "Show MethodSCRIPT" en la parte inferior
4. Edite un ajuste, por ejemplo, duplique la velocidad de exploración de 0,1 V/s a 0,2 V/s.
5. Copie la secuencia de comandos en el portapapeles.

El código resultante tendrá este aspecto:

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 no puedes ver el botón Mostrar MethodSCRIPT, por favor habilítalo yendo a herramientas -> configuración general -> Mostrar editor MethodSCRIPT como se muestra en la imagen de abajo.

Crear MethodSCRIPTs usando Arrastrar y Soltar

Con una interfaz intuitiva de arrastrar y soltar, puede construir métodos completos seleccionando comandos, colocándolos en el orden correcto y viendo al instante la estructura de su script. Este flujo de trabajo visual acelera el desarrollo de métodos, reduce los errores y le ayuda a pasar de la idea a la medida más rápidamente, sin necesidad de escribir manualmente el código.

El Editor Visual MethodSCRIPT está en PSTrace 5.13 y posteriores.

Edita tu código con Notepad

Puedes usar cualquier editor de texto para cambiar el código MethodSCRIPT. Si prefieres Notepad++, puedes obtener un resaltado de sintaxis correcto usando el archivo MethodSCRIPT XML.

Para resaltar los archivos MethodSCRIPT que terminan en .mscr en el Bloc de notas++, siga estos pasos:

1. Descargue y descomprima el archivo MethodSCRIPT XML.
2. En el Bloc de notas++, seleccione Idioma, Idioma definido por el usuario, Defina su idioma, importar.
3. Seleccione el archivo MethodSCRIPT_vx.x.xml.
4. Reinicia Notepad++

Cada archivo .mscr que abra, se cargará automáticamente con el resaltado de sintaxis correcto.

Edita tu script usando Visual Studio Code

Alternativamente, puedes editar tu script con Visual Studio Code. Puedes obtener resaltado de sintaxis, IntelliSense, validación y formato de código para archivos MethodSCRIPT usando este plugin MethodSCRIPT.

Aprender los comandos MethodSCRIPT

El script consiste en una serie de comandos predefinidos. Cada comando comienza con la cadena de comandos, seguida de un número predefinido de argumentos. Los argumentos van separados por un ' ' (espacio). Cada comando termina con un carácter 'n' (nueva línea). La "n" se omite en la mayoría de los ejemplos. Cada línea tiene un máximo de 128 caracteres. Se pueden añadir comentarios haciendo que el primer carácter de la línea que no sea un espacio en blanco sea '#'.

Para enviar un script al dispositivo, primero envíe "en". Esto pone el dispositivo en modo MethodSCRIPT. Para terminar el script, añada una línea que contenga sólo una "n". Los siguientes ejemplos envían hola mundo.

e
#This is a comment
send_string "hello world"

La respuesta a este script será:

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

Para todos los comandos, consulte la documentación de MethodSCRIPT.

Escribe y depura tu script con el editor online

Nuestro Editor MethodSCRIPT en línea te permite crear y editar rápidamente MethodSCRIPT directamente en tu navegador, sinnecesidad de instalación. Ejecuta el script directamente desde tu navegador, o cópialo en el Editor MethodSCRIPT de PSTrace. Esto le permitirá saber si el MethodSCRIPT se ejecuta correctamente o si contiene errores.

Depura tu script con Tera Term

Alternativamente para el editor online, puedes depurar usando TeraTerm. Cuando depures tu script, te gustaría obtener una respuesta inmediata: ¿en qué línea hay un error? Los instrumentos PalmSens que soportan MethodSCRIPT, pueden comunicarse a través de una conexión serie. Tera Term es un programa emulador de terminal gratuito y de código abierto. Se utiliza a menudo para la comunicación serie. A través de esta comunicación serie, puedes enviar tus comandos MethodSCRIPT y ver la respuesta del intérprete MethodSCRIPT.

Para configurar TeraTerm:

1. Descargar TeraTerm
2. Configurar el terminal para recibir y transmitir LF: salto de línea.
3. Activar eco local
4. Seleccione la fuente Consolas, estilo normal, tamaño 10
5. Conecte su instrumento
6. Como configuración del puerto serie, seleccione un puerto COM con FTDI en el ID de la instancia del dispositivo (en caso de EmStat Pico) o uno que muestre EmStat4 (para el EmStat4 LR o HR) en el nombre amigable del dispositivo.
7. Elija 230400 bit/s como velocidad para los potenciostatos basados en EmStat Pico, y 921600 bit/s para los potenciostatos basados en EmStat4.
8. Guardar la configuración

Para introducir secuencias de comandos a través de Tera Term, pegue secuencias de comandos desde el portapapeles con el botón derecho del ratón. Escribir manualmente los comandos sólo es posible para comandos cortos. Escribir comandos largos o incluso scripts provocará un error de tiempo de espera 0009. Este es un ejemplo de cómo pegar el script "hola mundo" desde el portapapeles en TeraTerm. Fíjate en las dos nuevas líneas después de "hola mundo", para las que puedes pulsar la tecla intro dos veces:

Tratamiento de errores

Pueden producirse errores que impidan la ejecución del MethodSCRIPT. Estos errores pueden producirse durante el análisis sintáctico del script o durante la ejecución del script (tiempo de ejecución).

Formato de error

• XXXX = El código de error, véase la tabla siguiente, donde:
• L = Número de línea, empezando por 1
• C = Número de carácter de línea, empezando por 1 (sólo visible durante el análisis)

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

Las líneas de comentario sólo cuentan durante el análisis

El número de línea indicado para los errores de ejecución no tiene en cuenta las líneas de comentario. Para los errores de análisis sintáctico, las líneas de comentario sí cuentan.

Solución del error

Si te encuentras con un error, consulta la descripción del mismo en esta tabla de códigos de error. La descripción del error, junto con el número de línea, te ayudará a localizar el comando incorrecto. La documentación de MethodSCRIPT te guiará con ejemplos sobre cómo utilizar cada comando.

Visualice los resultados en PSTrace

PSTrace puede visualizar corrientes y voltajes. Cada paquete de datos que recibe PSTrace, puede consistir en tiempo, voltaje y una corriente. Si has verificado en TeraTerm que tu script está libre de errores y devuelve paquetes de datos, es el momento de copiar el MethodSCRIPT en el editor PSTrace.

SWV Script de ejemplo

Este script realizará una medición SWV de -0,5 V a 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