DroneCamera

Eine Android-App zur Anzeige des Live-Videostreams von HASAKEE FPV Drohnen. Entwickelt durch Reverse Engineering des proprietären UDP-Protokolls, das von der WLAN-Kamera der Drohne verwendet wird.

Unterstützte Drohne

• HASAKEE FPV Drohne (WLAN SSID: HASAKEE-WiFi-XXXXX)
• VGA-Kamera, die das 0x6363 UDP-Protokoll verwendet
• Drohnen-IP: 192.168.0.1, Videoport: 40000

Andere HASAKEE/Lewei-basierte Drohnen, die dasselbe Protokoll verwenden, könnten ebenfalls funktionieren.

Funktionen

• Automatische WLAN-Verbindung zum Drohnennetzwerk (API 29+ verwendet WifiNetworkSpecifier, API 26-28 prüft bestehende Verbindung)
• Echtzeit-Decodierung und Anzeige von MJPEG-Videostreams
• Multi-Paket-UDP-Frame-Assemblierung mit korrekter Sequenzierung
• Unterstützung zur Deobfuskation von VGA-Daten (für ältere Kamera-Firmware)
• Heartbeat-Keepalive zur Aufrechterhaltung des Videostreams
• Verbindungsverlusterkennung (3 Sekunden Timeout)

Screenshots

Streaming	WLAN Auto-Verbindung

App-Symbol:

Drohnen-Symbol von Flaticon — kostenlos für private und kommerzielle Nutzung mit Namensnennung.

So funktioniert es

Die App kommuniziert über UDP mit der Drohne:

1. Stellt eine Verbindung zum WLAN-Zugangspunkt der Drohne her (HASAKEE-WiFi-XXXXX)
2. Sendet jede Sekunde ein Heartbeat-Paket (63 63 01 00 00 00 00) an 192.168.0.1:40000
3. Empfängt Multi-Paket-Videoframes mit dem 0x6363-Protokoll
4. Setzt Pakete zu vollständigen JPEG-Frames zusammen und zeigt sie an

Protokolldetails

Die Drohne verwendet ein proprietäres Paketformat, das aus den nativen Bibliotheken der HASAKEE FPV Android-App (liblewei-2.3.so, liblewei63.so) zurückentwickelt wurde:

Offset 0x00-0x01: 0x6363 (magic header)
Offset 0x02:      Command type (0x01=heartbeat, 0x03=video)
Offset 0x03-0x04: Sequence ID
Offset 0x05-0x06: Packet length
Offset 0x07:      Frame type
Offset 0x08-0x0B: Frame ID
Offset 0x36 (54): JPEG data start

Reverse Engineering

Diese App basiert auf Protokollkenntnissen, die durch Reverse Engineering der HASAKEE FPV Android-App (Version 1.0.4) gewonnen wurden, insbesondere ihrer nativen Bibliotheken unter Verwendung von Ghidra und Wireshark-Paketanalyse.

Die gesamte Reverse-Engineering-Arbeit, einschließlich dekompilierter Protokolldokumentation, Python-Proof-of-Concept-Streaming-Code und detaillierten Protokollnotizen, ist verfügbar unter:

DroneReverseEngineer

Erstellung

Voraussetzungen

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

Debug-APK erstellen

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

Die APK befindet sich unter app/build/outputs/apk/debug/app-debug.apk.

Release-APK erstellen

Release-Builds erfordern ein Signing-Keystore:

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

Die signierte APK befindet sich unter app/build/outputs/apk/release/app-release.apk.

Auf Gerät installieren

./gradlew installDebug

Tests ausführen

./gradlew test

Lint ausführen

./gradlew lintDebug

Projektstruktur

app/src/main/java/uk/org/retallack/dronecamera/
├── FrameAssembler.kt       # 0x6363 packet parser, frame assembly, deobfuscation
├── DroneConnection.kt      # UDP heartbeat sender and packet receiver
├── WifiConnector.kt        # Auto-connect to HASAKEE drone WiFi
├── DroneStreamViewModel.kt # State management (IDLE/CONNECTING/STREAMING/ERROR)
└── MainActivity.kt         # SurfaceView video display and UI

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert — siehe LICENSE für Details.

Drohnen-Symbol von Flaticon