Remote Control Transceiver (RMT)

The Rmt class provides a wrapper around the ESP32 RMT peripheral. It allows you to send infrared signals with the ESP32. See the esp-idf documentation for more information about the RMT peripheral. (https://docs.espressif.com/projects/esp-idf/en/latest/api-reference/peripherals/rmt.html)

The RmtEncoder class provides a wrapper around the ESP32 rmt encoder functionality. It allows you to encode infrared signals with the ESP32. See the esp-idf documentation for more information about the RMT encoder (https://docs.espressif.com/projects/esp-idf/en/latest/api-reference/peripherals/rmt.html#rmt-encoder)

The main functionality of the Rmt / RmtEncoder classes beyond what is provided by the esp-idf is to allow the use of the RMT peripheral with c++ functions (such as with bound functions, functionals, etc.). It also provides a simpler wrapper / interface to the user.

API Reference

Header File

Classes

class Rmt : public espp::BaseComponent

Class wrapping the RMT peripheral on the ESP32.

The RMT (Remote Control Transceiver) peripheral is used to generate precise timing pulses on a GPIO pin. It can be used to drive a WS2812B or similar LED strip which uses a 1-wire protocol such as the WS2812B. The RMT peripheral is also used by the ESP32 to drive the IR transmitter.

See also

https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/rmt.html

Example 1: Transmitting data

Public Functions

inline explicit Rmt(const Config &config)

Constructor.

Parameters

config – Configuration for this class

inline ~Rmt()

Destructor.

This function disables the RMT peripheral and frees the RMT channel.

inline bool transmit(const uint8_t *data, size_t length)

Transmit a buffer of data using the RMT peripheral.

Note

This function blocks until the data has been transmitted.

Parameters

  • data – Pointer to the data to transmit

  • length – Length of the data to transmit

Returns

True if the data was successfully transmitted, false otherwise

inline const std::string &get_name() const

Get the name of the component

Note

This is the tag of the logger

Returns

A const reference to the name of the component

inline void set_log_tag(const std::string_view &tag)

Set the tag for the logger

Parameters

tag – The tag to use for the logger

inline espp::Logger::Verbosity get_log_level() const

Get the log level for the logger

See also

Logger::Verbosity

See also

Logger::set_verbosity

Returns

The verbosity level of the logger

inline void set_log_level(espp::Logger::Verbosity level)

Set the log level for the logger

See also

Logger::Verbosity

See also

Logger::set_verbosity

Parameters

level – The verbosity level to use for the logger

inline void set_log_verbosity(espp::Logger::Verbosity level)

Set the log verbosity for the logger

See also

set_log_level

See also

Logger::Verbosity

See also

Logger::set_verbosity

Note

This is a convenience method that calls set_log_level

Parameters

level – The verbosity level to use for the logger

inline espp::Logger::Verbosity get_log_verbosity() const

Get the log verbosity for the logger

See also

get_log_level

See also

Logger::Verbosity

See also

Logger::get_verbosity

Note

This is a convenience method that calls get_log_level

Returns

The verbosity level of the logger

inline void set_log_rate_limit(std::chrono::duration<float> rate_limit)

Set the rate limit for the logger

See also

Logger::set_rate_limit

Note

Only calls to the logger that have _rate_limit suffix will be rate limited

Parameters

rate_limit – The rate limit to use for the logger

struct Config

Configuration for the RMT class.

Public Members

int gpio_num

GPIO pin to use for the RMT peripheral.

rmt_clock_source_t clock_src = RMT_CLK_SRC_DEFAULT

Clock source for the RMT peripheral.

bool dma_enabled = false

Whether to use DMA for the RMT peripheral.

int block_size = 64

Memory block size (e.g. 64 * 4 = 256 bytes) for the RMT peripheral. Note: this has different meaning depending on whether DMA is configured or not. Suggested size without DMA is >= 64, with DMA is >= 1024.

size_t resolution_hz = 10000000

Resolution of the RMT peripheral.

int transaction_queue_depth = 1

Depth of the RMT transaction queue (number of transactions that can be queued)

Logger::Verbosity log_level = Logger::Verbosity::WARN

Log level for this class.

Header File

Classes

class RmtEncoder

Class representing an RMT encoder.

This class is used to encode data for the RMT peripheral. It is used by the Rmt class to encode data for transmission.

See also

https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/rmt.html#rmt-encoder

Example 1: WS2812 encoder

Public Types

typedef std::function<size_t(rmt_channel_handle_t channel, rmt_encoder_t *copy_encoder, rmt_encoder_t *bytes_encoder, const void *primary_data, size_t data_size, rmt_encode_state_t *ret_state)> encode_fn

Function to encode data for the RMT peripheral.

Note

This function is called by the Rmt class to encode data for transmission. It is called repeatedly until all data has been encoded.

Note

This function should return the number of bytes encoded.

Note

This function should set the RMT encoder state to the next state to be used for encoding.

Param channel

RMT channel to use for encoding

Param copy_encoder

RMT encoder to use for copying data

Param bytes_encoder

RMT encoder to use for encoding bytes

Param primary_data

Pointer to the primary data to encode

Param data_size

Size of the primary data to encode

Param ret_state

Pointer to the RMT encoder state to return

Return

Number of bytes encoded

typedef std::function<esp_err_t(rmt_encoder_t*)> delete_fn

Function to delete an RMT encoder.

Param encoder

RMT encoder to delete

Return

ESP_OK if the encoder was successfully deleted, an error code

typedef std::function<esp_err_t(rmt_encoder_t*)> reset_fn

Function to reset an RMT encoder.

Param encoder

RMT encoder to reset

Return

ESP_OK if the encoder was successfully reset, an error code

Public Functions

inline explicit RmtEncoder(const Config &config)

Constructor.

Parameters

config – Configuration for this class

inline ~RmtEncoder()

Destructor.

inline rmt_encoder_handle_t handle() const

Get the RMT encoder handle.

Returns

RMT encoder handle

Public Static Attributes

static constexpr rmt_bytes_encoder_config_t sk6805_10mhz_bytes_encoder_config  = {.bit0 ={.duration0 = static_cast<uint16_t>(0.3 * 10000000 / 1000000),.level0 = 1,.duration1 = static_cast<uint16_t>(0.9 * 10000000 / 1000000),.level1 = 0,},.bit1 ={.duration0 = static_cast<uint16_t>(0.6 * 10000000 / 1000000),.level0 = 1,.duration1 = static_cast<uint16_t>(0.6 * 10000000 / 1000000),.level1 = 0,},.flags ={.msb_first = 1},}

Configuration for the byte encoding for SK6805 LEDs.

This configuration is used to encode bytes for SK6085 LEDs.

See also

Config

Note

This configuration can be provided to the configuration for this class. These values are based on the timing values provided in the SK6805 datasheet (https://cdn-shop.adafruit.com/product-files/3484/3484_Datasheet.pdf)

static constexpr rmt_bytes_encoder_config_t ws2812_10mhz_bytes_encoder_config  = {.bit0 ={.duration0 = static_cast<uint16_t>(0.3 * 10000000 / 1000000),.level0 = 1,.duration1 = static_cast<uint16_t>(0.9 * 10000000 / 1000000),.level1 = 0,},.bit1 ={.duration0 = static_cast<uint16_t>(0.9 * 10000000 / 1000000),.level0 = 1,.duration1 = static_cast<uint16_t>(0.3 * 10000000 / 1000000),.level1 = 0,},.flags ={.msb_first = 1},}

Configuration for the byte encoding for WS2812 LEDs.

This configuration is used to encode bytes for WS2812 LEDs.

See also

Config

Note

This configuration can be provided to the configuration for this class.

struct Config

Configuration for this class.

Public Members

rmt_bytes_encoder_config_t bytes_encoder_config

Configuration for the RMT bytes encoder.

encode_fn encode

Function to encode data for the RMT peripheral.

delete_fn del

Function to delete an RMT encoder.

reset_fn reset

Function to reset an RMT encoder.