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
@@ -0,0 +1,64 @@
# Pomegranate Systems Power Module
:::info
In 2022, UAVCAN (v0) was forked and is maintained as `DroneCAN`.
While this product still mentions "UAVCAN", it is fully compatible with PX4's DroneCAN support.
:::
![Module Image](../../assets/hardware/power_module/pomegranate_systems_pm/main_image.jpg)
Digital Power Module with high resolution current integration, 5V/2A supply with power monitoring, single DroneCAN CANbus interface, and an RGB status LED.
Detailed setup, configuration, and troubleshooting information can be found on the [manufacturer's device home page](https://p-systems.io/product/power_module).
## Hardware Specifications
- **Input Voltage:** 6-26V \(2-6S\)
- **Max Continuous Current:**
- **Benchtop:** 40A
- **Forced Cooling:** 100A
- **Max 5V Output Current:** 2A
- **Voltage Resolution:** 0.04 ΔV
- **Current Resolution:**
- **Primary / Battery Bus:** 0.02 ΔA
- **5V bus:** 0.001 ΔA
- **CANbus Termination:** Electronic (on by default)
- **MCU:** STM32F302K8U
- **Electrical Interface:**
- **Power:** Solder pads or XT60PW (right angle, board-mounted connectors)
- **CANbus** Dual JST GH-4 (standard UAVCAN micro-connector)
- **I2C / Serial:** JST GH-5
- **5V Output:** Solder pads or CANbus / I2C connectors
- **Device Mass:**
- **Without Connectors:** 9g
- **With XT60PW Connectors:** 16g
![Dimensions](../../assets/hardware/power_module/pomegranate_systems_pm/mechanical.png)
## Firmware Setup
The power module runs pomegranate systems' own custom (open source) firmware.
Source code and build instructions can be found on [the bitbucket](https://bitbucket.org/p-systems/firmware/src/master).
## Flight Controller Setup
1. Enable DroneCAN by setting the [UAVCAN_ENABLE](../advanced_config/parameter_reference.md#UAVCAN_ENABLE) parameter to `2` (Sensors Automatic Config) or `3`.
2. Enable DroneCAN battery monitoring by setting [UAVCAN_SUB_BAT](../advanced_config/parameter_reference.md#UAVCAN_SUB_BAT) to `1` or `2` ( depending on your battery).
3. Set the following module parameters using the [MAVLink console](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/mavlink_console.html):
- Battery capacity in mAh: `battery_capacity_mAh`
- Battery voltage when _full_: `battery_full_V`,
- Battery voltage when _empty_: `battery_empty_V`
- Turn on current integration: `enable_current_track`
- (optional) Turn Off CANbus termination resistor :`enable_can_term`
**Example:** A Power Module with UAVCAN node id `125` connected to a `3S` LiPo with capacity of `5000mAh` can be configured with the following commands:
```sh
uavcan param set 125 battery_capacity_mAh 5000
uavcan param set 125 battery_full_V 12.5
uavcan param set 125 battery_empty_V 11.2
uavcan param set 125 enable_current_track 1
uavcan param save 125
```
See [device configuration page](https://p-systems.io/product/power_module/configuration) for a full list of parameters.