How espressifapp/espblufiforandroid works
EspBlufiForAndroid is an Android demo for provisioning and inspecting ESP devices that run BluFi, alongside a reusable BluFi client library. The main workflow is to find a BLE device, open its control screen, establish a GATT connection, then issue security, configuration, status, version, Wi-Fi-scan, or custom-data operations and display callback results. Configuration forms and settings are additional app capabilities. The library implements the protocol over BLE, with parameter/response models and security helpers. Relationships for unsampled screens and protocol internals are included only where the README or source index supports them.
Main entry points: BlufiClientImpl.java BLE protocol engine · BlufiActivity.java Device controls · SettingsActivity.java App settings · MainActivity.java Device discovery
Components 21
Android demo app
- Device discovery
app/src/main/java/com/espressif/espblufi/ui/MainActivity.java - Device controls
app/src/main/java/com/espressif/espblufi/ui/BlufiActivity.java - Configuration forms
app/src/main/java/com/espressif/espblufi/ui/ConfigureOptionsActivity.java - App settings
app/src/main/java/com/espressif/espblufi/ui/SettingsActivity.java - App preferences
app/src/main/java/com/espressif/espblufi/app/BlufiApp.java - Activity base
app/src/main/java/com/espressif/espblufi/app/BaseActivity.java - App constants
app/src/main/java/com/espressif/espblufi/constants/BlufiConstants.java - Release lookup
app/src/main/java/com/espressif/espblufi/task/BlufiAppReleaseTask.java
BluFi client API
- Client facade
lib-blufi/src/main/java/blufi/espressif/BlufiClient.java - Callback contract
lib-blufi/src/main/java/blufi/espressif/BlufiCallback.java
Protocol implementation
- BLE protocol engine
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - Configuration parameters
lib-blufi/src/main/java/blufi/espressif/params/BlufiConfigureParams.java - Protocol definitions
lib-blufi/src/main/java/blufi/espressif/params/BlufiParameter.java - Status and scan models
lib-blufi/src/main/java/blufi/espressif/response/BlufiStatusResponse.java - Scan result model
lib-blufi/src/main/java/blufi/espressif/response/BlufiScanResult.java - Version model
lib-blufi/src/main/java/blufi/espressif/response/BlufiVersionResponse.java - Notification assembly
lib-blufi/src/main/java/blufi/espressif/BlufiNotifyData.java - Frame control
lib-blufi/src/main/java/blufi/espressif/FrameCtrlData.java - Security primitives
lib-blufi/src/main/java/blufi/espressif/security
Other components
- User
- ESP BluFi device
Connections 23
- User → Device discovery: selects device
- Device discovery → Device controls: opens controls
app/src/main/java/com/espressif/espblufi/ui/MainActivity.java - User → App settings: changes settings
- App settings → App preferences: reads preferences
app/src/main/java/com/espressif/espblufi/ui/SettingsActivity.java - App settings → Release lookup: checks release
app/src/main/java/com/espressif/espblufi/ui/SettingsActivity.java - Device controls → Configuration forms: opens forms
app/src/main/java/com/espressif/espblufi/ui/BlufiActivity.java - Device controls → Client facade: issues commands
app/src/main/java/com/espressif/espblufi/ui/BlufiActivity.java - Configuration forms → Configuration parameters: builds settings
app/src/main/java/com/espressif/espblufi/ui/ConfigureOptionsActivity.java - Client facade → BLE protocol engine: delegates calls
lib-blufi/src/main/java/blufi/espressif/BlufiClient.java - BLE protocol engine → ESP BluFi device: exchanges BLE data
- BLE protocol engine → Callback contract: dispatches events
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - Device controls → Callback contract: handles events
app/src/main/java/com/espressif/espblufi/ui/BlufiActivity.java - BLE protocol engine → Configuration parameters: encodes configuration
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Protocol definitions: uses protocol values
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Status and scan models: builds status
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Scan result model: builds scan results
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Version model: builds version
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Security primitives: uses cryptography
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Notification assembly: assembles notifications
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - BLE protocol engine → Frame control: reads frame flags
lib-blufi/src/main/java/blufi/espressif/BlufiClientImpl.java - App settings → Activity base: inherits navigation
app/src/main/java/com/espressif/espblufi/ui/SettingsActivity.java - Device controls → Activity base: inherits navigation
app/src/main/java/com/espressif/espblufi/ui/BlufiActivity.java - Device controls → App constants: uses app settings
app/src/main/java/com/espressif/espblufi/ui/BlufiActivity.java