20.3. Activating IOBOX devices

20.3. Activating IOBOX devices
	Chapter 20. IOBOX

20.3.1. Activating the GPIO device and the IOHUB resource

Add the GPIO device and IOHUB resource with the following commands:

[11:43:32] ABILIS_CPX:a dev:gpio-1

COMMAND EXECUTED

[11:43:33] ABILIS_CPX:a res:iohub

COMMAND EXECUTED

	Note
	IOHUB resource is required to enable web sections: Automation and Automation Log.

	Caution
	Remember to save the configuration using save conf and an Abilis restart are required (i.e. With warm start command).

The IOLOG must be activated with the commands:

[09:43:22] ABILIS_CPX:s p iohub iolog-act:yes

COMMAND EXECUTED

[14:38:24] ABILIS_CPX:d p iohub

RES:IoHub ---------------------------------------------------------------------
Run    DESCR:I/O_Hub_Driver
       LOG:NO        
       wdir:C:\APP\IO\
       - I/O Web Control ------------------------------------------------------
       WEBCTL-ACT:YES        webctl-maxclients:10   
       WEBCTL-XML-TOUT:60    WEBCTLXML-MIN-DELAY:50
       - I/O Log Service ------------------------------------------------------
       IOLOG-ACT:YES         iolog-size:SMALL (~50,000)

Meaning of the most important parameters:

IOLOG-ACT

Enable/disable IOLOG service [NO, YES].

iolog-size

Number of records in IOLOG database [TINY, SMALL, MEDIUM, LARGE, HUGE], where:

TINY corresponds to approximately 10,000 records;
SMALL corresponds to approximately 50,000 records;
MEDIUM corresponds to approximately 200,000 records;
LARGE corresponds to approximately 500,000 records;
HUGE corresponds to approximately 1,000,000 records.

	Tip
	Interesting chapter: Section 72.22, “Automation log”.

Use the following command to display resource parameters; the command d p gpio-1 ? displays the meaning of all parameters.

[10:10:53] ABILIS_CPX:d p gpio-1
RES:Gpio-1 --------------------------------------------------------------------
Run    DESCR:
       LOG:NO               ACT:YES              LIVE-EXPIRY:10
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       1      | 1
       2      | 2
       3      | 3
       4      | 4
       5      | 7
       6      | 5
       7      | 6
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:
       -------+----------------------------------------------------------------
       1      | 1
       2      | 2
       3      | 3
       4      | 4
       -------+-------------------- Analog Input lines ------------------------
       A-IN:  | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:  UPD:    POLL:
       -------+----------------------------------------------------------------
       1      | C        20      21      20      21      5.0     1.0     1.0
       2      | C        -10     40      0.0     40      5.0     1.0     1.0
       ------------------------------------------------------------------------

	Important
	The D P GPIO command shows only the lines which have been configured with a description or that have the parameters different from the default. To enforce the view of all theoretically possible 64 digital inputs, 64 digital outputs, 16 analog inputs, use D PE GPIO command.

Meaning of the I/O Digital lines parameters:

D-IN: Digital Input Line identifier [1..64].
D-OUT: Digital output Line identifier [1..64].
MODE: Operational mode [VALUE, PULSE].
PULSE-T: Duration of ON pulse [1..4294967295 ms]. Only for MODE:PULSE.
PULSE-GAP: Minimum OFF time after ON pulse [1..65535 ms]. Only for MODE:PULSE.

Meaning of the Analog Input Lines parameters:

A-IN: Analog Input Line identifier [1..16].
UNIT: Unit of subsequent values. Empty or max 8 characters (e.g. kWh, J, Volts, m, km, miles, myunit). Case is preserved.
MIN: Value corresponding to 0x0000. It must be < MAX. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
MAX: Value corresponding to 0x03FF. It must be > MIN. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
ALM-LO: Low threshold for alarm. It must be < ALM-HI and >= MIN, autoadjust against MIN. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
ALM-HI: High threshold for alarm. It must be > ALM-LO and <= MAX, autoadjust against MAX. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
HYST: Hysteresis for ALM-LO and ALM-HI for returning to NORMAL state. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
UPD: Difference that must occur between the last value delivered and the current value read in order to make a new value delivery. Absolute value, valid for positive and negative variations. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
POLL: Polling period [0.1..300.0 sec].

The following command allows the administrator to change the configuration of the resource:

s p gpio-1 parameter:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:gpio; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).

