अवधारणा और विकासमानवरहित खेल · #bezpiLOTa · KAIROS DRONE AGENTदस्तावेज़
Quickstart / Mission Control

लक्षित प्रक्रिया local demo mode से शुरू होती है: Dashboard, Plan, Configure, Flight Control और Simulate synthetic data से सीखे जाते हैं। वास्तविक FC component publication और secure context, serial flow तथा safety conditions की जाँच के बाद ही जोड़ा जाता है।

नियोजित

#bezpiLOTa Mission Control ecosystem का अलग component है, KairOS Drone Agent का हिस्सा नहीं; executable repository अभी प्रकाशित नहीं हुई है।

KairOS repository ↗
NODE 20+Runtime requirement
4000Default development port
07लक्षित demo profiles
NO FCDemo requirement
01
पूर्वापेक्षाएँ

Development environment और ब्राउज़र

  • Node.js 20 या नया।
  • npm 9 या नया।
  • Repository publication के बाद source code clone और update करने के लिए Git।
  • सामान्य UI के लिए Chrome, Edge या Firefox; WebSerial/WebUSB के लिए Chromium browser चाहिए।
  • बाद में वास्तविक FC जोड़ने के लिए data lines वाला USB cable।
bashToolchain जाँच
node --version
npm --version
git --version
02
विकल्प A

FC के बिना सुरक्षित demo प्रणाली

Demo mode वास्तविक वाहन जोड़े बिना interface सीखने के लिए बनाया जा रहा है। यह simulated telemetry उपयोग करता है और test bench को सक्रिय flight system नहीं बताता।

03
विकल्प B

स्थानीय demo mode

bashलक्षित local demo flow
# Отдельный репозиторий #bezpiLOTa Mission Control ещё не опубликован
# После выпуска ожидаемый поток будет таким:
npm install
NEXT_PUBLIC_DEMO_MODE=true npm run dev
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

नियोजित interface http://localhost:4000 पर खुलेगा। NEXT_PUBLIC_DEMO_MODE=true होने पर external database, SITL और physical hardware आवश्यक नहीं हैं। यह block launch contract निर्धारित करता है, मौजूदा KairOS Drone Agent repository में command होने का दावा नहीं करता।

04
UI जानें

पाँच मुख्य workspaces

01

डैशबोर्ड

Attitude, GPS/altitude, battery, flight mode, connection path और system alerts।

02

योजना

Waypoints, सात generators, altitude/speed/camera trigger, geofences, rally, QGC WPL/KML/CSV।

03

सेटअप करें

Failsafe, PID, power, OSD, ports, sensors, gimbal और firmware-specific panels।

04

Flight control

Arm/disarm, 25+ ArduPilot modes, 50 Hz gamepad/HOTAS, keyboard और guided waypoint।

05

Simulation चलाएँ

3D mission path, terrain following, camera markers, timing और altitude profile।

#bezpilOta GCS video cockpit: camera image, HUD, mini-map, battery, GPS, mission progress और flight commands।
INTERFACE / दृश्य उदाहरणVideo cockpit और flight commands

HUD, telemetry, mini-map और mission progress control commands के साथ हैं। उदाहरण operator workspaces समझने में मदद करता है।

05
वास्तविक FC जोड़ें

Localhost पर WebSerial flow

bashDevelopment server शुरू करना
npm run dev
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
01

Localhost खोलें

Chromium browser में http://localhost:4000 खोलें।

02

FC जोड़ें

Data USB cable उपयोग करें, Connect दबाएँ और browser prompt में serial port चुनें।

03

Serial port खोलना

ब्राउज़र user gesture permission प्राप्त करके port खोलता है।

04

Heartbeat

Mission Control FC heartbeat की प्रतीक्षा करके autopilot/vehicle पहचानता है।

05

क्षमताएँ

AUTOPILOT_VERSION और protocol capabilities माँगता है।

06

Streams + params

Telemetry streams माँगता है और parameters डाउनलोड करता है; handshake का design target 2–5 seconds है।

06
Browser सुरक्षा

WebSerial केवल secure context में काम करता है

WebSerial, WebUSB और Web Bluetooth को HTTPS या localhost पर विशेष trust चाहिए। इसलिए http://localhost:4000 अनुमत है, लेकिन दूसरे device से http://<lan-ip>:4000 को ये APIs नहीं मिलतीं। दूसरे device पर hardware access के लिए HTTPS या desktop/Electron build चाहिए।

सामान्य WebSocket और REST द्वारा Drone Agent connection WebSerial permission उपयोग नहीं करता, लेकिन browser mixed-content rules फिर भी महत्वपूर्ण हैं: HTTPS page plain HTTP/WS Agent को block कर सकता है। पूर्ण local plain-HTTP mode के लिए GCS और Agent संगत context में उपलब्ध होने चाहिए।

07
LAN self-hosting

एक network पर local server और Agent

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 का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
08
SITL

वास्तविक वाहन के बिना physics और protocol

bashलक्षित SITL bridge — component publication के बाद
cd KairOS_Drone-Agent/tools/sitl
npm install
npm start

ArduPilot SITL अलग install करना होगा; binary सामान्यतः ~/.ardupilot/ में होती है। Bridge simulator telemetry को browser transport से जोड़ता है। यह वाहन पर पहला protocol experiment करने से सुरक्षित है, फिर भी versions, parameters और mission behavior की जाँच आवश्यक है।

SOFTWARE SITL simulation screen: route map, waypoint progress, telemetry, वीडियो और mission event log।
INTERFACE / दृश्य उदाहरणSOFTWARE SITL में mission

Simulation screen पर map, waypoint progress, telemetry और waypoint transition events हैं। Log mission behavior verification का context देता है।

09
Desktop app

Hardware APIs और standalone package के लिए Electron

bashKairOS desktop scripts
npm run desktop:dev
npm run desktop:demo
npm run desktop:build:mac
npm run desktop:build
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

Planning में लगभग 200 MB disk और 200–300 MB RAM का अनुमान है। वास्तविक आवश्यकताएँ platform/runtime version पर निर्भर करेंगी और Mission Control build के साथ प्रकाशित होंगी।

10
Environment

Mode और external infrastructure variables

Variableडिफ़ॉल्टउद्देश्य
NEXT_PUBLIC_DEMO_MODEfalseवास्तविक sources के बजाय सात simulated drones
PORT4000Development server का port
NEXT_PUBLIC_CONVEX_URLnoneवैकल्पिक Convex backend
NEXT_PUBLIC_MQTT_URLnoneवैकल्पिक MQTT broker

Local/direct mode को cloud variables नहीं चाहिए। Convex या MQTT की अनुपस्थिति direct USB, local Agent discovery या offline mission planning रोकनी नहीं चाहिए।

11
परियोजना संरचना

अलग GCS की लक्षित संरचना

textRepository की लक्षित संरचना
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