ATEN Command Line Interface

Mga detalye

• Produkto: Sistema sa Pagkontrol sa ATEN
• Functionality: Pagdumala sa layo nga ATEN controllers ug expansion boxes pinaagi sa SSH/Telnet

Mga Instruksyon sa Paggamit sa Produkto

Pagtukod ug SSH/Telnet Session

1. Pag-download sa usa ka kliyente sa SSH/Telnet sama sa PuTTY sa usa ka kompyuter nga adunay access sa ATEN controller o Expansion Box.
2. Pagdalagan ang na-download nga kliyente.
3. Para sa SSH session:
   • Host Name / IP address: Isulod ang target controller o expansion box's IP address o host name.
   • Uri sa Koneksyon: SSH
   • Dunggoanan: 22
4. Para sa telnet session:
   • Host Name / IP address: Pagsulod sa target controller o
     ang IP address o host name sa expansion box.
   • Uri sa Koneksyon: Lain > Telnet
   • Dunggoanan: 23
5. I-klik ang Open ug sunda ang mga instruksyon sa screen aron maka-log in.

Mga Sugo sa SSH/Telnet

Tabang Command

• Paggamit: Ipakita ang mga panudlo alang sa pagpagana sa CLI mode sa controller.
• Syntax: tabang
• Moila: Command OK - Gipatuman ang function; Dili sakto ang sugo – Wala gipatuman
• Example: tabang: ipakita ang panudlo sa CLI mode

Pag-enable/Pag-disable sa Echo Reply

• Paggamit: I-enable o i-disable ang awtomatikong pagtubag sa nadawat nga mga mensahe.
• Syntax: echo[kontrol]
• Parameter: kontrol: on – makahimo; off – disable (ang default kay off)
• Moila: Command OK - Gipatuman ang function; Dili sakto ang sugo – Wala gipatuman
• Example: kinsa on: i-set ang controller nga awtomatikong motubag sa nadawat nga mga mensahe.

Pag-configure sa Telnet Timeout Interval o Login

• Paggamit: I-configure ang mga setting sa Telnet CLI mode.
• Syntax: telnet[timeout interval][login control]
• Parameter: timeout: setting sa agwat sa timeout sa sesyon sa Telnet; login: setting sa pag-login sa Telnet
• Moila: Command OK - Gipatuman ang function; Dili sakto ang sugo – Wala gipatuman
• Example: telnet timeout 0 : i-configure ang timeout interval aron dili gyud timeout

Pag-configure sa Mga Setting sa Serial Port

• Paggamit: Kontrola ug i-configure ang mga setting sa serial port.

Kanunay nga Gipangutana nga mga Pangutana (FAQ)

P: Unsa ang akong buhaton kung ang sesyon sa SSH/Telnet dili maestablisar?
A: Kung dili ma-establisar ang session, pag-log in sa device management console aron masusi kung kinahanglan ba nga usbon ang access key.

Bahin Niini nga Panudlo
Kini nga giya naghatag og impormasyon sa anaa nga SSH ug Telnet nga mga sugo sa layo nga pagdumala sa ATEN controllers ug expansion boxes.

IMPORTANTE: Ang pag-configure nga gihimo pinaagi sa interface sa command-line ma-overwrite kung ang usa ka proyekto file gi-upload pinaagi sa ATEN Configurator (GUI) pagkahuman.

Pagtukod ug SSH/Telnet Session

1. Sa kompyuter nga adunay access sa target nga ATEN controller o Expansion Box, pag-download ug SSH/Telnet nga kliyente, eg PuTTY.
   Nota: Para makuha ang installer, pangitaa ang “download putty” sa a web browser.
2. Pagdalagan ang na-download nga kliyente.
3. Aron magtukod og sesyon sa SSH, gamita ang mosunod nga mga setting.
   

   Natad	Setting
   Ngalan sa Host / IP address	IP address o host name sa target controller o expansion box
   Uri sa Koneksyon	SSH
   Dunggoanan	22

   Kay example:

4. Para magtukod ug telnet session, gamita ang mosunod nga mga setting.
   

   Natad	Setting
   Ngalan sa Host / IP address	IP address o ngalan sa host sa target controller o kahon sa pagpalapad
   Uri sa Koneksyon	Uban pa > Telnet
   Dunggoanan	23

   Kay example:

5. I-klik ang Open ug sunda ang mga instruksyon sa screen aron makasulod sa mga kredensyal sa pag-login. Gitukod ang usa ka sesyon. Kay example:

Mubo nga sulat: Kung ang sesyon dili maestablisar, pag-log in sa device management console aron masusi kung kinahanglan ba nga usbon ang access key.

Mga Sugo sa SSH/Telnet

Tabang

• Paggamit:
  Ipakita ang instruksyon alang sa pagpagana sa CLI mode sa controller.
• Syntax:
  tabang↙
• Moila:
  Command OK↙ : Ang command husto ug ang function gipatuman.
  Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.
• Example:
  tabang↙ : ipakita ang instruksyon sa CLI mode

Pag-enable/Pag-disable sa Echo Reply

• Paggamit:
  I-enable o i-disable ang controller aron awtomatikong tubagon ang nadawat nga mga mensahe.
• Syntax:
  echo[kontrol]↙
• Parameter:
  kontrol: on – i-enable kini nga function
  off – disable kini nga function (default kay off)
• Moila:
  Command OK↙ : Ang command husto ug ang function gipatuman.
  Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.
• Example:
  eho on↙ : itakda ang controller aron awtomatikong motubag sa nadawat nga mga mensahe.

Pag-configure sa Telnet Timeout Interval o Login

• Paggamit:
  I-configure ang mga setting sa Telnet CLI mode.
• Syntax:
  telnet[timeout interval][login control]↙
• Keyword
  timeout : Setting sa agwat sa timeout sa sesyon sa Telnet
  login : setting sa pag-login sa Telnet
• Parameter:
  agwat: oras sa sesyon sa minuto. (Ang 0 nagpasabut nga dili gyud mag-timeout) (ang default mao ang 5)
  kontrol: on - i-enable ang function sa pag-login (naka-on ang default)
  off - pag-disable ang function sa pag-login
• Moila:
  Command OK↙ : Ang command husto ug ang function gipatuman.
  Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.
• Example:
  telnet timeout 0↙ : i-configure ang timeout interval aron dili gyud timeout
  telnet timeout 5↙ : i-configure ang timeout interval ngadto sa 5 minutos
  telnet login off↙ : disable ang login function

Pag-configure sa Mga Setting sa Serial Port

Paggamit:
Kontrola ug i-configure ang mga setting sa serial port.

Syntax:
serial [p sequence] [type stype] [baud baudrate] [dbit databit] [parity sparity] [sbit stopbit] [fctrl flowctrl] [dtype datatype] [endchar chars ] [checksumtype checksumtype] [acktimeout duration ] [kontrol ang “data” ] [tabang]↙d

Keyword:

• p: pantalan
• tipo: serial type
• baud : baud rate
• dbit: gamay nga datos
• parity : serial parity
• sbit: hunong na
• fctrl: pagkontrol sa dagan
• dtype: tipo sa datos
• acktimeout : gidugayon sa timeout (ms) gigamit sa paghulat sa feedback gikan sa sendack control.
• endchar : espesipikong katapusan nga karakter gigamit sa pag-ila sa usa ka kompleto nga mensahe.
• checksumtype : kung kinahanglan fw sa auto-calculate command checksum, assign ug checksum type
• tabang: ipakita ang mga panudlo

Parameter:

• han-ay: pantalan, gibulag sa comma alang sa daghang mga pantalan * (tanan nga mga pantalan)
• klase: 232, 422, 485 (default 232)
• baudrate : 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200(default 9600)
• databit: 7, 8 (default 8)
• sparity : wala, bisan, katingad-an (default wala)
• stopbit: 1, 2 (default 1)
• flowctrl: wala, hw (default wala)
• datatype: ascii, hex (default nga ascii)
• checksumtype: wala, modbus (default wala)
• gidugayon : piho nga timeout (ms)(default 300)
• mga karakter : pagtapos sa mga karakter nga nagsunod sa usa ka kompleto nga mensahe.
• kontrol: basaha - ipakita ang nadawat nga mensahe sa piho nga serial port
• pagsulat - ipadala ang datos gikan sa serial port. Gamita ang " simbolo nga naglangkob sa datos. Gamita ang \x nga simbolo aron ipadala ang Hex code
• sendack - ipadala ang datos gikan sa serial port ug ipakita ang nadawat nga mensahe

