https://github.com/elupus/hass_nibe
Home Assistant Nibe Uplink Integration
https://github.com/elupus/hass_nibe
home-assistant home-automation nibe-uplink
Last synced: about 1 month ago
JSON representation
Home Assistant Nibe Uplink Integration
- Host: GitHub
- URL: https://github.com/elupus/hass_nibe
- Owner: elupus
- Created: 2017-06-05T20:08:06.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-05T12:00:37.000Z (10 months ago)
- Last Synced: 2024-10-14T19:19:04.997Z (7 months ago)
- Topics: home-assistant, home-automation, nibe-uplink
- Language: Python
- Size: 1.08 MB
- Stars: 184
- Watchers: 30
- Forks: 54
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Nibe - An home assistant plugin to get data from Nibe Uplink
## Deprecation
> [!WARNING]
> Nibe is shutting down nibeuplink.com which this integration is dependent upon. This project is therefor deprecated. Upgrade your heatpump and swith to myuplink solution, use built in modbus server on S-series pumps or add a nibegw device like https://github.com/elupus/esphome-nibe to use the native support inside home assistant instead.
## Preparation
- Register an nibe uplink application on: https://api.nibeuplink.com/
- Set the redirect url to match `://:/api/nibe/auth`. This is your **Callback url**
- Take note of the **Callback url**, **Identifer** (client_id) and the **Secret**
## Installation
There are 3 different methods of installing the custom component
### HACS installation
Read more here (https://hacs.xyz/) if you don't have HACS installed.
_While this component can be installed by HACS, it is not included in the default repository of HACS._
1. Add this repository as a custom repository inside HACS settings. Make sure you select `Integration` as Category.
2. Install the component from the Overview page.
### Git installation
1. Make sure you have git installed on your machine.
2. Navigate to you home assistant configuration folder.
3. Create a `custom_components` folder of it does not exist, navigate down into it after creation.
4. Execute the following command: `git clone https://github.com/elupus/hass_nibe.git nibe`
### Manual installation
1. Download the zip file and extract the folder inside to your custom_components folder. Create the folder is it does not exist.
2. Rename the folder "hass_nibe-master" to "nibe". All files, including the .translation folder, should be inside the "nibe" catalog under the custom_components folder.
## Setup
1. Add an empty nibe configuration block to your `/configuration.yaml`
```yaml
nibe:
```
2. Go to the Integrations page located in Home Assistants `Settings` panel.
3. Click `+ Add integration` in the lower right corner and select the "Nibe Uplink Heat Pumps" integration. It should have a little box icon to indicate that the integration is provided by a custom integration.
The "Nibe Heat Pump" integration is only for local communication with the heatpump using a UDP Gateway with NibeGw or a Modbus Connection.
4. Enter the data gathered when you registered on the nibe uplink homepage.
- **Callback url**
- **Identifer**: This is your (client_id)
- **Secret**
- **Write Access**: If you are going to be running smart home thermostants or control boost modes from home assistant this must be enabled.
5. The configurator will open a new window/tab directed at nibeuplinks home page. After logging in and accepting access for this client id, the window will close and you will be back in home assistant.
The system should now have access to the Nibe Uplink API. If you had not specified a system identifer already and error notifification will be added which contains the systems available to you. Take note of the **SystemId** and use to extend your configuration.
## Configuration
Full configuration description
```yaml
nibe:
# Default client identifier
client_id: xxx
# Default client secret
client_secret: yyy
# Default redirect url
redirect_uri: 'http://localhost:8123/api/nibe/auth'
systems:
# System identifier to add extra entities too
- system:
# Optional list of additional parameters to retrieve, can be done here or on the sensor platform.
sensors:
-
-
# Optional list of switches (note, for ability to change, you need to use writeaccess and have payed license).
switches:
- hot_water_boost
# Optional smart thermostats.
thermostats:
# Key in dict is external identifer in nibe uplink, it should
# be an unique integer for this thermostat
1:
# Required friendly name of thermostat
name: 'Kitchen Thermostat'
# Optional name of a home assistant entity representing current temperature
current_temperature: input_number.current
# Optional name of a home assistant entity representing valve position of
# a thermostat. At the moment it's use case is unknown.
# valve_position: input_number.valve
# List of systems that this thermostat is affecting. This is
# this is the sub climate system/area index (System 1, System 2, ..)
# that the pump is controlling.
systems: 1
2:
name: 'Livingroom Thermostat'
current_temperature: input_number.current
systems: 1
```