Schreiben mit Schriften
Skripte sind ein spezielles Anwendungsmechanismus für die Sendung und Verarbeitung von Anweisungen sequentiell. Sie können die Codierung-Tabelle-Einstellungen konfigurieren, das Transceiver-Memory lesen und schreiben und andere Operationen durchführen.
Verwenden Sie Skripte, wenn ein Transceptor eine Programmierungsprozess erfordert, die sich von der MSA-Standard unterscheidet und eine Reihe von speziellen Anweisungen benötigt, um Speicheränderungen erfolgreich zu speichern. Skripte können auch wiederholte Programmierung verschiedener Transceptor-Memory-Gebiete mit minimalem Betreiber-Beteiligung automatisieren.
Wie kann ich ein Script verwenden?
- Öffnen Sie das Menü Steuerung - Schreiben mit einem Script - Wählen Sie eine Script-Datei die Script-Datei-Path zu bestimmen;
- Stellen Sie sicher, dass der Editor den richtigen Code enthält, wenn das Script während der Ausführung die Editor-Daten verwendet;
- Klicken Sie auf die Transceiver-Memory Schreiben-Button, um das Script ausführen.
Beim Ausführen eines Skriptes ignoriert die Anwendung die derzeit ausgewählten Speicherbereich-Einstellungen. Die Les- und Schreibbereiche müssen in den Skriptschriften angegeben werden.
Bitte beachten Sie, dass die Software nicht überprüft, ob das Schreiben nach dem Abschluss eines Skripts erfolgreich ist.
Wie kann ich das ausgewählte Script ausklären?
Gehen Sie zum Menü Steuerung - Schreiben mit einem Script - Reset Script das ausgewählte Skript löschen und zurück zu Standardschrift.
Wie kann ich ein Script erstellen?
Script Command Syntax basiert auf dem SFPTotal Command Protocol.
Beispiele :
// 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
Erstellen Sie eine Textdatei und geben Sie eine Anweisung pro Zeile ein. Speichern Sie die Script-Datei, um diesen Programmierverfahren in der Anwendung zu verwenden.
Weitere Script Commands
Die folgenden zusätzlichen Bestellungen werden durch die Anwendung verarbeitet.
PAUSE
Pause Script Ausführung. Die Standardpause ist 100 ms.
Ein optionaler Parameter setzt die Pause in Millisekunden fest.
PAUSE
Delay 100ms
PAUSE=2000
Delay 2000ms
SETCHECKSUM
Die Checksumme neu berechnen.
SETVAL
Setzen Sie die Editor-Zelle auf Offset XX, um YY zu bewerten. Angeben Sie die Parameterwerte im HEX-Format.
Der Offset-Parameter akzeptiert Werte von 00 bis 7F.
SETVAL 7F 03
{00;7F}
Ersatz für Macro {XX;YY} wird innerhalb anderer Befehl verwendet, um ein Code-Segment aus dem Editor einzusetzen. Während der Script-Exektion wird die Makro automatisch mit den aktuellen Editor-Daten ersetzt, die mit der Byte XX beginnen und die YY-Bytes erstrecken.
Bitte beachten Sie, dass ein YY-Parameterwert 00 in HEX bedeutet, dass 1 Byte ersetzt wird, während ein Wert von 7F in HEX bedeutet, dass 128-Bytes ersetzt werden. Set YY auf die Segmentlänge in Byten minus einer, ausgedrückt in hexadecimal.
Beispiel: Schreiben Sie ein 128-Byte-Segment auf die A2h-Seite bei 80h.
w2A200807F{00;7F}
Beispiel: Schreiben Sie ein 96-Byte-DDM-Rendegment auf die Seite A2h bei 00h, gefolgt von einem Lesen.
W2A200005F{00;5F}
Beispiele: die 16-Byte-Code-Segment bei der Offset 0x44 zu einer Variable zugeordnet, die das Seriennummer enthält.
$VAR2={44;0F}
$VAR1
Buffer Variable für $VAR1. Verwenden Sie Buffer-Variablen, um Code-Segmente aus dem Editor zu speichern und während der Script-Exektion ihre Inhalte einzulegen.
Die Anwendung unterstützt 10 Buffervariablen, $VAR0–$VAR9.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
$VAR4=002AFE
$VAR5=4F
$YYYY
Geben Sie das aktuelle Jahr in die Kommando ein.
$MM
Geben Sie den aktuellen Monat in die Kommando ein.
$DD
Geben Sie den aktuellen Tag in die Kommando ein.
BACKUPTOFILE
Starten Sie eine Backup für den in den Anwendungsinstellungen ausgewählten Modultyp. Die Anwendung liest die verfügbaren Seiten sequentiell und speichert die Daten in eine Datei. Diese Befehl entspricht der Anrufe der Funktion aus dem Applikationsmenü.
BACKUPDIR
Setzen Sie das Backup-Dokument. Zusätzliche Parameter können verwendet werden, um ein Katalog mit einem bestimmten Namen zu erstellen.
Beispiel: Ein Backup-Dokument mit dem Datum in seinem Namen erstellen.
$VAR5=SOMETEXT
BACKUPDIR=\$YYYY-$MM-$DD_$VAR5\
BACKUPTOFILE
IMPORTFILE
Importieren Sie HEX-Code aus einem binären Datei in den Editor.
IMPORTFILE=\catalog\filename.bin
IMPORTHEX
Importieren Sie HEX-Code in den Editor.
Beispiel: Einführen eines 128-Byte-Code Segment in den Editor.
IMPORTHEX=030407100000000000000006670000000802001E4F454D2020202020202020202020202000000B4053465031302D535220202020202020204120202003520091001A000058473936535230313020202020202020303830393236202068F0031200001111A8DD05AA642FAA6F5A64DAF3285A9D000000000000000000F05E482F
Importieren Sie Code in den Editor, indem Sie Buffer-Varianten konzentrieren.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
IMPORTHEX=$VAR1$VAR2$VAR3
INCREMENT
Erhöhen Sie den Wert einer Variable, die eine hexadekimale Vertretung von Code enthält, so dass die Zahl am Ende der Textvertretung um ein erhöht wird.
Zum Beispiel die Textreprezentation der Variablen SN129YY00201 wird konvertiert zu SN129YY00202.
Wenn Zero die numerische Portion vorausgeht, versucht die Anwendung, die ursprüngliche Stringlänge zu bewahren, wenn die erhöhten Zahl eine zusätzliche Zahlen benötigt und die Wert nach links verwandelt. So ist der Wert SN129YY00999 wird konvertiert zu 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
Füllen Sie das Verkäufer-spezifische Bereich im Editor mit Zero.
COUNTER
Schrift iteration counter.
Stellen Sie diese Befehl am Anfang eines Skriptsdatei, das in einem Lauf läuft. Der aktuelle Iterationszahlenzahl ist über die $COUNTER Variable verfügbar.
// 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 ...
Vergleichen Sie die Werte. Verwenden Sie dieses Konstrukts, um A und B zu vergleichen und die Kommande nach THEN ausführen, wenn die angegebenen Bedingung wahr ist.
// 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
Wiederholen Sie das Script. Setzen Sie diese Befehl am Ende des Skriptsdatei, um die Anwendung zu sagen, den Verfahren erneut ausführen. Die UNLOOP-Kommand annulliert LOOP. Verwenden Sie eine Bedingung, um den Lauf zu verlassen und endlose Wiederholungen zu vermeiden.
Beispiel mit einer Bedingung.
COUNTER
...
R1A000007F
...
// Repeat the script until 10 iterations have completed
IF $COUNTER < 10 THEN LOOP
Wenn ein Script einen unendlichen Lauf eingibt, stoppt es mit der globalen Unterbrechungsbefehl in <Tools - Interrupt Processes>.
STRTOHEX
Umwandeln Sie den Text nach dem Betreiber in eine HEX-Stirn.
$VAR9=STRTOHEX QSFP28-SR4
MSGBOX $VAR9
HEXTOSTR
Konvertieren Sie die HEX-Stirn nach dem Betreiber in Text.
$VAR9=HEXTOSTR 5153465032382D535234202020202020
MSGBOX $VAR9
PADRIGHTHEX
Fügen Sie den hexadekimalen Wert in $VAR1 rechts mit dem Charakter, dessen Code YY ist, bis die Länge seiner Textvertretung XX erreicht.
Formate der Kommande:
PADRIGHTHEX XX YY $VAR1
XXeine Decimalnummer, die die Länge der Textvertretung des HEX-Stiegs angibt;YYdie HEX-Code des Zeichens, der zur Fassung der String auf die erforderliche Länge verwendet wird;$VAR1die Variable, die den HEX-Strahl enthält, umzuwandeln.
// 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
Diese Befehl ist nützlich, wenn Sie Text zu einer Variablen zugeordnen und es in eine HEX-Serie einer bestimmten Länge umwandeln.
PADLEFTHEX
Es funktioniert wie Padrighthex. Fügen Sie den hexadekimalen Wert in $VAR1 auf der linken Seite mit dem Charakter, dessen Code YY ist, bis die Länge seiner Textvertretung XX erreicht.
SAVECODEDIR
Setzen Sie den Weg, um eine Code-Datei automatisch ohne ein Dialogfeld zu speichern.
Beispiel: Setzen Sie den Code-Ausgangsprozess in einen Katalog, der nach dem Seriennummer im Code benannt wird:
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
Speichern Sie den Code auf eine Datei auf dem von SAVECODEDIR festgelegten Weg. Die Anwendung erzeugt den Dateinamen automatisch nach dem ausgewählten Modultyp und der Seite.
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
SIGNATURE
Führen Sie den Generator mit Vorgangsparameter aus.
Diese Funktion erfordert eine erweiterte Generator-Lizenz in der Anwendung, die nicht im Standardpaket enthalten ist.
Externe Feuervertreter
APIURL
Setzen Sie die URL, die verwendet wird, um den externen API-Händler zu nennen.
APIURL=http://localhost/example/api.php
APICALL
Rufen Sie den externen API-Händler an. Dies entspricht dem Klicken auf den API-Button im Hauptanwendungsfenster.
POST-Anfrageformat für Anrufe an APIURL
POST Fields: code=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000&module_type=1&table=A0&offset=00
codeCode: eine 256-Charakter-Reihe (HEX, Oberfläche)module_typeModultyp (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableTabellenadresse (HEX, obere Seite; zum Beispiel: A0, A2)offsetTabelle offset (HEX, obere Seite; zum Beispiel: 00, 80).
Der Server muss eine JSON-Serie zurückgeben:
{"status":1,"script":"R1A000007F\r\nW1A000007F{00;7F}\r\n","message":"","code":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","module_type":"1","table":"A0","offset":"00"}
Die Server-Reaktion muss die folgenden Parameter enthalten:
statusVerarbeitungssituation: 1 — das Skript importieren und ausführen; 0 — eine Nachricht anzeigen, ohne Code importieren;scriptScripttext nach dem Einfuhr von Code ausführen; Lassen Sie es leer, wenn kein Script angegeben ist;messagedie zurückgegebenen Nachricht, die angezeigt wird, wenn Status = 0;codezurückgegebenes Code: eine 256-Charakter-Stirn (HEX, Oberfläche);module_typeModultyp (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableTabellenadresse (HEX, obere Seite; zum Beispiel: A0, A2)offsetTabelle offset (HEX, obere Seite; zum Beispiel: 00, 80).
Arithmetische Operationen
Der Script-Prozessor unterstützt Addition, Subtraktion, Multiplikation und Division durch die MATH.
Formate der Kommande:
MATH Value1 %Operator Value2
Unterstützte Arithmetische Betreiber:
+- die Ergänzung-Subtraktion ist;*die Vervielfältigung;/die Division;
COUNTER
$VAR0=MATH 10 - $COUNTER
ECHO $VAR0
// Repeat the script while the condition is true
IF $VAR0 > 0 THEN LOOP
User Datei
Befehle, um mit einem Benutzerdatei zu arbeiten.
USERFILEPATH
Setzen Sie den Benutzer-Dateiweg.
USERFILEPATH=C:\Users\User\Desktop\user-file.txt
GETUSERFILESTRING
Lesen Sie die angegebenen Zeile aus der Benutzerdatei.
GETUSERFILESTRING 10
SAVETOUSERFILE
Speichern Sie Daten in die Benutzerdatei.
Beispiele :
// 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
Dieser Wert enthält die Anzahl der Zeilen im Benutzerdatei.
// 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