Scopri l'articolo

Scrivere con scrittura

Gli script sono un meccanismo speciale di applicazione per l'invio e il trattamento delle istruzioni in modo sequenziale. Possono configurare le impostazioni di codifica del pannello, leggere e scrivere la memoria del transitor e eseguire altre operazioni.

Utilizzare gli script quando un trasmissore richiede una procedura di programmazione che differisce dalla norma MSA e richiede una sequenza di istruzioni speciali per salvare con successo i cambiamenti della memoria. Gli script possono anche automatizzare la programmazione ripetuta di diverse aree di memoria transitor con minimo coinvolgimento operatore.


Come posso usare uno script?

  1. Apri il menu Controllo - Scrivere utilizzando uno script - Selezionare un file di script per specificare il percorso del file script;
  2. Assicurarsi che l'editore contiene il codice corretto se lo script utilizza i dati dell'editore durante l'esecuzione;
  3. Fare clic sul pulsante di scrittura della memoria del transitor per eseguire lo script.

Quando si esegue un script, l'applicazione ignora le impostazioni di area della memoria attualmente selezionate. Le aree di lettura e scrittura devono essere specificate nei comandi dello script.

Si prega di notare che il software non verifica se la scrittura è riuscita dopo che un script finisce.


Come faccio a chiarire lo scenario selezionato?

Vai al menu Controllo - Scrivere utilizzando uno script - Ristrutturare lo script eliminare lo script selezionato e tornare alla scrittura standard.


Come faccio a creare uno scenario?

La sintesi del comando script si basa sul protocollo di comando SFPTotal.

Esempio di:

// 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

Crea un file di testo e inserisci una istruzione per linea. Salva il file script per utilizzare questa procedura di programmazione nell'applicazione.


Comandi script aggiuntivi

I seguenti comandi aggiuntivi sono trattati dalla domanda.

PAUSE

Scritto di riposo. La pausa predefinita è 100 ms.

Un parametro opzionale stabilisce la durata della pausa in millisecondi.

PAUSE
Delay 100ms
PAUSE=2000
Delay 2000ms


SETCHECKSUM

Riscaldare il controllo.


SETVAL

Configurare la cella di editore all'offset XX per valutare YY. Determinare i valori dei parametri nel formato HEX.

Il parametro offset accetta valori da 00 a 7F.

SETVAL 7F 03


{00;7F}

La sostituzione macro {XX;YY} viene utilizzato all'interno di altri comandi per inserire un segmento di codice dall'editore. Durante l'esecuzione dello script, il macro viene automaticamente sostituito con i dati dell'editore corrente che iniziano al byte XX e spingono i byti YY.

Si noti che un parametro YY è di 00 in HEX significa che 1 byte è sostituito, mentre un valore di 7F in HEX significa che i byti 128 sono sostituiti. Imposta YY alla lunghezza del segmento in byte minus uno, espresso in hexadecimal.

Esempio: scrivere un segmento a 128 byte alla pagina A2h all'offset 80h.

w2A200807F{00;7F}

Esempio: scrivere un segmento di margine 96-byte DDM alla pagina A2h all'offset 00h, seguita da una lettura.

W2A200005F{00;5F}

Esempio: assegnare una variabile il segmento di codice 16-byte all'offset 0x44 che contiene il numero di serie.

$VAR2={44;0F}


$VAR1

La variabile di buffer è $VAR1. Utilizzare variabili buffer per memorizzare i segmenti di codice dall'editore e inserire i loro contenuti durante l'esecuzione dello script.

L'applicazione supporta 10 variabili di buffer, $VAR0–$VAR9.

$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
$VAR4=002AFE
$VAR5=4F


$YYYY

Inserisci l'anno in corso nel comando.


$MM

Inserisci il mese in ordine.


$DD

Inserisci il giorno corrente nel comando.


BACKUPTOFILE

Inizia una copia di backup per il tipo di modulo selezionato nelle impostazioni dell'applicazione. L'applicazione legge le pagine disponibili in modo sequenziale e salva i dati in un file. Questo comando è equivalente a invocare la funzione dal menu di applicazione.


BACKUPDIR

Inserisci il backup directory. I parametri aggiuntivi possono essere utilizzati per creare un directory con un nome specifico.

Esempio: creare un directory di backup con la data nel suo nome.

$VAR5=SOMETEXT
BACKUPDIR=\$YYYY-$MM-$DD_$VAR5\
BACKUPTOFILE


IMPORTFILE

Importare il codice HEX da un file binario all'editor.

IMPORTFILE=\catalog\filename.bin


IMPORTHEX

Importare il codice HEX nell'editore.

Esempio: importare un segmento di codice a 128 byte nell'editore.

IMPORTHEX=030407100000000000000006670000000802001E4F454D2020202020202020202020202000000B4053465031302D535220202020202020204120202003520091001A000058473936535230313020202020202020303830393236202068F0031200001111A8DD05AA642FAA6F5A64DAF3285A9D000000000000000000F05E482F

Importare il codice nell'editore con la concatenazione delle variabili buffer.

$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
IMPORTHEX=$VAR1$VAR2$VAR3


INCREMENT

Aumentare il valore di una variabile che contiene una rappresentazione hexadecimal del codice in modo che il numero alla fine della sua rappresentazione testo aumenta per uno.

Per esempio, la rappresentazione del testo della variabile SN129YY00201 Si converte in SN129YY00202.

