OTGateway
OTGateway is a powerful open-source solution for controlling OpenTherm-compatible boilers, turning your heating system into a smart one. Set the perfect temperature, save on energy bills, and eliminate unnecessary hassle — integration with Home Assistant makes heating management simple and automated.
Install / Use
/learn @Laxilef/OTGatewayREADME

Features
- DHW temperature control
- Heating temperature control
- Smart heating temperature control modes:
- PID
- Equithermic curves - adjusts the temperature based on indoor and outdoor temperatures
- Hysteresis setting (for accurate maintenance of room temperature)
- Ability to connect additional (external) sensors: Dallas (1-wire), NTC 10k, Bluetooth (BLE). Makes it possible to monitor indoor and outdoor temperatures, temperatures on pipes/heat exchangers/etc.
- Emergency mode. In any dangerous situation (loss of connection with Wifi, MQTT, sensors, etc) it will not let you and your home freeze.
- Ability of remote fault reset (not with all boilers)
- Diagnostics:
- Displaying gateway status
- Displaying the connection status to the boiler via OpenTherm
- Displaying the fault status and fault code
- Displaying the diagnostic status & diagnostic code
- Display of the process of heating: works/does not work
- Display of burner (flame) status: on/off
- Display of burner modulation level in percent
- Display of pressure in the heating system
- Display of current temperature of the heat carrier
- Display of return temperature of the heat carrier
- Display of setpoint heat carrier temperature (useful when using PID or Equitherm)
- Display of the process of DHW: working/not working
- Display of current DHW temperature
- And other information...
- Home Assistant integration via MQTT. The ability to create any automation for the boiler!
Documentation
All available information and instructions can be found in the wiki:
- Home
- Compatibility
- FAQ & Troubleshooting
- OT adapters
Gratitude
- To the developers of the libraries used: OpenTherm Library, ESP8266Scheduler, ArduinoJson, NimBLE-Arduino, ArduinoMqttClient, ESPTelnet, FileData, GyverPID, GyverBlinker, OneWireNg & OneWire
- To the PlatformIO Team
- To the team and contributors of the pioarduino project
- To the BrowserStack team. This project is tested with BrowserStack.
- To the PVS-Studio - static analyzer for C, C++, C#, and Java code.
- And of course to the contributors for their contribution to the development of the project!
Related Skills
node-connect
339.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
83.9kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
339.5kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
83.9kCommit, push, and open a PR
