Indice TinyGS ARTICOLO 4

Installare TinyGS

Procedura completa per portare la tua stazione dallo zero alla prima ricezione. Sei step, ciascuno con i punti critici evidenziati. Tutto è stato testato di persona.

1. Scaricare il firmware TinyGS

Il firmware ufficiale è su GitHub: github.com/G4lile0/tinyGS. Clona o scarica lo zip: 

git clone https://github.com/G4lile0/tinyGS.git

Serve PlatformIO (estensione di VS Code o tool da riga di comando) per compilare e flashare. Se non l'hai installato, segui la guida su platformio.org/install.

Workaround necessario (giugno 2026): il sorgente upstream richiede RadioLib 7.6.0 esatto, ma il fork in lib_deps ora è alla 7.7.0. Per farlo compilare apri tinyGS/tinyGS.ino alla riga 85 e cambia il check di versione per accettare anche 7.7.0 (allarghi la condizione del #if). È una modifica di 1 carattere.

2. Cablare il modulo LoRa

Per ESP32-DevKitC + Ra-01 usando la preset "433MHz HELTEC WiFi LoRA 32 V2" della Web Panel TinyGS:

Ra-01 ESP32 GPIO Note
VCC3V3⚠️ NON 5V
GNDGNDcomune con eventuale alim. esterna
MISOGPIO 19
MOSIGPIO 27
SCKGPIO 5se questo si stacca, tutto è muto
NSS (CS)GPIO 18
RSTGPIO 14
DIO0GPIO 26IRQ RX-done
DIO1GPIO 35opzionale ma consigliato
ANTantenna 433 MHz⚠️ obbligatoria, mai accendere senza
Regole anti-bruciatura:
  • USB SEMPRE staccato mentre cabli
  • Verifica VCC e GND DUE volte prima di alimentare
  • Antenna SEMPRE collegata prima di alimentare il modulo
  • Condensatore di bypass 100 µF + 100 nF tra VCC e GND del modulo, vicini al modulo (assorbe i picchi)

3. Compilare e flashare

Da terminale, nella cartella del progetto: 

# Cancella tutta la flash (utile se hai config residue da prove precedenti)
pio run -e ESP32 -t erase --upload-port /dev/ttyUSB0

# Compila e flasha
pio run -e ESP32 -t upload --upload-port /dev/ttyUSB0

# Monitora la seriale
pio device monitor -p /dev/ttyUSB0 -b 115200

Su Windows la porta sarà COM3, COM4, ecc. Su Linux/macOS tipicamente /dev/ttyUSB0 (CP2102) o /dev/ttyACM0 (ESP32-C3 con USB nativo).

4. Configurare la WiFi

Al primo avvio dopo un flash con flash cancellata, l'ESP32 crea un access point Wi-Fi chiamato My TinyGS (oppure il nome che hai impostato nelle precedenti config). La password è vuota.

  1. Dal telefono, cerca la rete My TinyGS e collegati
  2. Apri il browser su http://192.168.4.1
  3. Compila i campi:
    • SSID e password della tua rete WiFi di casa
    • Latitudine / Longitudine della tua posizione (servono per il calcolo dei pass satellite)
    • Board type: per Ra-01 cablato come sopra → seleziona 433MHz HELTEC WiFi LoRA 32 V2
    • Password locale del portale: scegli quella che vuoi
  4. Salva → l'ESP32 si riavvia e si collega al tuo WiFi
Se l'AP "My TinyGS" non appare: il firmware originale ha skipApStartup() attivo, che ritarda l'attivazione dell'AP. Soluzioni: aspetta 30-60 secondi dopo il boot, oppure tieni premuto il tasto BOOT per 8 secondi (entra in "rescue mode") oppure usa improv-wifi.com dal browser Chrome/Edge per configurare via USB.

5. Registrare la stazione su tinygs.com

Dopo il riavvio, l'ESP32 si connette al backend TinyGS e ottiene un codice OTP (6 cifre, viene generato a ogni boot finché non è registrato). Lo vedi nel portale locale (l'IP che il router ha assegnato all'ESP32, es. http://192.168.1.40) — è scritto in cima.

  1. Crea account su tinygs.com (gratuito)
  2. Vai a tinygs.com/user/addstation
  3. Inserisci il codice OTP che hai letto dal portale locale
  4. Dai un nome alla stazione (es. IZ5KHP-1)
  5. Salva

A registrazione avvenuta, il backend assegna automaticamente alla tua stazione i pass satellite da ricevere. Quando il primo satellite passa sopra di te, vedrai il pacchetto comparire sulla pagina della tua stazione.

6. Posizionare l'antenna

L'antenna è il punto più importante. Pochi accorgimenti:

  • Più in alto possibile: i satelliti vengono da sopra, qualsiasi cosa sopra l'antenna (tetto, soffitto, alberi) riduce la copertura
  • All'aperto: dentro casa la ricezione cala drasticamente. Un balcone o una finestra aperta è il minimo
  • Verticale: i satelliti TinyGS trasmettono con polarizzazione lineare, quindi un'antenna stilo dritta va benissimo
  • Lontano da metalli grossi: caloriferi, tubature, lamiere riflettono e degradano il segnale
  • Cavo coassiale corto e di qualità: a 433 MHz un RG58 economico perde ~6 dB ogni 20 m. Meglio LMR-400 o equivalenti, o tenere il cavo corto

Nota: ricevere un satellite non è come ricevere la radio FM. Il pass dura ~10 minuti, e per vedere il primo pacchetto possono passare ore. Una volta che vedi il primo, sai che tutto funziona e da lì arriveranno gli altri.

Qualcosa non va?

Se vedi "Radio failed code -2", "MISO/MOSI scambiati?", o l'AP non appare, vai alla pagina Troubleshooting. Ci sono i problemi reali che ho incontrato, con la soluzione.

Home TinyGS