تصور اور تیاریبے پائلٹ کھیل · #bezpiLOTa · KAIROS DRONE AGENTدستاویزات
فوری رہنما / DRONE AGENT

مجوزہ ایجنٹ UART یا USB سے فلائٹ کنٹرولر کے ساتھ جڑے Linux SBC پر نصب ہوتا ہے۔ ریلیز کے بعد status cockpit مقامی URL دکھائے گا اور براؤزر چیک لسٹ MAVLink، ویڈیو، نیٹ ورک اور Mission Control کو منتقلی کی تصدیق کرے گی۔

مجوزہ

KairOS کا اپنا انسٹالر ابھی شائع نہیں؛ صفحہ جعلی URL کے بغیر قابلِ جانچ تنصیب کا معاہدہ درج کرتا ہے۔

KairOS ریپوزٹری ↗
8080ترتیب / REST
SYSTEMDخدمات کی نگرانی
LOCALابتدائی موڈ
SSHتنصیب کا راستہ
01
آپ کیا بنائیں گے

فلائٹ کنٹرولر کے ساتھ Rust کو ترجیح دینے والا ایجنٹ

مجوزہ ایجنٹ companion SBC پر چل کر FC heartbeat حاصل کرے اور 8080 پر REST، MAVLink روٹنگ، ویڈیو، ریڈیو اور اختیاری کلاؤڈ فراہم کرے۔ Python تہہ AI/vision، hardware bootstrap اور پلگ اِن runtime کے لیے ہے۔ systemd ہر خدمت اور اس کے انحصارات کی نگرانی کرتا ہے۔

02
پیشگی ضروریات

تنصیب سے پہلے ہارڈ ویئر اور سافٹ ویئر

  • معاون Linux سنگل بورڈ کمپیوٹر۔
  • UART یا USB سے جڑا ArduPilot، PX4، Betaflight یا iNav فلائٹ کنٹرولر۔
  • USB UVC یا CSI کیمرا صرف ویڈیو درکار ہونے پر۔
  • انحصارات نصب کرتے وقت SBC پر انٹرنیٹ رسائی۔
  • Raspberry Pi OS Bookworm، Ubuntu 22.04+، Armbian، Debian 12+ یا ہم آہنگ Linux۔
  • SSH رسائی اور curl۔
  • کیمرا، ریڈیو اور زیادہ سے زیادہ لوڈ کے مطابق SBC کی الگ مستحکم بجلی۔
03
تنصیب

مجوزہ Flash Tool بورڈ چن کر کمانڈ بناتا ہے

01

اصل OS لوڈ کریں

سازندے کا معاون OS لکھ کر چلائیں، SSH فعال کریں اور بنیادی نظام اپ ڈیٹ کریں۔

02

Flash Tool کھولیں

Mission Control کی اشاعت کے بعد air-side Drone Agent اور بورڈ کا درست ماڈل منتخب کریں۔

03

بنائی گئی کمانڈ کاپی کریں

ٹول موجودہ انسٹالر اور منتخب پروفائل کے لیے ایک سطری curl بناتا ہے۔

04

SSH سے چلائیں

اسکرپٹ کو sudo درکار ہے؛ انحصارات نصب کر کے صارف/ڈائریکٹری، ترتیب اور systemd units بناتا ہے۔

05

صحت کی حالت کا انتظار کریں

بورڈ کی شناخت، خدمات کا آغاز اور پہلی حالت failed units کے بغیر مکمل ہوں۔

منصوبہ بندی کا ہدف 3–8 منٹ ہے، مگر یہ KairOS SLA نہیں۔ جامد URL جان بوجھ کر نہیں دیا گیا: درست کمانڈ جاری شدہ Flash Tool دے گا۔ غیر موجود kairos/install.sh غلط اور ممکنہ طور پر خطرناک ہدایت ہوگی۔

04
مقامی setup کھولیں

پہلے حالت، پھر URL

