This module includes functions that control CoAP communication. More...

Collaboration diagram for CoAP:

Data Structures
struct	otCoapBlockwiseResource

struct	otCoapOption

struct	otCoapOptionIterator

struct	otCoapResource

struct	otCoapTxParameters

Macros
#define	OT_COAP_CODE(c, d) ((((c)&0x7) << 5) \| ((d)&0x1f))

#define	OT_COAP_DEFAULT_TOKEN_LENGTH 2
	Default token length. More...

#define	OT_COAP_MAX_RETRANSMIT 20
	Max retransmit supported by OpenThread. More...

#define	OT_COAP_MAX_TOKEN_LENGTH 8
	Max token length as specified (RFC 7252). More...

#define	OT_COAP_MIN_ACK_TIMEOUT 1000
	Minimal ACK timeout in milliseconds supported by OpenThread. More...

#define	OT_DEFAULT_COAP_PORT 5683
	Default CoAP port, as specified in RFC 7252. More...

Typedefs
typedef enum otCoapBlockSzx	otCoapBlockSzx

typedef otError(*	otCoapBlockwiseReceiveHook) (void aContext, const uint8_t aBlock, uint32_t aPosition, uint16_t aBlockLength, bool aMore, uint32_t aTotalLength)

typedef struct otCoapBlockwiseResource	otCoapBlockwiseResource

typedef otError(*	otCoapBlockwiseTransmitHook) (void aContext, uint8_t aBlock, uint32_t aPosition, uint16_t aBlockLength, bool aMore)

typedef enum otCoapCode	otCoapCode

typedef struct otCoapOption	otCoapOption

typedef enum otCoapOptionContentFormat	otCoapOptionContentFormat

typedef struct otCoapOptionIterator	otCoapOptionIterator

typedef enum otCoapOptionType	otCoapOptionType

typedef void(*	otCoapRequestHandler) (void aContext, otMessage aMessage, const otMessageInfo *aMessageInfo)

typedef struct otCoapResource	otCoapResource

typedef void(*	otCoapResponseHandler) (void aContext, otMessage aMessage, const otMessageInfo *aMessageInfo, otError aResult)

typedef struct otCoapTxParameters	otCoapTxParameters

typedef enum otCoapType	otCoapType

Enumerations
enum	otCoapBlockSzx { OT_COAP_OPTION_BLOCK_SZX_16 = 0, OT_COAP_OPTION_BLOCK_SZX_32 = 1, OT_COAP_OPTION_BLOCK_SZX_64 = 2, OT_COAP_OPTION_BLOCK_SZX_128 = 3, OT_COAP_OPTION_BLOCK_SZX_256 = 4, OT_COAP_OPTION_BLOCK_SZX_512 = 5, OT_COAP_OPTION_BLOCK_SZX_1024 = 6 }

enum	otCoapCode { OT_COAP_CODE_EMPTY = OT_COAP_CODE(0, 0), OT_COAP_CODE_GET = OT_COAP_CODE(0, 1), OT_COAP_CODE_POST = OT_COAP_CODE(0, 2), OT_COAP_CODE_PUT = OT_COAP_CODE(0, 3), OT_COAP_CODE_DELETE = OT_COAP_CODE(0, 4), OT_COAP_CODE_RESPONSE_MIN = OT_COAP_CODE(2, 0), OT_COAP_CODE_CREATED = OT_COAP_CODE(2, 1), OT_COAP_CODE_DELETED = OT_COAP_CODE(2, 2), OT_COAP_CODE_VALID = OT_COAP_CODE(2, 3), OT_COAP_CODE_CHANGED = OT_COAP_CODE(2, 4), OT_COAP_CODE_CONTENT = OT_COAP_CODE(2, 5), OT_COAP_CODE_CONTINUE = OT_COAP_CODE(2, 31), OT_COAP_CODE_BAD_REQUEST = OT_COAP_CODE(4, 0), OT_COAP_CODE_UNAUTHORIZED = OT_COAP_CODE(4, 1), OT_COAP_CODE_BAD_OPTION = OT_COAP_CODE(4, 2), OT_COAP_CODE_FORBIDDEN = OT_COAP_CODE(4, 3), OT_COAP_CODE_NOT_FOUND = OT_COAP_CODE(4, 4), OT_COAP_CODE_METHOD_NOT_ALLOWED = OT_COAP_CODE(4, 5), OT_COAP_CODE_NOT_ACCEPTABLE = OT_COAP_CODE(4, 6), OT_COAP_CODE_REQUEST_INCOMPLETE = OT_COAP_CODE(4, 8), OT_COAP_CODE_PRECONDITION_FAILED = OT_COAP_CODE(4, 12), OT_COAP_CODE_REQUEST_TOO_LARGE = OT_COAP_CODE(4, 13), OT_COAP_CODE_UNSUPPORTED_FORMAT = OT_COAP_CODE(4, 15), OT_COAP_CODE_INTERNAL_ERROR = OT_COAP_CODE(5, 0), OT_COAP_CODE_NOT_IMPLEMENTED = OT_COAP_CODE(5, 1), OT_COAP_CODE_BAD_GATEWAY = OT_COAP_CODE(5, 2), OT_COAP_CODE_SERVICE_UNAVAILABLE = OT_COAP_CODE(5, 3), OT_COAP_CODE_GATEWAY_TIMEOUT = OT_COAP_CODE(5, 4), OT_COAP_CODE_PROXY_NOT_SUPPORTED = OT_COAP_CODE(5, 5) }

