البدء السريع / GROUND AGENT

يُصمَّم #bezpiLOTa Ground Agent بوصفه مكوّنًا ميدانيًا مجاورًا ضمن الملف ground-station: يستقبل WFB-ng ويوفر Wi‑Fi AP ومشاركة USB ويدعم كشك HDMI ويعرض الحالة على OLED بأزرار مادية.

مخطط له

Ground Agent ليس منتجًا من KairOS؛ ويتطلب بروتوكول التفاعل المشترك والملف الأرضي بناءً مستقلًا واختبارًا للمنظومة.

مستودع KairOS ↗

WFB-NGاستقبال لاسلكي

4مسارات العملاء

OLEDواجهة مادية اختيارية

GROUNDالملف

في هذه الصفحة +

ما هو GROUND AGENT

جسر بين الوصلة اللاسلكية وأجهزة المشغّل

على الجانب الجوي، يرمّز Drone Agent الفيديو ويرسل التدفق لاسلكيًا. يعمل Ground Agent مع محول Wi‑Fi متوافق في وضع المراقبة، ويستقبل حزم WFB-ng ويعيد بناء التدفق باستخدام FEC وينشره على الشبكة المحلية. يتصل الحاسوب المحمول أو الهاتف بنقطة الاتصال أو مشاركة الاتصال ويفتح Mission Control.

لا يتطلب الملف الأرضي وحدة تحكم بالطيران. يستخدم الاكتشاف التلقائي وجود محول الاستقبال وغياب FC ووجود OLED والأزرار دلائل على الدور. يُحفظ التجاوز الصريح في /etc/kairos/config.yaml.

الأجهزة المطلوبة

الحد الأدنى لمنصة الاختبار والمجموعة الميدانية المستقلة

السيناريو	المكونات
الحد الأدنى للمنصة	Raspberry Pi 4B بذاكرة 2 GB فأكثر؛ ومحول USB RTL8812EU؛ وهوائيان SMA بتردد 5.8 GHz؛ وكابل بيانات USB-C؛ وطاقة خارجية مستقرة
مجموعة ميدانية مستقلة	مجموعة المنصة + شاشة OLED I²C SSD1306 مقاس 1.3 بوصة؛ وأربعة أزرار؛ وشاشة HDMI؛ وذراع ألعاب USB
الجانب الجوي	حاسوب SBC لـDrone Agent؛ ومحول إرسال WFB-ng؛ وكاميرا؛ وقناة ومفتاح متطابقان؛ ووصلة FC عند الحاجة إلى القياس عن بُعد أو التحكم

التثبيت

من نظام تشغيل جديد إلى ملف ground-station

اكتب صورة نظام التشغيل

Pi 4B: Raspberry Pi OS Lite Bookworm 64 بت. Radxa: صورة Debian/Ubuntu من المصنّع.

الإقلاع وSSH

وصّل الشبكة واعثر على اسم المضيف/IP وادخل عبر SSH.

وصّل جهاز الراديو

وصّل RTL8812EU مع الهوائيات قبل تحويل الواجهة إلى وضع المراقبة.

تحقق من USB

يجب أن يعرض lsusb جهاز Realtek، ومعرّفه المعتاد 0bda:8812.

شغّل أمر التثبيت المولّد

تختار Flash Tool الوكيل Ground Agent واللوحة، ثم تولّد أمر KairOS الحالي.

أكد الدور

تحقق من الملف ground-station ومن تفعيل خدمات الاستقبال ونقطة الاتصال ومشاركة الاتصال.

bashتسجيل الدخول المستهدف وفحص المحول

ssh pi@kairos-ground.local
# или
ssh pi@192.168.1.XX

lsusb | grep -i realtek

واجهة KairOS المستهدفة: لا يصبح الأمر قابلًا للتنفيذ إلا بعد إصدار المكوّن المعني.

bashتحقق من الوكيل والخدمات

kairos status

واجهة KairOS المستهدفة: لا يصبح الأمر قابلًا للتنفيذ إلا بعد إصدار المكوّن المعني.

حالة المشروع المتوقعة

الخدمات والعناوين التي ينبغي أن تعرضها الحالة

العنصر	القيمة الحرفية المستهدفة في KairOS
الملف	ground-station
الخدمات	kairos-supervisor, kairos-api, kairos-health, kairos-wfb-rx, kairos-hostapd
نقطة الاتصال	SSID KAIROS-GS-abc123
قناة WFB	161 / 5805 MHz في المثال
عنوان نقطة الاتصال	10.0.0.1

وصّل أجهزتك

أربع طرق لفتح Mission Control

01الخيار الميداني الافتراضي

حاسوب محمول عبر Wi‑Fi

اتصل بـSSID KAIROS-GS-abc123 وافتح http://10.0.0.1:4000.

02سلكي

