ioBroker.myvbus

Tests:

ioBroker Adapter for Resol VBus

This adapter connects ioBroker to various VBus-based devices using resol-vbus, a JavaScript library for the acquisition of RESOL VBus data, provided by Daniel Wippermann.

https://github.com/danielwippermann/resol-vbus

https://www.npmjs.com/package/resol-vbus

Features

• Enables reading of the measurement data from various RESOL(R) VBus(R) devices - preferably solar and system controllers from the DeltaSol(R) series including built-in heat quantity meters (HQM) - using DL3 or DL2 data loggers, KM2 communication modules, VBus/LAN interface adapters or serial/LAN gateways locally via TCP/IP.
• Device access using the VBus/USB serial interface adapter or via VBus.net(R) using DLx/KMx is also supported.
• Processes live VBus data streams and makes them available as ioBroker states.
• Values are updated with a configurable cycle time.
• Reading or setting the VBus device configuration parameters is not supported. The tools provided by Resol should be used for this, e.g. via VBus.net or the parameterization tool RPT.
  A derived version of this adapter supporting control of VBus devices is available at https://github.com/Grizzelbee/ioBroker.resol
• Reading DL3 channel 0 (sensors directly connected to the DL3 device) is not supported due to limitations of the DL3 interface.

Configuration hints

• The connection device type e.g. VBus/LAN or DL2 must be explicitly selected, otherwise no connection will be established.
• TCP connection port: The default setting 7053 should not be changed
• Device password: The password which you have set in your connection device (default: vbus)
• DL3 channel: Only relevant for DL3/DL2Plus - leave at "None" for all other connection devices.
  (allowed values: 1-6, channel 0 cannot be read out)
• Update interval: The time between updates of the measured values (default 30s)
• The correct settings for direct LAN access for VBus/LAN, DL3, DL2, KM2 are:
  • Connection Device: VBus/LAN or KM2/DL2 or DL3/DL2Plus
  • Device Address: IP address (e.g. 192.168.178.188) or FullyQualifiedHostName (e.g. myKM2.fritz.box)
• The correct settings for the DL3, DL2, KM2 access via VBus.net are:
  • Connection Device: DL3/DL2Plus or DL2/KM2
  • Device Address: vbus.net (or vbus.io) - both without http:// and Via identifier!
  • Via Tag: YourViaIdentifier (e.g. d1234567890) - without http:// before or .vbus.io behind

Changelog

0.3.0 (2024-01-24) - 2024 maintenance release

• (pdbjjens) New: Use JSON config UI
• (pdbjjens) New: Support ioBroker discovery
• (pdbjjens) Change: node>=16, js-contoller>=4 and admin>=6 required
• (pdbjjens) Updated dependencies
• (pdbjjens) Fix: Set info.connection false when reconnecting

0.2.5 (2023-03-14)

• (pdbjjens) Updated dependencies
• (pdbjjens) Fix: reconnect handling for serial connections

0.2.4 (2023-03-01)

• (pdbjjens) Fix password check

0.2.3 (2023-02-27) - 2023 maintenance release

• (pdbjjens) Updated dependencies
• (pdbjjens) New: Use adapter-dev instead of gulp translate
• (pdbjjens) Fix: error handling for serial connections

0.2.2 (2022-02-11)

• Updated dependencies
• Compatibility check for js-controller 4.0
• Support for js-controller 1.x dropped

Legal Notices

RESOL, VBus, VBus.net, DeltaSol and others are trademarks or registered trademarks of RESOL - Elektronische Regelungen GmbH https://www.resol.de/en

All other trademarks are the property of their respective owners. The authors are in no way endorsed by or affiliated with RESOL GmbH, or any associated subsidiaries, logos or trademarks.

License

MIT License

Copyright (c) 2024 Jens-Peter Jensen [e-mail]

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.