Skip zum Artikel

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?

  1. Öffnen Sie das Menü Steuerung - Schreiben mit einem Script - Wählen Sie eine Script-Datei die Script-Datei-Path zu bestimmen;
  2. Stellen Sie sicher, dass der Editor den richtigen Code enthält, wenn das Script während der Ausführung die Editor-Daten verwendet;
  3. 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

  • XX eine Decimalnummer, die die Länge der Textvertretung des HEX-Stiegs angibt;
  • YY die HEX-Code des Zeichens, der zur Fassung der String auf die erforderliche Länge verwendet wird;
  • $VAR1 die 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
  • code Code: eine 256-Charakter-Reihe (HEX, Oberfläche)
  • module_type Modultyp (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table Tabellenadresse (HEX, obere Seite; zum Beispiel: A0, A2)
  • offset Tabelle 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:

  • status Verarbeitungssituation: 1 — das Skript importieren und ausführen; 0 — eine Nachricht anzeigen, ohne Code importieren;
  • script Scripttext nach dem Einfuhr von Code ausführen; Lassen Sie es leer, wenn kein Script angegeben ist;
  • message die zurückgegebenen Nachricht, die angezeigt wird, wenn Status = 0;
  • code zurückgegebenes Code: eine 256-Charakter-Stirn (HEX, Oberfläche);
  • module_type Modultyp (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table Tabellenadresse (HEX, obere Seite; zum Beispiel: A0, A2)
  • offset Tabelle 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
Aktualisiert: