{"id":28997744,"url":"https://github.com/danielkucera/esp-arduino-ebus","last_synced_at":"2026-04-08T06:03:17.307Z","repository":{"id":61087804,"uuid":"168523446","full_name":"danielkucera/esp-arduino-ebus","owner":"danielkucera","description":"ESP-based Wi-Fi firmware for eBUS adapter hardware","archived":false,"fork":false,"pushed_at":"2026-04-04T07:10:20.000Z","size":34946,"stargazers_count":121,"open_issues_count":50,"forks_count":18,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-04-04T07:22:32.143Z","etag":null,"topics":["ebus","esp32","heating","home-automation","homeassistant","platformio"],"latest_commit_sha":null,"homepage":"https://danman.eu/ebus-adapter","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielkucera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-01-31T12:43:36.000Z","updated_at":"2026-04-04T07:06:09.000Z","dependencies_parsed_at":"2023-02-17T18:16:04.648Z","dependency_job_id":"96c7fff7-de20-467e-b572-95d978b12fe4","html_url":"https://github.com/danielkucera/esp-arduino-ebus","commit_stats":null,"previous_names":["danielkucera/esp-arduino-ebus","danielkucera/esp8266-arduino-ebus"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/danielkucera/esp-arduino-ebus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielkucera%2Fesp-arduino-ebus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielkucera%2Fesp-arduino-ebus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielkucera%2Fesp-arduino-ebus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielkucera%2Fesp-arduino-ebus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielkucera","download_url":"https://codeload.github.com/danielkucera/esp-arduino-ebus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielkucera%2Fesp-arduino-ebus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31542384,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ebus","esp32","heating","home-automation","homeassistant","platformio"],"created_at":"2025-06-25T06:09:14.573Z","updated_at":"2026-04-08T06:03:17.273Z","avatar_url":"https://github.com/danielkucera.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# esp-arduino-ebus\n\nESP-based Wi-Fi firmware for eBUS adapter hardware\n\n**Warning: Do not power your adapter from a power supply on eBus terminals - you will burn the transmit circuit (receive may still work)!**\n\nTo get more info navigate to [wiki](https://github.com/danielkucera/esp-arduino-ebus/wiki)\n\n`esp-arduino-ebus` is an open-source firmware for [EBUS to WiFi Adapter Module](https://danman.eu/ebus-adapter).  \nIt 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.\n\n\u003e ⚠️ **This firmware is designed to run only on supported eBUS adapter boards.**  \n\u003e It is **not** intended for bare ESP modules without the required eBUS interface circuitry.\n\n---\n\n## What This Project Does\n\n- 🔌 Connects to **eBUS heating systems** (Vaillant and other eBUS-compatible HVAC equipment)\n- 📡 Bridges the physical eBUS line to **Wi-Fi / Ethernet**\n- 🌍 Exposes eBUS traffic over **TCP sockets** compatible with tools like `ebusd`\n- 📊 Publishes data to **MQTT** for smart home integration\n- 🏠 Supports **Home Assistant autodiscovery**\n- ⚙️ Provides a **web interface** for configuration and diagnostics\n\n---\n\n## Required Hardware\n\nThis firmware **requires a compatible eBUS adapter board**, which provides:\n\n- Proper **eBUS level shifting and electrical protection**\n- Safe **bus power handling**\n- Signal conditioning (PWM / comparator circuitry)\n- Reliable physical connection to the eBUS line\n\nSupported hardware revisions include multiple ESP32-based eBUS adapter boards maintained alongside this project.\n\n\u003e ❌ Flashing this firmware onto a generic ESP8266/ESP32 module **will not work**.\n\n---\n\n## 🧠 INTERNAL Firmware Mode\n\nIn addition to acting as a network bridge, `esp-arduino-ebus` offers an advanced **INTERNAL firmware mode**, allowing the adapter to behave as an **active, autonomous eBUS participant**.\n\n### Key INTERNAL Features\n\n- 🧾 **Internal command store** for eBUS messages\n- 💾 **Persistent storage** in flash, restored after reboot\n- 🔍 **Automatic eBUS device scanning**\n- 🔄 **Active and passive operation** on the bus\n- 📡 **Full remote control via MQTT or HTTP**\n\n### INTERNAL Control Capabilities\n\n- Insert or remove stored eBUS commands\n- Send single or periodic commands\n- Publish stored values on demand\n- Enable filtering and forwarding rules\n- Trigger bus scans and internal resets\n\nThis mode enables **standalone operation** without requiring external software such as `ebusd`.\n\n---\n\n## Smart Home Integration\n\n- Native **MQTT support**\n- **Home Assistant autodiscovery**\n- Seamless integration into existing automation setups\n- Suitable for dashboards, logging, and energy optimization\n\n---\n\n## Why Choose esp-arduino-ebus?\n\n- ✅ Designed for **real eBUS adapter hardware**\n- 🔓 Fully **open source**\n- ⚡ Low-power, always-on operation\n- 🔧 Flexible: bridge mode or INTERNAL standalone mode\n- 🧩 Compatible with existing eBUS tools and ecosystems\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielkucera%2Fesp-arduino-ebus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielkucera%2Fesp-arduino-ebus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielkucera%2Fesp-arduino-ebus/lists"}