Перейти к содержанию

Регистры RMT ESP32

Регистры RMT ESP32: восемь каналов, каждый из которых может передавать или принимать, память по 64 символа на канал, делитель такта, порог тишины, модуляция несущей, фильтр приёма, порог для потоковой передачи и флаги прерываний.

RMT по адресу 0x3FF5 6000 передаёт и принимает последовательности импульсов, закодированные символами по 32 бита (две пары «уровень, длительность 15 бит»): инфракрасные пульты, адресные светодиоды WS2812 и другие протоколы. У ESP32 восемь каналов, и каждый работает на передачу или на приём.

Память RMT — 512 слов, по умолчанию каналу достаётся блок из 64 слов; поле MEM_SIZE отдаёт каналу несколько блоков подряд за счёт следующих каналов. Такт канала — APB_CLK 80 МГц или REF_TICK 1 МГц (бит REF_ALWAYS_ON), делённый на DIV_CNT.

Регистры данных, состояния и адресов каналов (CHnDATA, CHnSTATUS, CHnADDR) в TRM v5.8 не описаны и здесь не показаны; данные в память RMT пишут по её адресу 0x3FF5 6800.

ЭкземплярБазовый адрес
RMT0x3FF5 6000

Пример на C

Канал 0: несущая 38 кГц, 33 % при APB_CLK 80 МГц (soc/rmt_reg.h). Макросы доступа REG_WRITE, REG_READ, REG_SET_BIT, REG_CLR_BIT, REG_GET_BIT, REG_SET_FIELD и REG_GET_FIELD объявлены в soc/soc.h ESP-IDF; поле задаётся именем макроса без суффикса, маска и сдвиг берутся из его вариантов _V и _S.

#include "soc/rmt_reg.h"

REG_SET_FIELD(RMT_CH0CARRIER_DUTY_REG, RMT_CARRIER_HIGH_CH0, 698);   // 8,7 мкс
REG_SET_FIELD(RMT_CH0CARRIER_DUTY_REG, RMT_CARRIER_LOW_CH0, 1407);   // 17,6 мкс
REG_SET_BIT(RMT_CH0CONF0_REG, RMT_CARRIER_EN_CH0);                   // модуляция включена

Регистры блока

Регистр (ESP-IDF)СмещениеНазначениеПосле сброса
RMT_CHnCONF0_REG0x0020 + n · 0x0008Канал n: делитель, порог тишины, память, несущая0x3110 0002
RMT_CHnCONF1_REG0x0024 + n · 0x0008Канал n: запуск, приём, такт, фильтр, владелец памяти0x0000 0F20
RMT_INT_RAW_REG0x00A0Необработанные флаги прерываний0x0000 0000
RMT_INT_ST_REG0x00A4Флаги прерываний после маски разрешения0x0000 0000
RMT_INT_ENA_REG0x00A8Разрешение прерываний0x0000 0000
RMT_INT_CLR_REG0x00ACСброс флагов прерываний записью 10x0000 0000
RMT_CHnCARRIER_DUTY_REG0x00B0 + n · 0x0004Канал n: длительности уровней несущей0x0040 0040
RMT_CHn_TX_LIM_REG0x00D0 + n · 0x0004Канал n: порог потоковой передачи0x0000 0080
RMT_APB_CONF_REG0x00F0Доступ к памяти RMT по шине APB0x0000 0000

Доступ — обозначения TRM: R/W — чтение и запись, RO — только чтение, WO — только запись, WT — запись 1 запускает действие, SS и SC — бит ставится и сбрасывается аппаратно, WTC — сбрасывается записью 1.

RMT_CHnCONF0_REG — канал n: делитель, порог тишины, память, несущая

8 копий, n = 0…7: смещение 0x0020 + n · 0x0008, после сброса 0x3110 0002. TRM: регистр 30.1.

31302928272625242322212019181716
—MEM_PDCARRIER_OUT_LV_CHnCARRIER_EN_CHnMEM_SIZE_CHnIDLE_THRES_CHn
1514131211109876543210
IDLE_THRES_CHnDIV_CNT_CHn
ПолеБитыДоступСбросНазначение
MEM_PD30R/W0Выключить питание памяти RMT
CARRIER_OUT_LV_CHn29R/W1Уровень, на котором модулируется несущая
CARRIER_EN_CHn28R/W1Модуляция несущей
MEM_SIZE_CHn27:24R/W0x1Число блоков памяти по 64 слова
IDLE_THRES_CHn23:8R/W0x1000Тишина дольше стольких тактов — конец приёма
DIV_CNT_CHn7:0R/W0x02Делитель такта канала 1…255; 0 означает 256 (так пишет rmt_ll.h ESP-IDF)

RMT_CHnCONF1_REG — канал n: запуск, приём, такт, фильтр, владелец памяти

8 копий, n = 0…7: смещение 0x0024 + n · 0x0008, после сброса 0x0000 0F20. TRM: регистр 30.2.

31302928272625242322212019181716
—IDLE_OUT_EN_CHnIDLE_OUT_LV_CHnREF_ALWAYS_ON_CHnREF_CNT_RST_CHn
1514131211109876543210
RX_FILTER_THRES_CHnRX_FILTER_EN_CHnTX_CONTI_MODE_CHnMEM_OWNER_CHn—MEM_RD_RST_CHnMEM_WR_RST_CHnRX_EN_CHnTX_START_CHn
ПолеБитыДоступСбросНазначение
IDLE_OUT_EN_CHn19R/W0Выдавать уровень покоя
IDLE_OUT_LV_CHn18R/W0Уровень выхода в покое
REF_ALWAYS_ON_CHn17R/W0Такт канала: 1 — APB_CLK, 0 — REF_TICK
REF_CNT_RST_CHn16R/W0Сброс делителя канала
RX_FILTER_THRES_CHn15:8R/W0x0FИмпульсы короче стольких тактов APB отбрасываются
RX_FILTER_EN_CHn7R/W0Фильтр коротких импульсов при приёме
TX_CONTI_MODE_CHn6R/W0Повторять передачу по кругу
MEM_OWNER_CHn5R/W1Владелец памяти: 1 — приёмник, 0 — программа или передатчик
MEM_RD_RST_CHn3R/W0Сброс адреса чтения памяти (передача)
MEM_WR_RST_CHn2R/W0Сброс адреса записи памяти (приём)
RX_EN_CHn1R/W0Включить приём
TX_START_CHn0R/W0Запись 1 запускает передачу

RMT_INT_RAW_REG — необработанные флаги прерываний

Смещение 0x00A0, адрес 0x3FF5 60A0, после сброса 0x0000 0000. TRM: регистр 30.3.

ПолеБитыДоступСбросНазначение
CH7_TX_THR_EVENT_INT_RAW31RO0Канал 7 передал TX_LIM_CH7 символов — пора дописать память
CH6_TX_THR_EVENT_INT_RAW30RO0Канал 6 передал TX_LIM_CH6 символов — пора дописать память
CH5_TX_THR_EVENT_INT_RAW29RO0Канал 5 передал TX_LIM_CH5 символов — пора дописать память
CH4_TX_THR_EVENT_INT_RAW28RO0Канал 4 передал TX_LIM_CH4 символов — пора дописать память
CH3_TX_THR_EVENT_INT_RAW27RO0Канал 3 передал TX_LIM_CH3 символов — пора дописать память
CH2_TX_THR_EVENT_INT_RAW26RO0Канал 2 передал TX_LIM_CH2 символов — пора дописать память
CH1_TX_THR_EVENT_INT_RAW25RO0Канал 1 передал TX_LIM_CH1 символов — пора дописать память
CH0_TX_THR_EVENT_INT_RAW24RO0Канал 0 передал TX_LIM_CH0 символов — пора дописать память
CH7_ERR_INT_RAW23RO0Канал 7: ошибка доступа к памяти RMT
CH7_RX_END_INT_RAW22RO0Канал 7 закончил приём
CH7_TX_END_INT_RAW21RO0Канал 7 закончил передачу
CH6_ERR_INT_RAW20RO0Канал 6: ошибка доступа к памяти RMT
CH6_RX_END_INT_RAW19RO0Канал 6 закончил приём
CH6_TX_END_INT_RAW18RO0Канал 6 закончил передачу
CH5_ERR_INT_RAW17RO0Канал 5: ошибка доступа к памяти RMT
CH5_RX_END_INT_RAW16RO0Канал 5 закончил приём
CH5_TX_END_INT_RAW15RO0Канал 5 закончил передачу
CH4_ERR_INT_RAW14RO0Канал 4: ошибка доступа к памяти RMT
CH4_RX_END_INT_RAW13RO0Канал 4 закончил приём
CH4_TX_END_INT_RAW12RO0Канал 4 закончил передачу
CH3_ERR_INT_RAW11RO0Канал 3: ошибка доступа к памяти RMT
CH3_RX_END_INT_RAW10RO0Канал 3 закончил приём
CH3_TX_END_INT_RAW9RO0Канал 3 закончил передачу
CH2_ERR_INT_RAW8RO0Канал 2: ошибка доступа к памяти RMT
CH2_RX_END_INT_RAW7RO0Канал 2 закончил приём
CH2_TX_END_INT_RAW6RO0Канал 2 закончил передачу
CH1_ERR_INT_RAW5RO0Канал 1: ошибка доступа к памяти RMT
CH1_RX_END_INT_RAW4RO0Канал 1 закончил приём
CH1_TX_END_INT_RAW3RO0Канал 1 закончил передачу
CH0_ERR_INT_RAW2RO0Канал 0: ошибка доступа к памяти RMT
CH0_RX_END_INT_RAW1RO0Канал 0 закончил приём
CH0_TX_END_INT_RAW0RO0Канал 0 закончил передачу

RMT_INT_ST_REG — флаги прерываний после маски разрешения

Смещение 0x00A4, адрес 0x3FF5 60A4, после сброса 0x0000 0000. TRM: регистр 30.4.

ПолеБитыДоступСбросНазначение
CH7_TX_THR_EVENT_INT_ST31RO0Канал 7 передал TX_LIM_CH7 символов — пора дописать память
CH6_TX_THR_EVENT_INT_ST30RO0Канал 6 передал TX_LIM_CH6 символов — пора дописать память
CH5_TX_THR_EVENT_INT_ST29RO0Канал 5 передал TX_LIM_CH5 символов — пора дописать память
CH4_TX_THR_EVENT_INT_ST28RO0Канал 4 передал TX_LIM_CH4 символов — пора дописать память
CH3_TX_THR_EVENT_INT_ST27RO0Канал 3 передал TX_LIM_CH3 символов — пора дописать память
CH2_TX_THR_EVENT_INT_ST26RO0Канал 2 передал TX_LIM_CH2 символов — пора дописать память
CH1_TX_THR_EVENT_INT_ST25RO0Канал 1 передал TX_LIM_CH1 символов — пора дописать память
CH0_TX_THR_EVENT_INT_ST24RO0Канал 0 передал TX_LIM_CH0 символов — пора дописать память
CH7_ERR_INT_ST23RO0Канал 7: ошибка доступа к памяти RMT
CH7_RX_END_INT_ST22RO0Канал 7 закончил приём
CH7_TX_END_INT_ST21RO0Канал 7 закончил передачу
CH6_ERR_INT_ST20RO0Канал 6: ошибка доступа к памяти RMT
CH6_RX_END_INT_ST19RO0Канал 6 закончил приём
CH6_TX_END_INT_ST18RO0Канал 6 закончил передачу
CH5_ERR_INT_ST17RO0Канал 5: ошибка доступа к памяти RMT
CH5_RX_END_INT_ST16RO0Канал 5 закончил приём
CH5_TX_END_INT_ST15RO0Канал 5 закончил передачу
CH4_ERR_INT_ST14RO0Канал 4: ошибка доступа к памяти RMT
CH4_RX_END_INT_ST13RO0Канал 4 закончил приём
CH4_TX_END_INT_ST12RO0Канал 4 закончил передачу
CH3_ERR_INT_ST11RO0Канал 3: ошибка доступа к памяти RMT
CH3_RX_END_INT_ST10RO0Канал 3 закончил приём
CH3_TX_END_INT_ST9RO0Канал 3 закончил передачу
CH2_ERR_INT_ST8RO0Канал 2: ошибка доступа к памяти RMT
CH2_RX_END_INT_ST7RO0Канал 2 закончил приём
CH2_TX_END_INT_ST6RO0Канал 2 закончил передачу
CH1_ERR_INT_ST5RO0Канал 1: ошибка доступа к памяти RMT
CH1_RX_END_INT_ST4RO0Канал 1 закончил приём
CH1_TX_END_INT_ST3RO0Канал 1 закончил передачу
CH0_ERR_INT_ST2RO0Канал 0: ошибка доступа к памяти RMT
CH0_RX_END_INT_ST1RO0Канал 0 закончил приём
CH0_TX_END_INT_ST0RO0Канал 0 закончил передачу

RMT_INT_ENA_REG — разрешение прерываний

Смещение 0x00A8, адрес 0x3FF5 60A8, после сброса 0x0000 0000. TRM: регистр 30.5.

ПолеБитыДоступСбросНазначение
CH7_TX_THR_EVENT_INT_ENA31R/W0Канал 7 передал TX_LIM_CH7 символов — пора дописать память
CH6_TX_THR_EVENT_INT_ENA30R/W0Канал 6 передал TX_LIM_CH6 символов — пора дописать память
CH5_TX_THR_EVENT_INT_ENA29R/W0Канал 5 передал TX_LIM_CH5 символов — пора дописать память
CH4_TX_THR_EVENT_INT_ENA28R/W0Канал 4 передал TX_LIM_CH4 символов — пора дописать память
CH3_TX_THR_EVENT_INT_ENA27R/W0Канал 3 передал TX_LIM_CH3 символов — пора дописать память
CH2_TX_THR_EVENT_INT_ENA26R/W0Канал 2 передал TX_LIM_CH2 символов — пора дописать память
CH1_TX_THR_EVENT_INT_ENA25R/W0Канал 1 передал TX_LIM_CH1 символов — пора дописать память
CH0_TX_THR_EVENT_INT_ENA24R/W0Канал 0 передал TX_LIM_CH0 символов — пора дописать память
CH7_ERR_INT_ENA23R/W0Канал 7: ошибка доступа к памяти RMT
CH7_RX_END_INT_ENA22R/W0Канал 7 закончил приём
CH7_TX_END_INT_ENA21R/W0Канал 7 закончил передачу
CH6_ERR_INT_ENA20R/W0Канал 6: ошибка доступа к памяти RMT
CH6_RX_END_INT_ENA19R/W0Канал 6 закончил приём
CH6_TX_END_INT_ENA18R/W0Канал 6 закончил передачу
CH5_ERR_INT_ENA17R/W0Канал 5: ошибка доступа к памяти RMT
CH5_RX_END_INT_ENA16R/W0Канал 5 закончил приём
CH5_TX_END_INT_ENA15R/W0Канал 5 закончил передачу
CH4_ERR_INT_ENA14R/W0Канал 4: ошибка доступа к памяти RMT
CH4_RX_END_INT_ENA13R/W0Канал 4 закончил приём
CH4_TX_END_INT_ENA12R/W0Канал 4 закончил передачу
CH3_ERR_INT_ENA11R/W0Канал 3: ошибка доступа к памяти RMT
CH3_RX_END_INT_ENA10R/W0Канал 3 закончил приём
CH3_TX_END_INT_ENA9R/W0Канал 3 закончил передачу
CH2_ERR_INT_ENA8R/W0Канал 2: ошибка доступа к памяти RMT
CH2_RX_END_INT_ENA7R/W0Канал 2 закончил приём
CH2_TX_END_INT_ENA6R/W0Канал 2 закончил передачу
CH1_ERR_INT_ENA5R/W0Канал 1: ошибка доступа к памяти RMT
CH1_RX_END_INT_ENA4R/W0Канал 1 закончил приём
CH1_TX_END_INT_ENA3R/W0Канал 1 закончил передачу
CH0_ERR_INT_ENA2R/W0Канал 0: ошибка доступа к памяти RMT
CH0_RX_END_INT_ENA1R/W0Канал 0 закончил приём
CH0_TX_END_INT_ENA0R/W0Канал 0 закончил передачу

RMT_INT_CLR_REG — сброс флагов прерываний записью 1

Смещение 0x00AC, адрес 0x3FF5 60AC, после сброса 0x0000 0000. TRM: регистр 30.6.

ПолеБитыДоступСбросНазначение
CH7_TX_THR_EVENT_INT_CLR31WO0Канал 7 передал TX_LIM_CH7 символов — пора дописать память
CH6_TX_THR_EVENT_INT_CLR30WO0Канал 6 передал TX_LIM_CH6 символов — пора дописать память
CH5_TX_THR_EVENT_INT_CLR29WO0Канал 5 передал TX_LIM_CH5 символов — пора дописать память
CH4_TX_THR_EVENT_INT_CLR28WO0Канал 4 передал TX_LIM_CH4 символов — пора дописать память
CH3_TX_THR_EVENT_INT_CLR27WO0Канал 3 передал TX_LIM_CH3 символов — пора дописать память
CH2_TX_THR_EVENT_INT_CLR26WO0Канал 2 передал TX_LIM_CH2 символов — пора дописать память
CH1_TX_THR_EVENT_INT_CLR25WO0Канал 1 передал TX_LIM_CH1 символов — пора дописать память
CH0_TX_THR_EVENT_INT_CLR24WO0Канал 0 передал TX_LIM_CH0 символов — пора дописать память
CH7_ERR_INT_CLR23WO0Канал 7: ошибка доступа к памяти RMT
CH7_RX_END_INT_CLR22WO0Канал 7 закончил приём
CH7_TX_END_INT_CLR21WO0Канал 7 закончил передачу
CH6_ERR_INT_CLR20WO0Канал 6: ошибка доступа к памяти RMT
CH6_RX_END_INT_CLR19WO0Канал 6 закончил приём
CH6_TX_END_INT_CLR18WO0Канал 6 закончил передачу
CH5_ERR_INT_CLR17WO0Канал 5: ошибка доступа к памяти RMT
CH5_RX_END_INT_CLR16WO0Канал 5 закончил приём
CH5_TX_END_INT_CLR15WO0Канал 5 закончил передачу
CH4_ERR_INT_CLR14WO0Канал 4: ошибка доступа к памяти RMT
CH4_RX_END_INT_CLR13WO0Канал 4 закончил приём
CH4_TX_END_INT_CLR12WO0Канал 4 закончил передачу
CH3_ERR_INT_CLR11WO0Канал 3: ошибка доступа к памяти RMT
CH3_RX_END_INT_CLR10WO0Канал 3 закончил приём
CH3_TX_END_INT_CLR9WO0Канал 3 закончил передачу
CH2_ERR_INT_CLR8WO0Канал 2: ошибка доступа к памяти RMT
CH2_RX_END_INT_CLR7WO0Канал 2 закончил приём
CH2_TX_END_INT_CLR6WO0Канал 2 закончил передачу
CH1_ERR_INT_CLR5WO0Канал 1: ошибка доступа к памяти RMT
CH1_RX_END_INT_CLR4WO0Канал 1 закончил приём
CH1_TX_END_INT_CLR3WO0Канал 1 закончил передачу
CH0_ERR_INT_CLR2WO0Канал 0: ошибка доступа к памяти RMT
CH0_RX_END_INT_CLR1WO0Канал 0 закончил приём
CH0_TX_END_INT_CLR0WO0Канал 0 закончил передачу

