Guía do usuario da interface de liña de comandos ATEN

Interface de liña de comandos ATEN

Especificacións

• Produto: ATEN Control System
• Funcionalidade: xestiona remotamente os controladores ATEN e as caixas de expansión a través de SSH/Telnet

Instrucións de uso do produto

Establecemento dunha sesión SSH/Telnet

1. Descarga un cliente SSH/Telnet como PuTTY nun ordenador con acceso ao controlador ATEN ou ao Expansion Box.
2. Executar o cliente descargado.
3. Para a sesión SSH:
   • Nome de host/enderezo IP: introduza o enderezo IP ou o nome de host da caixa de expansión ou controlador de destino.
   • Tipo de conexión: SSH
   • Porto: 22
4. Para a sesión de telnet:
   • Nome de host / enderezo IP: introduza o controlador de destino ou
     enderezo IP ou nome de host da caixa de expansión.
   • Tipo de conexión: Outro > Telnet
   • Porto: 23
5. Fai clic en Abrir e sigue as instrucións en pantalla para iniciar sesión.

Comandos SSH/Telnet

Comando de axuda

• Uso: Mostra as instrucións para activar o modo CLI do controlador.
• Sintaxe: axuda
• Agradecer: Comando OK - Función executada; Comando incorrecto: non se executou
• ExampLe: axuda: mostra instrucións do modo CLI

Activar/desactivar a resposta de eco

• Uso: Activa ou desactiva a resposta automática ás mensaxes recibidas.
• Sintaxe: eco [control]
• Parámetro: control: on – activar; off - desactivar (o predeterminado é desactivado)
• Agradecer: Comando OK - Función executada; Comando incorrecto: non se executou
• ExampLe: who on: configura o controlador para que responda automaticamente ás mensaxes recibidas.

Configurando o intervalo de tempo de espera de Telnet ou o inicio de sesión

• Uso: Configure os axustes do modo CLI de Telnet.
• Sintaxe: telnet[intervalo de tempo de espera][control de inicio de sesión]
• Parámetro: tempo de espera: configuración do intervalo de tempo de espera da sesión Telnet; login: configuración da función de inicio de sesión de Telnet
• Agradecer: Comando OK - Función executada; Comando incorrecto: non se executou
• ExampLe: telnet timeout 0 : configure o intervalo de tempo de espera para que nunca se agote

Configurar a configuración do porto serie

• Uso: Controla e configura os axustes do porto serie.

Preguntas frecuentes (FAQ)

P: Que debo facer se non se pode establecer a sesión SSH/Telnet?
R: Se non se pode establecer a sesión, inicie sesión na consola de xestión do dispositivo para comprobar se é necesario cambiar a clave de acceso.

Acerca desta guía
Esta guía ofrece información sobre os comandos SSH e Telnet dispoñibles para xestionar remotamente os controladores ATEN e as caixas de expansión.

IMPORTANTE: A configuración feita a través da interface de liña de comandos sobrescribirase se hai un proxecto file posteriormente se carga a través de ATEN Configurator (GUI).

Establecemento dunha sesión SSH/Telnet

1. Nun ordenador que teña acceso ao controlador ATEN ou ao Expansion Box de destino, descargue un cliente SSH/Telnet, por exemplo, PuTTY.
   Nota: Para obter o instalador, busque "download putty" en a web navegador.
2. Executar o cliente descargado.
3. Para establecer unha sesión SSH, use a seguinte configuración.
   

   Campo	Configuración
   Nome de host / enderezo IP	Enderezo IP ou nome de host do controlador ou caixa de expansión de destino
   Tipo de conexión	SSH
   Porto	22

   Por exampLe:

4. Para establecer unha sesión telnet, use a seguinte configuración.
   

   Campo	Configuración
   Nome de host / enderezo IP	Enderezo IP ou nome de host do controlador de destino ou caixa de expansión
   Tipo de conexión	Outros > Telnet
   Porto	23

   Por exampLe:

5. Fai clic en Abrir e siga as instrucións en pantalla para introducir as credenciais de inicio de sesión. Establécese unha sesión. Por exampLe:

Nota: Se non se pode establecer a sesión, inicie sesión na consola de xestión do dispositivo para comprobar se é necesario cambiar a clave de acceso.

Comandos SSH/Telnet

Axuda

• Uso:
  Mostra a instrución para activar o modo CLI do controlador.
• Sintaxe:
  axuda↙
• Agradecer:
  Comando OK↙ : o comando é correcto e a función execútase.
  Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.
• ExampLe:
  axuda↙ : mostra as instrucións do modo CLI

Activar/desactivar a resposta de eco

• Uso:
  Activa ou desactiva o controlador para responder automaticamente ás mensaxes recibidas.
• Sintaxe:
  eco[control]↙
• Parámetro:
  control : on – activa esta función
  off: desactiva esta función (o predeterminado está desactivado)
• Agradecer:
  Comando OK↙ : o comando é correcto e a función execútase.
  Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.
