DroneCamera

Un'app Android per visualizzare il flusso video live dei droni FPV HASAKEE. Realizzata tramite reverse engineering del protocollo UDP proprietario usato dalla fotocamera WiFi del drone.

Drone Supportato

• HASAKEE FPV Drone (SSID WiFi: HASAKEE-WiFi-XXXXX)
• Fotocamera VGA che utilizza il protocollo UDP 0x6363
• IP del drone: 192.168.0.1, porta video: 40000

Altri droni HASAKEE/Lewei che utilizzano lo stesso protocollo potrebbero funzionare.

Funzionalità

• Connessione WiFi automatica alla rete del drone (API 29+ usa WifiNetworkSpecifier, API 26-28 verifica la connessione esistente)
• Decodifica e visualizzazione in tempo reale del flusso video MJPEG
• Assemblaggio frame UDP multi-pacchetto con sequenziamento corretto
• Supporto deoffuscamento dati VGA (per firmware fotocamera più vecchi)
• Heartbeat keepalive per mantenere il flusso video
• Rilevamento perdita di connessione (timeout di 3 secondi)

Screenshot

Streaming	Connessione WiFi automatica

Icona dell'app:

Icona del drone di Flaticon — gratuita per uso personale e commerciale con attribuzione.

Come Funziona

L'app comunica con il drone tramite UDP:

1. Si connette al punto di accesso WiFi del drone (HASAKEE-WiFi-XXXXX)
2. Invia un pacchetto heartbeat (63 63 01 00 00 00 00) ogni 1 secondo a 192.168.0.1:40000
3. Riceve frame video multi-pacchetto utilizzando il protocollo 0x6363
4. Assembla i pacchetti in frame JPEG completi e li visualizza

Dettagli del Protocollo

Il drone utilizza un formato di pacchetto proprietario ottenuto tramite reverse engineering dalle librerie native dell'app Android HASAKEE FPV (liblewei-2.3.so, liblewei63.so):

Offset 0x00-0x01: 0x6363 (header magico)
Offset 0x02:      Tipo di comando (0x01=heartbeat, 0x03=video)
Offset 0x03-0x04: ID di sequenza
Offset 0x05-0x06: Lunghezza pacchetto
Offset 0x07:      Tipo di frame
Offset 0x08-0x0B: ID frame
Offset 0x36 (54): Inizio dati JPEG

Reverse Engineering

Questa app è stata realizzata partendo dalla conoscenza del protocollo acquisita tramite reverse engineering dell'app Android HASAKEE FPV (versione 1.0.4), in particolare delle sue librerie native utilizzando Ghidra e l'analisi dei pacchetti con Wireshark.

L'intero lavoro di reverse engineering, inclusa la documentazione del protocollo decompilato, il codice Python proof-of-concept per lo streaming e le note dettagliate sul protocollo, è disponibile su:

DroneReverseEngineer

Compilazione

Prerequisiti

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

Compilare APK di Debug

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

L'APK si troverà in app/build/outputs/apk/debug/app-debug.apk.

Compilare APK di Release

Le build di release richiedono un keystore di firma:

export KEYSTORE_PATH=release.keystore
export KEYSTORE_PASSWORD=<your-password>
export KEY_ALIAS=release
export KEY_PASSWORD=<your-password>
./gradlew assembleRelease

L'APK firmato si troverà in app/build/outputs/apk/release/app-release.apk.

Installare sul Dispositivo

./gradlew installDebug

Eseguire i Test

./gradlew test

Eseguire il Lint

./gradlew lintDebug

Struttura del Progetto

app/src/main/java/uk/org/retallack/dronecamera/
├── FrameAssembler.kt       # Parser pacchetti 0x6363, assemblaggio frame, deoffuscamento
├── DroneConnection.kt      # Invio heartbeat UDP e ricezione pacchetti
├── WifiConnector.kt        # Connessione automatica al WiFi del drone HASAKEE
├── DroneStreamViewModel.kt # Gestione stato (IDLE/CONNECTING/STREAMING/ERROR)
└── MainActivity.kt         # Visualizzazione video SurfaceView e UI

Licenza

Questo progetto è concesso in licenza secondo la MIT License — vedi LICENSE per i dettagli.

Icona del drone di Flaticon.