Подключите свои устройства Resol VBus

Кредиты

Этот адаптер создан на основе адаптера myVbus и разработан DutchmanNL и pdbjjens. Большое спасибо им обоим за их работу. Поскольку pdbjjens хотел только считывать значения из VBUS, а некоторым пользователям требуется более широкий контроль над своими устройствами, был создан этот адаптер. Здесь вы получаете возможность управлять своим контроллером VBUS.

Адаптер ioBroker для Resol VBus

Этот адаптер подключает различные устройства на базе VBus к ioBroker, поддерживая различные типы соединений.

Если вам понравился этот адаптер, пожалуйста, поддержите меня.

В нём используется библиотека resol-vbus на JavaScript, предоставленная Даниэлем Випперманном. Для более подробного ознакомления посетите https://github.com/danielwippermann/resol-vbus .

Функции

• Позволяет считывать данные измерений с различных устройств RESOL(R) VBus(R) — предпочтительно солнечных и системных контроллеров серии DeltaSol(R), включая встроенные измерители количества тепла (HQM) — с помощью регистраторов данных DL3 или DL2, коммуникационных модулей KM2, адаптеров интерфейса VBus/LAN или последовательных/LAN-шлюзов локально по протоколу TCP/IP.
• Доступ к устройству также поддерживается с помощью адаптера последовательного интерфейса VBus/USB или через VBus.net(R) с использованием DLx/KMx.
• Обрабатывает потоки данных VBus в реальном времени и делает их доступными в виде состояний ioBroker.
• Значения обновляются с настраиваемым циклом.
• Чтение или установка параметров конфигурации устройства VBus не поддерживается. Для этого следует использовать инструменты, предоставляемые Resol, например, через VBus.net или инструмент параметризации RPT.
• Считывание данных с канала 0 DL3 (датчиков, напрямую подключенных к устройству DL3) не поддерживается из-за ограничений интерфейса DL3.

Подсказки по настройке

• По умолчанию тип подключения — VBus/LAN, но его необходимо явно выбрать даже для VBus/LAN, иначе соединение не будет установлено.
• Правильные настройки для прямого доступа к локальной сети для VBus/LAN, DL3, DL2, KM2 следующие:
  • Тип подключения: VBus/LAN, KM2, DL2 или DL3
  • Идентификатор соединения: IP-адрес (например, 192.168.178.188) или полное имя хоста (например, host1.example.com)
  • Пароль VBus: YourVBusPassword (по умолчанию: vbus)
  • Порт подключения: значение по умолчанию 7053 изменять не следует.
  • Канал DL3: Актуально только для DL3 (значения 1-6, канал 0 не может быть считан).
  • Интервал обновления: Время между обновлениями измеренных значений (по умолчанию 30 с).
• Правильные настройки для доступа к DL3, DL2, KM2 через VBus.net следующие:
  • Тип подключения: vbus.net
  • Идентификатор соединения: оставьте пустым
  • Порт подключения: значение по умолчанию 7053 изменять не следует.
  • Пароль VBus: YourVBusPassword (по умолчанию: vbus)
  • Канал DL3: Актуально только для DL3 (значения: 1-6, канал 0 не может быть считан).
  • Идентификатор Via: Ваш Via-тег (например, d1234567890.vbus.io) — без префикса http:// перед ним.
  • Интервал обновления: Время между обновлениями измеренных значений (по умолчанию 30 с).

Примеры:

Подключение через USB/последовательный порт

Подключение через локальную сеть.

Это включает в себя:

• LAN
• Устройства KM2
• Устройства DL2
• Устройства DL3 (выбор канала важен, канал 0 не поддерживается)
• Шлюзы последовательного порта в локальную сеть

Подключение через vbus.net компанией Resol.

Ваш персональный Via-tag для каждого устройства вы найдете на главной странице vbus.net в разделе: Мой VBus.net - Мои устройства. Лучше всего скопировать/вставить его оттуда — без http://

Отправка команд на устройство разрешения

Отредактируйте файл вашего контроллера, который вы найдете в каталоге установки 'lib\resol-setup'.

{"dp": [{"dpName":"Pumpe1","type":"number","min":0,"max":2}, {"dpName":"Pumpe2","type":"number","min":0,"max":2}, {"dpName":"AutoRueckkuehl","type":"number","min":0,"max":1} ],

"fct": [{"name":"Pumpe1","cmd":"Handbetrieb1","val":"val"}, {"name":"Pumpe2","cmd":"Handbetrieb2","val":"val"}, {"name":"AutoRueckkuehl","cmds":[{"cmd":"ORueckkuehlung","val":"val"},{"cmd":"OHolyCool","val":"val"}]} ]}

