/ha-nefiteasy

Nefit Easy connection for Home Assistant

Primary LanguagePython

ha-nefiteasy

Nefit Easy connection for Home Assistant

Big thanks to marconfus for the aionefit library and his work on the ha-nefit-ng compontent!

Installation

  1. Create custom_components/nefiteasy/ in your homeassistant config directory.
  2. Copy the files of this repository into this directory.
  3. Add the config to your configuration.yaml file as explained below.
  4. Restart Home Assistant or Hass.io.

Configuration

nefiteasy:
  devices:
  - serial: 'XXXXXXXXX'
    accesskey: 'xxxxxxxxx'
    password: 'xxxxxxxxx'
    # name: Nefit Easy
    # min_temp: 15
    # max_temp: 27
    # sensors:
    #  - list of sensors to be exposed
    # switches:
    #  - list of switches to be exposed

If any of your secrets in the configuration is numbers only, make sure to put it between quotes (') to have homeassistant parse them correctly.

Examples

Basic

nefiteasy:
  devices:
  - serial: '01234567'
    accesskey: !secret nefitaccesskey
    password: !secret nefitpassword

Limit sensors and switches

nefiteasy:
  devices:
  - serial: '01234567'
    accesskey: !secret nefitaccesskey
    password: !secret nefitpassword
    sensors:
      - status
      - supply_temperature
      - hot_water_operation
    switches:
      - hot_water
      - holiday_mode
      - preheating

Multiple devices

nefiteasy:
  devices:
  - serial: '01234567'
    accesskey: !secret nefitaccesskey
    password: !secret nefitpassword
    name: Nefit 1
  - serial: '76543210'
    accesskey: !secret nefitaccesskey2
    password: !secret nefitpassword2
    name: Nefit 2

Available sensors & switches

See const.py file.

Debugging problems

logger:
  default: info
  logs:
    custom_components.nefiteasy: debug
    aionefit: debug

FAQ

HA cannot connect to Bosch cloud

If you experience errors during the boot of HA regarding the connection to the Bosch cloud ie Timeout while connecting to Bosch cloud. Retrying in the background, you may want to change the OpenSSL configuration. The OpenSSL defaults for Buster are causing the problem, probably because Nefit/Bosch is using either an outdated TLS version or an outdated cipher.

Edit /etc/ssl/openssl.cnf and change the system wide defaults back to their previous values(pre-Buster):

MinProtocol = None
CipherString = DEFAULT

https://www.debian.org/releases/stable/amd64/release-notes/ch-information.en.html#openssl-defaults