# Backpack Emulator — bench Tier 3 per 02_telemetry_bridge

ESP32-S3 che spedisce via **ESP-NOW** pacchetti sintetici identici (per
formato) a quelli del TX Backpack ELRS reale, verso l'UID del ricevitore
sotto test. Permette di validare `02_telemetry_bridge` (o `01_telemetry_reader`)
**senza aereo, GPS o radio ELRS**: bastano le due board collegate via USB sullo
stesso banco.

## Perché esiste

I Tier 0–2 della suite di test (`pio check`, unit test nativi su `lib/Ltm`,
unit test on-device su `lib/EspNowCrsf` e sul path di decodifica CRSF)
verificano la logica in isolamento. Il Tier 3 chiude il cerchio: due board
reali, ESP-NOW vero, stesso firmware di produzione sul ricevitore.

## Formato del pacchetto

Identico a quello del backpack reale (vedi `lib/EspNowCrsf/EspNowCrsf.cpp` sul
ricevitore):

```
[0..7]   header 8 byte (contenuto ignorato dal parser del ricevitore)
[8..]    frame CRSF grezzo: sync(0xC8) len type payload... crc
```

Il CRC è calcolato con lo stesso CRC8 (poly `0xD5`) usato da terseCRSF, quindi
i frame sono validi byte-per-byte, non solo "abbastanza buoni da passare il
parser".

## Cosa manda

Cicla ogni 250 ms tra 5 frame CRSF, con payload **identici** ai vettori già
verificati in `02_telemetry_bridge/test/test_embedded_crsf_decode/test_decode.cpp`:

| Tipo       | ID     | Valori attesi sul ricevitore (modo HUMAN) |
|------------|--------|--------------------------------------------|
| GPS        | 0x02   | lat 45.46421, lon 9.19, alt 152 m, sat 11   |
| BATTERY    | 0x08   | 16.4 V, 1.2 A, 78%                          |
| ATTITUDE   | 0x1E   | pitch 9.998°, roll -5.002°, yaw 330°        |
| LINK       | 0x14   | RSSI -52dBm ant1, LQ 100%, SNR -9dB         |
| FLIGHTMODE | 0x21   | "ACRO"                                      |

Ogni 8 invii (~2s) manda anche un **keep-alive** (header + 2 byte a zero), per
esercitare il filtro anti-keep-alive su hardware reale e non solo nel test
unitario (regressione del bug off-by-one corretto in `EspNowCrsf.cpp`).

Confrontando i valori stampati dal ricevitore con la tabella sopra si valida
in un colpo il path completo: ESP-NOW → ring buffer → filtro keep-alive →
decode CRSF → dashboard.

## Setup

1. `src/my_config.h` → `TARGET_UID` deve essere **lo stesso UID** configurato
   in `02_telemetry_bridge/src/my_config.h` (o `01_telemetry_reader`) sulla
   board ricevitrice sotto test. Non serve la bind phrase reale: è solo
   l'indirizzo a cui spedire.
2. Collega l'ESP32-S3 (qui: COM7) e l'ESP32 ricevitore (qui: COM4) allo stesso
   PC, due porte separate.
3. Flasha il ricevitore in modo **HUMAN** (così vedi i valori decodificati)
   o **CRSF_DUMP** (per vedere i frame grezzi).
4. Build → Upload → Monitor su questa cartella (115200).
5. Confronta l'output del ricevitore con la tabella sopra.

## Struttura del codice

```
platformio.ini
src/
  main.cpp      # init ESP-NOW + invio ciclico GPS/BATTERY/ATTITUDE/LINK/FLIGHTMODE + keep-alive
  my_config.h   # TARGET_UID -- DA COMPILARE (stesso UID del ricevitore)
```

## Limiti

Emula solo il **formato del pacchetto**, non l'intero stack ELRS (niente link
budget, niente vera bind phrase, niente canale/RF reale oltre a ESP-NOW su
canale 1). Per la validazione con catena RF completa serve comunque la radio
ELRS configurata con `Telemetry = ESPNOW` e l'UID reale dalla bind phrase.