PX4 Guide (main)

Мови (Ukrainian)

English
中文 (Chinese)
한국어 (Korean)

Мови (Ukrainian)

English
中文 (Chinese)
한국어 (Korean)

Appearance

Камери MAVLink (Протокол камери v2) ​

Ця тема пояснює, як використовувати PX4 з MAVLink камера, що реалізує [MAVLink Camera Protocol v2] (https://mavlink.io/en/services/camera.html) з PX4 та Наземною Станцією.

TIP

Це рекомендований спосіб інтеграції камери з PX4!

Загальний огляд ​

Протокол камери MAVLink v2 дозволяє запитувати, які функції підтримуються камерою, і надає команди для керування захопленням зображень та відео, передачі відео, встановлення зуму та фокусу, вибору між інфрачервоними та видимими потоками світла, встановлення місця, куди зберігаються зібрані дані, та інше.

Камера може реалізувати протокол на рівні системи, але більшість налаштувань камер MAVLink передбачають взаємодію PX4 з менеджером камер, що працює на супутниковому комп'ютері, який потім взаємодіє між MAVLink та вихідним протоколом камери.

Загалом можна сказати, що "інтеграція" PX4 з камерою полягає в повторному відтворенні команд камери, знайдених у місіях за допомогою протоколу команд. В іншому випадку вона може діяти як міст, пересилаючи команди між земною станцією та камерою, якщо немає прямого каналу MAVLink.

INFO

PX4 не підтримує використання команд MAVLink Протокол Камери v2 для управління камерами, які підключені до виходів контролера польоту. Хоча це технічно можливо, це вимагатиме від PX4 реалізації інтерфейсу керування камерою.

Керування камерою ​

Камери виявлені за допомогою протоколу підключення MAVLink (https://mavlink.io/en/services/heartbeat.html), заснованого на їх HEARTBEAT.type, заснованими на MAV_TYPE_CAMERA (https://mavlink.io/en/messages/common.html#MAV_TYPE_CAMERA).

TIP

Камери також повинні використовувати ID компонента в рекомендованому діапазоні, такому як MAV_COMP_ID_CAMERA, але, як правило, на це не можна покладатися для перевірки того, що компонент MAVLink є камерою.

Якщо камера виявлена, можна подивитися її властивості та можливості за допомогою MAV_CMD_REQUEST_MESSAGE, щоб запросити повідомлення CAMERA_INFORMATION, а потім інспектувати поле flags, щоб визначити, які стандартні функції в CAMERA_CAP_FLAGS підтримуються.

На основі прапорців ви можете визначити, які інші команди та повідомлення підтримуються камерою. Повний набір повідомлень, команд та констант узагальнено тут.

Додаткові параметри камери_можуть_бути викриті у файлі-визначенні камери, який зв'язаний з CAMERA_INFORMATION.cam_definition_uri. GCS або SDK можуть відкрити ці параметри через загальний інтерфейс користувача, не маючи розуміння будь-якого контексту. Ці параметри не можуть бути встановлені безпосередньо в місіях і не мають конкретних команд-встановлювачів.

Протокол камери MAVLink v2 описує всі взаємодії більш детально.

Наземні станції та MAVLink SDK виявляють камери та їх можливості, як описано в попередньому розділі.

Наземна станція може використовувати будь-яку функцію, яку надає камера. PX4 не має жодної ролі в цій взаємодії, крім пересилання трафіку MAVLink між камерою та наземною станцією або SDK, якщо потрібно.

Команди камери у місіях ​

PX4 дозволяє використовувати наступний піднабір команд Camera Protocol v2 під час місій:

PX4 відновлює команди камери, знайдені в місіях, як команди MAVLink. Системний ідентифікатор випущених команд співпадає з ідентифікатором автопілота. Ідентифікатор компонента команд може відрізнятися. Перші чотири команди адресовані MAV_COMP_ID_CAMERA (100) (якщо у камери є цей ідентифікатор компонента, вона виконає вказану команду). Режим камери, зум та фокусування, команди надсилаються до компонента з ідентифікатором MAV_COMP_ID_ALL.

INFO

PX4 в даний час ігнорує ідентифікатор цілі камери id в MAV_CMD_IMAGE_START_CAPTURE та інших повідомленнях камери. Див. PX4-Autopilot#23083.

Ручне керування ​

Стіки джойстика можуть бути налаштовані на спрацьовування захоплення зображення або перемикання захоплення відео.

PX4 видає команди MAVLink Camera Protocol v2, такі як MAV_CMD_IMAGE_START_CAPTURE, коли натиснута відповідна кнопка джойстика. Ця функція працює лише для цього типу камери та джойстика - підтримки для радіокерованних-контролерів немає.

Конфігурація PX4 ​

Вам потрібно буде надати канал MAVLink для будь-яких підключених камер, щоб PX4 міг висилати будь-які команди камери, знайдені в місіях. Якщо ваша мережа MAVLink така, що PX4 є "між" вашою камерою та наземною станцією, вам також потрібно буде пересилати комунікації, щоб вони могли спілкуватися.

Спочатку під'єднайте камеру до не використаного послідовного порту на контролері польоту, такого як TELEM2 (ви також можете використовувати порт Ethernet, якщо він присутній як на контролері польоту, так і на камері). Потім налаштуйте обраний порт як MAVLink Peripheral.

Документ пояснює, як, але коротко:

  1. Змініть невикористаний параметр MAV_n_CONFIG, такий як MAV_2_CONFIG, щоб він був присвоєний порту, до якого підключена ваша камера/компаньйонський комп'ютер.
  2. Встановіть відповідний MAV_2_MODE на 2 (На борту). Це забезпечує, що правильний набір повідомлень MAVLink випромінюється для супутнього комп'ютера (або камери).
  3. Встановіть MAV_2_FORWARD, щоб дозволити пересилання комунікацій з порту на інші порти, такі як той, що підключений до наземної станції.
  4. Можливо, вам доведеться встановити деякі інші параметри, залежно від типу підключення та будь-яких конкретних вимог камери щодо очікуваної швидкості передачі даних і т. д.

Ручне керування ​

Кнопки джойстика можуть бути налаштовані для захоплення зображень та перемикання запису відео включено/виключено.

Менеджери камер ​

Якщо ви хочете використовувати камеру, яка не підтримує протокол камери MAVLink за замовчуванням, вам знадобиться менеджер камери MAVLink. Менеджер камери працює на супутниковому комп'ютері та з'єднує інтерфейс протоколу камери MAVLink і нативний інтерфейс камери.

Існують "розширювані" менеджери камер, якими можна користуватися з багатьма різними камерами, менеджери камер, розроблені для роботи з певною камерою, а також ви можете написати свій власний (наприклад, використовуючи додатки сервера MAVSDK).

Загальні/розширені менеджери камер:

  • Менеджер камери MAVLink - Розширюваний крос-платформенний сервер камери MAVLink, побудований на базі GStreamer та Rust-MAVLink.
  • Менеджер камери Dronecode - Додає інтерфейс протоколу камери для камер, підключених до комп'ютера з Linux.

Специфічні менеджери камери:

  • Менеджер камери SIYI A8 mini - Менеджер камери на основі плагіна MAVSDK для [SIYI A8 mini] (включає навчальний посібник).

    TIP

    Це добрий приклад того, як MAVSDK може бути використаний для створення інтерфейсу протоколу камери MAVLink для певної камери.

:::

Під час використання менеджера камери ви підключаєте компаньйон-комп'ютер до контролера польоту (замість прямого підключення до камери), і вам знадобиться додаткове програмне забезпечення на комп'ютері для направлення трафіку MAVLink до менеджера камери на компаньйон-комп'ютері, таке як mavlink-router.

Додаткову інформацію щодо камерного менеджера та налаштувань компаньйона можна знайти в: