/api/… las contesta el ESP32 simulado.F4 = de diagnóstico a calefactor). Gris, el eco que el firmware descarta. Verde, la respuesta de la Webasto (4F, comando | 0x80). El último byte es el XOR de todos los anteriores.| Nº | Cable | Desde | Hasta |
|---|---|---|---|
| 1 | marrón | marrón de la furgo (masa) | Placa TJA1020, borna GND (lado 12V/LIN) |
| 2 | negro | negro de la furgo (W-Bus) | Placa TJA1020, borna LIN |
| 3 | rojo | rojo de la furgo (+12 V) | Placa TJA1020, borna 12V |
| 4 | rojo | rojo de la furgo (empalme del ③) | LM2596, IN+ |
| 5 | marrón | marrón de la furgo (empalme del ①) | LM2596, IN− |
| 6 | naranja | LM2596 OUT+ (5,0 V) | ESP32, pin 5V |
| 7 | gris | LM2596 OUT− | ESP32, pin GND (cualquiera) |
| 8 | verde | Placa TJA1020, borna TX | ESP32, pin IO16 (RX2) |
| 9 | azul | Placa TJA1020, borna RX | ESP32, pin IO17 (TX2) |
| 10 | violeta | Placa TJA1020, borna SLP | ESP32, pin 3V3 |
| 11 | gris | Placa TJA1020, borna GND (lado TX/RX) | ESP32, pin GND (otro, o el mismo) |
| — | amarillo | amarillo de la furgo | no se usa: aíslalo con cinta |
| — | — | Placa TJA1020, borna INH | no se conecta |
| Opcional: pantalla y termómetro (recuadro discontinuo del esquema). Los cuatro van al mismo bus I2C: cada cable une el pin del ESP32 con el de la pantalla y el del termómetro. | |||
| 12 | rosa | ESP32, pin 3V3 (el otro) | Pantalla VCC y termómetro VIN |
| 13 | gris | ESP32, pin GND (o empalme del ⑦) | Pantalla GND y termómetro GND |
| 14 | turquesa | ESP32, pin IO4 (SDA) | Pantalla SDA y termómetro SDA |
| 15 | dorado | ESP32, pin IO5 (SCL) | Pantalla SCL y termómetro SCL |
| 16 | magenta | ESP32, pin IO7 | Botón «calentar»: una pata |
| 17 | gris | Botón «calentar»: la otra pata | Masa: empalme del ⑬ (o un pin GND) |
| Opcional: sensor de monóxido de carbono Winsen ZE07-CO (electroquímico, de los que dan la lectura en ppm por serie; no vale un MQ-7). Si el CO sube, la placa apaga la Webasto, avisa por Telegram y no deja encender. No sustituye a un detector de CO homologado con su propia alarma: ponlo también. | |||
| 18 | naranja | Empalme del ⑥ (5 V del LM2596) | Sensor de CO, VIN (5 V) |
| 19 | gris | Empalme del ⑬ (masa) | Sensor de CO, GND |
| 20 | lima | Sensor de CO, TXD | ESP32, pin IO15 |
status y errores) lo confirma sin encender nada: si la Webasto contesta con su temperatura y su tensión, adelante; si solo sale el eco y «sin respuesta» con el cableado ya revisado, puede que la tuya no sea de W-Bus.status en la consola.Un segundo ESP32 (cualquiera, el clásico o un S3) puede hacerse pasar por la Webasto en el W-Bus: arranca, prende, regula, hace el postbarrido y da averías como una de verdad (es el mismo modelo que el simulador de arriba, contrastado con libwbus). Así se prueba WTTC entero en la mesa, sin gasoil ni furgoneta. Por su consola USB se provocan fallos (sin gasoil, llama que se apaga, sin corriente, cable suelto, batería baja) y se acelera el tiempo. El sketch, las instrucciones y la lista de pruebas: herramientas/webasto_falsa.
pines <rx> <tx>; para la conexión por el bus (B), eco no. Se quedan guardados.Lo más fácil: la consola de esta web (Chrome o Edge en un ordenador): conecta las dos placas a la vez, sabe cuál es cada una, pinta cada línea de un color y lo guarda en .txt o .md. Sin instalar nada.
Las dos placas (WTTC y la Webasto falsa) cuentan por su USB todo lo que hacen. Para verlo en Windows, con PuTTY:
ayuda (Webasto falsa) o info (WTTC) y Enter.Al abrir el puerto la placa se reinicia: es normal. El puerto solo lo puede usar un programa a la vez: cierra antes el Monitor serie de Arduino o la ventana del instalador. Con las dos placas en el mismo ordenador, cada una tiene su COM: abre dos PuTTY. En Linux o Mac: screen /dev/ttyUSB0 115200 (salir: Ctrl+A y luego K).
WTTC/ con WTTC.ino y web.h · 164 KB · 07/11/2026
⬇ WTTC-firmware.zipTodas las versiones de WTTC (firmware del ESP32 y app Android van con el mismo número).
Formato: la versión más reciente arriba. Cada versión publicada tiene su Release en GitHub con el APK y el firmware.
Mientras la versión empiece por 0, es una versión de prueba: compila y funciona en el simulador, pero aún no se
ha comprobado con una Webasto real. La 1.0.0 llegará cuando alguien lo haya probado montado en un vehículo.
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba. Es la 0.3.12 (abajo) con su firmware: la Release 0.3.12 salió solo con la app, porque el análisis
estático paró la compilación por unos formatos de texto de la Webasto falsa.
Versión de prueba (sin probar con una Webasto real).
log 0–log 3 (guardado) y la orden resumen.Versión de prueba (sin probar con una Webasto real).
eco no para la conexión por el bus, pines 16 17) y se quedan guardados.Versión de prueba. Es la 0.3.9 (abajo) con el firmware ya compilando: la Release 0.3.9 salió solo con la app, porque el
firmware de ese commit no compiló (el generador de prototipos del IDE tropezaba con las variables nuevas del sensor de CO).
Versión de prueba (sin probar con una Webasto real ni con el sensor de CO).
- 30 ppm durante 2 min: aviso por Telegram para ventilar.
- Alarma (300 ppm dos lecturas seguidas, 100 ppm 30 s o 50 ppm 3 min): apaga la Webasto, corta el termostato y lo aplazado, avisa por Telegram, lo pone en la pantalla y el LED parpadea en rojo y azul. No deja encender, ni a mano, hasta 5 min seguidos por debajo de 20 ppm.
- Si el sensor que tenía deja de mandar datos, avisa y los encendidos sin nadie delante (programas, «Salgo a las…», termostato) no se hacen; a mano, sí. En Configuración, «Ya no tengo sensor de CO» si se ha quitado a propósito.
- Se ve en la web de la placa, en la app y en el chequeo de la Webasto. En las estadísticas, el encendido sale como «Monóxido (CO) alto».
- No sustituye a un detector de CO homologado con su propia alarma: si la placa falla, este sensor no sirve de nada.
Versión de prueba (sin probar con una Webasto real).
chequeo en la consola y check en la app. Si está calentando, se hace al apagarse.borrar averias): borra la memoria de averías de la Webasto, que es lo que la desbloquea tras varios fallos seguidos. Solo con la calefacción parada.Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
herramientas/webasto_falsa): un segundo ESP32 que hace de Webasto en el W-Bus para probar WTTC en la mesa, con consola para provocar averías (sin gasoil, llama que se apaga, sin corriente, cable suelto, batería baja) y el tiempo acelerado. Su modelo se prueba en GitHub junto al código de WTTC que arma y comprueba las tramas, y se ha contrastado con libwbus: encender solo desde apagada, la orden se mantiene hasta apagarse del todo y sin renovación en 20 s apunta la avería 0x92. El simulador de la web usa ahora las mismas reglas.Versión de prueba (sin probar con una Webasto real).
.elf de la Release) señaló la puesta en hora por internet: se arrancaba al principio del arranque y, como tras un reinicio el reloj conserva la hora, su primera consulta coincidía con la de las órdenes remotas y la pila de red abortaba. Por eso la 0.3.3 se colgó al instalarse y la placa volvió sola a la 0.3.2. Ahora la hora por internet se arranca cuando la Wi-Fi tiene dirección, con la función de la pila de red pensada para ello, y ninguna conexión automática (órdenes, estadísticas, actualizaciones, Telegram, registro) empieza hasta que la Wi-Fi lleve 20 s conectada.Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real). Solo núcleo ESP32 3.x de Arduino: quien compile desde el código con el 2.x tiene que actualizarlo (Gestor de placas → esp32 de Espressif → 3.x); el instalador web y las actualizaciones no cambian.
Control de errores
Depuración
Botón y pantalla
Pruebas automáticas (en cada compilación, en GitHub)
logica.h) y se prueban con muchos casos (también millis() dando la vuelta), con los detectores de errores de memoria de GCC..github/ con propietario (CODEOWNERS).Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
coredump qué tarea falló y por qué direcciones del programa iba, y lo apunta en el registro. Cada Release lleva ahora el .elf del firmware, y herramientas/descifrar_cuelgue.py traduce esas direcciones a nombres de función.Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
info lo vuelve a sacar, y al unirse a la red con internet se escribe su dirección. Solo lo ve quien tiene la placa enchufada por USB; es también la forma de recuperar una clave olvidada.Versión de prueba (sin probar con una Webasto real).
- Consejos para ti sacados de tus datos: cuánto antes encender según el frío, si conviene «calentar hasta», cuánto gastas con y sin termostato, avisos de batería y de humedad, programas que te ahorrarían encenderla a mano, averías que se repiten y el gasto del mes con su previsión.
- Comparación con el periodo anterior, récords, calendario de uso con rachas, mapa de día y hora, cuánto tarda en calentar, coste y litros por hora por mes, termostato (objetivos que más usas y tiempo hasta llegar), humedad, agua del motor y batería por separado.
- Comparación con la media de las demás placas (cuando envíen al menos 3) y descarga de todo en CSV para Excel.
- Agrupa por día, semana o mes según el rango, con fechas concretas, y se instala como app.
Versión de prueba (sin probar con una Webasto real).
wttc / wttc), y con los de fábrica obliga a cambiarlos antes de dejar hacer nada. La sesión dura 30 días en ese navegador (hasta que la placa se reinicie); 5 intentos fallidos, 5 minutos de espera. Por la Wi-Fi propia de la placa no hace falta: ya se puso su clave. Se cambian en Configuración (web y app).- Código de instalación al azar, creado una vez y para siempre (Configuración → Mis estadísticas). Al cambiar de placa se escribe en la nueva el de la vieja y se siguen las mismas estadísticas.
- «Enviar las estadísticas de esta placa» (apagado de fábrica): la placa las envía si tiene internet; si no, la app al conectarse.
- https://wttc.favala.es/mi.php: con el código, gráficas de horas y gasoil por mes, encendidos por día, a qué hora y qué día enciende, quién la enciende, por qué se apaga, temperatura dentro, agua y batería, duración, averías y los últimos encendidos; coste estimado con el precio del gasoil que elijas. Sin el código no se puede ver nada, y se pueden borrar los datos desde la misma página.
- «Enviar el código por Telegram»: llega solo en un mensaje, para copiarlo.
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
wttc.local responden siempre. Gasta algo más con la furgo parada (≈ 40–60 mA, 1–1,5 Ah al día): si va a estar parada días, mejor «Solo mientras calienta» en Configuración. Las placas en las que ya se eligió un modo lo conservan.Versión de prueba (sin probar con una Webasto real). La 0.2.12 fue la primera actualización sin cable hecha en una placa real (subiendo el .ota desde su web).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real). La primera grabada en una placa real: el instalador desde el navegador funciona.
Versión de prueba (sin probar con una Webasto real). Cambio de licencia.
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
herramientas/generar_fuentes.py, sin librerías), barra del tiempo que queda y franja de aviso. Solo se mandan las filas que cambian. Se elige en Configuración → Tipo de pantalla; las de 128×64 siguen valiendo.Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real). Arreglo de la web de la placa.
Versión de prueba (sin probar con una Webasto real). Pantalla, termómetro y termostato. Solo ESP32-S3.
Versión de prueba (sin probar con una Webasto real). Primera que se puede instalar sin cable desde la 0.1.5.
.ota) y el paquete para instalar desde el navegador.Versión de prueba (sin probar con una Webasto real). Actualizaciones sin cable. Esta versión hay que grabarla una
vez por USB (trae una tabla de particiones nueva); a partir de ella, las siguientes se instalan desde la app o la web.
.ota de una Release desde la web de la placa (Configuración → Actualizar firmware).partitions.csv, Arduino la usa sola). La configuración y el PIN no se pierden al cambiarla.Versión de prueba (sin probar con una Webasto real). Mejoras de seguridad.
calefaccion, que es pública), su web solo deja elegir una nueva: no admite órdenes ni enseña el PIN de Bluetooth. No se puede volver a poner la de fábrica.Versión de prueba (sin probar con una Webasto real).
/en/) y alemán (/de/), simulador incluido.Versión de prueba (sin probar con una Webasto real).
Versión de prueba (sin probar con una Webasto real).
Primera versión pública como WTTC. Versión de prueba: aún sin probar con una Webasto real.
web.h y muestra la fecha completa en la cabecera.arduino-cli en Linux y Windows) y de uso (móvil Android, iPhone y radio de coche), descargas y versiones.
Versión inicial (no publicada) (como Webastot5.ino): solo Wi-Fi y web, encendido y apagado, programas semanales, temperatura, tensión, llama, potencia, averías y consola serie.
Todas las versiones publicadas: github.com/matatunos/wttc/releases
| Pieza | Modelo usado | Para qué |
|---|---|---|
| Vehículo y calefactor | VW T5 con calefacción auxiliar de agua Webasto Thermo Top C de fábrica (ref. VW 7H0 010 398 J), mandada por W-Bus desde el temporizador original | Lo que se controla. El ESP32 sustituye al temporizador y se enchufa en su conector |
| Microcontrolador | ESP32-S3 DevKitC-1 N16R8 (16 MB de flash; mejor sobre una base con bornas de tornillo, que no se sueltan con las vibraciones) — desde la versión 0.2.0, el único soportado | Wi-Fi, web, programas, avisos y protocolo W-Bus por su UART2 (IO16/IO17) |
| Transceptor W-Bus | Módulo UART ↔ LIN/K-Line con TJA1020 (el usado es de Gutol: bornas de tornillo 12V/GND/LIN/INH y TX/RX/SLP/GND, sin pin VCC) | Adapta el TTL de 3,3 V del ESP32 al bus de un hilo a 12 V. Vale cualquier módulo con TJA1020 o equivalente (TJA1021, MCP2003, L9637D) |
| Opcional: pantalla | OLED I2C SSD1327 de 1,5" (128×128, 16 grises; la recomendada) o una de 128×64: 1,3" (SH1106) o 0,96" (SSD1306). Dirección 0x3C o 0x3D | Temperatura de dentro, estado, agua, batería y lo siguiente que va a pasar. Se elige el tipo en Configuración |
| Opcional: termómetro | Módulo I2C SHT31 o AHT20 (temperatura y humedad) | Temperatura de dentro: «calentar hasta X °C», hora de salida más afinada y aviso de condensación a la vista |
| Opcional: botón «calentar» | Cualquier pulsador (normalmente abierto), entre IO7 y GND | Encender (30 min, o lo que elijas en Configuración) o apagar sin el móvil, como la tecla de calentar del mando original. Hay que mantenerlo medio segundo |
| Alimentación | Regulador reductor LM2596 (módulo con potenciómetro), ajustado a 5,0 V | Saca los 5 V del ESP32 del +12 V permanente del conector |
| Cableado | Cables dupont hembra para el ESP32, cable de 0,5 mm² para el lado de 12 V, empalmes o regletas y cinta o termorretráctil | Conexiones según el esquema y la lista de cables de arriba |
| Herramientas | Polímetro, destornillador pequeño, PC con USB (Linux o Windows) | Identificar los cables del conector, ajustar el LM2596, programar el ESP32 y la primera prueba por consola |
winget install ArduinoSA.IDE.stable; en Linux, el AppImage (dale permiso de ejecución).https://espressif.github.io/arduino-esp32/package_esp32_index.jsonWTTC/ con WTTC.ino y web.h (el IDE exige que la carpeta se llame como el .ino). Abre WTTC.ino.WTTC/ trae su propia tabla de particiones, con dos huecos para las actualizaciones sin cable, y Arduino la usa sola); y en Puerto el del ESP32 (COMx en Windows, /dev/ttyUSB0 en Linux).info sale otra vez). Escribe status para la primera prueba.curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=~/.local/bin sh arduino-cli config init arduino-cli config add board_manager.additional_urls \ https://espressif.github.io/arduino-esp32/package_esp32_index.json arduino-cli core update-index arduino-cli core install esp32:esp32 # dentro de la carpeta que contiene WTTC/ # ESP32-S3 FQBN=esp32:esp32:esp32s3:FlashSize=16M,PSRAM=opi,PartitionScheme=huge_app arduino-cli compile --fqbn $FQBN WTTC arduino-cli upload --fqbn $FQBN -p /dev/ttyUSB0 WTTC arduino-cli monitor -p /dev/ttyUSB0 -c baudrate=115200
/dev/ttyUSB0: sudo usermod -aG dialout $USER y cierra sesión. En Ubuntu, si el puerto aparece y desaparece, desinstala brltty.winget install ArduinoSA.CLI arduino-cli config init arduino-cli config add board_manager.additional_urls ` https://espressif.github.io/arduino-esp32/package_esp32_index.json arduino-cli core update-index arduino-cli core install esp32:esp32 # dentro de la carpeta que contiene WTTC\ # ESP32-S3 $FQBN = "esp32:esp32:esp32s3:FlashSize=16M,PSRAM=opi,PartitionScheme=huge_app" arduino-cli compile --fqbn $FQBN WTTC arduino-cli upload --fqbn $FQBN -p COM3 WTTC arduino-cli monitor -p COM3 -c baudrate=115200
COM3 por el puerto que salga en arduino-cli board list (o en el Administrador de dispositivos → Puertos COM). Tras instalar con winget, abre una PowerShell nueva para que encuentre arduino-cli.calefaccion: la primera vez la web te pide cambiarla antes de dejarte manejarla) y abre http://192.168.4.1 en Safari..ota de la última versión desde ese mismo apartado.| Modo (Configuración) | Cuándo está la Wi-Fi | Consumo aprox. aparcado |
|---|---|---|
| Siempre encendida (por defecto) | Todo el tiempo | ≈ 40–60 mA (1–1,5 Ah/día) |
| Mientras calienta (lo mejor con la furgo parada días) | Calentando y 10 min después | ≈ 15–25 mA solo con Bluetooth |
| Solo a petición | Cuando la pides desde la app (15 min) y unos minutos para enviar avisos | ≈ 15–25 mA |
/newbot y sigue los pasos: te da el token de tu bot.https://api.telegram.org/bot<TOKEN>/getUpdates; es el número de "chat":{"id":…}.forget), y cambia el PIN.calefaccion): hasta que eliges otra, la web de la placa no deja manejarla ni enseña el PIN, y la app te la pide al conectar. El token de Telegram nunca se muestra después de guardarlo.| Acción | Trama | Respuesta de la Webasto |
|---|
1. Objeto. WTTC (en adelante, «el proyecto») comprende el firmware para ESP32 y ESP32-S3, la aplicación para Android, esta web y su simulador, los esquemas, la documentación y los servicios asociados (estadísticas anónimas y actualizaciones). Es un proyecto personal y sin ánimo de lucro de su autor (matatunos, titular según la licencia), que se pone a disposición del público de forma gratuita. No es un producto comercial: no se vende, no tiene servicio técnico ni de atención al usuario y no ha superado ninguna homologación, certificación ni ensayo de conformidad.
2. Sin garantía. El proyecto se ofrece «tal cual» y «según disponibilidad», bajo la licencia GPL v3 o posterior, sin garantía de ningún tipo, expresa ni implícita, incluidas, sin carácter limitativo, las de funcionamiento, comerciabilidad, idoneidad para un fin concreto, ausencia de errores, compatibilidad con un vehículo o una calefacción determinados y continuidad de los servicios. Mientras su número de versión empiece por 0 es una versión de prueba: compila y se ha comprobado en el simulador, pero no se ha probado instalada con una calefacción Webasto real.
3. Exactitud de la información. La documentación (colores y función de los cables, conexiones, consumos, códigos de avería, estimaciones de gasoil y cualquier otro dato técnico) se basa en fuentes públicas y en suposiciones que no se han comprobado en todos los vehículos. Puede contener errores u omisiones y no sustituye al manual del fabricante, al esquema eléctrico del vehículo ni al criterio de un profesional. Compruébala por tus propios medios antes de conectar nada.
4. Exclusión de responsabilidad. En la máxima medida permitida por la legislación aplicable, el autor no será responsable de ningún daño o perjuicio, directo o indirecto, incidental o consecuente, de cualquier naturaleza —incluidos, entre otros, lesiones personales, intoxicación por monóxido de carbono, incendio, daños en la calefacción, en el vehículo, en su batería o en su instalación eléctrica, pérdida de la garantía o de la cobertura del seguro, sanciones, inmovilización del vehículo, pérdida de datos, lucro cesante o gastos de reparación— que se derive de la descarga, la instalación, el uso, la imposibilidad de uso, la modificación o la distribución del proyecto, de errores de su software o de su documentación, o de la interrupción o el fallo de servicios de terceros de los que depende (como GitHub o Telegram), o que guarde relación con ellos.
5. Responsabilidad del usuario. Quien instala o usa el proyecto lo hace por decisión propia, bajo su exclusiva responsabilidad, y asume todos los riesgos. En particular, le corresponde:
6. Software generado con inteligencia artificial. Todo el código y el contenido del proyecto se han generado con Claude, un modelo de inteligencia artificial de Anthropic, a partir de las indicaciones del autor. Pueden contener errores que no se hayan detectado. Anthropic no forma parte del proyecto ni responde de él.
7. Marcas. Webasto, Thermo Top, Volkswagen, Climatronic, Espressif, ESP32, Arduino, Android, Telegram y GitHub son marcas o denominaciones de sus respectivos titulares. El proyecto no tiene relación con ellos ni cuenta con su aprobación o patrocinio; sus nombres se usan solo para indicar con qué equipos y servicios es compatible o funciona.
8. Límites de esta exclusión. Nada de lo anterior excluye ni limita la responsabilidad en los casos en que la ley no permite hacerlo, como la derivada de dolo o culpa grave. Si alguna parte de este texto se considerase nula o inaplicable, el resto seguirá siendo válido.
9. Aceptación y ley aplicable. Descargar, instalar o usar cualquier parte del proyecto implica haber leído y aceptado esta descarga de responsabilidad y la licencia GPL v3; si no estás de acuerdo, no lo uses. En lo no previsto aquí se aplica la legislación española. Si hubiera diferencias entre las versiones en distintos idiomas, prevalece la española.
Este texto complementa, sin sustituirla, la exención de garantía y de responsabilidad de la licencia GPL v3 (cláusulas 15 y 16) (fichero LICENSE del repositorio).
WTTC · software libre (GPL v3) en GitHub · código y contenido generados íntegramente con Claude (Anthropic) · proyecto personal sin relación con Webasto ni Volkswagen.