2025-08-02 10:26:43 +02:00

19 KiB

Futurehome Home Assistant add-on

Futurehome add-on for Home Assistant, built using both public and reverse-engineered APIs. Designed to be a complete drop-in replacement for the official Futurehome app, with support for all device types compatible with the Futurehome hub.

Home Assistant screenshot Home Assistant screenshot

Pairing example

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.