mirror of https://github.com/adrianjagielak/home-assistant-futurehome.git synced 2026-07-07 13:23:03 +00:00

Files

Claude ac4e051ac2 Add Futurehome house mode support (Modeswitch) + scene event entities

The Futurehome Modeswitch (Modusbryter) is a house-mode switch: its buttons
change the hub's mode (Home/Away/Sleep/Vacation), which is a hub-level Vinculum
concept broadcast via `evt.pd7.notify` (component "mode") — not a device
`scene_ctrl` event. That is why tapping it produced nothing in the device
message stream and the mapped scene sensor was stuck on `unknown`.

The add-on had no house-mode support at all. This adds it:

- Expose the current house mode as a `Mode` select on the Smarthub device.
  It reflects the current mode, updates in real time via `evt.pd7.notify`
  (with a 30s house-poll fallback), and can change the mode from Home Assistant
  via `cmd.pd7.request {cmd:"set", component:"mode", id:<mode>}` (matching the
  reference primefimp `ChangeMode`).
- Always publish the Smarthub hub device so the Mode select is available even
  without Thingsplex credentials; inclusion/exclusion tooling stays gated.
- Discover available modes from the Vinculum `mode` component, falling back to
  home/away/sleep/vacation.

Also improve genuine scene controllers: `scene_ctrl` now additionally exposes a
Home Assistant `event` entity so momentary button presses can drive automations
(the previous `Scene` sensor latched and could not react to repeated presses).
The sensor is kept for backwards compatibility (renamed "Scene (last value)").

Includes demo-mode support, README/CHANGELOG updates, and a version bump to
1.7.0.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FuQAyPde4K57P2XMCKbFek

2026-07-01 20:51:24 +00: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.

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 Mode selector 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.

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	✅	Light, Number
Button	scene_ctrl	Modusbryter	✅	Event, 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.

19 KiB Raw Blame History