This page is part of archived documentation for openHAB 3.2. Go to the current stable version

# Anel NET-PwrCtrl Binding

Monitor and control Anel NET-PwrCtrl devices.

NET-PwrCtrl devices are power sockets / relays that can be configured via browser but they can also be controlled over the network, e.g. with an Android or iPhone app - and also with openHAB via this binding. Some NET-PwrCtrl devices also have 8 I/O ports which can either be used to directly switch the sockets / relays, or they can be used as general input / output switches in openHAB.

# Supported Things

There are three kinds of devices (overview on manufacturer's homepage (opens new window)):

Anel NET-PwrCtrl HUT (opens new window)
( advanced-firmware )
Anel NET-PwrCtrl IO (opens new window)
( advanced-firmware )
Anel NET-PwrCtrl HOME (opens new window)
( home )
(only German version)
Anel NET-PwrCtrl HUT 2 (opens new window) Anel NET-PwrCtrl IO (opens new window) Anel NET-PwrCtrl HOME (opens new window)

Thing type IDs:

  • home: The smallest device, the HOME, is the only one with only three power sockets and only available in Germany.
  • simple-firmware: The PRO and REDUNDANT have eight power sockets and a similar (simplified) firmware as the HOME.
  • advanced-firmware: All others (ADV, IO, and the different HUT variants) have eight power sockets / relays, eight IO ports, and an advanced firmware.

An additional sensor (opens new window) may be used for monitoring temperature, humidity, and brightness. The sensor can be attached to a HUT device via an Ethernet cable (max length is 50m).

# Discovery

Devices can be discovered automatically if their UDP ports are configured as follows:

  • 75 / 77 (default)
  • 750 / 770
  • 7500 / 7700
  • 7750 / 7770

If a device is found for a specific port (excluding the default port), the subsequent port is also scanned, e.g. 7500/7700 → 7501/7701 → 7502/7702 → etc.

Depending on the network switch and router devices, discovery may or may not work on wireless networks. It should work reliably though on local wired networks.

# Thing Configuration

Each Thing requires the following configuration parameters.

Parameter Type Default Required Description
Hostname / IP address String net-control yes Hostname or IP address of the device
Send Port Integer 75 yes UDP port to send data to the device (in the anel web UI, it's the receive port!)
Receive Port Integer 77 yes UDP port to receive data from the device (in the anel web UI, it's the send port!)
User String user7 yes User to access the device (make sure it has rights to change relay / IO states!)
Password String anel yes Password of the given user

For multiple devices, please use exclusive UDP ports for each device. Ports above 1024 are recommended because they are outside the range of system ports.

Possible entries in your thing file could be (thing types home, simple-firmware, and advanced-firmware are explained above in Supported Things):

anel:home:mydevice1 [hostname="192.168.0.101", udpSendPort=7500, udpReceivePort=7700, user="user7", password="anel"]
anel:simple-firmware:mydevice2 [hostname="192.168.0.102", udpSendPort=7501, udpReceivePort=7701, user="user7", password="anel"]
anel:advanced-firmware:mydevice3 [hostname="192.168.0.103", udpSendPort=7502, udpReceivePort=7702, user="user7", password="anel"]
anel:advanced-firmware:mydevice4 [hostname="192.168.0.104", udpSendPort=7503, udpReceivePort=7703, user="user7", password="anel"]

# Channels

Depending on the thing type, the following channels are available.

Channel ID Item Type Supported Things Read Only Description
prop#name String all yes Name of the device
prop#temperature Number:Temperature simple / advanced yes Temperature of the integrated sensor
sensor#temperature Number:Temperature advanced yes Temperature of the optional external sensor
sensor#humidity Number advanced yes Humidity of the optional external sensor
sensor#brightness Number advanced yes Brightness of the optional external sensor
r1#name String all yes Name of relay / socket 1
r2#name String all yes Name of relay / socket 2
r3#name String all yes Name of relay / socket 3
r4#name String simple / advanced yes Name of relay / socket 4
r5#name String simple / advanced yes Name of relay / socket 5
r6#name String simple / advanced yes Name of relay / socket 6
r7#name String simple / advanced yes Name of relay / socket 7
r8#name String simple / advanced yes Name of relay / socket 8
r1#state Switch all no * State of relay / socket 1
r2#state Switch all no * State of relay / socket 2
r3#state Switch all no * State of relay / socket 3
r4#state Switch simple / advanced no * State of relay / socket 4
r5#state Switch simple / advanced no * State of relay / socket 5
r6#state Switch simple / advanced no * State of relay / socket 6
r7#state Switch simple / advanced no * State of relay / socket 7
r8#state Switch simple / advanced no * State of relay / socket 8
r1#locked Switch all yes Whether or not relay / socket 1 is locked
r2#locked Switch all yes Whether or not relay / socket 2 is locked
r3#locked Switch all yes Whether or not relay / socket 3 is locked
r4#locked Switch simple / advanced yes Whether or not relay / socket 4 is locked
r5#locked Switch simple / advanced yes Whether or not relay / socket 5 is locked
r6#locked Switch simple / advanced yes Whether or not relay / socket 6 is locked
r7#locked Switch simple / advanced yes Whether or not relay / socket 7 is locked
r8#locked Switch simple / advanced yes Whether or not relay / socket 8 is locked
io1#name String advanced yes Name of IO port 1
io2#name String advanced yes Name of IO port 2
io3#name String advanced yes Name of IO port 3
io4#name String advanced yes Name of IO port 4
io5#name String advanced yes Name of IO port 5
io6#name String advanced yes Name of IO port 6
io7#name String advanced yes Name of IO port 7
io8#name String advanced yes Name of IO port 8
io1#state Switch advanced no ** State of IO port 1
io2#state Switch advanced no ** State of IO port 2
io3#state Switch advanced no ** State of IO port 3
io4#state Switch advanced no ** State of IO port 4
io5#state Switch advanced no ** State of IO port 5
io6#state Switch advanced no ** State of IO port 6
io7#state Switch advanced no ** State of IO port 7
io8#state Switch advanced no ** State of IO port 8
io1#mode Switch advanced yes Mode of port 1: ON = input, OFF = output
io2#mode Switch advanced yes Mode of port 2: ON = input, OFF = output
io3#mode Switch advanced yes Mode of port 3: ON = input, OFF = output
io4#mode Switch advanced yes Mode of port 4: ON = input, OFF = output
io5#mode Switch advanced yes Mode of port 5: ON = input, OFF = output
io6#mode Switch advanced yes Mode of port 6: ON = input, OFF = output
io7#mode Switch advanced yes Mode of port 7: ON = input, OFF = output
io8#mode Switch advanced yes Mode of port 8: ON = input, OFF = output

* Relay / socket state is read-only if it is locked; otherwise it is changeable.
** IO port state is read-only if its mode is input, it is changeable if its mode is output.

# Full Example

.things file:

Thing anel:advanced-firmware:anel1 "Anel1" [hostname="192.168.0.100", udpSendPort=7500, udpReceivePort=7700, user="user7", password="anel"]

.items file:

// device properties
String              anel1name               "Anel1 Name"                {channel="anel:advanced-firmware:anel1:prop#name"}
Number:Temperature  anel1temperature        "Anel1 Temperature"         {channel="anel:advanced-firmware:anel1:prop#temperature"}

// external sensor properties
Number:Temperature  anel1sensorTemperature  "Anel1 Sensor Temperature"  {channel="anel:advanced-firmware:anel1:sensor#temperature"}
Number              anel1sensorHumidity     "Anel1 Sensor Humidity"     {channel="anel:advanced-firmware:anel1:sensor#humidity"}
Number              anel1sensorBrightness   "Anel1 Sensor Brightness"   {channel="anel:advanced-firmware:anel1:sensor#brightness"}

// relay names and states
String  anel1relay1name    "Anel1 Relay1 name"    {channel="anel:advanced-firmware:anel1:r1#name"}
Switch  anel1relay1locked  "Anel1 Relay1 locked"  {channel="anel:advanced-firmware:anel1:r1#locked"}
Switch  anel1relay1state   "Anel1 Relay1"         {channel="anel:advanced-firmware:anel1:r1#state"}
Switch  anel1relay2state   "Anel1 Relay2"         {channel="anel:advanced-firmware:anel1:r2#state"}
Switch  anel1relay3state   "Anel1 Relay3"         {channel="anel:advanced-firmware:anel1:r3#state"}
Switch  anel1relay4state   "Anel1 Relay4"         {channel="anel:advanced-firmware:anel1:r4#state"}
Switch  anel1relay5state   "Light Bedroom"        {channel="anel:advanced-firmware:anel1:r5#state"}
Switch  anel1relay6state   "Doorbell"             {channel="anel:advanced-firmware:anel1:r6#state"}
Switch  anel1relay7state   "Socket TV"            {channel="anel:advanced-firmware:anel1:r7#state"}
Switch  anel1relay8state   "Socket Terrace"       {channel="anel:advanced-firmware:anel1:r8#state"}

// IO port names and states
String  anel1io1name   "Anel1 IO1 name"     {channel="anel:advanced-firmware:anel1:io1#name"}
Switch  anel1io1mode   "Anel1 IO1 mode"     {channel="anel:advanced-firmware:anel1:io1#mode"}
Switch  anel1io1state  "Anel1 IO1"          {channel="anel:advanced-firmware:anel1:io1#state"}
Switch  anel1io2state  "Anel1 IO2"          {channel="anel:advanced-firmware:anel1:io2#state"}
Switch  anel1io3state  "Anel1 IO3"          {channel="anel:advanced-firmware:anel1:io3#state"}
Switch  anel1io4state  "Anel1 IO4"          {channel="anel:advanced-firmware:anel1:io4#state"}
Switch  anel1io5state  "Switch Bedroom"     {channel="anel:advanced-firmware:anel1:io5#state"}
Switch  anel1io6state  "Doorbell"           {channel="anel:advanced-firmware:anel1:io6#state"}
Switch  anel1io7state  "Switch Office"      {channel="anel:advanced-firmware:anel1:io7#state"}
Switch  anel1io8state  "Reed Contact Door"  {channel="anel:advanced-firmware:anel1:io8#state"}

.sitemap file:

sitemap anel label="Anel NET-PwrCtrl" {
  Frame label="Device and Sensor" {
    Text   item=anel1name               label="Anel1 Name"
    Text   item=anel1temperature        label="Anel1 Temperature [%.1f °C]"
    Text   item=anel1sensorTemperature  label="Anel1 Sensor Temperature [%.1f °C]"
    Text   item=anel1sensorHumidity     label="Anel1 Sensor Humidity [%.1f]"
    Text   item=anel1sensorBrightness   label="Anel1 Sensor Brightness [%.1f]"
  }
  Frame label="Relays" {
    Text   item=anel1relay1name  label="Relay 1 name" labelcolor=[anel1relay1locked==ON="green",anel1relay1locked==OFF="maroon"]
    Switch item=anel1relay1state
    Switch item=anel1relay2state
    Switch item=anel1relay3state
    Switch item=anel1relay4state
    Switch item=anel1relay5state
    Switch item=anel1relay6state
    Switch item=anel1relay7state
    Switch item=anel1relay8state
  }
  Frame label="IO Ports" {
    Text   item=anel1io1name     label="IO 1 name"    labelcolor=[anel1io1mode==OFF="green",anel1io1mode==ON="maroon"]
    Switch item=anel1io1state
    Switch item=anel1io2state
    Switch item=anel1io3state
    Switch item=anel1io4state
    Switch item=anel1io5state
    Switch item=anel1io6state
    Switch item=anel1io7state
    Switch item=anel1io8state
  }
}

The relay / IO port names are rarely useful because you probably set similar (static) labels for the state items.
The locked state / IO mode is also rarely relevant in practice, because it typically doesn't change.

.rules file:

rule "doorbell only at daytime"
when Item anel1io6state changed then
  if (now.getHoursOfDay >= 6 && now.getHoursOfDay <= 22) {
    anel1relay6state.sendCommand(if (anel1io6state.state != ON) ON else OFF)
  }
  someNotificationItem.sendCommand("Someone just rang the doorbell")
end

# Reference Documentation

The UDP protocol of Anel devices is explained here (opens new window).