eBUS Adapter Shield v5

Firmware change history

See also on github.

Version 2026-07-04, reported as 1[6704]

Flash this version

• features:
  • micro-ebusd: log bus request reason, e.g. poll
  • generic: smaller enhancements
  • web UI: update UI library, add workaround for overlay positioning issue
• fixes:
  • generic: fix syslog host parsing
  • micro-ebusd: fix missed JSON deallocation
• other:
  • updated ESP-IDF to v5.5.4 release on commit bb2188b
  • updated mdns, DS18b20, and onewire_bus components

Version 2026-06-07, reported as 1[6607]

Flash this version

• features:
  • micro-ebusd: include message poll in config save+restore
  • generic: add NVS usage to “nvs_list” verbose output
  • generic: add option to run custom REPL commands on startup
  • web-UI: add button for downloading the log
• fixes:
  • micro-ebusd: avoid unnecessary dynamic file deletion
• other:
  • updated ESP-IDF to v5.5.4 release on commit c2dd042

Version 2026-05-11, reported as 1[650b]

Flash this version

• features:
  • generic: add optional common name verification to MQTT with TLS
  • generic: add I2C BMP+BME sensors to MQTT and Home Assistant discovery
  • web UI: add config save+restore
• fixes:
  • generic: fix missed enhanced protocol reset notification on connectionless host (Raspi+USB serial)
  • micro-ebusd: remove Home Assistant discovery entry for previous ebusd connection

Version 2026-05-06, reported as 1[6506]

Flash this version

• features:
  • micro-ebusd: increase the limit for uploading temporary message definitions from 10k to 32k
  • micro-ebusd: update messages definitions to ebusd-configuration commit cdc11e1
  • micro-ebusd: add option to list and delete own files on webservice
  • web UI: update UI library, add confirmation to reboot and file reload actions
• fixes:
  • micro-ebusd: fix handling of const message fields
  • generic: extend connect timeout on improv
• other:
  • updated ESP-IDF to v5.5.4 release on commit e467828
  • updated mdns, DS18b20, and onewire_bus components

Version 2026-04-22, reported as 1[6416]

Flash this version

