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>
This commit is contained in:
Hamish Willee
2025-03-13 16:08:27 +11:00
committed by GitHub
parent 8e6d2ebe4a
commit 88d623bedb
5176 changed files with 558771 additions and 2 deletions

View File

@@ -0,0 +1,52 @@
# ARK 12S PAB Power Module
The [ARK 12S PAB Power Module](https://arkelectron.gitbook.io/ark-documentation/power/ark-12s-pab-power-module) is a 5V 6A power supply and digital power monitor designed for use with Pixhawk Autopilot Bus Carrier boards.
![ARK 12S PAB Power Module](../../assets/hardware/power_module/ark_power_modules//ark_12s_pab_power_module.jpg)
## Де купити
Замовте цей модуль з:
- [ARK Electronics](https://arkelectron.com/product/ark-12s-pab-power-module/) (US)
## Характеристики обладнання
- **TI INA238 Digital Power Monitor**
- 0.0001 Ohm Shunt
- I2C Interface
- **5.2V 6A Step-Down Regulator**
- 66V Maximum Input Voltage
- 10V Minimum Input Voltage at 6A Out
- Output Over-Current Protection
- **Connections**
- Solder Pads Battery Input
- Solder Pads Battery Output
- 6 Pin Molex CLIK-Mate Output
- [Matches ARK PAB Carrier Power Pinout](https://arkelectron.gitbook.io/ark-documentation/flight-controllers/ark-pixhawk-autopilot-bus-carrier/pinout)
- **Other**
- USA Built
- Includes 6 Pin Molex CLIK-Mate Cable
- **Additional Information**
- Weight: 15.5 g
- Dimensions: 3.7 cm x 2.2 cm x 1.3 cm
## Налаштування PX4
- Disable the `SENS_EN_INA226` parameter if it is enabled.
- Enable the `SENS_EN_INA238` parameter.
- Reboot the flight controller.
- Set the `INA238_SHUNT` parameter to 0.0001.
- Reboot the flight controller.
## Дивіться також
- [ARK 12S PAB Power Module Documentation](https://arkelectron.gitbook.io/ark-documentation/power/ark-12s-pab-power-module) (ARK Docs)

View File

@@ -0,0 +1,53 @@
# ARK PAB Power Module
The [ARK PAB Power Module](https://arkelectron.gitbook.io/ark-documentation/power/ark-pab-power-module) is an advanced power module rated for 60A continuous battery current at 20°C ambient.
For higher continuous current needs, running multiple power modules in parallel is recommended.
Note that at 60A and 20°C without cooling, the 5V regulator is de-rated to a 3A continuous output.
![ARK PAB Power Module](../../assets/hardware/power_module/ark_power_modules//ark_pab_power_module.jpg)
## Де купити
Замовте цей модуль з:
- [ARK Electronics](https://arkelectron.com/product/ark-pab-power-module/) (US)
## Характеристики обладнання
- **TI INA226 Digital Power Monitor**
- 0.0005 Ohm Shunt
- I2C Interface
- **5.2V 6A Step-Down Regulator**
- 33V Maximum Input Voltage
- 5.8V Minimum Input Voltage at 6A Out
- Output Over-Voltage Protection
- Output Over-Current Protection
- **Connections**
- XT60 Battery Input
- XT60 Battery Output
- 6 Pin Molex CLIK-Mate Output
- [Matches ARK PAB Carrier Power Pinout](https://arkelectron.gitbook.io/ark-documentation/flight-controllers/ark-pixhawk-autopilot-bus-carrier/pinout)
- **Other**
- USA Built
- FCC Compliant
- Includes 6 Pin Molex CLIK-Mate Cable
- **Additional Information**
- Weight: 17.9 g
- Dimensions: 4.75 cm x 3.43 cm x 1.15 cm
## Налаштування PX4
- Enable the SENS_EN_INA226 parameter if it not enabled.
- Reboot the flight controller.
## Дивіться також
- [ARK PAB Power Module Documentation](https://arkelectron.gitbook.io/ark-documentation/power/ark-pab-power-module) (ARK Docs)

View File

@@ -0,0 +1 @@
<Redirect to="../dronecan/cuav_can_pmu" />

View File

@@ -0,0 +1,36 @@
# CUAV HV PM (High-Voltage модуль живлення)
The CUAV<sup>&reg;</sup> _HV_PM_ power module is a "high voltage" power module independently developed by CUAV.
:::tip
The _HV_PM_ is included in the CUAV V5+/V5 nano kit, but is also be sold separately.
Існують різні кабелі в залежності від контролера польоту (Pixhack v3, V5+/V5 nano, Pixhawk).
Це може бути використано з іншими контролерами польоту, але вам може знадобитися змінити контактний пін.
:::
## Характеристики
- **Higher voltage input:** 10V-60V (3s~14s battery)
- **Accurate battery monitor:**
- **Voltage detection accuracy:** +-0.1v;
- **Current detection accuracy:** +-0.2A
- **BEC (5v) max current:** 5A
- **Max (detection) current:** 60A
- **Max output current (ESC/MOTOR PORT):** 60A
## Де купити
[CUAV aliexpress store](https://www.aliexpress.com/item/32841805115.html?spm=2114.12010615.8148356.1.64165998hPvTKQ)
## Схема розташування виводів
![HV PM](../../assets/hardware/power_module/cuav_hv/hv_pm.jpg)
## Увімкнути HV PM
[Battery Estimation Tuning](../config/battery.md) describes how to configure the battery and power module.
The key configuration settings for `HV_PM` are:
- **Voltage divider:** 18
- **Amps per volt:** 24 A/V

View File

@@ -0,0 +1,37 @@
# Holybro PM02 (V3) Модуль живлення
Цей аналоговий блок живлення забезпечує регульоване живлення для керуючого пристрою польоту та розподільчої плати живлення, а також надсилає інформацію автопілоту про напругу батареї та поточний струм, що подається на керуючий пристрій польоту та двигуни.
It is commonly used with [Pixhawk 4](../assembly/quick_start_pixhawk4.md).
:::info
The module can be used with other flight controllers that require an analog power module, including [Durandal](../flight_controller/durandal.md), [Pix32 v5](../flight_controller/holybro_pix32_v5.md), etc
:::
![Holybro PM02](../../assets/hardware/power_module/holybro_pm02/pm02.jpg)
## Характеристики
- **Rated current**: 60A
- **Max current**: 120A (<60 Sec)
- **Max current sensing**: 120A
- **Battery supported**: up to 12S battery
- **Communication protocol**: Analog
- **Switching regulator outputs**: 5.2V and 3A max
- **Weight**: 20g
Напруга та поточне вимірювання налаштоване для 3,3V АДС
## Вміст набору
- Модуль живлення з платою з роз'ємом XT60
- Електролітична ємність: 220uF 63V (попередньо встановлена)
- Молех 6 Посадний Коннектор 15 см
- GH 6 Position Connector 15 см
## Де купити
[Order from Holybro Store](https://holybro.com/collections/power-modules-pdbs/products/pm02-v3-12s-power-module)
## Проведення/Підключення
Additional wiring and connection information can be found in: [Pixhawk 4 QuickStart](../assembly/quick_start_pixhawk4.md).

View File

@@ -0,0 +1,57 @@
# Holybro PM02D Енергогенератор
The Holybro PM02D digital power module provides regulated power to flight controller and power distribution board, and sends information to the autopilot about battery voltage and current supplied to the flight controller and the motors.
There are two versions: high voltage (12S/14S) and low voltage (6S).
Плата живлення підключається за допомогою протоколу I2C.
It is designed for flight controllers based on the Pixhawk FMUv5X and FMUv6X open standard, including the [Pixhawk 5X](../flight_controller/pixhawk5x.md).
:::info
The PM is **NOT** compatible with flight controllers that require an analog power module, including: [Pixhawk 4](../flight_controller/pixhawk4.md), [Durandal](../flight_controller/durandal.md), [Pix32 v5](../flight_controller/holybro_pix32_v5.md), etc.
:::
![PM02D](../../assets/hardware/power_module/holybro_pm02d/pm02d_hero.jpg)
## Характеристики
- **Max input voltage**: 36V
- **Rated current**: 60A
- **Max current**: 120A (<60S)
- **Max current sensing**: 164A
- **Battery supported**: up to 6S battery
- **Communication protocol**: I2C
- **Switching regulator outputs**: 5.2V and 3A max
- **Weight**: 20g
- **IC Used**: TI INA226 (LV), TI INA228 (HV)
## Вміст набору
- PM02D дошка з коннекторами XT60
- 6pin 2.00мм інтервал CLIK-Mate кабель до протиживлення контролера
## Де купити
[Order from Holybro Store](https://holybro.com/products/pm02d-power-module)
## Проведення/Підключення
![pm02d_pinout](../../assets/hardware/power_module/holybro_pm02d/pm02d_pinout.png)
Additional wiring and connection information can be found in: [Holybro Pixhawk 5x Wiring Quick Start](../assembly/quick_start_pixhawk5x.md).
## Конфігурація PX4
Low voltage (6S) Digital Power Module
- Enable parameter [SENS_EN_INA226](../advanced_config/parameter_reference.md#SENS_EN_INA226)
High Voltage (12S/14S) Digital Power Module:
- Enable parameter [SENS_EN_INA228](../advanced_config/parameter_reference.md#SENS_EN_INA228)
Note that the current divider and voltage divider should not be set in the [Battery Configuration](../config/battery.md) (the default values are accurate within 5%).
## Дивіться також
- [Digital Power Module (PM) Setup](https://docs.holybro.com/power-module-and-pdb/power-module/digital-power-module-pm-setup#px4-setup) (Manufacturer guide)

View File

@@ -0,0 +1,64 @@
# Модуль живлення Holybro PM03D
Плата живлення PM03D виступає як блок живлення (PM) та розподільча плата живлення (PDB).
Крім надання регульованого живлення Pixhawk v5X та ESC, вона надсилає інформацію автопілоту про напругу батареї та поточний струм, який подається на керуючий пристрій польоту та двигуни.
Плата живлення підключається за допомогою протоколу I2C.
It is designed for flight controllers based on the Pixhawk FMUv5X and FMUv6X open standard, including the [Pixhawk 5X](../flight_controller/pixhawk5x.md).
:::info
The PM is **NOT** compatible with flight controllers that require an analog power module, including: [Pixhawk 4](../flight_controller/pixhawk4.md), [Durandal](../flight_controller/durandal.md), [Pix32 v5](../flight_controller/holybro_pix32_v5.md), etc.
:::
![Pixhawk5x Upright Image](../../assets/hardware/power_module/holybro_pm03d/pm03d_pinout.jpg)
## Функції
- Plug & play, no additional setup required for QGroundcontrol & Mission Planner
- Роз'єми XT-30 та паяльні площини для простого підключення моторів та ESC
- Onboard voltage regulators: two 5.2V & one selectable 8V/12V
- Порти 5V/A для живлення супутнього комп'ютера або периферійного пристрою
- На вибір 8V або 12V трирядний рядок контактів для живлення периферійного пристрою
## Характеристики
- **Maximum input voltage**: 6S battery
- **Rated current**: 60A
- **Max current**: 120A (<60 Sec)
- **Max current sensing**: 164A
- **Communication protocol**: I2C
- **Dimension**: 84 x 78 x 12mm (excluding wires)
- **Mounting**: 45 x 45mm
- **Weight**: 59g
- **Connections**:
- ХТ-60 для акумулятора
- XT-30 for motor & peripheral device (battery voltage)
- Паяльні вклади в кожному кутку (напруга акумулятора)
- CLIK-Mate 2.0мм для контролю за польотами (5.2V/3A standalone BEC)
- JST GH 4pin (5.2V/3A, BEC shared with 5.2V потрійний рядок шпильковий заголовок)
- 2x Трьохрядний шплинтовий рядок (5.2V/3A, BEC спільний з JST GH 4pin)
- 2x Трьохрядний шплинтовий заголовок (8V або 12V вибирається переміщенням стрижня заголовка, 3A)
## Вміст набору
- 1x Плата PM06
- 1x 80 мм кабель з роз'ємом XT60 (попередньо припаяний)
- 1x Електролітична ємність: 220uF 63V (передпаяна)
- 1x 2.0мм інтервал CLIK-Mate 6pin кабель (Для живлення контролера польоту)
- 4pin JST GH в USB тип C
- 4pin JST GH до бочкового штекера (2.1\*5.5мм)
- 4pin JST GH до бочкового штекера (2.5\*5.5мм)
- Кабель Дюпон 4-шпильковий (2шт)
- Nylon standoffs & nuts
<img src="../../assets/hardware/power_module/holybro_pm03d/pm03d_contents.jpg" width="650px" title="Pixhawk5x Upright Image" />
## Де купити
[Order from Holybro Store](https://holybro.com/products/pm03d-power-module)
## Проведення/Підключення
![pinout](../../assets/hardware/power_module/holybro_pm02d/pm02d_pinout.png)
Additional wiring and connection information can be found in: [Holybro Pixhawk 5x Wiring Quick Start](../assembly/quick_start_pixhawk5x.md).

View File

@@ -0,0 +1,31 @@
# Holybro Micro Power Module (PM06)
Цей блок живлення має інтегровану розподільчу плату живлення і забезпечує стабілізоване живлення для керуючого пристрою польоту та ESC, а також надсилає інформацію автопілоту про напругу батареї та поточне споживання струму.
![PM06](../../assets/hardware/power_module/holybro_pm06_14s/pm06v2_pm06v2-14s.jpg)
## Характеристики
- **PCB Current:** 120A continued
- **UBEC Current:** 3A Max
- **Power input:** 2S~10S (standard version)
- **Power input:** 2S~14S (14S version)
- **Power output:** DC 5.1V~5.3V
- **Voltage Divider:** 18.182
- **Amperes per Volt:** 36.364
## Механічні характеристики
- **Dimensions:** 35x35x5mm
- **Mounting hole:** 30.5mm\*30.5mm
- **Weight:** 24g
## Де купити
[PM06 V2 Power Module](https://holybro.com/collections/power-modules-pdbs/products/micro-power-module-pm06-v2)
## Проведення/Підключення
Wiring and connection examples can be found in: [Pixhawk 4 Mini > Power](../assembly/quick_start_pixhawk4_mini.md#power).
<img src="../../assets/hardware/power_module/holybro_pm06/pm06_pin_map.jpg" width="450px" title="pm06" />

View File

@@ -0,0 +1,44 @@
# Holybro Модуль живлення Pixhawk 4 (PM07)
Плата управління живленням (PM Board) виконує функції блоку живлення та розподільчої плати живлення.
Крім надання регульованого живлення для Pixhawk 4 та ESC, вона надсилає інформацію автопілоту про напругу батареї та поточний струм, що подається на керуючий пристрій польоту та двигуни.
:::info
This module can be purchased as bundle with [Pixhawk 4](../assembly/quick_start_pixhawk4.md), but can also be used with other flight controllers.
:::
![PM07](../../assets/hardware/power_module/holybro_pm07/pm07_hero.jpg)
## Характеристики
- **PCB Current:** total 120A outputs (MAX)
- **UBEC 5v output current:** 3A
- **UBEC input voltage:** 2~12s LiPo
- **Dimensions:** 68 x 50 x 8 mm
- **Mounting Holes:** 45 x 45 mm
- **Weight:** 36g
## Вміст набору
![Package Contents](../../assets/hardware/power_module/holybro_pm07/package_contents.jpg)
- Плата PM07
- 80mm кабель з роз'ємом XT60 (встановлений)
- Електролітична ємність: 220uF 63V (встановлено)
- Кабель JST GH 10P 2x
- Кабель JST GH 8P
- Кабель JST GH 6P 2x
## Де купити
[Pixhawk 4 Power Module (PM07)](https://holybro.com/collections/power-modules-pdbs/products/pixhawk-4-power-module-pm07)
## Проведення/Підключення
Wiring and connection information can be found in: [Pixhawk 4 > Power](../assembly/quick_start_pixhawk4.md#power).
![Pixhawk 4 - Power Management Board](../../assets/hardware/power_module/holybro_pm07/pixhawk4_power_management_board.png)
## Подальша інформація
[Quick Start Guide](https://docs.holybro.com/power-module-and-pdb/power-module/pm07-quick-start-guide) (Holybro)

View File

@@ -0,0 +1,35 @@
# Power Modules & Power Distribution Boards
_Power Modules_ provide a regulated power supply for the flight controller (FC), along with information about battery voltage and current.
Інформація про напругу/струм використовується для визначення спожитої потужності та, відповідно, для оцінки залишкової ємності батареї.
This in turn allows the flight controller to provide failsafe warnings and other actions in the event of low power: [Safety > Low Battery Failsafe](../config/safety.md#battery-level-failsafe).
_Power Distribution Boards (PDB)_ are circuit boards that may be used to simplify splitting the output of the battery to various parts of the drone, and in particular motors.
PDBs will sometimes include a power module for the FC, ESCs for motors, and a battery elimination circuit (BEC) for powering servos.
The PX4 battery/power module configuration (via the ADC interface) is covered in: [Battery Estimation Tuning](../config/battery.md).
:::tip
For easiest assembly use a power module or PDB recommended by your FC manufacturer, and sized for your power requirements.
The Pixhawk connector standard requires that the VCC line must provide at least 2.5A continuous current and default to 5.3V.
In in practice flight controllers may have different recommendations or preferences, so if you don't (or can't) use a recommended module, check that the module matches your FC's requirements.
:::
This section provides information about a number of power modules and power distribution boards (see FC manufacturer docs for more options):
- Модулі живлення аналогового напруги та струму:
- [CUAV HV PM](../power_module/cuav_hv_pm.md)
- [Holybro PM02](../power_module/holybro_pm02.md)
- [Holybro PM07](../power_module/holybro_pm07_pixhawk4_power_module.md)
- [Holybro PM06 V2](../power_module/holybro_pm06_pixhawk4mini_power_module.md)
- [Sky-Drones SmartAP PDB](../power_module/sky-drones_smartap-pdb.md)
- Цифрові (I2C) модулі напруги та поточного живлення (для контролерів, похідних від Pixhawk FMUv6X та FMUv5X):
- [ARK PAB Power Module](../power_module/ark_pab_power_module.md)
- [ARK 12S PAB Power Module](../power_module/ark_12s_pab_power_module.md)
- [Holybro PM02D](../power_module/holybro_pm02d.md)
- [Holybro PM03D](../power_module/holybro_pm03d.md)
- [DroneCAN](../dronecan/index.md) power modules
- [CUAV CAN PMU](../dronecan/cuav_can_pmu.md)
- [Pomegranate Systems Power Module](../dronecan/pomegranate_systems_pm.md)
- [RaccoonLab Power Connectors and PMU](../dronecan/raccoonlab_power.md)

View File

@@ -0,0 +1 @@
<Redirect to="../dronecan/pomegranate_systems_pm" />

View File

@@ -0,0 +1,64 @@
# Sky-Drones SmartAP GPS
[SmartAP PDB](https://sky-drones.com/power/smartap-pdb.html) (Power Distribution Board) is used to simplify the distribution of power from one or more batteries to ESCs (motors), flight controller, and other peripherals.
It also acts as a [power module](../power_module/index.md), enabling battery voltage and current measurements.
SmartAP PDB спрощує підключення високовольтних ліній, роблячи їх надійнішими та зручнішими.
![SmartAP PDB](../../assets/hardware/power_module/sky-drones_smartap-pdb/smartap-pdb-top-side.jpg)
## Характеристики
- Розмір: 65\*65 мм, 4х М3 кріплення отворів
- Напруга введення до 60 Вольт (14S)
- Можливість керування екстремально високими струмами (максимальний струм до 400A)
- Живлення від основного акумулятора, можливість підключення до 2 незалежних акумуляторів
- 12 пар клем (6 зверху, 6 знизу) для живлення до 12 двигунів
- Інтегровані датчики напруги та струму з фільтрами L/C
- Точні виміри струму на основі ефекту Холла
- Інтегрований DC-DC перетворювач від входу 10-60 В (до 14S акумулятора) до виходу 5 В / 5A для живлення периферійних пристроїв
- Інтегрований DC-DC перетворювач від входу 10-60 В (до 14S акумулятора) до виходу 12 В / 5A для живлення периферійних пристроїв
- Вихідні клеми живлення 5 В і 12 В (стандартні коннектори 2.54 мм / 0,1 дюйма)
- Інтегрований електромагнітний сигналізатор (сигналізація)
- Вихід живлення для керуючого пристрою польоту (як 5 В регульоване, так і вихід на рівні напруги акумулятора)
## Розмір і вага
- Довжина: 65мм
- Ширина: 65мм
- Висота: 14мм
- Вага: 8g
## Конфігурація PX4
[Battery Estimation Tuning](../config/battery.md) describes how to configure the battery setting for a power module.
Етапи конфігурації ключових налаштувань:
- Подільник напруги: 15.51
- Ампери на вольт: 36.00
## Де купити
[SmartAP PDB](https://sky-drones.com/parts/smartap-pdb.html)
## Проводка / Схема роз'ємів
На відповідній схемі роз'ємів плати розподілу потужності SmartAP показано нижче.
![SmartAP PDB](../../assets/hardware/power_module/sky-drones_smartap-pdb/smartap-pdb-pinout.png)
Два великих контактних пункти призначені для підключення основного акумулятора.
Для здатності витримувати великі струми та вищу загальну ємність можна підключити до двох незалежних акумуляторів за допомогою товстих проводів (наприклад, 8-10 AWG).
До 12 ESC можна підключити за допомогою 6 менших контактних пунктів у верхній, нижній, лівій та правій частині.
## Датчики напруги та струму
У SmartAP PDB вбудовані датчики напруги та струму.
Датчик струму розташований на нижній стороні плати розподілу потужності.
![SmartAP PDB](../../assets/hardware/power_module/sky-drones_smartap-pdb/smartap-pdb-current-sensor.png)
## Подальша інформація
- [Buy SmartAP PDB](https://sky-drones.com/power/smartap-pdb.html)
- [Documentation](https://docs.sky-drones.com/avionics/smartap-pdb)