ATEN-Befehlszeilenschnittstelle – Benutzerhandbuch

ATEN-Befehlszeilenschnittstelle

Technische Daten

• Produkt: ATEN Kontrollsystem
• Funktionalität: Fernverwaltung von ATEN-Controllern und Erweiterungsboxen über SSH/Telnet

Anweisungen zur Produktverwendung

Herstellen einer SSH/Telnet-Sitzung

1. Laden Sie einen SSH/Telnet-Client wie PuTTY auf einen Computer mit Zugriff auf den ATEN-Controller oder die Expansion Box herunter.
2. Führen Sie den heruntergeladenen Client aus.
3. Für SSH-Sitzung:
   • Hostname/IP-Adresse: Geben Sie die IP-Adresse oder den Hostnamen des Zielcontrollers oder der Erweiterungsbox ein.
   • Verbindungstyp: SSH
   • Hafen: 22
4. Für Telnet-Sitzung:
   • Hostname/IP-Adresse: Geben Sie den Zielcontroller ein oder
     IP-Adresse oder Hostname der Erweiterungsbox.
   • Verbindungstyp: Andere > Telnet
   • Hafen: 23
5. Klicken Sie auf „Öffnen“ und folgen Sie den Anweisungen auf dem Bildschirm, um sich anzumelden.

SSH/Telnet-Befehle

Hilfebefehl

• Verwendung: Zeigt Anweisungen zum Aktivieren des CLI-Modus des Controllers an.
• Syntax: helfen
• Bestätigen: Befehl OK – Funktion ausgeführt; Befehl falsch – Nicht ausgeführt
• Exampauf: Hilfe: Anleitung zum Anzeigen des CLI-Modus

Aktivieren/Deaktivieren der Echo-Antwort

• Verwendung: Aktivieren oder deaktivieren Sie die automatische Antwort auf empfangene Nachrichten.
• Syntax: echo[Steuerung]
• Parameter: Steuerung: ein – aktivieren; aus – deaktivieren (Standard ist aus)
• Bestätigen: Befehl OK – Funktion ausgeführt; Befehl falsch – Nicht ausgeführt
• Exampauf: Wer ist eingeschaltet: Stellen Sie den Controller so ein, dass er automatisch auf empfangene Nachrichten antwortet.

Konfigurieren des Telnet-Timeout-Intervalls oder der Anmeldung

• Verwendung: Konfigurieren Sie die Einstellungen für den Telnet-CLI-Modus.
• Syntax: Telnet [Timeout-Intervall] [Anmeldekontrolle]
• Parameter: Timeout: Einstellung des Zeitüberschreitungsintervalls für die Telnet-Sitzung; Login: Einstellung der Telnet-Anmeldefunktion
• Bestätigen: Befehl OK – Funktion ausgeführt; Befehl falsch – Nicht ausgeführt
• Exampauf: Telnet-Timeout 0: Konfigurieren Sie das Timeout-Intervall so, dass es nie zu einer Zeitüberschreitung kommt.

Konfigurieren der seriellen Porteinstellungen

• Verwendung: Steuern und konfigurieren Sie die Einstellungen der seriellen Schnittstelle.

Häufig gestellte Fragen (FAQ)

F: Was soll ich tun, wenn die SSH/Telnet-Sitzung nicht hergestellt werden kann?
A: Wenn die Sitzung nicht hergestellt werden kann, melden Sie sich bei der Geräteverwaltungskonsole an, um zu prüfen, ob der Zugriffsschlüssel geändert werden muss.

Über dieses Handbuch
Dieses Handbuch enthält Informationen zu den verfügbaren SSH- und Telnet-Befehlen zur Fernverwaltung von ATEN-Controllern und Erweiterungsboxen.

WICHTIG: Die über die Kommandozeile vorgenommene Konfiguration wird überschrieben, wenn ein Projekt file wird anschließend über den ATEN Configurator (GUI) hochgeladen.

Herstellen einer SSH/Telnet-Sitzung

1. Laden Sie auf einem Computer, der Zugriff auf den Ziel-ATEN-Controller oder die Ziel-Erweiterungsbox hat, einen SSH/Telnet-Client herunter, z. B. PuTTY.
   Notiz: Um das Installationsprogramm zu erhalten, suchen Sie nach „Download Putty“ in einem web Browser.
