A house-mode-change evt.pd7.notify is broadcast on the hub component (component "hub", id "mode"), not component "mode". The previous guard `notify.component !== 'mode'` discarded every real mode-change notification, so the Mode select only updated via the 30s poll fallback instead of in real time. Gate on component "hub" (and, defensively, "mode") and extract the new mode from either param.mode.current (primefimp Hub/HubMode) or param.current (edge-iqcontrols/tpflow references), publishing only when a mode string is found. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FuQAyPde4K57P2XMCKbFek
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. See the FAQ for more details.
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.
- Exposes the Futurehome house mode (Home/Away/Sleep/Vacation) — the mode changed by the Futurehome Modeswitch — as a
Modeselector on the Smarthub device, and keeps it in sync in real time. - 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. |
FAQ
Q: But I thought Futurehome was going to disable the local API after a short grace period, as stated in the Subscription FAQ. What gives?
While that was initially stated, the latest hub firmware keeps the local API open indefinitely. There is currently no built-in mechanism in the firmware to disable it after a certain period, unless you update to a newer firmware. This has also been confirmed in the updated Subscription FAQ.
By using both public and reverse-engineered local APIs, this add-on is able to fully replicate the functionality of the Futurehome app.


