mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-05-17 09:17:35 +08:00
PX4 Build Bot
147 lines
8.2 KiB
Markdown
147 lines
8.2 KiB
Markdown
# DShot ESCs
|
||
|
||
DShot is an alternative ESC protocol that has several advantages over [PWM](../peripherals/pwm_escs_and_servo.md) or [OneShot](../peripherals/oneshot.md):
|
||
|
||
- Зменшений час затримки.
|
||
- Підвищена надійність за допомогою контрольної суми.
|
||
- Не потрібна калібрування ESC, оскільки протокол використовує цифрове кодування.
|
||
- Зворотний зв'язок телеметрії доступний/підтримується на деяких ESC.
|
||
- Може змінювати напрямок обертання двигуна за допомогою команд при потребі (замість фізичного переміщення проводів / перепайки).
|
||
- Інші корисні команди підтримуються.
|
||
|
||
Ця тема показує, як підключити та налаштувати DShot ESC.
|
||
|
||
## Supported ESC
|
||
|
||
[ESCs & Motors > Supported ESCs](../peripherals/esc_motors.md#supported-esc) has a list of supported ESC (check "Protocols" column for DShot ESC).
|
||
|
||
## Wiring/Connections {#wiring}
|
||
|
||
DShot ESC are wired the same way as [PWM ESCs](pwm_escs_and_servo.md).
|
||
Єдина відмінність полягає в тому, що їх можна підключити лише до FMU, і зазвичай лише до певного підмножини контактів.
|
||
|
||
:::info
|
||
You may want to check the actuator configuration screen to see what pins are available for DShot on your controller before wiring up!
|
||
:::
|
||
|
||
Pixhawk controllers with both an FMU and an IO board usually label them as `AUX` (FMU) and `MAIN` (IO), respectively.
|
||
These match the `PWM AUX` and `PWM MAIN` output tabs on the actuator configuration screen.
|
||
For these controllers connect the DShot ESC to the `AUX` port.
|
||
|
||
Controllers that don't have an IO board usually label the (single) output port as `MAIN`, and this is where you will connect your DShot ESC.
|
||
If the controller without IO has its own firmware, the actuator assignment will be to the matching `PWM MAIN` outputs.
|
||
However if the same firmware is used for hardware with/without the IO board, such as for the Pixhawk 4 and Pixhawk 4 Mini, then actuator assignment tab used is the same in both cases: `PWM AUX` (i.e. not matching the port label `MAIN` in the "mini" case).
|
||
|
||
## Налаштування
|
||
|
||
:::warning
|
||
Remove propellers before changing ESC configuration parameters!
|
||
:::
|
||
|
||
Enable DShot for your required outputs in the [Actuator Configuration](../config/actuators.md).
|
||
|
||
DShot comes with different speed options: _DShot150_, _DShot300_, and _DShot600_ where the number indicates the speed in kilo-bits/second.
|
||
Ви повинні встановити параметр на найвищу швидкість, підтримувану вашим ESC (згідно з його технічним описом).
|
||
|
||
Підключіть батарею та озбройте транспортний засіб.
|
||
РЕГБ повинні ініціалізуватися, а мотори повинні обертатися в правильних напрямках.
|
||
|
||
- If the motors do not spin in the correct direction (for the [selected airframe](../airframes/airframe_reference.md)) you can reverse them in the UI using the **Set Spin Direction** option (this option appears after you select DShot and assign motors).
|
||
|
||
## ESC Commands {#commands}
|
||
|
||
Commands can be sent to the ESC via the [MAVLink shell](../debug/mavlink_shell.md).
|
||
See [here](../modules/modules_driver.md#dshot) for a full reference of the supported commands.
|
||
|
||
## ESC Telemetry
|
||
|
||
Some ESCs are capable of sending telemetry back to the flight controller through a UART RX port.
|
||
Ці DShot ESCs матимуть додатковий телеметрійний дріт.
|
||
|
||
The provided telemetry includes:
|
||
|
||
- Температура
|
||
- Напруга
|
||
- Current
|
||
- Accumulated current consumption
|
||
- Значення RPM
|
||
|
||
Щоб увімкнути цю функцію (на ESC, які її підтримують):
|
||
|
||
1. Об'єднайте всі дроти телеметрії з усіх ESC разом, а потім підключіть їх до одного з контактів RX на не використаному порту послідовного зв'язку контролера польоту.
|
||
2. Enable telemetry on that serial port using [DSHOT_TEL_CFG](../advanced_config/parameter_reference.md#DSHOT_TEL_CFG).
|
||
|
||
:::tip
|
||
You may have to configure the per-motor pole count parameters ([`DSHOT_MOT_POL1`–`DSHOT_MOT_POL12`](../advanced_config/parameter_reference.md#DSHOT_MOT_POL1)) to get correct RPM values.
|
||
The default value for these is 14 poles, which is typical for 5-inch prop motors.
|
||
:::
|
||
|
||
:::tip
|
||
[Extended DShot Telemetry (EDT)](#extended-dshot-telemetry-edt) can provide temperature, voltage, and current through the BDShot signal — no serial telemetry wire needed.
|
||
:::
|
||
|
||
## Bidirectional DShot (Telemetry)
|
||
|
||
<Badge type="tip" text="PX4 v1.16" />
|
||
|
||
Bidirectional DShot (BDShot) enables the ESC to send eRPM telemetry back to the flight controller on the same signal wire used for throttle commands — no additional telemetry wire is needed for RPM data.
|
||
High-rate eRPM data significantly improves the performance of [Dynamic Notch Filters](../config_mc/filter_tuning.md#dynamic-notch-filters) and enables more precise vehicle tuning.
|
||
|
||
With [Extended DShot Telemetry (EDT)](#extended-dshot-telemetry-edt) enabled, BDShot can also provide temperature, voltage, and current data.
|
||
|
||
### Підтримка обладнання
|
||
|
||
BDShot requires a flight controller with DMA-capable timers.
|
||
Any FMU output on a supported timer can be used for BDShot — multiple timers are supported through sequential burst/capture.
|
||
|
||
Supported processors:
|
||
|
||
- **STM32H7**: All FMU outputs on DMA-capable timers
|
||
- **i.MXRT** (V6X-RT & Tropic): All FMU outputs
|
||
|
||
:::info
|
||
The ESC must be connected to FMU outputs only.
|
||
These are labeled `MAIN` on controllers with a single PWM bus, and `AUX` on controllers with both `MAIN` and `AUX` ports (i.e. those with an IO board).
|
||
:::
|
||
|
||
### PX4 Configuration {#bidirectional-dshot-configuration}
|
||
|
||
BDShot is enabled **per-timer** in the [Actuator Configuration](../config/actuators.md) UI.
|
||
Select **BDShot150**, **BDShot300**, or **BDShot600** as the output protocol instead of the corresponding DShot speed.
|
||
There is no separate enable parameter — choosing a BDShot protocol activates bidirectional telemetry on that timer's outputs.
|
||
|
||
The system calculates actual motor RPM from eRPM data using per-motor pole count parameters: `DSHOT_MOT_POL1` through `DSHOT_MOT_POL12` (one per motor output).
|
||
The default is 14 poles, which is typical for 5-inch prop motors.
|
||
If you are using AM32 ESCs, the motor pole count must also be set in the AM32 firmware configuration (e.g. via the AM32 configurator tool) to match.
|
||
|
||
### Extended DShot Telemetry (EDT)
|
||
|
||
EDT extends BDShot by interleaving temperature, voltage, and current data into the eRPM telemetry frames.
|
||
This allows ESC health monitoring through the same signal wire, without requiring a separate serial telemetry connection.
|
||
|
||
To enable EDT:
|
||
|
||
1. Configure BDShot on the desired outputs (see above).
|
||
2. Set `DSHOT_BIDIR_EDT` to `1` and reboot.
|
||
|
||
The ESC firmware must support EDT (e.g. [AM32](https://github.com/am32-firmware/AM32)).
|
||
|
||
When both serial telemetry and BDShot/EDT are enabled, the driver merges data from both sources.
|
||
|
||
## AM32 ESC Settings (EEPROM)
|
||
|
||
PX4 can read and write AM32 ESC firmware settings (EEPROM) via a ground station, enabling remote ESC configuration without connecting directly to each ESC.
|
||
|
||
### Вимоги
|
||
|
||
- ESCs running [AM32 firmware](https://github.com/am32-firmware/AM32) with serial telemetry connected ([DSHOT_TEL_CFG](../advanced_config/parameter_reference.md#DSHOT_TEL_CFG))
|
||
- `DSHOT_ESC_TYPE` set to `1` (AM32)
|
||
- Ground station with ESC EEPROM support (QGroundControl feature in development)
|
||
- MAVLink development dialect enabled on the flight controller
|
||
|
||
### How It Works
|
||
|
||
PX4 automatically reads the full EEPROM from each ESC on boot.
|
||
The ground station can then display individual settings and allow the user to modify them.
|
||
Changes are written back to the ESC one byte at a time using the DShot programming protocol.
|