Escape al artículo

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?

  1. Abrir el menú Control - Escribir usando un script - Seleccionar un archivo de script para especificar la ruta del archivo de script;
  2. Asegúrese de que el editor contenga el código correcto si el script utiliza datos del editor durante la ejecución;
  3. 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

  • XX un número decimal que especifica la longitud de la representación de texto de la cadena HEX;
  • YY el código HEX del carácter utilizado para rellenar la cadena hasta la longitud requerida;
  • $VAR1 la 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
  • code código: una cadena de 256 caracteres (HEX, mayúscula);
  • module_type tipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table dirección de tabla (HEX, mayúscula; por ejemplo: A0, A2);
  • offset desplazamiento 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:

  • status estado de procesamiento: 1 - importar y ejecutar el script; 0: muestra un mensaje sin importar código;
  • script texto del script para ejecutar después de importar el código; déjelo vacío si no se especifica ningún script;
  • message mensaje devuelto, mostrado cuando estado = 0;
  • code código devuelto: una cadena de 256 caracteres (HEX, mayúscula);
  • module_type tipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table dirección de tabla (HEX, mayúscula; por ejemplo: A0, A2);
  • offset desplazamiento 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
Actualizado: