DroneCamera

تطبيق أندرويد لعرض البث المباشر للفيديو من طائرات HASAKEE FPV بدون طيار. تم بناؤه عن طريق الهندسة العكسية للبروتوكول UDP الخاص الذي تستخدمه كاميرا WiFi للطائرة.

الطائرات المدعومة

• طائرة HASAKEE FPV بدون طيار (اسم شبكة WiFi: HASAKEE-WiFi-XXXXX)
• كاميرا VGA تستخدم بروتوكول UDP 0x6363
• عنوان IP الطائرة: 192.168.0.1، منفذ الفيديو: 40000

قد تعمل أيضًا طائرات أخرى من HASAKEE/Lewei تستخدم نفس البروتوكول.

الميزات

• اتصال تلقائي بشبكة WiFi للطائرة (API 29+ يستخدم WifiNetworkSpecifier، API 26-28 يتحقق من الاتصال الحالي)
• فك تشفير وعرض بث فيديو MJPEG في الوقت الحقيقي
• تجميع إطارات UDP متعددة الحزم مع الترتيب الصحيح
• دعم إزالة تشويش بيانات VGA (لبرامج الكاميرا الثابتة القديمة)
• حزمة نبضات للحفاظ على استمرار بث الفيديو
• كشف فقدان الاتصال (مهلة 3 ثوانٍ)

لقطات الشاشة

البث المباشر	الاتصال التلقائي بالـ WiFi

أيقونة التطبيق:

أيقونة الدرون بواسطة Flaticon — مجانية للاستخدام الشخصي والتجاري مع الإسناد.

كيف يعمل

يتواصل التطبيق مع الطائرة عبر UDP:

1. يتصل بنقطة الوصول WiFi للطائرة (HASAKEE-WiFi-XXXXX)
2. يرسل حزمة نبضات (63 63 01 00 00 00 00) كل ثانية واحدة إلى 192.168.0.1:40000
3. يستقبل إطارات فيديو متعددة الحزم باستخدام بروتوكول 0x6363
4. يجمع الحزم في إطارات JPEG كاملة ويعرضها

تفاصيل البروتوكول

تستخدم الطائرة تنسيق حزمة خاص تمت هندسته عكسيًا من المكتبات الأصلية لتطبيق HASAKEE FPV Android (liblewei-2.3.so، liblewei63.so):

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

الهندسة العكسية

تم بناء هذا التطبيق بناءً على المعرفة بالبروتوكول المكتسبة من الهندسة العكسية لتطبيق Android HASAKEE FPV (الإصدار 1.0.4)، وبالتحديد مكتباته الأصلية باستخدام Ghidra وتحليل حزم Wireshark.

العمل الكامل للهندسة العكسية، بما في ذلك توثيق البروتوكول المفكك، وكود بث Python للإثبات، وملاحظات البروتوكول التفصيلية، متاح على:

DroneReverseEngineer

البناء

المتطلبات الأساسية

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

بناء APK التصحيح

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

سيكون ملف APK في app/build/outputs/apk/debug/app-debug.apk.

بناء APK الإصدار

تتطلب إصدارات الإصدار مخزن مفاتيح توقيع:

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

سيكون ملف APK الموقع في app/build/outputs/apk/release/app-release.apk.

التثبيت على الجهاز

./gradlew installDebug

تشغيل الاختبارات

./gradlew test

تشغيل فحص Lint

./gradlew lintDebug

هيكل المشروع

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

الترخيص

هذا المشروع مرخص بموجب ترخيص MIT — راجع LICENSE للتفاصيل.

أيقونة الدرون بواسطة Flaticon.