Элементы "dp" будут созданы после установки адаптера. Элементы "fct", "name" связаны с именем элемента dpName. Пример: если вы измените значение в объекте "Pumpe1", адаптер отправит команду "Handbetrieb1" с этим значением на устройство Resol. Также возможно создание нескольких команд. Например, "AutoRueckkuehl".

Как добавить новую команду

например, охлаждение для устройства resol cs plus

Обратите внимание на идентификатор устройства в объектах resol (8721). Откройте файл селектора lib/resol-setup/Setup-Resol-Types.js и обратите внимание на строку, соответствующую идентификатору устройства: {"id":8721,"setup":"setup-resol-deltasol-cs-plus","data":"resol-deltasol-cs-plus-110-data"},

Откройте файл resol-deltasol-cs-plus-110-data.js в каталоге resol-vbus/src/configuration-optimizers. Найдите в этом файле строку 'ORueckkuehlung'.

Откройте файл setup-resol-deltasol-cs-plus.js в каталоге lib/resol-setup/. Добавьте строку в раздел "dp": {"dpName":"Rueckkuehlung","type":"number","min":0,"max":1}. Добавьте строку в раздел "fct": {"name":"Rueckkuehlung","cmd":"ORueckkuehlung","val":"val"}.

Файл должен выглядеть следующим образом.

{"dp": [{"dpName":"Pumpe1","type":"number","min":0,"max":2}, {"dpName":"Pumpe2","type":"number","min":0,"max":2}, {"dpName":"Rueckkuehlung","type":"number","min":0,"max":1}, {"dpName":"AutoRueckkuehl","type":"number","min":0,"max":1} ],

"fct": [{"name":"Pumpe1","cmd":"Handbetrieb1","val":"val"}, {"name":"Pumpe2","cmd":"Handbetrieb2","val":"val"}, {"name":"Rueckkuehlung","cmd":"ORueckkuehlung","val":"val"}, {"name":"AutoRueckkuehl","cmds":[{"cmd":"ORueckkuehlung","val":"val"},{"cmd":"OHolyCool","val":"val"}]} ]}

Сохраните файл и перезапустите адаптер; теперь вы увидите новый объект Rueckkuehlung.

Все

Юридические уведомления

RESOL, VBus, VBus.net, DeltaSol и другие являются торговыми марками или зарегистрированными торговыми марками RESOL - Elektronische Regelungen GmbH https://www.resol.de/en

Все остальные товарные знаки являются собственностью их соответствующих владельцев.

sentry.io

Этот адаптер использует sentry.io для сбора информации о сбоях и автоматического сообщения о них автору. Для этого используется плагин ioBroker.sentry . Подробную информацию о том, что делает плагин, какая информация собирается и как отключить его, если вы не хотите предоставлять автору информацию о сбоях, вы можете найти на домашней странице плагина .

Авторские права

Авторские права (c) 2024 grizzelbee open.source@hingsen.de

Changelog

1.5.1 (2024-10-18)

• (grizzelbee) Fix: Fixed minor issues in Admin-UI

1.5.0 (2024-10-01)

• (grizzelbee) Upd: Fixed some issues mentioned by adapter-checker

1.4.2 (2024-10-01)

• (grizzelbee) Upd: Internal update

1.4.1 (2024-10-01)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Plugin-Sentry removed
• (grizzelbee) Upd: made release script working

1.4.0 (2024-07-xx)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Upd: Translations got updated
• (grizzelbee) Fix: Finished work on new jsonConfig admin-UI
• (grizzelbee) New: Added new option for MX-Controllers to admin-UI
• (grizzelbee) New: Admin-UI now hides options which are invalid for the selected device.
• (gargano) New: Integrated Actions for MX-Controller (V1 and V2)

1.3.0 (2022-11-01)

• (grizzelbee) Fix: #106 Attempt to fix errors in log regarding DeltaSol-BX
• (grizzelbee) Fix: #108 Attempt to fix errors in log regarding DeltaSol-SLT and others
• (grizzelbee) New: Moved Admin interface to jsonConfig
• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Upd: Translations got updated

v1.2.0 (2022-05-16)

• (grizzelbee) New: #106 Added support for DeltaSol-BX

v1.1.6 (2022-05-04)

• (grizzelbee) Fix: #103 Fixed support for Serial-to-LAN-Gateway connections (Disabled credentials handshake - which is not necessary over serial ports.)

v1.1.5 (2022-04-29)

• (grizzelbee) New: #96 Fixed Cosmo-Multi-2 support (Faking a DeltaSol-E now)

v1.1.0 (2022-04-28)

• (grizzelbee) New: #96 Added support for DeltaSol-E and improved support for Cosmo-Multi-2 controllers

v1.0.0 (2022-04-25)

