فوری رہنما / MISSION CONTROL

مجوزہ منظرنامہ مقامی demo mode سے شروع ہوتا ہے: Dashboard، Plan، Configure، Flight Control اور Simulate مصنوعی ڈیٹا سے سیکھے جاتے ہیں۔ حقیقی FC صرف جزو کی اشاعت اور secure context، serial flow اور حفاظتی شرائط کی جانچ کے بعد جوڑا جاتا ہے۔

مجوزہ

#bezpiLOTa Mission Control ماحولیاتی نظام کا ساتھی جزو ہے، KairOS Drone Agent کا حصہ نہیں؛ قابلِ عمل ریپوزٹری ابھی شائع نہیں ہوا۔

KairOS ریپوزٹری ↗

NODE 20+runtime کی ضرورت

4000ابتدائی dev پورٹ

07مجوزہ demo پروفائل

NO FCdemo کی ضرورت

اس صفحے پر +

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

ترقیاتی ماحول اور براؤزر

Node.js 20 یا جدید۔
npm 9 یا جدید۔
ریپوزٹری کی اشاعت کے بعد ماخذ clone اور اپ ڈیٹ کرنے کے لیے Git۔
عام UI کے لیے Chrome، Edge یا Firefox؛ WebSerial/WebUSB کے لیے Chromium براؤزر ضروری ہے۔
بعد میں حقیقی FC جوڑنے کی صورت میں ڈیٹا لائن والی USB کیبل۔

bashٹول چین کی جانچ

node --version
npm --version
git --version

انتخاب A

FC کے بغیر محفوظ demo نظام

نمائشی موڈ حقیقی آلہ جوڑے بغیر انٹرفیس سے محفوظ واقفیت کے لیے ڈیزائن ہے۔ یہ سیمولیٹڈ ٹیلی میٹری استعمال کرتا ہے اور ٹیسٹ بینچ کو حقیقی فلائٹ نظام ظاہر نہیں کرتا۔

انتخاب B

مقامی demo mode

bashمجوزہ مقامی demo عمل

# Отдельный репозиторий #bezpiLOTa Mission Control ещё не опубликован
# После выпуска ожидаемый поток будет таким:
npm install
NEXT_PUBLIC_DEMO_MODE=true npm run dev

KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔

مجوزہ انٹرفیس http://localhost:4000 پر کھلنا چاہیے۔ NEXT_PUBLIC_DEMO_MODE=true پر بیرونی ڈیٹابیس، SITL اور حقیقی ہارڈ ویئر ضروری نہیں۔ یہ حصہ آغاز کا معاہدہ درج کرتا ہے، موجودہ KairOS Drone Agent ریپوزٹری میں کمانڈ کی موجودگی کا دعویٰ نہیں۔

انٹرفیس دریافت کریں

پانچ بنیادی کام کے انٹرفیس

ڈیش بورڈ

زاویائی حالت، GPS/بلندی، بیٹری، فلائٹ موڈ، کنکشن راستہ اور نظامی انتباہات۔

منصوبہ

Waypoints، سات جنریٹر، بلندی/رفتار/کیمرا ٹرگر، geofences، rally، QGC WPL/KML/CSV۔

ترتیب

Failsafe، PID، بجلی، OSD، پورٹس، سینسر، گمبل اور فرم ویئر کے مخصوص پینل۔

فلائٹ کنٹرول

Arm/disarm، 25+ ArduPilot موڈ، 50 Hz گیم پیڈ/HOTAS، کی بورڈ اور guided waypoint۔

سیمولیشن

3D مشن راستہ، زمین کی پیروی، کیمرا نشان، اوقات اور بلندی کا پروفائل۔

#bezpilOta GCS ویڈیو کاک پٹ: کیمرا منظر، HUD، چھوٹا نقشہ، بیٹری، GPS، مشن پیش رفت اور فلائٹ کمانڈ۔ — انٹرفیس / بصری مثال**ویڈیو کاک پٹ اور فلائٹ کمانڈ**
HUD، ٹیلی میٹری، چھوٹا نقشہ اور مشن پیش رفت کنٹرول کمانڈ کے ساتھ ہیں۔ مثال آپریٹر کے کام کے انٹرفیس سمجھنے میں مدد دیتی ہے۔

حقیقی FC جوڑیں

localhost پر WebSerial عمل

bashترقیاتی سرور چلانا

npm run dev

KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔

localhost کھولیں

Chromium براؤزر میں http://localhost:4000 کھولیں۔

FC جوڑیں

ڈیٹا USB کیبل استعمال کریں، Connect دبائیں اور براؤزر کے سوال میں serial port منتخب کریں۔

سیریل کھولنا

براؤزر صارف کے عمل کی اجازت لے کر پورٹ کھولتا ہے۔

ہارٹ بیٹ

Mission Control، FC heartbeat کا انتظار کر کے autopilot/vehicle شناخت کرتا ہے۔

صلاحیتیں