• features:
  • micro-ebusd: new message definition file format introducing min/max/step values per field.
    This is backwards compatible, i.e. a newer firmware can still use older files, but not vice versa.
    As a consequence, before switching back to a version before 2026-04-22, all stored files need to be dropped manually, e.g. by issuing “rm /data/*” from the REPL.
  • micro-ebusd: adjust several HA attributes and update messages definitions to ebusd-configuration commit 365470c

Version 2026-03-30, reported as 1[631e]

Flash this version

• features:
  • micro-ebusd: add poll data to ‘info’ command
  • micro-ebusd: add delay measurement to verbose output
• fixes:
  • micro-ebusd: avoid unnecessary memory allocation on too many requests in sequence
  • generic: fix potentially stalled host communication via UART as well as RX pin settings (see here and ESP_IDF issue)
  • generic: longer timeout for HTTP client during OTA
  • micro-ebusd: fix dynamic filename built for load instruction
  • generic: avoid starting manually configured ethernet if set to skip
• other:
  • updated mdns and DS18b20 components

Version 2026-03-17, reported as 1[6311]

Flash this version

• features:
  • generic: add adc continuous options
  • generic: increase tolerance for eBUS signal detection
  • web UI: minor improvements
• fixes:
  • generic: resend button MQTT topic on HA birth
  • generic: delay re-sending MQTT topics after HA birth and sent discovery messages
• other:
  • updated ESP-IDF to v5.5.3 release on commit a9de5ec (includes patches in UART driver)
  • updated mdns and led_strip components

Version 2026-03-04, reported as 1[6304]

Flash this version

• features:
  • generic: increase tolerance for eBUS signal detection
  • web UI: add advanced settings toggle to eBUS section
• fixes:
  • micro-ebusd: execution of load instruction in message definitions without context (introduced 20260301)
  • generic: wrong URLs on MQTT HA device entry
  • web UI: wrong links to docs and changelog

Version 2026-03-01, reported as 1[6301]

Flash this version

• features:
  • micro-ebusd: increase maximum of configurable receive timeout
  • micro-ebusd: allow uploading own message definitions for completely unknown addresses as well
  • generic: add low RSSI warning with red LED dimming down slowly
  • web UI: minor improvements
• other:
  • updated mdns component

Version 2026-02-22, reported as 1[6216]

Flash this version

• features:
  • micro-ebusd: add configurable receive timeout
  • web UI: minor improvements
• fixes:
  • micro-ebusd: fix /get and /set endpoints potentially picking the wrong message

Version 2026-02-08, reported as 1[6208]

Flash this version

• features:
  • micro-ebusd: add reload command and API and UI actions
  • micro-ebusd: add “keep scan” option
  • micro-ebusd: add support for storing own message files as well as uploading temporary using tsp2ebusd
  • micro-ebusd: update messages definitions to ebusd-configuration commit f728598
  • micro-ebusd: allow omitting non-required fields in MQTT+API write
  • web UI: minor improvements
• fixes:
  • micro-ebusd: fix max value for bit types
  • micro-ebusd web UI: fix number validation
• other:
  • updated ESP-IDF to v5.5.2 release on commit 87912cd

Version 2026-01-18, reported as 1[6112]

Flash this version

• features:
  • micro-ebusd: add configurable explicit scan addresses
  • generic: add configurable DNS (main/fallback)
  • generic: enhance Home Assistant update entity
  • web UI: minor improvements
• fixes:
  • generic: fix error on verbose info in enhanced protocol
  • micro-ebusd: fix missing TEM_P datatype
• other:
  • updated ESP-IDF to v5.5.2 release on commit f56bea3d1

Version 2026-01-04, reported as 1[6104]

Flash this version

• features:
  • micro-ebusd: extend /get API for use with circuit+message name
  • micro-ebusd web UI: reveal ebusd-configuration version being used
  • generic: add CPU usage, extend “info” command, and add optional debug topics to MQTT + HA Discovery
  • generic: optimize CPU usage e.g. when JTAG is not connected
  • generic: enable 802.11k+v on ESP32-C6 build (network assisted roaming with RRM+BTM)
  • web UI: minor improvements
• fixes:
  • micro-ebusd: fix for large HA Discovery messages
  • generic: fix functions calling other functions in startup scripts (could lead to e.g. WPS not starting)
  • generic: fix MQTT TLS connection
• other:
  • updated ESP-IDF to v5.5.2 release on commit 913c2b4f1 and migrated enhanced drivers (including UART+JTAG, also fixes the Raspberry Pi GPIO connection mode)

Version 2025-12-31, reported as 1[5c1f]

Flash this version

• features:
  • generic: allow configuring non-default Home Assistant Birth topic and payload
  • generic: add button to MQTT and Home Assistant Discovery
  • web-UI: ask for confirmation when leaving a page with unsaved changes
  • web UI: minor improvements
• fixes:
  • micro-ebusd web-UI: fix message list after saving polls

Version 2025-12-14, reported as 1[5c0e]

Flash this version

• features:
  • micro-ebusd web-UI: add status information including seen devices, scan status, and loaded files
  • generic: optimize memory usage (especially for ESP32-C3) and release WiFi stack if unused
  • web UI: minor improvements
• fixes:
  • micro-ebusd: avoid unnecessary manufacturer scan

Version 2025-12-07, reported as 1[5c07]

Flash this version

• features:
  • micro-ebusd: add multiple poll levels, configurable in “Messages” tab, and show estimated interval in tooltip
  • micro-ebusd: wait for answer in “hex” command
  • generic: add PWM outputs and allow higher precision for 1-wire DS18B20 sensors
  • web UI: add ADC low range input
  • generic: optimize nvs commands
• fixes:
  • generic: bring back UART RX pull-up “stolen” by ESP-IDF commit a1ba653 (fixes the Raspberry Pi GPIO connection mode, at least on RPI3)
  • generic: solve stalled JTAG transfer seen sometimes when the host rebooted
  • generic: resend Home Assistant MQTT discovery and status info when online message is received (even if the status did not change)
  • web UI: minor improvements

Version 2025-11-30, reported as 1[5b1e]

Flash this version

• features:
  • micro-ebusd web UI: enhance “Messages” tab with value lists, switches, numbers, and validation for writing, and show cache age
• fixes:
  • generic: send Home Assistant MQTT discovery always and all of them additionally when status message tells HA is online
  • micro-ebusd: use default poll interval of 60s if not configured yet
• other:
  • updated mdns component

Version 2025-11-23, reported as 1[5b17]

Flash this version

• features:
  • micro-ebusd: enhance “cache” command
• fixes:
  • ota: stop watchdog during update
  • micro-ebusd: fix message definition inclusion from another file
  • micro-ebusd web UI: allow using cached data for passive messages
• other:
  • updated mdns component
  • updated ESP-IDF to v5.3.4 release on commit cb920e322

Version 2025-11-16, reported as 1[5b10]

Flash this version

• features:
  • micro-ebusd: load message definitions from web if not already stored in flash
  • web UI: add clear button to log tab
• fixes:
  • micro-ebusd: fix loading message definition by scan result
  • ota: fix update availability check for web UI
  • ethernet: fix explicitly configured IP treated as disconnected
  • web UI: minor improvements

Version 2025-11-02, reported as 1[5b02]

Flash this version

• features:
  • disconnect during station “scan” command only if needed and reconnect afterwards
  • retrieve full output of commands executed via web REPL
• fixes:
  • improve reloading retained logs
  • avoid CDN for web UI base components due to potential connectivity issues on AP
  • minor improvements to web UI

Version 2025-10-30, reported as 1[5a1e]

Flash this version

• hot stuff:
  • this is the first release including micro-ebusd, see here for details.
    it includes the messages definitions as of ebusd-configuration commit 7b47241 and uses a completely new eBUS codec engine based on the experience with ebusd, ebusd-configuration, and ebus-typespec. The main feature highlights of micro-ebusd covered in this release are:
    • automatic scan just like ebusd
    • view, search, read, and write identified messages directly from the web UI
    • list, read, and write identified messages as well as hex messages via REPL
    • allow polling selected messages, adjustable in web UI
    • partially cache messages seen on eBUS
    • optionally send decoded message content via MQTT
    • optionally send discovery messages to Home Assistant via MQTT with several filtering options
• features:
  • add better names to Home Assistant integration for device entities (via MQTT discovery)
  • reduce memory consumption in several APIs (JSON and MQTT)
  • move web UI base components to CDN
  • no longer activate TX LED when sending SYN
  • add low range option to “adc” command
  • add syslog, use retained memory for log entries and allow adjusting the log level
  • add raw log view to web UI
• fixes:
  • fix integrated self-signed SSL certificate (#100)
  • change MQTT update topic to expect content in order to prevent unintended OTA
  • also stop mDNS and MQTT during OTA update
  • some minor improvements
• other:
  • updated onewire component and enable pull-up
  • updated ESP-IDF to v5.3.4 release on commit 13ec3f6

Version 2025-06-15, reported as 1[560f]

Flash this version

• features:
  • add Home Assistant integration via MQTT discovery including update entity
  • add follow log option to UI
  • add better responsive UI
  • add faster transfer via MQTT with QoS 0
• fixes:
  • fix extended MQTT URI storage
• other:
  • updated ESP-IDF to v5.3.3 release on commit d1159f6

Version 2025-05-17, reported as 1[5511]

Flash this version

• features:
  • add option to skip Ethernet module check
  • add extended MQTT URI length
  • add watchdog
• fixes:
  • fix weird REPL in web serial
• other:
  • updated ESP-IDF to v5.3.3 release on commit 995b09e

Version 2025-04-15, reported as 1[540f]

Flash this version

• features:
  • add option to erase other partition to UI and “ota” command
• other:
  • updated mDNS component
  • updated ESP-IDF to v5.3.3 release on commit 60d077e

Version 2025-02-16, reported as 1[5210]

Flash this version

• features:
  • turn off red LED when WPS succeeded
  • drop irrelevant logging during boot
  • add ADC inputs to UI
  • add option to send pin status and sensors to MQTT
  • nicer UI
• fixes:
  • fix IMPROV transfer including newline chars (e.g. for scan result)
  • fix reset in “strip” command
• other:
  • updated mDNS component
  • updated ESP-IDF to v5.3.2 release on commit a916a25

Version 2025-01-20, reported as 1[5114]

Flash this version

• features:
  • start WPS after button press only when device is unconfigured and add WPS status to query command
• other:
  • updated mDNS component
  • updated ESP-IDF to v5.3.2 release on commit adf5319

Version 2024-12-21, reported as 1[4c15]

Flash this version

• features:
  • nicer UI
• fixes:
  • fix wifi scan and join while wps enabled
  • fix previous build (20241215) with mismatched bundled UI
• other:
  • updated mDNS component
  • updated ESP-IDF to v5.3.2 release on commit 083aad9

Version 2024-10-27, reported as 1[4a1b]

Flash this version

• features:
  • add retrieval of credentials from WPS with push button mode (PBC) when device is blank
  • add mDNS device string to the UI
  • add Wi-Fi 6 only protocol selection on C6
• fixes:
  • arbitrary reboots issued by RGB LED driver
  • mDNS service list in case of late station connection
• other:
  • updated ESP-IDF to v5.3.1 release on commit a0f798c

Version 2024-10-08, reported as 1[4a08]

Flash this version

• features:
  • add estimate bus voltage report to enhanced protocol
  • add average of several samples for adc command
• other:
  • updated ESP-IDF to v5.3.1 release on commit 707d097 (including the massively changed USB serial driver)

Version 2024-08-25, reported as 1[4819]

Flash this version

• features:
  • better responsive web UI
  • add mDNS for auto discovery
• fixes:
  • HW ID determination for C6
• other:
  • updated ESP-IDF to commit 0bbd728 (without the massively changed USB serial driver though)

Version 2024-08-09, reported as 1[4809]

Flash this version

• features:
  • first version also released for ESP32-C6 supporting the C6 Edition
• other:
  • updated ESP-IDF to released v5.3 version on commit dc7fb34 (without the massively changed USB serial driver though)

Version 2024-06-15, reported as 1[460f]

Flash this version

• features:
  • add logging of last data exchanged to/from eBUS/host on error log and in verbose mode
• fixes:
  • enable another WiFi optimization setting of ESP-IDF to improve TCP transfer
  • remove one case reported as host protocol error, that is actually in responsibility of ebusd and not the adapter
• other:
  • updated ESP-IDF to current git (release/v5.3 branch) on commit ae87691

Version 2024-05-26, reported as 1[451a]

Flash this version

• features:
  • first version also released for Wemos C3 mini for use on older adapters
  • improved workaround for skipping too lengthy HTTP request headers (for weird cloudflare tunneling)
  • show initial network connection as green fade off
  • smaller web UI improvements
  • use dedicated reset pin for USR-ES1/W5500 Ethernet
• fixes:
  • missed reboot from web UI when skipping startup procedure
• other:
  • updated ESP-IDF to current git (release/v5.3 branch)

Version 2024-05-18, reported as 1[4512]

Flash this version

• features:
  • nicer web UI, better responsive layout for the pins section
  • skip too lengthy HTTP request headers (workaround for weird cloudflare tunneling)
• fixes:
  • correct topic extraction on received MQTT messages

Version 2024-05-05, reported as 1[4505]

Flash this version

• features:
  • improve timers and async handling of timed tasks (MQTT, LEDs)
  • force full Wi-Fi calibration
  • add wifi power+protocol+channel selection
  • more verbose “query” and “ip” command output
  • remove annoying vfs warning
  • add workaround for DNS via DHCP
  • increase tolerated HTTP header length
  • disable queueing TCP out-of-order packets
  • nicer web UI, better responsive layout
• other:
  • updated ESP-IDF to current git (release/v5.3 branch)

Version 2024-04-20, reported as 1[4414]

Flash this version

• features:
  • add ps command
• other:
  • switched ESP-IDF to release/v5.3 branch and updated to latest

Version 2024-04-15, reported as 1[440f]

Flash this version

• features:
  • MQTT support with status info like version, uptime, eBUS signal, temperature, AP RSSI
  • configurable HTTPS certificate
• other:
  • updated ESP-IDF to current git

Version 2024-03-30, reported as 1[431e]

Flash this version

• fixes:
  • avoid unnecessary wait when sending to eBUS after successful arbitration

Version 2024-03-17, reported as 1[4311]

Flash this version

• features:
  • nicer web UI, better responsive layout
  • new improved architecture for eBUS access
  • detect active host on JTAG ebusd connection
  • add last-modified handling to httpd
  • calibrate adc and add isadc command
  • enhanced some commands
• fixes:
  • allow using eth command without args on blank NVS
  • allow 64 chars in WIFI passwords
  • hide credential input fields unless needed (prevents undesired auto fill by some browsers)
  • avoid unnecessary httpd connection close
  • remove useless logging
• other:
  • updated ESP-IDF to current git

Version 2024-01-06, reported as 1[4106]

Flash this version

• features:
  • add station rssi to enhanced info
  • add https option with self-signed certificate
• fixes:
  • slow or missing response to enhanced info when there is no eBUS signal
  • potential fix for JTAG connection (aligned with b8e8042)
• other:
  • updated ESP-IDF to current git

Version 2023-12-23, reported as 1[3c17]

Flash this version

• fixes:
  • fix http server when Ethernet is configured only
• other:
  • updated ESP-IDF to current git

Version 2023-12-17, reported as 1[3c11]

Flash this version

• features:
  • add ping + ip REPL commands
  • improve transfer speed for HTTP requests
  • force full WIFI calibration and disable WIFI power save
  • add OTA with 2 swappable partitions
• fixes:
  • memory leak on REPL help command
• other:
  • updated ESP-IDF to current git

Version 2023-10-15, reported as 1[3a0f]

Flash this version

• features:
  • add full scan of WIFI to find the strongest AP, fade blue LED while doing so during boot
  • add AP ID to scan and query commands
  • add better startup logging
• fixes:
  • fix BTN press to skip normal boot detection while LEDs fade during boot
  • fix reset upon BTN press when normal boot was skipped
  • fix old I2C driver message
• other:
  • updated ESP-IDF to current git

Version 2023-09-17, reported as 1[3911]

Flash this version

• features:
  • add update check to web UI
• fixes:
  • fix optimize handling of host TCP socket
  • fix increase wait time for debouncing BTN press
  • fix increase API request timeouts in web UI
  • fix httpd not started with fix IP and Ethernet only
  • fix too many open sockets in httpd
  • fix potential bytes not sent to host via JTAG serial or UART or to eBUS
• other:
  • updated ESP-IDF to current git

Version 2023-09-03, reported as 1[3903]

Flash this version

• features:
  • add option to adjust the bitrate used for eBUS
  • add measurement of bitrate on eBUS and arbitration delay by master
• fixes:
  • fix credentials not being used for API calls by web UI
  • fix invalid value type for number fields in web UI
  • fix use of settings with an empty string
  • fix using a fixed IP
• other:
  • updated web UI packages

Version 2023-08-15, reported as 1[380f]

Flash this version

• features:
  • turn off station when configuring Ethernet via IMPROV
• fixes:
  • fix for empty user name forcing HTTP authentication
  • fix not executed reboot on button long press
• other:
  • updated ESP-IDF to current git

Version 2023-08-06, reported as 1[3806]

Flash this version

• features:
  • add optional HTTP authentication for sensitive endpoints
  • no longer start AP automatically for 2 minutes (AP mode can still be entered by pressing button during boot)
• fixes:
  • fix potential reboot loop when set to USB
• other:
  • updated ESP-IDF to current git
  • updated web UI packages

Version 2023-06-18, reported as 1[3612]

Flash this version

• features:
  • allow setting enhanced/non-enhanced protocol, LED usage and arbitration delay from web
  • smaller enhancements to web UI, better responsive layout
• other:
  • updated ESP-IDF to current git
  • updated web UI packages

Version 2023-05-01, reported as 1[3501]

Flash this version

• feat: first version with support for:
  • all eBUS host connection types: WIFI, Ethernet, Raspi, and USB
  • enhanced and non-enhanced protocol
  • flashing and basic setup (IMPROV) via web including Ethernet
  • “easi>” config via web and serial REPL
  • reading 1-wire DS18B20
  • reading BMP180, BMP180, BME280 (REPL only)
  • control of LEDs and LED strip (REPL only)
  • optional SSD1306 for status display (REPL only)

Erase tool

This is not a real firmware but just a little helper for erasing the whole NVS storage part, i.e. clear all settings and start from scratch.