2. Führen Sie den heruntergeladenen Client aus.
3. Verwenden Sie zum Herstellen einer SSH-Sitzung die folgenden Einstellungen.
   

   Feld	Einstellung
   Hostname/IP-Adresse	IP-Adresse oder Hostname des Zielcontrollers oder der Erweiterungsbox
   Verbindungstyp	SSH
   Hafen	22

   Zum Beispielampauf:

4. Verwenden Sie zum Herstellen einer Telnet-Sitzung die folgenden Einstellungen.
   

   Feld	Einstellung
   Hostname/IP-Adresse	IP-Adresse oder Hostname des Zielcontrollers oder Erweiterungsbox
   Verbindungstyp	Andere > Telnet
   Hafen	23

   Zum Beispielampauf:

5. Klicken Sie auf Öffnen und folgen Sie den Anweisungen auf dem Bildschirm, um die Anmeldeinformationen einzugeben. Eine Sitzung wird eingerichtet. Zum Beispielampauf:

Notiz: Wenn die Sitzung nicht hergestellt werden kann, melden Sie sich bei der Geräteverwaltungskonsole an, um zu prüfen, ob der Zugriffsschlüssel geändert werden muss.

SSH/Telnet-Befehle

Helfen

• Verwendung:
  Zeigen Sie die Anleitung zum Aktivieren des CLI-Modus des Controllers an.
• Syntax:
  Hilfe↙
• Bestätigen:
  Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
  Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.
• Exampauf:
  Hilfe↙: Anleitung zum Anzeigen des CLI-Modus

Aktivieren/Deaktivieren der Echo-Antwort

• Verwendung:
  Aktivieren oder deaktivieren Sie die automatische Antwort des Controllers auf empfangene Nachrichten.
• Syntax:
  echo[Steuerung]↙
• Parameter:
  Steuerung: ein – Aktivieren Sie diese Funktion
  aus – diese Funktion deaktivieren (Standard ist aus)
• Bestätigen:
  Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
  Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.
• Exampauf:
  eho on↙: Stellen Sie den Controller so ein, dass er automatisch auf empfangene Nachrichten antwortet.

Konfigurieren des Telnet-Timeout-Intervalls oder der Anmeldung

• Verwendung:
  Konfigurieren Sie die Einstellungen für den Telnet-CLI-Modus.
• Syntax:
  Telnet [Timeout-Intervall] [Anmeldekontrolle] ↙
• Stichwort
  timeout: Einstellung des Timeout-Intervalls der Telnet-Sitzung
  Anmelden: Einstellung der Telnet-Anmeldefunktion
• Parameter:
  Intervall: Sitzungstimeout in Minuten. (0 bedeutet, dass es nie ein Timeout gibt) (Standard ist 5)
  Steuerung: Ein – Anmeldefunktion aktivieren (Standard ist Ein)
  aus – Login-Funktion deaktivieren
• Bestätigen:
  Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
  Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.
• Exampauf:
  Telnet-Timeout 0↙: Konfigurieren Sie das Timeout-Intervall so, dass es nie zu einer Zeitüberschreitung kommt.
  Telnet-Timeout 5↙: Konfigurieren Sie das Timeout-Intervall auf 5 Minuten
  Telnet-Login aus↙: Deaktiviert die Login-Funktion

Konfigurieren der seriellen Porteinstellungen

Verwendung:
Steuern und konfigurieren Sie die Einstellungen der seriellen Schnittstelle.

Syntax:
seriell [p-Sequenz] [Typ Stype] [Baud Baudrate] [dbit Datenbit] [Parität Sparität] [sbit Stoppbit] [fctrl Flusssteuerung] [dtype Datentyp] [endchar Zeichen] [Prüfsummentyp Prüfsummentyp] [acktimeout Dauer] [Steuerung „Daten“] [Hilfe]↙d

Stichwort:

• p: Hafen
• Typ: Serientyp
• Baud: Baudrate
• dbit: Datenbit
• Parität: serielle Parität
• sbit: Stoppbit
• fctrl: Flusskontrolle
• dtype: Datentyp
• acktimeout: Die Timeout-Dauer (ms) wird zum Warten auf die Rückmeldung von der Sendack-Steuerung verwendet.
• Endzeichen: Ein bestimmtes Endzeichen wird verwendet, um eine vollständige Nachricht zu identifizieren.
• Prüfsummentyp: Wenn die Firmware die Befehlsprüfsumme automatisch berechnen soll, weisen Sie einen Prüfsummentyp zu.
• Hilfe: Anleitung anzeigen

Parameter:

• Reihenfolge: Port, bei mehreren Ports durch Komma getrennt * (alle Ports)
• Typ: 232, 422, 485 (Standard 232)
• Baudrate: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (Standard 9600)
• Datenbit: 7, 8 (Standard 8)
• Sparität: keine, gerade, ungerade (Standard: keine)
• Stoppbit: 1, 2 (Standard 1)
• flowctrl: keine, hw (Standard: keine)
• Datentyp: ASCII, Hex (Standard: ASCII)
• Prüfsummentyp: keiner, Modbus (Standard: keiner)
• Dauer: bestimmtes Timeout (ms) (Standard 300)
• Zeichen: Endzeichen nach einer vollständigen Nachricht.
• Steuerung: Lesen – Anzeige empfangener Nachrichten des spezifischen seriellen Ports
• Schreiben – Daten vom seriellen Port senden. Das Symbol „ deckt Daten ab. Das Symbol \x zum Senden von Hex-Code verwenden
• sendack – Daten vom seriellen Port senden und empfangene Nachricht anzeigen

BestätigenRand:
Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.

Exampauf:

• Serienhilfe ↙ : Anleitung anzeigen
• Serial p01 ↙: Einstellungsinformationen für seriellen Port 1 anzeigen.
• serial p* ↙: Einstellungsinformationen aller seriellen Ports anzeigen.
• Seriell p01 Typ 232 Baud 115200 Dbit 8 Parität keine Sbit 1 Fctrl keine ↙ : Port1 konfigurieren.
• seriell p01,04,07 Baud 19200 ↙: Port1, 4, 7 auf Baudrate 19200 konfigurieren.
• Seriell P02 Baud 19200 ↙: Konfigurieren Sie Port2 auf Baud 19200 und verwenden Sie die Standardeinstellungen für andere Parameter.
• serial p02 dtype hex read ↙: Zeigt die empfangene Nachricht von Port2 im HEX-Format an.
• serial p03 write “sw i01 o02\r\n” ↙ : Senden Sie den ASCII-Text „sw i01 o02“ von Port3.
• serielles p03-Sendeack „sw i01 o02\x0D\x0A“ ↙: Senden Sie den ASCII-Text „sw i01 o02“ von Port3 und zeigen Sie das Feedback an.

Konfigurieren der Relay-Port-Einstellungen

Verwendung:
Steuern und konfigurieren Sie Relay-Ports.

Syntax:
Relais [p-Sequenz] [tPulsdauer] [Steuerung] [Hilfe] ↙

Stichwort:

• p: Hafen
• tpulse: geschlossene Periode für Puls
• Hilfe: Anleitung anzeigen

Parameter:

• Reihenfolge: Port, bei mehreren Ports durch Komma getrennt
• * (alle Häfen)
• Dauer: Zeitspanne in Millisekunden.
• Steuerung: öffnen – ausschalten
• schließen – einschalten
• Impuls – Relaiskanal schließen, dann öffnen
• Umschalten – Relaisumschalten
• lesen – Status anzeigen

Bestätigen:
Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.

Exampauf:

• Relais-Hilfe ↙: Anleitung anzeigen
• Relais P01 schließen ↙: Port1-Kanal schließen.
• Relais P01 offen ↙: Port1-Kanal öffnen.
• Relais p01,04,07 schließen ↙: Relaiskanäle Port 1, 4, 7 schließen.
• Relais P02 T-Pulse 500 Pulse ↙: Port2 500 ms schließen, dann öffnen.
• Relais P02 lesen ↙: Port2-Status anzeigen.

Konfigurieren der E/A-Porteinstellungen

Verwendung:
Steuern und konfigurieren Sie E/A-Ports.

Syntax:
io [p-Sequenz] [Typ iotype] [lthresh-Schwellenwert] [hthresh-Schwellenwert] [tPulsdauer] [Steuerung] [Hilfe]↙

Stichwort:

• p: Hafen
• lthresh: unterer Schwellenwert
• hthresh: oberer Schwellenwert
• tpulse: Zeitraum, in dem I/O im Pulsmodus auf hohem Pegel bleibt
• Hilfe: Anleitung anzeigen
• HINWEIS: Wenn ein Parameter nicht angegeben wird, wird ein zuvor eingegebener Wert angewendet.
• Parameter:
• Reihenfolge: Port, bei mehreren Ports durch Komma getrennt
• * (alle Häfen)
• Iotyp: trocken, vdc, dout
• Schwellenwert: Auslöseschwelle in Lautstärketage
• Dauer: Zeitspanne in Millisekunden.
• Steuerung: offen
• schließen
• Impuls
• Umschalten
• lesen

