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.

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.

Name	Service	Example device	Implementation status	Home Assistant entity
Alarm	alarm_appliance, alarm_burglar, alarm_emergency, alarm_fire, alarm_gas, alarm_health, alarm_heat, alarm_lock, alarm_power, alarm_siren, alarm_system, alarm_time, alarm_water, alarm_water_valve, alarm_weather	Brannvarsler	✅	Binary sensor, Button
Blinds/door	barrier_ctrl		✅	Cover
Battery	battery		✅	Sensor, Binary sensor
Chargepoint	chargepoint	Futurehome Charge	✅	Sensor, Switch, Number, Select
Color control	color_ctrl		✅	Light
Door lock	door_lock, doorman	Yale Doorman	✅	Lock, Binary sensor, Switch, Number, Button, Select, Sensor, Text
Fan	fan_ctrl		✅	Fan
Media player	media_player		✅	Select, Number, Switch, Image, Sensor
Meter	meter_elec, meter_gas, meter_water, meter_heating, meter_cooling	HAN-Sensor	✅	Sensor, Button
Binary switch	out_bin_switch	16A Puck Relé	✅	Switch
Level switch	out_lvl_switch	Smart LED Dimmer	✅	Number
Button	scene_ctrl	Modusbryter	✅	Sensor, Select
Schedule entry	schedule_entry		✅	Number, Button, Binary sensor, Sensor
Binary sensor	sensor_contact, sensor_presence		✅	Binary sensor
Numeric sensor	sensor_accelx, sensor_accely, sensor_accelz, sensor_airflow, sensor_airq, sensor_anglepos, sensor_atmo, sensor_baro, sensor_co, sensor_co2, sensor_current, sensor_dew, sensor_direct, sensor_distance, sensor_elresist, sensor_freq, sensor_gp, sensor_gust, sensor_humid, sensor_lumin, sensor_moist, sensor_noise, sensor_power, sensor_rain, sensor_rotation, sensor_seismicint, sensor_seismicmag, sensor_solarrad, sensor_tank, sensor_temp, sensor_tidelvl, sensor_uv, sensor_veloc, sensor_voltage, sensor_watflow, sensor_watpressure, sensor_wattemp, sensor_weight, sensor_wind	Brannvarsler	✅	Sensor
Siren	siren_ctrl, complex_alarm_system	Brannvarsler	✅	Siren, Select, Number, Button, Sensor
Sound emitter	sound_switch		✅	Siren
Thermostat	thermostat	Thermostat	✅	Climate
Keypad	user_code		✅	Sensor, Binary sensor, Button, Text
Water heater	water_heater		✅	Water heater

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.

20 KiB Raw Blame History