Python Plugin: WeHeat

Python and python framework

Moderator: leecollings

Post Reply
jorknu
Posts: 10
Joined: Friday 12 September 2025 15:33
Target OS: Raspberry Pi / ODroid
Domoticz version: 2026.3
Location: NL
Contact:

Python Plugin: WeHeat

Post by jorknu »

Hi,

Recently had a WeHeat Sparrow heatpump installed.
WeHeat is a Dutch manufacturer of heatpump with a data driven approach.
They have given to the community a HA integration and put on github a python client library:
https://github.com/wefabricate/wh-python

In an effort to learn some python I have decided to make a domoticz plugin out of the client library.

Source code can be found:
https://github.com/Tableflipper9001/weh ... icz-plugin

The following can be found from the Readme in github (most accurate):
  • Installation instruction, highly advisable to use a python virtual environment
  • Version history
  • List of known problems / TODO's
This plugin has been tested with:
Domoticz 2025.1, 2025.2 - Raspberry pi 3B, RPI OS 12 with a WeHeat Sparrow P60 (Hybrid system, gas boiler via On/Off)
I have checked with a collegeau who has a Blackbird (P80), the parameter set looks the same, so no problems expected for the other heatpumps.

Looking for people to confirm that the plugin also works for:
  • Blackbird P60 / P80 - All electric
  • Blackbird P60 / P80 - Hybrid (On/Off or OT)
  • Sparrow P60 - All electric
  • Flint P40 - All electric
  • Flint P40 - Hybrid (On/Off or OT)
Also searching for people that use Windows to check if the plugin functions.

Current capability of the plugin is:
  • Temperature - Room temperature
  • Temperature - Room temperature setpoint
  • Temperature - Heating flow temperature
  • Temperature - Heating flow temperature setpoint
  • Temperature - Heatpump flow temperature
  • Temperature - Heatpump return temperature
  • Percentage - COP
  • kWh - Electrical power
  • kWh - Heat power
  • kWh - Power from air
  • Percentage - Compressor usage
  • Text - Heatpump state
  • Text - Cooling state
  • Text - Heatpump error

For Hybrid systems:
  • On/off switch - Gas boiler state
For All-Electric systems:
  • On/off switch - Electric heater state
If there are things not working or you think it should be different let me know in the comments

Greetz,

Jordy
User avatar
waltervl
Posts: 7023
Joined: Monday 28 January 2019 18:48
Target OS: Linux
Domoticz version: 2026.3
Location: NL
Contact:

Re: Python Plugin: WeHeat

Post by waltervl »

Thanks!
I added it to the Plugin List on the wiki.
Domoticz running on Udoo X86 (on Ubuntu)
Devices/plugins: ZigbeeforDomoticz (with Xiaomi, Ikea, Tuya devices), Nefit Easy, Midea Airco, Omnik Solar, Goodwe Solar
niki_lauda
Posts: 125
Joined: Saturday 31 August 2013 14:48
Target OS: Raspberry Pi / ODroid
Domoticz version: beta
Location: Eindhoven (NL)
Contact:

Re: Python Plugin: WeHeat

Post by niki_lauda »

jorknu wrote: Monday 27 October 2025 20:31 Hi,

Recently had a WeHeat Sparrow heatpump installed.
WeHeat is a Dutch manufacturer of heatpump with a data driven approach.
They have given to the community a HA integration and put on github a python client library:
https://github.com/wefabricate/wh-python

In an effort to learn some python I have decided to make a domoticz plugin out of the client library.

Source code can be found:
https://github.com/Tableflipper9001/weh ... icz-plugin

The following can be found from the Readme in github (most accurate):
  • Installation instruction, highly advisable to use a python virtual environment
  • Version history
  • List of known problems / TODO's
This plugin has been tested with:
Domoticz 2025.1, 2025.2 - Raspberry pi 3B, RPI OS 12 with a WeHeat Sparrow P60 (Hybrid system, gas boiler via On/Off)
I have checked with a collegeau who has a Blackbird (P80), the parameter set looks the same, so no problems expected for the other heatpumps.

Looking for people to confirm that the plugin also works for:
  • Blackbird P60 / P80 - All electric
  • Blackbird P60 / P80 - Hybrid (On/Off or OT)
  • Sparrow P60 - All electric
  • Flint P40 - All electric
  • Flint P40 - Hybrid (On/Off or OT)
Also searching for people that use Windows to check if the plugin functions.

Current capability of the plugin is:
  • Temperature - Room temperature
  • Temperature - Room temperature setpoint
  • Temperature - Heating flow temperature
  • Temperature - Heating flow temperature setpoint
  • Temperature - Heatpump flow temperature
  • Temperature - Heatpump return temperature
  • Percentage - COP
  • kWh - Electrical power
  • kWh - Heat power
  • kWh - Power from air
  • Percentage - Compressor usage
  • Text - Heatpump state
  • Text - Cooling state
  • Text - Heatpump error

For Hybrid systems:
  • On/off switch - Gas boiler state
For All-Electric systems:
  • On/off switch - Electric heater state
If there are things not working or you think it should be different let me know in the comments

Greetz,

Jordy
Hi Jordy
Thanks for you plug-in
I have an problem reported in github
Can you answer it?
Thx for the efforts.
jorknu
Posts: 10
Joined: Friday 12 September 2025 15:33
Target OS: Raspberry Pi / ODroid
Domoticz version: 2026.3
Location: NL
Contact:

Re: Python Plugin: WeHeat

Post by jorknu »

For completion:
Apparantly I am not getting emails on my own repos in github :(.
We are picking this up via github.
Post Reply