/hass-floureon

Floureon (Broadlink based) thermostat integration for Home Assistant

Primary LanguagePython

Your support

This open-source project is developed in my free time. Your donation would help me dedicate more time and resources to improve project, add new features, fix bugs, as well as improve motivation and helps me understand, that this project is useful not only for me, but for more users.

Buy Me A Coffee

Intro

Component for controlling Floureon or other chinese-based WiFi smart thermostat (Beok and others). Climate component will have 3 modes: "auto" (in which will used thermostat's internal schedule), "heat (which is "manual" mode) and "off". Also, while in "heat" mode it is possible to use preset "away". Changing mode to other than "heat" will set preset to "none".

If you want to use custom or more advanced control, you should use switch component and generic thermostat in Home Assistant instead. See below for configuration.

Configuration as a Climate

Name Type Default Description
host (required) string IP or hostname of thermostat.
name (required) string Set a custom name which is displayed beside the icon.
unique_id string Set a unique id to allow entity customisation in HA GUI.
schedule integer 0 Set which schedule to use (0 - 12345,67, 1 - 123456,7, 2 - 1234567).
use_external_temp boolean true Set to false if you want to use thermostat`s internal temperature sensor for temperature calculation.
precision float 0.5 Set temperature precision 1.0 or 0.5.
use_cooling boolean false Set to true if your thermostat has cooling function.

Example:

climate:
  platform: floureon
  name: livingroom_floor
  host: 192.168.0.1
  use_external_temp: false

Configuration as a Switch

Name Type Default Description
host (required) string IP or hostname of thermostat.
name (required) string Set a custom name which is displayed beside the icon.
unique_id string Set a unique id to allow entity customisation in HA GUI.
turn_off_mode string, float min_temp Thermostat turn off mode. Set to min_temp - thermostat will be turned off by setting minimum temperature, turn_off - thermostat will be turned off by turning it off completely, float - thermostat will be turned off by setting lower temperature, ex. 17
turn_on_mode string, float max_temp Thermostat turn on mode. Set to max_temp - thermostat will be turned on by setting maximum temperature, float - thermostat will be turned on by set temperature, ex. 20.5.
use_external_temp boolean true Set to false if you want to use thermostat`s internal temperature sensor for temperature calculation.

Example:

switch:
  platform: floureon
  name: livingroom_floor
  host: 192.168.0.1
  turn_off_mode: min_temp
  turn_on_mode: 23.5