bashKairOS کا مجوزہ CLI
kairos
KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔
راستہURL
اسی مشین پرhttp://127.0.0.1:8080
mDNShttp://kairos.local:8080
ایجنٹ کا hotspothttp://192.168.4.1
USB tetherhttp://10.55.0.1:8080
LANhttp://<sbc-ip>:8080
bashمختصر اور مشین کے قابلِ مطالعہ حالت
kairos status
kairos status --json
KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔
05
چیک لسٹ مکمل کریں

Mission Control کو منتقلی سے پہلے سات اسکرینیں

01

شناخت

نام، کردار، بورڈ پروفائل، ورژن اور زمانی خطہ۔

02

MAVLink

FC heartbeat، فرم ویئر، serial port، baud، system/component IDs اور روٹر URL۔

03

ویڈیو

کیمرا شناخت، ریزولوشن، codec، مقامی WHEP اور ریکارڈنگ کی حالت؛ کیمرا نہ ہو تو چھوڑ سکتے ہیں۔

04

نیٹ ورک

Hotspot/LAN، Wi-Fi client، Ethernet، USB tether، موڈیم اور mDNS۔

05

ریموٹ رسائی

اختیاری ٹنل/کلاؤڈ؛ مقامی موڈ مکمل اور درست حالت ہے۔

06

Mission Control

GCS کھول کر hostname/IP سے نوڈ شامل کریں یا خودکار دریافت کریں۔

07

مکمل کریں

معاونت کا خلاصہ محفوظ کریں، خدمات جانچیں اور ابتدائی شمولیت سے نکلیں۔

ایجنٹ کی ترتیب: ArduCopter سے MAVLink رابطہ، serial پورٹ، Wi-Fi اور LTE، نیٹ ورک پورٹس، جغرافیائی حدود اور مشن نقشہ۔
انٹرفیس / بصری مثالMission Control کو منتقلی سے پہلے رابطہ جانچ

MAVLink اور نیٹ ورک پیرامیٹر، چینل کی حالت اور مشن نقشہ ایجنٹ انٹرفیس میں یکجا ہیں۔ یہ جائزہ FC ترتیب کو بعد کے آپریٹر رابطے سے جوڑتا ہے۔

06
مفید کمانڈ

حالت اور حیاتی دور کے لیے کم سے کم CLI

bashحیاتی دور کا مجوزہ CLI
kairos
kairos status
kairos status --json
kairos update
kairos uninstall
KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔

حالت کے عمل صرف حالت پڑھتے ہیں۔ Update اور uninstall نظام بدلتے ہیں اور آپریٹر کے الگ فیصلے، محفوظ ترتیب اور بحالی کے منصوبے کے محتاج ہیں۔ پرواز کی تیاری یا دورانِ پرواز lifecycle کمانڈ نہ چلائیں۔

07
خرابیوں کا حل

supervisor، MAVLink اور کیمرا الگ جانچیں

bashایجنٹ webapp نہیں کھولتا
journalctl -u kairos-supervisor -n 50 --no-pager
ss -tlnp | grep 8080
KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔
bashFC heartbeat نہیں
ls -la /dev/ttyUSB* /dev/ttyAMA* /dev/ttyACM* 2>/dev/null
journalctl -u kairos-mavlink -n 50 --no-pager
KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔
bashکیمرا نہیں ملا
ls -la /dev/video*
v4l2-ctl --list-devices
KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔
  • :8080 نہ سن رہا ہو تو پہلے supervisor/خدمات کی حالت جانچیں، براؤزر کیش نہیں۔
  • serial device غائب ہو تو کیبل، FC بجلی، USB enumeration اور اجازتیں جانچیں۔
  • heartbeat نہ آئے تو baud اور FC ٹیلی میٹری پورٹ کی ترتیب ملائیں۔
  • /dev/video* موجود ہو مگر stream نہ چلے تو فارمیٹ اور دوسرے عمل کے آلہ استعمال کرنے کی جانچ کریں۔
  • API keys، Wi-Fi اسناد یا pairing حالت والا journal شائع نہ کریں۔