AUTOPILOT_VERSION اور پروٹوکول کی صلاحیتیں مانگتا ہے۔

بہاؤ اور پیرامیٹر

ٹیلی میٹری بہاؤ مانگ کر پیرامیٹر ڈاؤن لوڈ کرتا ہے؛ handshake کا مجوزہ وقت 2–5 سیکنڈ ہے۔

براؤزر کی سلامتی

WebSerial صرف secure context میں کام کرتا ہے

WebSerial، WebUSB اور Web Bluetooth کو HTTPS یا localhost پر خاص اعتماد درکار ہے۔ اس لیے http://localhost:4000 جائز ہے مگر دوسرے آلے کا http://<lan-ip>:4000 یہ APIs نہیں پاتا۔ دوسرے آلے پر ہارڈ ویئر رسائی کے لیے HTTPS یا desktop/Electron بلڈ چاہیے۔

عام WebSocket اور REST سے Drone Agent کا رابطہ WebSerial اجازت استعمال نہیں کرتا، مگر براؤزر کے mixed-content قواعد اہم ہیں: HTTPS صفحہ plain HTTP/WS ایجنٹ روک سکتا ہے۔ مکمل مقامی plain-HTTP موڈ میں GCS اور ایجنٹ ہم آہنگ context میں دستیاب ہوں۔

LAN پر خود میزبانی

مقامی سرور اور ایجنٹ ایک نیٹ ورک میں

textLAN پتے

npm run dev

# GCS on this machine
http://localhost:4000

# GCS from another LAN client
http://<your-lan-ip>:4000

# Example KairOS Agent address
http://kairos.local:8080
http://192.168.1.50:8080

KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔

SITL

حقیقی آلے کے بغیر طبیعیات اور پروٹوکول

bashمجوزہ SITL پل — جزو کی اشاعت کے بعد

cd KairOS_Drone-Agent/tools/sitl
npm install
npm start

ArduPilot SITL الگ نصب ہونا چاہیے؛ binary عموماً ~/.ardupilot/ میں ہے۔ پل سیمولیٹر ٹیلی میٹری کو براؤزر transport سے جوڑتا ہے۔ یہ حقیقی آلے پر پہلے پروٹوکول تجربے سے محفوظ ہے، مگر ورژن، پیرامیٹر اور مشن رویے کی جانچ پھر بھی ضروری ہے۔

SOFTWARE SITL سیمولیشن اسکرین: راستے کا نقشہ، نقاط سے گزرنا، ٹیلی میٹری، ویڈیو اور مشن واقعات کا لاگ۔ — انٹرفیس / بصری مثال**SOFTWARE SITL میں مشن**
سیمولیشن اسکرین نقشہ، waypoint پیش رفت، ٹیلی میٹری اور نقاط کے درمیان منتقلی کے واقعات دکھاتی ہے۔ لاگ مشن رویہ جانچنے کا سیاق دیتا ہے۔

ڈیسک ٹاپ ایپ

ہارڈ ویئر APIs اور خودکفیل پیکیج کے لیے Electron

bashKairOS ڈیسک ٹاپ اسکرپٹ

npm run desktop:dev
npm run desktop:demo
npm run desktop:build:mac
npm run desktop:build

KairOS کا مجوزہ انٹرفیس: متعلقہ جزو کے جاری ہونے کے بعد ہی کمانڈ قابلِ عمل ہوتی ہے۔

منصوبہ بندی کے لیے ڈسک پر تقریباً 200 MB اور 200–300 MB RAM ہدف ہے۔ حقیقی ضرورت platform/runtime ورژن پر منحصر ہے اور Mission Control بلڈ کے ساتھ شائع ہوگی۔

ماحول

موڈ اور بیرونی انفراسٹرکچر کے متغیرات

متغیر	ابتدائی قدر	مقصد
NEXT_PUBLIC_DEMO_MODE	false	حقیقی ماخذ کے بجائے سات سیمولیٹڈ ڈرون
PORT	4000	ترقیاتی سرور کا پورٹ
NEXT_PUBLIC_CONVEX_URL	کوئی نہیں	اختیاری Convex بیک اینڈ
NEXT_PUBLIC_MQTT_URL	کوئی نہیں	اختیاری MQTT بروکر

مقامی/direct موڈ میں کلاؤڈ متغیر ضروری نہیں۔ Convex یا MQTT کی عدم موجودگی براہِ راست USB، مقامی ایجنٹ تلاش یا آف لائن مشن منصوبہ بندی کو نہ روکے۔

منصوبے کی ساخت

الگ GCS کی مجوزہ ساخت

textریپوزٹری کی مجوزہ ساخت

KairOS_Drone-Agent/
├── agent/                onboard runtime
├── api/                  local control surface
├── protocols/            MAVLink and MSP adapters
├── media/                video transports
├── extensions/           sandbox runtime and SDK
├── tools/sitl/           simulator bridge
├── deploy/systemd/       Linux services
├── docs/                 project documentation
└── tests/                contracts and hardware profiles