Hi,
I’d like to share a fully working ESPHome BLE integration
for Hcalory / AirHeater diesel heaters.
This project is based on reverse-engineering the BLE protocol
used by the official mobile apps. As far as I know, there was
no complete working solution available before.
Features:
- Power ON / OFF (same sequence as the mobile app)
- Power level control (gear 0–6)
- Temperature and voltage readings
- Error handling (E-01 … E-10)
- Native Home Assistant entities
Hardware:
- ESP32
- BLE-enabled diesel heater (Hcalory / AirHeater)
Repository (code + protocol documentation):
GitHub - mSoftMS/AirHeater-BLE: Hcalory / AirHeater BLE – ESPHome + Home Assistant
The repo includes:
- ESPHome YAML
- Full README
- Reverse-engineered BLE protocol (PROTOCOL.md)
Tested on real devices.
Feedback and reports from other heater models are welcome.