Podręcznik użytkownika interfejsu wiersza poleceń ATEN

Interfejs wiersza poleceń ATEN

Specyfikacje

• Produkt: System sterowania ATEN
• Funkcjonalność: Zdalne zarządzanie kontrolerami ATEN i skrzynkami rozszerzeń za pośrednictwem SSH/Telnetu

Instrukcje użytkowania produktu

Nawiązywanie sesji SSH/Telnet

1. Pobierz klienta SSH/Telnet, np. PuTTY, na komputer z dostępem do kontrolera ATEN lub Expansion Box.
2. Uruchom pobranego klienta.
3. Dla sesji SSH:
   • Nazwa hosta/adres IP: wprowadź adres IP lub nazwę hosta docelowego kontrolera lub urządzenia rozszerzeń.
   • Typ połączenia: SSH
   • Port: 22
4. Dla sesji telnet:
   • Nazwa hosta/adres IP: Wprowadź kontroler docelowy lub
     adres IP lub nazwa hosta urządzenia rozszerzającego.
   • Typ połączenia: Inne > Telnet
   • Port: 23
5. Kliknij Otwórz i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby się zalogować.

Polecenia SSH/Telnetu

Polecenie Pomoc

• Stosowanie: Wyświetl instrukcje dotyczące włączania trybu CLI kontrolera.
• Składnia: pomoc
• Uznać: Polecenie OK – Funkcja wykonana; Polecenie niepoprawne – Nie wykonano
• Exampna: pomoc: wyświetl instrukcję trybu CLI

Włączanie/wyłączanie funkcji Echo Reply

• Stosowanie: Włącz lub wyłącz automatyczną odpowiedź na otrzymane wiadomości.
• Składnia: echo[kontrola]
• Parametr: sterowanie: włącz – włącz; wyłącz – wyłącz (domyślnie wyłączone)
• Uznać: Polecenie OK – Funkcja wykonana; Polecenie niepoprawne – Nie wykonano
• Exampna: who on: ustawia kontroler tak, aby automatycznie odpowiadał na otrzymane wiadomości.

Konfigurowanie interwału limitu czasu Telnet lub logowania

• Stosowanie: Skonfiguruj ustawienia trybu Telnet CLI.
• Składnia: telnet[interwał limitu czasu][kontrola logowania]
• Parametr: timeout: ustawienie interwału limitu czasu sesji Telnet; login: ustawienie funkcji logowania Telnet
• Uznać: Polecenie OK – Funkcja wykonana; Polecenie niepoprawne – Nie wykonano
• Exampna: telnet timeout 0: skonfiguruj interwał limitu czasu, aby nigdy nie przekraczał limitu czasu

Konfigurowanie ustawień portu szeregowego

• Stosowanie: Kontroluj i konfiguruj ustawienia portu szeregowego.

Często zadawane pytania (FAQ)

P: Co powinienem zrobić, jeżeli nie można nawiązać sesji SSH/Telnet?
A: Jeśli nie można nawiązać sesji, zaloguj się do konsoli zarządzania urządzeniem i sprawdź, czy klucz dostępu wymaga zmiany.

O tym przewodniku
W tym przewodniku znajdują się informacje o dostępnych poleceniach SSH i Telnet umożliwiających zdalne zarządzanie kontrolerami i urządzeniami rozszerzeń ATEN.

WAŻNY: Konfiguracja dokonana za pomocą interfejsu wiersza poleceń zostanie nadpisana, jeśli projekt file należy następnie przesłać za pomocą programu ATEN Configurator (GUI).

Nawiązywanie sesji SSH/Telnet

1. Na komputerze mającym dostęp do docelowego kontrolera ATEN lub Expansion Boxa należy pobrać klienta SSH/Telnet, np. PuTTY.
   Notatka:Aby uzyskać instalator, wyszukaj w wyszukiwarce frazę „download putty” web przeglądarka.
2. Uruchom pobranego klienta.
3. Aby nawiązać sesję SSH, użyj następujących ustawień.
   

   Pole	Ustawienie
   Nazwa hosta / adres IP	Adres IP lub nazwa hosta docelowego kontrolera lub skrzynki rozszerzeń
   Typ połączenia	SSH
   Port	22

   Na przykładampna:

4. Aby ustanowić sesję telnet, użyj następujących ustawień.
   

   Pole	Ustawienie
   Nazwa hosta / adres IP	Adres IP lub nazwa hosta kontrolera docelowego lub pudełko rozszerzeń
   Typ połączenia	Inne > Telnet
   Port	23

   Na przykładampna:

5. Kliknij Otwórz i postępuj zgodnie z instrukcjami na ekranie, aby wprowadzić dane logowania. Sesja jest ustanowiona. Na przykładampna:

Notatka: Jeśli nie można nawiązać sesji, zaloguj się do konsoli zarządzania urządzeniami i sprawdź, czy klucz dostępu wymaga zmiany.

Polecenia SSH/Telnetu

Pomoc

• Stosowanie:
  Wyświetl instrukcję włączania trybu CLI kontrolera.
• Składnia:
  pomoc↙
• Uznać:
  Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
  Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.
• Exampna:
  pomoc↙: wyświetl instrukcję trybu CLI

Włączanie/wyłączanie funkcji Echo Reply

• Stosowanie:
  Włącz lub wyłącz automatyczną odpowiedź kontrolera na otrzymane wiadomości.
• Składnia:
  echo[kontrola]↙
• Parametr:
  sterowanie: włączone – włącz tę funkcję
  off – wyłącz tę funkcję (domyślnie jest wyłączona)
• Uznać:
  Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
  Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.
• Exampna:
  eho on↙: ustawia kontroler tak, aby automatycznie odpowiadał na otrzymane wiadomości.

Konfigurowanie interwału limitu czasu Telnet lub logowania

• Stosowanie:
  Skonfiguruj ustawienia trybu Telnet CLI.
• Składnia:
  telnet[interwał limitu czasu][kontrola logowania]↙
• Słowo kluczowe
  timeout: Ustawienie interwału limitu czasu sesji Telnet
  login : Ustawienie funkcji logowania Telnet
• Parametr:
  interwał: limit czasu sesji w minutach. (0 oznacza, że ​​limit czasu nigdy nie ustaje) (domyślnie 5)
  kontrola: wł. – włącz funkcję logowania (domyślnie włączona)
  off – wyłącz funkcję logowania
• Uznać:
  Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
  Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.
• Exampna:
  telnet timeout 0↙: skonfiguruj interwał limitu czasu, aby nigdy nie przekraczał limitu czasu
  telnet timeout 5↙: skonfiguruj interwał limitu czasu na 5 minut
  logowanie telnet off↙ : wyłącz funkcję logowania

Konfigurowanie ustawień portu szeregowego

Stosowanie:
Kontroluj i konfiguruj ustawienia portu szeregowego.

Składnia:
szeregowy [sekwencja p] [typ stype] [szybkość transmisji danych w bodach] [dbit bit danych] [parzystość parzystość] [sbit bit stopu] [fctrl flowctrl] [typ dtype typ danych] [znak końcowy znaki] [typ sumy kontrolnej typ sumy kontrolnej] [czas trwania limitu czasu oczekiwania] [kontrola „dane”] [pomoc]↙d

Słowo kluczowe:

• p : port
• typ: typ seryjny
• baud : szybkość transmisji
• dbit : bit danych
• parzystość : parzystość szeregowa
• sbit : bit stopu
• fctrl : kontrola przepływu
• dtype : typ danych
• acktimeout : czas trwania limitu czasu (ms) używany do oczekiwania na odpowiedź ze sterowania sendack.
• endchar: określony znak końcowy jest używany do identyfikacji całej wiadomości.
• checksumtype: jeśli potrzebne jest oprogramowanie sprzętowe do automatycznego obliczania sumy kontrolnej polecenia, przypisz typ sumy kontrolnej
• pomoc: pokaż instrukcje

Parametr:

• sekwencja: port, oddzielone przecinkiem w przypadku wielu portów * (wszystkie porty)
• typ: 232, 422, 485 (domyślnie 232)
• szybkość transmisji: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (domyślnie 9600)
• bit danych: 7, 8 (domyślnie 8)
• parzystość: brak, parzystość, nieparzystość (domyślnie brak)
• bit stopu: 1, 2 (domyślnie 1)
• flowctrl : brak, hw (domyślnie brak)
• typ danych: ascii, hex (domyślny ascii)
• checksumtype: none, modbus (domyślnie none)
• czas trwania: określony limit czasu (ms) (domyślnie 300)
• znaki: znaki końcowe następujące po kompletnej wiadomości.
• kontrola: odczyt – wyświetla otrzymaną wiadomość określonego portu szeregowego
• write – wysyłaj dane z portu szeregowego. Użyj symbolu „zakrywa dane. Użyj symbolu \x, aby wysłać kod szesnastkowy
• sendack – wysyła dane z portu szeregowego i wyświetla otrzymaną wiadomość

Potwierdzićkrawędź:
Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.

Exampna:

• Pomoc dotycząca seriali ↙ : pokaż instrukcje
• serial p01 ↙ : wyświetla informacje o ustawieniach portu szeregowego 1.
• serial p* ↙ : wyświetla informacje o ustawieniach wszystkich portów szeregowych.
• typ szeregowy p01 232 bodów 115200 dbitów 8 parzystość brak sbit 1 fctrl brak ↙ : skonfiguruj port1.
• szeregowy p01,04,07 bodów 19200 ↙ : skonfiguruj port1, 4, 7 na szybkość transmisji 19200.
• serial p02 baud 19200 ↙ : skonfiguruj port2 na baud 19200 i użyj domyślnych ustawień dla pozostałych parametrów.
• serial p02 dtype hex read ↙ : wyświetl otrzymaną wiadomość portu2 w formacie HEX.
• serial p03 write “sw i01 o02\r\n” ↙ : wyślij tekst ASCII 'sw i01 o02' z portu 3.
• serial p03 sendack „sw i01 o02\x0D\x0A” ↙ : wyślij tekst ASCII „sw i01 o02” z portu 3 i wyświetl odpowiedź.

Konfigurowanie ustawień portu przekaźnikowego

Stosowanie:
Sterowanie i konfiguracja portów przekaźnikowych.

Składnia:
przekaźnik [sekwencja p] [czas trwania impulsu t] [sterowanie] [pomoc] ↙

Słowo kluczowe:

• p : port
• tpulse : okres zamknięty dla impulsu
• pomoc: pokaż instrukcje

Parametr:

• sekwencja: port, rozdzielone przecinkiem w przypadku wielu portów
• * (wszystkie porty)
• czas trwania: okres czasu w milisekundach.
• sterowanie: otwórz – wyłącz
• zamknij – włącz
• impuls – zamknij kanał przekaźnikowy, a następnie otwórz
• przełącznik – przełącznik przekaźnika
• czytaj – wyświetl status

Uznać:
Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.

Exampna:

• pomoc w przekazywaniu ↙ : pokaż instrukcje
• przekaźnik p01 zamknij ↙ : zamknij kanał portu1.
• przekaźnik p01 otwarty ↙ : otwarty kanał portu1.
• przekaźnik p01,04,07 zamknij ↙ : zamknij kanały przekaźnikowe portu 1, 4, 7.
• przekaźnik p02 tpulse 500 impulsów ↙: zamknij port2 na 500 ms, a następnie otwórz.
• przekaźnik p02 odczyt ↙: wyświetlanie statusu portu2.

Konfigurowanie ustawień portu I/O

Stosowanie:
Sterowanie i konfiguracja portów I/O.

Składnia:
io [sekwencja p] [typ iotype] [próg lthresh] [próg hthresh] [czas trwania tpulse] [sterowanie] [pomoc]↙

Słowo kluczowe:

• p : port
• lthresh : próg dolnego ograniczenia
• hthresh : próg górnego ograniczenia
• tpulse: okres, w którym I/O pozostaje na wysokim poziomie w trybie impulsowym
• pomoc: pokaż instrukcje
• UWAGA: Jeżeli nie określono parametru, zastosowana zostanie wartość wprowadzona wcześniej.
• Parametr:
• sekwencja: port, rozdzielone przecinkiem w przypadku wielu portów
• * (wszystkie porty)
• iotype: suchy, vdc, dout
• próg: próg wyzwalający w objętościtage
• czas trwania: okres czasu w milisekundach.
• kontrola: otwarta
• zamknąć
• puls
• dźwignia kolankowa
• Czytać

