Skip to content

Latest commit

 

History

History
115 lines (91 loc) · 4.82 KB

README.md

File metadata and controls

115 lines (91 loc) · 4.82 KB
Raw

Deep Heating

Supports amd64 Architecture Supports armv6 Architecture Supports armv7 Architecture

This app was born of frustration with the temperature reported by Hive TRVs. You really can't use a temperature sensor situated a couple of inches from a radiator to reliably tell you the room temperature. I already had a bunch of Hue motion sensors, which also report temperature, and decided to use those to control my heating too.

The result is a simple web app that works well on mobile devices, allowing you to control and tweak the desired temperature of each room in your home.

How do I use it?

For each room, set up your schedule to define the temperatures you would like throughout the week. Deep Heating will use these schedules for your target temperatures.

  • Your radiators will be turned off and on as needed to get your temperature sensors to read the scheduled target temperature in each room.
  • Radiators will turn on before the scheduled time if necessary, to get the room up to temperature by the time your schedule kicks in. (This is rather crude at the moment, but works for me).
  • One of your buttons can be used to switch the heating off at night. Your heating won't turn on again until needed, but never before 7am (because my heating is noisy).

Why isn't everything configurable?

Because this project was originally tailored for my own home, there are some things that are not yet configurable. I'll endeavor to fix this if there's any interest :)

Configuration

Environment variables

variable name description
SUPERVISOR_URL The URL of your Home Assistant instance, e.g. http://homeassistant.lan:8123
SUPERVISOR_TOKEN A long-lived access token for your Home Assistant instance
HOME_CONFIG_PATH The path to your home configuration file, e.g. /config/home.json

Home

A single JSON file configures your home:

{
  "heatingId": "...",
  "sleepSwitchId": "...",
  "rooms": []
}
property description
heatingId The climate entity id of the main heating thermostat
sleepSwitchId The event entity of an event (e.g. button press) that turns the heating off at bedtime

Add an object in rooms for each room with a temperature sensor:

{
  "name": "...",
  "temperatureSensorId": "...",
  "climateEntityIds": ["...", "..."],
  "schedule": {
    "monday": {},
    "tuesday": {},
    "wednesday": {},
    "thursday": {},
    "friday": {},
    "saturday": {},
    "sunday": {}
  }
}
property description
name The name of the room, as you would like it displayed in the app
temperatureSensorId The entity id of the temperature sensor to use to measure room temperature
climateEntityIds Array of entity ids of the climate control devices in the room
schedule The schedule of target temperatures for the room

Schedule

A schedule defines the target temperatures for a room, for each day of the week. Here's an example:

{
  "monday": { "07:00": 18, "17:00": 21, "23:45": 15 },
  "tuesday": { "07:00": 18, "17:00": 21, "23:45": 15 },
  "wednesday": { "07:00": 18, "17:00": 21, "23:45": 15 },
  "thursday": { "07:00": 18, "17:00": 21, "23:45": 15 },
  "friday": { "07:00": 18, "17:00": 21, "23:45": 15 },
  "saturday": { "07:00": 18, "17:00": 21, "23:45": 15 },
  "sunday": { "07:00": 18, "17:00": 21, "23:45": 15 }
}

Security

There isn't any! This is currently assumed to be hosted on your home network, if you want to access remotely then use a VPN. Use at your own risk!