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

Firstly the device must be configured to be operative.

At the first startup the device acts as an access point, connect to it (see device manual for this step) and configure your network credentials. Remember to assign a static IP address to the device (remove the flag from DHCP option) as shown in the example below:

Network configuration

When you save network configuration the device reboots and connects to your network.

After that connect to the device web configuration page (at the IP address that you have assigned to the device), relative credentials are specified on device manual. On the web configuration page go to section M2M API Protocol and configure JSON API protocol:

• Enable JSON API
• Enable READ
• Enable WRITE

Obviously you can change JSON API username and password.

HSYCO Configuration

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

Communication

• IP Address: local IP address of NETIO device
• Port: leave it blank

Authentication

• User: JSON API username, as set with device web configuration page
• Password: JSON API password, as set with device web configuration page

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

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>
	2	W	turn off output <n> for a short delay (restart)
	2&<t>	W	turn off output <n> for a delay equal to <t> (in milliseconds)
	3	W	turn on output <n> for a short delay
	3&<t>	W	turn on output <n> for a delay equal to <t> (in milliseconds)
	4	W	power switch on output <n>
	5	W	no change
	6	W	ignored
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>.action	<text>	R	output <n> action
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

3.8.0

• initial release