enum	otCoapOptionContentFormat { OT_COAP_OPTION_CONTENT_FORMAT_TEXT_PLAIN = 0, OT_COAP_OPTION_CONTENT_FORMAT_COSE_ENCRYPT0 = 16, OT_COAP_OPTION_CONTENT_FORMAT_COSE_MAC0 = 17, OT_COAP_OPTION_CONTENT_FORMAT_COSE_SIGN1 = 18, OT_COAP_OPTION_CONTENT_FORMAT_LINK_FORMAT = 40, OT_COAP_OPTION_CONTENT_FORMAT_XML = 41, OT_COAP_OPTION_CONTENT_FORMAT_OCTET_STREAM = 42, OT_COAP_OPTION_CONTENT_FORMAT_EXI = 47, OT_COAP_OPTION_CONTENT_FORMAT_JSON = 50, OT_COAP_OPTION_CONTENT_FORMAT_JSON_PATCH_JSON = 51, OT_COAP_OPTION_CONTENT_FORMAT_MERGE_PATCH_JSON = 52, OT_COAP_OPTION_CONTENT_FORMAT_CBOR = 60, OT_COAP_OPTION_CONTENT_FORMAT_CWT = 61, OT_COAP_OPTION_CONTENT_FORMAT_COSE_ENCRYPT = 96, OT_COAP_OPTION_CONTENT_FORMAT_COSE_MAC = 97, OT_COAP_OPTION_CONTENT_FORMAT_COSE_SIGN = 98, OT_COAP_OPTION_CONTENT_FORMAT_COSE_KEY = 101, OT_COAP_OPTION_CONTENT_FORMAT_COSE_KEY_SET = 102, OT_COAP_OPTION_CONTENT_FORMAT_SENML_JSON = 110, OT_COAP_OPTION_CONTENT_FORMAT_SENSML_JSON = 111, OT_COAP_OPTION_CONTENT_FORMAT_SENML_CBOR = 112, OT_COAP_OPTION_CONTENT_FORMAT_SENSML_CBOR = 113, OT_COAP_OPTION_CONTENT_FORMAT_SENML_EXI = 114, OT_COAP_OPTION_CONTENT_FORMAT_SENSML_EXI = 115, OT_COAP_OPTION_CONTENT_FORMAT_COAP_GROUP_JSON = 256, OT_COAP_OPTION_CONTENT_FORMAT_SENML_XML = 310, OT_COAP_OPTION_CONTENT_FORMAT_SENSML_XML = 311 }

enum	otCoapOptionType { OT_COAP_OPTION_IF_MATCH = 1, OT_COAP_OPTION_URI_HOST = 3, OT_COAP_OPTION_E_TAG = 4, OT_COAP_OPTION_IF_NONE_MATCH = 5, OT_COAP_OPTION_OBSERVE = 6, OT_COAP_OPTION_URI_PORT = 7, OT_COAP_OPTION_LOCATION_PATH = 8, OT_COAP_OPTION_URI_PATH = 11, OT_COAP_OPTION_CONTENT_FORMAT = 12, OT_COAP_OPTION_MAX_AGE = 14, OT_COAP_OPTION_URI_QUERY = 15, OT_COAP_OPTION_ACCEPT = 17, OT_COAP_OPTION_LOCATION_QUERY = 20, OT_COAP_OPTION_BLOCK2 = 23, OT_COAP_OPTION_BLOCK1 = 27, OT_COAP_OPTION_SIZE2 = 28, OT_COAP_OPTION_PROXY_URI = 35, OT_COAP_OPTION_PROXY_SCHEME = 39, OT_COAP_OPTION_SIZE1 = 60 }

enum	otCoapType { OT_COAP_TYPE_CONFIRMABLE = 0, OT_COAP_TYPE_NON_CONFIRMABLE = 1, OT_COAP_TYPE_ACKNOWLEDGMENT = 2, OT_COAP_TYPE_RESET = 3 }

Functions
void	otCoapAddBlockWiseResource (otInstance aInstance, otCoapBlockwiseResource aResource)

void	otCoapAddResource (otInstance aInstance, otCoapResource aResource)

uint16_t	otCoapBlockSizeFromExponent (otCoapBlockSzx aSize)

otError	otCoapMessageAppendBlock1Option (otMessage *aMessage, uint32_t aNum, bool aMore, otCoapBlockSzx aSize)

otError	otCoapMessageAppendBlock2Option (otMessage *aMessage, uint32_t aNum, bool aMore, otCoapBlockSzx aSize)

otError	otCoapMessageAppendContentFormatOption (otMessage *aMessage, otCoapOptionContentFormat aContentFormat)

otError	otCoapMessageAppendMaxAgeOption (otMessage *aMessage, uint32_t aMaxAge)

otError	otCoapMessageAppendObserveOption (otMessage *aMessage, uint32_t aObserve)

otError	otCoapMessageAppendOption (otMessage aMessage, uint16_t aNumber, uint16_t aLength, const void aValue)

otError	otCoapMessageAppendProxyUriOption (otMessage aMessage, const char aUriPath)

otError	otCoapMessageAppendUintOption (otMessage *aMessage, uint16_t aNumber, uint32_t aValue)

otError	otCoapMessageAppendUriPathOptions (otMessage aMessage, const char aUriPath)

otError	otCoapMessageAppendUriQueryOption (otMessage aMessage, const char aUriQuery)

const char *	otCoapMessageCodeToString (const otMessage *aMessage)

void	otCoapMessageGenerateToken (otMessage *aMessage, uint8_t aTokenLength)

otCoapCode	otCoapMessageGetCode (const otMessage *aMessage)

uint16_t	otCoapMessageGetMessageId (const otMessage *aMessage)

const uint8_t *	otCoapMessageGetToken (const otMessage *aMessage)

uint8_t	otCoapMessageGetTokenLength (const otMessage *aMessage)

otCoapType	otCoapMessageGetType (const otMessage *aMessage)

void	otCoapMessageInit (otMessage *aMessage, otCoapType aType, otCoapCode aCode)

otError	otCoapMessageInitResponse (otMessage aResponse, const otMessage aRequest, otCoapType aType, otCoapCode aCode)

void	otCoapMessageSetCode (otMessage *aMessage, otCoapCode aCode)

otError	otCoapMessageSetPayloadMarker (otMessage *aMessage)

otError	otCoapMessageSetToken (otMessage aMessage, const uint8_t aToken, uint8_t aTokenLength)

otMessage *	otCoapNewMessage (otInstance aInstance, const otMessageSettings aSettings)

const otCoapOption *	otCoapOptionIteratorGetFirstOption (otCoapOptionIterator *aIterator)

const otCoapOption *	otCoapOptionIteratorGetFirstOptionMatching (otCoapOptionIterator *aIterator, uint16_t aOption)

const otCoapOption *	otCoapOptionIteratorGetNextOption (otCoapOptionIterator *aIterator)

const otCoapOption *	otCoapOptionIteratorGetNextOptionMatching (otCoapOptionIterator *aIterator, uint16_t aOption)

otError	otCoapOptionIteratorGetOptionUintValue (otCoapOptionIterator aIterator, uint64_t aValue)

otError	otCoapOptionIteratorGetOptionValue (otCoapOptionIterator aIterator, void aValue)

otError	otCoapOptionIteratorInit (otCoapOptionIterator aIterator, const otMessage aMessage)

void	otCoapRemoveBlockWiseResource (otInstance aInstance, otCoapBlockwiseResource aResource)

void	otCoapRemoveResource (otInstance aInstance, otCoapResource aResource)

static otError	otCoapSendRequest (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, otCoapResponseHandler aHandler, void aContext)

static otError	otCoapSendRequestBlockWise (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, otCoapResponseHandler aHandler, void aContext, otCoapBlockwiseTransmitHook aTransmitHook, otCoapBlockwiseReceiveHook aReceiveHook)

otError	otCoapSendRequestBlockWiseWithParameters (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, otCoapResponseHandler aHandler, void aContext, const otCoapTxParameters *aTxParameters, otCoapBlockwiseTransmitHook aTransmitHook, otCoapBlockwiseReceiveHook aReceiveHook)

otError	otCoapSendRequestWithParameters (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, otCoapResponseHandler aHandler, void aContext, const otCoapTxParameters *aTxParameters)

static otError	otCoapSendResponse (otInstance aInstance, otMessage aMessage, const otMessageInfo *aMessageInfo)

static otError	otCoapSendResponseBlockWise (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, void aContext, otCoapBlockwiseTransmitHook aTransmitHook)

otError	otCoapSendResponseBlockWiseWithParameters (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, const otCoapTxParameters aTxParameters, void *aContext, otCoapBlockwiseTransmitHook aTransmitHook)

otError	otCoapSendResponseWithParameters (otInstance aInstance, otMessage aMessage, const otMessageInfo aMessageInfo, const otCoapTxParameters aTxParameters)

void	otCoapSetDefaultHandler (otInstance aInstance, otCoapRequestHandler aHandler, void aContext)

otError	otCoapStart (otInstance *aInstance, uint16_t aPort)

otError	otCoapStop (otInstance *aInstance)

Detailed Description

This module includes functions that control CoAP communication.

The functions in this module are available when CoAP API feature (OPENTHREAD_CONFIG_COAP_API_ENABLE) is enabled.

Macro Definition Documentation

§ OT_DEFAULT_COAP_PORT

#define OT_DEFAULT_COAP_PORT 5683

Default CoAP port, as specified in RFC 7252.

§ OT_COAP_DEFAULT_TOKEN_LENGTH

#define OT_COAP_DEFAULT_TOKEN_LENGTH 2

Default token length.

§ OT_COAP_MAX_TOKEN_LENGTH

#define OT_COAP_MAX_TOKEN_LENGTH 8

Max token length as specified (RFC 7252).

§ OT_COAP_MAX_RETRANSMIT

#define OT_COAP_MAX_RETRANSMIT 20

Max retransmit supported by OpenThread.

Referenced by TxParameters::IsValid().

§ OT_COAP_MIN_ACK_TIMEOUT

#define OT_COAP_MIN_ACK_TIMEOUT 1000

Minimal ACK timeout in milliseconds supported by OpenThread.

Referenced by TxParameters::IsValid().

§ OT_COAP_CODE

#define OT_COAP_CODE	(	c,
		d
	)	((((c)&0x7) << 5) \| ((d)&0x1f))

Helper macro to define CoAP Code values.

Typedef Documentation

§ otCoapType

typedef enum otCoapType otCoapType

CoAP Type values (2 bit unsigned integer).

§ otCoapCode

typedef enum otCoapCode otCoapCode

CoAP Code values.

§ otCoapOptionType

typedef enum otCoapOptionType otCoapOptionType

CoAP Option Numbers

§ otCoapOption

typedef struct otCoapOption otCoapOption

This structure represents a CoAP option.

§ otCoapOptionIterator

typedef struct otCoapOptionIterator otCoapOptionIterator

This structure acts as an iterator for CoAP options

§ otCoapOptionContentFormat

typedef enum otCoapOptionContentFormat otCoapOptionContentFormat

CoAP Content Format codes. The full list is documented at https://www.iana.org/assignments/core-parameters/core-parameters.xhtml#content-formats

§ otCoapBlockSzx

typedef enum otCoapBlockSzx otCoapBlockSzx

CoAP Block Size Exponents

§ otCoapResponseHandler

typedef void(* otCoapResponseHandler) (void *aContext, otMessage *aMessage, const otMessageInfo *aMessageInfo, otError aResult)

This function pointer is called when a CoAP response is received or on the request timeout.

Parameters

[in]	aContext	A pointer to application-specific context.
[in]	aMessage	A pointer to the message buffer containing the response. NULL if no response was received.
[in]	aMessageInfo	A pointer to the message info for `aMessage`. NULL if no response was received.
[in]	aResult	A result of the CoAP transaction.

Return values

OT_ERROR_NONE	A response was received successfully.
OT_ERROR_ABORT	A CoAP transaction was reset by peer.
OT_ERROR_RESPONSE_TIMEOUT	No response or acknowledgment received during timeout period.

§ otCoapRequestHandler

typedef void(* otCoapRequestHandler) (void *aContext, otMessage *aMessage, const otMessageInfo *aMessageInfo)

This function pointer is called when a CoAP request with a given Uri-Path is received.

Parameters

[in]	aContext	A pointer to arbitrary context information.
[in]	aMessage	A pointer to the message.
[in]	aMessageInfo	A pointer to the message info for `aMessage`.

§ otCoapBlockwiseReceiveHook

typedef otError(* otCoapBlockwiseReceiveHook) (void *aContext, const uint8_t *aBlock, uint32_t aPosition, uint16_t aBlockLength, bool aMore, uint32_t aTotalLength)

This function pointer is called when a CoAP message with an block-wise transfer option is received.

This function is available when OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE configuration is enabled.

Parameters

[in]	aContext	A pointer to application-specific context.
[in]	aBlock	A pointer to the block segment.
[in]	aPosition	The position of `aBlock` in a sequence in bytes.
[in]	aBlockLength	The length of the block segment in bytes.
[in]	aMore	Flag if more block segments are following.
[in]	aTotalLength	The total length in bytes of the transferred information (indicated by a Size1 or Size2 option).

Return values

OT_ERROR_NONE	Block segment was stored successfully.
OT_ERROR_NO_BUFS	No more memory to store blocks.
OT_ERROR_NO_FRAME_RECEIVED	Block segment missing.

§ otCoapBlockwiseTransmitHook

typedef otError(* otCoapBlockwiseTransmitHook) (void *aContext, uint8_t *aBlock, uint32_t aPosition, uint16_t *aBlockLength, bool *aMore)

This function pointer is called before the next block in a block-wise transfer is sent.

