21.3. Activating IOBOX devices
Prev Chapter 21. IOBOX Next

21.3. Activating IOBOX devices

21.3.1. Activating the RVS device

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

Add the IOHUB resource with the following command:

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

COMMAND EXECUTED
[Note]Note

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

[Caution]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]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]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]Tip

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

[Tip]Tip

Interesting chapters:

Section 2.16.1, “RVS - Remote Video Surveillance”;

Section 3.13, “RVS connection”;

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

Section 73.22, “Automation log”.

21.3.2. 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]Note

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

[Caution]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 73.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   

RES:Rio-1 ---------------------------------------------------------------------
Run    DESCR:RIO UNO
       LOG:DS                  ACT:YES                DI-CONTACT:NC
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:02-81-F8-42-24-10   IPRES:Ip-1    
       IPADD:192.168.027.211   MASK:255.255.255.000   GW:192.168.027.254
       -------+----------------------------------------------------------------
       DI:    | [DESCR:]
              | DFT:  EVENT-THR: ALERT: ALERT-ST:
       -------+----------------------------------------------------------------
       2      | UG4
       6      | UG2
       7      | UP
       -------+----------------------------------------------------------------
       DO:    | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
              | CONTROL-D:           CONTROL-D-ST: ALERT: ALERT-ST:
       -------+----------------------------------------------------------------
       1      | cancello
              | PULSE    300         250           DFT    OFF
              | #                    #             NO     #
       2      | PULSE    3000        250           DFT    OFF
              | #                    #             NO     #
       3      | caldaia
              | PULSE    14400000    250           DFT    OFF
              | #                    #             NO     #
       4      | faro corte
              | PULSE    300000      250           LAST   OFF
              | #                    #             NO     #
       9      | Uff.G2
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-2           OFF           NO     #
       10     | Uff.G4
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-6           OFF           NO     #
       11     | Uff.P
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-7           OFF           NO     #
       -------+----------------------------------------------------------------
       AI:    | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   SENSIT: POLL:
              |          DFT:    GAIN:   ALERT-ALM-LO:   ALERT-ALM-HI:
       -------+----------------------------------------------------------------
       -------+----------------------------------------------------------------
       AO:    | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   SENSIT: POLL:
              |          CUT-LO: CUT-HI: ALERT-ALM-LO:   ALERT-ALM-HI:
              |          START:  DFT:
       -------+----------------------------------------------------------------
[Important]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 UNO
       LOG:DS                  ACT:YES                DI-CONTACT:NC
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:02-81-F8-42-24-10   IPRES:Ip-1    
       IPADD:192.168.027.211   MASK:255.255.255.000   GW:192.168.027.254
       -------+----------------------------------------------------------------
       DI:    | [DESCR:]
              | DFT:  EVENT-THR: ALERT: ALERT-ST:
       -------+----------------------------------------------------------------
       1      | OFF   60         NO     #
       2      | UG4
              | OFF   60         NO     #
       3      | OFF   60         NO     #
       4      | OFF   60         NO     #
       5      | OFF   60         NO     #
       6      | UG2
              | OFF   60         NO     #
       7      | UP
              | OFF   60         NO     #
       8      | OFF   60         NO     #
       9      | OFF   60         NO     #
       10     | OFF   60         NO     #
       11     | OFF   60         NO     #
       12     | OFF   60         NO     #
       13     | OFF   60         NO     #
       14     | OFF   60         NO     #
       15     | OFF   60         NO     #
       16     | OFF   60         NO     #
       -------+----------------------------------------------------------------
       DO:    | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
              | CONTROL-D:           CONTROL-D-ST: ALERT: ALERT-ST:
       -------+----------------------------------------------------------------
       1      | cancello
              | PULSE    300         250           DFT    OFF
              | #                    #             NO     #
       2      | PULSE    3000        250           DFT    OFF
              | #                    #             NO     #
       3      | caldaia
              | PULSE    14400000    250           DFT    OFF
              | #                    #             NO     #
       4      | faro corte
              | PULSE    300000      250           LAST   OFF
              | #                    #             NO     #
       5      | VALUE                              LAST   OFF
              | #                    #             NO     #
       6      | VALUE                              LAST   OFF
              | #                    #             NO     #
       7      | VALUE                              LAST   OFF
              | #                    #             NO     #
       8      | VALUE                              LAST   OFF
              | #                    #             NO     #
       9      | Uff.G2
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-2           OFF           NO     #
       10     | Uff.G4
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-6           OFF           NO     #
       11     | Uff.P
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-7           OFF           NO     #
       12     | VALUE                              LAST   OFF
              | #                    #             NO     #
       13     | VALUE                              LAST   OFF
              | #                    #             NO     #
       14     | VALUE                              LAST   OFF
              | #                    #             NO     #
       15     | VALUE                              LAST   OFF
              | #                    #             NO     #
       16     | VALUE                              LAST   OFF
              | #                    #             NO     #
       -------+----------------------------------------------------------------
       AI:    | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   SENSIT: POLL:
              |          DFT:    GAIN:   ALERT-ALM-LO:   ALERT-ALM-HI:
       -------+----------------------------------------------------------------
       1      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       2      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       3      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       4      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       5      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       6      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       7      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       8      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          
              |          0.0     X1      NO              NO
       -------+----------------------------------------------------------------
       AO:    | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   SENSIT: POLL:
              |          CUT-LO: CUT-HI: ALERT-ALM-LO:   ALERT-ALM-HI:
              |          START:  DFT:
       -------+----------------------------------------------------------------
       1      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       NO              NO
              |          LAST    0.0     
       2      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       NO              NO
              |          LAST    0.0     
       3      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       NO              NO
              |          LAST    0.0     
       4      | %        0.0     100.0   -       -       5.0     1.0     1.0
              |          -       -       NO              NO
              |          LAST    0.0     
       ------------------------------------------------------------------------

