Skip to content

About

A Flipper Zero-inspired security tool built with ESP32 and MicroPython

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

Singed Zero

A Flipper Zero-inspired multi-tool for wireless security research, built from scratch with ESP32 and MicroPython.

Status Platform Language

Sobre o Projeto

O Singed Zero é um dispositivo de segurança ofensiva portátil inspirado no Flipper Zero, desenvolvido do zero com hardware acessível e documentado publicamente para fins educacionais.

Hardware

Componente Especificação
Microcontrolador ESP32 WROOM DevKit
Display OLED 0.96" 128x64 (SSD1306 I2C)
Interface 3 botões (cima, baixo, select)

Funcionalidades

  • Menu navegável com state machine
  • Wi-Fi — Scanner
  • Wi-Fi — Beacon Spam (Singed Mode, Hacker Mode, Random Mode)
  • Wi-Fi — Deauth
  • Bluetooth — BLE Scanner
  • Bluetooth — BLE Spam (Apple Continuity Protocol, Google Fast Pair)
  • Sub-GHz — CC1101 (planejado)
  • NFC — (planejado)
  • Infravermelho — (planejado)
  • RFID — (em estudo)

Estrutura do Projeto

singed-zero/

├── SingedZero/

│ ├── firmware/

│ │ ├── main.py # menu, state machine, loop principal

│ │ ├── input.py # botoes com debounce/deteccao de borda

│ │ ├── settings.py # config persistida em config.json

│ │ ├── configs.py # tela de configuracoes

│ │ ├── oled/

│ │ │ └── ui.py # desenho compartilhado (menu, listas, status)

│ │ ├── wifi/

│ │ └── bluetooth/

│ └── pymakr.conf

└── README.md

Progresso

v0.1 — Base do sistema

  • Firmware MicroPython gravado no ESP32
  • Display OLED inicializado via I2C
  • Menu principal navegável com 3 botões
  • State machine implementada para navegação entre submenus

v0.2 — Wi-Fi Scanner

  • Scanner de redes 2.4GHz e 5GHz
  • Listagem com SSID e RSSI ordenados por sinal
  • Tela de detalhes por rede (canal, BSSID, segurança, faixa)
  • Paginação automática na lista de redes
  • Loading animado durante o scan

v0.3 — Beacon Spam

  • Três modos: Singed Mode, Hacker Mode e Random Mode
  • SSIDs temáticos e geração aleatória
  • Loading animado e exibição do SSID atual no OLED
  • Parada e retorno ao menu via botão select

v0.4 — BLE Scanner

  • Scanner de dispositivos BLE próximos
  • Exibe nome, MAC e RSSI de cada dispositivo
  • Paginação automática na lista
  • Tela de detalhes por dispositivo

v0.5 — BLE Spam (Apple e Android)

  • Apple Continuity Protocol spam com múltiplos tipos de popup
  • Google Fast Pair advertisement para Android
  • Contadores de pacotes enviados
  • Parada via botão select

v0.6 — Refatoração e Configurações

  • input.py: botões com debounce por deteção de borda, sem mais time.sleep bloqueante espalhado pelo código
  • oled/ui.py: desenho de menu, listas paginadas, telas de status e loading centralizados (eliminou duplicação entre Wi-Fi e BLE)
  • settings.py + configs.py: tela de Configurações real (contraste do OLED, intervalo do beacon spam, intervalo do BLE spam), persistida em config.json
  • Corrigido intervalo de gap_advertise no BLE Spam (estava abaixo do mínimo permitido pelo BLE — provável causa do spam nunca sair no ar)
  • Item "Sub-GHz" (ainda não implementado) agora mostra "Em breve" em vez de não responder

v0.7 — Ajustes de velocidade e confiabilidade do spam

  • BLE Spam (Apple e Android): endereço BLE trocado para NRPA (aleatório não resolvível) — evita que o telefone trate os anúncios como "já visto"
  • Beacon Spam: authmode configurado uma única vez fora do loop; tela do OLED atualizada a cada 3 trocas de SSID em vez de a cada troca, tirando o I2C do caminho crítico
  • Intervalos padrão mais agressivos (beacon 0.5s → 0.2s, BLE spam 0.3s → 0.1s), ajustáveis em Configs
  • Limite conhecido: a troca de SSID via ap.config() obriga o ESP-IDF a reiniciar o AP internamente — isso é o teto real de velocidade do beacon spam com a API padrão do MicroPython. Multi-SSID simultâneo de verdade exige injeção de frames 802.11 crus (esp_wifi_80211_tx), fora do módulo network padrão

Autor

Pedro Trindade — @PedroSinged
LinkedIn

About

A Flipper Zero-inspired security tool built with ESP32 and MicroPython

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages