dan1-de / iobroker.anelhut

Adapter to connect the NET-PwrCrtl devices of ANEL Electronic AG with iobroker

ioBroker.anelhut

Tests:

anelhut adapter for ioBroker

Adapter for the NET-PwrCrtl devices of ANEL Electronic AG. Manufacturer: https://shop.anel.eu/

This adapter is working with the following anel devices:

• NET-PwrCtrl HUT
• NET-PwrCtrl IO
• HOME
• PRO
• POWER
• ADV

Usage

• Install adapter

• Configure Devices

  • Enable UDP Communication on your Anel device

  • Insert the properties of your Anel device

    • DeviceName: Custom Name of your device. This name is used to display the device in the objects list. Example: anelhut.0.DeviceName
    • DeviceIP: IP Adress of your device (please use no hostname)
    • UDPSendPort: Insert the port which is shown in the webinterface of your Anel device. This is the recieve port from the view of the anel device (default: 75).
    • UDPRecievePort: Insert the port which is shown in webinterface of your Anel device. This is the send port from the view of the anel device (default: 77).
    • XOR User & Password: Disabled by default. For more security you can enable XOR user and password encryption. Not every anel device supports XOR user & password. Please check before enabling this feature, if your device supports this. You can check this in the created object structure (device -> general -> XOR_USER_Password). If the value is true, XOR User & Password is supported by your device.

    Important note: If you want to controll multiple devices, please use a different recieve port for each device. For example you can use port 77 for the first device and 78 for the second and 79 for the third and so on. If you only use one device, you can use the default port 77. For the send port the default port 75 can be used for all devices. You can change the ports on the webinterface of the device.

• Docker

  • Don't forget the port forwarding, if you like to use this adapter with a docker environment:
    • 77:77/udp #port forwarding first anel device
    • 78:78/udp #port forwarding second anel device
  • You can find a working docker-compose example for reference in this repository (examples/docker-compose.yml)

Note

This adapter was tested with all Anel devices. Thanks to the anel developer :). Please report any issues.

Known Issues

NET-PwrCtrl PRO

Please use the latest firmeware (4.2). You can download it from https://de.anel.eu/index.htm?src=support/hut/hut.htm

Changelog

1.0.15

• (dan1-de) Bugfix for new jscontroller 5

1.0.14

• (dan1-de) Added new Logs messages for Relais Switch Command in Debug Mode

1.0.13

• (dan1-de) Improved error message for user/password missing. Added new Testcase for Message decode of NET-PWRCTRL_07.1

1.0.12

• (dan1-de) Cosmetic change in index_m.html

1.0.11

• (dan1-de) Implemented fix for Relais Status "You are assigning a number to the state which expects a boolean" Github issue/26

1.0.10

• (dan1-de) Implemented XOR User/Password encryption; improved logging/log levels;

1.0.9

• (dan1-de) Corrected bug for Pro v3

1.0.8

• (dan1-de) Quick Fix: Corrected bug in io control

1.0.7

• (dan1-de) Added possibility to control IO's; Code restructure

1.0.6

• (dan1-de) Fixed issues with sensor; display only 3 relais at anel home device; display type code instead of only letter; fixed temperature

1.0.4

• (dan1-de) New Icon; Improved object structure

1.0.3

• (dan1-de) Improvements: logging, udp broadcast adress, configuration

1.0.0

• (dan1-de) initial release

License

MIT License

Copyright (c) 2023 dan1-de [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

iobroker.anelhut's Issues

Update stable version in repo from 1.0.13 to 1.0.14

Think about update stable version to 1.0.14

Version: stable=1.0.13 (32 days old) => latest=1.0.14 (30 days old)
Installs: stable=17 (50%), latest=6 (17.65%), total=34
Click to edit

Not working on Home V.3 - Firmware-Version: HOME 4.6

Describe the bug
I have installed the anelhut adapter on my iobroker.
I have done the standard configuration as also configured on my Anel Net Power Control Home.
I can connect over the web interface without any problems.

But on iobroker I can not connect and get the following errors in the log:

Adapter anelhut starting..
Found: 1 devices in configuration
Found device in config: test | 192.168.....
Adapter anelhut initialized
**UDP Server Error: Error: bind EACCES 0.0.0.0:77
at dgram.js:338:20
at processTicksAndRejections (internal/process/task_queues.js:85:21)**
check user admin pw iobroker: true
check group user admin group admin: false

the user I configured is admin and has all the rights

Is the adapter really working on HOME ?

No connection to Anel-Hut

Hi,

I use the actual Version of the anel adapter (1.08) now with the actual iobroker Version (5.1.23). In the previous version it worked fine.
I have now a problem connecting to Anel-Hut (FW 7.1). The correct data for device name, device IP, UDPSendPort, UDPRecievePort, user name and password are stored in the instance. However, no connection is made. There is an error in the log: UDP Server Error: Error: bind EACCES 0.0.0.0:77 at dgram.js: 338: 20 at processTicksAndRejections (internal / process / task_queues.js: 85: 21)

My Node.js: v12.22.0 on a Rasbipi 4

Update stable version in repo from 1.0.13 to 1.0.14

Think about update stable version to 1.0.14

Version: stable=1.0.13 (69 days old) => latest=1.0.14 (67 days old)
Installs: stable=24 (58.54%), latest=6 (14.63%), total=41
Click to edit

no readings from temperature sensor of NET-PwrCtrl ADV (firmware 6.5)

No object structure created

After installing the first entry in the device list device is shown under Objects as a 1-liner with no structure.

Log shows device found and full information record retrieved but no corresponding object structure created.

You are assigning a number to the state ... which expects a boolean.

javascript.0	2022-10-25 18:25:18.241	warn	at processTimers (node:internal/timers:502:7)
javascript.0	2022-10-25 18:25:18.241	warn	at listOnTimeout (node:internal/timers:561:11)
javascript.0	2022-10-25 18:25:18.241	warn	at Timeout._onTimeout (/opt/iobroker/node_modules/iobroker.javascript/lib/sandbox.js:1747:29)
javascript.0	2022-10-25 18:25:18.241	warn	at Object.setState (/opt/iobroker/node_modules/iobroker.javascript/lib/sandbox.js:1689:20)
javascript.0	2022-10-25 18:25:18.240	warn	You are assigning a number to the state "anelhut.0.Technikraum.relais.7.Status" which expects a boolean. Please fix your code to use a boolean or change the state type to number. This warning might become an error in future versions.

Don't work with js-controller

Describe the bug
After upgrading to js-controller 5.09 from 4.06 the adapter dont start anymore

Screenshots & Logfiles
2023-07-28 22:39:47.955 - error: anelhut.0 (3447) undefined is not a valid state value
2023-07-28 22:39:47.956 - error: anelhut.0 (3447) Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch().
2023-07-28 22:39:47.956 - error: anelhut.0 (3447) unhandled promise rejection: undefined is not a valid state value
2023-07-28 22:39:47.956 - error: anelhut.0 (3447) Error: undefined is not a valid state value
at Object.maybeCallbackWithError (/opt/iobroker/node_modules/@iobroker/js-controller-common/build/lib/common/maybeCallback.js:35:17)
at Anelhut._setState (/opt/iobroker/node_modules/@iobroker/js-controller-adapter/build/lib/adapter/adapter.js:5386:49)
at Anelhut.setState (/opt/iobroker/node_modules/@iobroker/js-controller-adapter/build/lib/adapter/adapter.js:5347:21)
at Anelhut.setDeviceProperties (/opt/iobroker/node_modules/iobroker.anelhut/build/main.js:211:14)
at async Anelhut.UpdateHutData (/opt/iobroker/node_modules/iobroker.anelhut/build/main.js:107:9)

Versions:

• Adapter version:
• JS-Controller version: 5.0.9
• Node version: v16.15.1
• Operating system: ubuntu 22.04

Unable to connect to NET-PwrCtrl PRO

Describe the bug
I'm unable to get a connection to my NET-PwrCtrl PRO Version PRO 3.0 DE established

To Reproduce
Steps to reproduce the behavior:

1. Enabled UDP connectivity
2. Oddly I can configure a password specifically for UCP communication but there is seemingly no user linked to it
3. Try all the combinations of users and/or passwords
4. No connection can be established

Expected behavior
I'd love to see some way of establishing a connection to the hardware and controlling all eight outputs.

Versions:

• Adapter version: 1.0.8
• JS-Controller version: 4.0.15
• Node version: 14.19.0
• Operating system: Debian 10 buster