How mr-addict/homekit-devices works
This repository combines HomeSpan ESP32 devices, two Go-based HomeKit services, and a browser-based BLE provisioning tool. The main user workflow is to select a HomeSpan device, connect over BLE, authenticate with its OTA password, then send Wi-Fi credentials and confirm completion. The graph also preserves the documented fan, lamp, Wake-on-LAN, and temperature capabilities. Go and firmware internals are represented from the tree and README; their detailed call relationships were not sampled, so those links are omitted.
Main entry points: controller.ts Provision controller · ble-session.ts BLE session · homekit-wol/main.go Go WOL service · homekit-temperature/main.go Temperature service
Components 24
BLE provisioning
- Provisioning page
src/web/ble-provision/src/app.ts - Provision controller
src/web/ble-provision/src/workflows/controller.ts - Provision UI
src/web/ble-provision/src/ui/view.ts - Phase rules
src/web/ble-provision/src/workflows/flow.ts - BLE session
src/web/ble-provision/src/services/ble-session.ts - Frame encoding
src/web/ble-provision/src/protocol/frames.ts - Status parsing
src/web/ble-provision/src/protocol/status.ts - Frame exchange
src/web/ble-provision/src/services/send-frame.ts - Wi-Fi credential read
src/web/ble-provision/src/services/credentials.ts - Saved OTA password
src/web/ble-provision/src/services/ota-storage.ts
HomeSpan firmware
- HomeSpan BLE device
src/homespan/common/ble_provision.h - Fan accessory
src/homespan/fan/fan.h - Lamp accessory
src/homespan/lamp/lamp.h - Firmware Wake-on-LAN
src/homespan/wol/wol.h
Go Wake-on-LAN
- Go WOL service
src/go/cmd/homekit-wol/main.go - WOL accessories
src/go/internal/wol/accessories.go - WOL switch
src/go/internal/wol/switch.go - Magic packet sender
src/go/internal/wol/sender.go
Go temperature
- Temperature service
src/go/cmd/homekit-temperature/main.go - Temperature accessory
src/go/internal/temperature/accessory.go - Temperature sensor
src/go/internal/temperature/sensor.go
Go HomeKit base
- HomeKit server
src/go/internal/hapserver/server.go - Server configuration
src/go/internal/hapserver/config.go
Other components
- Device user
Connections 16
- Device user → Provisioning page: uses
README.md - Provisioning page → Provision controller: starts
src/web/ble-provision/src/app.ts - Provision controller → Provision UI: binds and renders
src/web/ble-provision/src/workflows/controller.ts - Provision UI → Phase rules: uses phase rules
src/web/ble-provision/src/ui/view.ts - Provision controller → BLE session: controls connection
src/web/ble-provision/src/workflows/controller.ts - Provision controller → Frame encoding: creates frames
src/web/ble-provision/src/workflows/controller.ts - Provision controller → Saved OTA password: loads and saves
src/web/ble-provision/src/workflows/controller.ts - BLE session → Frame exchange: sends frames
src/web/ble-provision/src/services/ble-session.ts - BLE session → Status parsing: parses device status
src/web/ble-provision/src/services/ble-session.ts - BLE session → Wi-Fi credential read: reads Wi-Fi data
src/web/ble-provision/src/services/ble-session.ts - Frame exchange → Status parsing: parses replies
src/web/ble-provision/src/services/send-frame.ts - BLE session → HomeSpan BLE device: communicates over BLE
src/web/ble-provision/src/services/ble-session.ts - Go WOL service → WOL accessories: provides service
README.md - Temperature service → Temperature accessory: provides service
README.md - Go WOL service → HomeKit server: uses shared HomeKit base
README.md - Temperature service → HomeKit server: uses shared HomeKit base
README.md