2025-07-27 00:14:09 +02:00

18 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 Home Assistant screenshot

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 of new Zigbee, Z-Wave, and Futurehome devices (work-in-progress). (If youve previously used third-party integrations—e.g. Philips Hue—you can still interact with those devices, as long as they're paired with the hub. However, it's generally recommended to use the appropriate Home Assistant integration directly for such devices.)

Installation

  1. In the Futurehome app, go to Settings > My household > Smarthub and enable Local API.
  2. (Optional but highly recommended) Block the hubs internet (WAN) access in your router settings to prevent future firmware updates.
  3. In Home Assistant, enable the MQTT integration.
  4. Add this add-on repository to Home Assistant and refresh the page.
  5. Open the Add-on Store and search for "Futurehome".
  6. 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
Basic basic Number
Battery battery Sensor, Binary sensor
Chargepoint chargepoint Futurehome Charge Sensor, Switch, Number, Select
Color control color_ctrl Light
Door lock door_lock Yale Doorman, 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

Problematic services

Service Description
schedule No devices or hub support this stub service.
battery_charge_ctrl No devices or hub support this stub service.
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.

Virtual, unnecessary services (easily reproduced in stock Home Assistant)

Service Description
virtual_meter_elec A virtual electricity meter that estimates energy usage by multiplying the device's configured average power consumption with its operating duration.

System or meta, not essential services

Service Implementation status Description
gateway
association
diagnostic
indicator_ctrl Identify devices
ota
parameters
Power regulator power_regulator 16A Puck Relé
technology_specific
time
time_parameters
version
dev_sys