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

लक्षित Agent UART या USB से flight controller जुड़े Linux SBC पर install होता है। Release के बाद status cockpit स्थानीय URL दिखाएगा और browser checklist MAVLink, वीडियो, network तथा Mission Control handoff की पुष्टि करेगी।

नियोजित

KairOS का अपना installer अभी प्रकाशित नहीं है; यह पृष्ठ गलत URL दिए बिना verified install contract बताता है।

KairOS repository ↗
8080Setup / REST
SYSTEMDService supervision
LOCALDefault mode
SSHInstallation path
01
आप क्या बनाएँगे

Flight controller के साथ Rust-first Agent

लक्षित Agent companion SBC पर चलेगा, FC heartbeat प्राप्त करेगा और port 8080 पर REST, MAVLink routing, वीडियो, radio तथा optional cloud देगा। Python परत AI/vision, hardware bootstrap और plugin runtime के लिए है। systemd हर service और उसकी dependencies नियंत्रित करता है।

02
पूर्वापेक्षाएँ

Installation से पहले hardware और software

  • समर्थित Linux single-board computer।
  • UART या USB से जुड़ा ArduPilot, PX4, Betaflight या iNav flight controller।
  • वीडियो आवश्यक हो तभी USB UVC या CSI camera।
  • Dependencies install करते समय SBC पर internet access।
  • Raspberry Pi OS Bookworm, Ubuntu 22.04+, Armbian, Debian 12+ या संगत Linux।
  • SSH access और curl।
  • Camera, radios और peak load के लिए उपयुक्त SBC की अलग stable power supply।
03
Install

लक्षित Flash Tool board चुनकर command बनाता है

01

Stock OS boot करें

निर्माता का समर्थित OS flash और boot करें, SSH चालू करें तथा base system update करें।

02

Flash Tool खोलें

Mission Control publication के बाद air-side Drone Agent और exact board model चुनें।

03

Generated command कॉपी करें

Tool मौजूदा installer और चुने profile के लिए one-line curl बनाता है।

04

SSH से चलाएँ

Script को sudo चाहिए; यह dependencies install करके user/directories, config और systemd units बनाता है।

05

Health की प्रतीक्षा करें

Board detection, service start और पहला status failed units के बिना पूरे होने चाहिए।

Planning का अनुमान 3–8 minutes है, लेकिन यह KairOS SLA नहीं है। Static URL जानबूझकर नहीं दिया गया: सही command released Flash Tool से आनी चाहिए। अस्तित्वहीन kairos/install.sh गलत और संभावित रूप से खतरनाक निर्देश होगा।

04
Local setup खोलें

पहले status, फिर URL

bashलक्षित KairOS CLI
kairos
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
मार्गURL
उसी machine परhttp://127.0.0.1:8080
mDNShttp://kairos.local:8080
Agent का hotspothttp://192.168.4.1
USB tetherhttp://10.55.0.1:8080
LANhttp://<sbc-ip>:8080
bashसंक्षिप्त और machine-readable status
kairos status
kairos status --json
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
05
Checklist पूरी करें

Mission Control handoff से पहले सात screens

01

पहचान

नाम, भूमिका, board profile, version और time zone।

02

MAVLink

FC heartbeat, firmware, serial port, baud, system/component IDs और router URL।

03

वीडियो

Camera detection, resolution, codec, local WHEP और recording state; camera न हो तो छोड़ सकते हैं।

04

नेटवर्क

Hotspot/LAN, Wi‑Fi client, Ethernet, USB tether, modem और mDNS।

05

दूरस्थ पहुँच

Optional tunnel/cloud; local mode पूरी तरह वैध स्थिति है।

06

Mission Control

GCS खोलकर hostname/IP से node जोड़ें या auto-discover करें।

07

समाप्त करें

Support summary बचाएँ, services जाँचें और onboarding से बाहर आएँ।

Agent setup: ArduCopter के साथ MAVLink connection, serial port, Wi‑Fi और LTE, network ports, geographic restrictions और mission map।
INTERFACE / दृश्य उदाहरणMission Control handoff से पहले connection check

Agent interface में MAVLink और network parameters, link status तथा mission map एकत्र हैं। यह overview FC setup को आगे के operator connection से जोड़ता है।

06
उपयोगी commands

State और lifecycle के लिए न्यूनतम CLI

bashलक्षित lifecycle CLI
kairos
kairos status
kairos status --json
kairos update
kairos uninstall
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।

Status operations state पढ़ते हैं। Update और uninstall system बदलते हैं तथा operator के अलग निर्णय, saved configuration और recovery plan की आवश्यकता होती है। उड़ान की तैयारी या संचालन के दौरान lifecycle command न चलाएँ।

07
समस्या निवारण

Supervisor, MAVLink और camera अलग जाँचें

bashAgent webapp नहीं खोलता
journalctl -u kairos-supervisor -n 50 --no-pager
ss -tlnp | grep 8080
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
bashFC heartbeat नहीं है
ls -la /dev/ttyUSB* /dev/ttyAMA* /dev/ttyACM* 2>/dev/null
journalctl -u kairos-mavlink -n 50 --no-pager
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
bashCamera नहीं मिला
ls -la /dev/video*
v4l2-ctl --list-devices
KairOS का लक्षित interface: संबंधित component के release के बाद ही command चलाने योग्य होगी।
  • यदि :8080 नहीं सुनता, पहले supervisor/service state जाँचें, browser cache नहीं।
  • Serial device न हो तो cable, FC power, USB enumeration और permissions जाँचें।
  • Heartbeat न आए तो baud और FC telemetry port settings मिलाएँ।
  • /dev/video* मौजूद हो लेकिन stream शुरू न हो तो formats और दूसरे process द्वारा device उपयोग जाँचें।
  • API keys, Wi‑Fi credentials या pairing state वाला journal प्रकाशित न करें।