Home Assistant add-on: Futurehome FIMP to MQTT

About

This Futurehome FIMP to MQTT add-on allows you to integrate the Futurehome Smarthub with Home Assistant by using the local MQTT broker inside the hub.

While it is possible to configure Home Assistant the FIMP protocol directly is a lot of work, and auto discovery is not possible.

This addon configure devices and their capabilities from Future Home in Home Assistant using MQTT Discovery.

Read more about the FIMP protocol.

Supported Futurehome devices

• Appliances (switches in HA)
  • Wall plugs like Fibaro Wall plug is supported
• Lights (lights in HA)
  • Dimmers - On/Off and brightness. Tested with Fibaro dimmer 2
  • Switches - On/Off. Tested with Fibaro wall plug
• Locks
  • Basic unlock/lock for doorlocks. Tested with IDLock 150 (Unlock commands are currently not supported on Zigbee)
• Thermostats
  • Set mode
  • Set target temp
  • Change fan speed if device supports it (e.g Sensibo)
• Sensors
  • Battery
  • Illuminance
  • Presence
  • Temperature
  • Humidity
  • Accumulated energy usage (kWh) (meter_elec) for devices supporting this
  • Power (W) (meter_elec) for devices supporting this
  • Voltage (V) (meter_elec) for devices supporting this
  • Current (A) (meter_elec) for devices supporting this
• Modus (home, away, sleep and vacation)
  • Set in entity select.fh_mode
• Shortcuts

Known issues / limitations

• Chargepoint (Easee, Zaptec etc.) is not currently supported
• Scene control (Fibaro button, Heatit Z-Push 4 etc.) is not currently supported
• Music players (Sonos etc.) is not currently supported
• Sirens are not currently supported
• On some thermostats (e.g Heatit) you are currently not able to readout current measured temperature (room temp sensor or floor temp sensor) directly on the thermostat card as it is on a different device
• Some devices might still use sensor_power (deprecated) and sensor_voltage (deprecated) instead of meter_elec. This needs to be fixed by Futurehome.
• Shortcuts triggered externally (e.g from Futurehome app) is not logged in logbook

Configuration and installation

Important

You need to enable local API access over MQTT from the Futurehome app.

Settings -> household -> hub settings -> local API setup

1. Home Assistant configuration

Home Assistant must use the MQTT broker provided by the Futurehome Smarthub. It's recommended to configure MQTT via GUI, and not via .yaml

Settings -> Device & services -> add integration -> search for MQTT -> select MQTT -> fill in hub IP and credentials. (NOTE that port should be 1884):

  broker: *hub ip*
  username: *username*
  password: *password*
  port: 1884
  discovery: true
  discovery_prefix: homeassistant

2. Install add-on

1. Add this repo as an add-on repository
   • Settings -> Add-ons -> Add-on store -> 3 dots in top right -> repositories -> paste link to this repository -> add
2. Install the addon 'Futurehome FIMP to MQTT'
   • Select Futurehome FIMP integration in the Add-on store -> install
3. Configure the addon with the same parameters as before
4. Start it. Supported devices should appear in the Home Assistant UI

Development

As this addon is not dependent on Home Assistant it's easiest to develop new features locally, or by using the Dev Container capabilities in VS Code which provides a full Home Assistant setup.

Using virtual env

Git clone and installation

git clone https://github.com/runelangseid/hassio-futurehome2mqtt
cd hassio-futurehome2mqtt/futurehome2mqtt
virtualenv venv  # You might need to specify python 3 somehow: virtualenv -p python3.7 venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Configuration

1. Setup configuration

   cp env-dist .env

2. Edit .env and fill in hostnames and credentials

3. Run python run.py serve

Alternative FIMP integrations

Look at here for examples on how to add Wall plugs and sensors manually in configuration.yaml, using MQTT without the use of this addon.