Meaning of the I/O Digital lines parameters:

DI

Digital Input Line identifier [1..7].

DO

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:

AI

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]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 UNO
       LOG:DS                  ACT:YES                DI-CONTACT:NC
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:02-81-F8-42-24-10   IPRES:Ip-1    
       IPADD:192.168.027.211   MASK:255.255.255.000   GW:192.168.027.254
       -------+----------------------------------------------------------------
       DI:    | [DESCR:]
              | DFT:  EVENT-THR: ALERT: ALERT-ST:
       -------+----------------------------------------------------------------
       2      | UG4
       6      | UG2
       7      | UP
       -------+----------------------------------------------------------------
       DO:    | [DESCR:]
              | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:
              | CONTROL-D:           CONTROL-D-ST: ALERT: ALERT-ST:
       -------+----------------------------------------------------------------
       1      | Gate#1
              | PULSE    500         250           DFT    OFF
              | #                    #             NO     #
       2      | PULSE    3000        250           DFT    OFF
              | #                    #             NO     #
       3      | caldaia
              | PULSE    14400000    250           DFT    OFF
              | #                    #             NO     #
       4      | faro corte
              | PULSE    300000      250           LAST   OFF
              | #                    #             NO     #
       9      | Uff.G2
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-2           OFF           NO     #
       10     | Uff.G4
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-6           OFF           NO     #
       11     | Uff.P
              | PULSE    14400000    250           DFT    OFF
              | Rio-1,DI-7           OFF           NO     #
       -------+----------------------------------------------------------------
       AI:    | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   SENSIT: POLL:
              |          DFT:    GAIN:   ALERT-ALM-LO:   ALERT-ALM-HI:
       -------+----------------------------------------------------------------
       -------+----------------------------------------------------------------
       AO:    | [DESCR:]
              | UNIT:    MIN:    MAX:    ALM-LO: ALM-HI: HYST:   SENSIT: POLL:
              |          CUT-LO: CUT-HI: ALERT-ALM-LO:   ALERT-ALM-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 UNO                                                                 
       STATE:UP                   MAC:02-81-F8-42-24-10   IPRES:Ip-1
       RemAdd-RemPort:192.168.027.211-41414
       HW-DESCR:Xunlong Orange Pi One                     HW-ID:opi-one
       FW-VER:5.6                 FACTORY-FW-VER:5.6      BOARD:1.0
       Lines summary:  DI:16  DO:16  AI:8  AO:4
       - Digital Input Lines State --------------------------------------------
        1..16| ON  ON  ON  ON  ON  ON  ON  ON  off off off off off off off off 
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1..16| off off off off off ON  ON  ON  off off off off off off off off 
       ------------------------------------------------------------------------
       - Analog Input Lines ---------------------------------------------------
             | State  Value   Unit     ADC    | State  Value   Unit     ADC
       ------+--------------------------------+--------------------------------
        1.. 2| NORMAL   49.9  %        2042   | NORMAL   49.9  %        2045   
        3.. 4| NORMAL   49.9  %        2045   | NORMAL   49.7  %        2034   
        5.. 6| NORMAL   50.1  %        2053   | NORMAL   50.0  %        2049   
        7.. 8| NORMAL   50.0  %        2047   | NORMAL   49.9  %        2045   
       ------------------------------------------------------------------------
       - Analog Output Lines --------------------------------------------------
             | State  Value   Unit     ADC    | State  Value   Unit     ADC
       ------+--------------------------------+--------------------------------
        1.. 2| NORMAL   21.8  %        892    | 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 do:2 ON

