MQTTc_Publish
Send a 'Publish' message to MQTT server.
Files
mqtt-c.h/mqtt-c.c
Prototype
void MQTTc_Publish ( MQTTc_CONN *p_conn, MQTTc_MSG *p_msg, const CPU_CHAR *topic_str, CPU_INT08U qos_lvl, CPU_BOOLEAN retain_flag, const CPU_CHAR *p_payload, CPU_INT32U payload_len, MQTTc_ERR *p_err);
Arguments
p_conn
Pointer to MQTTc Connection to use.
p_msg
Pointer to MQTTc Message object to use.
topic_str
String containing the topic on which to publish. Must stay valid until the message has been completely sent.
qos_lvl
Level of QoS at which to publish.
retain_flag
Flag indicating if the retain flag in the PUBLISH
header needs to be set.
p_payload
Pointer to the payload to publish. Must stay valid until the message has been completely sent.
payload_len
The length of the payload to publish.
p_err
Pointer to variable that will receive the return error code from this function:
MQTTc_ERR_NONE
MQTTc_ERR_NOT_INIT
MQTTc_ERR_NULL_PTR
MQTTc_ERR_INVALID_ARG
MQTTc_ERR_INVALID_BUF_SIZE
MQTTc_ERR_FAIL
Returned Values
None.
Required Configuration
None.
Notes / Warnings
- This function MUST be called after the µC/MQTT-client initialization has been completed.
- Both the
MQTTc_CONN
object and theMQTTc_MSG
object used MUST stay valid until the message has completed (callback has been called).