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

Merge branch 'fix/ringbuf_allow_split_receive_crash_v5.4' into 'release/v5.4'

Browse Source 
fix(ringbuf): xRingbufferReceive() crashes for allow-split buffers (v5.4)

See merge request espressif/esp-idf!37922
This commit is contained in:
Marius Vikhammer
2025-04-01 14:55:36 +08:00
parent 4354c3080a 3f5f6ec13e
commit a218e3f553
4 changed files with 15 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/en/api-reference/system/freertos_additions.rst
View File

@@ -296,6 +296,10 @@ Byte buffers **do not allow multiple retrievals before returning** (every retrie
Referring to the diagram above, the 38 bytes of continuous stored data at the tail of the buffer is retrieved, returned, and freed. The next call to :cpp:func:`xRingbufferReceive` or :cpp:func:`xRingbufferReceiveFromISR` then wraps around and does the same to the 30 bytes of continuous stored data at the head of the buffer.
.. note::
Retrieving items from Allow-Split buffers must be done via :cpp:func:`xRingbufferReceiveSplit` or :cpp:func:`xRingbufferReceiveSplitFromISR` instead of :cpp:func:`xRingbufferReceive` or :cpp:func:`xRingbufferReceiveFromISR`.
Ring Buffers with Queue Sets
^^^^^^^^^^^^^^^^^^^^^^^^^^^^