COMMAND EXECUTED 

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

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

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

[Tip]Tip

Interesting chapters:

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

Section 3.14, “RIO connection”;

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

Section 73.22, “Automation log”.

21.3.3. Activating the WIO device

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

Add the IOHUB resource with the following command:

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

COMMAND EXECUTED
[Note]Note

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

[Caution]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 wio ? displays the meaning of all parameters.

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

RES:Wio-1 ---------------------------------------------------------------------
Run    DESCR:Wio-1
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:02-42-DB-91-D4-29   IPRES:Ip-1    
       IPADD:192.168.029.103   MASK:255.255.255.000   GW:192.168.029.254
       ------------------------------------------------------------------------
       SLAVE: | DESCR:          HWADDR:                  ALERT-NA:
       -------+----------------------------------------------------------------
         DO:  | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:  DESCR:
              | CONTROL-D:           CONTROL-D-ST: ALERT: ALERT-ST:
       1      |                 00-12-4B-00-18-96-AE-1C  
       2      |                 00-12-4B-00-18-96-DB-86  
             4| PULSE    500         200           LAST   OFF   Cancello
              | #                    #             NO     #         
       -------+----------------------------------------------------------------
[Important]Important

The D P WIO 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 WIO command.

Meaning of the most important parameters:

ACT

Operation activation [NO, YES].

ALERT-NA

Send an alert in case of loss of the radio signal [NO, 1..255].

SLAVE

Slave node index [1..1000].

ALERT-NA

Send an alert in case of loss of the radio signal [SYS, NO, 1..255] When SYS, it uses the value configured in the parent Wio device.

DI

Digital input line number [1..4].

DFT

Default value to be used when there is not a known and valid value to set [OFF, ON].

EVENT-THR

Number of allowed state changes during a measurement period of 60s [10..300, NO]. When the threshold is reached the line state is set to FAILED. If "NO", no state tuning is applied.

ALERT

Send an alert when the line assumes the state indicated in 'ALERT-ST' [NO, 1..255].

ALERT-ST

State of the line that triggers the alert [#, OFF, ON, BOTH]

DO

Digital output line number [1..4].

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]. For some devices it is also the value autonomously set when the device is powered-on or the connection to Abilis is lost.

CONTROL-D

Digital line that can control this digital output. # or a string in the format: (e.g. 'Rio-1,DI-5' or 'Rvs-3,DI-1' or 'Wio-1.5,DO-3')

  • for Rio/Rvs: string in the format 'type-nn,line-mm', where:

    • type-nnn is the resource type [Rio, Rvs] and number, for Rio [1..16] and for Rvs [1..4];

    • line-mm is the line type [DI, DO] and number, for Rio [1..16] and for Rvs [1..4].

  • or Wio: string in the format 'type-n.xxx,line-m', where:

    • type-n.xxx is the resource type and number [1..7], followed by the wireless-slave number [1..1000];

    • line-m is the line type [DI, DO] and number [1..4].

CONTROL-D-ST

