KONSEP DAN PENGEMBANGANOLAHRAGA TANPA AWAK · #bezpiLOTa · KAIROS DRONE AGENTDokumentasi
#bezpiLOTaOLAHRAGA TANPA AWAKKairOSDRONE AGENT
KONSEP / PENGEMBANGANGitHub
#bezpiLOTa→Memulai→Drone Agent
PANDUAN CEPAT / DRONE AGENT

Agent yang ditargetkan dipasang pada SBC Linux yang terhubung ke pengendali penerbangan melalui UART atau USB. Setelah rilis, kokpit status seharusnya menampilkan URL lokal, dan daftar periksa peramban harus memverifikasi MAVLink, video, jaringan, serta handoff ke Mission Control.

DIRENCANAKAN

Penginstal milik KairOS belum dipublikasikan; halaman ini menetapkan kontrak instalasi yang dapat diverifikasi tanpa URL rekaan.

Repositori KairOS ↗
8080konfigurasi / REST
SYSTEMDpengawasan layanan
LOCALmode bawaan
SSHjalur instalasi
Semua bagian dokumentasi +
Pada halaman ini +
01
YANG AKAN ANDA BANGUN

Agent berbasis Rust di samping pengendali penerbangan

Agent yang ditargetkan seharusnya berjalan pada SBC pendamping, menerima heartbeat FC, dan menyediakan REST pada 8080, perutean MAVLink, video, radio, serta konektivitas cloud opsional. Python direncanakan untuk AI/visi, bootstrap perangkat keras, dan runtime plugin. systemd mengawasi setiap layanan dan dependensinya.

02
PRASYARAT

Perangkat keras dan perangkat lunak sebelum instalasi

  • Komputer papan tunggal Linux yang didukung.
  • Pengendali penerbangan dengan ArduPilot, PX4, Betaflight, atau iNav, terhubung melalui UART atau USB.
  • Kamera USB UVC atau CSI hanya jika video diperlukan.
  • Akses internet pada SBC saat memasang dependensi.
  • Raspberry Pi OS Bookworm, Ubuntu 22.04+, Armbian, Debian 12+, atau Linux yang kompatibel.
  • Akses SSH dan curl.
  • Daya SBC stabil yang terpisah, dengan kapasitas sesuai kamera, radio, dan beban puncak.
03
INSTALASI

Flash Tool yang ditargetkan memilih papan dan menghasilkan perintah

01

Boot OS bawaan

Tulis dan boot OS produsen yang didukung, aktifkan SSH, lalu perbarui sistem dasar.

02

Buka Flash Tool

Setelah Mission Control dipublikasikan, pilih Drone Agent sisi udara dan model papan yang tepat.

03

Salin perintah yang dihasilkan

Alat menghasilkan perintah curl satu baris untuk penginstal terkini dan profil yang dipilih.

04

Jalankan melalui SSH

Skrip memerlukan sudo, memasang dependensi, serta membuat pengguna/direktori, konfigurasi, dan unit systemd.

05

Tunggu status sehat

Deteksi papan, peluncuran layanan, dan pemeriksaan status pertama seharusnya selesai tanpa unit gagal.

Perencanaan mengasumsikan 3–8 menit, tetapi ini bukan SLA KairOS. URL statis sengaja tidak disertakan: Flash Tool yang dirilis harus menyediakan perintah yang benar. kairos/install.sh yang tidak ada akan menjadi instruksi yang menyesatkan dan berpotensi berbahaya.

04
BUKA KONFIGURASI LOKAL

Status dahulu, lalu URL