Example: to set a pulse of 500 ms on Digital Out number 1 to open the Gate #1 type the following command:

[12:38:32] ABILIS_CPX:s p gpio-1 d-out:1 descr:Gate#1 mode:pulse pulse-t:500

COMMAND EXECUTED

Initialize the device and save the configuration with init res:gpio-1 and save conf .

[18:50:51] ABILIS_CPX:d p gpio-1

RES:Gpio-1 - Not Saved (SAVE CONF), Not Refreshed (INIT) ----------------------
       ------------------------------------------------------------------------
Run    DESCR:
       LOG:NO               ACT:YES              LIVE-EXPIRY:10
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       1      | 1
       2      | 2
       3      | 3
       4      | 4
       5      | 7
       6      | 5
       7      | 6
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:
       -------+----------------------------------------------------------------
       1      | Gate#1
              | PULSE    500          250

The GPIO resource allows viewing the state of each digital input/output line and to read values from analog inputs.

[13:44:42] ABILIS_CPX:d d gpio-1

RES:Gpio-1 --------------------------------------------------------------------
       STATE:UP             USB-STATE:CONNECTED      
       - Digital Input Lines State --------------------------------------------
        1..16| off off off off off off off off .   .   .   .   .   .   .   .   
       17..32| .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   
       33..48| .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   
       49..64| .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1..16| off off off off .   .   .   .   .   .   .   .   .   .   .   .   
       17..32| .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   
       33..48| .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   
       49..64| .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   .   
       ------------------------------------------------------------------------
       - Analog Input Lines ---------------------------------------------------
             | State  Value   Unit     ADC    | State  Value   Unit     ADC
       ------+--------------------------------+--------------------------------
        1.. 2| LOW    0.0     %        1      | LOW    0.0     %        1      
        3.. 4| .      .       .        .      | .      .       .        .      
        5.. 6| .      .       .        .      | .      .       .        .      
        7.. 8| .      .       .        .      | .      .       .        .      
        9..10| .      .       .        .      | .      .       .        .      
       11..12| .      .       .        .      | .      .       .        .      
       13..14| .      .       .        .      | .      .       .        .      
       15..16| .      .       .        .      | .      .       .        .      
       ------------------------------------------------------------------------

The GPIO resource permits to pilot the digital output state typing the command:

[11:14:46] ABILIS_CPX:s s res:gpio-1 d-out:1 ON

COMMAND EXECUTED

[19:03:43] ABILIS_CPX:s s res:gpio-1 d-out: ?

S S RES:Gpio-n D-OUT:val ON|OFF     Set status of Digital Output Line [ON, OFF]
                                    of the specified Gpio resource

D-OUT:     One value in the range [1..64] or a range of values 'xx-yy'
           or a list of values 'xx,yy,...' separated by ',' (comma) or
           "A" or "ALL".

	Tip
	Information about management I/O via WEB Chapter 81, Automation.

	Tip
	Interesting chapter: Section 72.22, “Automation log”.

20.3.2. Activating the MFIO resource

Add the MFIO and IOHUB resource with the following command:

[12:34:17] ABILIS_CPX:a res:mfio

COMMAND EXECUTED

[11:43:33] ABILIS_CPX:a res:iohub

COMMAND EXECUTED

	Note
	IOHUB resource is required to enable web sections: Automation and Automation Log.

	Caution
	Remember to save the configuration using save conf and an Abilis restart are required (i.e. With warm start command).

The MFIO resources must be activated with the command:

[12:38:18] ABILIS_CPX:s p mfio act:yes    

COMMAND EXECUTED

Use the following command to display resource parameters; the command d p mfio ? displays the meaning of all parameters.

[12:38:27] ABILIS_CPX:d p mfio

RES:MfIo ----------------------------------------------------------------------
Run    DESCR:Abilis_Multi_Function_IO_Interface
       LOG:DS        ACT:YES  
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:
       -------+----------------------------------------------------------------
       1      | Gate#
              | PULSE    500          250
       2      | Test
       ------------------------------------------------------------------------

	Important
	The D P MFIO command shows only the lines which have been configured with a description or that have the parameters different from the default. To enforce the view of all, use D PE MFIO command.

Meaning of the most important parameters:

LOG: State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes).
ACT: Operation activation [NO, YES].
D-IN: Digital Input Line identifier [1..7].
D-OUT: Digital output Line identifier [1..7].
MODE: Operational mode [VALUE, PULSE].
PULSE-T: Duration of ON pulse [1..4294967295 ms]. Only for MODE:PULSE.
PULSE-GAP: Minimum OFF time after ON pulse [1..65535 ms]. Only for MODE:PULSE.

The following command allows the administrator to change the configuration of the resource:

s p mfio parameter:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:mfio; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).

Example: to set a pulse of 500 ms on Digital Out number 1 to open the Gate #1 type the following command:

[12:38:32] ABILIS_CPX:s p mfio d-out:1 descr:Gate#1 mode:pulse pulse-t:500

COMMAND EXECUTED

Initialize the device and save the configuration with init res:mfio and save conf .

[18:50:51] ABILIS_CPX:d p mfio

RES:MfIo ----------------------------------------------------------------------
Run    DESCR:Abilis_Multi_Function_IO_Interface
       LOG:DS        ACT:YES  
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:
       -------+----------------------------------------------------------------
       1      | Gate#
              | PULSE    500          250
       ------------------------------------------------------------------------

The MFIO resource allows viewing the state of each digital input/output line.

[08:29:04] ABILIS_CPX:d d mfio

RES:MfIo ----------------------------------------------------------------------
       Abilis_Multi_Function_IO_Interface                                      
       STATE:ACTIVE
       - Digital Input Lines State --------------------------------------------
        1..7| off off off off off off off 
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1..7| off off off off off off off 
       ------------------------------------------------------------------------

The MFIO resource permits to pilot the digital output state typing the command:

[11:14:46] ABILIS_CPX:s s res:mfio d-out:1 ON

COMMAND EXECUTED

[19:03:43] ABILIS_CPX:s s res:mfio d-out: ?

S S RES:Mfio-n D-OUT:val ON|OFF     Set status of Digital Output Line [ON, OFF]
                                    of the specified Gpio resource

D-OUT:     One value in the range [1..64] or a range of values 'xx-yy'
           or a list of values 'xx,yy,...' separated by ',' (comma) or
           "A" or "ALL".

	Tip
	Information about management I/O via WEB: Chapter 81, Automation.

	Tip
	Interesting chapter: Section 72.22, “Automation log”.

20.3.3. Activating the RVS device

The RVS device is added from the web interface, please see Section 72.24, “Rio/Rvs configuration”.

Add the IOHUB resource with the following command:

[11:43:33] ABILIS_CPX:a res:iohub

COMMAND EXECUTED

	Note
	IOHUB resource is required to enable web sections: Automation and Automation Log.

	Caution
	Remember to save the configuration using save conf and an Abilis restart are required (i.e. With warm start command).

Use the following command to display resource parameters; the command d p rvs ? displays the meaning of all parameters.

[13:57:34] ABILIS_CPX:d p rvs   

RES:Rvs-1 ---------------------------------------------------------------------
Run    DESCR:
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:B8-27-EB-93-FA-DF   IPRES:Ip-3    
       IPADD:192.168.029.101   MASK:255.255.255.000   GW:192.168.029.254
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
       -------+----------------------------------------------------------------
...

	Important
	The D P RVS command shows only the lines which have been configured with a description or that have the parameters different from the default. To enforce the view of all, use D PE RVS command.

Meaning of the most important parameters:

ACT: Operation activation [NO, YES].
D-IN: Digital Input Line identifier [1..7].
D-OUT: Digital output Line identifier [1..7].
MODE: Operational mode [VALUE, PULSE].
PULSE-T: Duration of ON pulse [1..4294967295 ms]. Only for MODE:PULSE.
PULSE-GAP: Minimum OFF time after ON pulse [1..65535 ms]. Only for MODE:PULSE.
START: Initial value to be applied when Abilis connects to the device [LAST, DFT]. If "LAST" and the last value is unknown or was lost, the value specified in DFT will be used.
DFT: Default value to be used when there is not a known and valid value to set [OFF, ON].

The following command allows the administrator to change the configuration of the resource:

s p rvs-1 parameter:value...

	Caution
	To activate the changes made, execute the initialization command init res:rvs.

Example: to set a pulse of 500 ms on Digital Out number 1 to open the Gate #1 type the following command:

[12:38:32] ABILIS_CPX:s p rvs-1 d-out:1 descr:Gate#1 mode:pulse pulse-t:500

COMMAND EXECUTED

Initialize the device and save the configuration with init res:rvs-1 and save conf .

[18:50:51] ABILIS_CPX:d p rvs-1

