diff --git a/components/driver/include/driver/rmt.h b/components/driver/include/driver/rmt.h index 7abf63ec08..bf6632f5d1 100644 --- a/components/driver/include/driver/rmt.h +++ b/components/driver/include/driver/rmt.h @@ -135,16 +135,11 @@ typedef struct { * This function may be called from an ISR, so, the code should be short and efficient. * * @param src Pointer to the buffer storing the raw data that needs to be converted to rmt format. - * * @param[out] dest Pointer to the buffer storing the rmt format data. - * * @param src_size The raw data size. - * * @param wanted_num The number of rmt format data that wanted to get. - * * @param[out] translated_size The size of the raw data that has been converted to rmt format, * it should return 0 if no data is converted in user callback. - * * @param[out] item_num The number of the rmt format data that actually converted to, it can be less than wanted_num if there is not enough raw data, * but cannot exceed wanted_num. it should return 0 if no data was converted. * @@ -159,7 +154,6 @@ typedef void (*sample_to_rmt_t)(const void* src, rmt_item32_t* dest, size_t src_ * @brief Set RMT clock divider, channel clock is divided from source clock. * * @param channel RMT channel (0-7) - * * @param div_cnt RMT counter clock divider * * @return @@ -172,7 +166,6 @@ esp_err_t rmt_set_clk_div(rmt_channel_t channel, uint8_t div_cnt); * @brief Get RMT clock divider, channel clock is divided from source clock. * * @param channel RMT channel (0-7) - * * @param div_cnt pointer to accept RMT counter divider * * @return @@ -189,7 +182,6 @@ esp_err_t rmt_get_clk_div(rmt_channel_t channel, uint8_t* div_cnt); * the receive process is finished. * * @param channel RMT channel (0-7) - * * @param thresh RMT RX idle threshold * * @return @@ -206,7 +198,6 @@ esp_err_t rmt_set_rx_idle_thresh(rmt_channel_t channel, uint16_t thresh); * the receive process is finished. * * @param channel RMT channel (0-7) - * * @param thresh pointer to accept RMT RX idle threshold value * * @return @@ -234,7 +225,6 @@ esp_err_t rmt_get_rx_idle_thresh(rmt_channel_t channel, uint16_t *thresh); * Channel 0 can use at most 8 blocks of memory, accordingly channel 7 can only use one memory block. * * @param channel RMT channel (0-7) - * * @param rmt_mem_num RMT RX memory block number, one block has 64 * 32 bits. * * @return @@ -247,7 +237,6 @@ esp_err_t rmt_set_mem_block_num(rmt_channel_t channel, uint8_t rmt_mem_num); * @brief Get RMT memory block number * * @param channel RMT channel (0-7) - * * @param rmt_mem_num Pointer to accept RMT RX memory block number * * @return @@ -263,13 +252,9 @@ esp_err_t rmt_get_mem_block_num(rmt_channel_t channel, uint8_t* rmt_mem_num); * The unit of carrier_high/low is the source clock tick, not the divided channel counter clock. * * @param channel RMT channel (0-7) - * * @param carrier_en Whether to enable output carrier. - * * @param high_level High level duration of carrier - * * @param low_level Low level duration of carrier. - * * @param carrier_level Configure the way carrier wave is modulated for channel 0-7. * - 1'b1:transmit on low output level * - 1'b0:transmit on high output level @@ -286,7 +271,6 @@ esp_err_t rmt_set_tx_carrier(rmt_channel_t channel, bool carrier_en, uint16_t hi * Reduce power consumed by memory. 1:memory is in low power state. * * @param channel RMT channel (0-7) - * * @param pd_en RMT memory low power enable. * * @return @@ -299,7 +283,6 @@ esp_err_t rmt_set_mem_pd(rmt_channel_t channel, bool pd_en); * @brief Get RMT memory low power mode. * * @param channel RMT channel (0-7) - * * @param pd_en Pointer to accept RMT memory low power mode. * * @return @@ -312,7 +295,6 @@ esp_err_t rmt_get_mem_pd(rmt_channel_t channel, bool* pd_en); * @brief Set RMT start sending data from memory. * * @param channel RMT channel (0-7) - * * @param tx_idx_rst Set true to reset memory index for TX. * Otherwise, transmitter will continue sending from the last index in memory. * @@ -337,7 +319,6 @@ esp_err_t rmt_tx_stop(rmt_channel_t channel); * @brief Set RMT start receiving data. * * @param channel RMT channel (0-7) - * * @param rx_idx_rst Set true to reset memory index for receiver. * Otherwise, receiver will continue receiving data to the last index in memory. * @@ -373,7 +354,6 @@ esp_err_t rmt_memory_rw_rst(rmt_channel_t channel); * @brief Set RMT memory owner. * * @param channel RMT channel (0-7) - * * @param owner To set when the transmitter or receiver can process the memory of channel. * * @return @@ -386,7 +366,6 @@ esp_err_t rmt_set_memory_owner(rmt_channel_t channel, rmt_mem_owner_t owner); * @brief Get RMT memory owner. * * @param channel RMT channel (0-7) - * * @param owner Pointer to get memory owner. * * @return @@ -399,7 +378,6 @@ esp_err_t rmt_get_memory_owner(rmt_channel_t channel, rmt_mem_owner_t* owner); * @brief Set RMT tx loop mode. * * @param channel RMT channel (0-7) - * * @param loop_en Enable RMT transmitter loop sending mode. * If set true, transmitter will continue sending from the first data * to the last data in channel 0-7 over and over again in a loop. @@ -414,7 +392,6 @@ esp_err_t rmt_set_tx_loop_mode(rmt_channel_t channel, bool loop_en); * @brief Get RMT tx loop mode. * * @param channel RMT channel (0-7) - * * @param loop_en Pointer to accept RMT transmitter loop sending mode. * * @return @@ -430,9 +407,7 @@ esp_err_t rmt_get_tx_loop_mode(rmt_channel_t channel, bool* loop_en); * Counted in source clock, not divided counter clock. * * @param channel RMT channel (0-7) - * * @param rx_filter_en To enable RMT receiver filter. - * * @param thresh Threshold of pulse width for receiver. * * @return @@ -449,7 +424,6 @@ esp_err_t rmt_set_rx_filter(rmt_channel_t channel, bool rx_filter_en, uint8_t th * 2. REF tick clock, which would be 1Mhz (not supported in this version). * * @param channel RMT channel (0-7) - * * @param base_clk To choose source clock for RMT module. * * @return @@ -466,7 +440,6 @@ esp_err_t rmt_set_source_clk(rmt_channel_t channel, rmt_source_clk_t base_clk); * 2. REF tick clock, which would be 1Mhz (not supported in this version). * * @param channel RMT channel (0-7) - * * @param src_clk Pointer to accept source clock for RMT module. * * @return @@ -479,9 +452,7 @@ esp_err_t rmt_get_source_clk(rmt_channel_t channel, rmt_source_clk_t* src_clk); * @brief Set RMT idle output level for transmitter * * @param channel RMT channel (0-7) - * * @param idle_out_en To enable idle level output. - * * @param level To set the output signal's level for channel 0-7 in idle state. * * @return @@ -490,11 +461,23 @@ esp_err_t rmt_get_source_clk(rmt_channel_t channel, rmt_source_clk_t* src_clk); */ esp_err_t rmt_set_idle_level(rmt_channel_t channel, bool idle_out_en, rmt_idle_level_t level); +/** + * @brief Get RMT idle output level for transmitter + * + * @param channel RMT channel (0-7) + * @param idle_out_en Pointer to accept value of enable idle. + * @param level Pointer to accept value of output signal's level in idle state for specified channel. + * + * @return + * - ESP_ERR_INVALID_ARG Parameter error + * - ESP_OK Success + */ +esp_err_t rmt_get_idle_level(rmt_channel_t channel, bool* idle_out_en, rmt_idle_level_t* level); + /** * @brief Get RMT status * * @param channel RMT channel (0-7) - * * @param status Pointer to accept channel status. * * @return @@ -523,7 +506,6 @@ void rmt_clr_intr_enable_mask(uint32_t mask); * @brief Set RMT RX interrupt enable * * @param channel RMT channel (0 - 7) - * * @param en enable or disable RX interrupt. * * @return @@ -536,7 +518,6 @@ esp_err_t rmt_set_rx_intr_en(rmt_channel_t channel, bool en); * @brief Set RMT RX error interrupt enable * * @param channel RMT channel (0 - 7) - * * @param en enable or disable RX err interrupt. * * @return @@ -549,7 +530,6 @@ esp_err_t rmt_set_err_intr_en(rmt_channel_t channel, bool en); * @brief Set RMT TX interrupt enable * * @param channel RMT channel (0 - 7) - * * @param en enable or disable TX interrupt. * * @return @@ -564,9 +544,7 @@ esp_err_t rmt_set_tx_intr_en(rmt_channel_t channel, bool en); * An interrupt will be triggered when the number of transmitted items reaches the threshold value * * @param channel RMT channel (0 - 7) - * * @param en enable or disable TX event interrupt. - * * @param evt_thresh RMT event interrupt threshold value * * @return @@ -579,9 +557,7 @@ esp_err_t rmt_set_tx_thr_intr_en(rmt_channel_t channel, bool en, uint16_t evt_th * @brief Set RMT pin * * @param channel RMT channel (0 - 7) - * * @param mode TX or RX mode for RMT - * * @param gpio_num GPIO number to transmit or receive the signal. * * @return @@ -637,11 +613,8 @@ esp_err_t rmt_isr_deregister(rmt_isr_handle_t handle); * @brief Fill memory data of channel with given RMT items. * * @param channel RMT channel (0 - 7) - * * @param item Pointer of items. - * * @param item_num RMT sending items number. - * * @param mem_offset Index offset of memory. * * @return @@ -654,9 +627,7 @@ esp_err_t rmt_fill_tx_items(rmt_channel_t channel, const rmt_item32_t* item, uin * @brief Initialize RMT driver * * @param channel RMT channel (0 - 7) - * * @param rx_buf_size Size of RMT RX ringbuffer. Can be 0 if the RX ringbuffer is not used. - * * @param intr_alloc_flags Flags for the RMT driver interrupt handler. Pass 0 for default flags. See esp_intr_alloc.h for details. * If ESP_INTR_FLAG_IRAM is used, please do not use the memory allocated from psram when calling rmt_write_items. * @@ -685,12 +656,9 @@ esp_err_t rmt_driver_uninstall(rmt_channel_t channel); * This API allows user to send waveform with any length. * * @param channel RMT channel (0 - 7) - * * @param rmt_item head point of RMT items array. * If ESP_INTR_FLAG_IRAM is used, please do not use the memory allocated from psram when calling rmt_write_items. - * * @param item_num RMT data item number. - * * @param wait_tx_done * - If set 1, it will block the task and wait for sending done. * - If set 0, it will not wait and return immediately. @@ -714,8 +682,7 @@ esp_err_t rmt_write_items(rmt_channel_t channel, const rmt_item32_t* rmt_item, i * @brief Wait RMT TX finished. * * @param channel RMT channel (0 - 7) - * - * @param wait_time Maximum time in ticks to wait for transmission to be complete + * @param wait_time Maximum time in ticks to wait for transmission to be complete. If set 0, return immediately with ESP_ERR_TIMEOUT if TX is busy (polling). * * @return * - ESP_OK RMT Tx done successfully @@ -731,7 +698,6 @@ esp_err_t rmt_wait_tx_done(rmt_channel_t channel, TickType_t wait_time); * Users can get the RMT RX ringbuffer handle, and process the RX data. * * @param channel RMT channel (0 - 7) - * * @param buf_handle Pointer to buffer handle to accept RX ringbuffer handle. * * @return @@ -746,7 +712,6 @@ esp_err_t rmt_get_ringbuf_handle(rmt_channel_t channel, RingbufHandle_t* buf_han * If a channel is initialized more than once, tha user callback will be replaced by the later. * * @param channel RMT channel (0 - 7). - * * @param fn Point to the data conversion function. * * @return @@ -760,11 +725,8 @@ esp_err_t rmt_translator_init(rmt_channel_t channel, sample_to_rmt_t fn); * Requires rmt_translator_init to init the translator first. * * @param channel RMT channel (0 - 7). - * * @param src Pointer to the raw data. - * * @param src_size The size of the raw data. - * * @param wait_tx_done Set true to wait all data send done. * * @return diff --git a/components/driver/rmt.c b/components/driver/rmt.c index 8ee1640c0b..107878698b 100644 --- a/components/driver/rmt.c +++ b/components/driver/rmt.c @@ -306,6 +306,14 @@ esp_err_t rmt_set_idle_level(rmt_channel_t channel, bool idle_out_en, rmt_idle_l return ESP_OK; } +esp_err_t rmt_get_idle_level(rmt_channel_t channel, bool* idle_out_en, rmt_idle_level_t* level) +{ + RMT_CHECK(channel < RMT_CHANNEL_MAX, RMT_CHANNEL_ERROR_STR, ESP_ERR_INVALID_ARG); + *idle_out_en = (bool) (RMT.conf_ch[channel].conf1.idle_out_en); + *level = (rmt_idle_level_t) (RMT.conf_ch[channel].conf1.idle_out_lv); + return ESP_OK; +} + esp_err_t rmt_get_status(rmt_channel_t channel, uint32_t* status) { RMT_CHECK(channel < RMT_CHANNEL_MAX, RMT_CHANNEL_ERROR_STR, ESP_ERR_INVALID_ARG); @@ -837,7 +845,9 @@ esp_err_t rmt_wait_tx_done(rmt_channel_t channel, TickType_t wait_time) return ESP_OK; } else { - ESP_LOGE(RMT_TAG, "Timeout on wait_tx_done"); + if (wait_time != 0) { // Don't emit error message if just polling. + ESP_LOGE(RMT_TAG, "Timeout on wait_tx_done"); + } return ESP_ERR_TIMEOUT; } }