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?
- Apri il menu Controllo - Scrivere utilizzando uno script - Selezionare un file di script per specificare il percorso del file script;
- Assicurarsi che l'editore contiene il codice corretto se lo script utilizza i dati dell'editore durante l'esecuzione;
- 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
XXun numero decimale che specifica la lunghezza della rappresentazione del testo della riga HEX;YYil codice HEX del carattere utilizzato per incollare la riga alla lunghezza richiesta;$VAR1La 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
codecodice: una riga di 256 caratteri (HEX, in alto);module_typetipo di modulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableindirizzo di tabella (HEX, in alto; ad esempio: A0, A2);offsetOffset 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:
statusstato di elaborazione: 1 — importare e eseguire lo script; 0 — visualizzare un messaggio senza importare il codice;scripttesto di script per eseguire dopo l'importazione del codice; lasciare vuoto se non è specificato uno script;messageil messaggio di ritorno, visualizzato quando lo stato = 0;codecodice restituito: una riga di 256 caratteri (HEX, in alto);module_typetipo di modulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableindirizzo di tabella (HEX, in alto; ad esempio: A0, A2);offsetOffset 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