This function is available when OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE configuration is enabled.

Parameters

[in]	aContext	A pointer to application-specific context.
[in,out]	aBlock	A pointer to where the block segment can be written to.
[in]	aPosition	The position in a sequence from which to obtain the block segment.
[in,out]	aBlockLength	On entry, the maximum block segment length in bytes.
[out]	aMore	A pointer to the flag if more block segments will follow.

Warning: By changing the value of aBlockLength, the block size of the whole exchange is renegotiated. It is recommended to do this after the first block has been received as later changes could cause problems with other CoAP implementations.

Return values

OT_ERROR_NONE	No error occurred.
OT_ERROR_INVALID_ARGS	Block at `aPosition` does not exist.

§ otCoapResource

typedef struct otCoapResource otCoapResource

This structure represents a CoAP resource.

§ otCoapBlockwiseResource

typedef struct otCoapBlockwiseResource otCoapBlockwiseResource

This structure represents a CoAP resource with block-wise transfer.

§ otCoapTxParameters

typedef struct otCoapTxParameters otCoapTxParameters

This structure represents the CoAP transmission parameters.

Note: mAckTimeout * ((2 ** (mMaxRetransmit + 1)) - 1) * (mAckRandomFactorNumerator / mAckRandomFactorDenominator) must not exceed what can be represented by a uint32_t (0xffffffff). This limitation allows OpenThread to avoid 64-bit arithmetic.

Enumeration Type Documentation

§ otCoapType

enum otCoapType

CoAP Type values (2 bit unsigned integer).

Enumerator
OT_COAP_TYPE_CONFIRMABLE	Confirmable.
OT_COAP_TYPE_NON_CONFIRMABLE	Non-confirmable.
OT_COAP_TYPE_ACKNOWLEDGMENT	Acknowledgment.
OT_COAP_TYPE_RESET	Reset.

§ otCoapCode

enum otCoapCode

CoAP Code values.

Enumerator
OT_COAP_CODE_EMPTY	Empty message code.
OT_COAP_CODE_GET	Get.
OT_COAP_CODE_POST	Post.
OT_COAP_CODE_PUT	Put.
OT_COAP_CODE_DELETE	Delete.
OT_COAP_CODE_RESPONSE_MIN	2.00
OT_COAP_CODE_CREATED	Created.
OT_COAP_CODE_DELETED	Deleted.
OT_COAP_CODE_VALID	Valid.
OT_COAP_CODE_CHANGED	Changed.
OT_COAP_CODE_CONTENT	Content.
OT_COAP_CODE_CONTINUE	RFC7959 Continue.
OT_COAP_CODE_BAD_REQUEST	Bad Request.
OT_COAP_CODE_UNAUTHORIZED	Unauthorized.
OT_COAP_CODE_BAD_OPTION	Bad Option.
OT_COAP_CODE_FORBIDDEN	Forbidden.
OT_COAP_CODE_NOT_FOUND	Not Found.
OT_COAP_CODE_METHOD_NOT_ALLOWED	Method Not Allowed.
OT_COAP_CODE_NOT_ACCEPTABLE	Not Acceptable.
OT_COAP_CODE_REQUEST_INCOMPLETE	RFC7959 Request Entity Incomplete.
OT_COAP_CODE_PRECONDITION_FAILED	Precondition Failed.
OT_COAP_CODE_REQUEST_TOO_LARGE	Request Entity Too Large.
OT_COAP_CODE_UNSUPPORTED_FORMAT	Unsupported Content-Format.
OT_COAP_CODE_INTERNAL_ERROR	Internal Server Error.
OT_COAP_CODE_NOT_IMPLEMENTED	Not Implemented.
OT_COAP_CODE_BAD_GATEWAY	Bad Gateway.
OT_COAP_CODE_SERVICE_UNAVAILABLE	Service Unavailable.
OT_COAP_CODE_GATEWAY_TIMEOUT	Gateway Timeout.
OT_COAP_CODE_PROXY_NOT_SUPPORTED	Proxying Not Supported.

§ otCoapOptionType

enum otCoapOptionType

CoAP Option Numbers

Enumerator
OT_COAP_OPTION_IF_MATCH	If-Match.
OT_COAP_OPTION_URI_HOST	Uri-Host.
OT_COAP_OPTION_E_TAG	ETag.
OT_COAP_OPTION_IF_NONE_MATCH	If-None-Match.
OT_COAP_OPTION_OBSERVE	Observe [RFC7641].
OT_COAP_OPTION_URI_PORT	Uri-Port.
OT_COAP_OPTION_LOCATION_PATH	Location-Path.
OT_COAP_OPTION_URI_PATH	Uri-Path.
OT_COAP_OPTION_CONTENT_FORMAT	Content-Format.
OT_COAP_OPTION_MAX_AGE	Max-Age.
OT_COAP_OPTION_URI_QUERY	Uri-Query.
OT_COAP_OPTION_ACCEPT	Accept.
OT_COAP_OPTION_LOCATION_QUERY	Location-Query.
OT_COAP_OPTION_BLOCK2	Block2 (RFC7959)
OT_COAP_OPTION_BLOCK1	Block1 (RFC7959)
OT_COAP_OPTION_SIZE2	Size2 (RFC7959)
OT_COAP_OPTION_PROXY_URI	Proxy-Uri.
OT_COAP_OPTION_PROXY_SCHEME	Proxy-Scheme.
OT_COAP_OPTION_SIZE1	Size1.

§ otCoapOptionContentFormat

enum otCoapOptionContentFormat

CoAP Content Format codes. The full list is documented at https://www.iana.org/assignments/core-parameters/core-parameters.xhtml#content-formats

Enumerator
OT_COAP_OPTION_CONTENT_FORMAT_TEXT_PLAIN	text/plain; charset=utf-8: [RFC2046][RFC3676][RFC5147]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_ENCRYPT0	application/cose; cose-type="cose-encrypt0": [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_MAC0	application/cose; cose-type="cose-mac0": [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_SIGN1	application/cose; cose-type="cose-sign1": [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_LINK_FORMAT	application/link-format: [RFC6690]
OT_COAP_OPTION_CONTENT_FORMAT_XML	application/xml: [RFC3023]
OT_COAP_OPTION_CONTENT_FORMAT_OCTET_STREAM	application/octet-stream: [RFC2045][RFC2046]
OT_COAP_OPTION_CONTENT_FORMAT_EXI	application/exi: ["Efficient XML Interchange (EXI) Format 1.0 (Second Edition)", February 2014]
OT_COAP_OPTION_CONTENT_FORMAT_JSON	application/json: [RFC7159]
OT_COAP_OPTION_CONTENT_FORMAT_JSON_PATCH_JSON	application/json-patch+json: [RFC6902]
OT_COAP_OPTION_CONTENT_FORMAT_MERGE_PATCH_JSON	application/merge-patch+json: [RFC7396]
OT_COAP_OPTION_CONTENT_FORMAT_CBOR	application/cbor: [RFC7049]
OT_COAP_OPTION_CONTENT_FORMAT_CWT	application/cwt: [RFC8392]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_ENCRYPT	application/cose; cose-type="cose-encrypt": [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_MAC	application/cose; cose-type="cose-mac": [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_SIGN	application/cose; cose-type="cose-sign": [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_KEY	application/cose-key: [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_COSE_KEY_SET	application/cose-key-set: [RFC8152]
OT_COAP_OPTION_CONTENT_FORMAT_SENML_JSON	application/senml+json: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_SENSML_JSON	application/sensml+json: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_SENML_CBOR	application/senml+cbor: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_SENSML_CBOR	application/sensml+cbor: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_SENML_EXI	application/senml-exi: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_SENSML_EXI	application/sensml-exi: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_COAP_GROUP_JSON	application/coap-group+json: [RFC7390]
OT_COAP_OPTION_CONTENT_FORMAT_SENML_XML	application/senml+xml: [RFC8428]
OT_COAP_OPTION_CONTENT_FORMAT_SENSML_XML	application/sensml+xml: [RFC8428]

§ otCoapBlockSzx

enum otCoapBlockSzx

CoAP Block Size Exponents

Enumerator
OT_COAP_OPTION_BLOCK_SZX_16
OT_COAP_OPTION_BLOCK_SZX_32
OT_COAP_OPTION_BLOCK_SZX_64
OT_COAP_OPTION_BLOCK_SZX_128
OT_COAP_OPTION_BLOCK_SZX_256
OT_COAP_OPTION_BLOCK_SZX_512
OT_COAP_OPTION_BLOCK_SZX_1024

Function Documentation

§ otCoapMessageInit()

void otCoapMessageInit	(	otMessage *	aMessage,
		otCoapType	aType,
		otCoapCode	aCode
	)

This function initializes the CoAP header.

Parameters

[in,out]	aMessage	A pointer to the CoAP message to initialize.
[in]	aType	CoAP message type.
[in]	aCode	CoAP message code.

§ otCoapMessageInitResponse()

otError otCoapMessageInitResponse	(	otMessage *	aResponse,
		const otMessage *	aRequest,
		otCoapType	aType,
		otCoapCode	aCode
	)

This function initializes a response message.

Note: Both message ID and token are set according to aRequest.

Parameters

[in,out]	aResponse	A pointer to the CoAP response message.
[in]	aRequest	A pointer to the CoAP request message.
[in]	aType	CoAP message type.
[in]	aCode	CoAP message code.

Return values

OT_ERROR_NONE	Successfully initialized the response message.
OT_ERROR_NO_BUFS	Insufficient message buffers available to initialize the response message.

§ otCoapMessageSetToken()

otError otCoapMessageSetToken	(	otMessage *	aMessage,
		const uint8_t *	aToken,
		uint8_t	aTokenLength
	)

This function sets the Token value and length in a header.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aToken	A pointer to the Token value.
[in]	aTokenLength	The Length of `aToken`.

Return values

OT_ERROR_NONE	Successfully set the Token value.
OT_ERROR_NO_BUFS	Insufficient buffers to set the Token value.

§ otCoapMessageGenerateToken()

void otCoapMessageGenerateToken	(	otMessage *	aMessage,
		uint8_t	aTokenLength
	)

This function sets the Token length and randomizes its value.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aTokenLength	The Length of a Token to set.

§ otCoapMessageAppendContentFormatOption()

otError otCoapMessageAppendContentFormatOption	(	otMessage *	aMessage,
		otCoapOptionContentFormat	aContentFormat
	)

This function appends the Content Format CoAP option as specified in https://tools.ietf.org/html/rfc7252#page-92. This must be called before setting otCoapMessageSetPayloadMarker if a payload is to be included in the message.

The function is a convenience wrapper around otCoapMessageAppendUintOption, and if the desired format type code isn't listed in otCoapOptionContentFormat, this base function should be used instead.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aContentFormat	One of the content formats listed in otCoapOptionContentFormat above.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendOption()

otError otCoapMessageAppendOption	(	otMessage *	aMessage,
		uint16_t	aNumber,
		uint16_t	aLength,
		const void *	aValue
	)

This function appends a CoAP option in a header.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aNumber	The CoAP Option number.
[in]	aLength	The CoAP Option length.
[in]	aValue	A pointer to the CoAP value.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendUintOption()

otError otCoapMessageAppendUintOption	(	otMessage *	aMessage,
		uint16_t	aNumber,
		uint32_t	aValue
	)

This function appends an unsigned integer CoAP option as specified in https://tools.ietf.org/html/rfc7252#section-3.2

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aNumber	The CoAP Option number.
[in]	aValue	The CoAP Option unsigned integer value.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

See also: otCoapMessageGetOptionUintValue

§ otCoapMessageAppendObserveOption()

otError otCoapMessageAppendObserveOption	(	otMessage *	aMessage,
		uint32_t	aObserve
	)

This function appends an Observe option.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aObserve	Observe field value.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendUriPathOptions()

otError otCoapMessageAppendUriPathOptions	(	otMessage *	aMessage,
		const char *	aUriPath
	)

This function appends a Uri-Path option.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aUriPath	A pointer to a NULL-terminated string.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapBlockSizeFromExponent()

uint16_t otCoapBlockSizeFromExponent ( otCoapBlockSzx aSize )

This function converts a CoAP Block option SZX field to the actual block size

Parameters

[in] aSize Block size exponent.

Returns: The actual size exponent value.

Referenced by CoapBase::DequeueMessage(), and CoapBase::SendMessage().

§ otCoapMessageAppendBlock2Option()

otError otCoapMessageAppendBlock2Option	(	otMessage *	aMessage,
		uint32_t	aNum,
		bool	aMore,
		otCoapBlockSzx	aSize
	)

This function appends a Block2 option

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aNum	Current block number.
[in]	aMore	Boolean to indicate more blocks are to be sent.
[in]	aSize	Block Size Exponent.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendBlock1Option()

otError otCoapMessageAppendBlock1Option	(	otMessage *	aMessage,
		uint32_t	aNum,
		bool	aMore,
		otCoapBlockSzx	aSize
	)

This function appends a Block1 option

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aNum	Current block number.
[in]	aMore	Boolean to indicate more blocks are to be sent.
[in]	aSize	Block Size Exponent.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendProxyUriOption()

otError otCoapMessageAppendProxyUriOption	(	otMessage *	aMessage,
		const char *	aUriPath
	)

This function appends a Proxy-Uri option.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aUriPath	A pointer to a NULL-terminated string.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendMaxAgeOption()

otError otCoapMessageAppendMaxAgeOption	(	otMessage *	aMessage,
		uint32_t	aMaxAge
	)

This function appends a Max-Age option.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aMaxAge	The Max-Age value.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageAppendUriQueryOption()

otError otCoapMessageAppendUriQueryOption	(	otMessage *	aMessage,
		const char *	aUriQuery
	)

This function appends a single Uri-Query option.

Parameters

[in,out]	aMessage	A pointer to the CoAP message.
[in]	aUriQuery	A pointer to NULL-terminated string, which should contain a single key=value pair.

Return values

OT_ERROR_NONE	Successfully appended the option.
OT_ERROR_INVALID_ARGS	The option type is not equal or greater than the last option type.
OT_ERROR_NO_BUFS	The option length exceeds the buffer size.

§ otCoapMessageSetPayloadMarker()

otError otCoapMessageSetPayloadMarker ( otMessage * aMessage )

This function adds Payload Marker indicating beginning of the payload to the CoAP header.

Parameters

[in,out] aMessage A pointer to the CoAP message.

Return values

OT_ERROR_NONE	Payload Marker successfully added.
OT_ERROR_NO_BUFS	Header Payload Marker exceeds the buffer size.

§ otCoapMessageGetType()

otCoapType otCoapMessageGetType ( const otMessage * aMessage )

This function returns the Type value.

Parameters

[in] aMessage A pointer to the CoAP message.

Returns: The Type value.

§ otCoapMessageGetCode()

otCoapCode otCoapMessageGetCode ( const otMessage * aMessage )

This function returns the Code value.

Parameters

[in] aMessage A pointer to the CoAP message.

Returns: The Code value.

§ otCoapMessageSetCode()

void otCoapMessageSetCode	(	otMessage *	aMessage,
		otCoapCode	aCode
	)

This function sets the Code value.

Parameters

[in,out]	aMessage	A pointer to the CoAP message to initialize.
[in]	aCode	CoAP message code.

§ otCoapMessageCodeToString()

const char* otCoapMessageCodeToString ( const otMessage * aMessage )

This method returns the CoAP Code as human readable string.

Parameters

[in] aMessage A pointer to the CoAP message.

@ returns The CoAP Code as string.

§ otCoapMessageGetMessageId()

uint16_t otCoapMessageGetMessageId ( const otMessage * aMessage )

This function returns the Message ID value.

Parameters

[in] aMessage A pointer to the CoAP message.

Returns: The Message ID value.

§ otCoapMessageGetTokenLength()

uint8_t otCoapMessageGetTokenLength ( const otMessage * aMessage )

This function returns the Token length.

Parameters

[in] aMessage A pointer to the CoAP message.

Returns: The Token length.

§ otCoapMessageGetToken()

const uint8_t* otCoapMessageGetToken ( const otMessage * aMessage )

This function returns a pointer to the Token value.

Parameters

[in] aMessage A pointer to the CoAP message.

Returns: A pointer to the Token value.

§ otCoapOptionIteratorInit()

otError otCoapOptionIteratorInit	(	otCoapOptionIterator *	aIterator,
		const otMessage *	aMessage
	)

This function initialises an iterator for the options in the given message.

Parameters

[in,out]	aIterator	A pointer to the CoAP message option iterator.
[in]	aMessage	A pointer to the CoAP message.

Return values

OT_ERROR_NONE	Successfully initialised.
OT_ERROR_PARSE	Message state is inconsistent.

§ otCoapOptionIteratorGetFirstOptionMatching()

const otCoapOption* otCoapOptionIteratorGetFirstOptionMatching	(	otCoapOptionIterator *	aIterator,
		uint16_t	aOption
	)

This function returns a pointer to the first option matching the specified option number.

Parameters

[in]	aIterator	A pointer to the CoAP message option iterator.
[in]	aOption	The option number sought.

Returns: A pointer to the first matching option. If no matching option is present NULL pointer is returned.

§ otCoapOptionIteratorGetFirstOption()

const otCoapOption* otCoapOptionIteratorGetFirstOption ( otCoapOptionIterator * aIterator )

This function returns a pointer to the first option.

Parameters

[in,out] aIterator A pointer to the CoAP message option iterator.

Returns: A pointer to the first option. If no option is present NULL pointer is returned.

§ otCoapOptionIteratorGetNextOptionMatching()

const otCoapOption* otCoapOptionIteratorGetNextOptionMatching	(	otCoapOptionIterator *	aIterator,
		uint16_t	aOption
	)

This function returns a pointer to the next option matching the specified option number.

Parameters

[in]	aIterator	A pointer to the CoAP message option iterator.
[in]	aOption	The option number sought.

Returns: A pointer to the next matching option. If no further matching option is present NULL pointer is returned.

§ otCoapOptionIteratorGetNextOption()

const otCoapOption* otCoapOptionIteratorGetNextOption ( otCoapOptionIterator * aIterator )

This function returns a pointer to the next option.

Parameters

[in,out] aIterator A pointer to the CoAP message option iterator.

Returns: A pointer to the next option. If no more options are present NULL pointer is returned.

§ otCoapOptionIteratorGetOptionUintValue()

otError otCoapOptionIteratorGetOptionUintValue	(	otCoapOptionIterator *	aIterator,
		uint64_t *	aValue
	)

This function fills current option value into aValue assuming the current value is an unsigned integer encoded according to https://tools.ietf.org/html/rfc7252#section-3.2

Parameters

[in,out]	aIterator	A pointer to the CoAP message option iterator.
[out]	aValue	A pointer to an unsigned integer to receive the option value.

Return values

OT_ERROR_NONE	Successfully filled value.
OT_ERROR_NOT_FOUND	No current option.
OT_ERROR_NO_BUFS	Value is too long to fit in a uint64_t.

See also: otCoapMessageAppendUintOption

§ otCoapOptionIteratorGetOptionValue()

otError otCoapOptionIteratorGetOptionValue	(	otCoapOptionIterator *	aIterator,
		void *	aValue
	)

This function fills current option value into aValue.

Parameters

[in,out]	aIterator	A pointer to the CoAP message option iterator.
[out]	aValue	A pointer to a buffer to receive the option value.

Return values

OT_ERROR_NONE	Successfully filled value.
OT_ERROR_NOT_FOUND	No current option.

§ otCoapNewMessage()

otMessage* otCoapNewMessage	(	otInstance *	aInstance,
		const otMessageSettings *	aSettings
	)

This function creates a new CoAP message.

Note: If aSettings is 'NULL', the link layer security is enabled and the message priority is set to OT_MESSAGE_PRIORITY_NORMAL by default.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aSettings	A pointer to the message settings or NULL to set default settings.

Returns: A pointer to the message buffer or NULL if no message buffers are available or parameters are invalid.

§ otCoapSendRequestWithParameters()

otError otCoapSendRequestWithParameters	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		otCoapResponseHandler	aHandler,
		void *	aContext,
		const otCoapTxParameters *	aTxParameters
	)

This function sends a CoAP request with custom transmission parameters.

If a response for a request is expected, respective function and context information should be provided. If no response is expected, these arguments should be NULL pointers.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the message to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aHandler	A function pointer that shall be called on response reception or timeout.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.
[in]	aTxParameters	A pointer to transmission parameters for this request. Use NULL for defaults. Otherwise, parameters given must meet the following conditions: mMaxRetransmit is no more than OT_COAP_MAX_RETRANSMIT. mAckRandomFactorNumerator / mAckRandomFactorDenominator must not be below 1.0. The calculated exchange life time must not overflow uint32_t.

Return values

OT_ERROR_INVALID_ARGS	`aTxParameters` is invalid.
OT_ERROR_NONE	Successfully sent CoAP message.
OT_ERROR_NO_BUFS	Failed to allocate retransmission data.

Referenced by otCoapSendRequest().

§ otCoapSendRequestBlockWiseWithParameters()

otError otCoapSendRequestBlockWiseWithParameters	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		otCoapResponseHandler	aHandler,
		void *	aContext,
		const otCoapTxParameters *	aTxParameters,
		otCoapBlockwiseTransmitHook	aTransmitHook,
		otCoapBlockwiseReceiveHook	aReceiveHook
	)

This function sends a CoAP request block-wise with custom transmission parameters.

This function is available when OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE configuration is enabled.

If a response for a request is expected, respective function and context information should be provided. If the response is expected to be block-wise, a respective hook function should be provided. If no response is expected, these arguments should be NULL pointers.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the message to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aHandler	A function pointer that shall be called on response reception or timeout.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.
[in]	aTxParameters	A pointer to transmission parameters for this request. Use NULL for defaults.
[in]	aTransmitHook	A pointer to a hook function for outgoing block-wise transfer.
[in]	aReceiveHook	A pointer to a hook function for incoming block-wise transfer.

Return values

OT_ERROR_NONE	Successfully sent CoAP message.
OT_ERROR_NO_BUFS	Failed to allocate retransmission data.

Referenced by otCoapSendRequestBlockWise().

§ otCoapSendRequestBlockWise()

static otError otCoapSendRequestBlockWise	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		otCoapResponseHandler	aHandler,
		void *	aContext,
		otCoapBlockwiseTransmitHook	aTransmitHook,
		otCoapBlockwiseReceiveHook	aReceiveHook
	)

inlinestatic

This function sends a CoAP request block-wise.

This function is available when OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE configuration is enabled.

If a response for a request is expected, respective function and context information should be provided. If the response is expected to be block-wise, a respective hook function should be provided. If no response is expected, these arguments should be NULL pointers.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the message to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aHandler	A function pointer that shall be called on response reception or timeout.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.
[in]	aTransmitHook	A pointer to a hook function for outgoing block-wise transfer.
[in]	aReceiveHook	A pointer to a hook function for incoming block-wise transfer.

Return values

OT_ERROR_NONE	Successfully sent CoAP message.
OT_ERROR_NO_BUFS	Failed to allocate retransmission data.

References otCoapSendRequestBlockWiseWithParameters().

§ otCoapSendRequest()

static otError otCoapSendRequest	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		otCoapResponseHandler	aHandler,
		void *	aContext
	)

inlinestatic

This function sends a CoAP request.

If a response for a request is expected, respective function and context information should be provided. If no response is expected, these arguments should be NULL pointers.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the message to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aHandler	A function pointer that shall be called on response reception or timeout.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.

Return values

OT_ERROR_NONE	Successfully sent CoAP message.
OT_ERROR_NO_BUFS	Failed to allocate retransmission data.

References otCoapAddBlockWiseResource(), otCoapAddResource(), otCoapRemoveBlockWiseResource(), otCoapRemoveResource(), otCoapSendRequestWithParameters(), otCoapSendResponseBlockWiseWithParameters(), otCoapSendResponseWithParameters(), otCoapSetDefaultHandler(), otCoapStart(), and otCoapStop().

§ otCoapStart()

otError otCoapStart	(	otInstance *	aInstance,
		uint16_t	aPort
	)

This function starts the CoAP server.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aPort	The local UDP port to bind to.

Return values

OT_ERROR_NONE	Successfully started the CoAP server.
OT_ERROR_FAILED	Failed to start the CoAP server.

Referenced by otCoapSendRequest().

§ otCoapStop()

otError otCoapStop ( otInstance * aInstance )

This function stops the CoAP server.

Parameters

[in] aInstance A pointer to an OpenThread instance.

Return values

OT_ERROR_NONE Successfully stopped the CoAP server.

Referenced by otCoapSendRequest().

§ otCoapAddResource()

void otCoapAddResource	(	otInstance *	aInstance,
		otCoapResource *	aResource
	)

This function adds a resource to the CoAP server.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aResource	A pointer to the resource.

Referenced by otCoapSendRequest().

§ otCoapRemoveResource()

void otCoapRemoveResource	(	otInstance *	aInstance,
		otCoapResource *	aResource
	)

This function removes a resource from the CoAP server.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aResource	A pointer to the resource.

Referenced by otCoapSendRequest().

§ otCoapAddBlockWiseResource()

void otCoapAddBlockWiseResource	(	otInstance *	aInstance,
		otCoapBlockwiseResource *	aResource
	)

This function adds a block-wise resource to the CoAP server.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aResource	A pointer to the resource.

Referenced by otCoapSendRequest().

§ otCoapRemoveBlockWiseResource()

void otCoapRemoveBlockWiseResource	(	otInstance *	aInstance,
		otCoapBlockwiseResource *	aResource
	)

This function removes a block-wise resource from the CoAP server.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aResource	A pointer to the resource.

Referenced by otCoapSendRequest().

§ otCoapSetDefaultHandler()

void otCoapSetDefaultHandler	(	otInstance *	aInstance,
		otCoapRequestHandler	aHandler,
		void *	aContext
	)

This function sets the default handler for unhandled CoAP requests.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aHandler	A function pointer that shall be called when an unhandled request arrives.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.

Referenced by otCoapSendRequest().

§ otCoapSendResponseWithParameters()

otError otCoapSendResponseWithParameters	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		const otCoapTxParameters *	aTxParameters
	)

This function sends a CoAP response from the server with custom transmission parameters.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the CoAP response to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aTxParameters	A pointer to transmission parameters for this response. Use NULL for defaults.

Return values

OT_ERROR_NONE	Successfully enqueued the CoAP response message.
OT_ERROR_NO_BUFS	Insufficient buffers available to send the CoAP response.

Referenced by otCoapSendRequest(), and otCoapSendResponse().

§ otCoapSendResponseBlockWiseWithParameters()

otError otCoapSendResponseBlockWiseWithParameters	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		const otCoapTxParameters *	aTxParameters,
		void *	aContext,
		otCoapBlockwiseTransmitHook	aTransmitHook
	)

This function sends a CoAP response block-wise from the server with custom transmission parameters.

This function is available when OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE configuration is enabled.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the CoAP response to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aTxParameters	A pointer to transmission parameters for this response. Use NULL for defaults.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.
[in]	aTransmitHook	A pointer to a hook function for outgoing block-wise transfer.

Return values

OT_ERROR_NONE	Successfully enqueued the CoAP response message.
OT_ERROR_NO_BUFS	Insufficient buffers available to send the CoAP response.

Referenced by otCoapSendRequest(), and otCoapSendResponseBlockWise().

§ otCoapSendResponseBlockWise()

static otError otCoapSendResponseBlockWise	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo,
		void *	aContext,
		otCoapBlockwiseTransmitHook	aTransmitHook
	)

