🏴‍☠️ PIrateRF - Plataforma de Transmissão de Rádio Definida por Software

PIrateRF transforma o seu Raspberry Pi Zero W num gerador de sinais RF portátil que cria o seu próprio hotspot WiFi. Controle tudo, desde transmissões FM até modos digitais através do seu navegador - hackeie as ondas de rádio de qualquer lugar! 📡⚡

🎬 Clique aqui para o Vídeo Promocional do PIrateRF

📺 Clique aqui para o Vídeo de Demonstração do PIrateRF

---

⚠️ AVISO LEGAL

O PIrateRF foi projetado para experimentação e educação em rádio amador - incluindo testes internos seguros sem antenas externas. Construído para engenheiros que entendem que boas práticas de RF importam mais que fronteiras administrativas arbitrárias. Os usuários são responsáveis pelo cumprimento de todas as regulamentações locais de RF e requisitos de licenciamento. Não sou responsável por nenhuma de suas decisões estúpidas!

Todas as imagens de demonstração e testes nesta documentação foram realizados em ambientes internos sem antena, com alcance máximo de aproximadamente 5 metros.

---

📋 Índice

• 🎯 12 Modos de Transmissão Diferentes
• 🚀 Guia de Configuração Rápida
  • Pré-requisitos
  • Opção 1: Imagem Pré-Construída (Recomendada)
  • Opção 2: Configuração de Compilação Manual
    • 🚨 IMPORTANTE: Configure o Pi Zero Primeiro!
    • 1. Configuração Inicial
    • 2. Configuração Completa do Pi
    • 3. Conecte e Use
• 🎉 Modo Tripulação Pirata
• 🔌 Configuração da Antena
• 📡 Modos de Transmissão Explicados
  • 🎵 Estação FM
  • 🎙️ Transmissão ao Vivo com Microfone
  • 📟 FT8
  • 📠 RTTY
  • 📊 FSK
  • 📱 POCSAG
  • 📻 Código Morse
  • 🎛️ Onda Portadora
  • 🌊 Varredura de Frequência
  • 📺 SSTV
  • 🎨 Spectrum Paint
  • 📡 IQ
• 💾 Sistema de Presets
• 🛠️ Comandos de Desenvolvimento
  • Desenvolvimento Local
  • Gerenciamento do Pi
• 📁 Estrutura do Projeto
• 🏴‍☠️ Aviso Legal e de Segurança
  • Licença de Rádio Amador Necessária
  • Regulamentações de Frequência
  • Requisitos de Hardware (para uso adequado)
  • Restrições Geográficas
  • 🏠 Testes e Experimentação em Ambientes Internos
• 📡 Frequências Operacionais Padrão
  • Faixas de HF para Amadores (3-30 MHz)
  • Faixas de VHF/UHF para Amadores
  • Frequências Padrão FT8 (modo USB)
  • Frequências Padrão RTTY (modo USB)
  • Frequências Padrão SSTV
  • Divisões Padrão de Repetidores FM
• 🔗 Dependências Principais
• 📝 Licença
• 📋 Changelog
• TODO

🎯 12 Modos de Transmissão Diferentes

• 🎵 Estação FM - Transmissão FM completa com metadados RDS, listas de reprodução e processamento de áudio
• 🎙️ Transmissão ao Vivo com Microfone - Streaming em tempo real do microfone com modulação configurável (AM/DSB/USB/LSB/FM/RAW)
• 📟 FT8 - Modo digital de longo alcance para comunicação em sinais fracos nas bandas de HF
• 📠 RTTY - Radioteletipo usando código Baudot e modulação FSK
• 📊 FSK - Chaveamento por deslocamento de frequência para transmissão de dados digitais
• 📱 POCSAG - Sistema de envio de mensagens para pagers digitais
• 📻 Código Morse - Transmissão CW com WPM configurável
• 🎛️ Onda Portadora - Geração simples de portadora para testes
• 🌊 Varredura de Frequência - Varreduras de RF para teste e análise de antenas
• 📺 SSTV - Transmissão de imagens em Slow Scan Television
• 🎨 Spectrum Paint - Converter imagens em arte de espectro RF
• 📡 IQ - Reprodução de amostras IQ brutas para reprodução e teste de sinais

Todos controlados através de um ponto de acesso WiFi independente - conecte qualquer dispositivo e comece a transmitir como o rebelde RF que você nasceu para ser! Perfeito para operações em águas internacionais e regiões com políticas de espectro mais... flexíveis.

🚀 Guia de Configuração Rápida

Pré-requisitos

• Raspberry Pi Zero 1 W (modelo original, recomendado) com cartão SD de 4 GB ou mais
  • Outros modelos de Pi: o rpitx funciona nos Pi 1, 2, 3, 3B+, Zero, Zero W e Pi 4 — mas os scripts de implantação do PIrateRF, configuração do AP WiFi, compilação cruzada e imagem pré-construída são feitos especificamente para o Pi Zero 1 W. Outras placas podem funcionar com configuração manual, mas não foram testadas.

Opção 1: Imagem Pré-Construída (Recomendada)

Pule toda a porcaria de compilação e vá direto ao caos RF:

1. Baixe a imagem pré-construída: Imagem PIrateRF v2025-11-23
2. Grave no cartão SD usando:
   • Raspberry Pi Imager (recomendado): Selecione "Usar imagem personalizada" e escolha o arquivo .img baixado
   • Linha de comando: sudo dd if=piraterf_2025-11-23_22-18-49.img of=/dev/sdX bs=4M status=progress (substitua /dev/sdX pelo seu cartão SD)
3. Inicialize o Pi Zero W e conecte-se ao WiFi: "🏴‍☠️📡" (senha: "FUCKER!!!")
4. Abra o navegador: https://piraterf.local e comece a transmitir imediatamente!

Configurações Padrão:

• AP WiFi: SSID "🏴‍☠️📡", Senha "FUCKER!!!"
• Acesso SSH: Usuário fucker, Senha FUCKER, Hostname piraterf.local
• Interface Web: https://piraterf.local

Opção 2: Configuração de Compilação Manual

🚨 IMPORTANTE: Configure o Pi Zero Primeiro!

Antes de fazer QUALQUER OUTRA COISA, conecte e acesse seu maldito Pi Zero W via SSH. Siga este tutorial que realmente funciona:

👉 Tutorial de Conexão USB para Pi Zero W

Isso conectará seu Pi Zero via USB com acesso SSH para que você possa realmente implantar o PIrateRF no pequeno desgraçado.

🌐 COMPARTILHAMENTO DE INTERNET OBRIGATÓRIO: Após a conexão USB funcionar, você DEVE compartilhar a internet do seu computador com o Pi Zero. Os scripts de configuração precisam baixar pacotes e dependências – sem internet, sem caos RF.

Configure o compartilhamento de internet no Ubuntu/Linux:

1. Defina a conexão como compartilhada: Nas Configurações de Rede do Ubuntu, encontre a conexão USB (geralmente usb0), clique nela, vá para as configurações de IPv4 e altere o método de "Apenas Link-Local" para "Compartilhado com outros computadores"