Escrever com escritos
Os scripts são um mecanismo de aplicação especial para o envio e processamento de instruções seqüencialmente. Eles podem configurar configurações de placa de codificação, ler e escrever memória de transmissor, e executar outras operações.
Use scripts quando um transceitor requer um procedimento de programação que difere do padrão MSA e precisa de uma sequência de instruções especiais para salvar mudanças de memória com sucesso. Os scripts também podem automatizar a programação repetida de diferentes áreas de memória de transmissores com a participação mínima do operador.
Como posso usar um script?
- Abra o menu Controle - Escrever usando um script - Selecione um arquivo de script Para especificar o caminho do arquivo de script;
- Certifique-se de que o editor contém o código correto se o script usa os dados do editor durante a execução;
- Clique no botão de escrita da memória do receptor para executar o script.
Ao executar um script, o aplicativo ignora as configurações de área de memória atualmente selecionadas. As áreas de leitura e escrita devem ser especificadas nos comandos do script.
Por favor, note que o software não verifica se a escrita foi bem sucedida depois de um script terminar.
Como posso esclarecer o script escolhido?
Vá ao menu Controle - Escreva usando um script - Reset script Desligar o script selecionado e retornar à escrita padrão.
Como faço para criar um script?
A sintaxe de comando de script é baseada no protocolo de comando SFPTotal.
O exemplo:
// 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
Crie um arquivo de texto e entre uma instrução por linha. Salve o arquivo de script para usar este procedimento de programação na aplicação.
Comando de script adicional
Os seguintes comandos adicionais são processados pela aplicação.
PAUSE
Execução do script de pausa. A pausa padrão é 100 ms.
Um parâmetro opcional define a duração da pausa em milisecundos.
PAUSE
Delay 100ms
PAUSE=2000
Delay 2000ms
SETCHECKSUM
Recalculando o checksum.
SETVAL
Configurar a célula de editor em offset XX para valorizar YY. Determine os valores de parâmetros no formato HEX da parte superior.
O parâmetro offset aceita valores de 00 a 7F.
SETVAL 7F 03
{00;7F}
Substituição do macro {XX;YY} É usado dentro de outros comandos para inserir um segmento de código do editor. Durante a execução do script, o macro é automaticamente substituído pelos dados do editor atuais, começando com o byte XX e expondo os bytes YY.
Observe que um parâmetro YY vale 00 em HEX significa que 1 byte é substituído, enquanto um valor de 7F em HEX significa que os bytes 128 são substituídos. Defina YY para a comprimento do segmento em bytes minus um, expressado em hexadecimal.
Exemplo: escrever um segmento de 128 bytes para a página A2h no offset 80h.
w2A200807F{00;7F}
Exemplo: escrever um segmento de limite DDM de 96 bytes para a página A2h no offset 00h, seguido por uma leitura.
W2A200005F{00;5F}
Exemplo: atribuindo uma variável o segmento de código de 16 bytes no offset 0x44 que contém o número de série.
$VAR2={44;0F}
$VAR1
Variação de buffer $VAR1. Use variáveis de buffer para armazenar segmentos de código do editor e inserir o seu conteúdo durante a execução do script.
O aplicativo suporta 10 variáveis de buffer, $VAR0 – $VAR9.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
$VAR4=002AFE
$VAR5=4F
$YYYY
Insira o ano atual no comando.
$MM
Insira o mês atual no comando.
$DD
Insira o dia atual no comando.
BACKUPTOFILE
Iniciar uma backup para o tipo de módulo selecionado nas configurações da aplicação. O aplicativo lê as páginas disponíveis seqüentemente e salva os dados para um arquivo. Este comando é equivalente a invocar a função do menu de aplicação.
BACKUPDIR
Configura o diretório de backup. Parâmetros adicionais podem ser usados para criar um directorio com um nome específico.
Exemplo: Crie um directorio de backup com a data em seu nome.
$VAR5=SOMETEXT
BACKUPDIR=\$YYYY-$MM-$DD_$VAR5\
BACKUPTOFILE
IMPORTFILE
Importar código HEX de um arquivo binário para o editor.
IMPORTFILE=\catalog\filename.bin
IMPORTHEX
Importar o código HEX para o editor.
Exemplo: importar um segmento de código de 128 bytes para o editor.
IMPORTHEX=030407100000000000000006670000000802001E4F454D2020202020202020202020202000000B4053465031302D535220202020202020204120202003520091001A000058473936535230313020202020202020303830393236202068F0031200001111A8DD05AA642FAA6F5A64DAF3285A9D000000000000000000F05E482F
Importar código para o editor, concatenando variáveis de buffer.
$VAR1={00;43}
$VAR2={44;0F}
$VAR3={54;2B}
IMPORTHEX=$VAR1$VAR2$VAR3
INCREMENT
Aumentar o valor de uma variável que contém uma representação hexadecimal do código para que o número no final da sua representação de texto aumenta por um.
Por exemplo, a representação de texto da variável SN129YY00201 É convertido em SN129YY00202.
Se o zero precede a porção numérica, a aplicação tenta preservar a largura da corrente original quando o número incrementado precisa de um dígito adicional, mudando o valor para a esquerda. Assim, o valor SN129YY00999 É convertido em 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
Preencha a área específica do vendedor no editor com zeros.
COUNTER
Contador de iteração.
Coloque este comando no início de um arquivo de script que corre em um loop. O número de iteração atual está disponível através da variável $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 ...
Compare os valores. Use este construto para comparar A e B e execute o comando seguido por isso se a condição especificada for verdadeira.
// 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 o script. Coloque este comando no final do arquivo de script para dizer ao aplicativo que execute novamente o procedimento. O comando UNLOOP cancelou o LOOP. Use uma condição para sair do loop e evitar repetições infinitas.
Exemplo com uma condição.
COUNTER
...
R1A000007F
...
// Repeat the script until 10 iterations have completed
IF $COUNTER < 10 THEN LOOP
Se um script entra em um loop infinito, pare usando o comando global de interrupção em <Tools - Interrupt Processes>.
STRTOHEX
Converter o texto seguido do operador para uma linha HEX.
$VAR9=STRTOHEX QSFP28-SR4
MSGBOX $VAR9
HEXTOSTR
Converter a linha HEX seguindo o operador para texto.
$VAR9=HEXTOSTR 5153465032382D535234202020202020
MSGBOX $VAR9
PADRIGHTHEX
Adicione o valor hexadecimal em $VAR1 à direita com o caráter cujo código é YY até que a duração da sua representação de texto alcance XX.
Formato de Comando:
PADRIGHTHEX XX YY $VAR1
XXum número decimal que especifique o comprimento da representação de texto da linha HEX;YYo código HEX do caráter usado para apagar a corda à duração requerida;$VAR1A variável que contém a corrente HEX para converter.
// 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 é útil ao atribuir texto a uma variável e convertê-lo em uma corrente HEX de um comprimento específico.
PADLEFTHEX
É como o PADRIGHTHEX. Adicione o valor hexadecimal em $VAR1 à esquerda com o caráter cujo código é YY até que o comprimento da sua representação de texto alcance XX.
SAVECODEDIR
Configura o caminho para salvar um arquivo de código automaticamente sem uma caixa de diálogo.
Exemplo: definir o caminho de saída do código para um diretório chamado após o número de série no código:
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
Salve o código para um arquivo no caminho definido pela SAVECODEDIR. O aplicativo gera o nome do arquivo automaticamente de acordo com o tipo e página do módulo selecionado.
$VAR4=HEXTOSTR {44;0F}
SAVECODEDIR=C:\Users\DemoUser\Desktop\Codes\$VAR4
SAVEFILE
SIGNATURE
Execute o gerador com os parâmetros predefinidos.
Esta funcionalidade requer uma licença de gerador estendida na aplicação, que não está incluída no pacote padrão.
Fogo de fogo externo
APIURL
Configura o URL usado para chamar o operador de API externo.
APIURL=http://localhost/example/api.php
APICALL
Chame o operador de API externo. Isto é equivalente ao clicar no botão API na janela principal da aplicação.
Formato de solicitação POST para chamadas para APIURL
POST Fields: code=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000&module_type=1&table=A0&offset=00
codeCódigo: uma corda de 256 caracteres (HEX, superior);module_typetipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableendereço de tabela (HEX, superior; por exemplo: A0, A2);offsetO despeso da tabela (HEX, superior; por exemplo: 00, 80).
O servidor deve devolver uma linha JSON:
{"status":1,"script":"R1A000007F\r\nW1A000007F{00;7F}\r\n","message":"","code":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","module_type":"1","table":"A0","offset":"00"}
A resposta do servidor deve conter os seguintes parâmetros:
statusestado de processamento: 1 — importar e executar o script; 0 — exibir uma mensagem sem importar código;scripttexto de script para executar após a importação do código; deixe vazio se não for especificado nenhum script;messagemensagem devolvida, exibida quando o status = 0;codeCódigo devolvido: uma corda de 256 caracteres (HEX, superior);module_typetipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);tableendereço de tabela (HEX, superior; por exemplo: A0, A2);offsetO despeso da tabela (HEX, superior; por exemplo: 00, 80).
Operações aritméticas
O processador de script suporta adição, subtracção, multiplicação e divisão através do MATH.
Formato de Comando:
MATH Value1 %Operator Value2
Operadores aritméticos suportados:
+- A adição-- Subtração de*- a multiplicação/Divisão →
COUNTER
$VAR0=MATH 10 - $COUNTER
ECHO $VAR0
// Repeat the script while the condition is true
IF $VAR0 > 0 THEN LOOP
arquivo do usuário
Comando para trabalhar com um arquivo de usuário.
USERFILEPATH
Defina o caminho do arquivo do usuário.
USERFILEPATH=C:\Users\User\Desktop\user-file.txt
GETUSERFILESTRING
Leia a linha especificada do arquivo do usuário.
GETUSERFILESTRING 10
SAVETOUSERFILE
Salve dados para o arquivo do usuário.
O exemplo:
// 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 contém o número de linhas no arquivo do usuário.
// 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