plakkie / ha-nefiteasy

Nefit Easy connection for Home Assistant

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!

• https://github.com/marconfus/aionefit
• https://github.com/marconfus/ha-nefit-ng

Installation

1. Copy the folder custom_components/nefiteasy/ to your homeassistant config directory.
2. Add the config to your configuration.yaml file as explained below.
3. Restart Home Assistant or Hass.io.

Alternative install using HACS

1. Add "https://github.com/ksya/ha-nefiteasy" to your custom repositories in the Settings tab of HACS.
2. Choose "Integration".
3. Press the "save" button.
4. Go to the integrations tab and search for Nefit Easy.
5. Click and install from there.

Configuration

nefiteasy:
  devices:
  - serial: 'XXXXXXXXX'
    accesskey: 'xxxxxxxxx'
    password: 'xxxxxxxxx'
    # name: Nefit Easy
    # min_temp: 15
    # max_temp: 27
    # temp_step: 0.5
    # 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

Sensors

- year_total
- status
- supply_temperature
- outdoor_temperature
- system_pressure
- active_program
- hot_water_operation

Switches

- hot_water
- holiday_mode
- fireplace_mode
- today_as_sunday
- tomorrow_as_sunday
- preheating
- home_entrance_detection
- weather_dependent
- lockui

Debugging problems

Turn on debug for both aionefit as custom_components.nefiteasy:

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