Se il zeros precede la porzione numerica, l'applicazione cerca di preservare la lunghezza della riga originale quando il numero incrementato ha bisogno di un numero aggiuntivo, spostando il valore a sinistra. Così, il valore SN129YY00999 Si converte in 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

Riempire la zona specifica del venditore nell'editore con zero.


COUNTER

Il contratto di iterazione scrittura.

Metti questo comando all'inizio di un file script che funziona in un loop. Il numero attuale di iterazione è disponibile attraverso la variabile $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 ...

Confronta i valori. Utilizzare questo costruttore per confrontare A e B e eseguire il comando seguendo THEN se la condizione specificata è vera.

// 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

Ripetere lo scenario. Posizionare questo comando alla fine del file script per dire all'applicazione di eseguire nuovamente la procedura. Il comando UNLOOP cancella LOOP. Utilizzare una condizione per uscire dal loop e evitare ripetizioni infinite.

Un esempio con una condizione.

COUNTER
...
R1A000007F
...
// Repeat the script until 10 iterations have completed
IF $COUNTER < 10 THEN LOOP

Se uno script entra in un loop infinito, smettere di usare il comando globale di interruzione in <Tools - Interrupt processes>.


STRTOHEX

Convertire il testo successivo all'operatore in una riga HEX.

$VAR9=STRTOHEX QSFP28-SR4 
MSGBOX $VAR9


HEXTOSTR

Convertire la riga HEX dopo l'operatore in testo.

$VAR9=HEXTOSTR 5153465032382D535234202020202020
MSGBOX $VAR9


PADRIGHTHEX

Metti il valore hexadecimal in $VAR1 a destra con il carattere il cui codice è YY fino a quando la lunghezza della sua rappresentazione testo raggiunge XX.

Il formato di comando:

PADRIGHTHEX XX YY $VAR1

  • XX un numero decimale che specifica la lunghezza della rappresentazione del testo della riga HEX;
  • YY il codice HEX del carattere utilizzato per incollare la riga alla lunghezza richiesta;
  • $VAR1 La variabile che contiene la stringhe HEX da convertire.
// 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

Questo comando è utile quando si assegna il testo a una variabile e si converte in una riga HEX di una lunghezza specifica.


PADLEFTHEX

E’ come un Padrighthex. Metti il valore hexadecimal in $VAR1 a sinistra con il carattere il cui codice è YY fino a quando la lunghezza della sua rappresentazione di testo raggiunge XX.


SAVECODEDIR

Imposta la strada per salvare un file di codice automaticamente senza una casella di dialogo.

Esempio: impostare la strada di uscita del codice in un directory chiamato dopo il numero di serie nel codice:

$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4


SAVEFILE

Salva il codice a un file sul percorso impostato da SAVECODEDIR. L'applicazione genera il nome del file automaticamente in base al tipo e alla pagina del modulo selezionato.

$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE


SIGNATURE

Eseguire il generatore con parametri pre-set.

Questa funzionalità richiede una licenza generatore estesa nell'applicazione, che non è incluso nel pacchetto standard.


Il fuoco esterno

APIURL

Imposta l'URL utilizzata per chiamare il operatore API esterno.

APIURL=http://localhost/example/api.php

APICALL

Chiama il operatore di API esterno. Questo è equivalente a fare clic sul pulsante API nella finestra principale dell'applicazione.

Il formato di richiesta POST per le chiamate a APIURL

POST Fields: code=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000&module_type=1&table=A0&offset=00
  • code codice: una riga di 256 caratteri (HEX, in alto);
  • module_type tipo di modulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table indirizzo di tabella (HEX, in alto; ad esempio: A0, A2);
  • offset Offset da tavolo (HEX, in cima; ad esempio: 00, 80).

Il server deve restituire una riga JSON:

{"status":1,"script":"R1A000007F\r\nW1A000007F{00;7F}\r\n","message":"","code":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","module_type":"1","table":"A0","offset":"00"}

La risposta del server deve contenere i seguenti parametri:

  • status stato di elaborazione: 1 — importare e eseguire lo script; 0 — visualizzare un messaggio senza importare il codice;
  • script testo di script per eseguire dopo l'importazione del codice; lasciare vuoto se non è specificato uno script;
  • message il messaggio di ritorno, visualizzato quando lo stato = 0;
  • code codice restituito: una riga di 256 caratteri (HEX, in alto);
  • module_type tipo di modulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table indirizzo di tabella (HEX, in alto; ad esempio: A0, A2);
  • offset Offset da tavolo (HEX, in cima; ad esempio: 00, 80).


Operazioni aritmetiche

Il processore di script supporta aggiunta, sottrazione, moltiplicazione e divisione attraverso il MATH.

Il formato di comando:

MATH Value1 %Operator Value2

Operatori aritmetici supportati:

  • + - l’aggiunta di
  • - - la sottrazione
  • * la moltiplicazione;
  • / la divisione;
COUNTER
$VAR0=MATH 10 - $COUNTER
ECHO $VAR0
// Repeat the script while the condition is true
IF $VAR0 > 0 THEN LOOP


File utente

Comandi per lavorare con un file utente.

USERFILEPATH

Imposta il percorso del file utente.

USERFILEPATH=C:\Users\User\Desktop\user-file.txt

GETUSERFILESTRING

Leggi la riga specificata dal file utente.

GETUSERFILESTRING 10

SAVETOUSERFILE

Salva i dati nel file utente.

Esempio di:

// 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

Questo valore contiene il numero di righe nel file utente.

// 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
Aggiornato: