This PR contains a proposal for a new, blocking MQTTV5Client for C.
Important: While the build system will not fail, none of the new functionality is actually implemented. The implementation and testing will be part of a series of future PRs.
The PR contains commits from develop not yet in the mqttv5 branch (only the latest 3 commits are new). These should automatically disappear after a merge of develop into mqttv5.
Design
MQTTClient is reused as much as possible
#if defined(MQTTV5) used throughout MQTTClient.h/c
New MQTTClient functionality (for parity with V5):
MQTTPublishWithResults that exposes PUBACK/PUBCOMP information through a new PubDoneData struct.
MQTTV5 Client differences:
Init will require a reusable receive MQTTProperties* struct, allocated by the application. Behavior regarding running out of property space can also be controlled using the truncateRecvProperties parameter.
All V5 APIs accept or return MQTTProperties
New APIs, only available in V5:
MQTTV5Auth and MQTTV5SetAuthHandler (controlHandler)
MQTTV5SetDisconnectHandler(controlHandler)
MQTTV5UnsubscribeWithResults + MQTTV5UnsubackData
Documentation
All documentation for MQTTClient-C and MQTTV5Client-C has been updated.
This PR contains a proposal for a new, blocking MQTTV5Client for C. Important: While the build system will not fail, none of the new functionality is actually implemented. The implementation and testing will be part of a series of future PRs.
The PR contains commits from
developnot yet in themqttv5branch (only the latest 3 commits are new). These should automatically disappear after a merge of develop into mqttv5.Design
MQTTClient is reused as much as possible
#if defined(MQTTV5)used throughout MQTTClient.h/cMQTTPublishWithResultsthat exposes PUBACK/PUBCOMP information through a newPubDoneDatastruct.MQTTV5 Client differences:
MQTTProperties*struct, allocated by the application. Behavior regarding running out of property space can also be controlled using thetruncateRecvPropertiesparameter.MQTTV5AuthandMQTTV5SetAuthHandler(controlHandler)MQTTV5SetDisconnectHandler(controlHandler)MQTTV5UnsubscribeWithResults+MQTTV5UnsubackDataDocumentation
All documentation for MQTTClient-C and MQTTV5Client-C has been updated.