esp version of DShotRMT
Go to file
Wastl Kraus 66482aeadb Rewrite ESP-IDF5
Now using "new" API (rmt_tx.h).

"old" Version of this library is still available: Branch "oldAPI".
2025-06-11 09:29:59 +02:00
.github/workflows Update esp32.yml 2023-03-30 19:28:29 +02:00
examples/dshot300 Rewrite ESP-IDF5 2025-06-11 09:29:59 +02:00
.gitattributes Initial commit 2021-06-29 19:55:37 +02:00
.gitignore ...updated class to optimize configuration 2023-03-26 16:19:54 +02:00
DShotRMT.code-workspace More updates 2023-03-26 17:58:24 +02:00
DShotRMT.cpp Rewrite ESP-IDF5 2025-06-11 09:29:59 +02:00
DShotRMT.h Rewrite ESP-IDF5 2025-06-11 09:29:59 +02:00
LICENSE Initial commit 2021-06-29 19:55:37 +02:00
README.md Rewrite ESP-IDF5 2025-06-11 09:29:59 +02:00
library.properties Rewrite ESP-IDF5 2025-06-11 09:29:59 +02:00

README.md

Arduino CI

DShot ESP32 Library using RMT (Rewrite for ESP-IDF 5)

This is a complete rewrite of the original DShotRMT library to support the new ESP-IDF 5 RMT encoder API (rmt_tx.h).
The library sends continuous DShot frames with a configurable pause between them and supports all standard DShot modes (150, 300, 600).

The old Version without encoding (rmt.h) is still available by using "oldAPI" Branch.


The DShot Protocol

The DShot protocol transmits 16-bit packets to brushless ESCs:

  • 11-bit throttle value
  • 1-bit telemetry request
  • 4-bit checksum

Data is transmitted MSB-first. Pulse timing depends on the selected DShot mode.

DSHOT Bitrate TH1 TH0 Bit Time (µs) Frame Time (µs)
150 150 kbit/s 5.00 2.50 6.67 ~106.72
300 300 kbit/s 2.50 1.25 3.33 ~53.28
600 600 kbit/s 1.25 0.625 1.67 ~26.72

Each frame is followed by a 21-bit time pause at low level. This helps ESCs detect separate frames.


Checksum Calculation

The checksum is calculated over the first 12 bits (throttle + telemetry):

crc = (value ^ (value >> 4) ^ (value >> 8)) & 0x0F;

For Bidirectional DShot (not yet implemented), the CRC is inverted:

crc = (~(value ^ (value >> 4) ^ (value >> 8))) & 0x0F;

RMT on the ESP32

The RMT peripheral on the ESP32 is perfect for generating precise time-based signals like DShot.

Advantages:

  • Hardware-timed pulses
  • CPU-independent signal generation
  • Loop mode with inter-frame pause
  • Reliable under system load

About This Library

This C++ library provides a simple class to generate DShot signals using any RMT-capable GPIO.
It uses a copy_encoder to continuously send a prebuilt symbol buffer. New throttle values are applied only when they change.

Supported Modes:

  • DSHOT150
  • DSHOT300 (default)
  • DSHOT600

Frame Structure:

  • 16-bit DShot data
  • 21-bit times worth of pause (LOW)

References


License

MIT License see LICENSE


Author

Wastl Kraus
GitHub: @derdoktor667
Website: wir-sind-die-matrix.de