RE: Async UART API: how to get partially filled buffer for immediate processing

WoutWG — Mon, 19 Feb 2024 14:06:22 GMT

Thank you Jørgen for the feedback. I'll use the timeout feature indeed to limit CPU activity as that's the main benefit of using the Async API.

RE: Async UART API: how to get partially filled buffer for immediate processing

Jørgen Holmefjord — Mon, 19 Feb 2024 12:55:47 GMT

Hi,

[quote user=""]I was under the impression that UART_RX_BUF_REQUEST would be called the moment data starts coming in. Due to the implementation in the central_uart sample, I would expect that a new buffer is provided, which would allow to immediately release the buffer which contains only the first data transmission, hence providing immediate processing of any incoming data.[/quote]

"When receiving starts to current buffer" in this context means whenever the receive operation has started, not necessarily that actual data reception have started. The UARTE peripheral in nRF52 and nRF91 supports double buffering, which means you can provide a new buffer pointer as soon as the RXSTARTED event has been generated. Together with HW shortcut between ENDRX event and STARTRX task, this could give minimal latency for buffer swapping to prevent data-loss from CPU needing to update the buffer pointer when the buffer have been filled.

[quote user=""]

I can get partial buffers by actually setting the rx timeout to a value matching the rate of the messages being sent.

Am I misinterpreting the documentation, and is the only way to get partial buffers using async UART API by setting RX timeout which is lower than the time it takes to completely fill a buffer? Or should I actually get a partially filled buffer released every time data is received?

[/quote]

If you want to process received data in smaller chunks, you need to reduce your buffer size, or use the timeout feature. The HW does not give any indication of number of received bytes until after reception have been stopped, but there is a HW event, EVENTS_RXDRDY, that can be used as an indication when data is actually received. This event are used by the driver to count number of received bytes using a TIMER instance when CONFIG_UART_x_NRF_HW_ASYNC is set. This event will also start the timeout timer, which will be reset whenever a new byte is received, until the timeout is hit.

If you do not want to use the timeout, you would need to set a 1-byte RX buffer for every transfer, which will cause excessive CPU activity to process all the interrupts.

Best regards,
Jørgen