• ExampLe:
  eho on↙ : configura o controlador para que responda automaticamente ás mensaxes recibidas.

Configurando o intervalo de tempo de espera de Telnet ou o inicio de sesión

• Uso:
  Configure os axustes do modo CLI de Telnet.
• Sintaxe:
  telnet[intervalo de tempo de espera][control de inicio de sesión]↙
• Palabra clave
  timeout : configuración do intervalo de tempo de espera da sesión Telnet
  login : configuración da función de inicio de sesión de Telnet
• Parámetro:
  intervalo: tempo de espera da sesión en minutos. (0 significa nunca tempo de espera) (o predeterminado é 5)
  control: activado: activa a función de inicio de sesión (o predeterminado está activado)
  off: desactiva a función de inicio de sesión
• Agradecer:
  Comando OK↙ : o comando é correcto e a función execútase.
  Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.
• ExampLe:
  telnet timeout 0↙ : configure o intervalo de tempo de espera para que nunca se agote
  telnet timeout 5↙ : configure o intervalo de tempo de espera en 5 minutos
  telnet login off↙ : desactiva a función de inicio de sesión

Configurar a configuración do porto serie

Uso:
Controla e configura os axustes do porto serie.

Sintaxe:
serie [p sequence] [tipo stype] [baudrate] [dbit databit] [parity sparity] [sbit stopbit] [fctrl flowctrl] [dtype datatype] [endchar chars ] [checksumtype checksumtype] [acktimeout duration ] [control "data" ] [axuda]↙d

Palabra clave:

• p: porto
• tipo: tipo de serie
• baudio: velocidade en baudios
• dbit: bit de datos
• parity : paridade en serie
• sbit: parar bit
• fctrl: control de fluxo
• dtype : tipo de datos
• acktimeout : a duración do tempo de espera (ms) úsase para esperar a resposta do control sendack.
• endchar : úsase un carácter final específico para identificar unha mensaxe completa.
• checksumtype : se é necesario fw para calcular automaticamente a suma de verificación do comando, asigne un tipo de suma de verificación
• axuda: mostrar instrucións

Parámetro:

• secuencia: porto, separado por coma para varios portos * (todos os portos)
• tipo: 232, 422, 485 (predeterminado 232)
• Velocidade de transmisión: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (predeterminado 9600)
• bit de datos: 7, 8 (predeterminado 8)
• sparity: ningún, par, impar (por defecto none)
• bit de parada: 1, 2 (predeterminado 1)
• flowctrl : none, hw (por defecto none)
• tipo de datos: ascii, hex (ascii predeterminado)
• tipo de suma de verificación: none, modbus (por defecto none)
• duración: tempo de espera específico (ms) (predeterminado 300)
• chars : finais de caracteres despois dunha mensaxe completa.
• control: ler: mostra a mensaxe recibida do porto serie específico
• escribir: enviar datos desde o porto serie. Use o símbolo " para os datos. Use o símbolo \x para enviar código hexadecimal
• sendack: envía datos desde o porto serie e mostra a mensaxe recibida

Recoñecebordo:
Comando OK↙ : o comando é correcto e a función execútase.
Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.

ExampLe:

• Axuda en serie ↙ : mostrar instrucións
• serial p01 ↙ : mostra a información de configuración do porto serie 1.
• serial p* ↙ : mostra a información de configuración de todos os portos serie.
• serie p01 tipo 232 baudios 115200 dbit 8 paridade ningunha sbit 1 fctrl ningunha ↙ : configurar porto1.
• serie p01,04,07 baudios 19200 ↙ : configure port1, 4, 7 a velocidade de baudios 19200.
• serie p02 baudios 19200 ↙ : configure o porto 2 en baudios 19200 e use a configuración predeterminada para outros parámetros.
• serial p02 dtype hex read ↙ : mostra a mensaxe recibida de port2 en formato HEX.
• serie p03 escriba “sw i01 o02\r\n” ↙ : envíe o texto ASCII 'sw i01 o02' desde o porto3.
• serial p03 sendack “sw i01 o02\x0D\x0A” ↙ : envía o texto ASCII 'sw i01 o02' desde o porto3 e amosa o feedback.

Configurar a configuración do porto de relé

Uso:
Controlar e configurar portos de relé.

Sintaxe:
relé [p secuencia] [tpulse duration] [control] [axuda] ↙

Palabra clave:

• p: porto
• tpulse : período pechado para o pulso
• axuda: mostrar instrucións

Parámetro:

• secuencia : porto, separado por coma para varios portos
• * (todos os portos)
• duración: período de tempo en milisegundos.
• control: abrir – apagar
• pechar - acender
• pulso: peche a canle de relé e despois ábrase
• alternar – alternar relé
• ler - mostrar o estado

Agradecer:
Comando OK↙ : o comando é correcto e a función execútase.
Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.

ExampLe:

• relé de axuda ↙ : mostrar instrucións
• relé p01 pechar ↙ : pechar a canle do porto1.
• relé p01 aberto ↙ : porto aberto 1 canle.
• relé p01,04,07 pechar ↙ : pechar o porto 1, 4, 7 canles de relé.
• relé p02 tpulse 500 pulso ↙ : pecha o porto 2 500 ms e despois ábrese.
• relé p02 ler ↙ : mostrar o estado do porto2.

Configuración do porto de E/S

Uso:
Controlar e configurar portos de E/S.

Sintaxe:
io [secuencia p] [tipo iotipo] [limiar lthresh] [limiar hthresh] [duración tpulse] [control] [axuda]↙

Palabra clave:

• p: porto
• lthresh : limiar baixo límite
• hthresh : limiar de límite alto
• tpulse : período no que a E/S permanece en alto nivel no modo de pulso
• axuda: mostrar instrucións
• NOTA: Se non se especifica un parámetro, aplicarase un valor introducido previamente.
• Parámetro:
• secuencia : porto, separado por coma para varios portos
• * (todos os portos)
• iotipo: seco, vdc, dout
• threshold : limiar de activación en voltage
• duración: período de tempo en milisegundos.
• control: aberto
• pechar
• pulso
• alternar
• ler

Agradecer:
Comando OK↙ : o comando é correcto e a función execútase.
Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.

ExampLe:

• io axuda ↙ : mostrar instrucións
• io p01↙ : mostra a información de configuración do porto de E/S 1.
• io p*↙ : mostra a información de configuración de todos os portos de E/S.
• io p01 tipo seco ↙ : configure o porto 1 para o modo de contacto seco.
• io p01 tipo dout ↙ : configurar o porto 1 para o modo de saída dixital.
• io p01 tipo vdc lthresh 1 hthresh 3 ↙ : configure o porto 1 para o modo vdc con axustes de limiar.
• io p01 aberto ↙ : abre a canle do porto1.
• io p01 pechar ↙ : pechar a canle do porto1.
• io p01,04,07 pechar ↙ : pechar canles port1,4,7.
• io p02 tpulse 500 pulso ↙ : pecha a canle do porto 2 500 ms e despois ábrese.
• io p02 ler ↙ : mostrar o estado do porto2.

Configurar axustes IR

Uso:
Controla e configura os portos IR.

Sintaxe:
ir [p secuencia] [tipo irtype] | [baudrate] [dbit databit] [parity sparity] [sbit stopbit] [dtype datatype] [checksumtype checksumtype] [control "datos"] [axuda]↙

Palabra clave:

• p: porto
• type : tipo de saída para un porto de saída específico
• baudios** : taxa de baudios
• dbit** : bit de datos
• paridade** : paridade en serie
• sbit**: parar pouco
• dtype** : tipo de datos
• checksumtype** : o controlador/caixa de extensión calcula automaticamente o tipo de suma de verificación especificado
• axuda: mostrar instrucións

NOTA:
* : esta palabra clave é para o tipo IR
**: Estas palabras clave son para o tipo 232

Se non se especifica un parámetro, aplicarase un valor introducido previamente.

Parámetro:

• secuencia: porto, separado por coma para varios portos * (todos os portos)
• irtype: ir, 232 (ir predeterminado)
• Velocidade de transmisión: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (predeterminado 9600)
• bit de datos: 7, 8 (predeterminado 8)
• sparity: none, even, odd (ningún por defecto)
• bit de parada: 1, 2 (predeterminado 1)
• tipo de datos: ascii, hex (ascii predeterminado)
• tipo de suma de verificación: none, modbus (por defecto none)
• control: escribir – enviar código IR ou datos RS232

Agradecer:
Comando OK↙ : o comando é correcto e a función execútase.
Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.

Example:

• ir axuda ↙ : mostrar instrucións
• ir p01 ↙ : mostra a información de configuración do porto IR 1.
• ir p* ↙ : mostra a información de configuración de todos os portos IR.
• ir p01,04,07 tipo 232 ↙: configurar port1,4,7 para tipo RS232
• ir p01 tipo 232 baudios 115200 dbit 8 paridade ningunha sbit 1 tipo de suma de verificación modbus↙: configure o porto 1 ao tipo RS232 e a configuración
• ir p02 escribir dtype hexadecimal “0a0b0c” ↙: enviar datos de formato hexadecimal 0a0b0c desde o porto2
• ir p02 baudios 19200 ↙ : configure port2 en baudios 19200 e use a configuración predeterminada para outros parámetros.
• ir p02 escribe “sw i01 o02\r\n” ↙ : envía o texto ASCII 'sw i01 o02' desde o porto2.
• ir p02 escribe “sw i01 o02\x0D\x0A”↙: envía o texto ASCII 'sw i01 o02' desde o porto2.

Reinicie

Uso:
Reinicie o controlador.

Sintaxe:
reiniciar↙

Agradecer:
Comando OK↙ : o comando é correcto e a función execútase.
Comando incorrecto↙ : o comando e/ou os parámetros son incorrectos e non se executan.

ExampLe:
reiniciar↙ : reiniciar o dispositivo