RES:Rvs-1 ---------------------------------------------------------------------
Run    DESCR:
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:B8-27-EB-93-FA-DF   IPRES:Ip-3    
       IPADD:192.168.029.101   MASK:255.255.255.000   GW:192.168.029.254
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
       -------+----------------------------------------------------------------
       1      | Gate#1
              | PULSE    500         250           LAST   OFF
       -------+-------------------------- Cameras -----------------------------
...

The RVS device allows viewing the state of each digital input/output line.

[14:13:21] ABILIS_CPX:d d rvs-1

RES:Rvs-1 ---------------------------------------------------------------------
       STATE:UP                   MAC:B8-27-EB-93-FA-DF
       RemAdd-RemPort:192.168.029.101-41414
       CURRENT-IMAGE:5.000        FACTORY-IMAGE:5.000     BOARD:0.0
       - Digital Input Lines State --------------------------------------------
        1.. 4| ON  ON  ON  ON  
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1.. 4| off off off off 
       ------------------------------------------------------------------------

The RVS resource permits to pilot the digital output state typing the command:

[14:16:43] ABILIS_CPX:s s res:rvs-1 d-out:2 ON

COMMAND EXECUTED 

[14:16:59] ABILIS_CPX:s s res:rvs-1 d-out: ?  

S S RES:Rvs-n D-OUT:val ON|OFF      Set status of Digital Output Line [ON, OFF]
                                    of the specified Rvs resource

D-OUT:     One value in the range [1..4] or a range of values 'x-y'
           or a list of values 'x,y,...' separated by ',' (comma) or 
           A or ALL. 

[14:17:06] ABILIS_CPX:d d rvs-1               

RES:Rvs-1 ---------------------------------------------------------------------
       STATE:UP                   MAC:B8-27-EB-93-FA-DF
       RemAdd-RemPort:192.168.029.101-41414
       CURRENT-IMAGE:5.000        FACTORY-IMAGE:5.000     BOARD:0.0
       - Digital Input Lines State --------------------------------------------
        1.. 4| ON  ON  ON  ON  
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1.. 4| off ON  off off 
       ------------------------------------------------------------------------
...

	Tip
	Information about management I/O via WEB: Chapter 81, Automation.

Tip

Interesting chapters:

Section 2.16.1, “RVS - Remote Video Surveillance”;

Section 3.12, “RVS connection”;

Section 81.2.1, “Example of LUA Script to pilot digital outputs of RIO device”;

Section 72.22, “Automation log”.

20.3.4. Activating the RIO device

Add the IO and IOHUB resource with the following command:

[12:34:17] ABILIS_CPX:a res:io

COMMAND EXECUTED

[11:43:33] ABILIS_CPX:a res:iohub

COMMAND EXECUTED

	Note
	IOHUB resource is required to enable web sections: Automation and Automation Log.

	Caution
	Remember to save the configuration using save conf and an Abilis restart are required (i.e. With warm start command).

The RIO device is added from the web interface, please see Section 72.24, “Rio/Rvs configuration”.

Use the following command to display resource parameters; the command d p rio ? displays the meaning of all parameters.

[13:57:34] ABILIS_CPX:d p rio   

Run    DESCR:RIO
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:B8-27-EB-12-F7-FB   IPRES:Ip-1    
       IPADD:192.168.001.222   MASK:255.255.255.000   GW:192.168.001.001
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
       -------+----------------------------------------------------------------
       2      | Porta Ingresso
              | PULSE    500         500           LAST   OFF
       3      | Porta Retro
              | PULSE    500         500           LAST   OFF
       4      | Cancellino
              | PULSE    500         500           LAST   OFF
       -------+-------------------- Analog Input lines ------------------------
       A-IN:  | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   UPD:    POLL:
       -------+----------------------------------------------------------------
       -------+-------------------- Analog Output lines -----------------------
       A-OUT: | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   UPD:    POLL:
              |          CUT-LO: CUT-HI: START:  DFT:
       -------+----------------------------------------------------------------

Important

The D P RIO command shows only the lines which have been configured with a description or that have the parameters different from the default. To enforce the view of all theoretically possible 16 digital inputs, 16 digital outputs, 8 analog inputs, 8 analog outputs, use D PE RIO command.

[13:57:34] ABILIS_CPX:d pe rio