inlinestatic

This function sends a CoAP response block-wise from the server.

This function is available when OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE configuration is enabled.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the CoAP response to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.
[in]	aContext	A pointer to arbitrary context information. May be NULL if not used.
[in]	aTransmitHook	A pointer to a hook function for outgoing block-wise transfer.

Return values

OT_ERROR_NONE	Successfully enqueued the CoAP response message.
OT_ERROR_NO_BUFS	Insufficient buffers available to send the CoAP response.

References otCoapSendResponseBlockWiseWithParameters().

§ otCoapSendResponse()

static otError otCoapSendResponse	(	otInstance *	aInstance,
		otMessage *	aMessage,
		const otMessageInfo *	aMessageInfo
	)

inlinestatic

This function sends a CoAP response from the server.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aMessage	A pointer to the CoAP response to send.
[in]	aMessageInfo	A pointer to the message info associated with `aMessage`.

Return values

OT_ERROR_NONE	Successfully enqueued the CoAP response message.
OT_ERROR_NO_BUFS	Insufficient buffers available to send the CoAP response.

References otCoapSendResponseWithParameters().

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

§ OT_DEFAULT_COAP_PORT

§ OT_COAP_DEFAULT_TOKEN_LENGTH

§ OT_COAP_MAX_TOKEN_LENGTH

§ OT_COAP_MAX_RETRANSMIT

§ OT_COAP_MIN_ACK_TIMEOUT

§ OT_COAP_CODE

Typedef Documentation

§ otCoapType

§ otCoapCode

§ otCoapOptionType

§ otCoapOption

§ otCoapOptionIterator

§ otCoapOptionContentFormat

§ otCoapBlockSzx

§ otCoapResponseHandler

§ otCoapRequestHandler

§ otCoapBlockwiseReceiveHook

§ otCoapBlockwiseTransmitHook

§ otCoapResource

§ otCoapBlockwiseResource

§ otCoapTxParameters

Enumeration Type Documentation

§ otCoapType

§ otCoapCode

§ otCoapOptionType

§ otCoapOptionContentFormat

§ otCoapBlockSzx

Function Documentation

§ otCoapMessageInit()

§ otCoapMessageInitResponse()

§ otCoapMessageSetToken()

§ otCoapMessageGenerateToken()

§ otCoapMessageAppendContentFormatOption()

§ otCoapMessageAppendOption()

§ otCoapMessageAppendUintOption()

§ otCoapMessageAppendObserveOption()

§ otCoapMessageAppendUriPathOptions()

§ otCoapBlockSizeFromExponent()

§ otCoapMessageAppendBlock2Option()

