Skip to content

hp-net/homebridge-nibe

Repository files navigation

homebridge-nibe

NPM version Release GitHub license Downloads

Build status

NPM

"Buy Me A Coffee"

Nibe myUplink plugin for homebridge

This Homebridge plugin retrieves data from a Nibe heat pump using Nibe myUplink.

⚠️ Notice: Version 2 of this plugin supports only myUplink! To access data from Nibe Uplink, please use version 1 of the plugin. The old API is no longer compatible with this plugin.

Plugin configuration

Complete setup instructions are available on the plugin configuration page in Homebridge, providing a step-by-step guide to obtaining the required parameters.

Supported accessories

Accessory Description
outdoor-temperature BT1 outdoor temperature (40004 or 44362).
average-outdoor-temperature BT1 average outdoor temperature (40067).
hot-water Thermostat for hot water (40014, 40008). The switch within the thermostat controls temporary lux (48132), which requires a Nibe premium subscription. Changing temporary lux through the Nibe API takes some time (20-30 seconds), so any switch adjustments won’t be immediately reflected in Nibe.
hot-water-top Top hot water temperature (40013).
ventilation-exhaust-air Ventilation/ERS exhaust air temperature (40025).
ventilation-extract-air Ventilation/ERS extract air temperature (40026).
ventilation-supply-air ERS supply air temperature (40075).
ventilation-outdoor ERS outdoor temperature (40183).
ers-fan (Soon) ERS fan speed (40311, 40312) with change rotation speed (47260) and active state when rotation is grater than 0.
ventilation-fan (Soon) Ventilation fan speed (10001) with change rotation speed (47260) and active state when rotation is grater than 0.
thermostat (Soon) Thermostat (40008,43437) for heating and cooling (if available). Active state is calculated. Changing desired temperature will affect heating/cooling offset (47011/48739).
new-firmware An occupancy sensor that will be triggered when a new firmware version becomes available.

Roadmap

Check the project roadmap at https://github.com/hp-net/homebridge-nibe/projects/1

Configuration

Configuration can be done via the Homebridge UI, which is the recommended method.

However, you can also make changes directly in the Homebridge config.json file. Below is a description of all options:

Name Required Default Description
platform Yes Nibe 'Nibe' is only correct value. If value will be different configuration will not match plugin.
identifier Yes Api client identifier from Nibe myUplink account. Follow plugin configuration instructions to obtain it.
secret Yes Api client secret from Nibe myUplink account. Follow plugin configuration instructions to obtain it.
language No en Language for accessory labels. Possible values: 'en', 'pl', 'sv'.
pollingPeriod No 60 Period (in seconds) for fetching device updates from api.
disabledAccessories No List of accessories to disable. Format 'id'.
showApiResponse No If set to `true` response from Nibe myUplink API will be displayed in logs.

Sponsorship & support

If you are using this project please consider sponsoring it's further development & bug fixes

"Buy Me A Coffee"