Interface de ligne de commande ATEN

Caractéristiques

• Produit : Système de contrôle ATEN
• Fonctionnalité : Gérez à distance les contrôleurs et boîtiers d'extension ATEN via SSH/Telnet

Instructions d'utilisation du produit

Etablissement d'une session SSH/Telnet

1. Téléchargez un client SSH/Telnet comme PuTTY sur un ordinateur avec accès au contrôleur ATEN ou au boîtier d'extension.
2. Exécutez le client téléchargé.
3. Pour la session SSH :
   • Nom d'hôte / Adresse IP : saisissez l'adresse IP ou le nom d'hôte du contrôleur cible ou du boîtier d'extension.
   • Type de connexion : SSH
   • Port: 22
4. Pour la session Telnet :
   • Nom d'hôte / Adresse IP : saisissez le contrôleur cible ou
     adresse IP ou nom d'hôte du boîtier d'extension.
   • Type de connexion : Autre > Telnet
   • Port: 23
5. Cliquez sur Ouvrir et suivez les instructions à l’écran pour vous connecter.

Commandes SSH/Telnet

Commande d'aide

• Usage: Afficher les instructions pour activer le mode CLI du contrôleur.
• Syntaxe: aide
• Reconnaître: Commande OK – Fonction exécutée ; Commande incorrecte – Non exécutée
• Example: aide : afficher les instructions du mode CLI

Activation/désactivation de la réponse par écho

• Usage: Activer ou désactiver la réponse automatique aux messages reçus.
• Syntaxe: écho[contrôle]
• Paramètre: contrôle : on – activer ; off – désactiver (la valeur par défaut est off)
• Reconnaître: Commande OK – Fonction exécutée ; Commande incorrecte – Non exécutée
• Example: qui sur : configurer le contrôleur pour répondre automatiquement aux messages reçus.

Configuration de l'intervalle de temporisation Telnet ou de la connexion

• Usage: Configurez les paramètres du mode CLI Telnet.
• Syntaxe: telnet[intervalle de temporisation][contrôle de connexion]
• Paramètre: timeout : paramètre d'intervalle de délai d'expiration de session Telnet ; login : paramètre de fonction de connexion Telnet
• Reconnaître: Commande OK – Fonction exécutée ; Commande incorrecte – Non exécutée
• Example: telnet timeout 0 : configurez l'intervalle de délai d'expiration pour ne jamais dépasser le délai d'expiration

Configuration des paramètres du port série

• Usage: Contrôlez et configurez les paramètres du port série.

Questions fréquemment posées (FAQ)

Q : Que dois-je faire si la session SSH/Telnet ne peut pas être établie ?
R : Si la session ne peut pas être établie, connectez-vous à la console de gestion des appareils pour vérifier si la clé d’accès doit être modifiée.

À propos de ce guide
Ce guide fournit des informations sur les commandes SSH et Telnet disponibles pour gérer à distance les contrôleurs et les boîtiers d'extension ATEN.

IMPORTANT: La configuration effectuée via l'interface de ligne de commande sera écrasée si un projet file est téléchargé via ATEN Configurator (GUI) par la suite.

Etablissement d'une session SSH/Telnet

1. Sur un ordinateur ayant accès au contrôleur ATEN cible ou au boîtier d'extension, téléchargez un client SSH/Telnet, par exemple PuTTY.
   Note: Pour obtenir le programme d'installation, recherchez « télécharger putty » dans un web navigateur.
2. Exécutez le client téléchargé.
3. Pour établir une session SSH, utilisez les paramètres suivants.
   

   Champ	Paramètre
   Nom d'hôte / Adresse IP	Adresse IP ou nom d'hôte du contrôleur cible ou du boîtier d'extension
   Type de connexion	SSH
   Port	22

   Par exempleample:

4. Pour établir une session Telnet, utilisez les paramètres suivants.
   

   Champ	Paramètre
   Nom d'hôte / Adresse IP	Adresse IP ou nom d'hôte du contrôleur cible ou boîte d'extension
   Type de connexion	Autre > Telnet
   Port	23

   Par exempleample:

5. Cliquez sur Ouvrir et suivez les instructions à l'écran pour saisir les informations de connexion. Une session est établie. Par exempleample:

Note: Si la session ne peut pas être établie, connectez-vous à la console de gestion des appareils pour vérifier si la clé d'accès doit être modifiée.

Commandes SSH/Telnet

Aide

• Usage:
  Affichez les instructions pour activer le mode CLI du contrôleur.
• Syntaxe:
  aide↙
• Reconnaître:
  Commande OK↙ : La commande est correcte et la fonction est exécutée.
  Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.
• Example:
  help↙ : affiche les instructions du mode CLI

Activation/désactivation de la réponse par écho

• Usage:
  Activez ou désactivez le contrôleur pour qu'il réponde automatiquement aux messages reçus.
• Syntaxe:
  écho[contrôle]↙
• Paramètre:
  contrôle : on – activer cette fonction
  off – désactive cette fonction (la valeur par défaut est off)
• Reconnaître:
  Commande OK↙ : La commande est correcte et la fonction est exécutée.
  Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.
