Tutorial on how to connect nibepi to Home Assistant to allow for monitoring and controlling the Nibe heat pump from Home Assistant. It allows for monitoring of current values such as:

• utilization of electrical heater
• Warm water temperature
• Outdoor and indoor temperature sensors
• Condenser and evaporator temperatures
• Fan speed
• Pump frequency
• and many more things....

By attaching a Raspberry Pi with a Modbus HAT and a 12 V power HAT it can communicate with the Nibe heat pump over Modbus. There are multiple ways to do this and check out the nibepi project for alternatives. This is my current installation:

nibepi is a project found on https://github.com/anerdins/nibepi with a closed community on Facebook https://www.facebook.com/groups/nibepi/ where you can as request to join. The community is a great place for questions and share your experiences primarily with nibepi. The base of many examples in this tutorial has been found in posts and comments in the Facebook group. Where attribution of code is missing, please point me in the right direction so that this can be corrected.

1. Prerequisites
2. Configuration
   1. nibepi - mqtt settings to connect to mqtt broker
   2. nibepi - publish registers to mqtt
   3. Home Assistant - Add integration - MQTT
   4. Home Assistant - Add HACS custom Frontend components
3. Home assistant - Examples to monitor and control your Nibe heat pump
   1. Status image with temperature control
   2. Heat pump schematics with sensor information
   3. Heat pump fan control
   4. Heat pump hot water mode control

This tutorial assumes the following:

• A working nibepi connected to your heat pump and reachable on your local network
• A working mqtt server/broker. Either in Home Assistant as add-on (instructions link) or stand alone.
• A working Home Assistant system
• The HACS-plugin installed in Home Assistant.

• Configuration: nibepi - Connection to mqtt broker
  The required setting to allow for nibepi to publish and to subscribe to messages on the mqtt broker.
  nibepi - Connect to mqtt broker

• Configuration: nibepi - Registers to publish to mqtt broker
  Select which register to publish and subscribe to on the mqtt broker. Only selected registers will be available in Home Assistant.
  nibepi - Publish registers to mqtt

• Configure Home Assistant - Integration mqtt
  For Home Assistant to be able to subscribe and to publish messages to the mqtt broker an integration must be added and configured.
  Home Assistant - Add integration - MQTT

You are most welcome to add more examples on how the nibepi integration can be utilized with Home Assistant to create or enhance smart functions.

• For simpler things, the report Issue function here might be sufficient.
• For more advanced things, please fork the repository and make a pull request.