Skip to content

Latest commit

 

History

History
124 lines (115 loc) · 7.17 KB

README.md

File metadata and controls

124 lines (115 loc) · 7.17 KB
Raw

ThermostatBecaWifi

GitHub version

Replaces original Tuya firmware on Beca thermostat with ESP8266 wifi module. The firmware is tested with following devices:

  • BHT-002, BHT-6000, BHT-3000 (floor heating)
  • AVATTO ME102H (Thermostat with LCD touch screen)
  • BAC-002 (heating, cooling, ventilation)
  • ET-81W
  • Floureon HY08WE
  • AVATTO ME81AH (floor heating, thanks to @lozb36 for implementation)
  • Minco Heat MK70GB-H (floor heating, thanks to @indimouse for implementation)
  • VH Control Calypso-W

BAC-002 ME102H

Function support since 1.20 (beta status)

For productive use only stable version 1.19. Version 1.20x_beta is rewritten to make the support of different models more easily in future. For model BHT-002 and ME102H the new version is tested and should work reliable already.

Function BHT-002 BHT-6000 BHT-3000 ME102H BAC-002 ET-81W HY08WE ME81AH MK70GBH Calypso-W*
actual temperature yes yes yes yes yes yes yes yes
target temperature yes yes yes yes yes yes yes yes
floor temperature yes yes no yes yes yes no yes
schedules mode auto off auto off auto off holiday auto hold off auto holiday hold auto off off auto hold holiday auto hold
locked yes yes yes yes yes yes yes yes
schedules 18 8 18 no no 8 8 no
system mode no no cool, heat, fan no no heat, cool, fan no no
fan mode no no auto, high, med, low no no no no no

'* needs testing

Features

  • No Tuya cloud connection anymore
  • Enables thermostat to communicate via MQTT and/or Mozilla Webthings
  • Configuration of connection and device parameters via web interface
  • NTP and time zone synchronisation to set the clock of thermostat
  • Reading and setting of all parameters via MQTT
  • Reading and setting of main parameters via Webthing
  • Only BHT-002-GBLW: actualFloorTemperature (external temperature sensor)
  • Only BAC-002-ALW: fanSpeed:auto|low|medium|high; systemMode:cooling|heating|ventilation
  • Reading and setting of time schedules via MQTT

Installation

To install the firmware, follow instructions here:
https://github.com/klausahrenberg/WThermostatBeca/blob/master/Flashing.md

Initial configuration

To setup the device model, network options and other parameters, follow instrcution here:
https://github.com/klausahrenberg/WThermostatBeca/blob/master/Configuration.md
After initial setup, the device configuration is still available via http://<device_ip>/config

Integration in Webthings

This firmware supports Mozilla Webthings directly. With Webthings you can control the device via the Gateway - inside and also outside of your home network. No clunky VPN, dynDNS solutions needed to access your home devices. I recommend to run the gateway in parallel to an MQTT server and for example Node-Red. Via MQTT you can control the device completely and logic can be done by Node-Red. Webthings is used for outside control of main parameters.
Add the device to the gateway via '+' icon. After that you have the new nice and shiny icon in the dashboard:
webthing_icon
The icon shows the actual temperature and heating state.
There is also a detailed view available:

Json structure

Firmware provides 3 different json messages:

  1. State report
  2. Schedules
  3. Device information (at start of device to let you know the topics and ip)

1. State report

MQTT: State report is provided every 5 minutes, at change of a parameter or at request via message with empty payload to <your_mqtt_topic>/thermostat/<your_state_topic>
Webthing: State report can be requested by: http://<device_ip>/things/thermostat/properties

{
  "idx":"thermostat_beca",
  "ip":"192.168.x.x",
  "firmware":"x.xx",
  "temperature":21.5,
  "targetTemperature":23,
  "deviceOn":true,
  "schedulesMode":"off|auto",
  "ecoMode":false,
  "locked":false,
  "state":"off|heating", //only_available,_if_hardware_modified
  "floorTemperature":20, //only_BHT-002-GBLW
  "fanMode":"auto|low|medium|high", //only_BAC-002-ALW
  "systemMode":"cool|heat|fan_only" //only_BAC-002-ALW
}

2. Schedules

MQTT: Request actual schedules via message with empty payload to <your_mqtt_topic>/thermostat/<your_state_topic>/schedules Webthing: State report can be requested by: http://<device_ip>/things/thermostat/schedules

{
  "w1h":"06:00",
  "w1t":20,
  "w2h":"08:00",
  "w2t":15,
  ...
  "w6h":"22:00",
  "w6t":15,
  "a1h":"06:00",
  ...
  "a6t":15,
  "u1h":"06:00",
  ...
  "u6t":15
}

Schedules can be modified via MQTT. Send a payload structure with all schedules or only the parts you want to modify to <your_mqtt_topic>/thermostat/<your_set_topic>/schedules.

3. Device information

MQTT: At start of device to let you know the topics and ip to devices/thermostat
Webthing: n.a.

{
  "url":"http://192.168.x.x/things/thermostat",
  "ip":"192.168.x.x",
  "stateTopic":"<your_mqtt_topic>/thermostat/<your_state_topic>"
  "setTopic":"<your_mqtt_topic>/thermostat/<your_set_topic>"
}

Modifying parameters via MQTT

Send a complete json structure with changed parameters to <your_mqtt_topic>/thermostat/<your_set_topic>, e.g. beca/thermostat/set. Alternatively you can set single values, modify the topic to <your_mqtt_topic>/thermostat/<your_set_topic>/<parameter>, e.g. beca/thermostat/set/deviceOn. The payload contains the new value. Send a json with changed schedules to <your_mqtt_topic>/things/thermostat/schedules.

Build this firmware from source

For build from sources you can use the Atom IDE (recommended), Arduino IDE or other. All sources needed are inside the folder 'WThermostat' and my other library: https://github.com/klausahrenberg/WAdapter. Additionally you will need some other libraries, which you can find listed here: https://github.com/klausahrenberg/WThermostatBeca/blob/master/WThermostat/platformio.ini