Difference between revisions of "Strato"

From HSYCO
Jump to navigation Jump to search
(Created page with "Strato is a general-purpose, professional input/output module based on a standard Arduino microcontroller. 200px|thumb|iono Ethernet This driver p...")
 
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Strato is a general-purpose, professional input/output module based on a standard Arduino microcontroller.
+
[[Category:I/O Server]]
  
[[File:Iono_ethernet.png|200px|thumb|iono Ethernet]]
+
[http://www.sferalabs.cc/strato/ Strato Pi] is an expansion board developed by Sfera Labs for the Raspberry Pi computer.
  
This driver provides support for iono Ethernet employing the HTTP API provided by the [https://github.com/sfera-labs/iono/wiki/IonoWeb IonoWeb library].
+
[[File:Strato_Board.png|200px|thumb|Strato Pi]]
  
The default sketch installed in iono Ethernet exposes this API.
+
Strato Pi implements a number of hardware features to expand the Pi and allows its use in professional applications:
 +
*9-28 Vdc extended-range power supply
 +
*integrated UPS with external NiCd rechargeable battery
 +
*real-time clock with dedicated back-up battery
 +
*opto-isolated RS-232 or RS-485 serial port
 +
*configurable hardware watchdog
 +
*buzzer for audible feedback.
  
[[Category:I/O Server]]
 
  
 
== 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 STRATO I/O Server in the [[Settings#I/O Servers|I/O Servers section of the Settings]] and set its parameters.
  
=== Communication ===
+
{{note|Note that the Strato I/O Server doesn't count in the I/O servers license total, so you don't need an extra I/O Server license to use Strato with HSYCO.}}
*'''IP Address''': the IP address assigned to iono;
 
  
 
=== High Availability ===
 
=== High Availability ===
*'''Shutdown when inactive''': defaults to true.
+
*'''Shutdown when inactive''': defaults to false.
  
 
=== Options ===
 
=== Options ===
Line 28: Line 32:
 
|-
 
|-
  
|rowspan="2"|startupevents
+
|rowspan="2"|watchdog
|rowspan="2"|true
+
|rowspan="2"|false
 
|true
 
|true
|generate IO events also during the driver’s start-up phase
+
|enables the hardware watchdog and automatically generates the heartbeat signal
 
|-
 
|-
 
|false
 
|false
|start generating events only after HSYCO is aligned with the current status of the system
+
|disables the hardware watchdog
  
 
|-
 
|-
  
|rowspan="2"|pollinterval
+
|rowspan="2"|shutdown_minutes
 
|rowspan="2"|0
 
|rowspan="2"|0
 
|0
 
|0
|the driver will use the push notifications sent by iono to monitor its changes
+
|no automatic shutdown after power failure
 
|-
 
|-
 
|int > 0
 
|int > 0
|the driver will poll iono's state with the specified time interval (in seconds). Push notifications won't be enabled
+
|the driver will command the operating system shutdown and hardware power off after N minutes of back-up battery operations during a power failure. The Strato board will automatically power-up the Pi when power is restored
  
 
|-
 
|-
  
|input1
+
|rowspan="2"|quiet
|rowspan="4"|digital
+
|rowspan="2"|false
|rowspan="2"|digital
+
|true
|rowspan="2"|the specified multi-mode input will be read as digital signal (DI<n>)
+
|enables audible alarms on power failure
 
|-
 
|-
|input2
+
|false
|-
+
|disables audible alarms on power failure
|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 98: Line 72:
 
|-
 
|-
  
|rowspan="2" |connection
+
|rowspan="2" |battery
|online
+
|0
 
|R
 
|R
|connection established
+
|power supply is available
 
|-
 
|-
|offline
+
|1
 +
|R
 +
|power supply failure, running on UPS battery
 +
 
 +
|-
 +
 
 +
|rowspan="6" |beep
 +
|0
 +
|R
 +
|buzzer is off
 +
|-
 +
|1
 
|R
 
|R
|HSYCO can't connect to the device
+
|buzzer is on
 +
|-
 +
|off
 +
|W
 +
|turn buzzer off
 +
|-
 +
|on
 +
|W
 +
|turn buzzer on (continuous tone)
 +
|-
 +
|<duration>
 +
|W
 +
|turn buzzer on for <duration> seconds (decimals allowed)
 +
|-
 +
|<duration>;<pause>
 +
|W
 +
|turn buzzer on for <duration> seconds, then pause for <pause> seconds (decimals allowed)
  
 
|-
 
|-
  
|rowspan="4" |do<n>
+
|rowspan="4" |heartbeat
 
|rowspan="2" |0
 
|rowspan="2" |0
 
|R
 
|R
|relay <n> (digital output) is off
+
|heartbeat line is off
 
|-
 
|-
 
|W
 
|W
|switch off relay <n>
+
|set heartbeat line to off
 
|-
 
|-
 
|rowspan="2" |1
 
|rowspan="2" |1
 
|R
 
|R
|relay <n> (digital output) is on
+
|heartbeat line is on
 
|-
 
|-
 
|W
 
|W
|switch on relay <n>
+
|set heartbeat line to on
  
 
|-
 
|-
  
|rowspan="2" |di<n>
+
|rowspan="3" |shutdown
 
|0
 
|0
 
|R
 
|R
|digital input <n> is low
+
|shutdown line is off
 
|-
 
|-
|1
+
|rowspan="2" |1
 
|R
 
|R
|digital input <n> is high
+
|shutdown line is on
 +
|-
 +
|W
 +
|set shutdown line to on (Strato will wait approximately 60 seconds, then execute a power off-on cycle. Once the shutdown line is set to on, the power cycle procedure can't be reset
  
 
|-
 
|-
  
|av<n>
+
|rowspan="2" |timeout
|<val>
+
|0
 
|R
 
|R
|analog input <n> is reading a voltage equal to <val> (in Volts)
+
|hardware watchdog timeout line is off
 +
|-
 +
|1
 +
|R
 +
|hardware watchdog timeout line is on. Strato will set this line to on, then wait approximately 60 seconds and execute a power off-on cycle
  
 
|-
 
|-
  
|ai<n>
+
|rowspan="4" |watchdog
|<val>
+
|rowspan="2" |0
 
|R
 
|R
|analog input <n> is reading a current equal to <val> (in mA)
+
|hardware watchdog is disabled
 
+
|-
 +
|W
 +
|disables the hardware watchdog
 +
|-
 +
|rowspan="2" |1
 +
|R
 +
|hardware watchdog is enabled
 
|-
 
|-
 
|ao1
 
|<val>
 
 
|W
 
|W
|set the analog output to <val> Volts
+
|enables the hardware watchdog. When enabled, Strato should see an off-on transition on the hearbeat line at least every 60 seconds, otherwise a power cycle will be initiated, setting the timeout line on, then waiting 60 seconds, removing power to the Pi for 5 seconds, and finally restoring power
  
 
|}
 
|}
 
== 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 172: Line 177:
  
  
''Strato is a registered trademarks of Home Systems Consulting S.p.A.''
+
''Strato is a registered trademark of Home Systems Consulting S.p.A.''

Latest revision as of 19:45, 31 October 2015


Strato Pi is an expansion board developed by Sfera Labs for the Raspberry Pi computer.

Strato Pi

Strato Pi implements a number of hardware features to expand the Pi and allows its use in professional applications:

  • 9-28 Vdc extended-range power supply
  • integrated UPS with external NiCd rechargeable battery
  • real-time clock with dedicated back-up battery
  • opto-isolated RS-232 or RS-485 serial port
  • configurable hardware watchdog
  • buzzer for audible feedback.


HSYCO Configuration

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

Note that the Strato I/O Server doesn't count in the I/O servers license total, so you don't need an extra I/O Server license to use Strato with HSYCO.


High Availability

  • Shutdown when inactive: defaults to false.

Options

ID Default Values Description
watchdog false true enables the hardware watchdog and automatically generates the heartbeat signal
false disables the hardware watchdog
shutdown_minutes 0 0 no automatic shutdown after power failure
int > 0 the driver will command the operating system shutdown and hardware power off after N minutes of back-up battery operations during a power failure. The Strato board will automatically power-up the Pi when power is restored
quiet false true enables audible alarms on power failure
false disables audible alarms on power failure

Datapoints

ID Value R/W Description
battery 0 R power supply is available
1 R power supply failure, running on UPS battery
beep 0 R buzzer is off
1 R buzzer is on
off W turn buzzer off
on W turn buzzer on (continuous tone)
<duration> W turn buzzer on for <duration> seconds (decimals allowed)
<duration>;<pause> W turn buzzer on for <duration> seconds, then pause for <pause> seconds (decimals allowed)
heartbeat 0 R heartbeat line is off
W set heartbeat line to off
1 R heartbeat line is on
W set heartbeat line to on
shutdown 0 R shutdown line is off
1 R shutdown line is on
W set shutdown line to on (Strato will wait approximately 60 seconds, then execute a power off-on cycle. Once the shutdown line is set to on, the power cycle procedure can't be reset
timeout 0 R hardware watchdog timeout line is off
1 R hardware watchdog timeout line is on. Strato will set this line to on, then wait approximately 60 seconds and execute a power off-on cycle
watchdog 0 R hardware watchdog is disabled
W disables the hardware watchdog
1 R hardware watchdog is enabled
W enables the hardware watchdog. When enabled, Strato should see an off-on transition on the hearbeat line at least every 60 seconds, otherwise a power cycle will be initiated, setting the timeout line on, then waiting 60 seconds, removing power to the Pi for 5 seconds, and finally restoring power

Release Notes

3.5.0

  • initial release


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