2025-07-28 17:32:28 +02:00

19 KiB
Raw Blame History

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.

Home Assistant screenshot

Pairing example

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

todo: rewrite the installation instructions

  1. In the Futurehome app, go to Settings > My household > Smarthub and enable Local API.
  2. (Optional) In the Futurehome app go to Settings > ??? > ??? and install Thingsplex integration (Needed for support of pairing new devices).
  3. (Optional but highly recommended) Block the hubs internet (WAN) access in your router settings to prevent future firmware updates.
  4. In Home Assistant, enable the MQTT integration.
  5. Add this add-on repository to Home Assistant and refresh the page.
  6. Open the Add-on Store and search for "Futurehome".
  7. Install, configure, and start the Futurehome add-on.

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

Hub

Name Service Implementation status Home Assistant entity
Futurehome Smarthub gateway

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.