alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2025-10-05 12:51:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(parlio_rx): support to receive in isr context

Browse Source
This commit is contained in:
laokaiyao
2025-07-02 16:51:19 +08:00
parent 5812b19e91
commit f0c45b7115
4 changed files with 376 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
components/esp_driver_parlio/include/driver/parlio_rx.h
View File

@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -161,7 +161,8 @@ typedef struct {
interrupt, if the data length is set to `0`, that mean the EOF will only triggers
when the end pulse detected, please ensure there is an end pulse for a frame and
`parlio_rx_pulse_delimiter_config_t::has_end_pulse` flag is set */
uint32_t timeout_ticks; /*!< The number of APB clock ticks to trigger timeout interrupt. Set 0 to disable the receive timeout interrupt */
uint32_t timeout_ticks; /*!< The number of APB clock ticks to trigger timeout interrupt. Set 0 to disable the receive timeout interrupt
The timeout counter starts when soft delimiter is stopped but the data is still not enough for EOF. */
} parlio_rx_soft_delimiter_config_t;
/**
@@ -270,6 +271,29 @@ esp_err_t parlio_rx_unit_receive(parlio_rx_unit_handle_t rx_unit,
size_t payload_size,
const parlio_receive_config_t* recv_cfg);
/**
* @brief Receive data by Parallel IO RX unit in ISR context (e.g. inside a callback function)
* @note This function should only be called in ISR context, and the callback function should not block.
* @note The payload buffer should be accessible in ISR context.
* The payload buffer will be sent to the tail of the transaction queue.
*
* @param[in] rx_unit Parallel IO RX unit handle that created by `parlio_new_rx_unit`
* @param[in] payload The payload buffer pointer
* @param[in] payload_size The size of the payload buffer, in bytes.
* @param[in] recv_cfg The configuration of this receive transaction
* @param[out] hp_task_woken Whether the high priority task is woken (Optional, set NULL if not needed)
* @return
* - ESP_OK: success to queue the transaction
* - ESP_FAIL: failed to queue the transaction since the queue is full
* - ESP_ERR_INVALID_ARG: invalid arguments, some conditions are not met
* - ESP_ERR_INVALID_STATE: invalid state
*/
esp_err_t parlio_rx_unit_receive_from_isr(parlio_rx_unit_handle_t rx_unit,
void *payload,
size_t payload_size,
const parlio_receive_config_t* recv_cfg,
bool *hp_task_woken);
/**
* @brief Wait for all pending RX transactions done
* @note This function will block until all receiving transactions done or timeout.