v0.1.0-beta.2

LoRa-Codec-2-RTX v0.1.0-beta.2: tre profili, menu a bordo, configurazione dal Wi-Fi

Messaggistica vocale tra radioamatori su LoRa a 433 MHz con Codec2, su schede LILYGO. Rispetto alla prima beta la scheda ha tre profili da scegliere dal menu, la posizione e la distanza della stazione ricevuta, il GPS (T-Beam) e la configurazione dal Wi-Fi della scheda, senza cavo. È una beta: funziona ed è provata sulle schede, ma manca ancora la misura sul campo.

Pagina di installazione e configurazione dal browser (Chrome, Edge od Opera): https://iu5hju.github.io/VoLoRa/

ATTENZIONE: aggiornare tutte le schede

Questa versione cambia i pacchetti (percentuale del messaggio, posizione, nuovo modo a 3200). Le schede con la beta.1 non capiscono i pacchetti nuovi: aggiorna tutte le schede alla stessa versione (CFG VERSION mostra fw= e proto=2). Le schede con profili o frequenze diversi non si sentono.

Novità

• Tre profili, da scegliere dal menu (volume premuto a lungo, PTT per scorrere, volume breve per confermare; la scheda si riavvia):
  • Standard: voce in tempo reale, Codec2 1200, SF8 e banda 250 kHz.
  • Messaggio: lungo raggio, SF12 e banda 125 kHz. Si registra fino a 30 s, si trasmette dopo il rilascio e chi riceve lo riproduce a ricezione conclusa, con la percentuale sul display e il suono "MSG" in Morse all'arrivo.
  • Qualità: Codec2 3200, SF7 e banda 250 kHz. Voce in tempo reale più naturale, con meno portata. All'ascolto suona meglio del 1200.
• Display: una lettera grande in alto a destra dice il profilo in uso: S Standard, M Messaggio, Q Qualità.
• Configurazione dal Wi-Fi della scheda (voce "Wi-Fi" del menu): la scheda si riavvia in un modo dedicato, crea la rete LoRaCodec2-XXXX con una password casuale, generata la prima volta e poi sempre la stessa, scritta in carattere grande sul display, e serve la pagina di configurazione su http://192.168.4.1. In questo modo non trasmette né riceve. Si esce dal pulsante della pagina, con la pressione lunga del volume o dopo 5 minuti senza client collegati.
• Volume: passi da 1 a 10, con il 5 a 0 dB (il vecchio massimo) e i passi 6-10 con guadagno fino a +15 dB, pensati per l'uso all'aperto. I volumi già salvati si convertono da soli.
• Posizione (spenta di default): nominativo, QTH fisso o GPS nel pacchetto di avvio e distanza in km dalla stazione ricevuta sul display. GPS sulla T-Beam (spento di default: consuma batteria).
• Una frequenza per ogni profilo (FREQ, FREQMSG, FREQQUAL): possono essere uguali, non c'è nessun obbligo di usarne di diverse.
• Pagina web: campi per profilo, frequenze, posizione fissa e GPS; il messaggio di stato resta sempre in vista e la pagina non scorre più da sola.
• Strumenti per il PC: ricevitore SDR in tempo reale (ricevitore-live.sh), decodifica dei pacchetti catturati e confronto dei codec (confronta-codec.sh).

Cosa è stato provato (10/11/2026)

