ধারণা ও উন্নয়নমানববিহীন ক্রীড়া · #bezpiLOTa · KAIROS DRONE AGENTনথিপত্র
Quickstart / Drone Agent

লক্ষ্য Agent UART বা USB দিয়ে flight controller-এ যুক্ত Linux SBC-তে install হয়। Release-এর পরে status cockpit local URL দেখাবে এবং browser checklist MAVLink, ভিডিও, network ও Mission Control handoff নিশ্চিত করবে।

পরিকল্পিত

KairOS-এর নিজস্ব installer এখনও প্রকাশিত নয়; পৃষ্ঠাটি মিথ্যা URL ছাড়া যাচাইযোগ্য install contract নির্ধারণ করে।

KairOS repository ↗
8080Setup / REST
SYSTEMDService supervision
LOCALDefault mode
SSHInstall path
01
আপনি যা তৈরি করবেন

Flight controller-এর পাশে Rust-first Agent

লক্ষ্য Agent companion SBC-তে চলবে, FC heartbeat পাবে, port 8080-এ REST, MAVLink routing, ভিডিও, radio ও optional cloud দেবে। Python layer 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 installation-এর সময় 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 করুন

নির্মাতার supported 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 ও selected profile-এর one-line curl তৈরি করে।

04

SSH দিয়ে চালান

Script-এর sudo লাগে; dependencies install করে user/directories, config ও systemd units বানায়।

05

Health-এর জন্য অপেক্ষা করুন

Board detection, service start ও first status failed units ছাড়াই শেষ হতে হবে।

Planning estimate 3–8 minutes, KairOS SLA নয়। ইচ্ছাকৃতভাবে static URL দেওয়া হয়নি: released Flash Tool সঠিক command দেবে। অস্তিত্বহীন kairos/install.sh মিথ্যা ও সম্ভাব্য বিপজ্জনক নির্দেশ হবে।

04
Local setup খুলুন

আগে status, পরে URL

bashলক্ষ্য KairOS CLI
kairos
KairOS-এর লক্ষ্য interface: সংশ্লিষ্ট component release হওয়ার পরেই command চালানো যাবে।
পথURL
একই machinehttp://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

পরিচয়

নাম, role, 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

দূরবর্তী access

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 দরকার। Flight preparation বা execution-এর সময় 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 প্রকাশ করবেন না।