Difference between revisions of "Iono"

From HSYCO
Jump to navigation Jump to search
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
iono is a general-purpose, professional input/output module based on a standard Arduino microcontroller.
+
[http://www.sferalabs.cc/iono/ Iono] is a general-purpose, professional input/output module based on a standard Arduino microcontroller.
 +
 
 +
[[File:Iono_ethernet.png|200px|thumb|iono Ethernet]]
 +
 
 +
This driver provides support for iono Ethernet employing the HTTP API provided by the [https://github.com/sfera-labs/iono/wiki/IonoWeb IonoWeb library].
 +
 
 +
The default sketch installed in iono Ethernet exposes this API.
  
 
[[Category:I/O Server]]
 
[[Category:I/O Server]]
Line 5: Line 11:
 
== HSYCO Configuration ==
 
== HSYCO Configuration ==
 
Add a IONO I/O Server in the [[Settings#I/O Servers|I/O Servers section of the Settings]] and set its parameters:
 
Add a IONO I/O Server in the [[Settings#I/O Servers|I/O Servers section of the Settings]] and set its parameters:
 +
 +
=== Communication ===
 +
*'''IP Address''': the IP address assigned to iono;
  
 
=== High Availability ===
 
=== High Availability ===
−
*'''IP Address''': the IP address assigned to iono;
+
*'''Shutdown when inactive''': defaults to true.
−
*'''Shutdown when inactive''': defaults to false.
 
  
 
=== Options ===
 
=== Options ===
Line 21: Line 29:
  
 
|rowspan="2"|startupevents
 
|rowspan="2"|startupevents
−
|rowspan="2"|false
+
|rowspan="2"|true
 
|true
 
|true
 
|generate IO events also during the driver’s start-up phase
 
|generate IO events also during the driver’s start-up phase
Line 29: Line 37:
  
 
|-
 
|-
 +
 +
|rowspan="2"|pollinterval
 +
|rowspan="2"|0
 +
|0
 +
|the driver will use the push notifications sent by iono to monitor its changes
 +
|-
 +
|int > 0
 +
|the driver will poll iono's state with the specified time interval (in seconds). Push notifications won't be enabled
 +
 +
|-
 +
 +
|input1
 +
|rowspan="4"|digital
 +
|rowspan="2"|digital
 +
|rowspan="2"|the specified multi-mode input will be read as digital signal (DI<n>)
 +
|-
 +
|input2
 +
|-
 +
|input3
 +
|voltage
 +
|the specified multi-mode input will be read as analog voltage (AV<n>)
 +
|-
 +
|input4
 +
|current
 +
|the specified multi-mode input will be read as analog current (AI<n>)
 +
 +
|-
 +
 +
|stabletime
 +
|100
 +
|int > 0
 +
|number of milliseconds an input must be stable before a push notification is sent by iono to HSYCO
 +
 +
|-
 +
 +
|minvariation
 +
|0.1
 +
|float > 0
 +
|minimun value variation (for analog inputs) to trigger a push notification
 +
 +
|-
 +
 +
|subscribehost
 +
|
 +
|<host_name>
 +
|hostname or IP address to be used by iono to send push notifications. Leave blank to let the driver discover the local address
  
 
|}
 
|}
  
 
== Datapoints ==
 
== Datapoints ==
 +
 +
For inputs 1 to 4, depending on the 'input1' ... 'input4' options, only the corresponding datapoint will be created, i.e. di<n> (if digital), av<n> (if voltage) or ai<n> (if curent).
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 52: Line 108:
  
 
|-
 
|-
 +
 +
|rowspan="4" |do<n>
 +
|rowspan="2" |0
 +
|R
 +
|relay <n> (digital output) is off
 +
|-
 +
|W
 +
|switch off relay <n>
 +
|-
 +
|rowspan="2" |1
 +
|R
 +
|relay <n> (digital output) is on
 +
|-
 +
|W
 +
|switch on relay <n>
 +
 +
|-
 +
 +
|rowspan="2" |di<n>
 +
|0
 +
|R
 +
|digital input <n> is low
 +
|-
 +
|1
 +
|R
 +
|digital input <n> is high
 +
 +
|-
 +
 +
|av<n>
 +
|<val>
 +
|R
 +
|analog input <n> is reading a voltage equal to <val> (in Volts)
 +
 +
|-
 +
 +
|ai<n>
 +
|<val>
 +
|R
 +
|analog input <n> is reading a current equal to <val> (in mA)
 +
 +
|-
 +
 +
|ao1
 +
|<val>
 +
|W
 +
|set the analog output to <val> Volts
  
 
|}
 
|}
Line 57: Line 160:
 
== User Interface ==
 
== User Interface ==
  
 +
To control a digital output (DO1 ... DO6), add a [[button]] or a [[buttonicon]] object to your project page and set its address field to the corresponding datapoint:
 +
 +
[[File:Iono_UI_Buttonicon.png|500px|border]]
  
 
== Release Notes ==
 
== Release Notes ==
Line 66: Line 172:
  
  
−
''iono is a registered trademarks of Home Systems Consulting S.p.A.''
+
''iono is a registered trademark of Home Systems Consulting S.p.A.''

Latest revision as of 18:45, 31 October 2015

Iono is a general-purpose, professional input/output module based on a standard Arduino microcontroller.

iono Ethernet

This driver provides support for iono Ethernet employing the HTTP API provided by the IonoWeb library.

The default sketch installed in iono Ethernet exposes this API.

HSYCO Configuration

Add a IONO I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

  • IP Address: the IP address assigned to iono;

High Availability

  • Shutdown when inactive: defaults to true.

Options

ID Default Values Description
startupevents true true generate IO events also during the driver’s start-up phase
false start generating events only after HSYCO is aligned with the current status of the system
pollinterval 0 0 the driver will use the push notifications sent by iono to monitor its changes
int > 0 the driver will poll iono's state with the specified time interval (in seconds). Push notifications won't be enabled
input1 digital digital the specified multi-mode input will be read as digital signal (DI<n>)
input2
input3 voltage the specified multi-mode input will be read as analog voltage (AV<n>)
input4 current the specified multi-mode input will be read as analog current (AI<n>)
stabletime 100 int > 0 number of milliseconds an input must be stable before a push notification is sent by iono to HSYCO
minvariation 0.1 float > 0 minimun value variation (for analog inputs) to trigger a push notification
subscribehost <host_name> hostname or IP address to be used by iono to send push notifications. Leave blank to let the driver discover the local address

Datapoints

For inputs 1 to 4, depending on the 'input1' ... 'input4' options, only the corresponding datapoint will be created, i.e. di<n> (if digital), av<n> (if voltage) or ai<n> (if curent).

ID Value R/W Description
connection online R connection established
offline R HSYCO can't connect to the device
do<n> 0 R relay <n> (digital output) is off
W switch off relay <n>
1 R relay <n> (digital output) is on
W switch on relay <n>
di<n> 0 R digital input <n> is low
1 R digital input <n> is high
av<n> <val> R analog input <n> is reading a voltage equal to <val> (in Volts)
ai<n> <val> R analog input <n> is reading a current equal to <val> (in mA)
ao1 <val> W set the analog output to <val> Volts

User Interface

To control a digital output (DO1 ... DO6), add a button or a buttonicon object to your project page and set its address field to the corresponding datapoint:

Iono UI Buttonicon.png

Release Notes

3.5.0

  • initial release


iono is a registered trademark of Home Systems Consulting S.p.A.

Retrieved from "http://wiki.hsyco.com/3.5.0/index.php?title=Iono&oldid=6110"