search

ksya / ha-nefiteasy

Nefit Easy connection for Home Assistant
74 stars 30 forks source link

readme

ha-nefiteasy

Nefit Easy connection for Home Assistant

Build

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

Installation

  1. Copy the folder custom_components/nefiteasy/ to your homeassistant config directory.
  2. Restart Home Assistant.

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

All configuration can be done from within Home Assistant:

  1. Go to Settings
  2. Go to Integrations
  3. At the bottom right, click Add Integration
  4. Search for "Nefit" -> Nefit Easy Bosch Thermostat
  5. Fill in your serial number, access key and password
  6. Save

Make sure to enter serial number and access key without spaces!

Limit sensors and switches

Some entities are disabled by default, if needed they can be enabled. Entities that are disabled will not be updated.

Controls/Switches & Sensors

Controls/Switches

None enabled by default.

Key Name Description
active_program Active program Clock [program] 1 or 2
fireplace_mode Fireplace mode Other rooms stay warm as the fire burns
holiday_mode Holiday mode Define settings in the app. Activate/Deactivate them in Home Assistant
hot_water Hot water Hot water preheat
home_entrance_detection Presence "The Nefit Easy detects the presence of the smart device in the home and adjusts the room temperature accordingly.

To let this function, operate mobile Internet and Wi-Fi must be enabled continuously. Location services must be enabled in the settings; optionally you can use the location modus -> battery saving if your device supports it."
lockui Lock UI "Manual operation of the thermostat can be locked to prevent unintended adjustments."
preheating Preheating
shower_timer Shower timer "Shortening the duration of showering helps save energy.

3 minutes prior to the allotted time set cold water will come out of the hot water tap temporarily. When the allotted tome has fully passed, cold water will come out of the hot water tap until the tap is closed."
shower_timer_duration Shower timer duration Set time for the 'Shower timer' in minutes.
today_as_sunday Today as Sunday
tomorrow_as_sunday Tomorrow as Sunday
weather_dependent Weather dependent "Weather compensation control based on the local outdoor temperature.

Weather compensation control is best used with thermostatic radiator valves or thermostatically controlled radiant heating.

Please note:
The control is not based on the measured room temperature. Weather compensation control is comfort enhancing, but may result in increased heating costs. This control requires knowledge of weather compensation control. Ask your installer for support."
temperature_adjustment Temperature Adjustment Calibrate the measured temperature between +2 and -2 °C.

Sensors

Key Name UoM Description Enabled by default
actual_power Power ✔
hot_water_operation Hot water operation "When 'Follow program' is off, preheat function will be active or your indirect storage tank will remain heated.

Follow heating program: Hot water will be heated inline with heating 'Wakeup' & 'Home' activities, but extended one hour before and after these periods.

Custom program: Use this to set an independent hot water clock program.

For combi boilers: To disable preheat permanently, please refer to the boiler user manual."		 ❌
inhouse_temperature Inhouse temperature °C Current room temperature ❌
outdoor_temperature Outdoor temperature °C Outdoor temperature ✔
status status Status of the boiler ✔
supply_temperature Supply temperature °C Temperature of (hot) water ready to supply ✔
system_pressure System pressure Bar System water pressure ✔
target_temperature Target temperature °C Target temperature ❌
year_total Year total m3 Volume of gas consumed since Jan 1st ✔

Sensor values

Status
Code Description
-H central heating active
=H hot water active
0C
0L
0U		 system starting
0E system waiting
0H system standby
0A
0Y		 system waiting (boiler cannot transfer heat to central heating)
2E
H07		 boiler water pressure too low
2F
2L
2P
2U
4F
4L		 sensors measured abnormal temperature
6A
6C		 burner doesn't ignite
rE system restarting
Hot water operation
- follow-ch

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