Ilhangilit:
Command OK↙ : Ang command husto ug ang function gipatuman.
Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.

Example:

• Serial nga tabang ↙ : ipakita ang mga instruksyon
• serial p01 ↙ : ipakita ang impormasyon sa setting sa serial port1.
• serial p* ↙ : ipakita ang impormasyon sa setting sa tanang serial port.
• serial p01 type 232 baud 115200 dbit 8 parity walay sbit 1 fctrl walay ↙ : i-configure ang port1.
• serial p01,04,07 baud 19200 ↙ : i-configure ang port1, 4, 7 ngadto sa baud rate 19200.
• serial p02 baud 19200 ↙ : i-configure ang port2 sa baud 19200 ug gamiton ang default settings para sa ubang mga parameter.
• serial p02 dtype hex read ↙ : ipakita ang nadawat nga mensahe sa port2 sa HEX format.
• serial p03 isulat “sw i01 o02\r\n” ↙ : ipadala ang ASCII text 'sw i01 o02' gikan sa port3.
• serial p03 sendack “sw i01 o02\x0D\x0A” ↙ : ipadala ang ASCII text 'sw i01 o02' gikan sa port3 ug ipakita ang feedback.

Pag-configure sa Mga Setting sa Relay Port

Paggamit:
Pagkontrol ug pag-configure sa mga relay port.

Syntax:
relay [p sequence] [tpulse duration] [kontrol] [tabang] ↙

Keyword:

• p: pantalan
• tpulse : sirado nga panahon para sa pulso
• tabang: ipakita ang mga panudlo

Parameter:

• han-ay: pantalan, gibulag sa comma alang sa daghang mga pantalan
• * (tanan nga pantalan)
• gidugayon : yugto sa panahon sa millisecond.
• kontrol: abli - i-off
• duol - i-on
• pulso – isira ang relay channel unya ablihi
• toggle – relay toggle
• basaha – ipakita ang kahimtang

Moila:
Command OK↙ : Ang command husto ug ang function gipatuman.
Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.

Example:

• tabang sa relay ↙ : ipakita ang mga instruksyon
• relay p01 close ↙ : close port1 channel.
• relay p01 bukas ↙ : bukas nga port1 channel.
• relay p01,04,07 close ↙ : close port 1, 4, 7 relay channels.
• relay p02 tpulse 500 pulse ↙ : close port2 500ms unya abli.
• relay p02 basaha ↙ : ipakita ang port2 status.

Pag-configure sa I/O Port Settings

Paggamit:
Kontrola ug i-configure ang mga I/O port.

Syntax:
io [p sequence] [type iotype] [lthresh threshold] [hthresh threshold] [tpulse duration] [kontrol] [tabang]↙

Keyword:

• p: pantalan
• lthresh : ubos nga bound threshold
• hthresh : taas nga utlanan nga threshold
• tpulse : panahon diin ang I/O nagpabilin sa taas nga lebel sa pulse mode
• tabang: ipakita ang mga panudlo
• PAHINUMDOM: Kung ang usa ka parametro wala gitino, ang usa ka gisulod nga kantidad ang magamit.
• Parameter:
• han-ay: pantalan, gibulag sa comma alang sa daghang mga pantalan
• * (tanan nga pantalan)
• iotype: uga, vdc, dout
• threshold : trigger threshold sa voltage
• gidugayon : yugto sa panahon sa millisecond.
• kontrol: bukas
• duol
• pulso
• toggle
• basaha

Moila:
Command OK↙ : Ang command husto ug ang function gipatuman.
Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.

Example:

• io tabang ↙ : ipakita ang mga instruksyon
• io p01↙ : ipakita ang impormasyon sa setting sa I/O port1.
• io p*↙ : ipakita ang impormasyon sa setting sa tanang I/O ports.
• io p01 type nga uga ↙ : i-configure ang port 1 sa dry contact mode.
• io p01 type dout ↙ : i-configure ang port 1 ngadto sa digital output mode.
• io p01 type vdc lthresh 1 hthresh 3 ↙ : i-configure ang port 1 ngadto sa vdc mode nga adunay mga setting sa threshold.
• io p01 bukas ↙ : bukas nga port1 channel.
• io p01 close ↙ : close port1 channel.
• io p01,04,07 close ↙ : close port1,4,7 channels.
• io p02 tpulse 500 pulse ↙ : close port2 channel 500ms unya abli.
• io p02 basaha ↙ : ipakita ang kahimtang sa port2.

Pag-configure sa Mga Setting sa IR

Paggamit:
Pagkontrol ug pag-configure sa mga IR port.

Syntax:
ir [p sequence] [type irtype] | [baud baudrate] [dbit databit] [parity sparity] [sbit stopbit] [dtype datatype] [checksumtype checksumtype] [kontrol ang “data”] [tabang]↙

Keyword:

• p: pantalan
• tipo: tipo sa output alang sa piho nga port sa output
• baud** : baud rate
• dbit** : gamay nga datos
• parity** : serial parity
• sbit** : hunong gamay
• dtype** : tipo sa datos
• checksumtype** : Ang controller/extension box awtomatik nga nagkalkula sa gipiho nga checksum type
• tabang: ipakita ang mga panudlo

NOTA:
* : Kini nga keyword kay para sa IR type
** : Kini nga mga keyword kay para sa 232 type

Kung ang usa ka parameter wala gitino, ang usa ka kaniadto nga gisulod nga kantidad magamit.

Parameter:

• han-ay: pantalan, gibulag sa comma alang sa daghang mga pantalan * (tanan nga mga pantalan)
• irtype: ir, 232(default ir)
• baudrate : 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200(default 9600)
• databit: 7, 8(default 8)
• sparity: wala, bisan, katingad-an (default wala)
• stopbit: 1, 2(default 1)
• datatype: ascii, hex(default nga ascii)
• checksumtype: wala, modbus(default walay)
• kontrol: pagsulat - ipadala IR code o RS232 data

Moila:
Command OK↙ : Ang command husto ug ang function gipatuman.
Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.

Example:

• ir tabang ↙ : ipakita ang mga instruksyon
• ir p01 ↙ : ipakita ang impormasyon sa setting sa IR port1.
• ir p* ↙ : ipakita ang impormasyon sa setting sa tanang IR ports.
• ir p01,04,07 type 232 ↙ : i-configure ang port1,4,7 ngadto sa RS232 type
• ir p01 type 232 baud 115200 dbit 8 parity walay sbit 1 checksum type modbus↙ : i-configure ang port1 sa RS232 type ug ang mga setting
• ir p02 isulat ang dtype hex “0a0b0c” ↙ : ipadala hex format data 0a0b0c gikan sa port2
• ir p02 baud 19200 ↙ : i-configure ang port2 sa baud 19200 ug gamita ang default setting para sa ubang mga parameter.
• ir p02 isulat ang “sw i01 o02\r\n” ↙ : ipadala ang ASCII text 'sw i01 o02' gikan sa port2.
• ir p02 isulat ang “sw i01 o02\x0D\x0A”↙ : ipadala ang ASCII text nga 'sw i01 o02' gikan sa port2.

Pag-reboot

Paggamit:
I-reboot ang controller.

Syntax:
reboot↙

Moila:
Command OK↙ : Ang command husto ug ang function gipatuman.
Sayop ang sugo↙ : Ang sugo ug/o mga parametro dili husto ug wala gipatuman.

Example:
reboot↙ : reboot device

Mga Dokumento / Mga Kapanguhaan

ATEN Command Line Interface [pdf] Giya sa Gumagamit Interface sa Command Line, Interface sa Linya, Interface

Mga pakisayran

• Manwal sa Gumagamit