Difference between revisions of "NETIO"

From HSYCO
Jump to navigation Jump to search
Line 267: Line 267:
 
|1
 
|1
 
|R
 
|R
|input <n> on
+
|input <n> is on
 
|-
 
|-
 
|0
 
|0
 
|R
 
|R
|input <n> off
+
|input <n> is off
 
|-
 
|-
 
|i<n>.name
 
|i<n>.name

Revision as of 12:24, 20 November 2020

This driver commands a NETIO power socket and reads status from it, it uses HTTP 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:

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
Network configuration

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