Hamish Willee 88d623bedb
Move PX4 Guide source into /docs (#24490)
* Add vitepress tree

* Update existing workflows so they dont trigger on changes in the docs path

* Add nojekyll, package.json, LICENCE etc

* Add crowdin docs upload/download scripts

* Add docs flaw checker workflows

* Used docs prefix for docs workflows

* Crowdin obvious fixes

* ci: docs move to self hosted runner

runs on a beefy server for faster builds

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: don't run build action for docs or ci changes

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: update runners

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* Add docs/en

* Add docs assets and scripts

* Fix up editlinks to point to PX4 sources

* Download just the translations that are supported

* Add translation sources for zh, uk, ko

* Update latest tranlsation and uorb graphs

* update vitepress to latest

---------

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
Co-authored-by: Ramon Roche <mrpollo@gmail.com>
2025-03-13 16:08:27 +11:00

7.1 KiB
Raw Blame History

Орбіта (Мультикоптер)

 

The Orbit guided flight mode allows you to command a multicopter (or VTOL in multicopter mode) to fly in a circle at a particular location, by default yawing so that it always faces towards the center.

::: info

  • Режим автоматичний - для керування апаратом не потрібно втручання користувача.
  • Режим потребує принаймні дійсної локальної оцінки позиції (не потребує глобальної позиції).
    • Літаючі транспортні засоби не можуть переключатися на цей режим без глобального положення.
    • Літаючі транспортні засоби перейдуть в режим аварійної безпеки, якщо втратять оцінку положення.
  • Режим перешкоджає зброюванню (транспортний засіб повинен бути зброєний при переході на цей режим).
  • Режим вимагає, щоб швидкість вітру та час польоту були в межах допустимих значень (вказано через параметри).
  • Цей режим в даний час підтримується лише на багатокоптерних (або VTOL у режимі MC).
  • Рух палиці RC може контролювати підйом/спуск та швидкість та напрямок оберту.
  • The mode can be triggered using the MAV_CMD_DO_ORBIT MAVLink command.

:::

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

Orbit Mode - MC

QGroundControl (or other compatible GCS or MAVLink API) is required to enable the mode, and to set the center position, initial radius and altitude of the orbit. Після активації транспортний засіб полетить якнайшвидше до найближчої точки на запланованій траєкторії кола і виконає повільний (1 м/с) ходовий оберт навколо запланованого кола за годинниковою стрілкою, обертаючись до центру.

Instructions for how to start an orbit can be found here: FlyView > Orbit Location (QGroundControl guide).

:::info The use of an RC control is optional. Якщо відсутній керування RC, орбіта буде продовжуватися, як описано вище. RC керування не може бути використане для запуску режиму (якщо ви перемикаєтеся на режим через RC, він буде просто працювати у мирі). :::

RC керування може бути використане для зміни висоти орбіти, радіусу, швидкості та напрямку обертання:

  • Left stick:
    • up/down: controls speed of ascent/descent, as in Position mode. Коли в центрі мертвої зони, висота заблокована.
    • left/right: no effect.
  • Right stick:
    • left/right: controls acceleration of orbit in clockwise/counter-clockwise directions. Коли центрується, поточна швидкість заблокована.
      • Максимальна швидкість становить 10 м/с і подальше обмеження з метою збереження центростремального прискорення нижче 2 м/с².
    • up/down: controls orbit radius (smaller/bigger). Коли центрується, поточний радіус заблокований.
      • Мінімальний радіус - 1м. Максимальний радіус становить 100 м.

The diagram below shows the mode behaviour visually (for a mode 2 transmitter).

Orbit Mode - MC

Режим можна припинити, переключившись на будь-який інший режим польоту (використовуючи RC або QGC).

Параметри/Обмеження

Режим впливає на наступні параметри:

Параметр Опис
MC_ORBIT_RAD_MAX Maximum radius of orbit. Default: 1000m.
MC_ORBIT_YAW_MOD Yaw behaviour during orbit flight. Default: Front to Circle Center.

Наступні обмеження зафіксовані у вихідному коді:

  • Початкове / типове обертання 1 м/с у годинному напрямку.
  • Максимальне прискорення обмежено до 2 м/с^2, з пріоритетом на збереження командованої траєкторії кола, а не командованої швидкості на землі (тобто транспортний засіб сповільнюватиметься, щоб досягти правильного кола, якщо прискорення перевищує 2 м/с^2).

Режим орбіти використовує наступні команди MAVLink:

  • MAV_CMD_DO_ORBIT - Start an orbit with specified center point, radius, direction, altitude, speed and yaw direction (vehicle defaults to faceing centre of orbit).
  • ORBIT_EXECUTION_STATUS - Orbit status emitted during orbit to update GCS of current orbit parameters (these may be changed by the RC controller).