Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iobroker-community-adapters/iobroker.myvbus

ioBroker Adapter for Resol VBus
https://github.com/iobroker-community-adapters/iobroker.myvbus

iobroker-adapter resol vbus

Last synced: about 1 month ago
JSON representation

ioBroker Adapter for Resol VBus

Awesome Lists containing this project

README

        

# ioBroker.myvbus

![Logo](admin/myvbus.png)

![Number of Installations (latest)](http://iobroker.live/badges/myvbus-installed.svg)
[![Downloads](https://img.shields.io/npm/dm/iobroker.myvbus.svg)](https://www.npmjs.com/package/iobroker.myvbus)
![Number of Installations (stable)](http://iobroker.live/badges/myvbus-stable.svg)
[![NPM version](https://img.shields.io/npm/v/iobroker.myvbus.svg)](https://www.npmjs.com/package/iobroker.myvbus)
**Tests:** ![Test and Release](https://github.com/iobroker-community-adapters/iobroker.myvbus/workflows/Test%20and%20Release/badge.svg)

[![NPM](https://nodei.co/npm/iobroker.myvbus.png?downloads=true)](https://nodei.co/npm/iobroker.myvbus/)

## 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.

## 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
* 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

### **WORK IN PROGRESS**

* (simatec) Responsive Design added

### 0.4.0 (2024-08-13) - 2024H2 maintenance release

* (pdbjjens) Change: node>=18, js-contoller>=5 and admin>=6 required
* (pdbjjens) Change: Removed .npmignore
* (pdbjjens) New: Updated dependencies

### 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

## Legal Notices

RESOL, VBus, VBus.net, DeltaSol and others are trademarks or registered trademarks of RESOL - Elektronische Regelungen GmbH

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

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.