Files

T

Clément SAILLANT 7da6ea37e7 feat: Enhance BluetoothManager with audio bridge and auto-reconnect features

- Added AudioEngine integration to BluetoothManager for audio handling.
- Implemented auto-reconnect functionality with enabling/disabling options.
- Introduced methods for managing audio state and HFP events.
- Updated BluetoothManager's internal state management for better audio handling.

refactor: Update A252ConfigStore to improve pin validation logic

- Renamed critical_pins to required_pins for clarity.
- Added optional legacy line-enable pin validation.
- Improved error handling for pin conflicts and invalid ranges.

fix: Adjust default volume and slic_line configuration in A252ConfigStore

- Set default slic_line to -1 to indicate retirement.
- Increased default audio volume from 80 to 90.

feat: Implement audio amplifier control in main application

- Added commands to enable/disable audio amplifier via GPIO.
- Integrated audio amplifier control into the setup process.

fix: Improve ESP-NOW and WiFi coexistence policies

- Enforced modem sleep for better coexistence between WiFi and Bluetooth.
- Added checks to ensure proper WiFi mode before enforcing coexistence.

feat: Enhance TelephonyService with DTMF and pulse dialing support

- Added DTMF capture and processing capabilities.
- Implemented rotary pulse dialing logic with state management.
- Introduced callbacks for dialing and answering actions.

feat: Add real-time event publishing to WebServerManager

- Enabled real-time status updates via SSE.
- Improved status caching and thread safety with critical sections.

fix: General code cleanup and optimizations across modules

- Refactored various methods for better readability and maintainability.
- Improved error handling and logging for better debugging.

2026-02-23 11:54:09 +01:00

2.2 KiB

Raw Permalink Blame History

ESP-NOW API v1 (enveloppe `msg_id/seq/type/payload/ack`)

Date: 2026-02-21
Scope: contrat d'échange entre RTC_BL_PHONE (A252) et la seconde carte.

1. Objectif

Normaliser les trames ESP-NOW pour:

corréler requête/réponse,
conserver compatibilité legacy,
simplifier l'intégration du second repo.

2. Requête v1 (nouveau format recommandé)

{
  "proto": "rtcbl/1",
  "msg_id": "req-001",
  "seq": 1,
  "type": "command",
  "ack": true,
  "payload": {
    "cmd": "STATUS",
    "args": {}
  }
}

Règles:

proto=rtcbl/1 recommandé (toléré absent pour compat).
msg_id sert à corréler la réponse.
seq est un compteur local de trame (recommandé monotone par source).
type=command|request|cmd déclenche l'exécution côté firmware.
ack=true demande une réponse corrélée.
payload.cmd obligatoire pour une commande dispatcher.
payload.args optionnel; sérialisé puis passé au dispatcher.

3. Réponse v1 (ack corrélée)

{
  "proto": "rtcbl/1",
  "msg_id": "req-001",
  "seq": 1,
  "type": "ack",
  "ack": true,
  "payload": {
    "ok": true,
    "code": "STATUS",
    "data": {},
    "error": ""
  }
}

Règles:

msg_id et seq reprennent la requête.
payload.ok=false => payload.error non vide.
payload.data contient le JSON de la commande si disponible.
fallback possible payload.data_raw si la réponse n'est pas JSON.

4. Compatibilité legacy

Le firmware continue d'accepter les formats existants:

{"cmd":"..."}
{"raw":"..."}
{"command":"..."}
{"action":"..."}
variantes imbriquées via event, message, payload
format historique rtcbl/1:
- {"proto":"rtcbl/1","id":"...","cmd":"...","args":{}}

5. Commandes recommandées v1

STATUS
RING
CALL
HOOK
LIST_FILES
PLAY_FILE
WIFI_STATUS
MQTT_STATUS
ESPNOW_STATUS
BT_STATUS

6. Intégration second repo

Checklist minimum côté seconde carte:

Émettre msg_id unique + seq monotone.
Positionner type=command et ack=true pour obtenir une réponse.
Implémenter timeout de réponse (2-5s) et corréler sur msg_id.
Prévoir fallback legacy (rtcbl/1 + formats cmd/raw/command/action) pour compat.

2.2 KiB Raw Permalink Blame History

ESP-NOW API v1 (enveloppe msg_id/seq/type/payload/ack)