bashCLI KairOS yang ditargetkan
kairos
Antarmuka yang ditargetkan KairOS: perintah baru dapat dijalankan setelah komponen terkait dirilis.
JalurURL
Mesin yang samahttp://127.0.0.1:8080
mDNShttp://kairos.local:8080
Hotspot agenhttp://192.168.4.1
Tether USBhttp://10.55.0.1:8080
LANhttp://<sbc-ip>:8080
bashStatus ringkas yang dapat dibaca mesin
kairos status
kairos status --json
Antarmuka yang ditargetkan KairOS: perintah baru dapat dijalankan setelah komponen terkait dirilis.
05
SELESAIKAN DAFTAR PERIKSA

Tujuh layar sebelum handoff ke Mission Control

01

Identifikasi

Nama, peran, profil papan, versi, dan zona waktu.

02

MAVLink

Heartbeat FC, firmware, port serial, baud rate, ID sistem/komponen, dan URL router.

03

Video

Deteksi kamera, resolusi, codec, WHEP lokal, dan keadaan perekaman; dapat dilewati tanpa kamera.

04

Jaringan

Hotspot/LAN, klien Wi-Fi, Ethernet, tethering USB, modem, dan mDNS.

05

Akses jarak jauh

Terowongan/cloud opsional; mode lokal merupakan keadaan yang lengkap dan valid.

06

Mission Control

Buka GCS dan tambahkan simpul berdasarkan nama host/IP atau temukan secara otomatis.

07

Selesai

Simpan ringkasan dukungan, periksa layanan, dan keluar dari orientasi awal.

Konfigurasi agen: koneksi MAVLink ke ArduCopter, port serial, Wi-Fi dan LTE, port jaringan, pembatasan geografis, dan peta misi.
ANTARMUKA / CONTOH VISUALPemeriksaan koneksi sebelum handoff ke Mission Control

Parameter MAVLink dan jaringan, keadaan tautan, serta peta misi dihimpun dalam antarmuka agen. Ringkasan ini menghubungkan konfigurasi FC dengan koneksi operator berikutnya.

06
PERINTAH BERGUNA

CLI minimal untuk status dan siklus hidup

bashCLI siklus hidup yang ditargetkan
kairos
kairos status
kairos status --json
kairos update
kairos uninstall
Antarmuka yang ditargetkan KairOS: perintah baru dapat dijalankan setelah komponen terkait dirilis.

Operasi status membaca keadaan. Pembaruan dan penghapusan instalasi mengubah sistem serta memerlukan keputusan operator terpisah, konfigurasi tersimpan, dan rencana pemulihan. Jangan jalankan perintah siklus hidup saat mempersiapkan atau menjalankan penerbangan.

07
PEMECAHAN MASALAH

Diagnosis supervisor, MAVLink, dan kamera secara terpisah

bashAplikasi web agen tidak terbuka
journalctl -u kairos-supervisor -n 50 --no-pager
ss -tlnp | grep 8080
Antarmuka yang ditargetkan KairOS: perintah baru dapat dijalankan setelah komponen terkait dirilis.
bashTidak ada heartbeat FC
ls -la /dev/ttyUSB* /dev/ttyAMA* /dev/ttyACM* 2>/dev/null
journalctl -u kairos-mavlink -n 50 --no-pager
Antarmuka yang ditargetkan KairOS: perintah baru dapat dijalankan setelah komponen terkait dirilis.
bashKamera tidak ditemukan
ls -la /dev/video*
v4l2-ctl --list-devices
Antarmuka yang ditargetkan KairOS: perintah baru dapat dijalankan setelah komponen terkait dirilis.
  • Jika :8080 tidak mendengarkan, periksa keadaan supervisor/layanan sebelum cache peramban.
  • Jika perangkat serial tidak ada, periksa kabel, daya FC, enumerasi USB, dan izin.
  • Jika heartbeat tidak muncul, bandingkan baud rate dan pengaturan port telemetri FC.
  • Jika /dev/video* ada tetapi aliran tidak dimulai, periksa format dan apakah perangkat digunakan proses lain.
  • Jangan memublikasikan log jurnal yang berisi kunci API, kredensial Wi-Fi, atau keadaan pemasangan.