Guida utente dell'interfaccia della riga di comando ATEN

Interfaccia della riga di comando ATEN

Specifiche

• Prodotto: Sistema di controllo ATEN
• Funzionalità: Gestire da remoto i controller ATEN e le scatole di espansione tramite SSH/Telnet

Istruzioni per l'uso del prodotto

Stabilire una sessione SSH/Telnet

1. Scaricare un client SSH/Telnet come PuTTY su un computer con accesso al controller ATEN o all'Expansion Box.
2. Eseguire il client scaricato.
3. Per la sessione SSH:
   • Nome host/indirizzo IP: immettere l'indirizzo IP o il nome host del controller di destinazione o del box di espansione.
   • Tipo di connessione: SSH
   • Porto: 22
4. Per la sessione telnet:
   • Nome host/indirizzo IP: immettere il controller di destinazione o
     indirizzo IP o nome host del box di espansione.
   • Tipo di connessione: Altro > Telnet
   • Porto: 23
5. Fare clic su Apri e seguire le istruzioni sullo schermo per accedere.

Comandi SSH/Telnet

Comando di aiuto

• Utilizzo: Visualizza le istruzioni per abilitare la modalità CLI del controller.
• Sintassi: aiuto
• Riconoscere: Comando OK – Funzione eseguita; Comando non corretto – Non eseguito
• Exampon: aiuto: visualizza le istruzioni della modalità CLI

Abilitazione/disabilitazione della risposta Echo

• Utilizzo: Abilita o disabilita la risposta automatica ai messaggi ricevuti.
• Sintassi: eco[controllo]
• Parametro: controllo: on – abilita; off – disabilita (il valore predefinito è off)
• Riconoscere: Comando OK – Funzione eseguita; Comando non corretto – Non eseguito
• Exampon: who on: imposta il controller in modo che risponda automaticamente ai messaggi ricevuti.

Configurazione dell'intervallo di timeout Telnet o dell'accesso

• Utilizzo: Configura le impostazioni della modalità CLI di Telnet.
• Sintassi: telnet[intervallo di timeout][controllo di accesso]
• Parametro: timeout: impostazione dell'intervallo di timeout della sessione Telnet; login: impostazione della funzione di accesso Telnet
• Riconoscere: Comando OK – Funzione eseguita; Comando non corretto – Non eseguito
• Exampon: telnet timeout 0: configura l'intervallo di timeout in modo che non si verifichi mai alcun timeout

Configurazione delle impostazioni della porta seriale

• Utilizzo: Controllare e configurare le impostazioni della porta seriale.

Domande frequenti (FAQ)

D: Cosa devo fare se non è possibile stabilire la sessione SSH/Telnet?
R: Se non è possibile stabilire la sessione, accedere alla console di gestione dei dispositivi per verificare se è necessario modificare la chiave di accesso.

Informazioni su questa guida
Questa guida fornisce informazioni sui comandi SSH e Telnet disponibili per gestire in remoto i controller e i box di espansione ATEN.

IMPORTANTE: La configurazione effettuata tramite l'interfaccia della riga di comando verrà sovrascritta se un progetto file viene caricato successivamente tramite ATEN Configurator (GUI).

Stabilire una sessione SSH/Telnet

1. Su un computer che ha accesso al controller ATEN di destinazione o all'Expansion Box, scaricare un client SSH/Telnet, ad esempio PuTTY.
   Nota: Per ottenere il programma di installazione, cerca "download putty" in un web browser.
2. Eseguire il client scaricato.
3. Per stabilire una sessione SSH, utilizzare le seguenti impostazioni.
   

   Campo	Collocamento
   Nome host/Indirizzo IP	Indirizzo IP o nome host del controller di destinazione o della casella di espansione
   Tipo di connessione	SSH
   Porta	22

   Per esempioampon:

4. Per stabilire una sessione telnet, utilizzare le seguenti impostazioni.
   

   Campo	Collocamento
   Nome host/Indirizzo IP	Indirizzo IP o nome host del controller di destinazione o scatola di espansione
   Tipo di connessione	Altro > Telnet
   Porta	23

   Per esempioampon:

5. Fai clic su Apri e segui le istruzioni sullo schermo per immettere le credenziali di accesso. Viene stabilita una sessione. Ad esempioampon:

Nota: Se non è possibile stabilire la sessione, accedere alla console di gestione dei dispositivi per verificare se è necessario modificare la chiave di accesso.

Comandi SSH/Telnet

Aiuto

• Utilizzo:
  Visualizza le istruzioni per abilitare la modalità CLI del controller.
• Sintassi:
  aiuto↙
• Riconoscere:
  Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
  Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.
• Exampon:
  help↙ : visualizza le istruzioni della modalità CLI

Abilitazione/disabilitazione della risposta Echo

• Utilizzo:
  Abilita o disabilita il controller per rispondere automaticamente ai messaggi ricevuti.
• Sintassi:
  eco[controllo]↙
