NETIO Specific Reference manual

Script triggers

• Power measurements changed^3.3.1
• Global power characteristics changed^3.3.1
• Schedule has started or stopped
• Incoming URL API request
• System started up
• Mqtt was disconnected from the broker^3.3.1
• Mqtt received message on subscribed topic^3.3.1
• System variables updated
• Mqtt has connected to the broker^3.3.1
• DO state changed

Outlet Management

devices.system

• function .SetOut() - turns the outlet on or off
• function .ResetOut() - turns the outlet off and then resets its previous state
• string .output1_state - outlet's state
• number .output1_consumption - outlet's consumption (in Watts)
• number .output1_cumulatedConsumption - outlet's consumed energy (in Watthours)
• function .resetCumulativeConsumption() - resets outlet's energy counter
• string .output1_consumptionStart - date and time since the last energy counter reset

Socket System Management

devices.system

• number .averageLoad - socket's CPU load
• function .Reboot() - reboot socket's system
• number .sessionCount - number of connected users
• number .freeSpace - free disk space
• number .totalSpace - total disk space
• string .serialNumber ^3.3.1 - returns serial number of the device (Eth Interface MAC address)
• number .voltage ^3.0.0 - socket's voltage
• number .overallPowerFactor ^3.0.0 - overall power factor
• number .frequency ^3.0.0 - socket's frequency
• number .totalCurrent ^3.0.0 - total current through socket
• number .totalLoad ^3.0.0 - total load on socket
• number .totalEnergy ^3.0.0 - total energy consumed by socket
• string .energyStart ^3.0.0 - time of last consumption reset

Socket Communication

• function ping() - tests socket's network responsivity
• function mail() - sends e-mail
• function devices.system.CustomCGI() - send HTTP request
• function cgiGet() ^2.3.5 - send HTTP request and receive response
• table event.args - HTTP GET /event variables table
• function snmpGet() ^3.3.1 - send SNMP request

XML Processing ^2.3.6

xml

• function .escape() - escapes XML string to fit xml node contents
• function .check() - tests if string is well-formed XML
• function .parse() - parses XML string into XmlElement object

JSON Processing ^3.3.1

json

• function .decode() - parse json string into obj table
• function .encode() - generate JSON string from table

(based on dkjson)

Modbus ^3.3.1

Read functions

• function modbusReadCoil() - read value from coil
• function modbusReadDiscreteInput() - read value from discrete input
• function modbusReadHoldingRegister() - read value from holding register
• function modbusReadInputRegister() - read value from input register

Write functions

• function modbusWriteSingleCoil() - write value to single coil
• function modbusWriteSingleRegister() - write value to single register

MQTT ^3.3.1

• function .MqttLuaSubscribe() - subscribe to MQTT topic
• function .MqttPublish() - send message to MQTT topic

Standard Lua Functions

• function assert(), error() issues an error
• function ipairs(), pairs(), next() traverse tables
• function tonumber(), tostring() data type conversion
• function pcall() protected call function (handles error inside the function)
• function select() selects from multiple return value
• function unpack converts table into multiple values
• function type() returns variable type
• function os.date(), os.time() system date and time
• function os.difftime() returns time span between two times

Miscellaneous

• function log() - insert a record to the socket's event log
• function logf() - insert a formated record (incl. numbers) to the socket's event log
• function delay() - execute function with delay (seconds)
• function milliDelay() - execute function with delay (milliseconds)
• function toboolean() - converts any variable to boolean type