User guide
What Warmcast does
Warmcast learns how your home gains and loses heat: how fast each room cools, how much heat the floors and walls hold, and how much the sun warms each room. Later it will use that to plan your heat pump's heating ahead in half-hour slots. It will store heat in the house and the hot water tank when energy is cheapest or the heat pump runs most efficiently, and hold back before a sunny day so rooms do not overheat.
Comfort always comes first. Your own thermostats and automations stay in charge and keep the house warm if Warmcast stops.
What this version does
It only reads. Every minute it reads the sensors you listed and adds one row to its own reading log. Each night at 22:00 it tries to learn a model of your house from that log. The Overview tab shows whether the log is being written and what the last nightly refit said.
It publishes no sensors, changes no settings and makes no plans.
Heating mode is what your heat pump is set to, for example Night Only or Continuous. Warmcast only reads it. It does not change it.
What shadow mode means
Shadow mode means Warmcast works out what it would do but does not act on it. You can watch what it would have done and compare it with what happened, with no risk to your comfort. Warmcast always starts in shadow mode. It only acts once you switch it to Advisory or Control yourself.
Until its model passes Gate 2, Warmcast has no tested model to work out what it would do, so for now it reads your sensors and learns. Passing Gate 2 does not switch anything on: it then starts working out what it would do, still without acting on it.
Gate 1 and Gate 2
Warmcast moves forward only when it has passed a check, called a gate, so it never plans with a model that has not been tested.
Gate 1: enough data
At least 14 days with the heating on, including 3 cold days and 3 sunny days, with every sensor recording. Until then the nightly refit may say there is not enough data yet. That is normal.
The Overview counts the days received so far under "What it is doing now". A day counts
only once it has ended and at least 80% of its readings were logged with the outdoor
temperature, the heat output and every room's temperature. A heating-on day is one with no
part in a heating-off period from house.toml. Learning also needs 7 days to
learn from and 3 more to test what it learned. Cold and sunny days are not counted until
what counts as a cold day and a sunny day has been set.
Before the plan and history are available, Warmcast will show them the next day, based on the readings logged so far. It will be refined as more readings are captured.
Gate 2: accurate forecasts
For a week, the model forecasts the warmest part of each day in every room to within about 0.5 °C. The forecast is made the evening before, so it is a fair test. Once Gate 2 is passed, shadow-mode plans and forecasts appear on the Overview and Plan tabs.
Your home's location
Warmcast needs your home's latitude and longitude to work out where the sun is, so it can
tell morning sun from afternoon sun. Enter them on the App & house tab of the Settings
page, or put them in
house.toml as latitude and longitude; the app will not
start without them.
Find your home's latitude and longitude at
https://www.itilog.com/
(search for your address, then copy the two numbers shown). West and south are negative.
The Settings page
The Settings page has these tabs.
- App & house: what heats your home, your location, the heating-off periods already set, the outdoor temperature sensor and the list of rooms, where you add or remove a room.
- Rooms: one section per room, with its name, heating type, comfort range, the two sun settings and its own sensors. Every room needs a thermostat sensor. Tick Has a floor sensor or Has door or window sensors to choose those; a room can have several door or window sensors. Unticking a box tells you which sensor will no longer be logged. A room whose heating ceiling your install already logs shows it under the room's sensors. The ceiling is the setpoint your Home Assistant automation sets, which tells the room when to stop taking heat.
- Hot water: the hot water valve, the immersion heater's electricity, and any other hot water readings your install already logs, such as the tank temperature and setpoint.
- Energy: the heat pump's electricity, solar generation, solar panel power now and your electricity tariff.
- Heat pump: heat output, heating mode, and the readings your heat pump gives about how it is running, such as the leaving and return water temperatures, flow rate, compressor speed, defrost, the leaving water setpoint and offset, and its own mode.
- Other sensors: any reading that fits none of the tabs above. This tab appears only when there is one.
- Save: what you have changed on each tab.
Choosing sensors
Each reading shows the sensor behind it: its name in Home Assistant in bold, then its entity id. Choose Change to search your own entities for another one; the list shows only entities of the right kind. Picking one puts it in place of the old one and says it is not saved yet. Undo puts the earlier sensor back. An optional reading also has Clear, for when you have no such sensor.
Saving
Your changes on every tab are kept while you move between tabs. Nothing is saved until you choose Save, at the bottom of the page, and Save saves every tab together. If something is wrong, nothing is saved, and the message at the top says what to fix and which tab it is on. A room's sensors are saved with the room, so a box ticked without a sensor chosen is refused. The change applies when you restart Warmcast.
How to read the charts
The Charts tab shows the last 24 hours of readings from the log. Every time on the dashboard is in the house time zone from your house settings (Europe/London unless you changed it), not the time zone of the device you are using, so the times match your heating.
- The first chart has one line per room, plus a dashed line for the outdoor temperature. Rooms with underfloor heating warm slowly and keep warming for a while after the heat pump stops. Rooms with radiators respond faster.
- The second chart is the heat pump's heat output in kilowatts. The sensor measures all the heat the heat pump makes. When the hot water valve reading is available, heat for the hot water tank is shown as its own line, apart from space heating. Older readings, from before the valve was logged, cannot be split, so they show as a dashed line labelled total heat, hot water not separated.
- Heat can read low, or below zero, for a few minutes at a time. This happens during defrost, when the heat pump briefly reverses to clear ice from the outdoor unit, and it is expected. If a defrost reading is bound, those times are shaded light grey on the heat chart.
- A gap in a line means there was no reading then, for example because a sensor was unavailable. Warmcast never fills a gap with a made-up number.
- Hover over or tap a chart to see the exact readings at that time.
If something looks wrong
- Overview says “Stopped logging”. Check that Home Assistant is running, then open the app's log in Home Assistant for the reason.
- A feed shows “Missing”. The entity had no reading at the last sample. Check the entity in Home Assistant, and check which entity is chosen for it on the Settings page.
- The charts are empty. There are no readings from the last 24 hours yet. The charts need no internet access: the chart library comes with the app.