21.1. Analog and digital I/O Overview

21.1. Analog and digital I/O Overview
	Chapter 21. IOBOX

From release 8-4-0 added a new web application that permits the handling of analog and digital I/O made available with the following hardware:

RVS;
RIO.
Note
RIO Sonoff devices are supported starting from Abilis firmware version 8.7.

	Note
RIO Sonoff devices are supported starting from Abilis firmware version 8.7.

From release 9-0-0 added new hardware:

WIO.

The application permits:

Use of .jpg, .png, .gif, .bmp images as background.

A visual creation of maps (up to 10) and the placement on the map of indicators and actuators.

Drive toggle or pulse output just by clicking on the icon.

"By user" access rights to the maps, and different rights for design and for control.
- /sys/io: main page;
- /sys/io/control/map<X>: control maps, where <X> is the map number between 1 and 10;
- /sys/io/design/map<X>: design maps, where <X> is the map number between 1 and 10.
- /sys/io/iolog: Automation log.

Real-time indication of states and values of the monitored I/O.
Configurable labels.
Javascript required (recent version of Firefox, Chrome, Safari, Opera, IE 7/8/9).
IOLOG events viewed as graphs.

See below a couple of example screenshots.

Figure 21.1. I/O Maps index

Figure 21.2. I/O Map1 control

Figure 21.3. I/O Automation log

RIO/WIO/RVS device

Handling of Analog Inputs values (Only for WIO and RIO).
Analog signals are digitized by ADC converters present in the interface hardware. The numerical value is read by Abilis and converted to the measure unit by means of the analog input configuration parameters:
UNIT
Unit of subsequent values. Empty or max 8 characters (e.g. kWh, J, Volts, m, km, miles, myunit).
MIN
Value corresponding 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 the 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', '.'].
UPD
Value corresponding to the 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', '.'].
POOL
Polling period [0.1..300.0 sec].

Handling of Analog Inputs alarms (Only for RIO and WIO).
The measured analog values are verified against thresholds in order to generate LOW and HIGH alarms.
Analog alarms parameters:
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', '.'].
Handling of Digital Output.
Three parameters have been added:
MODE
To choose between VALUE operational mode and PULSE.
PULSE-T
The duration of the pulse, in milliseconds. Only for MODE:PULSE.
PULSE-GAP
The minimal guaranteed pause between two pulses, in milliseconds. Only for MODE:PULSE.
Two parameters have been added only for RIO and RVS:
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].
Handling of Analog Output (Only for RIO and WIO).
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', '.'].