µC/MQTT-client offers many structures that the application can use to create objects to interact with the µC/MQTT-client stack.
All the MQTT-client objects required by the application must be allocated by the application and passed to the µC/MQTT-client stack.
All objects or strings passed to the µC/MQTT-client stack MUST stay valid and unmodified for the duration of the MQTT message for message-oriented parameters and objects; or until the MQTT connection is closed for Connection-oriented parameters and objects.
MQTT-client Connection (MQTTc_CONN)
This structure is the main one used by µC/MQTT-client. It contains all parameters relative to an MQTT connection (server port number, server address, server host name, etc.) and also many internal parameters for the MQTT connection and MQTT message processing.
Each configurable parameter SHOULD be set up with the function MQTTc_ConnSetParam(). The list of available parameters for a connection can be viewed here.
The members of an MQTT-client Connection object should never be directly tampered with at any time.
MQTT-client Message (MQTTc_MSG)
This structure regroups parameters and flags related to the configuration of an MQTT message.
Each configurable parameter SHOULD be set up with the function MQTTc_MsgSetParam(). The list of available parameters for a connection can be viewed here.
The members of an MQTT-client Message object should never be directly tempered with at any time.