Escribir con guiones
Los scripts son un mecanismo de aplicación especial para enviar y procesar instrucciones de forma secuencial. Pueden configurar los ajustes de la placa de codificación, leer y escribir en la memoria del transceptor y realizar otras operaciones.
Utilice scripts cuando un transceptor requiera un procedimiento de programación que difiera del estándar MSA y necesite una secuencia de instrucciones especiales para guardar los cambios de memoria con éxito. Los scripts también pueden automatizar la programación repetida de diferentes áreas de memoria del transceptor con una mínima participación del operador.
¿Cómo uso un script?
- Abrir el menú Control - Escribir usando un script - Seleccionar un archivo de script para especificar la ruta del archivo de script;
- Asegúrese de que el editor contenga el código correcto si el script utiliza datos del editor durante la ejecución;
- Haga clic en el botón de escritura en la memoria del transceptor para ejecutar el script.
Al ejecutar un script, la aplicación ignora la configuración del área de memoria actualmente seleccionada. Las áreas de lectura y escritura deben especificarse en los comandos del script.
Tenga en cuenta que el software no verifica si la escritura se realizó correctamente una vez finalizado un guión.
¿Cómo borro el script seleccionado?
Ir al menú Control - Escribir usando un script - Restablecer script para borrar el guión seleccionado y volver a la escritura estándar.
¿Cómo creo un guión?
La sintaxis del comando de script se basa en el protocolo de comando SFPTotal.
Ejemplo:
// Write password AABBCCDD to page A2 at offset 7B
w2A2007B03AABBCCDD
// Write the code from the editor to page A0 at offset 00
w2A000007F{00;7F}
// Write value 80 to page A2 at offset 7F
w2A2007F0080
// Write value 01 to page A2 at offset FF
w2A200FF0001
PAUSE
// Read code from page A0 at offset 00
R2A000007F
Cree un archivo de texto e ingrese una instrucción por línea. Guarde el archivo de script para utilizar este procedimiento de programación en la aplicación.
Comandos de script adicionales
La aplicación procesa los siguientes comandos adicionales.
PAUSE
Pausar la ejecución del script. La pausa predeterminada es de 100 ms.
Un parámetro opcional establece la duración de la pausa en milisegundos.
PAUSE
Delay 100ms
PAUSE=2000
Delay 2000ms
SETCHECKSUM
Vuelva a calcular la suma de verificación.
SETVAL
Establezca la celda del editor en el desplazamiento XX al valor YY. Especifique los valores de los parámetros en formato HEX en mayúsculas.
El parámetro de compensación acepta valores de 00 a 7F.
SETVAL 7F 03
{00;7F}
La macro de sustitución {XX;YY} se usa dentro de otros comandos para insertar un segmento de código desde el editor. Durante la ejecución del script, la macro se reemplaza automáticamente con los datos del editor actual comenzando en el byte XX y abarcando YY bytes.
Tenga en cuenta que un valor del parámetro YY de 00 en HEX significa que se sustituye 1 byte, mientras que un valor de 7F en HEX significa que se sustituyen 128 bytes. Establezca YY en la longitud del segmento en bytes menos uno, expresada en hexadecimal.
Ejemplo: escribir un segmento de 128 bytes en la página A2h en el desplazamiento 80h.
w2A200807F{00;7F}
Ejemplo: escribir un segmento de umbral DDM de 96 bytes en la página A2h en el desplazamiento 00h, seguido de una lectura.
W2A200005F{00;5F}
Ejemplo: asignar a una variable el segmento de código de 16 bytes en el desplazamiento 0x44 que contiene el número de serie.
$VAR2={44;0F}
$VAR1
Variable de búfer $VAR1. Utilice variables de búfer para almacenar segmentos de código del editor e insertar su contenido durante la ejecución del script.
La aplicación admite 10 variables de búfer, $VAR0–$VAR9.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
$VAR4=002AFE
$VAR5=4F
$YYYY
Inserte el año actual en el comando.
$MM
Inserte el mes actual en el comando.
$DD
Inserte el día actual en el comando.
BACKUPTOFILE
Inicie una copia de seguridad para el tipo de módulo seleccionado en la configuración de la aplicación. La aplicación lee las páginas disponibles secuencialmente y guarda los datos en un archivo. Este comando equivale a invocar la función desde el menú de la aplicación.
BACKUPDIR
Configure el directorio de respaldo. Se pueden utilizar parámetros adicionales para crear un directorio con un nombre particular.
Ejemplo: crear un directorio de respaldo con la fecha en su nombre.
$VAR5=SOMETEXT
BACKUPDIR=\$YYYY-$MM-$DD_$VAR5\
BACKUPTOFILE
IMPORTFILE
Importe código HEX desde un archivo binario al editor.
IMPORTFILE=\catalog\filename.bin
IMPORTHEX
Importe el código HEX al editor.
Ejemplo: importar un segmento de código de 128 bytes al editor.
IMPORTHEX=030407100000000000000006670000000802001E4F454D2020202020202020202020202000000B4053465031302D535220202020202020204120202003520091001A000058473936535230313020202020202020303830393236202068F0031200001111A8DD05AA642FAA6F5A64DAF3285A9D000000000000000000F05E482F
Importe código al editor concatenando variables de búfer.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
IMPORTHEX=$VAR1$VAR2$VAR3
INCREMENT
Incrementar el valor de una variable que contiene una representación hexadecimal de código de modo que el número al final de su representación de texto aumente en uno.
Por ejemplo, la representación de texto de la variable SN129YY00201 se convierte en SN129YY00202.
Si los ceros preceden a la parte numérica, la aplicación intenta preservar la longitud de la cadena original cuando el número incrementado necesita un dígito adicional, desplazando el valor hacia la izquierda. Así, el valor SN129YY00999 se convierte en SN129YY01000.
$VAR1={00;43}
// Assign the code area containing the serial number to a variable
$VAR2={44;0F}
$VAR3={54;2B}
INCREMENT $VAR2
IMPORTHEX=$VAR1$VAR2$VAR3
ERASEVENDORCODE
Llene el área específica del proveedor en el editor con ceros.
COUNTER
Contador de iteraciones de script.
Coloque este comando al inicio de un archivo de script que se ejecuta en un bucle. El recuento de iteraciones actual está disponible a través de la variable $COUNTER.
// Invoke the iteration counter
COUNTER
// Assign the current counter value to a variable
$VAR0=$COUNTER
// Display the counter value
ECHO $COUNTER
IF A ... B THEN ...
Comparar valores. Utilice esta construcción para comparar A y B y ejecute el siguiente comando ENTONCES si la condición especificada es verdadera.
// Assign numeric values to variables
$VAR1=10
$VAR2=20
// Display a message box if the condition is true.
IF $VAR1 < $VAR2 THEN MSGBOX HELLO WORLD!
LOOP
Repita el guión. Coloque este comando al final del archivo de secuencia de comandos para indicarle a la aplicación que ejecute el procedimiento nuevamente. El comando UNLOOP cancela LOOP. Utilice una condición para salir del bucle y evitar repeticiones interminables.
Ejemplo con una condición.
COUNTER
...
R1A000007F
...
// Repeat the script until 10 iterations have completed
IF $COUNTER < 10 THEN LOOP
Si un script ingresa a un bucle infinito, deténgalo usando el comando de interrupción global en <Herramientas - Interrumpir procesos>.
STRTOHEX
Convierta el texto que sigue al operador en una cadena HEX.
$VAR9=STRTOHEX QSFP28-SR4
MSGBOX $VAR9
HEXTOSTR
Convierta la cadena HEX que sigue al operador en texto.
$VAR9=HEXTOSTR 5153465032382D535234202020202020
MSGBOX $VAR9
PADRIGHTHEX
Rellene el valor hexadecimal en $VAR1 a la derecha con el carácter cuyo código es YY hasta que la longitud de su representación de texto llegue a XX.
Formato de comando:
PADRIGHTHEX XX YY $VAR1
XXun número decimal que especifica la longitud de la representación de texto de la cadena HEX;YYel código HEX del carácter utilizado para rellenar la cadena hasta la longitud requerida;$VAR1la variable que contiene la cadena HEX a convertir.
// Convert text to a HEX string and store it in a variable
$VAR9=STRTOHEX QSFP28-SR4
// Pad the variable on the right with spaces (HEX code 0x20) to 16 bytes
$VAR8=PADRIGHTHEX 16 20 $VAR9
ECHO $VAR8
Este comando es útil al asignar texto a una variable y convertirlo en una cadena HEX de una longitud específica.
PADLEFTHEX
Funciona como PADRIGHTHEX. Rellene el valor hexadecimal en $VAR1 a la izquierda con el carácter cuyo código es YY hasta que la longitud de su representación de texto llegue a XX.
SAVECODEDIR
Establezca la ruta para guardar un archivo de código automáticamente sin un cuadro de diálogo.
Ejemplo: configurar la ruta de salida del código a un directorio nombrado después del número de serie en el código:
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
Salva el código a un archivo en el camino establecido por SAVECODEDIR. La aplicación genera el nombre del archivo automáticamente según el tipo y la página del módulo seleccionado.
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
SIGNATURE
Ejecute el generador con parámetros preestablecidos.
Esta característica requiere una licencia de generador extendida en la aplicación, que no está incluida en el paquete estándar.
Controlador externo API
APIURL
Establezca la URL utilizada para llamar al controlador externo API.
APIURL=http://localhost/example/api.php
APICALL
Llame al controlador externo API. Esto equivale a hacer clic en el botón API en la ventana principal de la aplicación.
Formato de solicitud POST para llamadas a APIURL
POST Fields: code=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000&module_type=1&table=A0&offset=00
codecódigo: una cadena de 256 caracteres (HEX, mayúscula);module_typetipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tabledirección de tabla (HEX, mayúscula; por ejemplo: A0, A2);offsetdesplazamiento de tabla (HEX, mayúsculas; por ejemplo: 00, 80).
El servidor debe devolver una cadena JSON:
{"status":1,"script":"R1A000007F\r\nW1A000007F{00;7F}\r\n","message":"","code":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","module_type":"1","table":"A0","offset":"00"}
La respuesta del servidor debe contener los siguientes parámetros:
statusestado de procesamiento: 1 - importar y ejecutar el script; 0: muestra un mensaje sin importar código;scripttexto del script para ejecutar después de importar el código; déjelo vacío si no se especifica ningún script;messagemensaje devuelto, mostrado cuando estado = 0;codecódigo devuelto: una cadena de 256 caracteres (HEX, mayúscula);module_typetipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tabledirección de tabla (HEX, mayúscula; por ejemplo: A0, A2);offsetdesplazamiento de tabla (HEX, mayúsculas; por ejemplo: 00, 80).
Operaciones aritméticas
El procesador de script admite suma, resta, multiplicación y división a través del MATH.
Formato de comando:
MATH Value1 %Operator Value2
Operadores aritméticos admitidos:
+- adición;-- resta;*- multiplicación;/- división;
COUNTER
$VAR0=MATH 10 - $COUNTER
ECHO $VAR0
// Repeat the script while the condition is true
IF $VAR0 > 0 THEN LOOP
Archivo de usuario
Comandos para trabajar con un archivo de usuario.
USERFILEPATH
Establezca la ruta del archivo del usuario.
USERFILEPATH=C:\Users\User\Desktop\user-file.txt
GETUSERFILESTRING
Lea la línea especificada del archivo de usuario.
GETUSERFILESTRING 10
SAVETOUSERFILE
Guardar datos en el archivo de usuario.
Ejemplo:
// Store the serial number in a variable
$VAR2={44;0F}
// Save the variable value to the user file
SAVETOUSERFILE HEXTOSTR $VAR2
// Add a line feed and carriage return
SAVETOUSERFILE HEXTOSTR 0D0A
$STRCOUNTUSERFILE
Este valor contiene el número de líneas en el archivo de usuario.
// Find the inserted line's position by subtracting the script iteration count from the file's line count
$VAR0=MATH $STRCOUNTUSERFILE - $COUNTER
ECHO $VAR0
// Read the most recently inserted line from the file
GETUSERFILESTRING $VAR0