mirror of
https://github.com/adrianjagielak/home-assistant-futurehome.git
synced 2026-05-28 05:55:40 +00:00
87dded2e4a
HA 2026.5 enforces strict validation of device_class/unit_of_measurement pairs in MQTT discovery payloads. Four categories were broken: - power_factor: unit was sent as "power_factor" (the FIMP field name); HA requires the field to be omitted or empty for this device class. Fixed by normalising the display unit separately from the FIMP data-path key. - illuminance: unit "Lux" is rejected; normalise to "lx". When a sensor reports luminance as "%" (some Z-Wave devices), the illuminance device class is dropped so the entity becomes a generic sensor rather than triggering a validation error. - reactive_power (regular/export meter): unit "VAr" is rejected; HA requires lowercase "var". - reactive_power (extended meter values, e.g. p_import_react): the unit determination logic fell through to the generic power branch and sent "W"; reactive power extended values now emit "var", apparent power values emit "VA", and reactive energy values emit "kvarh". Fixes #31
Futurehome Home Assistant add-on
Futurehome add-on for Home Assistant. Designed to be a complete drop-in replacement for the official Futurehome app, with support for all device types compatible with the Futurehome hub.
Watch the official add-on demo video
Features
This add-on:
- Fetches all device metadata from the Futurehome hub and maps them to Home Assistant devices/entities.
- Fetches and updates device states and availability in real time.
- Supports interaction with devices comparable to the official Futurehome app.
- Supports pairing and unpairing devices.
Installation Guide
See the full Installation Guide for step-by-step setup instructions.
Futurehome Device Services Compatibility Chart
This chart lists all services supported by the Futurehome hub, along with their current implementation status.
Devices commonly consist of multiple services: for example, a presence sensor might expose a sensor_presence service with a presence (true/false) value, and also a battery service if it is battery-powered.
Some services are more common than others; some are deprecated entirely.
Implemented system services
| Name | Service | Implementation status | Home Assistant entity |
|---|---|---|---|
| Fall-back Z-wave 'basic' service | basic | ✅ | Number |
| Reboot device | dev_sys | ✅ | Button |
| Identify device | indicator_ctrl | ✅ | Button |
| Advanced configuration of a device | parameters | ✅ | Button, Sensor, Number, Select, Text |
Other system, meta, unused, or not essential services
| Service | Description |
|---|---|
| association | Virtual association between devices. Easily reproducible using Home Assistant's built-in configuration. |
| battery_charge_ctrl | No devices or hub support this stub service. |
| diagnostic | Diagnostic (logging, etc) |
| inverter_consumer_conn | No devices or hub support this stub service. |
| inverter_grid_conn | No devices or hub support this stub service. |
| inverter_solar_conn | No devices or hub support this stub service. |
| ota | Managing OTA updates of devices |
| power_regulator | Automation. Easily reproducible using Home Assistant's built-in configuration. |
| schedule | No devices or hub support this stub service. |
| technology_specific | Should be covered by other services |
| time | Z-wave service for setting and reading time |
| time_parameters | Z-wave service for setting and reading time |
| version | Device hardware and software versions. Exposed through other means. |
| virtual_meter_elec | A virtual electricity meter that estimates energy usage by multiplying the device's configured average power consumption with its operating duration. Easily reproducible using Home Assistant's built-in configuration. |