Escape para o artigo

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?

  1. Abra o menu Controle - Escrever usando um script - Selecione um arquivo de script Para especificar o caminho do arquivo de script;
  2. Certifique-se de que o editor contém o código correto se o script usa os dados do editor durante a execução;
  3. 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

  • XX um número decimal que especifique o comprimento da representação de texto da linha HEX;
  • YY o código HEX do caráter usado para apagar a corda à duração requerida;
  • $VAR1 A 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
  • code Código: uma corda de 256 caracteres (HEX, superior);
  • module_type tipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table endereço de tabela (HEX, superior; por exemplo: A0, A2);
  • offset O 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:

  • status estado de processamento: 1 — importar e executar o script; 0 — exibir uma mensagem sem importar código;
  • script texto de script para executar após a importação do código; deixe vazio se não for especificado nenhum script;
  • message mensagem devolvida, exibida quando o status = 0;
  • code Código devolvido: uma corda de 256 caracteres (HEX, superior);
  • module_type tipo de módulo (0 — GBIC, 1 — SFP, 2 — SFP-DD, 3 — XFP, 4 — QSFP, 5 — QSFP-DD, 6 — OSFP);
  • table endereço de tabela (HEX, superior; por exemplo: A0, A2);
  • offset O 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
Atualização: