Send a 'Publish' message to MQTT server.
Files
mqtt-c.h/mqtt-c.c
Prototype
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.
payload_str
String containing the payload to publish. Must stay valid until the message has been completely sent.
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).