Агент обслуживает mobile‑first setup webapp по локальной сети и read‑only статус‑кокпит по SSH. Оба интерфейса, Mission Control и Android‑handoff читают один объект состояния, поэтому оператор видит согласованную картину.
Локальная модель настройки зафиксирована как целевой контракт; сборка KairOS и адреса сервисов требуют проверки.
Репозиторий KairOS ↗На этой странице +
Один mobile‑first поток настройки
Webapp раздаётся самим агентом и открывается с телефона, планшета или ноутбука. Интернет и облачная учётная запись для основного локального сценария не нужны. Мастер ведёт от идентификации устройства до передачи подключения в Mission Control.
Identify
Имя устройства, роль, профиль платы, версия агента и общий прогресс onboarding.
MAVLink
Состояние FC, firmware, serial path, baud rate, heartbeat и WebSocket URL.
Video
Камера или приёмник, WHEP URL, запись, bitrate, формат и состояние линка.
Network
Hotspot, LAN, USB tether, mDNS, Ethernet, Wi‑Fi client и cellular modem.
Remote access
Необязательный cloud tunnel token, состояние туннеля и опубликованные URL.
System
Сервисы, логи, версия, support summary и подтверждаемые recovery‑действия.
Терминал намеренно не меняет живую конфигурацию
Команда kairos открывает короткий cockpit, который показывает роль, версию, состояние FC, видео, линка и облака, а также локальный setup URL. Изменения выполняются через webapp с явными полями и подтверждениями. Такой read‑only подход уменьшает риск случайной команды во время удалённой поддержки.
kairos
KairOS Drone Agent · drone · v0.1.0-dev
─────────────────────────────────────
FC connected ArduPilot 4.5
Video streaming 1080p30 H.264
Link healthy -51 dBm
Cloud local mode relay off
─────────────────────────────────────
Setup http://<board-ip>:8080| Команда | Назначение |
|---|---|
| kairos | Открыть read‑only cockpit и показать локальные URL |
| kairos status | Компактно вывести setup, MAVLink, video, network и services |
| kairos status --json | Вернуть status payload для скриптов и поддержки |
| kairos update | Проверить и установить опубликованный KairOS‑релиз |
| kairos uninstall | Удалить KairOS agent с системы |
Пять путей доступа, облако — вторично
| Адрес | Назначение |
|---|---|
| http://<board-ip>:8080 | Setup webapp и status по LAN |
| http://<hostname>.local:8080 | mDNS на той же сети |
| http://192.168.4.1:8080 | Hotspot агента до настройки внешней сети |
| ws://<board-ip>:8765 | Сырой MAVLink WebSocket relay |
| http://<board-ip>:8889/<cam>/whep | WebRTC‑видео по WHEP |
Приоритетный путь — IP платы, USB tether или hotspot. mDNS удобен, но зависит от клиентской ОС и локальной сети. Cloud tunnel включается только для удалённого доступа; отключённый relay в local mode является нормальным состоянием, а не ошибкой.
Общий status object для всех поверхностей
- Setup webapp показывает полный onboarding и разрешённые изменения.
- CLI выдаёт безопасную read‑only сводку и JSON для поддержки.
- Mission Control использует те же поля при добавлении и диагностике узла.
- Android или другой handoff открывает тот же локальный URL, не создавая отдельную конфигурацию.
- Support summary объединяет версию, профиль, сервисы, сеть, MAVLink и видео без выдачи секретов.
