From 627cc9d5902824de96a54aff05fa7ba9a914d5ba Mon Sep 17 00:00:00 2001 From: M Valla <12682715+mvalla@users.noreply.github.com> Date: Fri, 19 Apr 2024 00:22:48 +0200 Subject: [PATCH] [openwebnet] Thermo: new channels and README updates (#16652) * [openwebnet] added new channels: targetTemperature, heating and cooling to bus_thermo_zone Fixes #12019 * [openwebnet] cleaner code in updateModeAndFunction() to handle *4*1*w## messages * [openwebnet] Updated README. Added new device images --------- Signed-off-by: Massimo Valla Signed-off-by: Ciprian Pascu --- .../org.openhab.binding.openwebnet/README.md | 89 +++++++++--------- .../doc/BTI_F411_2.jpg | Bin 0 -> 8603 bytes .../doc/BTI_NT4695.jpg | Bin 0 -> 12028 bytes .../doc/F454_gateway.png | Bin 69409 -> 0 bytes .../internal/OpenWebNetBindingConstants.java | 4 +- .../OpenWebNetThermoregulationHandler.java | 83 ++++++++++++---- .../OH-INF/i18n/openwebnet.properties | 16 +++- .../resources/OH-INF/thing/BusThermoZone.xml | 6 +- .../main/resources/OH-INF/thing/channels.xml | 31 +++++- .../main/resources/OH-INF/update/update.xml | 14 +++ 10 files changed, 171 insertions(+), 72 deletions(-) create mode 100644 bundles/org.openhab.binding.openwebnet/doc/BTI_F411_2.jpg create mode 100644 bundles/org.openhab.binding.openwebnet/doc/BTI_NT4695.jpg delete mode 100644 bundles/org.openhab.binding.openwebnet/doc/F454_gateway.png diff --git a/bundles/org.openhab.binding.openwebnet/README.md b/bundles/org.openhab.binding.openwebnet/README.md index 7bbdb6f82db..d5d73a8d699 100644 --- a/bundles/org.openhab.binding.openwebnet/README.md +++ b/bundles/org.openhab.binding.openwebnet/README.md @@ -1,16 +1,18 @@ # OpenWebNet (BTicino/Legrand) Binding -This binding integrates BTicino / Legrand MyHOME® BUS and Zigbee wireless (MyHOME_Radio®) devices using the [OpenWebNet](https://en.wikipedia.org/wiki/OpenWebNet) protocol. +This binding integrates **BTicino / Legrand** **MyHOME ® - BUS/SCS** and **MyHOME ® Radio - Zigbee** wireless devices using the [OpenWebNet](https://en.wikipedia.org/wiki/OpenWebNet) protocol. The binding supports: -- both wired BUS/SCS (MyHOME) and wireless setups (MyHOME Zigbee). The two networks can be configured simultaneously -- auto discovery of BUS/SCS IP and Zigbee USB gateways; auto discovery of devices -- commands from openHAB and feedback (events) from BUS/SCS and wireless network +- both wired MyHOME - BUS/SCS and wireless MyHOME Radio - Zigbee setups. The two networks can be configured simultaneously +- auto discovery of MyHOME - BUS/SCS IP and MyHOME Radio - Zigbee USB gateways; auto discovery of devices +- commands from openHAB and feedback (events) from BUS/SCS and Radio network ![MyHOMEServer1 Gateway](doc/MyHOMEServer1_gateway.jpg) -![F454 Gateway](doc/F454_gateway.png) -![Zigbee USB Gateway](doc/USB_gateway.jpg) +![F411/2](doc/BTI_F411_2.jpg) +![NT4695](doc/BTI_NT4695.jpg) +![MyHOME Radio USB Gateway](doc/USB_gateway.jpg) + ## Supported Things @@ -18,9 +20,9 @@ In order for this binding to work, a **BTicino/Legrand OpenWebNet gateway** is n These gateways have been tested with the binding: -- **IP gateways** or scenario programmers, such as BTicino -[F454](https://catalogue.bticino.com/BTI-F454-EN), +- **MyHOME - BUS/SCS IP gateways** or scenario programmers, such as BTicino [MyHOMEServer1](https://catalogue.bticino.com/BTI-MYHOMESERVER1-EN), +[F454](https://catalogue.bticino.com/BTI-F454-EN), [MyHOME_Screen10 (MH4893C)](https://catalogue.bticino.com/BTI-MH4893C-EN), [MyHOME_Screen3,5 (LN4890)](https://www.homesystems-legrandgroup.com/home/-/productsheets/2452536), [MH201](https://catalogue.bticino.com/BTI-MH201-EN), @@ -29,7 +31,7 @@ These gateways have been tested with the binding: [MH200N](https://www.homesystems-legrandgroup.com/home/-/productsheets/2469209), [F453](https://www.homesystems-legrandgroup.com/home/-/productsheets/2703566), etc. -- **Zigbee USB Gateways**, such as [BTicino 3578](https://www.legrand.be/fr/catalogue/zigbee-interface-openzigbee-3578), also known as *Legrand 088328* +- **MyHOME Radio - Zigbee USB Gateways**, such as [BTicino 3578](https://www.legrand.be/fr/catalogue/zigbee-interface-openzigbee-3578), also known as *Legrand 088328* Some of these modules are not on the BTicino catalogue anymore. @@ -37,33 +39,33 @@ Some of these modules are not on the BTicino catalogue anymore. The following Things and OpenWebNet `WHOs` are supported: -### For BUS/SCS +### For MyHOME - BUS/SCS | Category | WHO | Thing Type IDs | Description | Status | |-------------------------------|:-----------:|:----------------------------------------------------------:|------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Gateway Management | `13` | `bus_gateway` | Any IP gateway supporting OpenWebNet protocol should work | Successfully tested: F452, F453, F453AV,F454, F455, MyHOMEServer1, MyHOME_Screen10, MyHOME_Screen3,5, MH201, MH202, MH200N. Some connection stability issues/gateway resets reported with MH202  | | Lighting | `1` | `bus_on_off_switch`, `bus_dimmer` | BUS switches and dimmers | Successfully tested: F411/2, F411/4, F411U2, F422, F429. Some discovery issues reported with F429 (DALI Dimmers) | | Automation | `2` | `bus_automation` | BUS roller shutters, with position feedback and auto-calibration | Successfully tested: LN4672M2 | -| Temperature Control | `4` | `bus_thermo_zone`, `bus_thermo_sensor`, `bus_thermo_cu` | Thermo zones management and temperature sensors (probes) | Successfully tested: H/LN4691, HS4692, KG4691; thermo sensors: L/N/NT4577 + 3455. Partially tested: Central Units 4-zones (models L/N/NT/HD/HC/HS4695) and 99-zones (model 3550). See [Channels - Thermo](#configuring-thermo) for more details | +| Temperature Control | `4` | `bus_thermo_zone`, `bus_thermo_sensor`, `bus_thermo_cu` | Thermo zones management and temperature sensors (probes) | Successfully tested: Thermostats H/LN4691, HS4692, KG4691; sensors (probes): L/N/NT4577 + 3455; Central Units 4-zones (models L/N/NT/HD/HC/HS4695) and 99-zones (model 3550). See [Channels - Thermo](#configuring-thermo) for more details | | Alarm | `5` | `bus_alarm_system`, `bus_alarm_zone` | BUS Alarm system and zones | Successfully tested: Burglar-alarm Unit 3486 | | Auxiliary (AUX) | `9` | `bus_aux` | AUX commands | Successfully tested: AUX configured for Burglar-alarm Unit 3486. **Only sending AUX commands is supported** | | Basic, CEN & CEN+ Scenarios | `0`, `15`, `25` | `bus_scenario_control`, `bus_cen_scenario_control`, `bus_cenplus_scenario_control` | Basic and CEN/CEN+ Scenarios events and virtual activation | Successfully tested: CEN/CEN+ scenario control: HC/HD/HS/L/N/NT4680 and basic scenario modules F420/IR3456 + L4680 (WHO=0) | | Dry Contact and IR Interfaces | `25` | `bus_dry_contact_ir` | Dry Contacts and IR Interfaces | Successfully tested: contact interfaces F428 and 3477; IR sensors: HC/HD/HS/L/N/NT4610 | | Energy Management | `18` | `bus_energy_meter` | Energy Management | Successfully tested: F520, F521. Partially tested: F522, F523 | -### For Zigbee (Radio) +### For MyHOME Radio - Zigbee | Category | WHO | Thing Type IDs | Description | Status | | -------------------- | :----: | :---------------------------------------------------: | :-------------------------------------------------------------------: | ------------------------------------ | -| Gateway Management | `13` | `zb_gateway` | Zigbee USB Gateway (models: BTI-3578 / LG 088328) | Tested: BTI-3578 and LG 088328 | -| Lighting | `1` | `zb_dimmer`, `zb_on_off_switch`, `zb_on_off_switch2u` | Zigbee dimmers, switches and 2-unit switches | Tested: BTI-4591, BTI-3584, BTI-4585 | -| Automation | `2` | `zb_automation` | Zigbee roller shutters | | +| Gateway Management | `13` | `zb_gateway` | MyHOME Radio - Zigbee USB Gateway (models: BTI-3578 / LG 088328) | Tested: BTI-3578 and LG 088328 | +| Lighting | `1` | `zb_dimmer`, `zb_on_off_switch`, `zb_on_off_switch2u` | Radio Zigbee dimmers, switches and 2-unit switches | Tested: BTI-4591, BTI-3584, BTI-4585 | +| Automation | `2` | `zb_automation` | Radio Zigbee roller shutters | | ## Discovery Gateway and Things discovery is supported by this binding. -### BUS/SCS Discovery +### MyHOME - BUS/SCS Discovery - BUS Gateway automatic discovery will work only for newer gateways supporting UPnP: F454, MyHOMEServer1, MH201, MH202, MH200N, MyHOME_Screen 10. For other gateways you can add them manually, see [Thing Configuration](#thing-configuration) below. @@ -80,9 +82,9 @@ Setting the parameter `discoveryByActivation=true` for a BUS gateway Thing makes If a device cannot be discovered automatically from Inbox it's always possible to add it manually, see [Configuring Devices](#configuring-devices). -### Zigbee Discovery +### MyHOME Radio - Zigbee Discovery -- The Zigbee USB Gateway must be inserted in one of the USB ports of the openHAB computer before a discovery is started +- The MyHOME Radio - Zigbee USB Gateway must be inserted in one of the USB ports of the openHAB computer before a discovery is started - _**IMPORTANT NOTE:**_ As for other openHAB bindings using the USB/serial ports, on Linux the `openhab` user must be member of the `dialout` group to be able to use USB/serial port; set the group with the following command: ```shell @@ -90,14 +92,14 @@ sudo usermod -a -G dialout openhab ``` - The user will need to logout and login to see the new group added. If you added your user to this group and still cannot get permission, reboot Linux to ensure the new group permission is attached to the `openhab` user. -- Once the Zigbee USB Gateway is added and online, a second Inbox scan will discover devices connected to it. Because of the Zigbee radio network, device discovery will take ~40-60 sec. Be patient! -- Wireless devices must be part of the same Zigbee network of the Zigbee USB Gateway to discover them. Please refer to [this video by BTicino](https://www.youtube.com/watch?v=CoIgg_Xqhbo) to setup a Zigbee wireless network which includes the Zigbee USB Gateway -- Only powered wireless devices part of the same Zigbee network and within radio coverage of the Zigbee USB Gateway will be discovered. Unreachable or not powered devices will be discovered as _GENERIC_ devices and cannot be controlled -- Wireless control units cannot be discovered by the Zigbee USB Gateway and therefore are not supported +- Once the MyHOME Radio - Zigbee USB Gateway is added and online, a second Inbox scan will discover devices connected to it. Because of the Zigbee radio network, device discovery will take ~40-60 sec. Be patient! +- Wireless devices must be part of the same Zigbee network of the MyHOME Radio - Zigbee USB Gateway to discover them. Please refer to [this video by BTicino](https://www.youtube.com/watch?v=CoIgg_Xqhbo) to setup a Zigbee wireless network which includes the MyHOME Radio - Zigbee USB Gateway +- Only powered wireless devices part of the same Zigbee network and within radio coverage of the MyHOME Radio - Zigbee USB Gateway will be discovered. Unreachable or not powered devices will be discovered as _GENERIC_ devices and cannot be controlled +- Wireless control units cannot be discovered by the MyHOME Radio - Zigbee USB Gateway and therefore are not supported ## Thing Configuration -### Configuring BUS/SCS Gateway +### Configuring MyHOME - BUS/SCS Gateway Configuration parameters are: @@ -109,18 +111,18 @@ Configuration parameters are: - if the BUS/SCS gateway is configured to accept connections from the openHAB computer IP address, no password should be required - in all other cases, a password must be configured. This includes gateways that have been discovered and added from Inbox: without a password configured they will remain OFFLINE - `discoveryByActivation`: discover BUS devices when they are activated also when a device scan hasn't been started from Inbox (`boolean`, _optional_, default: `false`). See [Discovery by Activation](#discovery-by-activation). -- `dateTimeSynch`: synchronise date and time of slave elements on the SCS BUS using openHAB timestamp (`boolean`, _optional_, default: `false`). Set this parameter to `true` to send time-date synchronisation commands on the BUS when the timestamp received from the gateway differs by more than 1 minute from that of openHAB. Useful if the BUS gateway is not syncronized with Internet time servers and with daylight saving time changes. +- `dateTimeSynch`: synchronise date and time of slave elements on the BUS using openHAB timestamp (`boolean`, _optional_, default: `false`). Set this parameter to `true` to send time-date synchronisation commands on the BUS when the timestamp received from the gateway differs by more than 1 minute from that of openHAB. Useful if the BUS gateway is not syncronized with Internet time servers and with daylight saving time changes. -Alternatively the BUS/SCS Gateway thing can be configured using the `.things` file, see `openwebnet.things` example [below](#full-example). +Alternatively the MyHOME - BUS/SCS Gateway Thing can be configured using the `.things` file, see `openwebnet.things` example [below](#full-example). -### Configuring Wireless Zigbee USB Gateway +### Configuring MyHOME Radio - Zigbee USB Gateway Configuration parameters are: -- `serialPort` : the serial port where the Zigbee USB Gateway is connected (`String`, _mandatory_) +- `serialPort` : the serial port where the MyHOME Radio - Zigbee USB Gateway is connected (`String`, _mandatory_) - Examples: `/dev/ttyUSB0` (Linux/RaPi), `COM3` (Windows) -Alternatively the Zigbee USB Gateway thing can be configured using the `.things` file, see `openwebnet.things` example [below](#full-example). +Alternatively the MyHOME Radio - Zigbee USB Gateway thing can be configured using the `.things` file, see `openwebnet.things` example [below](#full-example). ### Configuring Devices @@ -130,7 +132,7 @@ For any manually added device, you must configure: - the associated gateway Thing (`Parent Bridge` menu) - the `where` configuration parameter (`OpenWebNet Address`): this is the OpenWebNet address configured for the device in the BTicino/Legrand system. This address can be found either on the device itself (Physical configuration, using jumpers in case of BUS) or through the MyHOME_Suite software (Virtual configuration). The address can have several formats depending on the device/system: - - example for BUS/SCS system: + - example for MyHOME - BUS/SCS system: - light device A=`2` (Area 2), PL=`4` (Light-point 4) --> `where="24"` - light device A=`03`, PL=`11` on local bus `01` --> `where="0311#4#01"` - scenario control module address `53` --> `where="53"` @@ -163,7 +165,7 @@ The (optional) Central Unit can be configured defining a `bus_themo_cu` Thing wi ##### Thermo Central Unit integration known limitations -- Read CU setPoint temperature when in WEEKLY / SCENARIO / PROTECTION / VACATION / HOLIDAY +- Read Central Unit setPoint temperature when in WEEKLY / SCENARIO / PROTECTION / VACATION / HOLIDAY - Set VACATION deadline date / time - Central Unit Programming and Customisations settings (T1/2/3 temperature levels, setting date & time, weekly/scenarios/holiday profiles programming, etc.) @@ -210,7 +212,7 @@ OPEN command to execute: *5*8#134## ## Channels -### Lighting, Automation, Basic/CEN/CEN+ Scenario Events, Dry Contact / IR Interfaces, Power and Aux channels +### Lighting, Automation, Basic/CEN/CEN+ Scenario Events, Dry Contact / IR Interfaces, Power and AUX channels | Channel Type ID (channel ID) | Applies to Thing Type IDs | Item Type | Description | Read/Write | |-----------------------------------------|---------------------------------------------------------------|---------------|-----------------------------------------------------------------------------------------------------------------------|:-----------:| @@ -221,8 +223,8 @@ OPEN command to execute: *5*8#134## | `button#X` | `bus_cen_scenario_control`, `bus_cenplus_scenario_control` | String | Trigger channel for CEN/CEN+ scenario events [see possible values](#scenario-channels) | R (TRIGGER) | | `sensor` | `bus_dry_contact_ir` | Switch | Indicates if a Dry Contact Interface is `ON`/`OFF`, or if an IR Sensor is detecting movement (`ON`), or not (`OFF`) | R | | `power` | `bus_energy_meter` | Number:Power | The current active power usage from Energy Meter | R | -| `energyToday` | `bus_energy_meter` | Number:Energy | Current day energy totalizer | R | -| `energyThisMonth` | `bus_energy_meter` | Number:Energy | Current month energy totalizer | R | +| `energyToday` | `bus_energy_meter` | Number:Energy | Current day energy | R | +| `energyThisMonth` | `bus_energy_meter` | Number:Energy | Current month energy | R | | `aux` | `bus_aux` | String | Possible commands: `ON`, `OFF`, `TOGGLE`, `STOP`, `UP`, `DOWN`, `ENABLED`, `DISABLED`, `RESET_GEN`, `RESET_BI`, `RESET_TRI`. Only `ON` and `OFF` are supported for now | R/W | ### Alarm channels @@ -244,18 +246,21 @@ OPEN command to execute: *5*8#134## | ---------------------------- | -------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | :--------: | :------: | | `temperature` | `bus_thermo_zone`, `bus_thermo_sensor` | Number:Temperature | Currently sensed temperature for zone or sensor | R | N | | `setpointTemperature` | `bus_thermo_zone`, `bus_thermo_cu` | Number:Temperature | The zone or Central Unit manual setpoint temperature | R/W | N | -| `function` | `bus_thermo_zone`, `bus_thermo_cu` | String | The zone set thermo function (`COOLING`, `HEATING`, `GENERIC`) or the Central Unit thermo function (`COOLING`, `HEATING`) | R/W | N | +| `targetTemperature` | `bus_thermo_zone` | Number:Temperature | The current zone target temperature according to `mode`, `setpointTemperature` and `localOffset` | R | Y +|`function` | `bus_thermo_zone`, `bus_thermo_cu` | String | The zone set thermo function (`COOLING`, `HEATING`, `GENERIC`) or the Central Unit thermo function (`COOLING`, `HEATING`) | R/W | N | | `mode` | `bus_thermo_zone`, `bus_thermo_cu` | String | The zone set mode (`AUTO`, `MANUAL`, `OFF`, `PROTECTION`) or the Central Unit set mode (`WEEKLY`, `MANUAL`, `SCENARIO`, `HOLIDAY`, `VACATION`, `OFF`, `PROTECTION`) | R/W | N | | `speedFanCoil` | `bus_thermo_zone` | String | The zone fancoil speed: `AUTO`, `SPEED_1`, `SPEED_2`, `SPEED_3` | R/W | N | | `actuators` | `bus_thermo_zone` | String | The zone actuator(s) status: `OFF`, `ON`, `OPENED`, `CLOSED` , `STOP`, `OFF_FAN_COIL`, `ON_SPEED_1`, `ON_SPEED_2`, `ON_SPEED_3`, `OFF_SPEED_1`, `OFF_SPEED_2`, `OFF_SPEED_3` | R | Y | | `heatingValves` | `bus_thermo_zone` | String | The zone heating valve(s) status: `OFF`, `ON`, `OPENED`, `CLOSED` , `STOP`, `OFF_FAN_COIL`, `ON_SPEED_1`, `ON_SPEED_2`, `ON_SPEED_3`, `OFF_SPEED_1`, `OFF_SPEED_2`, `OFF_SPEED_3` | R | Y | | `conditioningValves` | `bus_thermo_zone` | String | The zone conditioning valve(s) status: `OFF`, `ON`, `OPENED`, `CLOSED` , `STOP`, `OFF_FAN_COIL`, `ON_SPEED_1`, `ON_SPEED_2`, `ON_SPEED_3`, `OFF_SPEED_1`, `OFF_SPEED_2`, `OFF_SPEED_3` | R | Y | -| `localOffset` | `bus_thermo_zone` | String | The zone local offset status: `OFF`, `PROTECTION`, `MINUS_3`, `MINUS_2` , `MINUS_1`, `NORMAL`, `PLUS_1`, `PLUS_2`, `PLUS_3` | R | Y | +| `heating` | `bus_thermo_zone` | Switch | `ON` if the zone heating valve is currently active (meaning heating is On) | R | Y | +| `cooling` | `bus_thermo_zone` | Switch | `ON` if the zone conditioning valve is currently active (meaning conditioning is On) | R | Y | +| `localOffset` | `bus_thermo_zone` | String | The zone local offset status: `OFF`, `PROTECTION`, `MINUS_3`, `MINUS_2` , `MINUS_1`, `NORMAL`, `PLUS_1`, `PLUS_2`, `PLUS_3`, as set on the room thermostat physical knob | R | Y | | `remoteControl` | `bus_thermo_cu` | String | The Central Unit Remote Control status: `ENABLED`, `DISABLED` | R | Y | | `batteryStatus` | `bus_thermo_cu` | String | The Central Unit Battery status: `OK`, `KO` | R | Y | | `weeklyProgram` | `bus_thermo_cu` | Number | The weekly program number (`1`, `2`, `3`) when Central Unit mode is `WEEKLY` | R/W | N | | `scenarioProgram` | `bus_thermo_cu` | Number | The scenario program number (`1`, `2`, ... , `16`) when Central Unit mode is `SCENARIO` | R/W | N | -| `vacationDays` | `bus_thermo_cu` | Number | Number of days 1-255 the Central Unit will be set to Anti-freeze / Heat Protection temperature before returning to mode WEEKLY | R/W | N | +| `vacationDays` | `bus_thermo_cu` | Number | Number of days `1-255` the Central Unit will be set to Anti-freeze / Heat Protection temperature before returning to mode `WEEKLY` | R/W | N | | `failureDiscovered` | `bus_thermo_cu` | Switch | Indicates if a Failure was discovered by the Central Unit (`ON`), or not (`OFF`) | R | Y | | `atLeastOneProbeOff` | `bus_thermo_cu` | Switch | Indicates if at least one probe is in OFF mode (`ON`) or not (`OFF`) | R | Y | | `atLeastOneProbeProtection` | `bus_thermo_cu` | Switch | Indicates if at least one probe is in PROTECTION mode (`ON`) or not (`OFF`) | R | Y | @@ -314,15 +319,15 @@ There are three WEEKLY and sixteen SCENARIO programs defined for the thermo Cent In order to activate one specific weekly or scenario program two different channels must be used: - with the `mode` channel it's possible to set the mode (`WEEKLY` or `SCENARIO`) -- with `weeklyProgram` (if `WEEKLY` was set) or `scenarioProgram` (if `SCENARIO` was set) channels you can set the specific weekly/scenario program number +- with `weeklyProgram` (if `WEEKLY` was set) or `scenarioProgram` (if `SCENARIO` was set) channels it's possible to set the specific weekly/scenario program number -Example: if you want to activate SCENARIO number 9 on the thermo Central Unit you have to set channel `mode` = `SCENARIO` and channel `scenarioProgram` = `9`. +Example: to activate SCENARIO number 9 on the thermo Central Unit then set channel `mode` = `SCENARIO` and channel `scenarioProgram` = `9`. ## Full Example ### openwebnet.things: -BUS gateway and things configuration: +MyHOME BUS/SCS gateway and Things configuration: ```java Bridge openwebnet:bus_gateway:mybridge "MyHOMEServer1" [ host="192.168.1.35", passwd="abcde", port=20000, discoveryByActivation=false ] { @@ -350,7 +355,7 @@ Bridge openwebnet:bus_gateway:mybridge "MyHOMEServer1" [ host="192.168.1.35", pa } ``` -Zigbee USB Gateway and things configuration - for radio devices: +MyHOME Radio - Zigbee USB Gateway and Things configuration: ```java Bridge openwebnet:zb_gateway:myZBgateway [ serialPort="COM3" ] { @@ -362,7 +367,7 @@ Bridge openwebnet:zb_gateway:myZBgateway [ serialPort="COM3" ] { ### openwebnet.items: -Example items linked to BUS devices: +Example items linked to MyHOME - BUS/SCS devices: NOTE: lights, blinds and zones (thermostat) can be handled from personal assistants (Google Home, Alexa). In the following example some `Google Assistant` (`ga="..."`) and `HomeKit` (`homekit="..."`) metadata were added as examples according to the [documentation for Google Assistant integration on openHAB](https://www.openhab.org/docs/ecosystem/google-assistant) and [the openHAB HomeKit Add-on documentation](https://www.openhab.org/addons/integrations/homekit/): see the specific openHAB documentation for updated configurations and more metadata options. @@ -421,7 +426,7 @@ Switch iAlarm_Zone_3_State "Zone 3 state" ( String iAlarm_Zone_3_Alarm "Zone 3 alarm" (gAlarm) { channel="openwebnet:bus_alarm_zone:mybridge:Alarm_Zone_3:alarm" } ``` -Example items linked to OpenWebNet Zigbee devices: +Example items linked to OpenWebNet MyHOME Radio - Zigbee devices: ```java Dimmer iDimmer "Dimmer [%.0f %%]" (gKitchen) [ "Lighting" ] { channel="openwebnet:zb_dimmer:myZBgateway:myZB_dimmer:brightness" } diff --git a/bundles/org.openhab.binding.openwebnet/doc/BTI_F411_2.jpg b/bundles/org.openhab.binding.openwebnet/doc/BTI_F411_2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3022721b5a7f101847fb3a588836afe46ce71d28 GIT binary patch literal 8603 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 literal 0 HcmV?d00001 diff --git a/bundles/org.openhab.binding.openwebnet/doc/BTI_NT4695.jpg b/bundles/org.openhab.binding.openwebnet/doc/BTI_NT4695.jpg new file mode 100644 index 0000000000000000000000000000000000000000..69e02ab114da692fb46a1d14e7c9c219787cdada GIT binary patch literal 12028 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 - + + + + @@ -31,6 +34,7 @@ BTicino/Legrand Zone thermostat BTI-LN4691 (stand-alone), 3550 (99 zones Central Unit) 410/420 + 1 ownId diff --git a/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/thing/channels.xml b/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/thing/channels.xml index 3ae800b1e5d..6cbc330b15b 100644 --- a/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/thing/channels.xml +++ b/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/thing/channels.xml @@ -113,6 +113,13 @@ + + Number:Temperature + + Target temperature (read only) + + + String @@ -121,7 +128,7 @@ - + @@ -186,6 +193,20 @@ + + Switch + + Heating is active in the zone (read only) + + + + + Switch + + Cooling is active in the zone (read only) + + + String @@ -215,7 +236,7 @@ - + @@ -236,7 +257,7 @@ - + @@ -287,7 +308,7 @@ Number - Number of days the Central Unit will be set to Antifreeze / Heat Protection target temperature before + Number of days the Central Unit will be set to Anti-freeze / Heat Protection target temperature before returning to mode WEEKLY (read/write) @@ -332,7 +353,7 @@ Switch - At least one probe in PROTECTION mode (Antifreeze / Heat Protection) indicator from Central Unit (read + At least one probe in PROTECTION mode (Anti-freeze / Heat Protection) indicator from Central Unit (read only) diff --git a/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/update/update.xml b/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/update/update.xml index bc53c452a38..221b152b414 100644 --- a/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/update/update.xml +++ b/bundles/org.openhab.binding.openwebnet/src/main/resources/OH-INF/update/update.xml @@ -29,4 +29,18 @@ + + + + openwebnet:targetTemperature + + + openwebnet:heating + + + openwebnet:cooling + + + +