RES:Rio-1 ---------------------------------------------------------------------
Run    DESCR:RIO
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:B8-27-EB-12-F7-FB   IPRES:Ip-1    
       IPADD:192.168.001.222   MASK:255.255.255.000   GW:192.168.001.001
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | DESCR:
       -------+----------------------------------------------------------------
       1      | 
       2      | 
       3      | 
       4      | 
       5      | 
       6      | 
       7      | 
       8      | 
       9      | 
       10     | 
       11     | 
       12     | 
       13     | 
       14     | 
       15     | 
       16     | 
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
       -------+----------------------------------------------------------------
       1      | Cancello
              | PULSE    500         500           LAST   OFF
       2      | Porta Ingresso
              | PULSE    500         500           LAST   OFF
       3      | Porta Retro
              | PULSE    500         500           LAST   OFF
       4      | Cancellino
              | PULSE    500         500           LAST   OFF
       5      | VALUE                              LAST   OFF
       6      | VALUE                              LAST   OFF
       7      | VALUE                              LAST   OFF
       8      | VALUE                              LAST   OFF
       9      | VALUE                              LAST   OFF
       10     | VALUE                              LAST   OFF
       11     | VALUE                              LAST   OFF
       12     | VALUE                              LAST   OFF
       13     | VALUE                              LAST   OFF
       14     | VALUE                              LAST   OFF
       15     | VALUE                              LAST   OFF
       16     | VALUE                              LAST   OFF
       -------+-------------------- Analog Input lines ------------------------
       A-IN:  | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   UPD:    POLL:
       -------+----------------------------------------------------------------
       1      | %        0.0     100.0   -       -       5.0     1.0     1.0
       2      | %        0.0     100.0   -       -       5.0     1.0     1.0
       3      | %        0.0     100.0   -       -       5.0     1.0     1.0
       4      | %        0.0     100.0   -       -       5.0     1.0     1.0
       5      | %        0.0     100.0   -       -       5.0     1.0     1.0
       6      | %        0.0     100.0   -       -       5.0     1.0     1.0
       7      | %        0.0     100.0   -       -       5.0     1.0     1.0
       8      | %        0.0     100.0   -       -       5.0     1.0     1.0
       -------+-------------------- Analog Output lines -----------------------
       A-OUT: | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   UPD:    POLL:
              |          CUT-LO: CUT-HI: START:  DFT:
       -------+----------------------------------------------------------------
       1      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       2      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       3      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       4      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       5      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       6      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       7      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       8      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       LAST    0.0     
       ------------------------------------------------------------------------

Meaning of the I/O Digital lines parameters:

D-IN: Digital Input Line identifier [1..7].
D-OUT: Digital output Line identifier [1..7].
MODE: Operational mode [VALUE, PULSE].
PULSE-T: Duration of ON pulse [1..4294967295 ms]. Only for MODE:PULSE.
PULSE-GAP: Minimum OFF time after ON pulse [1..65535 ms]. Only for MODE:PULSE.
START: Initial value to be applied when Abilis connects to the device [LAST, DFT]. If "LAST" and the last value is unknown or was lost, the value specified in DFT will be used.
DFT: Default value to be used when there is not a known and valid value to set [OFF, ON].

Meaning of the Analog Input Lines parameters:

A-IN: Analog Input Line identifier [1..16].
UNIT: Unit of subsequent values. Empty or max 8 characters (e.g. kWh, J, Volts, m, km, miles, myunit). Case is preserved.
MIN: Value corresponding to 0x0000. It must be < MAX. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
MAX: Value corresponding to 0x03FF. It must be > MIN. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
ALM-LO: Low threshold for alarm. It must be < ALM-HI and >= MIN, autoadjust against MIN. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
ALM-HI: High threshold for alarm. It must be > ALM-LO and <= MAX, autoadjust against MAX. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
HYST: Hysteresis for ALM-LO and ALM-HI for returning to NORMAL state. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
UPD: Difference that must occur between the last value delivered and the current value read in order to make a new value delivery. Absolute value, valid for positive and negative variations. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
POLL: Polling period [0.1..300.0 sec].

Meaning of the Analog Output Lines parameters:

The same parameters as Analog Input and also:

CUT-LO: Lowest allowed value. It must be < CUT-HI. String representing a floating point number from -9998 to +9998, or an empty string to disable it. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
CUT-HI: Highest allowed value. It must be > CUT-LO. String representing a floating point number from -9998 to +9998, or an empty string to disable it. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].
START: Initial value to be applied when Abilis connects to the device [LAST, DFT]. If "LAST" and the last value is unknown or was lost, the value specified in DFT will be used.
DFT: Default value to be used when there is not a known and valid value to set. It must be >= MIN and =< MAX. String representing a floating point number from -9999 to +9999. From 1 up to 6 characters in ['+', '-', '0'..'9', '.'].

