يوفر الوكيل تطبيق إعداد مصممًا أولًا للهواتف عبر الشبكة المحلية، ولوحة حالة للقراءة فقط عبر SSH. تقرأ الواجهتان وMission Control والتسليم إلى Android كائن حالة واحدًا، فيرى المشغّل صورة متسقة.
حُدد نموذج الإعداد المحلي بوصفه مواصفات مستهدفة؛ وتتطلب بنية KairOS وعناوين الخدمات التحقق.
مستودع KairOS ↗في هذه الصفحة +
مسار إعداد واحد مصمم أولًا للهاتف
يقدّم الوكيل نفسه تطبيق الويب، ويمكن فتحه من هاتف أو جهاز لوحي أو حاسوب محمول. لا يتطلب السيناريو المحلي الأساسي الإنترنت أو حسابًا سحابيًا. يرشد المعالج المستخدم من تعريف الجهاز إلى تسليم الاتصال إلى Mission Control.
التعريف
اسم الجهاز ودوره وملف اللوحة وإصدار الوكيل والتقدم العام للإعداد الأولي.
MAVLink
حالة FC والبرنامج الثابت ومسار المنفذ التسلسلي ومعدل الباود وheartbeat وعنوان WebSocket URL.
الفيديو
الكاميرا أو المستقبل وعنوان WHEP URL والتسجيل ومعدل البت والتنسيق وحالة الوصلة.
الشبكة
نقطة الاتصال وLAN ومشاركة الاتصال عبر USB وmDNS وEthernet وعميل Wi‑Fi والمودم الخلوي.
الوصول عن بُعد
رمز نفق سحابي اختياري وحالة النفق وعناوين URL المنشورة.
النظام
الخدمات والسجلات والإصدار وملخص الدعم وإجراءات الاستعادة التي تتطلب تأكيدًا.
لا تغيّر الطرفية الإعدادات الفعلية عمدًا
يفتح الأمر kairos لوحة مختصرة تعرض الدور والإصدار وحالة FC والفيديو والوصلة والسحابة، وكذلك عنوان URL المحلي للإعداد. تُجرى التغييرات عبر تطبيق الويب بحقول وتأكيدات صريحة. يقلل نهج القراءة فقط هذا خطر تنفيذ أمر عرضي أثناء الدعم عن بُعد.
kairos
KairOS Drone Agent · drone · v0.1.0-dev
─────────────────────────────────────
FC connected ArduPilot 4.5
Video streaming 1080p30 H.264
Link healthy -51 dBm
Cloud local mode relay off
─────────────────────────────────────
Setup http://<board-ip>:8080| الأمر | الغرض |
|---|---|
| kairos | افتح لوحة القراءة فقط واعرض عناوين URL المحلية |
| kairos status | اعرض بإيجاز الإعداد وMAVLink والفيديو والشبكة والخدمات |
| kairos status --json | أعد حمولة الحالة للبرامج النصية والدعم |
| kairos update | تحقق من إصدار KairOS المنشور وثبّته |
| kairos uninstall | أزل وكيل KairOS من النظام |
خمسة مسارات للوصول، والسحابة ثانوية
| العنوان | الغرض |
|---|---|
| http://<board-ip>:8080 | تطبيق الإعداد والحالة عبر LAN |
| http://<hostname>.local:8080 | mDNS على الشبكة نفسها |
| http://192.168.4.1:8080 | نقطة اتصال الوكيل قبل إعداد الشبكة الخارجية |
| ws://<board-ip>:8765 | مرحّل MAVLink WebSocket خام |
| http://<board-ip>:8889/<cam>/whep | فيديو WebRTC عبر WHEP |
المسار المفضل هو عنوان IP للوحة أو مشاركة الاتصال عبر USB أو نقطة الاتصال. يُسهّل mDNS الاستخدام لكنه يعتمد على نظام العميل والشبكة المحلية. يُفعَّل النفق السحابي للوصول عن بُعد فقط؛ ويُعد تعطيل المرحّل في الوضع المحلي حالة طبيعية لا خطأ.
كائن حالة مشترك لجميع الواجهات
- يعرض تطبيق الإعداد مسار التهيئة الأولية كاملًا والتغييرات المسموح بها.
- توفر CLI ملخصًا آمنًا للقراءة فقط وJSON للدعم.
- يستخدم Mission Control الحقول نفسها عند إضافة العقدة وتشخيصها.
- يفتح التسليم إلى Android أو غيره عنوان URL المحلي نفسه دون إنشاء إعدادات مستقلة.
- يجمع ملخص الدعم الإصدار والملف والخدمات والشبكة وMAVLink والفيديو دون كشف الأسرار.