حاسوب محمول عبر USB

مشاركة CDC-NCM، افتح http://192.168.7.1:4000؛ مع دعم أصلي في macOS Sonoma+ وWindows 11 وLinux.

03دون حاسوب محمول

كشك HDMI

كشك Chromium على الشاشة المتصلة؛ وتبقى ذراع ألعاب USB لدى Ground Agent.

04محمول

هاتف أو جهاز لوحي

متصفح عبر Wi‑Fi AP؛ تطبيق KairOS Android مسار مستقل وغير إلزامي.

قد يتطلب Windows 10 برنامج تشغيل RNDIS بدلًا من CDC-NCM الأصلي. يجب على المشغّل في أي مسار معرفة الواجهة التي تحمل الفيديو، والتي تحمل القياس عن بُعد، والتي تملك صلاحية الأوامر.

الواجهة المادية

تعرض OLED خمس مجموعات من الحالة

الشاشة	الحقول
الوصلة	إشارة WFB وFEC وفقدان الحزم ومعدل البت
الطائرة المسيّرة	اتصال FC وحالة التسليح والوضع والبطارية وGPS
GCS	العملاء المتصلون وتدفقات الفيديو
الشبكة	وصلات الرفع وعناوين IP واستهلاك البيانات
النظام	CPU وRAM والحرارة والقرص ومدة التشغيل

عنصر التحكم	ضغطة قصيرة	ضغطة مطوّلة
أعلى / أسفل	التنقل بين الشاشات	—
اختيار	فتح التفاصيل / تأكيد	الدخول إلى وضع الإعداد
رجوع	عودة	مسار إعادة ضبط المصنع مع تأكيد

معالج الإعداد

الراديو ووصلة الرفع والأمان المحلي

قناة WFB

اختر القناة نفسها التي يستخدمها المرسل الجوي؛ اختلاف القنوات يعني غياب الفيديو.

شبكة Wi‑Fi خارجية

شبكة عميل اختيارية للتحديث والسحابة، لا تستبدل نقطة الاتصال الميدانية.

حساب سحابي

اقتران/ترحيل اختياريان؛ ويستمر الاستقبال المحلي بالعمل دونهما.

عبارة مرور نقطة الاتصال

تنشئ الصورة المستهدفة عبارة مرور فريدة لكل وحدة عند التشغيل الأول وتعرضها للمشغّل عبر مسار الإعداد المحلي.

مصفوفة وصلات الرفع

خمسة مسارات شبكية مع تحويل احتياطي قابل للمراقبة

وصلة الرفع	الدور
Wi‑Fi AP	عملاء المشغّل المحليون
عميل Wi‑Fi	شبكة خارجية وسحابة اختيارية
Ethernet	شبكة LAN أو ربط خلفي سلكي
مشاركة اتصال USB	مسار بيانات مباشر إلى الحاسوب المحمول
SIM7600G-H 4G	ربط خلفي خلوي اختياري

تتضمن المنظومة المستهدفة تحويلًا احتياطيًا حسب الأولوية وفحوص صحة وحدًا قابلًا للضبط لاستهلاك البيانات الخلوية. يجب اختبار ترتيب المسارات والقياس والتحويل الاحتياطي وإتاحتها للمشغّل كحالة صريحة، لا أتمتة خفية.

استكشاف الأعطال

تُشخَّص نقطة الاتصال وWFB ومشاركة USB بصورة مستقلة

bashنقطة اتصال Wi-Fi

sudo systemctl status kairos-hostapd
iwconfig

واجهة KairOS المستهدفة: لا يصبح الأمر قابلًا للتنفيذ إلا بعد إصدار المكوّن المعني.

bashاستقبال WFB ووضع المراقبة

journalctl -u kairos-wfb -n 30 --no-pager
iwconfig wlan1

واجهة KairOS المستهدفة: لا يصبح الأمر قابلًا للتنفيذ إلا بعد إصدار المكوّن المعني.

bashجهاز USB افتراضي

ls /sys/kernel/config/usb_gadget/kairos-ncm 2>/dev/null
sudo systemctl restart kairos-usb-gadget-setup

واجهة KairOS المستهدفة: لا يصبح الأمر قابلًا للتنفيذ إلا بعد إصدار المكوّن المعني.

إذا غابت نقطة الاتصال، فتحقق من hostapd وتعارض أدوار الواجهات.
إذا غاب الفيديو، فتحقق من القناة والمفاتيح ووضع المراقبة والمرسل الجوي قبل تشخيص المتصفح.
إذا لم تظهر مشاركة USB، فتحقق من أسلاك البيانات في الكابل وإعداد gadget وبرنامج تشغيل نظام العميل.
لا تعِد تشغيل خدمات الراديو أو التحكم أثناء طيران نشط دون مسار احتياطي مقرر.