The following command allows the administrator to change the configuration of the resource:

s p rio-1 parameter:value...

	Caution
	To activate the changes made, execute the initialization command init res:rio.

Example: to set a pulse of 500 ms on Digital Out number 1 to open the Gate #1 type the following command:

[12:38:32] ABILIS_CPX:s p rio-1 d-out:1 descr:Gate#1 mode:pulse pulse-t:500

COMMAND EXECUTED

Initialize the device and save the configuration with init res:rio-1 and save conf .

[18:50:51] ABILIS_CPX:d p rio-1

RES:Rio-1 ---------------------------------------------------------------------
Run    DESCR:RIO
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:B8-27-EB-12-F7-FB   IPRES:Ip-1    
       IPADD:192.168.001.222   MASK:255.255.255.000   GW:192.168.001.001
       -------+-------------------- Digital Input lines -----------------------
       D-IN:  | [DESCR:]
       -------+----------------------------------------------------------------
       -------+-------------------- Digital Output lines ----------------------
       D-OUT: | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
       -------+----------------------------------------------------------------
       1      | Gate#1
              | PULSE    500         250           LAST   OFF
       2      | Porta Ingresso
              | PULSE    500         500           LAST   OFF
       3      | Porta Retro
              | PULSE    500         500           LAST   OFF
       4      | Cancellino
              | PULSE    500         500           LAST   OFF
       -------+-------------------- Analog Input lines ------------------------
       A-IN:  | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   UPD:    POLL:
       -------+----------------------------------------------------------------
       -------+-------------------- Analog Output lines -----------------------
       A-OUT: | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   UPD:    POLL:
              |          CUT-LO: CUT-HI: START:  DFT:
       -------+----------------------------------------------------------------

The RIO resource allows viewing the state of each digital input/output line.

[14:13:21] ABILIS_CPX:d d rio-1

RES:Rio-1 ---------------------------------------------------------------------
       RIO                                                                     
       STATE:UP                   MAC:B8-27-EB-12-F7-FB
       RemAdd-RemPort:192.168.001.222-41414
       CURRENT-IMAGE:5.001        FACTORY-IMAGE:5.001     BOARD:1.6
       - Digital Input Lines State --------------------------------------------
        1.. 8| ON  ON  ON  ON  ON  ON  ON  ON  
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1.. 8| off off off off off off off off 
       ------------------------------------------------------------------------
       - Analog Input Lines ---------------------------------------------------
             | State  Value   Unit     ADC    | State  Value   Unit     ADC
       ------+--------------------------------+--------------------------------
        1.. 2| NORMAL   50.0  %        2048   | NORMAL   50.0  %        2048   
        3.. 4| NORMAL   50.0  %        2048   | NORMAL   50.0  %        2048   
       ------------------------------------------------------------------------
       - Analog Output Lines --------------------------------------------------
             | State  Value   Unit     ADC    | State  Value   Unit     ADC
       ------+--------------------------------+--------------------------------
        1.. 2| NORMAL    0.0  %        0      | NORMAL    0.0  %        0      
        3.. 4| NORMAL    0.0  %        0      | NORMAL    0.0  %        0      
       ------------------------------------------------------------------------

The RIO resource permits to pilot digital/analog outputs state typing the command:

[14:16:43] ABILIS_CPX:s s res:rio-1 d-out:2 ON

COMMAND EXECUTED 

[14:16:59] ABILIS_CPX:s s res:rio-1 ?  

 S RES:Rio-n D-OUT:val ON|OFF      Set status of Digital Output Line [ON, OFF]
                                    of the specified Rio resource
S S RES:Rio-n A-OUT:val <num>       Set value of Analog Output Line of the
                                    specified Rio resource.

	Tip
	Information about management I/O via WEB: Chapter 81, Automation.

Tip

Interesting chapters:

Section 2.16.2, “RIO - Remote I/O”;

Section 3.13, “RIO connection”;

Section 81.2.1, “Example of LUA Script to pilot digital outputs of RIO device”;

Section 72.22, “Automation log”.


20.2. Physical connections		20.4. RIO Sonoff WiFi Configuration