Nefit Easy connection for Home Assistant
Big thanks to marconfus for the aionefit library and his work on the ha-nefit-ng component!
- Copy the folder
custom_components/nefiteasy/
to your homeassistant config directory. - Restart Home Assistant.
- Add "https://github.com/ksya/ha-nefiteasy" to your custom repositories in the Settings tab of HACS.
- Choose "Integration".
- Press the "save" button.
- Go to the integrations tab and search for Nefit Easy.
- Click and install from there.
All configuration can be done from within Home Assistant:
- Go to Settings
- Go to Integrations
- At the bottom right, click Add Integration
- Search for "Nefit" -> Nefit Easy Bosch Thermostat
- Fill in your serial number, access key and password
- Save
Make sure to enter serial number and access key without spaces!
Some entities are disabled by default, if needed they can be enabled. Entities that are disabled will not be updated.
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 |
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 | ✔ |
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 |
- follow-ch
Turn on debug for both aionefit as custom_components.nefiteasy:
logger:
default: info
logs:
custom_components.nefiteasy: debug
aionefit: debug
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