0.0.5.0
This release is a major rewrite of the Flair integration. With this being the case, there are breaking changes. I encourage you to check any automations that you may have and to read the documentation.
Notable Changes
- Mini Splits are now supported
- Pucks, Mini Splits, Rooms, Structures, and Vents are now integrated as
Devices
with entities within each device. - Attributes are no longer used. The previous attributes are now presented as separate entities.
- Additional control has been added to Structures
Set Sechedule
service is no longer used. Instead, schedules are picked using a select entity within a Flair Structure.
Documentation Below
Devices
Each Flair mini-split, puck, room, structure, and vent is represented as a device in Home Assistant. Within each device
are several entities described below.
Structure
Each structure has the following entities:
Entity | Entity Type | Additional Comments |
---|---|---|
Home/Away Mode |
Select |
Please read Flair's documentation regarding Home/Away Mode |
Schedules |
Select |
Schedules and this entity are only available if the Flair System Mode is set to "Auto". All schedules created within the Flair app will appear here. To turn off a schedule, select "No Schedule" |
Structure Mode |
Select |
Please read Flair's documentation regarding Structure mode |
System Mode |
Select |
Please read Flair's documentation regarding Auto mode and Manual mode |
Puck
Each puck has the following entities:
Entity | Entity Type | Additional Comments |
---|---|---|
Humidity |
Sensor |
|
Light Level |
Sensor |
|
Temperature |
Sensor |
|
RSSI |
Sensor |
|
Voltage |
Sensor |
Displays the current voltage of the puck. If using batteries to power your puck, this can be used to monitor battery health. |
Note About Pucks
Flair statement regarding Puck Light Level sensor:
It is not calibrated. The sensor itself, if the nominal reference is 1, can range from 0.3 to 1.6. This also doesn't take into account the mechanical loss in the Puck. In short, this is not an accurate lux sensor.
Vent
In order to control vents that are in Flair Rooms that have a temperature sensor, the System setting in the Flair app needs to be set to Manual
(see image above). If you have it set to Auto
, you will still be able to control your vents, however, eventually Flair will override your changes. This mode can also be set using a Flair Structure's System Mode select entity
within Home Assistant. Any vents in Flair Rooms that don't report temperature can be controlled regardless of current mode set.
Each Vent has the following entities:
Entity | Entity Type | Additional Comments |
---|---|---|
Vent |
Fan |
Has a state of either on or off . If your vent is either 50 or 100 percent open, the state will be on . If your vent is 0 percent open, the state will be off . Turning the vent fan entity on manually will fully open the vent (100 percent). Turning the vent fan entity off manually will completely close the vent (0 percent). You are also able to manually open the vent halfway (50 percent) by either changing the speed to 50 via the UI or by using the service fan.set_percentage and setting percentage to 50 - the same goes for fully open with 100 or fully closed with 0 . |
Duct Pressure |
Sensor |
|
Duct Temperature |
Sensor |
|
RSSI |
Sensor |
|
Voltage |
Sensor |
Displays the current voltage of the vent. If using batteries to power your vent, this can be used to monitor battery health. |
Room
Each Room has the following entities:
Entity | Entity Type | Additional Comments |
---|---|---|
Activity Status |
Select |
Rooms can be set to Active or Inactive. |
Room |
Climate |
Temperature set points can be changed on a room by room basis. Changing HVAC mode on a room by room basis is not supported as room HVAC mode (for all rooms) is controlled by a Flair structure. Changing HVAC mode for all rooms can be done using a structure's Structure Mode entity. |
Duct Temperature |
Sensor |
|
RSSI |
Sensor |
|
Voltage |
Sensor |
Displays the current voltage of the vent. If using batteries to power your vent, this can be used to monitor battery health. |
Additional Notes
Changing the temperature for a room climate entity will change the set temperature of the corresponding room. This change will remain for until next scheduled event
, 3h
, 8h
, 24h
, or forever
- this depends on the setting in the Flair app under Home Settings > System Settings > Default Hold Duration.
Mini Split
Each Mini Split has the following entities:
Entity | Entity Type | Additional Comments |
---|---|---|
Mini Split |
Climate |
To fully control your mini split unit, the associated Flair structure needs to be in Manual Mode . If your structure is set to Auto Mode you will only be able to control Fan speed and Swing (if available for your unit). In addition, mini split set points are controlled by rooms if a Flair structure is set to Auto Mode . Changing the temperature of this climate entity will result in changing the room set point when in Auto Mode . |