Посібник користувача інтерфейсу командного рядка ATEN

Інтерфейс командного рядка ATEN

Технічні характеристики

• Продукт: Система управління ATEN
• Функціональність: віддалене керування контролерами та блоками розширення ATEN через SSH/Telnet

Інструкція з використання продукту

Встановлення сеансу SSH/Telnet

1. Завантажте клієнт SSH/Telnet, наприклад PuTTY, на комп’ютер із доступом до контролера ATEN або Expansion Box.
2. Запустіть завантажений клієнт.
3. Для сесії SSH:
   • Ім’я хоста/IP-адреса: введіть IP-адресу або ім’я хоста цільового контролера або блоку розширення.
   • Тип підключення: SSH
   • Порт: 22
4. Для сесії telnet:
   • Ім’я хоста/IP-адреса: введіть цільовий контролер або
     IP-адресу або ім’я хоста блоку розширення.
   • Тип підключення: Інше > Telnet
   • Порт: 23
5. Натисніть Відкрити та дотримуйтесь інструкцій на екрані, щоб увійти.

Команди SSH/Telnet

Команда допомоги

• Використання: Відображення інструкцій для ввімкнення режиму CLI контролера.
• Синтаксис: допомогти
• Признайте: Команда ОК – функція виконана; Команда неправильна – не виконується
• Exampле: допомога: відображення інструкцій режиму CLI

Увімкнення/вимкнення Echo Reply

• Використання: Увімкнути або вимкнути автоматичну відповідь на отримані повідомлення.
• Синтаксис: echo[контроль]
• Параметр: керування: увімкнути – увімкнути; off – вимкнено (за замовчуванням вимкнено)
• Признайте: Команда ОК – функція виконана; Команда неправильна – не виконується
• Exampле: who on: налаштуйте контролер на автоматичну відповідь на отримані повідомлення.

Налаштування інтервалу очікування Telnet або входу

• Використання: Налаштуйте параметри режиму Telnet CLI.
• Синтаксис: telnet[інтервал очікування][контроль входу]
• Параметр: тайм-аут: налаштування інтервалу тайм-ауту сеансу Telnet; login: налаштування функції входу Telnet
• Признайте: Команда ОК – функція виконана; Команда неправильна – не виконується
• Exampле: telnet тайм-аут 0: налаштуйте інтервал тайм-ауту так, щоб він ніколи не таймаут

Налаштування параметрів послідовного порту

• Використання: Контролюйте та налаштовуйте параметри послідовного порту.

Часті запитання (FAQ)

З: Що робити, якщо не вдається встановити сеанс SSH/Telnet?
A: Якщо сеанс не вдається встановити, увійдіть до консолі керування пристроєм, щоб перевірити, чи потрібно змінити ключ доступу.

Про цей посібник
Цей посібник містить інформацію про доступні команди SSH і Telnet для віддаленого керування контролерами та блоками розширення ATEN.

ВАЖЛИВО: Конфігурацію, зроблену через інтерфейс командного рядка, буде перезаписано, якщо проект file потім завантажується через ATEN Configurator (GUI).

Встановлення сеансу SSH/Telnet

1. На комп’ютері, який має доступ до цільового контролера ATEN або Expansion Box, завантажте клієнт SSH/Telnet, наприклад PuTTY.
   Примітка: щоб отримати програму встановлення, знайдіть «завантажити putty» у a web браузер.
2. Запустіть завантажений клієнт.
3. Щоб встановити сеанс SSH, скористайтеся наведеними нижче налаштуваннями.
   

   Поле	Налаштування
   Ім'я хоста / IP-адреса	IP-адреса або ім’я хоста цільового контролера або блоку розширення
   Тип підключення	SSH
   Порт	22

   наприкладampле:

4. Щоб встановити сеанс Telnet, скористайтеся наведеними нижче налаштуваннями.
   

   Поле	Налаштування
   Ім'я хоста / IP-адреса	IP-адреса або ім’я хоста цільового контролера або коробка розширення
   Тип підключення	Інше > Telnet
   Порт	23

   наприкладampле:

5. Натисніть Відкрити та дотримуйтеся вказівок на екрані, щоб ввести облікові дані для входу. Встановлюється сесія. наприкладampле:

Примітка: Якщо сеанс не вдається встановити, увійдіть у консоль керування пристроєм, щоб перевірити, чи потрібно змінити ключ доступу.

Команди SSH/Telnet

Довідка

• Використання:
  Відобразити інструкцію для ввімкнення режиму CLI контролера.
• Синтаксис:
  допомога↙
• Признайте:
  Команда OK↙ : команда правильна і функція виконується.
  Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.
• Exampле:
  довідка↙ : відображення інструкцій режиму CLI

Увімкнення/вимкнення Echo Reply

• Використання:
  Увімкніть або вимкніть автоматичну відповідь контролера на отримані повідомлення.
• Синтаксис:
  echo[контроль]↙
• Параметр:
  control : on – увімкнути цю функцію
  вимкнено – вимкнути цю функцію (за замовчуванням вимкнено)
• Признайте:
  Команда OK↙ : команда правильна і функція виконується.
  Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.
• Exampле:
  eho on↙ : налаштуйте контролер на автоматичну відповідь на отримані повідомлення.

Налаштування інтервалу очікування Telnet або входу

• Використання:
  Налаштуйте параметри режиму Telnet CLI.
• Синтаксис:
  telnet[інтервал очікування][контроль входу]↙
• Ключове слово
  тайм-аут : налаштування інтервалу тайм-ауту сеансу Telnet
  login : налаштування функції входу Telnet
• Параметр:
  інтервал: тайм-аут сеансу в хвилинах. (0 означає відсутність часу очікування) (за замовчуванням 5)
  control : on – увімкнути функцію входу (за замовчуванням увімкнено)
  вимкнено – вимкнути функцію входу
• Признайте:
  Команда OK↙ : команда правильна і функція виконується.
  Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.
• Exampле:
  telnet тайм-аут 0↙ : налаштуйте інтервал тайм-ауту на ніколи
  telnet timeout 5↙ : налаштуйте інтервал тайм-ауту на 5 хвилин
  telnet login off↙ : вимкнути функцію входу

Налаштування параметрів послідовного порту

Використання:
Контролюйте та налаштовуйте параметри послідовного порту.

Синтаксис:
послідовний [p послідовність] [тип stype] [швидкість передачі в бодах] [dbit databit] [parity parity] [sbit stopbit] [fctrl flowctrl] [dtype datatype] [endchar chars ] [checksumtype checksumtype] [acktimeout duration] [control “data” ] [допомога]↙d

Ключове слово:

• p : порт
• тип: серійний тип
• baud : швидкість передачі даних
• dbit : біт даних
• parity : послідовний паритет
• sbit : стоп-біт
• fctrl : керування потоком
• dtype : тип даних
• acktimeout: тривалість тайм-ауту (мс) використовується для очікування зворотного зв’язку від керування sendack.
• endchar : певний кінцевий символ використовується для ідентифікації повного повідомлення.
• checksumtype: якщо потрібно fw автоматично обчислити контрольну суму команди, призначте тип контрольної суми
• допомога: показати інструкції

Параметр:

• послідовність: порт, розділений комою для кількох портів * (усі порти)
• тип: 232, 422, 485 (за замовчуванням 232)
• Швидкість передачі: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (за замовчуванням 9600)
• біт даних: 7, 8 (за замовчуванням 8)
• парність: немає, парний, непарний (за замовчуванням немає)
• стоп-біт: 1, 2 (за замовчуванням 1)
• flowctrl : немає, hw (за замовчуванням немає)
• тип даних: ascii, hex (за замовчуванням ascii)
• контрольна сума: немає, modbus (за замовчуванням немає)
• тривалість: певний час очікування (мс) (за замовчуванням 300)
• chars : кінцеві символи після повного повідомлення.
• control : read – відображення отриманого повідомлення певного послідовного порту
• write – відправляти дані з послідовного порту. Використовуйте символ «охоплює дані». Використовуйте символ \x, щоб надіслати шістнадцятковий код
• sendack – надсилати дані з послідовного порту та відображати отримане повідомлення

Підтвердитикрай:
Команда OK↙ : команда правильна і функція виконується.
Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.

Exampле:

• Серійна довідка ↙: показати інструкції
• serial p01 ↙ : відображення інформації про налаштування послідовного порту1.
• serial p* ↙ : відображення інформації про налаштування всіх послідовних портів.
• послідовний p01 тип 232 бод 115200 dbit 8 парність немає sbit 1 fctrl немає ↙ : налаштувати порт1.
• serial p01,04,07 baud 19200 ↙ : налаштувати port1, 4, 7 на швидкість передачі даних 19200 bod.
• serial p02 baud 19200 ↙: налаштуйте порт2 на швидкість передачі 19200 і використовуйте налаштування за замовчуванням для інших параметрів.
• serial p02 dtype hex read ↙ : відображення отриманого повідомлення порту2 у форматі HEX.
• serial p03 write “sw i01 o02\r\n” ↙ : надіслати текст ASCII 'sw i01 o02' з порту3.
• serial p03 sendack “sw i01 o02\x0D\x0A” ↙ : надсилання тексту ASCII 'sw i01 o02' з порту3 та відображення зворотного зв'язку.

Налаштування параметрів порту ретрансляції

Використання:
Контролюйте та налаштовуйте релейні порти.

Синтаксис:
реле [p послідовність] [tтривалість імпульсу] [контроль] [довідка] ↙

Ключове слово:

• p : порт
• tpulse : закритий період для імпульсу
• допомога: показати інструкції

Параметр:

• послідовність : порт, розділений комою для кількох портів
• * (всі порти)
• тривалість : період часу в мілісекундах.
• управління: відкрити – вимкнути
• закрити – включити
• імпульс – замкнути канал реле, потім відкрити
• тумблер – перемикач реле
• читати – відображення стану

Признайте:
Команда OK↙ : команда правильна і функція виконується.
Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.

Exampле:

• реле допомоги ↙ : показати інструкції
• реле p01 закрити ↙ : закрити канал порту1.
• реле p01 відкрито ↙ : відкрити канал порту1.
• реле p01,04,07 закрити ↙ : закрити порт 1, 4, 7 каналів реле.
• реле p02 tpulse 500 імпульсів ↙ : закрити порт2 500 мс, потім відкрити.
• реле p02 читання ↙ : відображення статусу порту 2.

Налаштування параметрів порту введення/виведення

Використання:
Контролюйте та налаштовуйте порти введення/виведення.

Синтаксис:
io [p послідовність] [тип iotype] [lthresh threshold] [hthresh threshold] [tpulse duration] [control] [help]↙

Ключове слово:

• p : порт
• lthresh: нижній поріг
• hthresh : поріг високої межі
• tpulse : період, протягом якого введення/виведення залишається на високому рівні в імпульсному режимі
• допомога: показати інструкції
• ПРИМІТКА. Якщо параметр не вказано, буде застосовано попередньо введене значення.
• Параметр:
• послідовність : порт, розділений комою для кількох портів
• * (всі порти)
• йотип: сухий, vdc, dout
• threshold : поріг запуску в обtage
• тривалість : період часу в мілісекундах.
• керування: відкритий
• закрити
• пульс
• перемикач
• читати

Признайте:
Команда OK↙ : команда правильна і функція виконується.
Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.

Exampле:

• io help ↙ : показати інструкції
• io p01↙ : відображення інформації про налаштування порту введення/виведення1.
• io p*↙ : відображення інформації про налаштування всіх портів введення/виведення.
• io p01 type dry ↙ : налаштувати порт 1 на режим сухого контакту.
• io p01 type dout ↙ : налаштувати порт 1 на режим цифрового виведення.
• io p01 type vdc lthresh 1 hthresh 3 ↙ : налаштуйте порт 1 на режим vdc із налаштуваннями порогу.
• io p01 open ↙ : відкритий канал port1.
• io p01 close ↙ : закрити канал port1.
• io p01,04,07 закрити ↙ : закрити канали port1,4,7.
• io p02 tpulse 500 імпульсів ↙ : закрийте канал port2 на 500 мс, а потім відкрийте.
• io p02 read ↙ : відображення статусу port2.

Налаштування параметрів ІЧ

Використання:
Керуйте та налаштовуйте ІЧ-порти.

Синтаксис:
ir [p послідовність] [тип irtype] | [швидкість передачі в бодах] [dbit databit] [parity parity] [sbit stopbit] [dtype datatype] [checksumtype checksumtype] [control “data”] [help]↙

Ключове слово:

• p : порт
• type : тип виводу для певного вихідного порту
• baud** : швидкість передачі даних
• dbit** : біт даних
• parity** : послідовний паритет
• sbit** : стоп-біт
• dtype** : тип даних
• checksumtype** : контролер/блок розширення автоматично обчислює вказаний тип контрольної суми
• допомога: показати інструкції

ПРИМІТКА:
* : це ключове слово для ІЧ-типу
** : Ці ключові слова для 232 типу

Якщо параметр не вказано, буде застосовано попередньо введене значення.

Параметр:

• послідовність: порт, розділений комою для кількох портів * (усі порти)
• irtype: ir, 232 (за замовчуванням ir)
• Швидкість передачі: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 (за замовчуванням 9600)
• біт даних: 7, 8 (за замовчуванням 8)
• парність: немає, парний, непарний (за замовчуванням немає)
• стоп-біт: 1, 2 (за замовчуванням 1)
• тип даних: ascii, hex (за замовчуванням ascii)
• контрольна сума: немає, modbus (за замовчуванням немає)
• керування: запис – надсилання ІЧ-коду або даних RS232

Признайте:
Команда OK↙ : команда правильна і функція виконується.
Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.

Example:

• ir help ↙ : показати інструкції
• ir p01 ↙ : відображення інформації про налаштування ІЧ-порту1.
• ir p* ↙ : відображення інформації про налаштування всіх ІЧ-портів.
• ir p01,04,07 тип 232 ↙ : налаштувати порт 1,4,7 на тип RS232
• ir p01 type 232 baud 115200 dbit 8 parity none sbit 1 checksum type modbus↙ : конфігурація port1 для типу RS232 і параметрів
• ir p02 write dtype hex “0a0b0c” ↙ : надсилання даних у шістнадцятковому форматі 0a0b0c з порту2
• ir p02 бод 19200 ↙ : налаштуйте порт2 на 19200 бод і використовуйте налаштування за замовчуванням для інших параметрів.
• ir p02 написати «sw i01 o02\r\n» ↙ : надіслати текст ASCII «sw i01 o02» з порту2.
• ir p02 write “sw i01 o02\x0D\x0A”↙ : надішліть текст ASCII 'sw i01 o02' з порту2.

Перезавантаження

Використання:
Перезавантажте контролер.

Синтаксис:
перезавантажити↙

Признайте:
Команда OK↙ : команда правильна і функція виконується.
Неправильна команда↙ : команда та/або параметри неправильні та не виконуються.

Exampле:
reboot↙ : перезавантажити пристрій