Difference between revisions of "Strato"

From HSYCO
Jump to navigation Jump to search
 
(42 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Strato Pi is an expansion board developed by Sfera Labs for the Raspberry Pi computer board.
+
[[Category:I/O Server]]
 +
 
 +
[http://www.sferalabs.cc/strato/ Strato Pi] is an expansion board developed by Sfera Labs for the Raspberry Pi computer.
  
 
[[File:Strato_Board.png|200px|thumb|Strato Pi]]
 
[[File:Strato_Board.png|200px|thumb|Strato Pi]]
  
Strato Pi implements a number of hardware features to expand the Pi and allow its use in professional applications:
+
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
 
*9-28 Vdc extended-range power supply
 
*integrated UPS with external NiCd rechargeable battery
 
*integrated UPS with external NiCd rechargeable battery
Line 11: Line 13:
 
*buzzer for audible feedback.
 
*buzzer for audible feedback.
  
 
 
[[Category:I/O Server]]
 
  
 
== HSYCO Configuration ==
 
== HSYCO Configuration ==
Line 33: 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 (Strato Pi Mini board not supported)
 
|-
 
|-
 
|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 (use this option only with the Strato UPS board)
  
 
|-
 
|-
  
|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
+
|rowspan="5"|version
|the specified multi-mode input will be read as analog voltage (AV<n>)
+
|rowspan="5"|base
 +
|base
 +
|Strato Pi Base and UPS boards
 
|-
 
|-
|input4
+
|mini
|current
+
|Strato Pi Mini board
|the specified multi-mode input will be read as analog current (AI<n>)
 
 
 
 
|-
 
|-
 
+
|can
|stabletime
+
|Strato Pi CAN
|100
 
|int > 0
 
|number of milliseconds an input must be stable before a push notification is sent by iono to HSYCO
 
 
 
 
|-
 
|-
 
+
|cm
|minvariation
+
|Strato Pi CM
|0.1
 
|float > 0
 
|minimun value variation (for analog inputs) to trigger a push notification
 
 
 
 
|-
 
|-
 
+
|cmduo
|subscribehost
+
|Strato Pi CM Duo
|
 
|<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 103: Line 91:
 
|-
 
|-
  
|rowspan="2" |connection
+
|rowspan="2" |backlight.brightness
|online
+
|rowspan="2" |<brightness>
 +
|R
 +
|the current backlight brightness of HSYCO Pi Touch Display
 +
|-
 +
|W
 +
|set brightness of HSYCO Pi Touch Display to a value between 0 (off) and 255 (max)
 +
 
 +
|-
 +
 
 +
|rowspan="2" |battery<br>(base/ups only)
 +
|0
 +
|R
 +
|power supply is available
 +
|-
 +
|1
 +
|R
 +
|power supply failure, running on UPS battery
 +
 
 +
|-
 +
 
 +
|rowspan="6" |beep<br>(base/ups/mini only)
 +
|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)
 +
 
 +
|-
 +
 
 +
|cpu.temperature
 +
|<temperature>
 +
|R
 +
|the current CPU core temperature in Celsius degrees
 +
 
 +
|-
 +
 
 +
|rowspan="6" |led<br>(cm only)
 +
|0
 
|R
 
|R
|connection established
+
|led is off
 
|-
 
|-
|offline
+
|1
 
|R
 
|R
|HSYCO can't connect to the device
+
|led is on
 +
|-
 +
|off
 +
|W
 +
|turn led off
 +
|-
 +
|on
 +
|W
 +
|turn led on
 +
|-
 +
|<duration>
 +
|W
 +
|turn led on for <duration> seconds (decimals allowed)
 +
|-
 +
|<duration>;<pause>
 +
|W
 +
|turn led on for <duration> seconds, then pause for <pause> seconds (decimals allowed)
  
 
|-
 
|-
  
|rowspan="4" |do<n>
+
|rowspan="4" |heartbeat<br>(base/ups/cm only)
 
|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<br>(base/ups/cm only)
 
|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. On Strato Pi CM, a hardware reset of the Compute Module is performed, while the power is not removed
  
 
|-
 
|-
  
|av<n>
+
|rowspan="2" |timeout<br>(base/ups/cm only)
|<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. On Strato Pi CM, a hardware reset of the Compute Module is performed, while the power is not removed
  
 
|-
 
|-
  
|ai<n>
+
|rowspan="4" |watchdog<br>(base/ups/cm only)
|<val>
+
|rowspan="2" |0
 +
|R
 +
|hardware watchdog is disabled
 +
|-
 +
|W
 +
|disables the hardware watchdog
 +
|-
 +
|rowspan="2" |1
 
|R
 
|R
|analog input <n> is reading a current equal to <val> (in mA)
+
|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. On Strato Pi CM, a hardware reset of the Compute Module is performed, while the power is not removed
  
 
|}
 
|}
  
== User Interface ==
+
== Release Notes ==
  
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:
+
=== 3.7.0 ===
 +
*added support for Strato Pi CAN and Strato Pi CM Duo
 +
*new cpu.temperature data point
  
[[File:Iono_UI_Buttonicon.png|500px|border]]
+
=== 3.6.0 ===
 
+
*added support for Strato Pi Mini and Strato Pi CM
== Release Notes ==
+
*new backlight.brightness data point to set the display backlight brightness of HSYCO Pi Touch Display
  
 
=== 3.5.0 ===
 
=== 3.5.0 ===
Line 177: Line 248:
  
  
''Strato is a registered trademarks of Home Systems Consulting S.p.A.''
+
''Strato is a registered trademark of Sfera Labs Srl''

Latest revision as of 13:42, 18 January 2020


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 (Strato Pi Mini board not supported)
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 (use this option only with the Strato UPS board)
quiet false true enables audible alarms on power failure
false disables audible alarms on power failure
version base base Strato Pi Base and UPS boards
mini Strato Pi Mini board
can Strato Pi CAN
cm Strato Pi CM
cmduo Strato Pi CM Duo

Datapoints

ID Value R/W Description
backlight.brightness <brightness> R the current backlight brightness of HSYCO Pi Touch Display
W set brightness of HSYCO Pi Touch Display to a value between 0 (off) and 255 (max)
battery
(base/ups only)
0 R power supply is available
1 R power supply failure, running on UPS battery
beep
(base/ups/mini only)
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)
cpu.temperature <temperature> R the current CPU core temperature in Celsius degrees
led
(cm only)
0 R led is off
1 R led is on
off W turn led off
on W turn led on
<duration> W turn led on for <duration> seconds (decimals allowed)
<duration>;<pause> W turn led on for <duration> seconds, then pause for <pause> seconds (decimals allowed)
heartbeat
(base/ups/cm only)
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
(base/ups/cm only)
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. On Strato Pi CM, a hardware reset of the Compute Module is performed, while the power is not removed
timeout
(base/ups/cm only)
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. On Strato Pi CM, a hardware reset of the Compute Module is performed, while the power is not removed
watchdog
(base/ups/cm only)
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. On Strato Pi CM, a hardware reset of the Compute Module is performed, while the power is not removed

Release Notes

3.7.0

  • added support for Strato Pi CAN and Strato Pi CM Duo
  • new cpu.temperature data point

3.6.0

  • added support for Strato Pi Mini and Strato Pi CM
  • new backlight.brightness data point to set the display backlight brightness of HSYCO Pi Touch Display

3.5.0

  • initial release


Strato is a registered trademark of Sfera Labs Srl