• Example:
  eho on↙ : configurer le contrôleur pour qu'il réponde automatiquement aux messages reçus.

Configuration de l'intervalle de temporisation Telnet ou de la connexion

• Usage:
  Configurez les paramètres du mode CLI Telnet.
• Syntaxe:
  telnet[intervalle de temporisation][contrôle de connexion]↙
• Mot-clé
  timeout : paramètre d'intervalle de délai d'expiration de session Telnet
  login : Paramétrage de la fonction de connexion Telnet
• Paramètre:
  intervalle : timeout de la session en minute. (0 signifie jamais d'expiration) (la valeur par défaut est 5)
  contrôle : on – activer la fonction de connexion (la valeur par défaut est activée)
  off – désactiver la fonction de connexion
• Reconnaître:
  Commande OK↙ : La commande est correcte et la fonction est exécutée.
  Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.
• Example:
  telnet timeout 0↙ : configurez l'intervalle de délai d'expiration pour ne jamais dépasser le délai d'expiration
  telnet timeout 5↙ : configurer l'intervalle de temporisation à 5 minutes
  connexion telnet désactivée↙ : désactiver la fonction de connexion

Configuration des paramètres du port série

Usage:
Contrôlez et configurez les paramètres du port série.

Syntaxe:
série [p séquence] [type stype] [baud débit en bauds] [dbit bit de données] [parité parité] [sbit bit d'arrêt] [fctrl flowctrl] [dtype type de données] [endchar caractères] [checksumtype type de somme de contrôle] [durée d'expiration du délai d'attente] [contrôle « données »] [aide]↙d

Mot-clé:

• p : port
• type : type de série
• baud : débit en bauds
• dbit : bit de données
• parité : parité série
• sbit : bit d'arrêt
• fctrl : contrôle de flux
• dtype : type de données
• acktimeout : la durée du timeout (ms) est utilisée pour attendre le retour du contrôle sendack.
• endchar : un caractère de fin spécifique est utilisé pour identifier un message complet.
• checksumtype : si besoin d'un fw pour calculer automatiquement la somme de contrôle de la commande, attribuez un type de somme de contrôle
• aide : afficher les instructions

Paramètre:

• séquence : port, séparé par une virgule pour plusieurs ports * (tous les ports)
• type : 232, 422, 485 (par défaut 232)
• débit en bauds : 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (par défaut 9600)
• bit de données : 7, 8 (par défaut 8)
• sparité : aucune, paire, impaire (aucune par défaut)
• bit d'arrêt : 1, 2 (par défaut 1)
• flowctrl : aucun, hw (aucun par défaut)
• type de données : ascii, hex (ascii par défaut)
• type de somme de contrôle : aucun, modbus (aucun par défaut)
• durée : timeout spécifique (ms)(par défaut 300)
• chars : caractères de fin suivant un message complet.
• contrôle : lecture - affichage du message reçu du port série spécifique
• écriture – envoi de données depuis le port série. Utilisez le symbole « » pour couvrir les données. Utilisez le symbole \x pour envoyer le code hexadécimal
• sendack - envoie des données depuis le port série et affiche le message reçu

Reconnaîtrebord:
Commande OK↙ : La commande est correcte et la fonction est exécutée.
Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.

Example:

• Aide série ↙ : affiche les instructions
• serial p01 ↙ : affiche les informations de réglage du port série1.
• serial p* ↙ : affiche les informations de réglage de tous les ports série.
• série p01 type 232 baud 115200 dbit 8 parité aucune sbit 1 fctrl aucune ↙ : configurer port1.
• série p01,04,07 baud 19200 ↙ : configurer port1, 4, 7 au débit en bauds 19200.
• série p02 baud 19200 ↙ : configurez le port2 sur 19200 baud et utilisez les réglages par défaut pour les autres paramètres.
• serial p02 dtype hex read ↙ : affiche le message reçu du port2 au format HEX.
• serial p03 écrire "sw i01 o02\r\n" ↙ : envoyer le texte ASCII 'sw i01 o02' depuis le port3.
• serial p03 sendack "sw i01 o02\x0D\x0A" ↙ : envoie le texte ASCII 'sw i01 o02' depuis le port3 et affiche le retour.

Configuration des paramètres du port relais

Usage:
Contrôlez et configurez les ports de relais.

Syntaxe:
relais [séquence p] [tdurée impulsion] [commande] [aide] ↙

Mot-clé:

• p : port
• tpulse : période fermée pour les impulsions
• aide : afficher les instructions

Paramètre:

• séquence : port, séparé par une virgule pour plusieurs ports
• * (tous ports)
• durée : période de temps en millisecondes.
• contrôle : ouvrir – éteindre
• fermer - allumer
• impulsion - fermer le canal de relais puis ouvrir
• bascule - bascule de relais
• lire - afficher l'état

Reconnaître:
Commande OK↙ : La commande est correcte et la fonction est exécutée.
Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.

Example:

• aide relais ↙ : afficher les instructions
• relais p01 fermé ↙ : ferme le canal port1.
• relais p01 ouvert ↙ : voie ouverte port1.
• relais p01,04,07 fermer ↙ : fermer le port 1, 4, 7 canaux de relais.
• relais p02 timpulsion 500 impulsion ↙ : fermer port2 500ms puis ouvrir.
• relais p02 lecture ↙ : affichage de l'état du port2.

Configuration des paramètres du port d'E/S

Usage:
Contrôlez et configurez les ports d'E/S.

Syntaxe:
io [séquence p] [type iotype] [seuil lthresh] [seuil hthresh] [tdurée impulsion] [control] [help]↙

Mot-clé:

• p : port
• lthresh : seuil bas
• hthresh : seuil supérieur
• tpulse : période pendant laquelle les E/S restent au niveau haut en mode impulsionnel
• aide : afficher les instructions
• REMARQUE : Si un paramètre n'est pas spécifié, une valeur précédemment saisie sera appliquée.
• Paramètre:
• séquence : port, séparé par une virgule pour plusieurs ports
• * (tous ports)
• iotype : sec, vdc, dout
• seuil : seuil de déclenchement en voltage
• durée : période de temps en millisecondes.
• contrôle : ouvert
• fermer
• impulsion
• basculer
• lire

Reconnaître:
Commande OK↙ : La commande est correcte et la fonction est exécutée.
Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.

Example:

• io help ↙ : affiche les instructions
• io p01↙ : affiche les informations de réglage du port I/O1.
• io p*↙ : affiche les informations de réglage de tous les ports d'E/S.
• io p01 type sec ↙ : configurer le port 1 en mode contact sec.
• io p01 type dout ↙ : configure le port 1 en mode sortie numérique.
• io p01 type vdc lthresh 1 hthresh 3 ↙ : configurer le port 1 en mode vdc avec les paramètres de seuil.
• io p01 open ↙ : ouvre le canal port1.
• io p01 close ↙ : ferme le canal port1.
• io p01,04,07 close ↙ : ferme les canaux port1,4,7.
• io p02 tpulse 500 pulse ↙ : ferme port2 canal 500ms puis ouvre.
• io p02 lecture ↙ : affiche l'état du port2.

Configuration des paramètres IR

Usage:
Contrôlez et configurez les ports IR.

Syntaxe:
ir [séquence p] [type irtype] | [baud baudrate] [dbit databit] [parity sparity] [sbit stopbit] [dtype datatype] [checksumtype checksumtype] [control "data"] [help]↙

Mot-clé:

• p : port
• type : type de sortie pour un port de sortie spécifique
• baud** : débit en bauds
• dbit** : bit de données
• parité** : parité série
• sbit** : bit d'arrêt
• dtype** : type de données
• checksumtype** : le contrôleur/boîtier d'extension calcule automatiquement le type de somme de contrôle spécifié
• aide : afficher les instructions

NOTE:
* : Ce mot-clé est pour le type IR
** : Ces mots clés sont pour le type 232

Si un paramètre n'est pas spécifié, une valeur saisie précédemment sera appliquée.

Paramètre:

• séquence : port, séparé par une virgule pour plusieurs ports * (tous les ports)
• irtype : ir, 232 (ir par défaut)
• débit en bauds : 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (par défaut 9600)
• bit de données : 7, 8 (par défaut 8)
• sparité : aucune, paire, impaire (aucune par défaut)
• bit d'arrêt : 1, 2 (par défaut 1)
• type de données : ascii, hex (ascii par défaut)
• type de somme de contrôle : aucun, modbus (aucun par défaut)
• contrôle : écriture – envoi de code IR ou de données RS232

Reconnaître:
Commande OK↙ : La commande est correcte et la fonction est exécutée.
Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.

Example:

• ir help ↙ : afficher les instructions
• ir p01 ↙ : affiche les informations de réglage du port IR1.
• ir p* ↙ : affiche les informations de réglage de tous les ports IR.
• ir p01,04,07 type 232 ↙ : configurer port1,4,7 en type RS232
• ir p01 type 232 bauds 115200 dbit 8 parité aucune sbit 1 type de somme de contrôle modbus↙ : configurez le port1 sur le type RS232 et les paramètres
• ir p02 write dtype hex “0a0b0c” ↙ : envoyer les données au format hexadécimal 0a0b0c depuis le port2
• ir p02 baud 19200 ↙ : configurez port2 sur 19200 baud et utilisez les réglages par défaut pour les autres paramètres.
• ir p02 écrire "sw i01 o02\r\n" ↙ : envoyer le texte ASCII 'sw i01 o02' depuis le port2.
• ir p02 écrire "sw i01 o02\x0D\x0A"↙ : envoyer le texte ASCII 'sw i01 o02' depuis le port2.

Redémarrer

Usage:
Redémarrez le contrôleur.

Syntaxe:
redémarrer↙

Reconnaître:
Commande OK↙ : La commande est correcte et la fonction est exécutée.
Commande incorrecte↙ : La commande et/ou les paramètres sont incorrects et non exécutés.

Example:
reboot↙ : redémarrer l'appareil

Documents / Ressources

Interface de ligne de commande ATEN [pdf] Guide de l'utilisateur Interface de ligne de commande, interface de ligne, interface

Références

• Manuel d'utilisation