• (grizzelbee) New: #94 Added support for Cosmo controllers (No Sensor connected = 888°C)
• (grizzelbee) Upd: Pushed version from 0.4.4 to v1.0.0 to be compliant to semver
• (grizzelbee) Upd: Dependencies got updated

v0.4.4 (2022-03-17)

• (grizzelbee) New: Added donate button to config page and readme
• (grizzelbee) Upd: Dependencies got updated

v0.4.3 (2022-02-08)

• (grizzelbee) Fix: fixed wrong state role "switch" and changed to "level"

v0.4.2 (2022-01-05)

• (grizzelbee) Fix: Removed password encryption stuff from admin to avoid double encryption

v0.4.1 (2022-01-05)

• (grizzelbee) Fix: switched action roles from "indicator" to "switch" to be compliant with ioBroker rules
• (grizzelbee) Fix: Removed password encryption stuff and added dependency Admin >=4.0.9
• (grizzelbee) Fix: Fixed a few code warnings
• (grizzelbee) Fix: Fixed: info.connection has been written w/o ACK
• (grizzelbee) Upd: updated dependencies

v0.4.0 (2021-11-08)

• (grizzelbee) Upd: updated dependencies
• (grizzelbee) New: Trying more than one time to connect when network isn't setup properly. E.g. on router startup.

v0.3.3 (2021-11-04)

• (grizzelbee) Upd: updated dependencies
• (grizzelbee) Upd: Switched from adapter-type climate-control to energy

v0.3.2 (2021-09-16)

• (grizzelbee) Upd: updated dependencies
• (grizzelbee) Fix: #27 Fixed: State value to set for "resol.0.xxx.010221110010002220" has to be type "number" but received type "string" - it may be needed to delete datapoints manually
• (grizzelbee) Upd: set correct tier in io-package
• (grizzelbee) New: Writing value null when received value is <= -999 and >= 999. This is to avoid writing crap when no sensors are connected.
• (grizzelbee) New: Making use of adapter internal decrypt function (req. at least js-controller >= 3.0)

v0.3.1 (2021-05-07)

• (gargano) Fix: wrong object types fixed according JS-Controller 3.x
• (gargano) Fix: prevent setState if value = undefined
• (gargano) Upd: Updated resol lib by Daniel Wippermann to v0.22.0
• (grizzelbee) New: Added sentry
• (grizzelbee) Fix: Made eslint happy
• (grizzelbee) Upd: updated dependencies

v0.3.0 (2021-01-xx)

• (grizzelbee) Upd: Updated dependencies
• (grizzelbee) New: Log connection-losts as info

v0.2.1 (2021-01-23)

• (gargano) New: write function to resol device added

v0.2.0 (2021-01-18)

• (grizzelbee) New: New Icon
• (grizzelbee) Upd: Update resol-Bus lib to V0.21.0
• (grizzelbee) Upd: Security-Update to lodash lib
• (grizzelbee) Upd: Reorganized configuration to get it more intuitive
• (grizzelbee) Upd: Config-page translated via gulp
• (grizzelbee) New: Changed the way to configure access via vbus.net to be more intuitive
• (grizzelbee) New: Extended documentation
• (grizzelbee) Fix: Adapter doesn't crash on connection losts anymore

v0.1.0 (2020-03-29)

• (grizzelbee) Fix: config page shows current settings now (not default anymore) May raise the need to reenter the password!
• (grizzelbee) Fix: "Connected" state is updated correctly now if connection is disrupted.
• (grizzelbee) New: Added Badge for latest(npm) version to readme
• (grizzelbee) Fix: removed default password from config to ensure it's encrypted on first config
• (grizzelbee) Fix: removed Force-ReInit
• (grizzelbee) Fix: sensor maintenance indicators are working booleans now
• (grizzelbee) New: added new activity indicator states for each relais.
• (grizzelbee) New: testing configuration to avoid start with invalid config

v0.0.6

• (pdbjjens) alpha 6 release updated dependencies

v0.0.5

• (pdbjjens) alpha 5 release improved type and role mapping of adapter values

v0.0.4

• (pdbjjens) alpha 4 release updated dependency on resol-vbus library to 0.21.0

v0.0.3

• (pdbjjens) alpha 3 release tested with DL3 over local LAN and VBus.net and DeltaSol SLT (0x1001) incl. HQM (0x1011)

v0.0.2

• (pdbjjens) alpha 2 release tested with VBus/LAN, KM2, VBus.net and DeltaSol E (0x7721 & 0x7722), DeltaSol M (0x7311 & 0x716), DeltaSol CS Plus (0x2211), Oventrop RQXXL (0x7541)

v0.0.1

• (pdbjjens) initial release tested only with VBus/USB (Serial) and DeltaSol(R) BS2009 (0x427B)

License

MIT License

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.