How ravensystem/esp-homekit-devices works
HAA is embedded firmware that gives ESP32/ESP8266 devices native Apple HomeKit support and configurable accessory behavior. The user-facing path is device setup and configuration, then HomeKit accessory interaction; separate installer firmware supports device installation and updating. The README also describes broad HomeKit service support and companion-app management. Source excerpts are sparse, so the graph distinguishes documented capabilities from directly evidenced calls and leaves uncertain wiring unconnected.
Main entry points: main/main.c Accessory services · server.c HomeKit server · main/main.c Installer firmware · storage.c Pairing storage
Components 12
HAA Firmware
- Accessory configuration
HAA/HAA_Main/main/main.c - Accessory services
HAA/HAA_Main/main/main.c
HomeKit Runtime
- HomeKit server
libs/homekit-rsf/src/server.c - Pairing storage
libs/homekit-rsf/src/storage.c
Installation
- Installer firmware
HAA/HAA_Installer/main/main.c - Setup mode
HAA/HAA_Installer/main/setup.c - Firmware update
HAA/HAA_Installer/main/ota.c - Migration installer
HAA/HAA_mgos32_Installer/main/main.c
Device I/O
- Light effects
HAA/HAA_Main/main/lightbulb_fx.c - Hardware drivers
libs
Other components
- Device owner
- Apple Home
Connections 11
- Device owner → Installer firmware: starts setup
- Installer firmware → Setup mode: initializes Wi-Fi
HAA/HAA_Installer/main/main.c - Installer firmware → Firmware update: supports updates
- Device owner → Accessory configuration: customizes device
- Accessory configuration → Accessory services: configures services
- Accessory services → HomeKit server: exposes accessory
- HomeKit server → Apple Home: serves HomeKit
- HomeKit server → Pairing storage: uses pairing data
libs/homekit-rsf/src/server.c - Accessory services → Light effects: controls effects
- Accessory services → Hardware drivers: controls hardware
- Device owner → Migration installer: starts migration