Finish most of the basic features, add few services

This commit is contained in:
Adrian Jagielak
2025-07-22 23:21:34 +02:00
parent 4a18c249cd
commit ff38146ac4
23 changed files with 1039 additions and 84 deletions

134
README.md
View File

@@ -2,6 +2,14 @@
Futurehome add-on for Home Assistant. The add-on aims to be a complete drop-in replacement for the official Futurehome app, implementing support for all Futurehome-supported device types.
## Features
This plugin:
1. Fetches all devices metadata from Futurehome hub and maps them to Home Assistant Devices/Entities.
2. Fetches and updates devices state.
3. Fetches and updates devices availability.
## Installation
1. Configure Local API in Smarthub settings in Futurehome app.
@@ -12,6 +20,131 @@ Futurehome add-on for Home Assistant. The add-on aims to be a complete drop-in r
6. Search for "Futurehome" in add-on store.
7. Install, configure, and run 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.
todo add more services
todo document which services are not documented in github FIMP api and are only present in reverse engineered app code (app store/play store)
| Service | Example device | Implemented in any capacity | Full implementation verified | todo change columns
| --- | --- | --- | --- |
| 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 | | ✅ | |
| appliance | | | |
| barrier_ctrl | | ✅ | |
| basic | | ✅ | |
| battery | | ✅ | |
| blinds | | | |
| boiler | | | |
| chargepoint | [Futurehome Charge](https://www.futurehome.io/en_no/shop/charge) | ✅ | |
| color_ctrl | | ✅ | |
| complex_alarm_system | | ✅ | |
| door_lock | | | |
| doorman | | ✅ | |
| fan | | | |
| fan_ctrl | | ✅ | |
| fire_detector | | | |
| garage_door | | | |
| gas_detector | | | |
| gate | | | |
| gateway | | ✅ | |
| heat_detector | | | |
| heat_pump | | | |
| heater | | | |
| input | | | |
| leak_detector | | | |
| light | | | |
| media_player | | ✅ | |
| meter | | | |
| meter_elec | [HAN-Sensor](https://www.futurehome.io/en/shop/han-sensor) | ✅ | |
| meter_gas | | ✅ | |
| meter_water | | ✅ | |
| out_bin_switch | | ✅ | |
| out_lvl_switch | [Smart LED Dimmer](https://www.futurehome.io/en_no/shop/smart-led-dimmer-polar-white) | ✅ | |
| power_regulator | | | |
| scene_ctrl | | ✅ | |
| sensor | | | |
| sensor_accelx | | ✅ | |
| sensor_accely | | ✅ | |
| sensor_accelz | | ✅ | |
| sensor_airflow | | ✅ | |
| sensor_airq | | ✅ | |
| sensor_anglepos | | ✅ | |
| sensor_atmo | | ✅ | |
| sensor_baro | | ✅ | |
| sensor_co | | ✅ | |
| sensor_co2 | | ✅ | |
| sensor_contact | | ✅ | |
| 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_presence | | ✅ | |
| 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 | | ✅ | |
| siren | | | |
| siren_ctrl | | ✅ | |
| thermostat | [Thermostat](https://www.futurehome.io/en_no/shop/thermostat-w) | ✅ | |
| user_code | | ✅ | |
| virtual_meter_elec | | ✅ | |
| water_heater | | ✅ | |
| water_valve | | | |
meta services:
| association | | | |
| diagnostic | | | |
| indicator_ctrl | | | |
| ota | | ✅ | |
| parameters | | ✅ | |
| dev_sys | | ✅ | |
| technology_specific | | ✅ | |
| time | | ✅ | |
| version | | ✅ | |
todo add demo mode checkbox? sample data
<!--
Notes to developers after forking or using the github template feature:
@@ -26,3 +159,4 @@ Notes to developers after forking or using the github template feature:
- Adjust all keys/url's that points to 'home-assistant' to now point to your user/fork.
- Do awesome stuff!
-->