Skip to content

The Smart Pump Control is designed to work seamlessly with your heat pump and central heating system. It detects when either of these sources is producing heat and then intelligently activates your floor heating pump.

Notifications You must be signed in to change notification settings

patrickvorgers/SPC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Issues


Logo

Smart Pump Control

Are you tired of high electricity bills and inefficient heating systems in your home? The Smart Pump Control is the solution you've been waiting for. With this innovative device, you can enhance the performance of your heat pump in combination with central heating, ensuring optimal comfort, control and savings.

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contact

About The Project

Floorheating usecase

Are you using floor heating and struggling with low temperature issues? The Smart Pump Control has the answer! By integrating this intelligent device into your heating system, you can optimize your energy consumption and maintain the perfect temperature in your home.

The Smart Pump Control is designed to work seamlessly with your heat pump and central heating system. It detects when either of these sources is producing heat and then intelligently activates your floor heating pump. This means you no longer have to keep the pump running continuously, wasting electricity when it's not needed. Instead, your heating system operates at its peak efficiency, saving you money on your energy bills.

Take Control with Home Automation

With the Smart Pump Control, you're gaining more control. You can easily monitor and manage your Smart Pump Control through popular home automation systems like Home Assistant. Adjust settings from the convenience of your smartphone or computer. It's a smarter, more connected way to manage your pump.

Key Benefits of Smart Pump Control:

  • Energy Savings: Reduce electricity consumption by only running your pump when necessary.
  • Easy Installation: Simple setup ensures you can start saving in no time.
  • Standalone operation: A Home Automation system is not required to operate.
  • Home Automation Integration: Seamlessly integrate with Home Assistant or other automation systems for remote control and monitoring.
  • Multiple forms of activation: Temperature based activation (threshold or delta) but also on external state triggers.

Technical features of Smart Pump Control:

  • Temperature based activation: Activate the pump based on a temperature trigger (threshold / delta).
  • Autorun: Automatically run the pump based on a period of inactivity to prevent damage to the system.
  • Frostprotection: Automatically run the pump when the registered temperature it too low to prevent frost damage.
  • WebUI: Fully configure the SPC using a WebUI.
  • Full API support: All userinterface functionality is also available as an API.
  • MQTT support: Status information can be published via MQTT and used in any system that supports MQTT.
  • Home Automation integration: Home Assistant autodiscovery of the device and monitoring and configuration via Home Assistant.
  • External Trigger support: Trigger the Smart Pump Control based on an external JSON information. This can be any system that provides JSON data. For instance: Home Assistant or Heat pump systems.
  • Automatic trigger configuration for Quatt heat pump systems by auto-detecting the Quatt
  • Multiple devices: Support for multiple SPC's on the same network.
  • Firmware update: New firmware releases are automatically detected. Upgrade can be initiated via WebUI and API.

(back to top)

Getting Started

Follow these simple steps to setup your Smart Pump Control

Installation

  1. In case temperature sensors can be connected, connect the temperature sensors to the device.
  2. Plug the device in an electrical outlet and wait for the blue led to start blinking (WiFi accesspoint mode).
  3. On your phone connect to the WiFi accesspoint and follow the steps to connect the Smart Pump Control to your WiFi network. It can take some time before the accessportal pops up so please be patient.
    • SPC-S-AP for the socket version
    • SPC-SC-AP for the socket version with no temperature sensors (core version)
    • SPC-AP for the basic version
  4. After the Smart Pump Control has been connected to the WiFi, the Smart Pump Control can be accessed via the below links
  5. On the device page it is possible to rename the device into a more meaningfull name (needed when using multiple Smart Pump Control's on the same network)
  6. In case temperature sensors can be connected, identify the temperature sensors by holding a single temperature sensor in your hand and monitor for 30 seconds on the SPC startpage the temperature of the sensors. On the configuration page the identified temperature sensor can be assigned (if needed) to another circuit and/or flow/return role.
  7. Update the configuration to your liking

Restart/Reset

Restart

Single press the button on the device. This will restart the device and preserve the configuration.

Configuration reset

Double press the button on the device. This will restart the device and reset all the settings to the factory defaults except for the WiFi connection.

Factory reset

Press and hold the button on the device for at least 3 seconds. This will restart the device and reset all the settings to the factory defaults including the WiFi connection. After restart the blue led will start blinking to indicate that the device is in WiFi accesspoint mode and that the WiFi needs to be configured.

(back to top)

Usage

Trigger activation

With trigger activation, it is possible to initiate the SPC based on an external trigger. Currently, it can make an API call and, based on the response, activate the pump. Trigger conditions can be customized to accommodate different activation requirements, allowing for greater flexibility and precision in pump control. This setup enables seamless integration with other systems, enhancing automation capabilities.

Example: Quatt heatpump

Example: Home Assistant heatpump

Temperature activation

Activate when above

Activate when above

The pump is activated in case the temperature rises above the activation temperature. The pump is turned off in case the temperature falls below the calculated hyteresis temperature (activation temperature - hysteresis).

Usage example:
Floor heating pump activation when central heating is producing heat.

Activate when below

Activate when below

The pump is activated in case the temperature falls below the activation temperature. The pump is turned off in case the temperature rises above the calculated hyteresis temperature (activation temperature + hysteresis).

Usage example:
Boiler heating when the temperature falls below a threshold.

Activate when ΔT above

Activate when ΔT above

The pump is activated in case the ΔT temperature (temperature flow - temperature return) rises above the activation temperature. The pump is turned off in case the ΔT temperature falls below the calculated hyteresis temperature (activation temperature - hysteresis).

Usage example:
Floor heating pump activation when there is a positive temperature difference in temperature between the central heating and the floor (heating during winter). This is usefull in case high and low temperature heating (central heating and heat pump) is mixed and no fixed temperature can be set to activate the floor heating pump.

Activate when ΔT below

Activate when ΔT below

The pump is activated in case the ΔT temperature falls (temperature flow - temperature return) below the activation temperature. The pump is turned off in case the ΔT temperature rises above the calculated hyteresis temperature (activation temperature + hysteresis).

Usage example:
Floor heating pump activation when there is a negative temperature difference in temperature between the central heating and the floor (cooling during summer).

Web UI

Main screen showing the state of the pump and temperature sensors

Trigger configuration for automatically starting/stopping the pump (autodetection for Quatt devices)


24h temperature history including pumpstate

Logbook show when the pump was activated

Configuration tools

Firmware update

Home Assistant UI

Autodetected device

Dashboard

(back to top)

Roadmap

  • Autodetect IP of the external trigger system
  • Different pump activation temperatures for summer and winter
  • Default behaviour when the external trigger system is not available (activate pump / deactivate pump)
  • Delta triggering, when difference between two sensors is above or below a threshold activate the pump (scenario: difference between flow and return)
  • Logbook of trigger events and their duration

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contact

Project Link: https://github.com/patrickvorgers/SPC

(back to top)

About

The Smart Pump Control is designed to work seamlessly with your heat pump and central heating system. It detects when either of these sources is producing heat and then intelligently activates your floor heating pump.

Resources

Stars

Watchers

Forks

Packages

No packages published