This module includes functions that manipulate OpenThread message buffers. More...

Data Structures
struct	otMessageQueue

Functions
void	otMessageFree (otMessage *aMessage)

uint16_t	otMessageGetLength (otMessage *aMessage)

otError	otMessageSetLength (otMessage *aMessage, uint16_t aLength)

uint16_t	otMessageGetOffset (otMessage *aMessage)

otError	otMessageSetOffset (otMessage *aMessage, uint16_t aOffset)

bool	otMessageIsLinkSecurityEnabled (otMessage *aMessage)

void	otMessageSetDirectTransmission (otMessage *aMessage, bool aEnabled)

int8_t	otMessageGetRss (otMessage *aMessage)

otError	otMessageAppend (otMessage aMessage, const void aBuf, uint16_t aLength)

int	otMessageRead (otMessage aMessage, uint16_t aOffset, void aBuf, uint16_t aLength)

int	otMessageWrite (otMessage aMessage, uint16_t aOffset, const void aBuf, uint16_t aLength)

void	otMessageQueueInit (otMessageQueue *aQueue)

otError	otMessageQueueEnqueue (otMessageQueue aQueue, otMessage aMessage)

otError	otMessageQueueEnqueueAtHead (otMessageQueue aQueue, otMessage aMessage)

otError	otMessageQueueDequeue (otMessageQueue aQueue, otMessage aMessage)

otMessage *	otMessageQueueGetHead (otMessageQueue *aQueue)

otMessage *	otMessageQueueGetNext (otMessageQueue aQueue, const otMessage aMessage)

OTAPI void OTCALL	otMessageGetBufferInfo (otInstance aInstance, otBufferInfo aBufferInfo)

Detailed Description

This module includes functions that manipulate OpenThread message buffers.

Function Documentation

otError otMessageAppend	(	otMessage *	aMessage,
		const void *	aBuf,
		uint16_t	aLength
	)

Append bytes to a message.

Parameters

[in]	aMessage	A pointer to a message buffer.
[in]	aBuf	A pointer to the data to append.
[in]	aLength	Number of bytes to append.

Return values

OT_ERROR_NONE	Successfully appended to the message
OT_ERROR_NO_BUFS	No available buffers to grow the message.

See Also: otMessageFree; otMessageGetLength; otMessageSetLength; otMessageGetOffset; otMessageSetOffset; otMessageRead; otMessageWrite

void otMessageFree ( otMessage * aMessage )

Free an allocated message buffer.

Parameters

[in] aMessage A pointer to a message buffer.

See Also: otMessageAppend; otMessageGetLength; otMessageSetLength; otMessageGetOffset; otMessageSetOffset; otMessageRead; otMessageWrite

OTAPI void OTCALL otMessageGetBufferInfo	(	otInstance *	aInstance,
		otBufferInfo *	aBufferInfo
	)

Get the Message Buffer information.

Parameters

[in]	aInstance	A pointer to the OpenThread instance.
[out]	aBufferInfo	A pointer where the message buffer information is written.

uint16_t otMessageGetLength ( otMessage * aMessage )

Get the message length in bytes.

Parameters

[in] aMessage A pointer to a message buffer.

Returns: The message length in bytes.

See Also: otMessageFree; otMessageAppend; otMessageSetLength; otMessageGetOffset; otMessageSetOffset; otMessageRead; otMessageWrite; otMessageSetLength

uint16_t otMessageGetOffset ( otMessage * aMessage )

Get the message offset in bytes.

Parameters

[in] aMessage A pointer to a message buffer.

Returns: The message offset value.

See Also: otMessageFree; otMessageAppend; otMessageGetLength; otMessageSetLength; otMessageSetOffset; otMessageRead; otMessageWrite

int8_t otMessageGetRss ( otMessage * aMessage )

This function returns the average RSS (received signal strength) associated with the message.

Returns: The average RSS value (in dBm) or OT_RADIO_RSSI_INVALID if no average/RSS is available.

bool otMessageIsLinkSecurityEnabled ( otMessage * aMessage )

This function indicates whether or not link security is enabled for the message.

Parameters

[in] aMessage A pointer to a message buffer.

Return values

TRUE	If link security is enabled.
FALSE	If link security is not enabled.

otError otMessageQueueDequeue	(	otMessageQueue *	aQueue,
		otMessage *	aMessage
	)

This function removes a message from the given message queue.

Parameters

[in]	aQueue	A pointer to the message queue.
[in]	aMessage	The message to remove.

Return values

OT_ERROR_NONE	Successfully removed the message from the queue.
OT_ERROR_NOT_FOUND	The message is not enqueued in this queue.

otError otMessageQueueEnqueue	(	otMessageQueue *	aQueue,
		otMessage *	aMessage
	)

This function adds a message to the end of the given message queue.

Parameters

[in]	aQueue	A pointer to the message queue.
[in]	aMessage	The message to add.

Return values

OT_ERROR_NONE	Successfully added the message to the queue.
OT_ERROR_ALREADY	The message is already enqueued in a queue.

otError otMessageQueueEnqueueAtHead	(	otMessageQueue *	aQueue,
		otMessage *	aMessage
	)

This function adds a message at the head/front of the given message queue.

Parameters

[in]	aQueue	A pointer to the message queue.
[in]	aMessage	The message to add.

Return values

OT_ERROR_NONE	Successfully added the message to the queue.
OT_ERROR_ALREADY	The message is already enqueued in a queue.

otMessage* otMessageQueueGetHead ( otMessageQueue * aQueue )

This function returns a pointer to the message at the head of the queue.

Parameters

[in] aQueue A pointer to a message queue.

Returns: A pointer to the message at the head of queue or NULL if queue is empty.

otMessage* otMessageQueueGetNext	(	otMessageQueue *	aQueue,
		const otMessage *	aMessage
	)

This function returns a pointer to the next message in the queue by iterating forward (from head to tail).

Parameters

[in]	aQueue	A pointer to a message queue.
[in]	aMessage	A pointer to current message buffer.

Returns: A pointer to the next message in the queue after aMessage or NULL if aMessage is the tail of queue. NULL is returned ifaMessageis not in the queueaQueue`.

void otMessageQueueInit ( otMessageQueue * aQueue )

Initialize the message queue.

This function MUST be called once and only once for a otMessageQueue instance before any other otMessageQueue functions. The behavior is undefined if other queue APIs are used with an otMessageQueue before it being initialized or if it is initialized more than once.

Parameters

[in] aQueue A pointer to a message queue.

int otMessageRead	(	otMessage *	aMessage,
		uint16_t	aOffset,
		void *	aBuf,
		uint16_t	aLength
	)

Read bytes from a message.

Parameters

[in]	aMessage	A pointer to a message buffer.
[in]	aOffset	An offset in bytes.
[in]	aBuf	A pointer to a buffer that message bytes are read to.
[in]	aLength	Number of bytes to read.

Returns: The number of bytes read.

See Also: otMessageFree; otMessageAppend; otMessageGetLength; otMessageSetLength; otMessageGetOffset; otMessageSetOffset; otMessageWrite

void otMessageSetDirectTransmission	(	otMessage *	aMessage,
		bool	aEnabled
	)

This function sets/forces the message to be forwarded using direct transmission. Default setting for a new message is false.

Parameters

[in]	aMessage	A pointer to a message buffer.
[in]	aEnabled	If `true`, the message is forced to use direct transmission. If `false`, the message follows the normal procedure.

otError otMessageSetLength	(	otMessage *	aMessage,
		uint16_t	aLength
	)

Set the message length in bytes.

Parameters

[in]	aMessage	A pointer to a message buffer.
[in]	aLength	A length in bytes.

Return values

OT_ERROR_NONE	Successfully set the message length.
OT_ERROR_NO_BUFS	No available buffers to grow the message.

See Also: otMessageFree; otMessageAppend; otMessageGetLength; otMessageGetOffset; otMessageSetOffset; otMessageRead; otMessageWrite

otError otMessageSetOffset	(	otMessage *	aMessage,
		uint16_t	aOffset
	)

Set the message offset in bytes.

Parameters

[in]	aMessage	A pointer to a message buffer.
[in]	aOffset	An offset in bytes.

Return values

OT_ERROR_NONE	Successfully set the message offset.
OT_ERROR_INVALID_ARGS	The offset is beyond the message length.

See Also: otMessageFree; otMessageAppend; otMessageGetLength; otMessageSetLength; otMessageGetOffset; otMessageRead; otMessageWrite

int otMessageWrite	(	otMessage *	aMessage,
		uint16_t	aOffset,
		const void *	aBuf,
		uint16_t	aLength
	)

Write bytes to a message.

Parameters

[in]	aMessage	A pointer to a message buffer.
[in]	aOffset	An offset in bytes.
[in]	aBuf	A pointer to a buffer that message bytes are written from.
[in]	aLength	Number of bytes to write.

Returns: The number of bytes written.

See Also: otMessageFree; otMessageAppend; otMessageGetLength; otMessageSetLength; otMessageGetOffset; otMessageSetOffset; otMessageRead

Data Structures

Functions

Detailed Description

Function Documentation