jm-cook / ha-flexit

Flexit for HomeAssistant

A local and native Flexit BACnet integration is pending PR in core. Will probably stop working on this integration when the merge goes through, as this integration relies on the cloud.

This integration uses an undocumented API, use at your own risk. This integration uses the same domain name as the official Flexit-integration, so in its current state you can't use both at the same time.

Tested with:

• Nordic S2
• Nordic S3
• Nordic S4
• Nordic CL4

Requirements

• Your Flexit-unit needs to be connected to the Internet
• Unit needs to be registered in the Flexit Go-app

Installation

HACS (Recommanded)

1. Ensure that HACS is installed.
2. Add this repository as a custom repository
3. Search for and install the "Flexit" integration.
4. Restart Home Assistant.
5. Add the Flexit integration to HA from the integration-page
6. Username and password is the same as in Flexit Go

Manual installation

1. Download the Source code (zip) file from the latest release.
2. Unpack the release and copy the custom_components/flexit directory into the custom_components directory of your Home Assistant installation.
3. Restart Home Assistant.
4. Add the Flexit integration to HA from the integration-page
5. Username and password is the same as in Flexit Go

Features

Climate-entity

• Preset modes:
  • Home
  • Away
  • Boost
  • Boost Temporary
  • Fireplace
• Operation modes:
  • Fan only
  • Heat
• Viewable modes:
  • Home
  • Away
  • Boost
  • Boost Temporary
  • Cooker hood
  • Fireplace

Sensor-entities

• Additional Heater
• Fan Control Signal Extract
• Fan Control Signal Supply
• Fan Speed Extract
• Fan Speed Supply
• Speed Heat Exchanger
• Temperature Extract
• Temperature Exhaust
• Temperature Outside
• Temperature Supply
• Temperature Room

Number-entities

• Delay Away Mode
• Duration Boost Temporary
• Duration Fireplace

Binary sensor-entity

• Alarm
  • Alarm Code A
  • Alarm Code B
• Dirty filter
  • Hours since change
  • Hours until dirty
  • Filter change interval hours
  • Days since change
  • Days until dirty
  • Filter change interval days

Keep in mind

The integration only polls every 30 min by default. When durations and delays are set, the integration and the app might become out of sync. Not sure how to avoid this without polling a lot more.

For instance, if you set a duration_fireplace to 5 minutes and change the mode to Fireplace, then HA will think the state is Fireplace until the next poll, when in reality it changed back after 5 minutes.

This also goes for away_delay. If this is set, the integration switches to Away right away, but it only activates after the delay has passed.

Service information

Service status

Service status can be found here

API limitation

API is restricted to 50 calls/min or 500 calls/week. The integration calls the API at least twice per action, depending on the endpoint. Defaults to polling every 30 minutes, this can be configured but be aware of API restrictions.

Debugging

If something is not working properly, logs might help with debugging. To turn on debug-logging add this to your configuration.yaml

logger:
  default: info
  logs:
    custom_components.flexit: debug

PS: This will log various details, including all HTTP-requests for the Flexit-integration to your home-assistant.log. This includes your username and password in cleartext in your Token-requests.

Have started work on diagnostics. This will be expanded on in the future as it is more clear what is needed to include to resolve issues. To download diagnostics, go into your device and press DOWNLOAD DIAGNOSTICS. This downloads a txt-file you can post in you issue. All sensitive data should be redacted here, so no need to worry, but you can inspect it if you want.