State of the digital line that triggers this digital output. [#, OFF, ON, BOTH].

Meaning of the Analog Input Lines parameters:

A-IN

Analog Input Line identifier [1].

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 lowest ADC value. 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 highest ADC value. 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. 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', '.'].

ALM-HI

High threshold for alarm. It must be > ALM-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', '.'].

HYST

Hysteresis for ALM-LO and ALM-HI for returning to NORMAL state. String representing a floating point number from 0 to 9999. From 1 up to 6 characters in ['+', '0'..'9', '.'].

ALERT-ALM-LO

Send an alert when Low threshold is reached [NO, 1..255].

ALERT-ALM-HI

Send an alert when High threshold is reached [NO, 1..255].

SENSIT

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. It determines the precision (number of decimals) of MIN/MAX/... parameters. When set, if there is a discrepancy in their precision, they are rounded up/down accordingly. String representing a floating point number from 0 to 9999. From 1 up to 6 characters in ['+', '0'..'9', '.'].

POLL

Polling period [0.1..300.0 sec].

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', '.'].

Meaning of the Analog Output Lines parameters:

The same parameters as Analog Input and also:

AO

Analog output line number [1].

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', '.']. For some devices it is also the value autonomously set when the device is powered-on or the connection to Abilis is lost.

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

s p wio-1 parameter:value...

[Caution]Caution

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

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

[12:38:32] ABILIS_CPX:s p wio-1 slave:1 do:1 descr:Gate#1 mode:pulse pulse-t:500

COMMAND EXECUTED

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

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

RES:Wio-1 - Not Saved (SAVE CONF), Not Refreshed (INIT) -----------------------
Run    DESCR:Wio-1
       LOG:DS                  ACT:YES
       - IpConf parameters (Read Only) ---------------------------------------
       MAC:02-42-DB-91-D4-29   IPRES:Ip-1    
       IPADD:192.168.029.103   MASK:255.255.255.000   GW:192.168.029.254
       ------------------------------------------------------------------------
       SLAVE: | DESCR:          HWADDR:                  ALERT-NA:
       -------+----------------------------------------------------------------
         DO:  | MODE:    PULSE-T:    PULSE-GAP:    START: DFT:  DESCR:
              | CONTROL-D:           CONTROL-D-ST: ALERT: ALERT-ST:
       1      |                 00-12-4B-00-18-96-AE-1C  
             1| PULSE    500         0             LAST   OFF   Gate#1
              | #                    #             NO     #         
       2      |                 00-12-4B-00-18-96-DB-86  
             4| PULSE    500         200           LAST   OFF   Cancello
              | #                    #             NO     #         
       -------+----------------------------------------------------------------

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

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

RES:Wio-1 ---------------------------------------------------------------------
       Wio-1                                                                   
       STATE:UP                   MAC:02-42-DB-91-D4-29   IPRES:Ip-1
       RemAdd-RemPort:192.168.029.103-41412
       HW-DESCR:Xunlong Orange Pi Zero                    HW-ID:
       FW-VER:  1.004             FACTORY-FW-VER:  1.004  BOARD:1.0
       Lines summary:  DI:0  DO:8  AI:0  AO:0

       Slave Type  State  dBm   1    2    3    4    |
       ----------+------------+---------------------+
       1      DO | dn    -128 | .    .    .    .    |
       2      DO | UP     -45 | 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:wio-1 slave:2 do:2 ON


COMMAND EXECUTED 

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

S S RES:Wio-n SLAVE:m DO:val ON|OFF   Set status of DO Line [ON, OFF] belonging
                                      to the given wireless-slave of a Wio resource
S S RES:Wio-n SLAVE:m AO:val <num>    Set value of AO Line of the belonging
                                      to the given wireless-slave of a Wio resource

SLAVE:     Slave node number in the range [1..1000]
DO:        Digital Output line number in the range [1..4]
AO:        Analog Output line number in the range [1]

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

RES:Wio-1 ---------------------------------------------------------------------
       Wio-1                                                                   
       STATE:UP                   MAC:02-42-DB-91-D4-29   IPRES:Ip-1
       RemAdd-RemPort:192.168.029.103-41412
       HW-DESCR:Xunlong Orange Pi Zero                    HW-ID:
       FW-VER:  1.004             FACTORY-FW-VER:  1.004  BOARD:1.0
       Lines summary:  DI:0  DO:8  AI:0  AO:0

       Slave Type  State  dBm   1    2    3    4    |
       ----------+------------+---------------------+
       1      DO | dn    -128 | .    .    .    .    |
       2      DO | UP     -46 | off  ON   off  off  |
       ---------------------------------------------+
[Tip]Tip

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

[Tip]Tip

Interesting chapters:

Section 2.16.3, “WIO - Wireless I/O”;

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

Section 73.22, “Automation log”.

Prev Up Next
21.2. Physical connections Home 21.4. RIO Sonoff WiFi Configuration