Inputs:
     Multiple indoor temperature & relHumidity sensors,
     Outdoor conditions & forecast,
Outputs:
     Set HEAT/COOL mode,
     Set zone calls (ON/OFF),
     Set dewpoint for radiant cooling,
     Recommendations to maximize energy efficiency

This was specifically built to control the radiant cooling zones in a house where dewpoint temperature is not consistant from room to room and where humidity control and ventilation was lacking.

A single dewpoint controller was inadequate. This system allows placing a sensor next to each emitter and embedded alongside the piping behind the walls for dewpoint data where its needed most.

The system also determines if outdoor conditions suggest windows should be opened instead of a zone call, preventing wasted energy usage and encouraging natural ventilation. It would be simple to extend this to automate the windows where applicable.

In heating mode, the system will attempt to optimize energy efficiency by recommending changes to flow temperature / outdoor reset settings. It does this by measuring the fraction of time a zone is calling for heat. Very short calls for heat imply the flow temperature can be reduced to get better heatpump efficiency (COP). This needs to be balanced against the energy use of the zone circulators - in mild weather, it could be more efficient to run the pumps less.

This control system is currently in use with a DX2W Air-to-water Hydronics Module from ThermAtlantic.

The modbus service and dewpoint-->voltage output is specifically designed for this equipment.

Missing features:

• The system assumes the heatpump can run more efficiently (lower flow temperature while heating) if there is no zoning. For this reason, multiple zone controls have not been implemented.
• Priority DHW diversion has not been implemented.
• the DX2W heatpump controller maintains buffer temperature with outdoor reset, so this type of control was ommitted

• zigbee temperature and humidity sensors with a display are used in place of thermostats. They wirelessly transmit the room conditions data to the mqtt server (via zigbee2mqtt service) for processing,
• zigbee temperature and humidity sensors WITHOUT a display are used as humidistats and are placed next to hydronic emiters. These are used to measure the dewpoint and ensure no condensation while radiant cooling,
• any sensor type can be used so long as it can write its data to mqtt.

• this service subscribes to all the sensor data,
• calculates dewpoint from temp/humidity measurements and calculates setpoint errors, then writes the data back to mqtt in a format the controller understands.
• simple httpserver to allow setting thermostat names, heat setpoint, and cool setpoint,
• httpserver also allows querying current thermostat states.

• periodically polls an availalable weather api to determine current conditions and get a 24hr hourly forecast,
• open-mateo provides current conditions, and forecasted temperatures,
• weather.gc.ca provides current and forecast AQHI (air quality health index),
• the weather service writes the data to mqtt for the controller.

• subscribes to thermostat, humidistat, and weather data streams via mqtt,
• processes data:
  • determines 24h high, 24h mean, and 24h low temperatures,
  • determines highest indoor dewpoint,
• uses the data to determine:
  • heatpump mode (HEAT/COOL/OFF),
  • zone controller state (ON/OFF),
  • minimum flow temperature (highest dewpoint),
  • if conditions are right for natural ventilation (open windows),
• posts to the Phidgets service to apply mode (HEAT/COOL), zone state (ON/OFF), and dewpoint (converted to 0-10Vdc signal)
• posts to modbus service to apply heatpump state (ON/OFF),
• posts to NTFY service to send notifications (mode and state changes, suggest windows open/close),
• simple httpserver to allow querying current state (inputs and outputs).

• phidgets are physical devices used to programatically interact with the real world,
• there is a relay setup to turn ON/OFF up to four 24vdc signals, and a voltage output setup to provide a 0-10vdc signal,
• the phidgets service is a simple httpserver written in python (to use Phidgets python API client) which accepts http post requests to control the devices,
• the httpserver also allows querying current state of the phidget devices.

This system is built on the Phidgets SBC which comes with its own web server. This isn't really used.

• reads and writes from the heatpump modbus device
• reads are scheduled (every 15 seconds for fast changing data like flow and return temperatures, longer periods for slow changing data like buffer setpoint) and cached to limit the number of simultanous modbus requests,
• simple httpserver to allow reading cached values, and writing control/config registers.

• reads current state from the controller,
• reads current state of the modbus device (via modbus service),
• posts data to EmonCMS to feed its Heatpump Monitor app (which eventially ends up on heatpumpmonitor.org)

• reads current state from the controller,
• reads current state of the modbus device (via modbus service),
• webserver to serve dashboard UI,
• allows user input to configure and control the system, posts to controller and thermostat endpoints).

• simple httpserver to query logged events
• maintains history of X days