github-forks
/
FreeRTOS-Kernel
mirror of https://github.com/FreeRTOS/FreeRTOS-Kernel.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update stream and message buffer documentation (#1226)

Browse Source 
Signed-off-by: Gaurav Aggarwal <aggarg@amazon.com>
pull/1223/head
Gaurav-Aggarwal-AWS 1 week ago committed by GitHub
parent a58579681c
commit b5d1b972cc
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 54 additions and 54 deletions
Show Stats Download Patch File Download Diff File

60
include/message_buffer.h
Unescape Escape View File

@ -43,12 +43,12 @@
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xMessageBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xMessageBufferRead()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* timeout to 0. * critical section and use a block time of 0.
* *
* Message buffers hold variable length messages. To enable that, when a * Message buffers hold variable length messages. To enable that, when a
* message is written to the message buffer an additional sizeof( size_t ) bytes * message is written to the message buffer an additional sizeof( size_t ) bytes
@ -306,12 +306,12 @@ typedef StreamBufferHandle_t MessageBufferHandle_t;
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xMessageBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xMessageBufferRead()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xMessageBufferSend() to write to a message buffer from a task. Use * Use xMessageBufferSend() to write to a message buffer from a task. Use
* xMessageBufferSendFromISR() to write to a message buffer from an interrupt * xMessageBufferSendFromISR() to write to a message buffer from an interrupt
@ -409,12 +409,12 @@ typedef StreamBufferHandle_t MessageBufferHandle_t;
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xMessageBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xMessageBufferRead()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xMessageBufferSend() to write to a message buffer from a task. Use * Use xMessageBufferSend() to write to a message buffer from a task. Use
* xMessageBufferSendFromISR() to write to a message buffer from an interrupt * xMessageBufferSendFromISR() to write to a message buffer from an interrupt
@ -516,12 +516,12 @@ typedef StreamBufferHandle_t MessageBufferHandle_t;
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xMessageBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xMessageBufferRead()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xMessageBufferReceive() to read from a message buffer from a task. Use * Use xMessageBufferReceive() to read from a message buffer from a task. Use
* xMessageBufferReceiveFromISR() to read from a message buffer from an * xMessageBufferReceiveFromISR() to read from a message buffer from an
@ -610,12 +610,12 @@ typedef StreamBufferHandle_t MessageBufferHandle_t;
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xMessageBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xMessageBufferRead()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xMessageBufferReceive() to read from a message buffer from a task. Use * Use xMessageBufferReceive() to read from a message buffer from a task. Use
* xMessageBufferReceiveFromISR() to read from a message buffer from an * xMessageBufferReceiveFromISR() to read from a message buffer from an

48
include/stream_buffer.h
Unescape Escape View File

@ -40,12 +40,12 @@
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xStreamBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xStreamBufferReceive()) inside a critical section section and set the * serialization in single core or SMP kernel is to place each API call inside a
* receive block time to 0. * critical section and use a block time of 0.
* *
*/ */
@ -514,12 +514,12 @@ typedef void (* StreamBufferCallbackFunction_t)( StreamBufferHandle_t xStreamBuf
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xStreamBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xStreamBufferReceive()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xStreamBufferSend() to write to a stream buffer from a task. Use * Use xStreamBufferSend() to write to a stream buffer from a task. Use
* xStreamBufferSendFromISR() to write to a stream buffer from an interrupt * xStreamBufferSendFromISR() to write to a stream buffer from an interrupt
@ -615,12 +615,12 @@ size_t xStreamBufferSend( StreamBufferHandle_t xStreamBuffer,
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xStreamBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xStreamBufferReceive()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xStreamBufferSend() to write to a stream buffer from a task. Use * Use xStreamBufferSend() to write to a stream buffer from a task. Use
* xStreamBufferSendFromISR() to write to a stream buffer from an interrupt * xStreamBufferSendFromISR() to write to a stream buffer from an interrupt
@ -718,12 +718,12 @@ size_t xStreamBufferSendFromISR( StreamBufferHandle_t xStreamBuffer,
* writer and reader to be different tasks or interrupts, but, unlike other * writer and reader to be different tasks or interrupts, but, unlike other
* FreeRTOS objects, it is not safe to have multiple different writers or * FreeRTOS objects, it is not safe to have multiple different writers or
* multiple different readers. If there are to be multiple different writers * multiple different readers. If there are to be multiple different writers
* then the application writer must place each call to a writing API function * then the application writer must serialize calls to writing API functions
* (such as xStreamBufferSend()) inside a critical section and set the send * (such as xStreamBufferSend()). Likewise, if there are to be multiple
* block time to 0. Likewise, if there are to be multiple different readers * different readers then the application writer must serialize calls to reading
* then the application writer must place each call to a reading API function * API functions (such as xStreamBufferReceive()). One way to achieve such
* (such as xStreamBufferReceive()) inside a critical section and set the receive * serialization in single core or SMP kernel is to place each API call inside a
* block time to 0. * critical section and use a block time of 0.
* *
* Use xStreamBufferReceive() to read from a stream buffer from a task. Use * Use xStreamBufferReceive() to read from a stream buffer from a task. Use
* xStreamBufferReceiveFromISR() to read from a stream buffer from an * xStreamBufferReceiveFromISR() to read from a stream buffer from an

Write Preview
Loading…
Cancel
Save