How cfosteriv/promist works
ProMist is an ESP32 retrofit controller with an iPhone app, authenticated BLE, and Matter/Apple Home control, while retaining local panel and RF operation. The main workflow is a user action in the app or Home being delivered over BLE or Matter to firmware’s shared DeviceController, then applied to appliance hardware; firmware state is published back to the control surfaces. The README documents this architecture, and the source index confirms key module references. Several firmware and UI subsystems are represented by their exact enclosing paths because their implementation files were not sampled.
Main entry points: DeviceController.cpp Shared device state · ProMistBLECentral.swift BLE session owner · BleManager.cpp Firmware BLE service · DeviceView.swift SwiftUI controls
Components 23
iPhone app
- SwiftUI controls
ProMist/ProMist/Views/DeviceView.swift - Dashboard and setup
ProMist/ProMist/Views - Known fan state
ProMist/ProMist/Models/KnownFan.swift - Home association
ProMist/ProMist/Services/ProMistHomeManager.swift - Matter commissioning
ProMist/ProMist/Services/ProMistMatterCommissioningCoordinator.swift - App Intents
ProMist/ProMist/Services/ProMistAppIntents.swift
BLE control
- BLE session owner
ProMist/ProMist/Services/ProMistBLECentral.swift - BLE protocol
ProMist/ProMist/Models/ProMistBLEProtocol.swift - Owner authentication
ProMist/ProMist/Services/ProMistBLEAuthenticationEngine.swift - Command transactions
ProMist/ProMist/Services/ProMistBLECommandEngine.swift - Diagnostic retrieval
ProMist/ProMist/Services/ProMistDiagnosticsEngine.swift
Device firmware
- Firmware BLE service
ProMistIDF/main/BleManager.cpp - Shared device state
ProMistIDF/main/DeviceController.cpp - Firmware composition
ProMistIDF/main/main.cpp - Breeze profiles
ProMistIDF/main/BreezeProfiles.cpp - Diagnostic log
ProMistIDF/main/DiagnosticLog.cpp
Appliance hardware
- Panel and RF input
ProMistIDF/main/UserInterface.cpp - Fan and tach
ProMistIDF/main/FanMotor.cpp - Oscillation control
ProMistIDF/main/OscillationController.cpp - Mister pump
ProMistIDF/main/MisterPump.cpp
Matter and Home
- Matter fan endpoint
ProMistIDF/main/EspMatterFanEndpoint.cpp
Other components
- iPhone user
- Apple Home / Siri
Connections 25
- iPhone user → SwiftUI controls: operates
README.md - SwiftUI controls → BLE session owner: issues controls
ProMist/ProMist/Views/DeviceView.swift - SwiftUI controls → Dashboard and setup: opens settings
ProMist/ProMist/Views/DeviceView.swift - BLE session owner → Known fan state: updates records
- BLE session owner → Owner authentication: coordinates auth
ProMist/ProMist/Services/ProMistBLECentral.swift - BLE session owner → Command transactions: coordinates requests
ProMist/ProMist/Services/ProMistBLECentral.swift - BLE session owner → Diagnostic retrieval: coordinates retrieval
ProMist/ProMist/Services/ProMistBLECentral.swift - Command transactions → BLE protocol: builds packets
ProMist/ProMist/Services/ProMistBLECommandEngine.swift - Command transactions → Firmware BLE service: sends commands
README.md - Diagnostic retrieval → Firmware BLE service: requests logs
README.md - Owner authentication → Firmware BLE service: authenticates owner
README.md - Firmware BLE service → Shared device state: applies commands
README.md - Firmware composition → Firmware BLE service: starts service
ProMistIDF/main/main.cpp - Firmware composition → Shared device state: configures controller
ProMistIDF/main/main.cpp - Shared device state → Matter fan endpoint: publishes state
README.md - Apple Home / Siri → Matter fan endpoint: controls fan
README.md - Matter fan endpoint → Shared device state: writes attributes
README.md - Home association → Matter commissioning: coordinates setup
- Shared device state → Panel and RF input: shares state
- Shared device state → Fan and tach: drives fan
- Shared device state → Oscillation control: positions mechanism
- Shared device state → Mister pump: controls pump
- Shared device state → Breeze profiles: uses profiles
- Shared device state → Diagnostic log: records events
- iPhone user → App Intents: invokes shortcuts
README.md