Skip to content

derdoktor667/DShotRMT

Repository files navigation

Arduino CI

DShotRMT - ESP32 Library (Rewrite for ESP-IDF 5)

A modern, robust C++ library for generating DShot signals on the ESP32 using the new ESP-IDF 5 RMT encoder API (rmt_tx.h / rmt_rx.h).
Supports all standard DShot modes (150, 300, 600) and features continuous frame transmission with configurable pause.
Now with BiDirectional DShot support!

The legacy version (using the old rmt.h API) is still available in the oldAPI branch.


🚀 Features

  • All DShot Modes: DSHOT150, DSHOT300 (default), DSHOT600, (DSHOT1200)
  • BiDirectional DShot: Experimental support for RPM feedback
  • Continuous Frames: Independent timed, Hardware signal generation
  • Configurable Pause: Ensures ESCs can reliably detect frame boundaries
  • Simple API: Easy integration into your Arduino or ESP-IDF project

📦 Installation

Clone this repository and add it to your Arduino libraries or ESP-IDF components.

git clone https://github.com/derdoktor667/DShotRMT.git

⚡ Quick Start

Use "dshot300.ino" example sketch

📚 DShot Protocol Overview

DShot transmits 16-bit packets to brushless ESCs:

  • 11 bits: Throttle value
  • 1 bit: Telemetry request
  • 4 bits: Checksum (CRC)

Data is sent 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 pause to help ESCs detect separate frames.

DShotRMT


🔒 Checksum Calculation

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

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

Bidirectional DSHOT

Bidirectional DSHOT (sometimes called "inverted DSHOT") inverts the signal level:
A logical '1' is low, and a '0' is high. This signals the ESC to send telemetry packets back.

Bidirectional CRC:

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

Note: Bidirectional DShot is experimental. Further hardware testing is needed.


🛠️ ESP32 RMT Peripheral

The RMT (Remote Control) peripheral generates accurate, hardware-timed signals for controlling external devices.
Perfect for DShot:

  • Utilizes latest ESP-IDF APIs
  • Hardware-timed pulses
  • CPU-independent
  • Loop mode with inter-frame pause
  • Reliable under system load

📝 API Reference

  • DShotRMT(gpio_num_t gpio, dshot_mode_t mode, bool isBidirectional)
  • void begin()
  • void sendThrottle(uint16_t throttle)

See examples/dshot300/dshot300.ino for a more informations.


📖 References


📄 License

MIT License – see LICENSE


👤 Author

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

About

DShot Signal library for ESP32 using the RMT module – Arduino IDE compatible

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published