Ultimo aggiornamento: 19/05/2026.

Documentazione

Questa è la pagina ufficiale della scheda, sul sito del produttore, con tutti i dettagli tecnici.

@snow ha scritto un’ottima guida per iniziare con questo dispositivo sulla rete nazionale LoRa Italia.

Infine, questa è la pagina ufficiale di Meshtastic che riguarda il flash del firmware sul dispositivo.

Assemblaggio

Prima di tutto, con molta delicatezza, ho assemblato la schedina, l’antenna e la batteria all’interno del contenitore. È molto importante collegare l’antenna prima di connettere la batteria.

Per quanto riguarda i due adesivi termoisolanti, uno l’ho applicato sulla schedina e uno sul retro della batteria. Ho posizionato in modo ottimale il cavetto dell’antenna e i fili della batteria in modo da non ostacolare la chiusura del contenitore.

Per permettere la perfetta chiusura del contenitore ho dovuto collocare esternamente entrambe le rondelle del connettore dell’antenna, ma non so se questa è la procedura corretta. Stringendo il dado del connettore ho evitato di ruotare il cavetto.

Configurazione

Ho utilizzato il mio computer Linux con Ubuntu 25.04, collegando il device con un cavo USB-C dati.

Ho aggiunto il mio utente non root al gruppo dialout:

sudo usermod -aG dialout <NOME-UTENTE>

Per verificare l’appartenenza al gruppo, aprire una nuova sessione di terminale con l’utente specificato sopra e digitare

id

per visualizzare la lista completa dei gruppi di appartenenza.

Quando il dispositivo è collegato via USB, vedo /dev/ttyUSB0 (ad es., ma la numerazione dipende dall’eventuale presenza di dispositivi serali collegati ad altre porte USB).

Installo esptool:

python -m pip install esptool

Il comando

esptool chip-id

fornisce una serie di informazioni utili. In particolare, la riga contenente il messaggio

Stub flasher running.

indica che la scheda è pronta a ricevere il firmware.

È pure possibile attivare una connessione seriale utilizzando screen:

screen /dev/ttyUSB0 115200

Firmware

La pagina per la generazione del firmware precompilato non ha funzionato: ricevo un file zip che contiene una struttura dati vuota. D’altronde, questo non è un problema: è sufficiente scaricare un firmware stable e poi procedere alla prima configurazione del dispositivo.

Ho preferito installare il primo firmware da riga di comando, utilizzando esptool e non attraverso il flasher web di Meshtastic in quanto avrebbe richiesto l’installazione di Chrome (oppure Chromium), cosa che ho assolutamente evitato.

Ho scaricato il firmware da qui: scegliere la versione e navigare sotto heltec-v3. Io ho scaricato il file (firmware-heltec-v3-X.Y.ZZ.nnnnnnn.factory.bin) utilizzando wget da terminale. La versione *.factory.bin è quella da installare per la prima volta oppure quando si vuole resettare completamente la board. Per le installazioni successive si potrà scegliere la versione *.update.bin.

Per la prima installazione del firmware eseguire quanto segue:

esptool.py --chip esp32s3 --port /dev/ttyUSB0 erase_flash
esptool.py --chip esp32s3 --port /dev/ttyUSB0 --baud 921600 write_flash -z 0x0 <FILE-FIRMWARE>

FIXME Aggiungere la documentazione per l’aggiornamento della versione del firmware.

A questo punto si può completare la configurazione del nodo: io ho utilizzato l’app Meshtastic con il dispositivo collegato via bluetooth.