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

Files

Jagi ᯅ 93a036c4f7 Add Futurehome house mode support (Modeswitch) + scene event entities (#33 )

* 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

* Fix real-time house-mode updates: hub-mode notify uses component "hub"

A house-mode-change evt.pd7.notify is broadcast on the hub component
(component "hub", id "mode"), not component "mode". The previous guard
`notify.component !== 'mode'` discarded every real mode-change notification, so
the Mode select only updated via the 30s poll fallback instead of in real time.

Gate on component "hub" (and, defensively, "mode") and extract the new mode
from either param.mode.current (primefimp Hub/HubMode) or param.current
(edge-iqcontrols/tpflow references), publishing only when a mode string is
found.

2026-07-01 23:36:36 +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.

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