🏴‍☠️ PIrateRF - Plataforma de Transmisión Radioeléctrica Definida por Software

PIrateRF transforma tu Raspberry Pi Zero W en un generador de señales RF portátil que crea su propio punto de acceso WiFi. Controla desde emisiones FM hasta modos digitales a través de tu navegador: ¡hackea las ondas desde cualquier lugar! 📡⚡

🎬 Haz clic aquí para ver el video promocional de PIrateRF

📺 Haz clic aquí para ver el video demostrativo de PIrateRF

---

⚠️ AVISO LEGAL

PIrateRF está diseñado para experimentación amateur y educación radioeléctrica, incluyendo pruebas seguras en interiores sin antenas externas. Construido para ingenieros que entienden que las buenas prácticas de RF importan más que los límites administrativos arbitrarios. Los usuarios son responsables de cumplir con todas las regulaciones locales de RF y requisitos de licencia. ¡No soy responsable de ninguna de tus estúpidas decisiones!

Todas las imágenes de demostración y pruebas en esta documentación se realizaron en interiores sin antena, con un alcance máximo de aproximadamente 5 metros.

---

📋 Tabla de Contenidos

• 🎯 12 Modos de Transmisión Diferentes
• 🚀 Guía de Configuración Rápida
  • Requisitos Previos
  • Opción 1: Imagen Preconstruida (Recomendada)
  • Opción 2: Configuración Manual
    • 🚨 IMPORTANTE: ¡Configura Pi Zero Primero!
    • 1. Configuración Inicial
    • 2. Configuración Completa de Pi
    • 3. Conectar y Usar
• 🎉 Modo Tripulación Pirata
• 🔌 Configuración de Antena
• 📡 Modos de Transmisión Explicados
  • 🎵 Estación FM
  • 🎙️ Transmisión en Vivo con Micrófono
  • 📟 FT8
  • 📠 RTTY
  • 📊 FSK
  • 📱 POCSAG
  • 📻 Código Morse
  • 🎛️ Onda Portadora
  • 🌊 Barrido de Frecuencia
  • 📺 SSTV
  • 🎨 Pintura Espectral
  • 📡 IQ
• 💾 Sistema de Presets
• 🛠️ Comandos de Desarrollo
  • Desarrollo Local
  • Gestión de Pi
• 📁 Estructura del Proyecto
• 🏴‍☠️ Aviso Legal y de Seguridad
  • Licencia de Radioaficionado Requerida
  • Regulaciones de Frecuencia
  • Requisitos de Hardware (para uso adecuado)
  • Restricciones Geográficas
  • 🏠 Pruebas y Experimentación en Interiores
• 📡 Frecuencias Operativas Estándar
  • Bandas de Aficionados HF (3-30 MHz)
  • Bandas de Aficionados VHF/UHF
  • Frecuencias Estándar FT8 (modo USB)
  • Frecuencias Estándar RTTY (modo USB)
  • Frecuencias Estándar SSTV
  • Separaciones Estándar de Repetidores FM
• 🔗 Dependencias Principales
• 📝 Licencia
• 📋 Registro de Cambios
• TODO

🎯 12 Diferentes Modos de Transmisión

• 🎵 Estación FM - Transmisión FM completa con metadatos RDS, listas de reproducción y procesamiento de audio
• 🎙️ Transmisión en Vivo con Micrófono - Transmisión en tiempo real desde el micrófono con modulación configurable (AM/DSB/USB/LSB/FM/RAW)
• 📟 FT8 - Modo digital de largo alcance para comunicación con señal débil en bandas HF
• 📠 RTTY - Radioteletipo usando código Baudot y modulación FSK
• 📊 FSK - Modulación por desplazamiento de frecuencia para transmisión de datos digitales
• 📱 POCSAG - Sistema de mensajería para buscas digitales
• 📻 Código Morse - Transmisión CW con WPM configurable
• 🎛️ Onda Portadora - Generación de portadora simple para pruebas
• 🌊 Barrido de Frecuencia - Barridos RF para pruebas y análisis de antenas
• 📺 SSTV - Transmisión de imágenes de televisión de barrido lento
• 🎨 Pintura Espectral - Convertir imágenes en arte espectral RF
• 📡 IQ - Reproducción de muestras IQ sin procesar para reproducción y prueba de señales

Todo controlado a través de un punto de acceso WiFi independiente: conecta cualquier dispositivo y comienza a transmitir como el rebelde RF que estabas destinado a ser. ¡Perfecto para operaciones en aguas internacionales y regiones con políticas de espectro más... flexibles!

🚀 Guía de Configuración Rápida

Requisitos Previos

• Raspberry Pi Zero 1 W (modelo original, recomendado) con tarjeta SD de 4GB+
  • Otros modelos de Pi: rpitx funciona en Pi 1, 2, 3, 3B+, Zero, Zero W y Pi 4 — pero los scripts de despliegue de PIrateRF, la configuración del AP WiFi, la compilación cruzada y la imagen preconstruida están diseñados específicamente para la Pi Zero 1 W. Otras placas pueden funcionar con configuración manual, pero no han sido probadas.

Opción 1: Imagen Preconstruida (Recomendada)

Sáltate todo el rollo de compilación y ve directo al caos RF:

1. Descarga la imagen preconstruida: Imagen PIrateRF v2025-11-23
2. Graba en la tarjeta SD usando:
   • Raspberry Pi Imager (recomendado): Selecciona "Usar imagen personalizada" y elige el archivo .img descargado
   • Línea de comandos: sudo dd if=piraterf_2025-11-23_22-18-49.img of=/dev/sdX bs=4M status=progress (reemplaza /dev/sdX con tu tarjeta SD)
3. Arranca la Pi Zero W y conéctate al WiFi: "🏴‍☠️📡" (contraseña: "FUCKER!!!")
4. Abre el navegador: https://piraterf.local ¡y empieza a transmitir inmediatamente!

Configuración por Defecto:

• Punto de Acceso WiFi: SSID "🏴‍☠️📡", Contraseña "FUCKER!!!"
• Acceso SSH: Usuario fucker, Contraseña FUCKER, Nombre de Host piraterf.local
• Interfaz Web: https://piraterf.local

Opción 2: Configuración Manual

🚨 IMPORTANTE: ¡Configura Pi Zero Primero!

Antes de hacer CUALQUIER otra cosa, consigue que tu maldita Pi Zero W esté conectada y accesible por SSH. Sigue este tutorial que realmente funciona:

👉 Tutorial de Conexión USB para Pi Zero W

Esto conectará tu Pi Zero vía USB con acceso SSH para que puedas desplegar PIrateRF en el pequeño cabrón.

🌐 COMPARTIR INTERNET REQUERIDO: Después de que la conexión USB funcione, DEBES compartir internet desde tu computadora a la Pi Zero. Los scripts de configuración necesitan descargar paquetes y dependencias: sin internet, no hay caos RF.

Configurar el uso compartido de Internet en Ubuntu/Linux:

1. Configurar conexión como compartida: En la Configuración de Red de Ubuntu, encuentra la conexión USB (generalmente usb0), haz clic en ella, ve a la configuración de IPv4, y cambia el método de "Solo enlace local" a "Compartida con otros ordenadores"