Skip to content

Commit ad1b9dc

Browse files
committed
docs: update README for PilotGaeaSH7V1 and bdshot versions
1 parent 0503513 commit ad1b9dc

2 files changed

Lines changed: 25 additions & 18 deletions

File tree

libraries/AP_HAL_ChibiOS/hwdef/PilotGaeaSH7V1-bdshot/README.md

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ The PilotGaeaSH7V1 is a flight controller designed and produced by PilotGaea
2626

2727
## Physical and pinout
2828

29-
![PilotGaeaSH7V1 front view](PilotGaeaSH7V1_front_view_Pin.jpg)
29+
![PilotGaeaSH7V1 front view](./PilotGaea_front_view_Pin.jpg)
3030

31-
![PilotGaeaSH7V1 rear view](PilotGaeaSH7V1_rear_view_Pin.jpg)
31+
![PilotGaeaSH7V1 rear view](./PilotGaea_rear_view_Pin.jpg)
3232

3333
## Power supply
3434

@@ -64,18 +64,26 @@ The default RC input is configured on the UART6 and supports all RC protocols ex
6464

6565
The PilotGaeaSH7V1 Supports onboard analog OSD using the AT7456 chip.The composited image is output via the VTX pin.
6666

67-
## PWM Output
67+
## PWM Output and DShot
6868

69-
The PilotGaeaSH7V1 supports up to 11 PWM outputs.
70-
All the channels support DShot.
71-
Outputs are grouped and every output within a group must use the same output protocol:
69+
The PilotGaeaSH7V1 supports up to 11 PWM outputs.organized into 5 independent timer groups. All groups support DShot, but **Bi-directional DShot (BDShot)** is optimized for Groups 1-3.
7270

73-
1, 2 are Group 1;
74-
3, 4, 5, 6 are Group 2;
75-
7, 8 are Group 3;
76-
11, 12 are Group 4;
77-
13(LED) is Group 5;
78-
Output 13 can be used as LED neopixel output;
71+
### PWM Grouping Table
72+
73+
| Group | PWM Output | Timer | BDShot Support (hwdef-bl) | Recommended Use |
74+
| :--- | :--- | :--- | :--- | :--- |
75+
| **1** | 1, 2 | TIM8 | **Full (DMA)** | Motors 1-2 |
76+
| **2** | 3, 4, 5, 6 | TIM5 | **Full (DMA)** | Motors 3-6 |
77+
| **3** | 7, 8 | TIM4 | **Full (DMA)** | Motors 7-8 |
78+
| **4** | 11, 12 | TIM15 | No (NODMA) | Servos / Auxiliary |
79+
| **5** | 13 (LED) | TIM1 | No (NODMA) | NeoPixel / WS2812 |
80+
81+
### Bi-directional DShot Configuration
82+
To use BDShot for RPM filtering, you must flash the `PilotGaeaSH7V1-bdshot` firmware.
83+
- **Outputs 1-8:** Fully optimized with dedicated DMA resources to ensure stable DShot600 performance and telemetry feedback.
84+
- **Outputs 11-13:** Configured with `NODMA`. While they support standard PWM/DShot, they do not support RPM telemetry. This design prioritizes DMA bandwidth for the primary IMU (SPI1) and core motor functions.
85+
86+
> **Note:** Every output within a group must use the same output protocol (e.g., if Output 3 is set to DShot, Outputs 4, 5, and 6 must also be DShot).
7987
8088
## Battery Monitoring
8189

@@ -114,4 +122,4 @@ The 8V power supply can be controlled by an RC channel. Set the parameters below
114122
## Loading Firmware
115123

116124
Initial firmware load can be done with DFU by plugging in USB with the bootloader button pressed.Then you should load the "*with_bl.hex" firmware, using your favourite DFU loading tool.
117-
Once the initial firmware is loaded you can update the firmware using any ArduPilot ground station software. Updates should be done with the "\*.apj" firmware files.
125+
Once the initial firmware is loaded you can update the firmware using any ArduPilot ground station software. Updates should be done with the "\*.apj" firmware files.

libraries/AP_HAL_ChibiOS/hwdef/PilotGaeaSH7V1/README.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ The PilotGaeaSH7V1 is a flight controller designed and produced by PilotGaea
2626

2727
## Physical and pinout
2828

29-
![PilotGaeaSH7V1 front view](PilotGaeaSH7V1_front_view_Pin.jpg)
29+
![PilotGaeaSH7V1 front view](./PilotGaeaSH7V1_front_view_Pin.jpg)
3030

31-
![PilotGaeaSH7V1 rear view](PilotGaeaSH7V1_rear_view_Pin.jpg)
31+
![PilotGaeaSH7V1 rear view](./PilotGaeaSH7V1_rear_view_Pin.jpg)
3232

3333
## Power supply
3434

@@ -64,10 +64,9 @@ The default RC input is configured on the UART6 and supports all RC protocols ex
6464

6565
The PilotGaeaSH7V1 Supports onboard analog OSD using the AT7456 chip.The composited image is output via the VTX pin.
6666

67-
## PWM Output
67+
## PWM Output and DShot
6868

69-
The PilotGaeaSH7V1 supports up to 11 PWM outputs.
70-
All the channels support DShot.
69+
The PilotGaeaSH7V1 supports up to 11 PWM outputs, All the channels support DShot.
7170
Outputs are grouped and every output within a group must use the same output protocol:
7271

7372
1, 2 are Group 1;

0 commit comments

Comments
 (0)