NETIO
This driver can read the status and send control commands to a NETIO power socket, using the HTTP JSON API protocol with basic authentication (username and password).
NETIO supported models are: PowerCable REST 101x, PowerPDU 4C, PowerPDU 4PS, PowerDIN 4PZ, PowerBOX 3Px, 4, 4All.
Device Configuration
Section titled “Device Configuration”The device should be configured with a static IP address, or a fixed DHCP assigned address.
On the device's configuration page go to section M2M API Protocol and configure JSON API protocol:
- Enable JSON API
- Enable READ
- Enable WRITE
You should change the JSON API username and password.
HSYCO Configuration
Section titled “HSYCO Configuration”Add the NETIO I/O Server in the I/O Servers section of the Settings and set its parameters:
Communication
Section titled “Communication”- IP Address: local IP address of NETIO device
- Port: leave it blank
Authentication
Section titled “Authentication”- User: JSON API username, as set with device web configuration page
- Password: JSON API password, as set with device web configuration page
Options
Section titled “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 | 1000 | n >= 100 | data acquisition interval, in milliseconds, from the power socket |
Datapoints
Section titled “Datapoints”| ID | Value | R/W | Description |
|---|---|---|---|
| connection | online | R | the power socket is online and the driver is receiving data from it |
| offline | R | initialization of the driver failed or loop cycle failed | |
| o<n> | on | W | turn on output <n> |
| off | W | turn off output <n> | |
| flip | W | power switch on output <n> | |
| 0 | R | output <n> is off | |
| W | turn off output <n> | ||
| 1 | R | output <n> is on | |
| W | turn on output <n> | ||
| off& | W | turn off output <n> for a short time (short off) | |
| off&<t> | W | turn off output <n> for <t> milliseconds | |
| on& | W | turn on output <n> for a short time (short on) | |
| on&<t> | W | turn on output <n> for <t> milliseconds | |
| model | <text> | R | device model |
| fwversion | <text> | R | firmware version |
| jsonversion | <text> | R | JSON protocol version |
| name | <text> | R | device name |
| macaddress | <text> | R | device MAC address |
| serialnum | <text> | R | device serial number |
| uptime | <val> | R | time, in minutes, since device startup |
| numoutputs | <n> | R | number of device outputs |
| numinputs | <n> | R | number of device inputs |
| voltage | <val> | R | instantaneous device voltage, in Volt |
| frequency | <val> | R | instantaneous device frequency, in Hertz |
| totcurrent | <val> | R | instantaneous total current through all power outputs, in milliampere |
| opf | <val> | R | instantaneous True Power Factor weighted average from all meters |
| phase | <val> | R | instantaneous phase weighted average from all meters |
| totload | <val> | R | total power of all power outputs, in Watt |
| totenergy | <val> | R | instantaneous value of the Total Energy counter (Wh) |
| o<n>.name | <text> | R | output <n> name, defined in web configuration page |
| o<n>.delay | <val> | R | output <n> delay for short On/Off, in milliseconds |
| o<n>.current | <val> | R | instantaneous current of output <n>, in milliampere |
| o<n>.pf | <val> | R | instantaneous True Power Factor of output <n> |
| o<n>.phase | <val> | R | instantaneous phase of output <n> |
| o<n>.load | <val> | R | total power of output <n> |
| o<n>.energy | <val> | R | instantaneous value of the energy counter of output <n> (Wh) |
| o<n>.rvenergy | <val> | R | instantaneous value of the reverse energy counter of output <n> (Wh) |
| i<n> | 1 | R | input <n> is on |
| 0 | R | input <n> is off | |
| i<n>.name | <text> | R | input <n> name, defined in web configuration page |
| i<n>.s0counter | <val> | R | s0 counter value of input <n> |
Release Notes
Section titled “Release Notes”- initial release
NETIO is a registered trademark of NETIO Products a.s.