DroneCamera

Um aplicativo Android para visualizar o fluxo de vídeo ao vivo de drones HASAKEE FPV. Construído por engenharia reversa do protocolo UDP proprietário usado pela câmera WiFi do drone.

Drone Suportado

• Drone HASAKEE FPV (SSID WiFi: HASAKEE-WiFi-XXXXX)
• Câmera VGA usando o protocolo UDP 0x6363
• IP do drone: 192.168.0.1, porta de vídeo: 40000

Outros drones HASAKEE/Lewei que usam o mesmo protocolo também podem funcionar.

Recursos

• Conexão WiFi automática à rede do drone (API 29+ usa WifiNetworkSpecifier, API 26-28 verifica a conexão existente)
• Decodificação e exibição de fluxo de vídeo MJPEG em tempo real
• Montagem de quadros UDP de múltiplos pacotes com sequenciamento adequado
• Suporte a desofuscação de dados VGA (para firmware de câmera mais antigo)
• Heartbeat keepalive para manter o fluxo de vídeo
• Detecção de perda de conexão (timeout de 3 segundos)

Capturas de Tela

Streaming	Conexão WiFi Automática

Ícone do aplicativo:

Ícone de drone por Flaticon — gratuito para uso pessoal e comercial com atribuição.

Como Funciona

O aplicativo se comunica com o drone via UDP:

1. Conecta-se ao ponto de acesso WiFi do drone (HASAKEE-WiFi-XXXXX)
2. Envia um pacote de heartbeat (63 63 01 00 00 00 00) a cada 1 segundo para 192.168.0.1:40000
3. Recebe quadros de vídeo de múltiplos pacotes usando o protocolo 0x6363
4. Monta os pacotes em quadros JPEG completos e os exibe

Detalhes do Protocolo

O drone usa um formato de pacote proprietário obtido por engenharia reversa das bibliotecas nativas do aplicativo Android HASAKEE FPV (liblewei-2.3.so, liblewei63.so):

Offset 0x00-0x01: 0x6363 (cabeçalho mágico)
Offset 0x02:      Tipo de comando (0x01=heartbeat, 0x03=video)
Offset 0x03-0x04: ID de sequência
Offset 0x05-0x06: Comprimento do pacote
Offset 0x07:      Tipo de quadro
Offset 0x08-0x0B: ID do quadro
Offset 0x36 (54): Início dos dados JPEG

Engenharia Reversa

Este aplicativo foi construído a partir do conhecimento do protocolo obtido por engenharia reversa do aplicativo Android HASAKEE FPV (versão 1.0.4), especificamente suas bibliotecas nativas usando Ghidra e análise de pacotes com Wireshark.

Todo o trabalho de engenharia reversa, incluindo documentação do protocolo descompilado, código Python de proof-of-concept para streaming e notas detalhadas do protocolo, está disponível em:

DroneReverseEngineer

Compilação

Pré-requisitos

• JDK 17+
• Android SDK (compile SDK 35, min SDK 26)

Compilar APK de Depuração

git clone https://github.com/mretallack/DroneCamera.git
cd DroneCamera
./gradlew assembleDebug

O APK estará em app/build/outputs/apk/debug/app-debug.apk.

Compilar APK de Lançamento

Compilações de lançamento exigem um keystore de assinatura:

export KEYSTORE_PATH=release.keystore
export KEYSTORE_PASSWORD=<sua-senha>
export KEY_ALIAS=release
export KEY_PASSWORD=<sua-senha>
./gradlew assembleRelease

O APK assinado estará em app/build/outputs/apk/release/app-release.apk.

Instalar no Dispositivo

./gradlew installDebug

Executar Testes

./gradlew test

Executar Lint

./gradlew lintDebug

Estrutura do Projeto

app/src/main/java/uk/org/retallack/dronecamera/
├── FrameAssembler.kt       # Analisador de pacotes 0x6363, montagem de quadros, desofuscação
├── DroneConnection.kt      # Envio de heartbeat UDP e receptor de pacotes
├── WifiConnector.kt        # Conexão automática ao WiFi do drone HASAKEE
├── DroneStreamViewModel.kt # Gerenciamento de estado (IDLE/CONNECTING/STREAMING/ERROR)
└── MainActivity.kt         # Exibição de vídeo SurfaceView e interface do usuário

Licença

Este projeto está licenciado sob a Licença MIT — veja LICENSE para detalhes.

Ícone de drone por Flaticon.