Control Hcalory Bluetooth-enabled heaters using Home Assistant!
This integration lets Home Assistant do many of the things the Hcalory app does. You can:
- Turn the heater on and off
- Set the heater mode (either thermostat, or "gear", which is really just a 1-6 power scale)
- Change the heater mode's setting (either degrees if you're in thermostat mode, or which "gear" you're in)
- View the built-in thermometer's temperature
- View the temperature of the heat exchanger
- View the battery voltage
- View error conditions (right now, that's only E08)
- Work reliably
- Work with any Hcalory heater model beyond the one I tested
- It's possible it could work, but I only own the heater I own, so I can't reverse engineer anything else
- If that link dies, here's an archive link
- Additionally, here's what I assume is the same model on Hcalory's website, plus a Wayback Machine link
- If all of those links die or fail to work, it's the Hcalory "short-app" (ridiculous model "name"). The model number listed on the Amazon page is SKUK63125. The model listed on Hcalory's website is "W1". The "variant" on the Hcalory website is 41155845849131
Currently, this integration doesn't support doing these things:
- Changing the units. In fact, you should probably set the units on your heater to °F because that's the unit I assumed. I believe Home Assistant should let you convert to °C on the frontend if you'd like
- Setting timers. Just use Home Assistant to turn the thing on/off, or send a PR to hcalory-control if you'd like to add support for this feature
- Using the "Blow Wind" (AKA "just turn on the fan") feature
- Toggling high plateau mode. If anyone besides me uses this integration and has a need for it, submit an issue and I'll go reverse engineer it myself
- Some way for your Home Assistant instance to use Bluetooth
- While this integration can be used with something like a USB Bluetooth dongle, I wouldn't recommend it. Instead, an ESPHome Bluetooth Proxy should be used, which lets you get a Bluetooth antenna anywhere you have wifi reception. Don't be scared off by the thought of flashing microcontrollers because it's shockingly easy. You can literally do everything you need from within your web browser
- Install the Hcalory BLE integration using this handy button:
Please be careful. These heaters are relatively safe, but they're still on fire and they still produce horribly toxic exhaust products. You're trusting your control over your heater to Bluetooth and code written by some random idiot on the internet. Please ensure you have carbon monoxide detectors and fire alarms installed where you plan to use your heater.