T3 V1.6.1 e T-Beam V1.2 con lo stesso firmware (CFG VERSION): lettera del profilo sul display, menu e configurazione dal Wi-Fi, e trasmissione tra le due schede in Standard, in Qualità e in Messaggio. Esiti in docs/prove.md. In precedenza (9-10/11/2026): percentuale e "MSG" in Morse, posizione e distanza, GPS con fix a 4 satelliti, ricezione e ascolto in tempo reale con un SDR in Standard, in Messaggio e in Qualità (quest'ultimo il 10/11/2026, dopo la correzione del ricevitore).

Cosa NON è ancora stato provato

• Distanze lunghe e mezzi in movimento: manca la misura sul campo (RSSI, SNR, perdite).
• Ripetizione dei messaggi: non esiste ancora.
• Un messaggio di 30 s in Messaggio dura circa 4,5 minuti in aria: è il tetto, non il caso tipico.

Da sapere

• Il firmware parte con il nominativo N0CALL: riceve ma non trasmette. Imposta il tuo nominativo dalla pagina web o dalla pagina interna della scheda.
• Collega l'antenna a 433 MHz prima di alimentare la scheda o di trasmettere. Trasmetti solo con il tuo nominativo, sulle frequenze e con le potenze consentite. Il nominativo e la posizione (se la attivi) viaggiano in chiaro: i contenuti non sono cifrati.
• Frequenza predefinita 433,900 MHz per tutti i profili: è un segnaposto, scegli il canale con il piano di banda.
• Turno massimo 30 secondi. Protocollo versione 2.
• Le impostazioni salvate restano dopo l'aggiornamento; le frequenze dei profili nuovi partono uguali a quella già salvata.

Come installarla

Dalla pagina (consigliato): apri la pagina del progetto, scegli la scheda e la versione dal menu a tendina e premi "Installa il firmware".

Esattamente questa beta, da riga di comando: scarica da questa pagina il file web_factory.bin della tua scheda e scrivilo con:

esptool.py --chip esp32 write_flash 0x0 firmware-t3-v161-web_factory.bin

(firmware-tbeam-v12-web_factory.bin per la T-Beam). web_factory.bin è l'immagine completa (bootloader, partizioni e firmware); ota_update.bin contiene solo l'applicazione. Le somme di controllo SHA-256 sono in SHA256SUMS.

Segnalazioni, prove sul campo e difetti: https://github.com/IU5HJU/VoLoRa/issues · Documentazione: docs/ (guida rapida, protocollo, SDR, versioni).

v0.1.0-beta.1

LoRa-Codec-2-RTX v0.1.0-beta.1 — prima beta

Messaggistica vocale a turni tra radioamatori su LoRa a 433 MHz, con voce Codec2 a 1200 bit/s, su schede LILYGO. Questa è la prima versione in cui la voce passa davvero da una scheda all'altra e si sente bene. È una beta: funziona, ma è ancora in prova sul campo.

Pagina di installazione e configurazione dal browser (Chrome, Edge od Opera): https://iu5hju.github.io/LoRa-Codec-2-RTX/

Schede supportate

Scheda	File
LILYGO LoRa32 T3 V1.6.1	firmware-t3-v161-web_factory.bin
LILYGO T-Beam V1.2 (AXP2101)	firmware-tbeam-v12-web_factory.bin

Audio: microfono INMP441, amplificatore MAX98357A, altoparlante 8 ohm (schemi di collegamento in docs/pinout.md).

Cosa è stato provato (08/11/2026)

• Voce a turni tra due LoRa32 T3: la voce si sente bene in ricezione, con il suono caratteristico del Codec2 a 1200 bit/s.
• Prova di collegamento tra schede: 300 frame confrontati bit per bit, 0 persi, risposta automatica del ricevitore.
• Ricezione con SDR (NESDR, GNU Radio): pacchetti, prova di collegamento e voce decodificati sul PC, a circa 1 m.
• T-Beam V1.2: avvio anche a batteria, AXP2101, radio, tasto IO38 come PTT, trasmissione e ricezione.
• Pagina web: installazione, nominativo, frequenza, potenza, volume e misura del fondo del microfono, verificata con test automatici.

Cosa NON è ancora stato provato

• Audio sulla T-Beam (microfono, amplificatore, altoparlante).
• Distanze lunghe e mezzi in movimento (Doppler, fading, ombre da ostacoli): non c'è ancora una misura sul campo.
• Display esterno sulla T-Beam (ricerca dell'indirizzo 0x3C/0x3D, controller SSD1306).
• Con molti pacchetti persi la voce ha dei buchi (ogni pacchetto sono 480 ms; la parità XOR ne ricostruisce uno ogni quattro).

Da sapere

• Il firmware parte con il nominativo N0CALL: riceve ma non trasmette. Imposta il tuo nominativo dalla pagina ("Salva e riavvia") prima di trasmettere.
• Collega l'antenna a 433 MHz prima di alimentare la scheda o di trasmettere.
• Trasmetti solo con il tuo nominativo, sulle frequenze e con le potenze consentite. Il nominativo viaggia in chiaro e i contenuti non sono cifrati.
• Frequenza predefinita 433,900 MHz (modificabile). Radio: SF8, banda 250 kHz, coding rate 4/5, sync word 0x4C.
• Ogni turno dura al massimo 30 secondi. In ricezione la voce parte circa 1 secondo dopo l'inizio.
• Protocollo: versione 2. Due schede devono avere lo stesso protocollo, non per forza lo stesso firmware.
• Le impostazioni salvate nella scheda restano dopo un aggiornamento.

Funzioni

• PTT: premi e parla. Una pressione breve (meno di 0,3 s) è un clic e non trasmette.
• Prova di collegamento: tre clic veloci sul PTT attivano o disattivano la prova (12 secondi di frame noti, esito sul display, risposta automatica dell'altra scheda).
• Display OLED (se presente): stato, nominativo, RSSI e SNR, batteria.
• Comandi da seriale (115200): CFG GET, CFG SET ..., CFG VERSION, CFG TEST ON/OFF, CFG TEST AUDIO (toni con e senza radio), CFG TEST CODEC (prova locale del Codec2), CFG REC ON/OFF (registra e poi trasmetti, per diagnosi).

Come installarla

Dalla pagina (consigliato): apri la pagina del progetto, scegli la scheda e premi "Installa il firmware". La pagina installa l'ultima versione pubblicata, che dopo questa beta può essere una versione di sviluppo più recente: la pagina scrive sotto il menu quale versione stai per installare.

Esattamente questa beta: scarica il file web_factory.bin della tua scheda da questa pagina e scrivilo con:

esptool.py --chip esp32 write_flash 0x0 firmware-t3-v161-web_factory.bin

web_factory.bin è l'immagine completa (bootloader, partizioni e firmware); ota_update.bin contiene solo l'applicazione, per chi aggiorna con strumenti propri. Le somme di controllo SHA-256 sono in SHA256SUMS.

Cosa ha richiesto più tempo

Per molti giorni la voce arrivava intera ma suonava come crepitii che seguivano la voce. La causa non era la radio né il Codec2: il codice che spegne l'amplificatore dopo 400 ms di silenzio lo spegneva dopo ogni frame per un confronto di orari senza segno. Corretto e coperto da un test. Il racconto della diagnosi è in docs/prove.md.

Segnalazioni

Prove sul campo, schede diverse, difetti: https://github.com/IU5HJU/LoRa-Codec-2-RTX/issues

Documentazione: docs/ (guida rapida, protocollo, pinout, SDR, versioni).