Skip to content

Plugin photovoltaic boiler

Martin Pihrt edited this page Oct 13, 2026 · 1 revision

Photovoltaic Boiler

Controls boiler heating between photovoltaic surplus and the public grid using configured temperature sources.

At a glance

Item Value
Version 1.0.0
Category Energy and building control
Author Martin Pihrt
License GPL-3.0
OSPy 3.0.211 or newer
Python 3.8 or newer
Permissions system
Hardware No dedicated hardware requirement declared
Dependencies None
Python/OS packages None
Interfaces No provider or mobile API declared
Source Open the plug-in directory

What it is for

Controls boiler heating between photovoltaic surplus and the public grid using configured temperature sources.

How it works and how to configure it

Tested in Python 3+

The plug-in includes a plugin.json manifest and reports its worker, regulation, selected output, latest temperature, control cycle and errors through the OSPy system health interface.

This plugin needs enabled and corect setup the Air Temperature and Humidity Monitor. Reading temperature using from DS18B20 sensors connected to the external hardware board'). Or it is possible to use temperature measurement from OSPy sensors (LAN/Wi-Fi, radio...) Allows boiler heating regulation. Example: for heating boiler with photovoltaic solar panel. During the day, when the solar power plant has excess electricity, we heat the boiler from the solar power plant. In the evening hours, for example, from 8 p.m. to 11 p.m., and if the boiler temperature is lower than set, we switch the station (contactor) to the public network. The contactor has a changeover contact that connects the boiler either to the solar power plant or to the public grid. The boiler has its own thermostat with a set temperature to regulate the water temperature. This extension only switches between the public grid and PV if there was no solar heating.

Plugin setup

  • Check Enable Control: If checked Enable Control, control for regulation is enabled.

  • Sensors or plugin: Select the temperature probes from sensors or from plugin air temperature.

  • Probe input for boiler: Select the temperature sensor (its name) you want to use.

  • Start Time for activating (hh:mm): If the boiler temperature is lower than set in this extension and the current time is greater than the start time, the output will be switched.

  • Stop Time for activating (hh:mm): If the boiler temperature is lower than set in this extension and the current time is less than the stop time, the output will be active.

  • Temperature for ON output: Temperature for switch ON (boiler output).

  • Select Output: Select the output you want to control with regulation.

  • Show in footer: Show data from plugin in footer on home page.

  • Status: Status window from the plugin.

Visit Martin Pihrt's blog. for more information HW board with DS18B20 probe.

In-app help and settings notes

The following notes are generated from the help page shipped with this plug-in. Field names are also explained directly in the OSPy settings page.

This plugin needs enabled and corect setup the Air Temperature and Humidity Monitor. Reading temperature using from DS18B20 sensors connected to the external hardware board Or it is possible to use temperature measurement from OSPy sensors (LAN/Wi-Fi, radio...) Allows boiler heating regulation.

Example: for heating boiler with photovoltaic solar panel. During the day, when the solar power plant has excess electricity, we heat the boiler from the solar power plant. In the evening hours, for example, from 8 p.m. to 11 p.m., and if the boiler temperature is lower than set, we switch the station (contactor) to the public network. The contactor has a changeover contact that connects the boiler either to the solar power plant or to the public grid.

The boiler has its own thermostat with a set temperature to regulate the water temperature. This extension only switches between the public grid and PV if there was no solar heating.

All temperatures is in

Or in OSPy sensors as well also in

Support

Check OSPy → Diagnostics first and remove passwords, tokens, private addresses and other secrets before sharing logs. Report reproducible plug-in problems in the OSPy-plugins issue tracker.

Back to the plug-in catalog

Clone this wiki locally