Skip to content

Italian

Jump to bottom
IronGiu edited this page Apr 13, 2026 · 12 revisions

MeshStation (Italiano)

Piattaforme Arch Installazione Licenza

Benvenuto

MeshStation è un Analizzatore Meshtastic SDR & Interfaccia Desktop. Ascolta passivamente lo spettro RF, decodifica il traffico Meshtastic direttamente dall’etere (senza bisogno di un nodo Meshtastic) e visualizza la rete mesh in tempo reale.

Consigliato: usa i binari portabili nelle GitHub Releases. Non serve compilare.

Avvio rapido (Portable)

  1. Scarica l’archivio corretto per il tuo OS / CPU
  2. Estrai l’archivio in una cartella (mantieni tutti i file insieme)
  3. Avvia l’eseguibile MeshStation

✅ Completamente portable: nessun installer, nessuna dipendenza di sistema
✅ Nelle release è incluso anche l’engine/runtime SDR (basato su GNU Radio), già ottimizzato

Download ultima release.

Questi link puntano sempre all’ultima release stabile disponibile.

Linux

macOS

Windows

Note d’uso

  • Estrai l’archivio completamente prima di avviare (non avviare dall’archivio compresso).
  • Mantieni l’eseguibile e i file dell’engine/runtime nella stessa struttura di cartelle.
  • Puoi spostare la cartella dove vuoi: continuerà a funzionare (portable).

Requisiti di sistema

Windows

  • Versione minima: Windows 10 versione 1809 (build 17763, ottobre 2018) o successiva
  • È richiesto il runtime Microsoft Edge WebView2 per visualizzare l'interfaccia dell'applicazione. È pre-installato sulla maggior parte dei sistemi Windows 10/11 aggiornati, se mancante, scaricarlo dal sito Microsoft.
  • Nessun altro software necessario.

Linux

  • Qualsiasi distribuzione moderna a 64-bit (x86_64 o ARM64)

  • Nessun requisito specifico di versione, se il sistema è in grado di eseguire un'applicazione Python 3.10+, funzionerà.

  • Le seguenti librerie di sistema sono necessarie. MeshStation le rileva automaticamente se mancanti e propone l'installazione, ma è possibile installarle manualmente in anticipo:

    Debian / Ubuntu / Mint:

    sudo apt-get install libxcb-cursor0 libminizip1

    Fedora / RHEL:

    sudo dnf install xcb-util-cursor minizip

    Arch Linux:

    sudo pacman -S xcb-util-cursor minizip

  • Supporto AppImage (FUSE):

    Poiché la versione Linux è fornita come AppImage, il sistema deve avere FUSE 2 installato per avviarla. Se l'applicazione non parte, installalo con:

    Debian / Ubuntu / Mint:

    sudo apt-get install libfuse2

    Fedora:

    sudo dnf install fuse-libs

    Arch Linux:

    sudo pacman -S fuse2

  • Avvio senza FUSE (Estrazione): Se non puoi o non vuoi installare FUSE sul tuo sistema, puoi comunque eseguire MeshStation estraendo il contenuto dell'AppImage:

    • Apri un terminale nella cartella dell'AppImage.
    • Esegui: ./MeshStation_vX-X-X.AppImage --appimage-extract
    • Entra nella cartella creata: cd squashfs-root
    • Avvia l'app: ./AppRun

  • I driver RTL-SDR potrebbero essere necessari a seconda dell'utilizzo (vedi la sezione dedicata più in basso).

macOS

  • Versione minima: macOS 10.15 Catalina (per x86_64) e macOS 11.0 Big Sur (per ARM64)

  • È richiesto Google Chrome, MeshStation utilizza Chrome come motore di visualizzazione su macOS. Scaricarlo da google.com/chrome se non è già installato.

  • Poiché MeshStation non è firmata con un certificato Apple Developer, macOS Gatekeeper la bloccherà al primo avvio. Per sbloccarla:

    Opzione A - tramite Terminale (consigliata):

    xattr -cr /percorso/di/MeshStation_vX.X.X.app

    Sostituire il percorso e il file con la posizione effettiva dell'app, poi avviarla normalmente.

    Meglio ancora se fatto sull'intera cartella così da non dover permettere decine di file quando si avvia l'engine.

    xattr -cr /path/to/MeshStation_vX.X.X/

    Opzione B - tramite Impostazioni di Sistema:

    • Provare ad aprire l'app, macOS mostrerà un avviso e la bloccherà.
    • Aprire Impostazioni di Sistema → Privacy e Sicurezza.
    • Scorrere fino alla sezione Sicurezza, comparirà un messaggio relativo a MeshStation bloccata.
    • Cliccare su "Apri comunque".
    • Confermare nella finestra di dialogo che appare.

Installazione Driver RTL-SDR Linux

1. Installazione Rapida (Metodo Consigliato)

Nella maggior parte delle distribuzioni Linux (Ubuntu, Debian, Linux Mint, Raspberry Pi OS), apri il terminale ed esegui:

Debian / Ubuntu / Mint:

sudo apt-get install rtl-sdr

Fedora:

sudo dnf install rtl-sdr

Arch Linux:

sudo pacman -S rtl-sdr

Questo comando installa le utility necessarie per utilizzare la chiavetta RTL-SDR.

2. Test del Dispositivo

Collega la chiavetta RTL-SDR (staccala e riattaccala se era già attaccata) e verifica che venga riconosciuta correttamente:

rtl_test

Possibili risultati:

Successo

Found 1 device(s)

Vengono mostrati messaggi con il tuner e il chip rilevati. Il dispositivo è pronto all'uso.

Errore: "Kernel driver is active"
Il sistema ha caricato i driver DVB-T invece di quelli SDR. Procedi con il passo 3.

Errore: "Permission denied"
L'utente non ha i permessi per accedere al dispositivo USB. Procedi con il passo 4.

3. Blacklist dei Driver TV (Se Necessario)

Alcuni sistemi caricano automaticamente i driver per ricevitori DVB-T impedendo l'utilizzo in modalità SDR.

Crea il file:

sudo nano /etc/modprobe.d/blacklist-rtl.conf

Inserisci:

blacklist dvb_usb_rtl28xxu

Salva (Ctrl+O) ed esci (Ctrl+X), quindi riavvia il sistema.

4. Regole Udev (Permessi per Utenti Non Root)

Se ricevi errori di permessi, aggiungi una regola udev per consentire agli utenti normali di accedere al dispositivo:

sudo wget -O /etc/udev/rules.d/20-rtlsdr.rules https://raw.githubusercontent.com/rtlsdrblog/rtl-sdr-blog/master/rtl-sdr.rules
sudo udevadm control --reload-rules && sudo udevadm trigger

Scollega e ricollega la chiavetta oppure riavvia il sistema per applicare le modifiche.

Installazione Driver RTL-SDR Windows

1. Scaricare gli Strumenti Necessari

Scarica l'ultima release RTL-SDR per Windows da:

https://ftp.osmocom.org/binaries/windows/rtl-sdr/rtl-sdr-64bit-20260308.zip

Estrai l'archivio in una cartella, ad esempio:

C:\rtl-sdr

2. Installare il Driver USB (Zadig)

Windows installa automaticamente un driver DVB-T per TV digitale, che non funziona per l'uso SDR.
Devi sostituirlo con il driver WinUSB.

  1. Scarica Zadig: https://zadig.akeo.ie/
  2. Collega la chiavetta RTL-SDR
  3. Avvia zadig.exe come amministratore
  4. Vai su Options → List All Devices
  5. Seleziona il dispositivo RTL-SDR (di solito Bulk-In, Interface 0)
  6. Scegli WinUSB
  7. Clicca Install Driver

Attendi il completamento dell'installazione.

3. Test del Dispositivo

Apri il Prompt dei comandi nella cartella dove hai estratto gli strumenti.

Esempio:

cd C:\rtl-sdr

Esegui il programma di test:

rtl_test.exe

Se tutto funziona correttamente vedrai un output simile a:

Found 1 device(s)

Verranno mostrate anche informazioni sul tuner e sulle frequenze supportate.

4. Risoluzione dei Problemi

Dispositivo non rilevato

  • Verifica che la chiavetta sia collegata
  • Reinstalla il driver usando Zadig
  • Assicurati di selezionare Bulk-In Interface 0

Errori o crash

  • Chiudi eventuali software SDR già aperti
  • Scollega e ricollega la chiavetta

Se rtl_test.exe funziona senza errori, il dispositivo RTL-SDR è pronto per l'uso.

Note per sviluppatori (Sorgente / Ambiente)

Qui viene spiegato come usare MeshStation direttamente dal sorgente (non necessario per l'utente che vuole solo usare l'app, ci sono le release)

Clonare la repository

git clone https://github.com/IronGiu/MeshStation.git
cd MeshStation

Setup del virtual environment Python (obbligatorio)

È richiesto Python 3.10. L'esecuzione da sorgente è supportata solo tramite venv + pip. Non viene fornito supporto (gratuito) per altri metodi (conda, installazioni di sistema, ecc.), vedi la nota sul supporto qui sotto per l'assistenza premium.

Opzione A - venv standard:

python3.10 -m venv venv
source venv/bin/activate        # Linux / macOS
venv\Scripts\activate           # Windows

Opzione B - virtualenv:

pip install virtualenv
virtualenv -p python3.10 venv
source venv/bin/activate        # Linux / macOS
venv\Scripts\activate           # Windows

Installare le dipendenze

pip install -r requirements.txt

Generare il runtime dell'engine (GNU Radio)

Il runtime dell'engine SDR deve essere generato prima del primo avvio. Naviga nella cartella corrispondente al tuo OS e architettura dentro engine/os/ ed esegui lo script di build:

Linux (esempio per x86_64):

bash engine/os/linux_x86_64/auto-engine-builder.sh

Windows:

engine\os\win_x86_64\auto-engine-builder.bat

Lo script genererà e ottimizzerà automaticamente il runtime GNU Radio per il tuo sistema. Va eseguito una sola volta, o di nuovo se cambi OS/ambiente.

Avviare MeshStation

python MeshStation.py

Al primo avvio, eventuali librerie mancanti verranno rilevate e verrà chiesto di installarle.

⚠️ Politica di supporto

Il supporto è disponibile per segnalazioni di bug, problemi e suggerimenti sul codice pubblico tramite GitHub Issues.

Il supporto per compilazione, packaging o pipeline di build personalizzate (per qualsiasi OS) non è fornito (gratis), lo script di build per le release è privato e compilare pacchetti distribuibili è troppo complesso, affamato di tempo e dipendente dal sistema per essere supportato in modo generico. Release pre-compilate per tutte le piattaforme supportate sono disponibili nella pagina Releases.

Per assistenza premium (build personalizzate, compilazione, setup avanzato), disponibile dal tier Platinum in su: ko-fi.com/irongiu/tiers

Clone this wiki locally