Difference between revisions of "IonoPiMax"

From HSYCO
Jump to navigation Jump to search
Line 56: Line 56:
  
 
Note that "max.buzzer.beep" is not visible in the Status Browser and doesn't generate events, because it is write only, and only the "max.buzzer.status" data point will be visible, with a value of 0 if the buzzer is not active, or 1 if active.
 
Note that "max.buzzer.beep" is not visible in the Status Browser and doesn't generate events, because it is write only, and only the "max.buzzer.status" data point will be visible, with a value of 0 if the buzzer is not active, or 1 if active.
 +
 +
=== Additional datapoints ===
 +
 +
{| class="wikitable"
 +
!ID
 +
!Value
 +
!R/W
 +
!Description
 +
 +
|-
 +
 +
|rowspan="2" |backlight.brightness
 +
|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
 +
|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)
 +
 +
|-
 +
 +
|rowspan="4" |heartbeat<br>(base/ups/cm only)
 +
|rowspan="2" |0
 +
|R
 +
|heartbeat line is off
 +
|-
 +
|W
 +
|set heartbeat line to off
 +
|-
 +
|rowspan="2" |1
 +
|R
 +
|heartbeat line is on
 +
|-
 +
|W
 +
|set heartbeat line to on
 +
 +
|-
 +
 +
|rowspan="3" |shutdown<br>(base/ups/cm only)
 +
|0
 +
|R
 +
|shutdown line is off
 +
|-
 +
|rowspan="2" |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
 +
 +
|-
 +
 +
|rowspan="2" |timeout<br>(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
 +
 +
|-
 +
 +
|rowspan="4" |watchdog<br>(base/ups/cm only)
 +
|rowspan="2" |0
 +
|R
 +
|hardware watchdog is disabled
 +
|-
 +
|W
 +
|disables the hardware watchdog
 +
|-
 +
|rowspan="2" |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 ==
 
== Release Notes ==

Revision as of 17:57, 5 January 2021

Iono Pi Max is an extremely versatile industrial server with a huge variety of Input/Output lines and standard communication interfaces, all routed to the incredibly powerful quad-core processor of the Raspberry Pi.

Iono Pi Max

This driver provides support for a local installation of HSYCO on Iono Pi Max itself. The Raspberry Pi OS Kernel module for Iono Pi Max must be installed. The kernel module documentation is available at GitHub and the Iono Pi Max User Guide.

HSYCO Configuration

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

Note that the IONO Pi Max 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 IONO Pi Max with HSYCO.


High Availability

  • Shutdown when inactive: defaults to false.

Options

ID Default Values Description
startupevents false 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 250 10 <= n <= 30000 the data acquisition interval, in milliseconds

Datapoints

The Iono Pi Max implements all data points provided by the underlying Iono Pi Max kernel module. Refer to the documentation is available at GitHub.

Each readable file name exposed by the kernel module under the /sys/class/ionopimax/ sub-directories appears as a data point with id <subdir>.<file>. For example, as the buzzer's status file is /sys/class/ionopimax/buzzer/status, the corresponding data point is "buzzer.status".

Command files that are marked as write only in the documentation (W), are not shown as visible data points in HSYCO, but can be used in the IO events action or ioSet() methods to send a command.

For example, if "max" is the id assigned to the Iono Pi Max I/O Server, then: 

TIME : IO max.buzzer.beep = 1000

will make the buzzer beep for 1 second (1000 ms).

Note that "max.buzzer.beep" is not visible in the Status Browser and doesn't generate events, because it is write only, and only the "max.buzzer.status" data point will be visible, with a value of 0 if the buzzer is not active, or 1 if active.

Additional 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.8.0

  • dual µSD card support
  • improved watchdog and UPS support

3.7.0

  • initial release


Iono Pi Max is a registered trademark of Sfera Labs Srl

Retrieved from "https://wiki.hsyco.com/3.8/index.php?title=IonoPiMax&oldid=9571"