§ otCoapMessageAppendBlock1Option()

§ otCoapMessageAppendProxyUriOption()

§ otCoapMessageAppendMaxAgeOption()

§ otCoapMessageAppendUriQueryOption()

§ otCoapMessageSetPayloadMarker()

§ otCoapMessageGetType()

§ otCoapMessageGetCode()

§ otCoapMessageSetCode()

§ otCoapMessageCodeToString()

§ otCoapMessageGetMessageId()

§ otCoapMessageGetTokenLength()

§ otCoapMessageGetToken()

§ otCoapOptionIteratorInit()

§ otCoapOptionIteratorGetFirstOptionMatching()

§ otCoapOptionIteratorGetFirstOption()

§ otCoapOptionIteratorGetNextOptionMatching()

§ otCoapOptionIteratorGetNextOption()

§ otCoapOptionIteratorGetOptionUintValue()

§ otCoapOptionIteratorGetOptionValue()

§ otCoapNewMessage()

§ otCoapSendRequestWithParameters()

§ otCoapSendRequestBlockWiseWithParameters()

§ otCoapSendRequestBlockWise()

§ otCoapSendRequest()

§ otCoapStart()

§ otCoapStop()

§ otCoapAddResource()

§ otCoapRemoveResource()

§ otCoapAddBlockWiseResource()

§ otCoapRemoveBlockWiseResource()

§ otCoapSetDefaultHandler()

§ otCoapSendResponseWithParameters()

§ otCoapSendResponseBlockWiseWithParameters()

§ otCoapSendResponseBlockWise()