• Parametro:
  controllo: on – abilita questa funzione
  off – disabilita questa funzione (l'impostazione predefinita è off)
• Riconoscere:
  Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
  Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.
• Exampon:
  eho on↙ : imposta il controller in modo che risponda automaticamente ai messaggi ricevuti.

Configurazione dell'intervallo di timeout Telnet o dell'accesso

• Utilizzo:
  Configura le impostazioni della modalità CLI di Telnet.
• Sintassi:
  telnet[intervallo di timeout][controllo accesso]↙
• Parola chiave
  timeout: impostazione dell'intervallo di timeout della sessione Telnet
  login : Impostazione della funzione di accesso Telnet
• Parametro:
  intervallo : timeout della sessione in minuti. (0 significa mai timeout) (il valore predefinito è 5)
  controllo: on – abilita la funzione di accesso (l'impostazione predefinita è on)
  off – disabilita la funzione di login
• Riconoscere:
  Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
  Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.
• Exampon:
  telnet timeout 0↙ : configura l'intervallo di timeout in modo che non si verifichi mai alcun timeout
  telnet timeout 5↙ : configura l'intervallo di timeout a 5 minuti
  telnet login off↙ : disabilita la funzione di login

Configurazione delle impostazioni della porta seriale

Utilizzo:
Controllare e configurare le impostazioni della porta seriale.

Sintassi:
seriale [sequenza p] [tipo stype] [baud baudrate] [dbit databit] [parità sparilità] [sbit stopbit] [fctrl flowctrl] [dtype datatype] [endchar caratteri ] [checksumtype checksumtype] [acktimeout durata ] [controllo “dati”] [aiuto]↙d

Parola chiave:

• p : porto
• tipo: tipo seriale
• baud : velocità di trasmissione
• dbit : bit di dati
• parità: parità seriale
• sbit : bit di arresto
• fctrl : controllo del flusso
• dtype : tipo di dati
• acktimeout : la durata del timeout (ms) viene utilizzata per attendere il feedback dal controllo sendack.
• endchar : il carattere di fine specifico viene utilizzato per identificare un messaggio completo.
• checksumtype : se necessario fw per calcolare automaticamente il checksum del comando, assegnare un tipo di checksum
• aiuto: mostra le istruzioni

Parametro:

• sequenza: porta, separata da virgola per più porte * (tutte le porte)
• tipo: 232, 422, 485 (predefinito 232)
• baudrate: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (predefinito 9600)
• bit di dati: 7, 8 (predefinito 8)
• sparity : nessuno, pari, dispari (predefinito nessuno)
• bit di stop: 1, 2 (predefinito 1)
• flowctrl : nessuno, hw (predefinito nessuno)
• tipo di dati: ascii, hex (ascii predefinito)
• tipo di checksum: nessuno, modbus (predefinito nessuno)
• durata : timeout specifico (ms) (predefinito 300)
• chars : caratteri finali che seguono un messaggio completo.
• control : read – visualizza il messaggio ricevuto della specifica porta seriale
• write – invia dati dalla porta seriale. Usa il simbolo “ copre i dati. Usa il simbolo \x per inviare codice esadecimale
• sendack – invia i dati dalla porta seriale e visualizza il messaggio ricevuto

Riconoscimentobordo:
Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.

Exampon:

• Guida seriale ↙ : mostra le istruzioni
• seriale p01 ↙ : visualizza le informazioni di impostazione della porta seriale1.
• serial p* ↙ : visualizza le informazioni di impostazione di tutte le porte seriali.
• seriale p01 tipo 232 baud 115200 dbit 8 parità nessuna sbit 1 fctrl nessuna ↙ : configura porta1.
• seriale p01,04,07 baud 19200 ↙ : configurare la porta 1, 4, 7 su baud rate 19200.
• seriale p02 baud 19200 ↙ : configura la porta 2 su baud 19200 e usa le impostazioni predefinite per altri parametri.
• seriale p02 dtype hex read ↙ : visualizza il messaggio ricevuto della porta2 in formato HEX.
• seriale p03 write “sw i01 o02\r\n” ↙ : invia il testo ASCII 'sw i01 o02' dalla porta3.
• seriale p03 sendack “sw i01 o02\x0D\x0A” ↙ : invia il testo ASCII 'sw i01 o02' dalla porta3 e visualizza il feedback.

Configurazione delle impostazioni della porta relay

Utilizzo:
Controlla e configura le porte relè.

Sintassi:
relè [p sequenza] [tdurata impulso] [controllo] [aiuto] ↙

Parola chiave:

• p : porto
• tpulse : periodo di chiusura per l'impulso
• aiuto: mostra le istruzioni

Parametro:

• sequenza: porta, separata da virgola per più porte
• * (tutte le porte)
• durata : periodo di tempo in millisecondi.
• comando : aperto – spento
• chiudi – accendi
• impulso: chiude il canale del relè, quindi apre
• toggle - commutazione del relè
• leggi – visualizza lo stato

Riconoscere:
Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.

Exampon:

• aiuto relè ↙ : mostra le istruzioni
• relè p01 chiude ↙ : chiude il canale port1.
• relè p01 aperto ↙ : canale porta1 aperta.
• relè p01,04,07 chiudi ↙ : chiude le porte 1, 4, 7 canali di ritrasmissione.
• relè p02 tpulse 500 impulso ↙ : chiude la porta 2 500 ms quindi apre.
• relè p02 read ↙ : visualizza lo stato della porta2.

Configurazione delle impostazioni della porta I/O

Utilizzo:
Controlla e configura le porte I/O.

Sintassi:
io [p sequenza] [tipo iotipo] [lsoglia soglia] [hsoglia soglia] [tdurata impulso] [controllo] [aiuto]↙

Parola chiave:

• p : porto
• lthresh : soglia di limite basso
• hthresh : soglia limite alta
• tpulse : periodo in cui l'I/O rimane a livello alto in modalità impulso
• aiuto: mostra le istruzioni
• NOTA: se non viene specificato un parametro, verrà applicato un valore immesso in precedenza.
• Parametro:
• sequenza: porta, separata da virgola per più porte
• * (tutte le porte)
• iotipo : secco, vdc, dout
• soglia : soglia di attivazione nel voltage
• durata : periodo di tempo in millisecondi.
• controllo: aperto
• vicino
• impulso
• commutare
• Leggere

Riconoscere:
Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.

Exampon:

• io aiuto ↙ : mostra le istruzioni
• io p01↙ : visualizza le informazioni di impostazione della porta I/O 1.
• io p*↙ : visualizza le informazioni sull'impostazione di tutte le porte I/O.
• io p01 type dry ↙ : configura la porta 1 in modalità contatto pulito.
• io p01 type dout ↙ : configura la porta 1 in modalità uscita digitale.
• io p01 type vdc lthresh 1 hthresh 3 ↙ : configura la porta 1 in modalità vdc con le impostazioni di soglia.
• io p01 open ↙ : apre il canale port1.
• io p01 close ↙ : chiude il canale port1.
• io p01,04,07 close ↙ : chiude i canali port1,4,7.
• io p02 tpulse 500 impulso ↙ : chiude il canale port2 per 500 ms, quindi apre.
• io p02 read ↙ : visualizza lo stato della porta2.

Configurazione delle impostazioni IR

Utilizzo:
Controlla e configura le porte IR.

Sintassi:
ir [p sequenza] [tipo irtype] | [baud baudrate] [dbit databit] [parity sparity] [sbit stopbit] [dtype datatype] [checksumtype checksumtype] [controllo “data”] [aiuto]↙

Parola chiave:

• p : porto
• tipo: tipo di uscita per una porta di uscita specifica
• baud** : velocità di trasmissione
• dbit** : bit di dati
• parità** : parità seriale
• sbit** : bit di stop
• dtype** : tipo di dati
• checksumtype**: la casella controller/estensione calcola automaticamente il tipo di checksum specificato
• aiuto: mostra le istruzioni

NOTA:
* : questa parola chiave è per il tipo IR
** : queste parole chiave sono per il tipo 232

Se non viene specificato un parametro, verrà applicato un valore immesso in precedenza.

Parametro:

• sequenza: porta, separata da virgola per più porte * (tutte le porte)
• tipo di ir: ir, 232 (ir di default)
• baudrate: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (predefinito 9600)
• bit di dati: 7, 8 (predefinito 8)
• sparity : nessuno, pari, dispari (predefinito nessuno)
• bit di stop: 1, 2 (predefinito 1)
• tipo di dati: ascii, hex (ascii predefinito)
• tipo di checksum: nessuno, modbus (predefinito nessuno)
• controllo: scrittura – invia codice IR o dati RS232

Riconoscere:
Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.

Example:

• ir help ↙ : mostra le istruzioni
• ir p01 ↙ : visualizza le informazioni di impostazione della porta IR1.
• ir p* ↙ : visualizza le informazioni di impostazione di tutte le porte IR.
• ir p01,04,07 tipo 232 ↙ : configurare la porta 1,4,7 sul tipo RS232
• ir p01 tipo 232 baud 115200 dbit 8 parità nessuna sbit 1 checksum tipo modbus↙ : configura la porta 1 su tipo RS232 e le impostazioni
• ir p02 write dtype hex “0a0b0c” ↙ : invia dati in formato esadecimale 0a0b0c dalla porta 2
• ir p02 baud 19200 ↙ : configura la porta2 su baud 19200 e usa le impostazioni predefinite per altri parametri.
• ir p02 write “sw i01 o02\r\n” ↙ : invia il testo ASCII 'sw i01 o02' dalla porta2.
• ir p02 write “sw i01 o02\x0D\x0A”↙ : invia il testo ASCII 'sw i01 o02' dalla porta2.

Riavviare

Utilizzo:
Riavvia il controller.

Sintassi:
riavvia↙

Riconoscere:
Comando OK↙ : Il comando è corretto e la funzione viene eseguita.
Comando errato↙ : Comando e/o parametri non corretti e non eseguiti.

Exampon:
riavvio↙ : riavvia il dispositivo