Bestätigen:
Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.

Exampauf:

• io-Hilfe ↙: Anweisungen anzeigen
• io p01↙: Einstellungsinformationen für E/A-Port1 anzeigen.
• io p*↙: Einstellungsinformationen aller E/A-Ports anzeigen.
• io p01 Typ trocken ↙: Port 1 auf Trockenkontaktmodus konfigurieren.
• io p01 Typ dout ↙: Port 1 auf digitalen Ausgabemodus konfigurieren.
• io p01 Typ VDC lthresh 1 hthresh 3 ↙: Port 1 auf VDC-Modus mit Schwellenwerteinstellungen konfigurieren.
• io p01 öffnen ↙: Port1-Kanal öffnen.
• io p01 close ↙: Port1-Kanal schließen.
• io p01,04,07 schließen ↙: Port1,4,7-Kanäle schließen.
• io p02 tpulse 500 Pulse ↙: Port2-Kanal 500 ms schließen, dann öffnen.
• io p02 lesen ↙: Port2-Status anzeigen.

Konfigurieren der IR-Einstellungen

Verwendung:
Steuern und konfigurieren Sie IR-Ports.

Syntax:
ir [p-Sequenz] [Typ irtype] | [Baud Baudrate] [dbit Datenbit] [Parität Sparität] [sbit Stoppbit] [dtype Datentyp] [Prüfsummentyp Prüfsummentyp] [Steuerung „Daten“] [Hilfe]↙

Stichwort:

• p: Hafen
• Typ: Ausgabetyp für bestimmten Ausgabeport
• baud** : Baudrate
• dbit** : Datenbit
• Parität**: serielle Parität
• sbit**: Stoppbit
• dtype**: Datentyp
• checksumtype** : Controller/Erweiterungsbox berechnet automatisch den angegebenen Prüfsummentyp
• Hilfe: Anleitung anzeigen

NOTIZ:
*: Dieses Schlüsselwort ist für den IR-Typ
**: Diese Schlüsselwörter sind für Typ 232

Wenn ein Parameter nicht angegeben wird, wird ein zuvor eingegebener Wert verwendet.

Parameter:

• Reihenfolge: Port, bei mehreren Ports durch Komma getrennt * (alle Ports)
• irtype: ir, 232 (Standard ir)
• Baudrate: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (Standard 9600)
• Datenbit: 7, 8 (Standard 8)
• Sparität: keine, gerade, ungerade (Standard: keine)
• Stoppbit: 1, 2 (Standard 1)
• Datentyp: ASCII, Hex (Standard: ASCII)
• Prüfsummentyp: keiner, Modbus (Standard: keiner)
• Steuerung: Schreiben – Senden von IR-Code oder RS232-Daten

Bestätigen:
Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.

Example:

• ir Hilfe ↙ : Anweisungen anzeigen
• ir p01 ↙: Einstellungsinformationen für IR-Port1 anzeigen.
• ir p* ↙: Einstellungsinformationen aller IR-Ports anzeigen.
• ir p01,04,07 Typ 232 ↙: Port1,4,7 auf RS232-Typ konfigurieren
• ir p01 Typ 232 Baud 115200 Dbit 8 Parität keine Sbit 1 Prüfsummentyp Modbus↙: Konfigurieren Sie Port1 auf RS232-Typ und die Einstellungen
• ir p02 write dtype hex „0a0b0c“ ↙ : sende Daten im Hex-Format 0a0b0c von Port2
• ir p02 Baud 19200 ↙: Konfigurieren Sie Port2 auf Baud 19200 und verwenden Sie die Standardeinstellungen für andere Parameter.
• ir p02 schreibe „sw i01 o02\r\n“ ↙: Sende den ASCII-Text „sw i01 o02“ von Port2.
• ir p02 schreibe „sw i01 o02\x0D\x0A“ ↙: Sende den ASCII-Text „sw i01 o02“ von Port2.

Neustart

Verwendung:
Starten Sie den Controller neu.

Syntax:
Neustart↙

Bestätigen:
Befehl OK↙: Befehl ist korrekt und die Funktion wird ausgeführt.
Befehl falsch↙: Befehl und/oder Parameter sind falsch und werden nicht ausgeführt.

Exampauf:
Neustart ↙: Gerät neu starten