RMT_CHnCARRIER_DUTY_REG — канал n: длительности уровней несущей

8 копий, n = 0…7: смещение 0x00B0 + n · 0x0004, после сброса 0x0040 0040. TRM: регистр 30.7.

31302928272625242322212019181716
CARRIER_HIGH_CHn
1514131211109876543210
CARRIER_LOW_CHn
ПолеБитыДоступСбросНазначение
CARRIER_HIGH_CHn31:16R/W0x0040Длительность высокого уровня несущей в тактах
CARRIER_LOW_CHn15:0R/W0x0040Длительность низкого уровня несущей

RMT_CHn_TX_LIM_REG — канал n: порог потоковой передачи

8 копий, n = 0…7: смещение 0x00D0 + n · 0x0004, после сброса 0x0000 0080. TRM: регистр 30.8.

ПолеБитыДоступСбросНазначение
TX_LIM_CHn8:0R/W0x080Порог: после стольких символов — прерывание TX_THR_EVENT

RMT_APB_CONF_REG — доступ к памяти RMT по шине APB

Смещение 0x00F0, адрес 0x3FF5 60F0, после сброса 0x0000 0000. TRM: регистр 30.9.

1514131211109876543210
—MEM_TX_WRAP_ENMEM_ACCESS_EN
ПолеБитыДоступСбросНазначение
MEM_TX_WRAP_EN1R/W0Кольцевой режим памяти при передаче
MEM_ACCESS_EN0R/W01 — доступ к памяти напрямую, 0 — через FIFO

Частые вопросы

Сколько символов помещается в канал RMT ESP32?

Блок памяти канала — 64 слова по 32 бита, то есть 128 пар «уровень — длительность». Поле MEM_SIZE_CHn позволяет отдать каналу до восьми блоков (512 слов), но тогда следующие каналы остаются без памяти. Длинные последовательности передают порциями по прерыванию TX_THR_EVENT.

Как выбрать такт канала RMT ESP32?

Бит REF_ALWAYS_ON_CHn регистра RMT_CHnCONF1_REG выбирает APB_CLK 80 МГц (1) или REF_TICK 1 МГц (0), поле DIV_CNT_CHn регистра RMT_CHnCONF0_REG делит его на 1…255 (0 означает 256). Для светодиодов WS2812 пример ESP-IDF берёт делитель 8 — 10 МГц, шаг 0,1 мкс.

Источники

  1. Espressif. ESP32 Technical Reference Manual, версия 5.8 — глава 30: таблица Register Summary и рисунки регистров — смещения, поля, тип доступа и значения после сброса
  2. Espressif. SVD svd/esp32.svd, версия 16 (espressif/svd, коммит be20aa1) — базовые адреса периферии, список регистров и полей; лицензия Apache-2.0
  3. Espressif. ESP-IDF v6.1: заголовки components/soc/esp32/register/soc/*_reg.h (коммит fff9895) — имена макросов регистров и полей, сверка положения полей и значений по умолчанию; лицензия Apache-2.0 OR MIT

Нашли ошибку в регистрах? ·

Другие регистры ESP32

Статьи, инструменты и термины