nRF Connect SDK API 0.1.0
Loading...
Searching...
No Matches

◆ nrf_cloud_coap_message_send()

int nrf_cloud_coap_message_send ( const char *  app_id,
const char *  message,
bool  json,
int64_t  ts_ms,
bool  confirmable 
)

#include <include/net/nrf_cloud_coap.h>

Send a message to nRF Cloud.

The JSON or CBOR message is sent either as a non-confirmable or confirmable CoAP message. Use non-confirmable when sending low priority information for which some data loss is acceptable.

Parameters
[in]app_idThe app_id identifying the type of data. See the values in nrf_cloud_defs.h that begin with NRF_CLOUD_JSON_APPID_. You may also use custom names.
[in]messageThe string to send.
[in]jsonSet true if the data should be sent in JSON format, otherwise CBOR.
[in]ts_msTimestamp the data was measured, or NRF_CLOUD_NO_TIMESTAMP.
[in]confirmableSelect whether to use a CON or NON CoAP transfer.
Return values
-EACCESDevice does not have a valid nRF Cloud CoAP connection.
Returns
0 If successful, nonzero if failed. Negative values are device-side errors defined in errno.h. Positive values are cloud-side errors (CoAP result codes) defined in zephyr/net/coap.h.