fly316/PX4-Autopilot
7
0
Fork 0
mirror of https://gitee.com/mirrors_PX4/PX4-Autopilot.git synced 2026-10-17 06:33:35 +08:00
Code Issues Packages Projects Releases Wiki Activity

Move PX4 Guide source into /docs (#24490)

Browse Source 
* 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>
This commit is contained in:
Hamish Willee
2025-03-13 16:08:27 +11:00
committed by GitHub
co-authored by Ramon Roche
parent 8e6d2ebe4a
commit 88d623bedb
5176 changed files with 558771 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/uk/getting_started/flight_controller_selection.md
+40
View File
@@ -0,0 +1,40 @@
# Вибір політного контролера
Політний контролер - це "мізки" безпілотного апарату.
PX4 can run on [many flight controller boards](../flight_controller/index.md).
Вам слід обирати плату, яка відповідає фізичним обмеженням вашого апарату, видам діяльності, які ви хочете виконувати та, звичайно, за вартістю.
<img src="../../assets/flight_controller/pixhawk6x/pixhawk6x_hero_upright.png" width="120px" title="Holybro Pixhawk6X"><img src="../../assets/flight_controller/cuav_pixhawk_v6x/pixhawk_v6x.jpg" width="200px" title="CUAV Pixhawk 6X" ><img src="../../assets/flight_controller/cube/orange/cube_orange_hero.jpg" width="250px" title="CubePilot Cube Orange" />
## Pixhawk Series
[Pixhawk Series](../flight_controller/pixhawk_series.md) open-hardware flight controllers run PX4 on NuttX OS.
With many form factors, there are versions targeted towards many use cases and market segments.
[Pixhawk Standard Autopilots](../flight_controller/autopilot_pixhawk_standard.md) are used as the PX4 reference platform.
They are supported and tested by the PX4 development team, and are highly recommended.
## Контролери від виробників
Other flight controllers are [manufacturer-supported](../flight_controller/autopilot_manufacturer_supported.md).
This includes FCs that are heavily based on the Pixhawk standard (but which are not fully compliant), and many others.
Note that manufacturer-supported controllers can be just as "good" (or better) than those which are Pixhawk-standard.
## Автопілоти для завдань з інтенсивними обчисленнями
Dedicated flight controllers like Pixhawk are not usually well-suited for general purpose computing or running computationally intensive tasks.
For more computing power, the most common approach is to run those applications on a separate onboard [Companion Computer](../companion_computer/index.md).
Some companion computers can also run PX4 on a separate DSP, as part of the same autopilot board.
Similarly, PX4 can also run natively Raspberry Pi (this approach is not generally considered as "robust" as having a separate companion or using a dedicated DSP):
- [Raspberry Pi 2/3 Navio2](../flight_controller/raspberry_pi_navio2.md)
- [Raspberry Pi 2/3/4 PilotPi Shield](../flight_controller/raspberry_pi_pilotpi.md)
## Комерційні БПЛА, які можуть працювати з PX4
PX4 is available on many popular commercial drone products, including some that ship with PX4 and others that can be updated with PX4 (allowing you to add mission planning and other PX4 Flight modes to your vehicle).
For more information see [Complete Vehicles](../complete_vehicles/index.md).
docs/uk/getting_started/flight_modes.md
+1
View File
@@ -0,0 +1 @@
<Redirect to="../getting_started/px4_basic_concepts" />
docs/uk/getting_started/flight_reporting.md
+48
View File
@@ -0,0 +1,48 @@
# Політні звіти
PX4 реєструє детальний стан апарату і дані датчиків, які можна використовувати для аналізу проблем з продуктивністю.
У цій темі пояснюється, як ви можете завантажувати та аналізувати бортові журнали, а також ділитися ними з командою розробників.
:::tip
Keeping flight logs is a legal requirement in some jurisdictions.
:::
## Завантаження журналів з політного контролера
Logs can be downloaded using [QGroundControl](http://qgroundcontrol.com/): **[Analyze View > Log Download](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/log_download.html)**.
![Flight Log Download](../../assets/qgc/analyze/log_download.jpg)
## Аналіз журналів
Upload the log file to the online [Flight Review](http://logs.px4.io) tool.
Після завантаження вам буде надіслано посилання на сторінку аналізу журналу.
[Log Analysis using Flight Review](../log/flight_review.md) explains how to interpret the plots, and can help you to verify/reject the causes of common problems: excessive vibration, poor PID tuning, saturated controllers, imbalanced vehicles, GPS noise, etc.
:::info
There are many other great tools for visualising and analysing PX4 Logs.
For more information see: [Flight Analysis](../dev_log/flight_log_analysis.md).
:::
:::tip
If you have a constant high-rate MAVLink connection to the vehicle (not just a telemetry link) then you can use _QGroundControl_ to automatically upload logs directly to _Flight Review_.
For more information see [Settings > MAVLink Settings > MAVLink 2 Logging (PX4 only)](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/settings_view/mavlink.html#logging).
:::
## Надання доступу до файлів журналів розробникам PX4
The [Flight Review](http://logs.px4.io) log file link can be shared for discussion in the [support forums](../contribute/support.md#forums-and-chat) or a [Github issue](../index.md#reporting-bugs-issues).
## Конфігурація журналу
The logging system is configured by default to collect sensible logs for use with [Flight Review](http://logs.px4.io).
Logging may further be configured using the [SD Logging](../advanced_config/parameter_reference.md#sd-logging) parameters or with a file on the SD card.
Details on configuration can be found in the [logging configuration documentation](../dev_log/logging.md#configuration).
## Ключові посилання
- [Flight Review](http://logs.px4.io)
- [Log Analysis using Flight Review](../log/flight_review.md)
- [Flight Log Analysis](../dev_log/flight_log_analysis.md)
docs/uk/getting_started/led_meanings.md
+87
View File
@@ -0,0 +1,87 @@
# Значення LED індикаторів (Pixhawk Series)
[Pixhawk-series flight controllers](../flight_controller/pixhawk_series.md) use LEDs to indicate the current status of the vehicle.
- The [UI LED](#ui_led) provides user-facing status information related to _readiness for flight_.
- The [Status LEDs](#status_led) provide status for the PX4IO and FMU SoC.
Вони показують заряд, режим і стан завантажувача, а також помилки.
<a id="ui_led"></a>
## LED індикатори інтерфейсу
The RGB _UI LED_ indicates the current _readiness for flight_ status of the vehicle.
Зазвичай це дуже яскравий I2C, який може бути встановлений або не встановлений на платі політного контролера (наприклад. FMUv4 не має такого на борту, і зазвичай використовує світлодіод, встановлений на GPS).
На зображенні нижче показано взаємозв'язок між світлодіодом і станом апарату.
:::warning
It is possible to have a GPS lock (Green LED) and still not be able to arm the vehicle because PX4 has not yet [passed preflight checks](../flying/pre_flight_checks.md). **A valid global position estimate is required to takeoff!**
:::
:::tip
In the event of an error (blinking red), or if the vehicle can't achieve GPS lock (change from blue to green), check for more detailed status information in _QGroundControl_ including calibration status, and errors messages reported by the [Preflight Checks (Internal)](../flying/pre_flight_checks.md).
Також перевірте, чи правильно підключений GPS-модуль, чи правильно Pixhawk зчитує ваш GPS, і чи правильно GPS передає дані про місцеперебування.
:::
![LED meanings](../../assets/flight_controller/pixhawk_led_meanings.gif)
- **[Solid Blue] Armed, No GPS Lock:** Indicates vehicle has been armed and has no position lock from a GPS unit.
Коли апарат вмикається, PX4 розблоковує керування моторами, що дозволить вам керувати дроном.
Як завжди, будьте обережні під час увімкнення, оскільки великі гвинти можуть бути небезпечними на високих обертах.
У цьому режимі апарат не може виконувати керовані місії.
- **[Pulsing Blue] Disarmed, No GPS Lock:** Similar to above, but your vehicle is disarmed.
Це означає, що ви не зможете управляти моторами, але всі інші підсистеми працюють.
- **[Solid Green] Armed, GPS Lock:** Indicates vehicle has been armed and has a valid position lock from a GPS unit.
Коли апарат вмикається, PX4 розблоковує керування моторами, що дозволить вам керувати дроном.
Як завжди, будьте обережні під час увімкнення, оскільки великі гвинти можуть бути небезпечними на високих обертах.
У цьому режимі апарат може виконувати керовані місії.
- **[Pulsing Green] Disarmed, GPS Lock:** Similar to above, but your vehicle is disarmed.
Це означає, що ви не зможете управляти моторами, але всі інші підсистеми, включаючи GPS-фіксацію положення, працюють.
- **[Solid Purple] Failsafe Mode:** This mode will activate whenever vehicle encounters an issue during flight,
such as losing manual control, a critically low battery, or an internal error.
Під час аварійного режиму апарат намагатиметься повернутися до місця зльоту або може просто знизитися там, де він зараз перебуває.
- **[Solid Amber] Low Battery Warning:** Indicates your vehicle's battery is running dangerously low.
Після певного моменту пристрій перейде у failsafe режим. Однак цей режим повинен сигналізувати про те, що настав час завершити політ.
- **[Blinking Red] Error / Setup Required:** Indicates that your autopilot needs to be configured or calibrated before flying.
Під'єднайте автопілот до наземної станції керування, щоб перевірити, в чому проблема.
Якщо ви завершили процес налаштування, а автопілот все ще сигналізує червоним і блимає, можливо, виникла інша помилка.
<a id="status_led"></a>
## Індикатор стану
Three _Status LEDs_ provide status for the FMU SoC, and three more provide status for the PX4IO (if present).
Вони показують заряд, режим і стан завантажувача, а також помилки.
![Pixhawk 4](../../assets/flight_controller/pixhawk4/pixhawk4_status_leds.jpg)
Після ввімкнення живлення процесори FMU та PX4IO спочатку запускають завантажувач (BL), а потім додаток (APP).
У таблиці нижче показано, як завантажувач, а потім додаток використовують світлодіоди для індикації стану.
| Колір | Позначка | Використання завантажувача | Використання додатку |
| --------------------- | -------------------------------------------------- | ----------------------------------------- | -------------------- |
| Синій | ACT (активність) | Мерехтить, коли завантажувач отримує дані | Індикація стану ARM |
| Червоний/помаранчевий | B/E (в завантажувачі / помилка) | Мерехтить, коли в завантажувачі | Індикація ERROR |
| Зелений | PWR (потужність) | Не використовується в завантажувачі | Індикація стану ARM |
:::info
The LED labels shown above are commonly used, but might differ on some boards.
:::
Більш детальна інформація про те, як інтерпретувати світлодіодні індикатори, наведені нижче (де "х" означає "будь-який стан")
| Червоний/помаранчевий | Синій | Зелений | Значення |
| --------------------- | ----- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 10 Гц | x | x | Overload CPU load > 80%, or RAM usage > 98% |
| ВИМК | x | x | Overload CPU load <= 80%, or RAM usage <= 98% |
| NA | ВИМК | 4 Гц | actuator_armed->armed && failsafe |
| NA | УВІМК | 4 Гц | actuator_armed->armed && !failsafe |
| NA | ВИМК | 1 Гц | !actuator_armed-> armed && actuator_armed->ready_to_arm |
| NA | ВИМК | 10 Гц | !actuator_armed->armed && !actuator_armed->ready_to_arm |
docs/uk/getting_started/px4_basic_concepts.md
+387
View File
@@ -0,0 +1,387 @@
# Основні поняття
Цей розділ надає базовий вступ до безпілотників та використання PX4 (призначений в основному для користувачів початківців, але також є хорошим введенням для досвідчених користувачів).
If you are already familiar with the basic concepts, you can move on to [Basic Assembly](../assembly/index.md) to learn how to wire your specific autopilot hardware.
To load firmware and set up the vehicle with _QGroundControl_, see [Basic Configuration](../config/index.md).
## Що таке безпілотник?
Безпілотник, або Безпілотні Транспортні Засоби (БТЗ), - це безпілотний "роботизований" рухомий засіб, яким можна дистанційно або автономно керувати.
They can travel in air, on the ground, on/under the water, and are used for many [consumer, industrial, government and military applications](https://px4.io/ecosystem/commercial-systems/), including aerial photography/video, carrying cargo, racing, search and surveying, and so on.
Дрони більш формально називаються Безпілотними Повітряними Літальними Апаратами (UAV), Безпілотними Наземними Транспортними Засобами (UGV), Безпілотними Надводними Транспортними Засобами (USV), Безпілотними Підводними Транспортними Засобами (UUV).
:::info
The term Unmanned Aerial System (UAS) typically refers to a UAV and all of the other components of a complete system, including a ground control station and/or radio controller, and any other systems used to control the drone, capture, and process data.
:::
## Типи дронів
Існує багато різних рам автомобілів (типів), і всередині типів є багато варіацій.
Деякі типи, разом з використанням для яких вони найбільш підходять, перераховані нижче.
- [Multicopters](../frames_multicopter/index.md) — Multi-rotors offer precision hovering and vertical takeoff, at the cost of shorter and generally slower flight.
Вони є найпопулярнішим типом літаючого транспорту, частково через те, що їх легко складати, і PX4 має режими, які роблять їх легкими у керуванні та дуже підходять як платформа для камери.
- [Helicopters](../frames_helicopter/index.md) — Helicopters similar benefits to Multicopters but are mechanically more complex and more efficient.
Також їм набагато складніше літати.
- [Planes (Fixed-wing)](../frames_plane/index.md) — Fixed-wing vehicles offer longer and faster flight than multicopters, and hence better coverage for ground surveys etc.
However they are harder to fly and land than multicopters, and aren't suitable if you need to hover or fly very slowly (e.g. when surveying vertical structures).
- [VTOL](../frames_vtol/index.md) (Vertical Takeoff and Landing) - Hybrid Fixed-wing/Multicopter vehicles offer the best of both worlds: take off in vertical mode and hover like a multicopter but transition to forward flight like an airplane to cover more ground.
Апарати VTOL часто дорожчі за мультикоптери або апарати літакового типу, а також їх важче збирати та налаштовувати.
Вони існують у ряді типів: тілтротори, тейлсітери, квадроплани тощо.
- [Airships](../frames_airship/index.md)/[Balloons](../frames_balloon/index.md) — Lighter-than-air vehicles that typically offer high altitude long duration flight, often at the cost of having limited (or no) control over speed and direction of flight.
- [Rovers](../frames_rover/index.md) — Car-like ground vehicles.
Вони прості в керуванні та часто приємні у використанні.
Вони не можуть рухатися так швидко, як більшість повітряних суден, але можуть нести важчі вантажі, і не використовують багато енергії, коли стоять.
- **Boats** — Water-surface vehicles.
- [Submersibles](../frames_sub/index.md) — Underwater vehicles.
Для додаткової інформації дивіться:
- [Vehicle Types & Setup](../airframes/index.md)
- [Airframe setup](../config/airframe.md)
- [Airframe Reference](../airframes/airframe_reference.md).
## Автопілоти
"Мізками" дрону є автопілот.
It minimally consists of _flight stack_ software running on a real time OS ("RTOS") on _flight controller_ (FC) hardware.
Політний стек забезпечує основну стабілізацію та функції безпеки, а зазвичай також певний рівень допомоги пілоту для ручного польоту та автоматизації загальних завдань, таких як зліт, посадка та виконання попередньо визначених місій.
Деякі автопілоти також включають універсальну обчислювальну систему, яка може забезпечувати "вищий рівень" управління та контролю, а також підтримувати більш просунуті мережеві технології, машинний зір та інші можливості.
This might be implemented as a separate [companion computer](#offboard-companion-computer), but in future it is increasingly likely to be a fully integrated component.
## Політний стек PX4
[PX4](https://px4.io/) is powerful open source autopilot _flight stack_ running on the NuttX RTOS.
Деякі ключові можливості PX4:
- Supports many different vehicle frames/types, including: [multicopters](../frames_multicopter/index.md), [fixed-wing aircraft](../frames_plane/index.md) (planes), [VTOLs](../frames_vtol/index.md) (hybrid multicopter/fixed-wing), [ground vehicles](../frames_rover/index.md), and [underwater vehicles](../frames_sub/index.md).
- Great choice of drone components for [flight controller](#flight-controller), [sensors](#sensors), [payloads](#payloads), and other peripherals.
- Flexible and powerful [flight modes](#flight-modes) and [safety features](#safety-settings-failsafe).
- Robust and deep integration with [companion computers](#offboard-companion-computer) and [robotics APIs](../robotics/index.md) such as [ROS 2](../ros2/user_guide.md) and [MAVSDK](http://mavsdk.mavlink.io).
PX4 is a core part of a broader drone platform that includes the [QGroundControl](#qgc) ground station, [Pixhawk hardware](https://pixhawk.org/), and [MAVSDK](http://mavsdk.mavlink.io) for integration with companion computers, cameras and other hardware using the MAVLink protocol.
PX4 is supported by the [Dronecode Project](https://www.dronecode.org/).
## Наземні станції керування
Станції земного контролю (GCS) - це системи на землі, які дозволяють операторам УЗ контролювати і керувати безпілотником та його вантажем.
Підмножина продуктів, які відомо, що працюють з PX4, перераховані нижче.
### QGroundControl {#qgc}
The Dronecode GCS software is called [QGroundControl](http://qgroundcontrol.com/) ("QGC").
Він працює на апаратному забезпеченні Windows, Android, MacOS або Linux і підтримує широкий спектр форм факторів екрану.
You can download it (for free) from [here](http://qgroundcontrol.com/downloads/).
![QGC Main Screen](../../assets/concepts/qgc_fly_view.png)
QGroundControl communicates with the drone using a telemetry radio (a bidirectional data link), which allows you to get real-time flight and safety information, and to control the vehicle, camera, and other payloads using a point-and-click interface.
На апаратному забезпеченні, яке їх підтримує, ви також можете вручну керувати транспортним засобом за допомогою джойстиків.
QGC також може бути використаний для візуального планування, виконання та моніторингу автономних місій, встановлення геозахисту та багато іншого.
Настільні версії QGroundControl також використовуються для встановлення (прошивки) PX4 та налаштування PX4 на автопілоті/контролері польоту дрона.
### Auterion Mission Control (AMC) {#amc}
[Auterion Mission Control](https://auterion.com/product/mission-control/) is a powerful and fully featured ground control station application that is optimized for _pilots_ rather than vehicle configuration.
Хоча призначений для роботи з продуктами Auterion, його можна використовувати з "ванільним" PX4.
Для додаткової інформації дивіться:
- [AMC docs](https://docs.auterion.com/vehicle-operation/auterion-mission-control)
- [Download from Auterion Suite](https://suite.auterion.com/)
## Drone Components & Parts
### Політний контролер
Контролери польоту (FC) - це апаратне забезпечення, на яке завантажується та виконується прошивка стеку польоту PX4.
Вони підключені до датчиків, за допомогою яких PX4 визначає свій стан, а також до виконавчих пристроїв/двигунів, які він використовує для стабілізації та переміщення транспортного засобу.
<img src="../../assets/flight_controller/cuav_pixhawk_v6x/pixhawk_v6x.jpg" width="230px" title="CUAV Pixhawk 6X" >
PX4 can run on many different types of [Flight Controller Hardware](../flight_controller/index.md), ranging from [Pixhawk Series](../flight_controller/pixhawk_series.md) controllers to Linux computers.
These include [Pixhawk Standard](../flight_controller/autopilot_pixhawk_standard.md) and [manufacturer-supported](../flight_controller/autopilot_manufacturer_supported.md) boards.
Вам слід обирати плату, яка відповідає фізичним обмеженням вашого апарату, видам діяльності, які ви хочете виконувати та, за вартістю.
For more information see: [Flight Controller Selection](flight_controller_selection.md)
### Датчики
Системи на основі PX4 використовують датчики для визначення стану транспортного засобу, який їй потрібен для стабілізації транспортного засобу та увімкнення автономного керування.
Стани транспортного засобу включають: позицію/висоту, курс, швидкість, швидкість польоту, орієнтацію (відносно чогось), швидкість обертання в різних вісях, рівень заряду батареї тощо.
PX4 _minimally requires_ a [gyroscope](../sensor/gyroscope.md), [accelerometer](../sensor/accelerometer.md), [magnetometer](../gps_compass/magnetometer.md) (compass) and [barometer](../sensor/barometer.md).
This minimal set of sensors is incorporated into [Pixhawk Series](../flight_controller/pixhawk_series.md) flight controllers (and may also be in other controller platforms).
До контролера можна приєднати додаткові/зовнішні датчики.
The following sensors are recommended:
- A [GNSS/GPS](../gps_compass/index.md) or other source of global position is needed to enable all automatic modes, and some manual/assisted modes.
Typically a module that combines a GNSS and Compass is used, as an external compass can be made less susceptible to electromomagnetic interference than the internal compass in the flight controller.
- [Airspeed sensors](../sensor/airspeed.md) are highly recommended for fixed-wing and VTOL-vehicles.
- [Distance Sensors \(Rangefinders\)](../sensor/rangefinders.md) are highly recommended for all vehicle types, as they allow smoother and more robust landings, and enable features such as terrain following on multicopters.
- [Optical Flow Sensors](../sensor/optical_flow.md) can be used with distance sensors on multcopters and VTOL to support navigation in GNSS-denied environments.
For more information about sensors see: [Sensor Hardware & Setup](../sensor/index.md).
### Виводи: Двигуни, Сервоприводи, Актуатори, або приводи
PX4 uses _outputs_ to control: motor speed (e.g. via [ESC](#escs-motors)), flight surfaces like ailerons and flaps, camera triggers, parachutes, grippers, and many other types of payloads.
The outputs may be PWM ports or DroneCAN nodes (e.g. DroneCAN [motor controllers](../dronecan/escs.md)).
The images below show the PWM output ports for [Pixhawk 4](../flight_controller/pixhawk4.md) and [Pixhawk 4 mini](../flight_controller/pixhawk4_mini.md).
![Pixhawk 4 output ports](../../assets/flight_controller/pixhawk4/pixhawk4_main_aux_ports.jpg) ![Pixhawk4 mini MAIN ports](../../assets/flight_controller/pixhawk4mini/pixhawk4mini_pwm.png)
The outputs are divided into `MAIN` and `AUX` outputs, and individually numbered (i.e. `MAINn` and `AUXn`, where `n` is 1 to usually 6 or 8).
They might also be marked as `IO PWM Out` and `FMU PWM OUT` (or similar).
:::warning
A flight controller may only have `MAIN` PWM outputs (like the _Pixhawk 4 Mini_), or may have only 6 outputs on either `MAIN` or `AUX`.
Ensure that you select a controller that has enough ports/outputs for your [airframe](../airframes/airframe_reference.md).
:::
You can connect almost any output to any motor or other actuator, by assigning the associated function ("Motor 1") to the desired output ("AUX1") in QGroundControl: [Actuator Configuration and Testing](../config/actuators.md).
Note that the functions (motor and control surface actuator positions) for each frame are given in the [Airframe Reference](../airframes/airframe_reference.md).
**Notes:**
- Pixhawk controllers have an FMU board and _may_ have a separate IO board.
If there is an IO board, the `AUX` ports are connected directly to the FMU and the `MAIN` ports are connected to the IO board.
Otherwise the `MAIN` ports are connected to the FMU, and there are no `AUX` ports.
- The FMU output ports can use [D-shot](../peripherals/dshot.md) or _One-shot_ protocols (as well as PWM), which provide much lower-latency behaviour.
Це може бути корисним для тих хто займається перегонами та інших планерів які потребують кращої ефективності.
- There are only 6-8 outputs in `MAIN` and `AUX` because most flight controllers only have this many PWM/Dshot/Oneshot outputs.
В теорії може бути більше виводів, якщо шина підтримує це (наприклад UAVCAN не обмежена такою малою кількістю вузлів).
### ESCs & Motors
Багато безпілотників на базі P4X використовують безколекторні електродвигуни, які керуються польотним контролером через електронний регулятор швидкості (ECS) (ECS перетворює сигнал з політного контролера у відповідний рівень потужності, що передається на мотор).
Для отримання інформації про те, які ESC/мотори підтримуються PX4 дивіться:
- [ESC & Motors](../peripherals/esc_motors.md)
- [ESC Calibration](../advanced_config/esc_calibration.md)
- [ESC Firmware and Protocols Overview](https://oscarliang.com/esc-firmware-protocols/) (oscarliang.com)
### Батарея/Живлення
Безпілотники на базі PX4 найчастіше працюють від літій-полімерних акумуляторів (LiPo).
The battery is typically connected to the system using a [Power Module](../power_module/index.md) or _Power Management Board_, which provide separate power for the flight controller and to the ESCs (for the motors).
Information about batteries and battery configuration can be found in [Battery Estimation Tuning](../config/battery.md) and the guides in [Basic Assembly](../assembly/index.md) (e.g. [Pixhawk 4 Wiring Quick Start > Power](../assembly/quick_start_pixhawk4.md#power)).
### Ручне керування
Pilots can control a vehicle manually using either a [Radio Control (RC) System](../getting_started/rc_transmitter_receiver.md) or a [Joystick/Gamepad](../config/joystick.md) controller connected via QGroundControl.
![Taranis X9D Transmitter](../../assets/hardware/transmitters/frsky_taranis_x9d_transmitter.jpg) <img src="../../assets/peripherals/joystick/micronav.jpg" alt="Photo of MicroNav, a ground controller with integrated joysticks" width="400px">
Системи радіокерування використовують спеціалізований наземний радіопередавач та приймач на апараті для передачі сигналів керування.
Вони завжди повинні використовуватися, коли ви вперше налаштовуєте/тестуєте нову конструкцію рами або під час польотів на перегонах / акробатичних польотах (та інших випадках коли важлива мала затримка).
Системи з джойстиком використовують QGroundControl для кодування інформації керування з "стандартного" ігрового джойстика комп'ютера у повідомлення MAVLink та надсилають її до апарату за допомогою (спільного) радіоканалу телеметрії.
Вони можуть використовуватися для більшості випадків ручного польоту, таких як зліт, обстеження тощо, за умови, що ваш канал телеметрії має достатньо високу пропускну спроможність / низьку затримку.
Джойстики часто використовуються в інтегрованих GCS / системах ручного керування, тому що інтеграція джойстика дешевша та простіша, ніж окремої системи радіокерування, і для більшості випадків використання нижча затримка не має значення.
Вони також ідеально підходять для польотів у симуляторі PX4, оскільки їх можна безпосередньо під'єднати до вашого комп'ютера наземної станції керування.
:::info
PX4 does not _require_ a manual control system for autonomous flight modes.
:::
### Запобіжний перемикач
Vehicles may include a _safety switch_ that must be engaged before the vehicle can be [armed](#arming-and-disarming) (when armed, motors are powered and propellers can turn).
This switch is almost always integrated into the [GPS](../gps_compass/index.md) module that is connected to the Pixhawk `GPS1` port — along with the [buzzer](#buzzer) and [UI LED](#leds).
The switch may be disabled by default, though this depends on the particular flight controller and airframe configuration.
You can disable/enable use of the switch with the [CBRK_IO_SAFETY](../advanced_config/parameter_reference.md#CBRK_IO_SAFETY) parameter.
:::info
Safety switches are optional.
Many argue that it is safer for users never to approach a powered system, even to enable/disable this interlock.
:::
### Зумер
Vehicles commonly include a buzzer for providing audible notification of vehicle state and readiness to fly (see [Tune meanings](../getting_started/tunes.md)).
This buzzer is almost always integrated into the [GPS](../gps_compass/index.md) module that is connected to the Pixhawk `GPS1` port — along with the [safety switch](#safety-switch) and [UI LED](#leds).
You can disable the notification tunes using the parameter [CBRK_BUZZER](../advanced_config/parameter_reference.md#CBRK_BUZZER).
### Світлодіоди
Vehicles should have a superbright [UI RGB LED](../getting_started/led_meanings.md#ui-led) that indicates the current readiness for flight.
Historically this was included in the flight controller board.
On more recent flight controllers this is almost always an [I2C peripheral](../sensor_bus/i2c_general.md) integrated into the [GPS](../gps_compass/index.md) module that is connected to the Pixhawk `GPS1` port — along with the [safety switch](#safety-switch) and [buzzer](#buzzer).
### Радіопередавачі даних/телеметрії
[Data/Telemetry Radios](../telemetry/index.md) can provide a wireless MAVLink connection between a ground control station like _QGroundControl_ and a vehicle running PX4.
Це дозволяє налаштовувати параметри, коли транспортний засіб в польоті, перевіряти телеметрію в режимі реального часу, змінювати політне завдання на льоту тощо.
### Бортовий / Супутній комп'ютер
A [Companion Computer](../companion_computer/index.md) (also referred to as "mission computer" or "offboard computer"), is a separate on-vehicle computer that communicates with PX4 to provide higher level command and control.
Супутній комп'ютер зазвичай працює на Linux, оскільки це краща платформа для розробки програмного забезпечення та дозволяє безпілотникам отримувати перевагу від наявності передвстановленого програмного забезпечення для машинного зору, мережевої взаємодії тощо.
Політний контролер та супутній комп'ютер можуть бути інтегровані на одній платі, полегшуючи розробку апаратного забезпечення, чи бути окремими пристроями, під'єднаними через serial кабель, Ethernet кабель чи WiFi.
The companion computer typically communicates with PX4 using a high level Robotics API such as [MAVSDK](https://mavsdk.mavlink.io/) or [ROS 2](../ros2/user_guide.md).
Відповідні теми:
- [Companion Computers](../companion_computer/index.md)
- [Off-board Mode](../flight_modes/offboard.md) - Flight mode for offboard control of PX4 from a GCS or companion computer.
- [Robotics APIs](../robotics/index.md)
### SD-карти (знімна пам'ять)
PX4 uses SD memory cards for storing [flight logs](../getting_started/flight_reporting.md), and they are also required in order to use UAVCAN peripherals and fly [missions](../flying/missions.md).
By default, if no SD card is present PX4 will play the [format failed (2-beep)](../getting_started/tunes.md#format-failed) tune twice during boot (and none of the above features will be available).
:::tip
The maximum supported SD card size on Pixhawk boards is 32GB.
The _SanDisk Extreme U3 32GB_ and _Samsung EVO Plus 32_ are [highly recommended](../dev_log/logging.md#sd-cards).
:::
SD карти, однак, не обов'язкові.
Політні контролери, які не містять слот для SD карти, можуть:
- Disable notification beeps are disabled using the parameter [CBRK_BUZZER](../advanced_config/parameter_reference.md#CBRK_BUZZER).
- [Stream logs](../dev_log/logging.md#log-streaming) to another component (companion).
- Зберігати місії в RAM/FLASH.
<!-- Too low-level for this. But see FLASH_BASED_DATAMAN in Intel Aero: https://github.com/PX4/PX4-Autopilot/blob/main/boards/intel/aerofc-v1/src/board_config.h#L115 -->
## Корисне навантаження
Корисне навантаження — це обладнання, яке переноситься апаратом для досягнення цілей користувача або місії, такі як камери в місіях з обстеження, інструменти, що використовуються для інспектування, наприклад, детектори радіації, та вантаж, який потрібно доставити.
PX4 підтримує багато камер та широкий спектр корисних навантажень.
Payloads are connected to [Flight Controller outputs](#outputs-motors-servos-actuators), and can be triggered automatically in missions, or manually from an RC Controller or Joystick, or from a Ground Station (via MAVLink/MAVSDK commands).
For more information see: [Payloads & Cameras](../payloads/index.md)
## Увімкнення та вимкнення
A vehicle is said to be _armed_ when all motors and actuators are powered, and _disarmed_ when nothing is powered.
There is also a _prearmed_ state when only servo actuators are powered, which is primarily used for testing.
A vehicle is usually disarmed on the ground, and must be armed before taking off in the current flight mode.
:::warning
Armed vehicles are dangerous because propellers can start spinning at any time without further user input, and in many cases will start spinning immediately.
:::
Arming and disarming are triggered by default using RC stick _gestures_.
On Mode 2 transmitters you arm by holding the RC throttle/yaw stick on the _bottom right_ for one second, and to disarm you hold the stick on bottom left for one second.
Також альтернативно є можливість налаштувати PX4 для увімкнення за допомогою RC перемикача або кнопки (й можна відправляти MAVLink команди увімкнення з наземної станції).
Для зменшення нещасних випадків, коли рухомі засоби на землі, вони повинні бути увімкненими якомога менше часу.
За замовчуванням рухомі засоби:
- _Disarmed_ or _Prearmed_ (motors unpowered) when not in use, and must be explicitly _armed_ before taking off.
- Автоматично перемикаються у стан disarmed/prearmed якщо засіб не злетів достатньо швидко після увімкнення (час перемикання налаштовується).
- Автоматично перемикаються у стан disarmed/prearmed незабаром після посадки (час налаштовується).
- Увімкнення запобігається, якщо засіб не в "нормальному" стані.
- Arming is prevented if the vehicle has a [safety switch](#safety-switch) that has not been engaged.
- Arming is prevented if a VTOL vehicle is in fixed-wing mode ([by default](../advanced_config/parameter_reference.md#CBRK_VTOLARMING)).
- Arming may be prevented due to a number of other optional [arming pre-condition settings](../config/safety.md#arming-pre-conditions), such as low battery.
В стані prearmed можна користуватись приводами, тоді як disarmed вимикає усе живлення.
Prearmed та disarmed стани є безпечними, а конкретний рухомий засіб може підтримувати один зі станів або обидва.
:::tip
Sometimes a vehicle will not arm for reasons that are not obvious.
QGC v4.2.0 (Daily build at time of writing) and later provide an arming check report in [Fly View > Arming and Preflight Checks](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/fly_view/fly_view.html#arm).
Починаючи з PX4 v1.14 це забезпечує комплексну інформацію про проблеми увімкнення разом з можливими рішеннями.
:::
A detailed overview of arming and disarming configuration can be found here: [Prearm, Arm, Disarm Configuration](../advanced_config/prearm_arm_disarm.md).
## Режими польоту
Modes are special operational states that provide different types/levels of vehicle automation and autopilot assistance to the user (pilot).
_Autonomous modes_ are fully controlled by the autopilot, and require no pilot/remote control input.
These are used, for example, to automate common tasks like takeoff, returning to the home position, and landing.
Other autonomous modes execute pre-programmed missions, follow a GPS beacon, or accept commands from an offboard computer or ground station.
_Manual modes_ are controlled by the user (via the RC control sticks/joystick) with assistance from the autopilot.
Different manual modes enable different flight characteristics - for example, some modes enable acrobatic tricks,
while others are impossible to flip and will hold position/course against wind.
:::tip
Not all modes are available on all vehicle types, and some modes can only be used when specific conditions have been met (e.g. many modes require a global position estimate).
:::
An overview of the flight modes implemented within PX4 for each vehicle can be found below:
- [Flight Modes (Multicopter)](../flight_modes_mc/index.md)
- [Flight Modes (Fixed-Wing)](../flight_modes_fw/index.md)
- [Flight Modes (VTOL)](../flight_modes_vtol/index.md)
- [Drive Modes (Differential Rover)](../flight_modes_rover/differential.md)
- [Drive Modes (Ackermann Rover)](../flight_modes_rover/ackermann.md)
Instructions for how to set up your remote control switches to enable different flight modes is provided in [Flight Mode Configuration](../config/flight_mode.md).
PX4 also supports external modes implemented in [ROS 2](../ros2/index.md) using the [PX4 ROS 2 Control Interface](../ros2/px4_ros2_control_interface.md).
These are indistinguishable from PX4 internal modes, and can be used to override internal modes with a more advanced version, or to create entirely new functionality.
Note that these depend on ROS 2 and can therefore only run on systems that have a [companion computer](#offboard-companion-computer).
## Налаштування безпеки (Відмовостійкість)
PX4 має системи відмовостійкості, які можна налаштувати для захисту та повернення вашого засобу якщо щось піде не так!
Вони дозволяють вам вказати території й умови, за яких можна безпечно літати, а також дію, що буде виконуватися, якщо відбудеться умова запобігання відмові (наприклад, посадка, утримання позиції або повернення до зазначеної точки).
:::info
You can only specify the action for the _first_ failsafe event.
Як тільки запобіжна подія станеться, система перейде в режим спеціального виконання таким чином, що наступні тригери запобігання відмові будуть управлятися окремим рівнем системи та кодом притаманним конкретному рухомому засобу.
:::
Основні запобіжні випадки перераховані нижче:
- Низький заряд батареї
- Втрата дистанційного керування (RC)
- Втрата позиції (якість глобальної оцінки позиції занадто низька).
- Втрата бортового комп'ютера (наприклад втрата зв'язку із супутнім комп'ютером)
- Втрата каналу даних (наприклад втрата з'єднання телеметрії з GCS).
- Порушення геозони (обмеження польоту апарату у віртуальному циліндрі).
- Запобігання відмові місії (запобігає запуску попередньої місії під час зльоту з нової локації).
- Уникнення трафіку (викликається даними з, наприклад ADSB транспондера).
For more information see: [Safety](../config/safety.md) (Basic Configuration).
## Курс та напрямок руху
Усі транспортні засоби, човни та літаки мають напрям курсу або орієнтацію, що базується на їхньому русі вперед.
![Frame Heading](../../assets/concepts/frame_heading.png)
:::info
For a VTOL Tailsitter the heading is relative to the multirotor configuration (i.e. vehicle pose during takeoff, hovering, landing).
:::
Важливо знати напрямок курсу рухомого засобу з метою приведення автопілота у відповідність з вектором руху.
Мультикоптери мають напрямок руху навіть якщо вони симетричні з усіх боків!
Usually manufacturers use a coloured props or coloured arms to indicate the heading.
![Frame Heading TOP](../../assets/concepts/frame_heading_top.png)
In our illustrations we will use red colouring for the front propellers of multicopter to show heading.
You can read in depth about heading in [Flight Controller Orientation](../config/flight_controller_orientation.md)
docs/uk/getting_started/rc_transmitter_receiver.md
+171
View File
@@ -0,0 +1,171 @@
# Системи радіо керування
A Radio Control (RC) system can be used to _manually_ control your vehicle from a handheld RC controller.
У цьому розділі наведено огляд того, як працює RC система, як вибрати відповідну радіосистему для вашого засобу, і як під'єднати її до політного контролера.
:::tip
PX4 can also be manually controlled using a [Joystick](../config/joystick.md) or gamepad-like controller: this is different to an RC system!
The [COM_RC_IN_MODE](../advanced_config/parameter_reference.md#COM_RC_IN_MODE) parameter [can be set](../advanced_config/parameters.md) to choose whether RC (default), Joystick, both, or neither, are enabled.
:::
:::info
PX4 does not require a remote control system for autonomous flight modes.
:::
## Як працюють системи радіо керування?
An _RC system_ has a ground-based _remote control unit_ that is used by the operator to command the vehicle.
The remote has physical controls that can be used to specify vehicle movement (e.g. speed, direction, throttle, yaw, pitch, roll, etc.) and to enable autopilot [flight modes](../flight_modes/index.md) (e.g. takeoff, land, return to land, mission etc.).
On _telemetry-enabled_ RC systems, the remote control unit can also receive and display information from the vehicle, such as battery level, flight mode, and warnings.
![Taranis X9D Transmitter](../../assets/hardware/transmitters/frsky_taranis_x9d_transmitter.jpg)
Наземний RC контролер містить радіомодуль, який пов'язаний із (сумісним) радіомодулем у рухомому засобі та спілкується з ним.
Пристрій радіомодуля на апараті під'єднано до політного контролера.
Політний контролер визначає як інтерпретувати команди в залежності від поточного режиму польоту автопілота і відповідно керує моторами та приводами апарату.
<!-- image showing the different parts here would be nice -->
:::info
The ground- and vehicle- based radio modules are referred to as the transmitter and receiver respectively (even if they support bidirectional communication) and are collectively referred to as a _transmitter/receiver pair_.
RC контролер та включений в нього радіомодуль часто називають просто "передавачем".
:::
Важлива якість RC системи це кількість "каналів", яку вона підтримує.
Кількість каналів визначає скільки різних фізичних елементів керування на пульті можна використовувати для відправлення команд рухомому засобу (наприклад скільки перемикачів, стіків керування можна використовувати).
Літальний апарат повинен використовувати систему, яка підтримує щонайменше 4 канали (для крену, тангажу, рискання, тяги).
Наземні транспортні засоби потребують не менше двох каналів (кермо + газ). An 8 or 16 channel transmitter provides additional channels that can be used to control other mechanisms or activate different [flight modes](../flight_modes/index.md) provided by the autopilot.
## Типи пристроїв дистанційного керування
<a id="transmitter_modes"></a>
### Пристрої керування для літальних апаратів
The most popular _form_ of remote control unit for UAVs is shown below.
Як можна бачити, він має окремі стіки керування для крену/тангажу та для тяги/рискання (тобто літальний апарат потребує принаймні 4 канали).
![RC Basic Commands](../../assets/flying/rc_basic_commands.png)
Існує багато можливих розташувань для стіків керування, перемикачів і т. ін.
Найпоширеніші розташування мають власний номер "режиму". _Mode 1_ and _Mode 2_ (shown below) differ only in the placement of the throttle.
![Mode1-Mode2](../../assets/concepts/mode1_mode2.png)
:::info
The choice of mode is largely one of taste (_Mode 2_ is more popular).
:::
## Пристрої керування для наземних засобів
Безпілотний наземний транспортний засіб (UGV)/автомобіль мінімально потребує передавача з 2 каналами для того, щоб передавати дані для керування та швидкості.
Часто передавачі задають ці дані за допомогою колеса та тригера, двох одновісних стіків керування або одного двовісного стіку.
Вам ніщо не заважає користуватися додатковими каналами або механізмами керування і це може бути дуже корисно для залучення додаткових приводів та режимів автопілота.
## Вибір компонентів RC системи
Вам необхідно буде обрати пару передача/приймача сумісних між собою.
In addition, receivers have to be [compatible with PX4](#compatible_receivers) and the flight controller hardware.
Сумісні радіосистеми часто продаються разом.
For example, [FrSky Taranis X9D and FrSky X8R](https://hobbyking.com/en_us/frsky-2-4ghz-accst-taranis-x9d-plus-and-x8r-combo-digital-telemetry-radio-system-mode-2.html?___store=en_us) are a popular combination.
### Пари передавач/приймач
One of the most popular RC units is the _FrSky Taranis X9D_.
It has an internal transmitter module can be used with the recommended _FrSky X4R-SB_ (S-BUS, low delay) or _X4R_ (PPM-Sum, legacy) receivers out of the box.
Він також має спеціальний роз'єм для радіо передавача та прошивку з відкритим кодом OpenTX яку можна налаштувати.
:::info
This remote control unit can display vehicle telemetry when used with [FrSky](../peripherals/frsky_telemetry.md) or [TBS Crossfire](../telemetry/crsf_telemetry.md) radio modules.
:::
Інші популярні пари передавач/приймач
- Пульт Turnigy з, наприклад, парою передавач/приймач FrSky.
- Передавачі Futaba та сумісні S-Bus приймачі Futaba.
- Передавачі на далеку відстань у діапазоні ~900МГц з низькою затримкою: набори "Team Black Sheep Crossfire" або "Crossfire Micro" із сумісним пультом (наприклад Taranis)
- Передавач на далеку відстань у діапазоні ~433МГц: набір ImmersionRC EzUHF із сумісним пультом (наприклад Taranis)
### PX4-Compatible Receivers {#compatible_receivers}
На додачу до пари передавач/приймач, приймач також повинен бути сумісним з PX4 та політним контролером.
_PX4_ and _Pixhawk_ have been validated with:
- PPM sum receivers
- S.BUS and S.BUS2 receivers from:
- Futaba
- FrSky S.BUS and PPM models
- TBS Crossfire with SBUS as output protocol
- Herelink
- TBS Crossfire with ([CRSF protocol](../telemetry/crsf_telemetry.md))
- Express LRS with ([CRSF protocol](../telemetry/crsf_telemetry.md))
- TBS Ghost with (GHST protocol)
- Spektrum DSM
- Graupner HoTT
Receivers from other vendors that use a supported protocol are likely to work but have not been tested.
:::info
Historically there were differences and incompatibilities between receiver models, largely due to a lack of detailed specification of protocols.
The receivers we have tested all now appear to be compatible, but it is possible that others may not be.
:::
## Підключення приймачів
Як загальне правило: приймачі з'єднуються з політним контролером використовуючи порт відповідного протоколу що ним підтримується:
- Spektrum/DSM receivers connect to the "DSM" input.
Pixhawk flight controllers variously label this as: `SPKT/DSM`, `DSM`, `DSM/SBUS RC`, `DSM RC`, `DSM/SBUS/RSSI`.
- Graupner HoTT receivers: SUMD output must connect to a **SPKT/DSM** input (as above).
- PPM-Sum and S.BUS receivers must connect directly to the **RC** ground, power and signal pins.
This is typically labeled: `RC IN`, `RCIN` or `RC`, but has in some FCs has been labeled `PPM RC` or `PPM`.
- PPM receivers that have an individual wire for each channel must connect to the RCIN channel _via_ a PPM encoder [like this one](http://www.getfpv.com/radios/radio-accessories/holybro-ppm-encoder-module.html) (PPM-Sum receivers use a single signal wire for all channels).
- TBS Crossfire/Express LRS Receivers using [CRSF Telemetry](../telemetry/crsf_telemetry.md) connect via a spare UART.
Flight controllers usually include appropriate cables for connecting common receiver types.
Instructions for connecting to specific flight controllers are given in their [quick-start](../assembly/index.md) guides (such as [CUAV Pixhawk V6X Wiring Quick Start: Radio Control](../assembly/quick_start_cuav_pixhawk_v6x.md#radio-control) or [Holybro Pixhawk 6X Wiring Quick Start: Radio Control](../assembly/quick_start_pixhawk6x.md#radio-control)).
:::tip
See the manufacturer's flight controller setup guide for additional information.
:::
<a id="binding"></a>
## Прив'язка передавача/приймача
Before you can calibrate/use a radio system you must _bind_ the receiver and transmitter so that they communicate only with each other.
Процес прив'язки пари передавача та приймача залежить від апаратного забезпечення (дивіться посібник користувача для інструкцій).
If you are using a _Spektrum_ receiver, you can put it into bind mode using _QGroundControl_: [Radio Setup > Spectrum Bind](../config/radio.md#spectrum-bind).
## Налаштування поведінки при втраті сигналу
У RC приймачів є різні способи визначення втрати сигналу:
- Відсутній вивід (автоматично виявляється PX4)
- Output a low throttle value (you can [configure PX4 to detect this](../config/radio.md#rc-loss-detection)).
- Виводиться останній отриманий сигнал (PX4 не може впоратися з цим випадком!)
Виберіть приймач, який може нічого не виводити коли RC втрачається (бажано) або виводить низьке значення газу.
Ця поведінка може вимагати налаштування апаратного забезпечення приймача (перевірте інструкцію користувача).
For more information see [Radio Control Setup > RC Loss Detection](../config/radio.md#rc-loss-detection).
## Пов'язані теми
- [Radio Control Setup](../config/radio.md) - Configuring your radio with PX4.
- Manual Flying on [multicopter](../flying/basic_flying_mc.md) or [fixed wing](../flying/basic_flying_fw.md) - Learn how to fly with a remote control.
- [TBS Crossfire (CRSF) Telemetry](../telemetry/crsf_telemetry.md)
- [FrSky Telemetry](../peripherals/frsky_telemetry.md)
docs/uk/getting_started/tunes.md
+198
View File
@@ -0,0 +1,198 @@
# Значення мелодії (серія Pixhawk)
[Pixhawk-series flight controllers](../flight_controller/pixhawk_series.md) use audible tones/tunes from a [buzzer](../getting_started/px4_basic_concepts.md#buzzer) and colours/sequences from a [LED](../getting_started/led_meanings.md) to indicate vehicle state and events (e.g. arming success and failure, low battery warnings).
Набір стандартних звуків наведено нижче.
:::info
**Developers:** Tunes are defined in [/lib/tunes/tune_definition.desc](https://github.com/PX4/PX4-Autopilot/blob/main/src/lib/tunes/tune_definition.desc) and can be tested using the [tune-control](../modules/modules_system.md#tune-control) module.
You can search for tune use using the string `TUNE_ID_name`(e.g. \`TUNE_ID_PARACHUTE_RELEASE)
:::
## Завантаження/запуск
Ці мелодії відтворюються під час завантаження.
<!-- https://github.com/PX4/PX4-Autopilot/blob/main/ROMFS/px4fmu_common/init.d/rcS -->
#### Сигнал запуску
<audio controls><source src="../../assets/tunes/1_startup_tone.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- tune: 1, STARTUP -->
- microSD card successfully mounted (during boot).
#### Error Tune
<audio controls><source src="../../assets/tunes/2_error_tune.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- tune 2, ERROR_TUNE -->
- Hard fault has caused a system reboot.
- System set to use PX4IO but no IO present.
- UAVCAN is enabled but driver can't start.
- SITL/HITL enabled but _pwm_out_sim_ driver can't start.
- FMU startup failed.
#### Make File System
<audio controls><source src="../../assets/tunes/16_make_fs.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 14, SD_INIT (previously tune 16) -->
- Formatting microSD card.
- Mounting failed (if formatting succeeds boot sequence will try to mount again).
- No microSD card.
#### Format Failed
<audio controls><source src="../../assets/tunes/17_format_failed.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 15, SD_ERROR (previously 17) -->
- Formatting microSD card failed (following previous attempt to mount card).
#### Program PX4IO
<audio controls><source src="../../assets/tunes/18_program_px4io.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 16, PROG_PX4IO (previously id 18) -->
- Starting to program PX4IO.
#### Program PX4IO Success
<audio controls><source src="../../assets/tunes/19_program_px4io_success.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 17, PROG_PX4IO_OK (previously tune 19) -->
- PX4IO programming succeeded.
#### Program PX4IO Fail
<audio controls><source src="../../assets/tunes/20_program_px4io_fail.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 18, PROG_PX4IO_ERR (previously tune 20) -->
- PX4IO programming failed.
- PX4IO couldn't start.
- AUX Mixer not found.
## Operational
These tones/tunes are emitted during normal operation.
<a id="error_tune_operational"></a>
#### Error Tune
<audio controls><source src="../../assets/tunes/2_error_tune.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 2, ERROR_TUNE -->
- RC Loss
#### Notify Positive Tone
<audio controls><source src="../../assets/tunes/3_notify_positive_tone.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 3, NOTIFY_POSITIVE -->
- Calibration succeeded.
- Successful mode change.
- Command accepted (e.g. from MAVLink command protocol).
- Safety switch off (vehicle can be armed).
#### Notify Neutral Tone
<audio controls><source src="../../assets/tunes/4_notify_neutral_tone.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 4, NOTIFY_NEUTRAL -->
- Mission is valid and has no warnings.
- Airspeed calibration: supply more air pressure, or calibration complete.
- Safety switch turned on/disarmed (safe to approach vehicle).
#### Notify Negative Tone
<audio controls><source src="../../assets/tunes/5_notify_negative_tone.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 5, NOTIFY_NEGATIVE -->
- Calibration failed.
- Calibration already completed.
- Mission is invalid.
- Command denied, failed, temporarily rejected (e.g. from MAVLink command protocol).
- Arming/disarming transition denied (e.g. pre-flight checks failed, safety not disabled, system not in manual mode).
- Reject mode transition.
#### Arming Warning
<audio controls><source src="../../assets/tunes/6_arming_warning.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 6, ARMING_WARNING -->
- Vehicle is now armed.
#### Arming Failure Tune
<audio controls><source src="../../assets/tunes/10_arming_failure_tune.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 10, ARMING_FAILURE -->
- Arming failed
#### Battery Warning Slow
<audio controls><source src="../../assets/tunes/7_battery_warning_slow.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 7, BATTERY_WARNING_SLOW -->
- Low battery warning ([failsafe](../config/safety.md#battery-level-failsafe)).
#### Battery Warning Fast
<audio controls><source src="../../assets/tunes/8_battery_warning_fast.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 8, BATTERY_WARNING_FAST -->
- Critical low battery warning ([failsafe](../config/safety.md#battery-level-failsafe)).
#### GPS Warning Slow
<audio controls><source src="../../assets/tunes/9_gps_warning_slow.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 9, GPS_WARNING -->
#### Parachute Release
<audio controls><source src="../../assets/tunes/11_parachute_release.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 11, PARACHUTE_RELEASE -->
- Parachute release triggered.
#### Single Beep
<audio controls><source src="../../assets/tunes/14_single_beep.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 12, SINGLE_BEEP (previously was id 14 -->
- Magnetometer/Compass calibration: Notify user to start rotating vehicle.
#### Home Set Tune
<audio controls><source src="../../assets/tunes/15_home_set_tune.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
<!-- 13, HOME_SET (previously id 15) -->
- Home position initialised (first time only).
#### Power Off Tune
<audio controls><source src="../../assets/tunes/power_off_tune.mp3" type="audio/mpeg">Your browser does not support the audio element.</audio>
- Vehicle powering off.
<!--19, POWER_OFF -->
docs/uk/getting_started/vehicle_status.md
+12
View File
@@ -0,0 +1,12 @@
# Повідомлення про статус апарату
PX4 надає візуальні (LED) та звукові (Buzzer) сповіщення про "загальний рівень" стану апарату та його готовності до польоту.
Ці сповіщення вказують, наприклад, чи правильно відкалібрований апарат, чи має він SD-карту, чи має визначення позиції, чи безпечно до нього наближатися, чи він увімкнений, чи він готовий до польоту тощо.
In addition, PX4 provides more fine-grained information about readiness to fly in QGroundControl.
The LED, tune, and GCS notifications are linked below:
- [LED Meanings](../getting_started/led_meanings.md)
- [Tune/Sound Meanings](../getting_started/tunes.md)
- [QGroundControl Flight-Readiness Status](../flying/pre_flight_checks.md)