VoLoRa

(già LoRa-Codec-2-RTX fino all'11/11/2026: se cerchi il vecchio nome, sei nel posto giusto.)

Messaggi vocali broadcast a turni (stile QSO) tra schede LilyGo a 433 MHz (LoRa32 T3 V1.6.1 e T-Beam V1.2), per radioamatori. La voce è compressa con Codec2 e trasmessa con LoRa, con tre profili da scegliere dal menu della scheda:

Profilo	Radio	Codec2	Uso
Standard (S)	SF7, banda 250 kHz	3200 bps	voce in tempo reale più naturale; è il profilo di base, quello del ripetitore e del nodo Internet
Range (R)	SF8, banda 250 kHz	1200 bps	voce in tempo reale con un po' più di portata (circa 2,5 dB teorici, non misurati)
Messaggio (M)	SF12, banda 125 kHz	1200 bps	lungo raggio: si registra un messaggio (fino a 15 s); chi riceve lo trova in una casella e lo ascolta premendo il PTT, con la percentuale sul display

Perché lo Standard è il 3200 (decisione del 12/11/2026): il guadagno di portata del 1200 (Range) è modesto, circa 2,5 dB teorici e non misurati, mentre la voce a 3200 bit/s suona meglio. Il Range resta nel firmware per i collegamenti in condizioni difficili, quando serve quel poco di portata in più a scapito della qualità vocale (decisione).

Funzionamento in breve:

1. Si preme il PTT: il microfono viene bufferizzato subito.
2. Si trasmette il nominativo, poi la voce Codec2 man mano che si parla.
3. Al rilascio del PTT (massimo 30 s) si invia l'ultimo audio e il segnale di fine turno (OVER).
4. Tutte le stazioni in ascolto sulla frequenza ricevono e riproducono. Dopo 5-10 s di attesa si risponde.

Progetto sperimentale (beta). La voce passa da una scheda all'altra ed è provata sulle schede (T3 e T-Beam, nei tre profili, 10/11/2026: esiti in docs/prove.md). Manca ancora la misura sul campo: distanze lunghe, mezzi in movimento. Possono trasmettere solo radioamatori con il proprio nominativo, sulle frequenze e con le potenze consentite. Il nominativo viaggia in chiaro e i contenuti non sono cifrati.

Nuovo? Parti dalla guida rapida. Indice della documentazione: docs/README.md.

Per provare il firmware

Occorrente per ogni stazione:

• scheda LILYGO LoRa32 T3 V1.6.1 oppure T-Beam V1.2 (AXP2101), a 433 MHz, con antenna a 433 MHz (SMA);
• un pulsante PTT esterno tra GPIO0 e massa;
• per la voce: microfono INMP441, amplificatore MAX98357A e altoparlante 8 Ω 3 W (per il solo test radio senza audio non servono);
• schema dei collegamenti in docs/pinout.md (con le immagini dei collegamenti di T3 e T-Beam) e docs/audio.md.

Regole di sicurezza: antenna collegata prima del cavo USB, mai alimentare la scheda senza antenna o carico fittizio; microSD tolta durante il caricamento.

Passi:

1. Dal browser (il modo più semplice, anche senza Linux). Apri la pagina di installazione con Chrome, Edge od Opera, collega la scheda con il cavo USB, scegli la versione dal menu a tendina (quella proposta va bene per chi non sa quale scegliere: stabile, o beta finché non ce n'è una) e premi "Installa il firmware". Poi, nel passo 2 della stessa pagina, imposta nominativo, frequenza, potenza e volume: restano salvati nella scheda. Il firmware pubblico ha N0CALL e non trasmette (riceve soltanto) finché non imposti il tuo nominativo. La configurazione si può fare anche senza cavo e senza PC: dal menu della scheda (volume lungo, voce "Wi-Fi") la scheda crea una rete con la sua pagina su 192.168.4.1 (docs/firmware.md).
2. In alternativa. Scarica i binari dall'esecuzione di GitHub Actions (artefatto firmware-t3-v161 o firmware-tbeam-v12, serve essere loggati; contengono web_factory.bin e ota_update.bin) e caricali con web_factory.bin all'indirizzo 0x0 (docs/firmware.md, anche per Windows), oppure compila in locale con PlatformIO. Il nominativo non richiede di ricompilare: si imposta dalla pagina o con CFG SET CALLSIGN e resta salvato. Se preferisci un firmware con il tuo nominativo già dentro: fai un fork, cambia LCR_CALLSIGN in src/user_config.h dal sito GitHub e lascia compilare Actions (non usare binari di altri che ne contengono uno diverso). Dalla seriale si cambia tutto con i comandi CFG (docs/firmware.md).
3. Frequenza. Il valore predefinito è un segnaposto: scegli il canale con il band plan IARU R1 / ARI. Le stazioni che si ascoltano devono avere gli stessi parametri LoRa e la stessa frequenza.
4. Prova di collegamento (senza microfono né altoparlante). Su due schede attiva la prova (tre pressioni veloci del PTT, il pulsante nella pagina o CFG TEST ON) e premi il PTT: la scheda ricevente confronta una sequenza nota bit per bit, mostra l'esito sul display e risponde. Dettagli in docs/prova-collegamento.md.

Per chi collabora

• main è il punto comune di partenza: è sempre compilabile (GitHub Actions deve essere verde) e ha come nominativo N0CALL, quindi non trasmette finché non imposti il tuo.
• Come contribuire: fai un fork, lavora su un ramo tuo e proponi le modifiche con una pull request. Prima di proporle esegui make test.
• Prove: annota ogni prova in docs/prove.md con il modello indicato. Per un problema da risolvere apri una segnalazione (Issues).
• Decisioni e ordine dei lavori: docs/roadmap.md. Prossimi passi: misure sul campo (RSSI, SNR, perdite, anche in movimento), intestazione del messaggio, memorie con profilo e frequenze per canale, locatore Maidenhead e ora dal GPS; il ripetitore: prova a banco (docs/banco-ripetitore.md).

This is the beginning of the README. Read the rest at the original. Read the full README ↗