Uznać:
Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.

Exampna:

• io help ↙ : pokaż instrukcje
• io p01↙: wyświetla informacje o ustawieniach portu I/O 1.
• io p*↙: wyświetla informacje o ustawieniach wszystkich portów I/O.
• io p01 type dry ↙: skonfiguruj port 1 w trybie styku bezpotencjałowego.
• io p01 type dout ↙: skonfiguruj port 1 do trybu wyjścia cyfrowego.
• io p01 type vdc lthresh 1 hthresh 3 ↙: skonfiguruj port 1 do trybu vdc z ustawieniami progowymi.
• io p01 open ↙ : otwórz kanał portu1.
• io p01 close ↙ : zamknij kanał portu1.
• io p01,04,07 close ↙ : zamknij kanały port1,4,7.
• io p02 tpulse 500 impulsów ↙ : zamknij kanał portu2 na 500 ms, a następnie otwórz.
• io p02 read ↙ : wyświetl status portu2.

Konfigurowanie ustawień IR

Stosowanie:
Sterowanie i konfiguracja portów IR.

Składnia:
ir [sekwencja p] [typ irtype] | [szybkość transmisji] [dbit bit danych] [parzystość parzystość] [sbit bit stopu] [typ dtyp danych] [typ sumy kontrolnej typ sumy kontrolnej] [kontrola „dane”] [pomoc]↙

Słowo kluczowe:

• p : port
• typ: typ wyjścia dla określonego portu wyjściowego
• baud** : szybkość transmisji
• dbit** : bit danych
• parzystość** : parzystość szeregowa
• sbit** : bit stopu
• dtype** : typ danych
• checksumtype** : Kontroler/pole rozszerzenia automatycznie oblicza określony typ sumy kontrolnej
• pomoc: pokaż instrukcje

NOTATKA:
* : To słowo kluczowe jest dla typu IR
**: Te słowa kluczowe są dla typu 232

Jeżeli nie określono parametru, zastosowana zostanie wartość wprowadzona wcześniej.

Parametr:

• sekwencja: port, oddzielone przecinkiem w przypadku wielu portów * (wszystkie porty)
• irtype: ir, 232 (domyślny ir)
• szybkość transmisji: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (domyślnie 9600)
• bit danych: 7, 8 (domyślnie 8)
• parzystość: brak, parzystość, nieparzystość (domyślnie brak)
• bit stopu: 1, 2 (domyślnie 1)
• typ danych: ascii, hex (domyślny ascii)
• checksumtype: none, modbus (domyślnie none)
• sterowanie: pisanie – wysyłanie kodu IR lub danych RS232

Uznać:
Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.

Example:

• ir help ↙ : pokaż instrukcje
• ir p01 ↙: wyświetla informacje o ustawieniach portu IR1.
• ir p* ↙ : wyświetla informacje o ustawieniach wszystkich portów IR.
• ir p01,04,07 typ 232 ↙ : skonfiguruj port 1,4,7 na typ RS232
• ir p01 typ 232 bodów 115200 dbit 8 parzystość brak sbit 1 suma kontrolna typ modbus↙: skonfiguruj port1 na typ RS232 i ustawienia
• ir p02 write dtype hex “0a0b0c” ↙ : wyślij dane w formacie hex 0a0b0c z portu2
• ir p02 baud 19200 ↙ : skonfiguruj port2 na baud 19200 i użyj domyślnych ustawień dla pozostałych parametrów.
• ir p02 write “sw i01 o02\r\n” ↙ : wyślij tekst ASCII 'sw i01 o02' z portu 2.
• ir p02 write “sw i01 o02\x0D\x0A”↙ : wyślij tekst ASCII 'sw i01 o02' z portu 2.

Ponowne uruchomienie

Stosowanie:
Uruchom ponownie kontroler.

Składnia:
uruchom ponownie↙

Uznać:
Polecenie OK↙: Polecenie jest poprawne i funkcja została wykonana.
Nieprawidłowe polecenie↙: Polecenie i/lub parametry są nieprawidłowe i nie zostały wykonane.

Exampna:
reboot↙ : ponowne uruchomienie urządzenia