How hn/bsh-home-appliances works
This repository combines an ESPHome integration that parses B/S/H/ D-Bus messages into sensor entities with Open-DBus2, an ESP32 D-Bus-2 framework and appliance-diagnostic firmware. The principal firmware workflow starts in main.cpp: it registers protocol nodes with a manager, initializes the UART bus, and processes bus traffic; the Huda node provides a diagnostic CLI for querying and interacting with participants. Other node implementations cover monitoring, LEDs, demos, appliance interfaces, and an optional MQTT gateway. Some node implementations were not excerpted, so their internal links are omitted.
Main entry points: main.cpp Firmware Entry · bshdbus.cpp Frame Parser · DBus2Manager.cpp Bus Manager · FlexConsole.cpp Flex Console
Components 23
ESPHome Integration
- Frame Parser
components/bshdbus/bshdbus.cpp - Binary Sensors
components/bshdbus/binary_sensor/bshdbus_binary_sensor.cpp - Numeric Sensors
components/bshdbus/sensor/bshdbus_sensor.cpp - Text Sensors
components/bshdbus/text_sensor/bshdbus_text_sensor.cpp
D-Bus Runtime
- Firmware Entry
open-dbus2/src/main.cpp - Bus Manager
open-dbus2/src/DBus2Manager.cpp - Node Framework
open-dbus2/include/DBus2Node.h - Subsystem Framework
open-dbus2/include/DBus2Subsystem.h - Frame Format
open-dbus2/include/DBus2Frame.h
Protocol Nodes
- HUDA Diagnostics
open-dbus2/src/nodes/Huda.cpp - Bus Monitor
open-dbus2/src/nodes/Monitor.cpp - LED Status
open-dbus2/src/nodes/LedStatus.cpp - Ping Demo
open-dbus2/src/nodes/PingDemo.cpp - Pong Demo
open-dbus2/src/nodes/PongDemo.cpp - Dishwasher Node
open-dbus2/src/nodes/Dishwasher39C3.cpp - Dishwasher UI
open-dbus2/src/nodes/DishwasherUIPSimple.cpp - Unbalance Demo
open-dbus2/src/nodes/UnbalanceDemo.cpp - MQTT Gateway
open-dbus2/src/nodes/MqttGateway.cpp
Console and Diagnostics
- Flex Console
open-dbus2/src/FlexConsole.cpp - Web Serial Page
open-dbus2/include/FlexConsolePage.h - Logging
open-dbus2/include/DBus2Log.h
Other components
- ESPHome User
- Appliance Bus
Connections 24
- ESPHome User → Frame Parser: configures
- Frame Parser → Binary Sensors: dispatches messages
components/bshdbus/bshdbus.cpp - Frame Parser → Numeric Sensors: dispatches messages
- Frame Parser → Text Sensors: dispatches messages
- Appliance Bus → Frame Parser: supplies frames
- Firmware Entry → Bus Manager: registers nodes
open-dbus2/src/main.cpp - Firmware Entry → HUDA Diagnostics: registers
open-dbus2/src/main.cpp - Firmware Entry → Bus Monitor: registers
open-dbus2/src/main.cpp - Firmware Entry → LED Status: registers
open-dbus2/src/main.cpp - Firmware Entry → Ping Demo: registers
open-dbus2/src/main.cpp - Firmware Entry → Pong Demo: registers
open-dbus2/src/main.cpp - Firmware Entry → Flex Console: starts
open-dbus2/src/main.cpp - Firmware Entry → Dishwasher Node: optional registration
open-dbus2/src/main.cpp - Firmware Entry → Dishwasher UI: optional registration
open-dbus2/src/main.cpp - Firmware Entry → Unbalance Demo: optional registration
open-dbus2/src/main.cpp - Firmware Entry → MQTT Gateway: optional registration
open-dbus2/src/main.cpp - Bus Manager → Node Framework: runs node lifecycle
open-dbus2/src/DBus2Manager.cpp - Node Framework → Subsystem Framework: delegates lifecycle
open-dbus2/include/DBus2Node.h - Subsystem Framework → Frame Format: uses frames
open-dbus2/include/DBus2Subsystem.h - HUDA Diagnostics → Bus Manager: sends commands
open-dbus2/src/nodes/Huda.cpp - Bus Manager → Appliance Bus: reads and writes
- HUDA Diagnostics → Flex Console: reads user input
- Logging → Flex Console: prints logs
open-dbus2/include/DBus2Log.h - Flex Console → Web Serial Page: serves page