wiki.netio-products.com - User contributions [en]

Welcome to NETIO resources & projects & documentation overview

2019-07-11T18:59:24Z

Admin:

<div style="text-align: center; white-space: nowrap;">
<div style="display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 40%; vertical-align: top; white-space: normal;">
<div style="text-align: center; white-space: nowrap;">

<div style="background: #eaf6f2; display: inline-block; margin: 0 1em 0 1em; border-left: 0px solid gray; width: 45%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;">Interoperability</h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: left; vertical-align: top; white-space: normal;">
=== M2M API doc ===
[[MQTT-flex]]

[[MQTT]]

[[JSON API]]

[[XML API]]

[[URL API]]

[[SNMP]]

[[Telnet/Kshell]]

[[Modbus TCP]]

=== Integrations ===
[https://www.home-assistant.io/components/netio/ Home Assistant]

[[IBM Cloud]] - MQTT-flex

[[IBM Cloud]] - NETIO 4x MQTT-LUA

[[Azure IoT Hub]] - MQTT

[[HiveMQ]] - MQTT-flex

[[NodeRED]] - JSON API

[https://www.jam-software.com/serversentinel/online_manual/EN/index.html?actions_netio230bnetworkpowersocket.html Jam-software - ServerSentinel]
</div>
</div>
<div style="background: #eaf6f2; display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 52%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> Community </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: left; vertical-align: top; white-space: normal;">
=== Official ===
[https://github.com/netioproducts GitHub - official]

[https://github.com/Koukaam/netio-utils/tree/master/actions GitHub - obsolete (Koukaam)]

=== Community ===
[https://github.com/stdevel/check_netio Nagios plugin]

[https://github.com/elmicro/fhem_netio_4x_pm FHEM module by Elmicro]

[https://github.com/imolein/lua-netio LUA control Library]

[https://github.com/rynr/netio Java Control Library]

[https://github.com/st3veV/Netio-OpenHAB OpenHAB using MQTT]

[https://jirikuba.github.io/NETIO.SpinaniHDO/ NETIO controlled by HDO]

[https://groups.google.com/forum/#!topic/openhab/O6psocjU70s Read consumption in OpenHAB - HTTP]

[https://www.instructables.com/id/How-to-Work-With-JSON-in-Node-RED/ NETIO 4All from NodeRED]

[https://github.com/theone1984/netio-jenkins Jenkins plugin]
</div>
</div>

</div>

</div>
<div style="display: inline-block; padding: 0 2em 0 0; border-right: 0px solid gray; width: 60%; vertical-align: top; white-space: normal;">
<div style="background: #eaf6f2; display: inline-block; padding: 0 0 0 1em; border-left: 0px solid gray; width: 98%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> NETIO Lua Programming </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: justify; vertical-align: top; white-space: normal;">
=== Don't know LUA? ===
==== [https://www.lua.org/pil/contents.html Official Lua tutorial] ====
If you are new to Lua and programming as such and if you are eager to learn, this is your starting point. Before you proceed to NETIO Sockets, this [https://www.lua.org/demo.html online environment] will be a good place to test your first scripts.
==== [https://www.lua.org/manual/5.3/ Official Lua manual] ====
Although you won't need everything mentioned here, it is worth to peek here from time to time to grasp the concepts of effective Lua programming.

=== Lua in NETIO ===
If you already know Lua, just keep in mind that <b>NETIO Lua loops are limited to 32k cycles</b> and all <b>numbers are integers, not decimals</b> like in standard Lua.
==== [[Lua basics for other language programmers]] ====
A quick jump into NETIO Lua programming if you mastered another programming language. It's simple...
==== [[NETIO Lua Tips & Philosophy]] ====
Explanation of starting LUA scripts in NETIO devices and some tips how to hack NETIO to doing what you want.

==== [[NETIO Specific Reference manual]] ====
If you can already code in Lua, NETIO-specific Lua functions is your main guide to programing NETIO Sockets.

==== [[Examples & Aplication notes]] ====
Aplication notes for devices supporting LUA programming. Example configurations downloads and Script programming explanation with direct links to reference
</div>
</div>
</div>
</div>
__NOTOC__

Welcome to NETIO resources & projects & documentation overview

2019-07-11T18:57:28Z

Admin:

<div style="text-align: center; white-space: nowrap;">
<div style="display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 40%; vertical-align: top; white-space: normal;">
<div style="text-align: center; white-space: nowrap;">

<div style="background: #eaf6f2; display: inline-block; margin: 0 1em 0 1em; border-left: 0px solid gray; width: 45%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> Integration </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: left; vertical-align: top; white-space: normal;">
=== M2M API doc ===
[[MQTT-flex]]

[[MQTT]]

[[JSON API]]

[[XML API]]

[[URL API]]

[[SNMP]]

[[Telnet/Kshell]]

[[Modbus TCP]]

=== Examples ===
[https://www.home-assistant.io/components/netio/ Home Assistant]

[[IBM Cloud]] - MQTT-flex

[[IBM Cloud]] - NETIO 4x MQTT-LUA

[[Azure IoT Hub]] - MQTT

[[HiveMQ]] - MQTT-flex

[[NodeRED]] - JSON API

[https://www.jam-software.com/serversentinel/online_manual/EN/index.html?actions_netio230bnetworkpowersocket.html Jam-software - ServerSentinel]
</div>
</div>
<div style="background: #eaf6f2; display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 52%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> Community </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: left; vertical-align: top; white-space: normal;">
=== Official ===
[https://github.com/netioproducts GitHub - official]

[https://github.com/Koukaam/netio-utils/tree/master/actions GitHub - obsolete (Koukaam)]

=== Community ===
[https://github.com/stdevel/check_netio Nagios plugin]

[https://github.com/elmicro/fhem_netio_4x_pm FHEM module by Elmicro]

[https://github.com/imolein/lua-netio LUA control Library]

[https://github.com/rynr/netio Java Control Library]

[https://github.com/st3veV/Netio-OpenHAB OpenHAB using MQTT]

[https://jirikuba.github.io/NETIO.SpinaniHDO/ NETIO controlled by HDO]

[https://groups.google.com/forum/#!topic/openhab/O6psocjU70s Read consumption in OpenHAB - HTTP]

[https://www.instructables.com/id/How-to-Work-With-JSON-in-Node-RED/ NETIO 4All from NodeRED]

[https://github.com/theone1984/netio-jenkins Jenkins plugin]
</div>
</div>

</div>

</div>
<div style="display: inline-block; padding: 0 2em 0 0; border-right: 0px solid gray; width: 60%; vertical-align: top; white-space: normal;">
<div style="background: #eaf6f2; display: inline-block; padding: 0 0 0 1em; border-left: 0px solid gray; width: 98%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> NETIO Lua Programming </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: justify; vertical-align: top; white-space: normal;">
=== Don't know LUA? ===
==== [https://www.lua.org/pil/contents.html Official Lua tutorial] ====
If you are new to Lua and programming as such and if you are eager to learn, this is your starting point. Before you proceed to NETIO Sockets, this [https://www.lua.org/demo.html online environment] will be a good place to test your first scripts.
==== [https://www.lua.org/manual/5.3/ Official Lua manual] ====
Although you won't need everything mentioned here, it is worth to peek here from time to time to grasp the concepts of effective Lua programming.

=== Lua in NETIO ===
If you already know Lua, just keep in mind that <b>NETIO Lua loops are limited to 32k cycles</b> and all <b>numbers are integers, not decimals</b> like in standard Lua.
==== [[Lua basics for other language programmers]] ====
A quick jump into NETIO Lua programming if you mastered another programming language. It's simple...
==== [[NETIO Lua Tips & Philosophy]] ====
Explanation of starting LUA scripts in NETIO devices and some tips how to hack NETIO to doing what you want.

==== [[NETIO Specific Reference manual]] ====
If you can already code in Lua, NETIO-specific Lua functions is your main guide to programing NETIO Sockets.

==== [[Examples & Aplication notes]] ====
Aplication notes for devices supporting LUA programming. Example configurations downloads and Script programming explanation with direct links to reference
</div>
</div>
</div>
</div>
__NOTOC__

NETIO Specific Reference manual

2019-07-11T18:45:33Z

Admin: /* Socket System Management */

== Script triggers ==
* [[Power measurements changed|Power measurements changed]]<sup><code>3.3.1</code></sup>
* [[Global power characteristics changed|Global power characteristics changed]]<sup><code>3.3.1</code></sup>
* [[Schedule has started or stopped|Schedule has started or stopped]]
* [[Incoming URL API request|Incoming URL API request]]
* [[System started up|System started up]]
* [[Mqtt was disconnected from the broker|Mqtt was disconnected from the broker]]<sup><code>3.3.1</code></sup>
* [[Mqtt received message on subscribed topic|Mqtt received message on subscribed topic]]<sup><code>3.3.1</code></sup>
* [[System variables updated|System variables updated]]
* [[Mqtt has connected to the broker|Mqtt has connected to the broker]]<sup><code>3.3.1</code></sup>
* [[DO state changed|DO state changed]]

== Outlet Management ==
<big><b> devices.system </b></big>
* function [[Function devices.system.SetOut()|.SetOut()]] - turns the outlet on or off
* function [[Function devices.system.ResetOut()|.ResetOut()]] - turns the outlet off and then resets its previous state
* string [[String devices.system.output1_state|.output1_state]] - outlet's state
* number [[Number devices.system.output1_consumption|.output1_consumption]] - outlet's consumption (in Watts)
* number [[Number devices.system.output1_cumulatedConsumption|.output1_cumulatedConsumption]] - outlet's consumed energy (in Watthours)
* function [[Function devices.system.resetCumulativeConsumption()|.resetCumulativeConsumption()]] - resets outlet's energy counter
* string [[String devices.system.output1_consumptionStart|.output1_consumptionStart]] - date and time since the last energy counter reset

== Socket System Management ==
<big><b> devices.system</b> </big>
* number [[number devices.system.averageLoad|.averageLoad]] - socket's CPU load
* function [[Function devices.system.Reboot()|.Reboot()]] - reboot socket's system
* number [[Number devices.system.sessionCount|.sessionCount]] - number of connected users
* number [[Number devices.system.freeSpace|.freeSpace]] - free disk space
* number [[Number devices.system.totalSpace|.totalSpace]] - total disk space
* string [[String devices.system.serialNumber|.serialNumber]] <sup><code>3.3.1</code></sup> - returns serial number of the device (Eth Interface MAC address)
* number [[Number devices.system.voltage|.voltage]] <sup><code>3.0.0</code></sup> - socket's voltage
* number [[Number devices.system.overallPowerFactor|.overallPowerFactor]] <sup><code>3.0.0</code></sup> - overall power factor
* number [[Number devices.system.frequency|.frequency]] <sup><code>3.0.0</code></sup> - socket's frequency
* number [[Number devices.system.totalCurrent|.totalCurrent]] <sup><code>3.0.0</code></sup> - total current through socket
* number [[Number devices.system.totalLoad|.totalLoad]] <sup><code>3.0.0</code></sup> - total load on socket
* number [[Number devices.system.totalEnergy|.totalEnergy]] <sup><code>3.0.0</code></sup> - total energy consumed by socket
* string [[Number devices.system.energyStart|.energyStart]] <sup><code>3.0.0</code></sup> - time of last consumption reset

== Socket Communication ==
* function [[Function ping()|ping()]] - tests socket's network responsivity
* function [[Function mail()|mail()]] - sends e-mail
* function [[Function devices.system.CustomCGI()|devices.system.CustomCGI()]] - send HTTP request
* function [[Function cgiGet()|cgiGet()]] <sup><code>2.3.5</code></sup> - send HTTP request and receive response
* table [[Table event.args|event.args]] - HTTP GET /event variables table
* function [[Function snmpGet()|snmpGet()]] <sup><code>3.3.1</code></sup> - send SNMP request

== XML Processing <sup><code>2.3.6</code></sup> ==
<big><b>xml</b></big>
* function [[Function xml.escape()|.escape()]] - escapes XML string to fit xml node contents
* function [[Function xml.check()|.check()]] - tests if string is well-formed XML
* function [[Function xml.parse()|.parse()]] - parses XML string into [[Function xml.parse()#XmlElement|XmlElement]] object

== JSON Processing <sup><code>3.3.1</code></sup> ==
<big><b>json</b></big>
* function [[Function json.decode()|.decode()]] - parse json string into obj table
* function [[Function json.encode()|.encode()]] - generate JSON string from table

(based on [http://dkolf.de/src/dkjson-lua.fsl/home dkjson])

== Modbus <sup><code>3.3.1</code></sup>==
<big><b>Read functions</b></big>
* function [[Function modbusReadCoil()|modbusReadCoil()]] - read value from coil
* function [[Function modbusReadDiscreteInput()|modbusReadDiscreteInput()]] - read value from discrete input
* function [[Function modbusReadHoldingRegister()|modbusReadHoldingRegister()]] - read value from holding register
* function [[Function modbusReadInputRegister()|modbusReadInputRegister()]] - read value from input register

<big><b>Write functions</b></big>
* function [[Function modbusWriteSingleCoil()|modbusWriteSingleCoil()]] - write value to single coil
* function [[Function modbusWriteSingleRegister()|modbusWriteSingleRegister()]] - write value to single register

== MQTT <sup><code>3.3.1</code></sup>==
* function [[Function devices.system.MqttLuaSubscribe()|.MqttLuaSubscribe()]] - subscribe to MQTT topic
* function [[Function devices.system.MqttPublish()|.MqttPublish()]] - send message to MQTT topic

== Standard Lua Functions ==
* function [https://www.lua.org/pil/8.3.html assert(), error()] issues an error
* function [https://www.lua.org/pil/7.3.html ipairs(), pairs(), next()] traverse tables
* function [https://www.lua.org/pil/2.4.html tonumber(), tostring()] data type conversion
* function [https://www.lua.org/pil/8.4.html pcall()] protected call function (handles error inside the function)
* function [https://www.lua.org/pil/5.2.html select()] selects from multiple return value
* function [https://www.lua.org/pil/2.html unpack] converts table into multiple values
* function [https://www.lua.org/pil/2.html type()] returns variable type
* function [https://www.lua.org/pil/22.1.html os.date(), os.time()] system date and time
* function os.difftime() returns time span between two times

== Miscellaneous ==
* function [[Function log()|log()]] - insert a record to the socket's event log
* function [[Function logf()|logf()]] - insert a formated record (incl. numbers) to the socket's event log
* function [[Function delay()|delay()]] - execute function with delay (seconds)
* function [[Function milliDelay()|milliDelay()]] - execute function with delay (milliseconds)
* function [[Function toboolean()|toboolean()]] - converts any variable to boolean type

NETIO Specific Reference manual

2019-07-11T18:44:27Z

Admin: /* Script triggers */

== Script triggers ==
* [[Power measurements changed|Power measurements changed]]<sup><code>3.3.1</code></sup>
* [[Global power characteristics changed|Global power characteristics changed]]<sup><code>3.3.1</code></sup>
* [[Schedule has started or stopped|Schedule has started or stopped]]
* [[Incoming URL API request|Incoming URL API request]]
* [[System started up|System started up]]
* [[Mqtt was disconnected from the broker|Mqtt was disconnected from the broker]]<sup><code>3.3.1</code></sup>
* [[Mqtt received message on subscribed topic|Mqtt received message on subscribed topic]]<sup><code>3.3.1</code></sup>
* [[System variables updated|System variables updated]]
* [[Mqtt has connected to the broker|Mqtt has connected to the broker]]<sup><code>3.3.1</code></sup>
* [[DO state changed|DO state changed]]

== Outlet Management ==
<big><b> devices.system </b></big>
* function [[Function devices.system.SetOut()|.SetOut()]] - turns the outlet on or off
* function [[Function devices.system.ResetOut()|.ResetOut()]] - turns the outlet off and then resets its previous state
* string [[String devices.system.output1_state|.output1_state]] - outlet's state
* number [[Number devices.system.output1_consumption|.output1_consumption]] - outlet's consumption (in Watts)
* number [[Number devices.system.output1_cumulatedConsumption|.output1_cumulatedConsumption]] - outlet's consumed energy (in Watthours)
* function [[Function devices.system.resetCumulativeConsumption()|.resetCumulativeConsumption()]] - resets outlet's energy counter
* string [[String devices.system.output1_consumptionStart|.output1_consumptionStart]] - date and time since the last energy counter reset

== Socket System Management ==
<big><b> devices.system</b> </big>
* number [[number devices.system.averageLoad|.averageLoad]] - socket's CPU load
* function [[Function devices.system.Reboot()|.Reboot()]] - reboot socket's system
* number [[Number devices.system.sessionCount|.sessionCount]] - number of connected users
* number [[Number devices.system.freeSpace|.freeSpace]] - free disk space
* number [[Number devices.system.totalSpace|.totalSpace]] - total disk space
* string [[String devices.system.serialNumber|.serialNumber]] <sup><code>3.3.1</code></sup> - returns serial number of the device (Eth Interface MAC address)
* number [[Number devices.system.voltage|.voltage]] - socket's voltage
* number [[Number devices.system.overallPowerFactor|.overallPowerFactor]] - overall power factor
* number [[Number devices.system.frequency|.frequency]] - socket's frequency
* number [[Number devices.system.totalCurrent|.totalCurrent]] - total current through socket
* number [[Number devices.system.totalLoad|.totalLoad]] - total load on socket
* number [[Number devices.system.totalEnergy|.totalEnergy]] - total energy consumed by socket
* string [[Number devices.system.energyStart|.energyStart]] - time of last consumption reset

== Socket Communication ==
* function [[Function ping()|ping()]] - tests socket's network responsivity
* function [[Function mail()|mail()]] - sends e-mail
* function [[Function devices.system.CustomCGI()|devices.system.CustomCGI()]] - send HTTP request
* function [[Function cgiGet()|cgiGet()]] <sup><code>2.3.5</code></sup> - send HTTP request and receive response
* table [[Table event.args|event.args]] - HTTP GET /event variables table
* function [[Function snmpGet()|snmpGet()]] <sup><code>3.3.1</code></sup> - send SNMP request

== XML Processing <sup><code>2.3.6</code></sup> ==
<big><b>xml</b></big>
* function [[Function xml.escape()|.escape()]] - escapes XML string to fit xml node contents
* function [[Function xml.check()|.check()]] - tests if string is well-formed XML
* function [[Function xml.parse()|.parse()]] - parses XML string into [[Function xml.parse()#XmlElement|XmlElement]] object

== JSON Processing <sup><code>3.3.1</code></sup> ==
<big><b>json</b></big>
* function [[Function json.decode()|.decode()]] - parse json string into obj table
* function [[Function json.encode()|.encode()]] - generate JSON string from table

(based on [http://dkolf.de/src/dkjson-lua.fsl/home dkjson])

== Modbus <sup><code>3.3.1</code></sup>==
<big><b>Read functions</b></big>
* function [[Function modbusReadCoil()|modbusReadCoil()]] - read value from coil
* function [[Function modbusReadDiscreteInput()|modbusReadDiscreteInput()]] - read value from discrete input
* function [[Function modbusReadHoldingRegister()|modbusReadHoldingRegister()]] - read value from holding register
* function [[Function modbusReadInputRegister()|modbusReadInputRegister()]] - read value from input register

<big><b>Write functions</b></big>
* function [[Function modbusWriteSingleCoil()|modbusWriteSingleCoil()]] - write value to single coil
* function [[Function modbusWriteSingleRegister()|modbusWriteSingleRegister()]] - write value to single register

== MQTT <sup><code>3.3.1</code></sup>==
* function [[Function devices.system.MqttLuaSubscribe()|.MqttLuaSubscribe()]] - subscribe to MQTT topic
* function [[Function devices.system.MqttPublish()|.MqttPublish()]] - send message to MQTT topic

== Standard Lua Functions ==
* function [https://www.lua.org/pil/8.3.html assert(), error()] issues an error
* function [https://www.lua.org/pil/7.3.html ipairs(), pairs(), next()] traverse tables
* function [https://www.lua.org/pil/2.4.html tonumber(), tostring()] data type conversion
* function [https://www.lua.org/pil/8.4.html pcall()] protected call function (handles error inside the function)
* function [https://www.lua.org/pil/5.2.html select()] selects from multiple return value
* function [https://www.lua.org/pil/2.html unpack] converts table into multiple values
* function [https://www.lua.org/pil/2.html type()] returns variable type
* function [https://www.lua.org/pil/22.1.html os.date(), os.time()] system date and time
* function os.difftime() returns time span between two times

== Miscellaneous ==
* function [[Function log()|log()]] - insert a record to the socket's event log
* function [[Function logf()|logf()]] - insert a formated record (incl. numbers) to the socket's event log
* function [[Function delay()|delay()]] - execute function with delay (seconds)
* function [[Function milliDelay()|milliDelay()]] - execute function with delay (milliseconds)
* function [[Function toboolean()|toboolean()]] - converts any variable to boolean type

Welcome to NETIO resources & projects & documentation overview

2019-07-11T18:41:23Z

Admin: /* Lua in NETIO */

<div style="text-align: center; white-space: nowrap;">
<div style="display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 40%; vertical-align: top; white-space: normal;">
<div style="text-align: center; white-space: nowrap;">

<div style="background: #eaf6f2; display: inline-block; margin: 0 1em 0 1em; border-left: 0px solid gray; width: 45%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> Integration </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: left; vertical-align: top; white-space: normal;">
=== M2M API doc ===
[[MQTT-flex]]

[[MQTT]]

[[JSON API]]

[[XML API]]

[[URL API]]

[[SNMP]]

[[Telnet/Kshell]]

[[Modbus TCP]]

=== Examples ===
[https://www.home-assistant.io/components/netio/ Home Assistant]

[[IBM Cloud]] - MQTT-flex

[[IBM Cloud]] - NETIO 4x MQTT-LUA

[[Azure IoT Hub]] - MQTT

[[HiveMQ]] - MQTT-flex

[[NodeRED]] - JSON API

[https://www.jam-software.com/serversentinel/online_manual/EN/index.html?actions_netio230bnetworkpowersocket.html Jam-software - ServerSentinel]
</div>
</div>
<div style="background: #eaf6f2; display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 52%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> Community </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: left; vertical-align: top; white-space: normal;">
=== Official ===
[https://github.com/netioproducts GitHub - official]

[https://github.com/Koukaam/netio-utils/tree/master/actions GitHub - obsolete (Koukaam)]

=== Community ===
[https://github.com/stdevel/check_netio Nagios plugin]

[https://github.com/elmicro/fhem_netio_4x_pm FHEM module by Elmicro]

[https://github.com/imolein/lua-netio LUA control Library]

[https://github.com/rynr/netio Java Control Library]

[https://github.com/st3veV/Netio-OpenHAB OpenHAB using MQTT]

[https://jirikuba.github.io/NETIO.SpinaniHDO/ NETIO controlled by HDO]

[https://groups.google.com/forum/#!topic/openhab/O6psocjU70s Read consumption in OpenHAB - HTTP]

[https://www.instructables.com/id/How-to-Work-With-JSON-in-Node-RED/ NETIO 4All from NodeRED]

[https://github.com/theone1984/netio-jenkins Jenkins plugin]
</div>
</div>

</div>

</div>
<div style="display: inline-block; padding: 0 1em 0 1em; border-right: 0px solid gray; width: 60%; vertical-align: top; white-space: normal;">
<div style="background: #eaf6f2; display: inline-block; padding: 0 0 0 0; border-left: 0px solid gray; width: 98%; vertical-align: top; white-space: normal;">
<h2 style="background: #005f41; color: #FFF; margin: 0 0 0 0; padding: 0 1em 0 1em;"> NETIO Lua Programming </h2>
<div style=" display: inline-block; padding: 0 1em 0 1em;text-align: justify; vertical-align: top; white-space: normal;">
=== Don't know LUA? ===
==== [https://www.lua.org/pil/contents.html Official Lua tutorial] ====
If you are new to Lua and programming as such and if you are eager to learn, this is your starting point. Before you proceed to NETIO Sockets, this [https://www.lua.org/demo.html online environment] will be a good place to test your first scripts.
==== [https://www.lua.org/manual/5.3/ Official Lua manual] ====
Although you won't need everything mentioned here, it is worth to peek here from time to time to grasp the concepts of effective Lua programming.

=== Lua in NETIO ===
If you already know Lua, just keep in mind that <b>NETIO Lua loops are limited to 32k cycles</b> and all <b>numbers are integers, not decimals</b> like in standard Lua.
==== [[Lua basics for other language programmers]] ====
A quick jump into NETIO Lua programming if you mastered another programming language. It's simple...
==== [[NETIO Lua Tips & Philosophy]] ====
Explanation of starting LUA scripts in NETIO devices and some tips how to hack NETIO to doing what you want.

==== [[NETIO Specific Reference manual]] ====
If you can already code in Lua, NETIO-specific Lua functions is your main guide to programing NETIO Sockets.

==== [[Examples & Aplication notes]] ====
Aplication notes for devices supporting LUA programming. Example configurations downloads and Script programming explanation with direct links to reference
</div>
</div>
</div>
</div>
__NOTOC__

Lua basics for other language programmers

2019-07-11T18:39:04Z

Admin: Admin moved page Lua basics & NETIO Lua from original Lua difference to Lua basics for other language programmers

== Data types and variables ==
Lua supports these data types:
* <i>nil</i> (to assign <i>nil</i> value effectively deletes the variable)
* <i>boolean</i> (falsy values are <i>nil</i> and <i>false</i> only; "" and 0 evaluates as <i>true</i>)
* <i>number</i> (decimals only in standard Lua, integers only in Netio Lua)
* <i>string</i> (same strings share same address, so equality operator measures both address and value)
* <i>tables</i> are associative arrays. (Tables with numeric indices are, well, just arrays.)

local numbers = {2,3,7,5} -- array (first index = 1)
local dictionary = {one=1, two=2, three=3} -- table
local numbersZeroBased = {[0]=2,3,7,5} -- array (first index = 0)

<i>local</i> keyword limits the variable scope to the block (ended by <i>end</i>) where it is declared. To access an <i>upvalue</i> (variable defined outside of the scope), just omit the <i>local</i> keyword.

== Operators ==
Lua has its own manners:
* <code>~=</code> is inequality operator
* <code>..</code> is string concatenation (don't use plus)
* <code><s>i++</s></code> no increment/decrement operator <code>i = i + 1</code>
* <code><s>max = a<b ? b : a</s></code> no ternary operator. Use (and get used to) <i>and idiom</i> instead: <code>max = (a<b) and b or a</code>
* <i>or idiom</i> works: <code>x = x or 42</code> is equivalent to <code>if not x then x = 42 end</code>

== Conditions ==
Lua conditions has casual syntax, see [https://www.lua.org/pil/4.3.1.html here]. Just keep in mind to merge <code>else</code> and <code>if</code> to <code>elseif</code> or multiple <code>end</code>s are required.

Note that falsy values are <i>nil</i> and <i>false</i> only. Empty string and 0 evaluates as true. If you come from C, you might be surprised by following snippet:

if devices.system.output1_consumption then
-- always happens, even if the consumption is 0
log("Outlet 1 supplies power")
end

if not devices.system.output1_consumption then
-- never happens, even if the consumption is 0
log("Outlet 1 is idle")
end

== Loops ==
Lua has <code>break</code> statement, but no <code>continue</code> (use condition inside loop instead). Additionally, Netio Lua implementation limits the loop iterations to 32k.

=== While ===
While syntax is not different to other languages:
local i = 0
while i~=3 do
i = i + 1
logf("%d",i)
end

=== Repeat until ===
Repeat until syntax is the same as Pascal's, other languages have similar do-while loops:
local i = 0
repeat
i = i + 1
logf("%d",i)
until i==3

=== Numeric for ===
Arrays in Lua are one-based (in indices are not specified, the first one is 1, not 0).
local arr = {2,3,7,5}
for i=1,#arr do logf("%d",arr[i]) end
<code><b>for</b> initVar,limit,increment <b>do</b></code>
* <i>number assignment</i> <code>initVar</code> inits loop-local variable
* <i>number</i> <code>limit</code> loops until initVar reaches this value
* <i>optional number</i> <code>increment</code> after each loop initVar increment by this value (default 1)

=== Generic for ===
Is rather sophisticated. Most common example (the order of elements in <code>pairs()</code> is not guaranteed):
local tab = {one=1, two=2, three=3}
for key,val in pairs(tab) do logf("%s:%d",key,val) end
Generic for syntax
<b>for</b> var_1, ..., var_n <b>in</b> explist <b>do</b> block end
is equivalent to (Full explanation [https://www.lua.org/pil/7.2.html here].)
do
local _f, _s, _var = explist
while true do
local var_1, ... , var_n = _f(_s, _var)
_var = var_1
if _var == nil then break end
block
end
end

Iterator closure that holds its state
function iter(a)
local i = 0
return function()
i = i+1
return a[i]
end
end

local arr = {2,3,7,5}
for value in iter(arr) do
logf("%d",value)
end

Stateless iterator (in this case returns variable list: key and value)
function iter(a,i)
i = i+1
if a[i] then return i,a[i] end
end

local arr = {2,3,7,5}
for k,v in iter,arr,0 do
logf("%d:%d",k,v)
end

Same effect using <code>ipairs()</code> Lua function (without initial state)
for k,v in ipairs(arr) do
logf("%d:%d",k,v)
end

Now return to the most common example above using <code>pairs()</code> Lua function and read about <code>pairs()</code> and <code>ipairs()</code> implementation [https://www.lua.org/pil/7.3.html here].

== Functions ==

Lua allows multiple results (comma separated):

function diskSpace()
return devices.system.freeSpace, devices.system.totalSpace
end

logf("Free space: %d MB", diskSpace()) -- only first return value is used
local free,total = diskSpace() -- values are stored into LHS var-list
logf("Free space: %d %%", 100*free/total)

Variable-length arguments are also available:

function sum(...)
local result = 0
for _,v in ipairs(arg) do
result = result + v
end
return result
end

logf("Sum: %d", sum(2,3,5))

Lua basics & NETIO Lua from original Lua difference

2019-07-11T18:39:04Z

Admin: Admin moved page Lua basics & NETIO Lua from original Lua difference to Lua basics for other language programmers

#REDIRECT [[Lua basics for other language programmers]]

Main Page

2019-07-10T00:12:03Z

Admin: Changed redirect target from Welcome to NETIO resources, projects and documentation overview to Welcome to NETIO resources & projects & documentation overview

#REDIRECT [[Welcome to NETIO resources & projects & documentation overview]]

Main Page

2019-07-10T00:10:50Z

Admin: Changed redirect target from NETIO to Welcome to NETIO resources, projects and documentation overview

#REDIRECT [[Welcome to NETIO resources, projects and documentation overview]]

Welcome to NETIO resources & projects & documentation overview

2019-07-10T00:10:32Z

Admin: Admin moved page NETIO to Welcome to NETIO resources & projects & documentation overview without leaving a redirect

<div style="text-align: center; white-space: nowrap;">
<div style="display: inline-block; padding: 0 2em 2em 2em; margin-bottom: 2em; width: 46%; min-width: 15em; border-right: 1px solid gray; text-align: justify; vertical-align: top; white-space: normal;">

<h2 style="background: #005f41; color: #FFF; margin: 0 -1em; padding: 0 1em;"> NETIO Resources</h2>
<div style="text-align: center; white-space: nowrap;">
<div style="display: inline-block; padding: 0 0 0 0; width: 50%; margin-bottom: 1em; margin-top: 1em; min-width: 10em; text-align: justify; vertical-align: top; white-space: normal;">

=== M2M API Reference ===
[[MQTT Flex]]

[[MQTT]]

[[JSON API]]

[[XML API]]

[[URL API]]

[[SNMP]]

[[Telnet/Kshell]]

[[Modbus TCP]]

=== Integrations ===
[https://www.home-assistant.io/components/netio/ Home Assistant]

[[IBM Cloud]] - MQTT Flex

[[Azure IoT Hub]] - MQTT

[[HiveMQ]] - MQTT Flex

[[NodeRED]] - JSON API

[https://www.jam-software.com/serversentinel/online_manual/EN/index.html?actions_netio230bnetworkpowersocket.html Jam-software - ServerSentinel]

</div>

<div style="display: inline-block; padding: 0 0 2em 2em; margin-bottom: 1em; margin-top: 1em; border-left: 1px solid gray; width: 50%; min-width: 10em; text-align: justify; white-space: normal;">

=== Public projects & examples ===
==== Official ====
[https://github.com/netioproducts GitHub - official]

[https://github.com/Koukaam/netio-utils/tree/master/actions GitHub - obsolete (Koukaam)]

==== Community ====
[https://github.com/stdevel/check_netio Nagios plugin]

[https://github.com/elmicro/fhem_netio_4x_pm FHEM module by Elmicro]

[https://github.com/imolein/lua-netio LUA control Library]

[https://github.com/rynr/netio Java Control Library]

[https://github.com/st3veV/Netio-OpenHAB OpenHAB using MQTT]

[https://jirikuba.github.io/NETIO.SpinaniHDO/ NETIO controlled by HDO]

[https://groups.google.com/forum/#!topic/openhab/O6psocjU70s Read consumption in OpenHAB - HTTP]

[https://www.instructables.com/id/How-to-Work-With-JSON-in-Node-RED/ Controll NETIO 4All from NodeRED]

</div>
</div>

</div>

<div style="display: inline-block; padding: 0 2em; border-left: 1px solid gray; width: 46%; min-width: 15em; text-align: justify; white-space: normal;">

<h2 style="background: #005f41; color: #FFF; margin: 0 -1em; padding: 0 1em;"> NETIO Lua Programming </h2>
NETIO uses Lua as its scripting language. To master it, follow these references:

=== [https://www.lua.org/pil/contents.html Lua tutorial] ===
If you are new to Lua and programming as such and if you are eager to learn, this is your starting point. Before you proceed to NETIO Sockets, this [https://www.lua.org/demo.html online environment] will be a good place to test your first scripts.

=== [https://www.lua.org/manual/5.3/ Lua manual] ===
Although you won't need everything mentioned here, it is worth to peek here from time to time to grasp the concepts of effective Lua programming.

=== [[NETIO Lua Manual]] ===
A quick jump into NETIO Lua programming if you mastered another programming language. If you already know Lua, just keep in mind that NETIO Lua loops are limited to 32k cycles and all numbers are integers, not decimals like in standard Lua.

=== [[NETIO Lua Reference]] ===
If you can already code in Lua, NETIO-specific Lua functions is your main guide to programm NETIO Sockets.

=== [[LUA Aplication notes]] ===
Aplication notes for devices supporting LUA programming. Example configurations downloads and Script programming explanation with direct links to reference

</div>
</div>

__NOTOC__

Main Page

2019-07-10T00:09:30Z

Admin: Changed redirect target from Welcome to NETIO resources, projects and documentation overview to NETIO

#REDIRECT [[NETIO]]

Welcome to NETIO resources & projects & documentation overview

2017-06-26T12:33:22Z

Admin:

<div style="text-align: center; white-space: nowrap;">
<div style="display: inline-block; padding: 0 2em; margin-bottom: 2em; width: 40%; min-width: 15em; text-align: justify; vertical-align: top; white-space: normal;">
<div style="margin-bottom: 0.5em; margin-top: 50px; height: 50px;">[[File:Netio-mainlogo.png|200px]]</div>
<h2 style="background: #005f41; color: #FFF; margin: 0 -1em; padding: 0 1em;"> Introducing NETIO </h2>
NETIO sockets can operate just like any socket, but it can be connected as a network node and communicate in many protocols with various devices.

=== NETIO Features ===
Coming soon.

=== Connect NETIO to your network ===
Coming soon.

=== NETIO web interface ===
Coming soon.

=== A simple NETIO application ===
Coming soon.
</div><div style="display: inline-block; padding: 0 2em; border-left: 1px solid gray; width: 40%; min-width: 15em; text-align: justify; white-space: normal;">
<div style="margin-bottom: 0.5em; height: 100px">[[File:Netio-lua.png]]</div>
<h2 style="background: #005f41; color: #FFF; margin: 0 -1em; padding: 0 1em;"> NETIO Programming </h2>
NETIO uses Lua as its scripting language. To master it, follow these references:

=== [https://www.lua.org/pil/contents.html Lua tutorial] ===
If you are new to Lua and programming as such and if you are eager to learn, this is your starting point. Before you proceed to NETIO Sockets, this [https://www.lua.org/demo.html online environment] will be a good place to test your first scripts.

=== [[NETIO Lua Manual]] ===
A quick jump into NETIO Lua programming if you mastered another programming language. If you already know Lua, just keep in mind that NETIO Lua loops are limited to 32k cycles and all numbers are integers, not decimals like in standard Lua.

=== [[NETIO Lua Reference]] ===
If you can already code in Lua, NETIO-specific Lua functions is your main guide to programm NETIO Sockets.

=== [https://www.lua.org/manual/5.3/ Lua manual] ===
Although you won't need everything mentioned here, it is worth to peek here from time to time to grasp the concepts of effective Lua programming.

</div>
</div>

__NOTOC__

Welcome to NETIO resources & projects & documentation overview

2017-05-05T21:02:30Z

Admin: __NOTITLE__ extension test

__NOTITLE__
<center>[[Soubor:Netio-logo.png]]</center>

<center>
<div style="inline-block; float: left; padding: 0 2em; width: 40%; min-width: 15em; text-align: justify;">
<h2 style="background: #005f41; color: #FFF; margin: 0 -1em; padding: 0 1em;"> Introducing NETIO </h2>
NETIO sockets can operate just like any socket, but it can be connected as a network node and communicate in many protocols with various devices.

=== NETIO Features ===
Coming soon.

=== Connect NETIO to your network ===
Coming soon.

=== NETIO web interface ===
Coming soon.

=== A simple NETIO application ===
Coming soon.
</div>
<div style="inline-block; float: left; padding: 0 2em; border-left: 1px solid gray; width: 40%; min-width: 15em; text-align: justify;">
<h2 style="background: #005f41; color: #FFF; margin: 0 -1em; padding: 0 1em;"> NETIO Programming </h2>
NETIO uses Lua as its scripting language. To master it, follow these references:

=== [https://www.lua.org/pil/contents.html Lua tutorial] ===
If you are new to Lua and programming as such and if you are eager to learn, this is your starting point. Before you proceed to NETIO Sockets, this [https://www.lua.org/demo.html online environment] will be a good place to test your first scripts.

=== [[NETIO Lua Manual]] ===
A quick jump into NETIO Lua programming if you mastered another programming language. If you already know Lua, just keep in mind that NETIO Lua loops are limited to 32k cycles and all numbers are integers, not decimals like in standard Lua.

=== [[NETIO Lua Reference]] ===
If you can already code in Lua, NETIO-specific Lua functions is your main guide to programm NETIO Sockets.

=== [https://www.lua.org/manual/5.3/ Lua manual] ===
Although you won't need everything mentioned here, it is worth to peek here from time to time to grasp the concepts of effective Lua programming.

</div>
</center>

__NOTOC__

Testovací stránka

2016-08-31T16:00:44Z

Admin:

==== Toto je testovací stránka ====
<syntaxhighlight lang="lua">
function foo (a)
print("foo", a)
return coroutine.yield(2*a)
end

co = coroutine.create(function (a,b)
print("co-body", a, b)
local r = foo(a+1)
print("co-body", r)
local r, s = coroutine.yield(a+b, a-b)
print("co-body", r, s)
return b, "end"
end)

print("main", coroutine.resume(co, 1, 10))
print("main", coroutine.resume(co, "r"))
print("main", coroutine.resume(co, "x", "y"))
print("main", coroutine.resume(co, "x", "y"))
</syntaxhighlight>

Testovací stránka

2016-08-31T15:55:14Z

Admin:

==== Toto je testovací stránka ====
<syntaxhighlight>
function foo (a)
print("foo", a)
return coroutine.yield(2*a)
end

co = coroutine.create(function (a,b)
print("co-body", a, b)
local r = foo(a+1)
print("co-body", r)
local r, s = coroutine.yield(a+b, a-b)
print("co-body", r, s)
return b, "end"
end)

print("main", coroutine.resume(co, 1, 10))
print("main", coroutine.resume(co, "r"))
print("main", coroutine.resume(co, "x", "y"))
print("main", coroutine.resume(co, "x", "y"))
</syntaxhighlight>

Testovací stránka

2016-08-30T17:42:07Z

Admin: Založena nová stránka s textem „==== Toto je testovací stránka ====“

==== Toto je testovací stránka ====

NETIO Reference

2016-08-30T17:41:33Z

Admin:

'''MediaWiki byla úspěšně nainstalována.'''

[//meta.wikimedia.org/wiki/Help:Contents Uživatelská příručka] vám napoví, jak MediaWiki používat.
[[Testovací stránka]]

== Začínáme ==

* [//www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Nastavení konfigurace]
* [//www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ Často kladené otázky o MediaWiki]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce E-mailová konference oznámení MediaWiki]
* [//www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Překlad MediaWiki do vašeho jazyka]

NETIO Reference

2016-08-30T17:40:29Z

Admin:

'''MediaWiki byla úspěšně nainstalována.'''

[//meta.wikimedia.org/wiki/Help:Contents Uživatelská příručka] vám napoví, jak MediaWiki používat.
[Testovací stránka]

== Začínáme ==

* [//www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Nastavení konfigurace]
* [//www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ Často kladené otázky o MediaWiki]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce E-mailová konference oznámení MediaWiki]
* [//www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Překlad MediaWiki do vašeho jazyka]