micheleandCursor
6087bb5297
Introduces a new SwiftUI app with HTTP REST device control, mock mode for UI development, BLE-based discovery, and documented architecture aligned with the firmware API. Co-authored-by: Cursor <cursoragent@cursor.com>
1.4 KiB
1.4 KiB
BLE_PROTOCOL — igiRadio
Riepilogo
DigiRadio non espone un protocollo BLE GATT documentato per il controllo radio/audio.
Il BLE dell'ESP32-S3 è usato solo per il provisioning Wi‑Fi (setup iniziale).
BLE Wi‑Fi Provisioning (documentato)
| Parametro | Valore |
|---|---|
| Stack | ESP-IDF wifi_provisioning + scheme_ble |
| Sicurezza | protocomm Security1 |
| Proof of possession | Serial number dispositivo (EUI-48 da EEPROM) |
| Nome advertising | DigiRadio-<suffix> (es. DigiRadio-CC4DB4) |
| Riferimento firmware | components/net/src/BleProvisioning.cpp |
| Riferimento manuale | ch-api.tex §BLE provisioning |
Flusso
- Dispositivo in setup mode (no credenziali Wi‑Fi salvate)
- Advertise BLE con nome = SoftAP SSID
- App iOS invia credenziali Wi‑Fi via protocomm (Security1 + PoP)
- Firmware valida, salva in NVS, reboot in STA
- App passa a controllo via HTTP su LAN
Implementazione igiRadio
- Usare CoreBluetooth solo per questa fase
- Compatibile con app generiche "ESP BLE Provisioning" (stesso protocollo Espressif)
- PoP richiesto dall'utente: serial da etichetta o da schermata setup SoftAP
UNKNOWN
- UUID servizio/caratteristica custom DigiRadio per controllo: non documentati
- Notifiche BLE stato tuner: non documentate
Controllo dispositivo (post-provisioning)
Vedi APP_ARCHITECTURE.md — trasporto HTTP REST porta 80.