danielkucera / esp-arduino-ebus
ESP-based Wi-Fi firmware for eBUS adapter hardware
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing danielkucera/esp-arduino-ebus in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler viewesp-arduino-ebus ESP-based Wi-Fi firmware for eBUS adapter hardware **Warning: Do not power your adapter from a power supply on eBus terminals - you will burn the transmit circuit (receive may still work)!** To get more info navigate to wiki is an open-source firmware for EBUS to WiFi Adapter Module. It turns the adapter into a **network-connected eBUS interface** with TCP, MQTT, HTTP, and Home Assistant support ā suitable for monitoring and controlling eBUS-based heating systems. > ā ļø **This firmware is designed to run only on supported eBUS adapter boards.** > It is **not** intended for bare ESP modules without the required eBUS interface circuitry. --- What This Project Does ā¢ š Connects to **eBUS heating systems** (Vaillant and other eBUS-compatible HVAC equipment) ā¢ š” Bridges the physical eBUS line to **Wi-Fi / Ethernet** ā¢ š Exposes eBUS traffic over **TCP sockets** compatible with tools like ā¢ š Publishes data to **MQTT** for smart home integration ā¢ š Supports **Home Assistant autodiscovery** ā¢ āļø Provides a **web interface** for configuration and diagnostics --- Required Hardware This firmware **requires a compatible eBUS adapter board**, which provides: ā¢ Proper **eBUS level shifting and electrical protection** ā¢ Safe **bus power handling** ā¢ Signal conditioning (PWM / comparator circuitry) ā¢ Reliable physical connection to the eBUS line Supported hardware revisions include multiple ESP32-based eBUS adapter boards maintained alongside this project. > ā Flashing this firmware onto a generic ESP8266/ESP32 module **will not work**. --- š§ INTERNAL Firmware Mode In addition to acting as a network bridge, offers an advanced **INTERNAL firmware mode**, allowing the adapter to behave as an **active, autonomous eBUS participant**. Key INTERNAL Features ā¢ š§¾ **Internal command store** for eBUS messages ā¢ š¾ **Persistent storage** in flash, restored after reboot ā¢ š **Automatic eBUS device scanning** ā¢ š **Active and passive operation** on the bus ā¢ š” **Full remote control via MQTT or HTTP** INTERNAL Control Capabilities ā¢ Insert or remove stored eBUS commands ā¢ Send single or periodic commands ā¢ Publish stored values on demand ā¢ Enable filtering and forwarding rules ā¢ Trigger bus scans and internal resets This mode enables **standalone operation** without requiring external software such as . --- Smart Home Integration ā¢ Native **MQTT support** ā¢ **Home Assistant autodiscovery** ā¢ Seamless integration into existing automation setups ā¢ Suitable for dashboards, logging, and energy optimization --- Why Choose esp-arduino-ebus? ā¢ ā Designed for **real eBUS adapter hardware** ā¢ š Fully **open source** ā¢ ā” Low-power, always-on operation ā¢ š§ Flexible: bridge mode or INTERNAL standalone mode ā¢ š§© Compatible with existing eBUS tools and ecosystems ---