otgw-firmware

OTGW-firmware es un firmware para el NodoShop OpenTherm Gateway, que se sitúa entre un termostato OpenTherm y una caldera. La configuración compatible v2.0.0 utiliza un ESP32-S3 LOLIN S3 Mini con el coprocesador PIC existente de la pasarela; v1.x admitía módulos ESP8266, pero ESP8266 ya no es un objetivo de compilación para v2. El proyecto se compila con PlatformIO y se puede flashear usando el flasher de Python proporcionado o comandos de PlatformIO. El firmware decodifica el tráfico del bus OpenTherm, lo expone mediante un panel basado en navegador con registros y gráficos en vivo, y proporciona una API REST. La compatibilidad con MQTT incluye autodescubrimiento de Home Assistant para más de 250 entidades, que abarcan temperaturas, puntos de consigna, modulación, estado de llama, agua caliente, fallos, presión, sensores y controles SAT. Un puente serie TCP en el puerto 25238 sigue siendo compatible con OTmonitor y la integración OpenTherm Gateway integrada de Home Assistant. SAT (Smart Autotune Thermostat) es un controlador de calefacción integrado que puede gestionar la temperatura de impulsión de la caldera sin depender de un controlador externo de domótica. Combina compensación climática con un controlador PID, ajuste automático, modos radiador/suelo radiante/bomba de calor, preajustes, promedio de temperatura multizona, compensación por ganancia solar, supresión estival, monitoreo de presión y comprobaciones de seguridad. Puede usar sensores Dallas DS18B20, medición por pulsos S0 y hasta cuatro sensores BLE Xiaomi LYWSD03MMC usando BTHome v2 en ESP32. Otras características documentadas incluyen una pantalla de estado OLED SSD1306, portal de configuración Wi-Fi y respaldo AP, Ethernet W5500 opcional con conmutación por error, actualizaciones OTA de firmware y sistema de archivos, registro de depuración por Telnet, webhooks, transmisión de registro en vivo por WebSocket, autenticación básica HTTP opcional para endpoints protegidos de configuración/mantenimiento y recuperación de credenciales mediante triple reinicio. Existe un modo OpenTherm directo por GPIO del ESP32 llamado OTDirect, que incluye modos termostato, caldera, pasarela, monitor y maestro+esclavo, mientras que la placa de hardware directo se describe solo como prototipo. El README indica que v2.0.0 es software alfa y dirige a los usuarios de producción a la rama 1.x o a las versiones publicadas. También advierte no flashear el firmware PIC por Wi-Fi con OTmonitor, no realizar actualizaciones del PIC mientras OTDirect esté activo y mantener el dispositivo en una red local de confianza en lugar de exponerlo directamente a internet. El proyecto tiene licencia GPLv3, con componentes de terceros que conservan sus licencias indicadas.