🏴‍☠️ PIrateRF - Piattaforma di Trasmissione Radio a Definizione Software

PIrateRF trasforma il tuo Raspberry Pi Zero W in un generatore di segnali RF portatile che crea il proprio hotspot WiFi. Controlla tutto, dalle trasmissioni FM ai modi digitali, attraverso il tuo browser - hackerai le onde radio da qualsiasi luogo! 📡⚡

🎬 Clicca qui per il video promozionale di PIrateRF

📺 Clicca qui per il video di presentazione di PIrateRF

---

⚠️ AVVISO LEGALE

PIrateRF è progettato per la sperimentazione e l'educazione radioamatoriale - incluso test interni sicuri senza antenne esterne. Creato per ingegneri che sanno che le buone pratiche RF contano più dei confini amministrativi arbitrari. Gli utenti sono responsabili del rispetto di tutte le normative RF locali e dei requisiti di licenza. Non sono responsabile per le tue stupide fottute decisioni!

Tutte le immagini dimostrative e i test in questa documentazione sono stati eseguiti al chiuso senza antenna, con una portata massima di circa 5 metri.

---

📋 Indice

• 🎯 12 Diverse Modalità di Trasmissione
• 🚀 Guida Rapida all'Installazione
  • Prerequisiti
  • Opzione 1: Immagine Precompilata (Consigliata)
  • Opzione 2: Configurazione di Build Manuale
    • 🚨 IMPORTANTE: Configurare prima il Pi Zero!
    • 1. Configurazione Iniziale
    • 2. Configurazione Completa del Pi
    • 3. Connetti e Usa
• 🎉 Modalità Equipaggio Pirata
• 🔌 Configurazione dell'Antenna
• 📡 Spiegazione delle Modalità di Trasmissione
  • 🎵 Stazione FM
  • 🎙️ Trasmissione Microfono in Diretta
  • 📟 FT8
  • 📠 RTTY
  • 📊 FSK
  • 📱 POCSAG
  • 📻 Codice Morse
  • 🎛️ Onda Portante
  • 🌊 Spazzata di Frequenza
  • 📺 SSTV
  • 🎨 Spectrum Paint
  • 📡 IQ
• 💾 Sistema di Preset
• 🛠️ Comandi di Sviluppo
  • Sviluppo Locale
  • Gestione del Pi
• 📁 Struttura del Progetto
• 🏴‍☠️ Avviso Legale e di Sicurezza
  • Licenza di Radioamatore Richiesta
  • Regolamentazioni sulle Frequenze
  • Requisiti Hardware (per un uso corretto)
  • Restrizioni Geografiche
  • 🏠 Test & Sperimentazione al Chiuso
• 📡 Frequenze Operative Standard
  • Bande Radioamatoriali HF (3-30 MHz)
  • Bande Radioamatoriali VHF/UHF
  • Frequenze Standard FT8 (modalità USB)
  • Frequenze Standard RTTY (modalità USB)
  • Frequenze Standard SSTV
  • Split Standard dei Ripetitori FM
• 🔗 Dipendenze Fondamentali
• 📝 Licenza
• 📋 Changelog
• TODO

🎯 12 Diverse Modalità di Trasmissione

• 🎵 Stazione FM - Trasmissione FM completa con metadati RDS, playlist ed elaborazione audio
• 🎙️ Trasmissione Microfono in Diretta - Streaming del microfono in tempo reale con modulazione configurabile (AM/DSB/USB/LSB/FM/RAW)
• 📟 FT8 - Modo digitale a lunga distanza per comunicazioni a segnale debole sulle bande HF
• 📠 RTTY - Radio telescrivente utilizzando il codice Baudot e modulazione FSK
• 📊 FSK - Frequency Shift Keying per trasmissione dati digitali
• 📱 POCSAG - Sistema di messaggistica per cercapersone digitale
• 📻 Codice Morse - Trasmissione CW con WPM configurabile
• 🎛️ Onda Portante - Generazione semplice di portante per test
• 🌊 Spazzata di Frequenza - Spazzate RF per test e analisi di antenne
• 📺 SSTV - Trasmissione di immagini Slow Scan Television
• 🎨 Spectrum Paint - Converti immagini in arte dello spettro RF
• 📡 IQ - Riproduzione di campioni IQ grezzi per riproduzione e test di segnali

Tutto controllato tramite un punto di accesso WiFi autonomo - connetti qualsiasi dispositivo e inizia a trasmettere come il ribelle RF che sei destinato ad essere! Perfetto per operazioni in acque internazionali e regioni con politiche dello spettro più... flessibili.

🚀 Guida Rapida all'Installazione

Prerequisiti

• Raspberry Pi Zero 1 W (modello originale, consigliato) con scheda SD da 4GB+
  • Altri modelli Pi: rpitx funziona su Pi 1, 2, 3, 3B+, Zero, Zero W e Pi 4 — ma gli script di deployment di PIrateRF, la configurazione AP WiFi, la cross-compilazione e l'immagine precompilata sono tutti realizzati specificamente per Pi Zero 1 W. Altre schede potrebbero funzionare con configurazione manuale ma non sono testate.

Opzione 1: Immagine Precompilata (Consigliata)

Salta tutte le stronzate di build e vai direttamente al caos RF:

1. Scarica l'immagine precompilata: PIrateRF Image v2025-11-23
2. Masterizza sulla scheda SD usando:
   • Raspberry Pi Imager (consigliato): Seleziona "Usa immagine personalizzata" e scegli il file .img scaricato
   • Riga di comando: sudo dd if=piraterf_2025-11-23_22-18-49.img of=/dev/sdX bs=4M status=progress (sostituisci /dev/sdX con la tua scheda SD)
3. Avvia il Pi Zero W e connettiti al WiFi: "🏴‍☠️📡" (password: "FUCKER!!!")
4. Apri il browser: https://piraterf.local e inizia immediatamente a trasmettere!

Impostazioni Predefinite:

• AP WiFi: SSID "🏴‍☠️📡", Password "FUCKER!!!"
• Accesso SSH: Utente fucker, Password FUCKER, Hostname piraterf.local
• Interfaccia Web: https://piraterf.local

Opzione 2: Configurazione di Build Manuale

🚨 IMPORTANTE: Configurare prima il Pi Zero!

Prima di fare QUALSIASI altra cosa, connetti il tuo fottuto Pi Zero W e rendilo accessibile tramite SSH. Segui questo tutorial che funziona davvero:

👉 Tutorial di Connessione USB Pi Zero W

Questo ti permetterà di connettere il tuo Pi Zero tramite USB con accesso SSH in modo da poter effettivamente distribuire PIrateRF su quel piccolo bastardo.

🌐 CONDIVISIONE INTERNET RICHIESTA: Dopo che la connessione USB funziona, DEVI condividere Internet dal tuo computer al Pi Zero. Gli script di configurazione devono scaricare pacchetti e dipendenze - niente Internet, niente caos RF.

Configurare la condivisione Internet su Ubuntu/Linux:

1. Imposta la connessione come condivisa: In Impostazioni di Rete di Ubuntu, trova la connessione USB (di solito usb0), cliccaci sopra, vai alle impostazioni IPv4, e cambia il metodo da "Solo collegamento locale" a "Condiviso con altri computer"