dshot-pio

KO | EN

gitlite — search

#javascript #python #react #ai #llm #android #machine-learning #rust #macos #java #awesome #awesome-list #vue #security

(★ 27)

DShot implementation for the RP2040 using a single PIO block, for up to 4 ESCs

dshot-pio Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DShot implementation for RP2040 using PIO

This crate utilizes a single PIO block of the RP2040, enable it to send up to four DShot ESC commands (per PIO block, there are 2 of them) simultaneously, making it a great fit for quad-copters. The crate supports both the `embassy-rp` and  `rp2040-hal` hardware abstraction layers (HAL). To use either HAL, the corresponding feature *must* be enabled, using either feature below.

```toml
dshot-pio = { git = "https://github.com/peterkrull/dshot-pio", features = ["embassy-rp"] }
dshot-pio = { git = "https://github.com/peterkrull/dshot-pio", features = ["rp2040-hal"] }
```
Creating the `DshotPio` struct is then a matter of passing into the constructor the PIO block to use, a single HAL-specific item, and the four pins to use as DShot ouputs. The last argument is the clock divider. In order to get reliable transmission to the ESCs, it is important to set the clock divider correctly. The formula for doing so is the following, where *dshot speed* is the number indicating speed, eg 150, 300, 600 and so on. The system clock can vary from board to board, but generally 120 Mhz to 133 Mhz is common for RP2040 boards.

$$\text{clock divider} = \frac { \text{system clock} }{8 \cdot \text{dshot speed} \cdot 1000} $$

This clock divider is passed to the constructor in two parts, consisting of the integer part, and the fraction. Generally stuff after the decimal point of the *clock divider* can be ignored, meaning that is should be good enough to pass only the integer part. Otherwise the remainder should be passed as `(remainder * 256 ) as u8`

---

## Construction

Constructing the motor struct looks slightly different, depending on whether the `rp2040-hal` or `embassy-rp`  HAL is used. The functionality of the resulting struct is however shared through a trait. The number of DShot drivers needed can be changed using the first number in the turbofish.

```rust
use dshot_pio::rp2040_hal::*;
let dshot_rp2040_hal = DshotPio::<4,_>::new(
    pac.PIO0,
    &mut pac.RESETS,
    pins.gpio13,
    pins.gpio7,
    pins.gpio6,
    pins.gpio12,
    (52, 0) // clock divider
);
```
For embassy, it is currently necessary to use a macro to correctly bind an interrupt.

```rust
bind_interrupts!( struct Pio0Irqs {
    PIO0_IRQ_0 => InterruptHandler<PIO0>;
});

use dshot_pio::embassy_rp::*;
let dshot_embassy = DshotPio::<4,_>::new(
    peri.PIO0,
    Pio0Irqs,
    peri.PIN_13,
    peri.PIN_7,
    peri.PIN_6,
    peri.PIN_12,
    (52, 0) // clock divider
);
```

dshot-pio

dshot-pio Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

dshot-pio

dshot-pio Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README