Vergil Cola / Mbed OS HelloMQTT Featured

A Threaded Secure MQTT Client example. Uses MBED TLS for SSL/TLS connection. QoS0 only for now. Example has been tested with K64F connected via Ethernet.

Dependencies:   FP MQTTPacket

Fork of HelloMQTT by MQTT

MQTTThreadedClient.h@26:4b21de8043a5, 2017-03-27 (annotated)

Committer:
vpcola
Date:
Mon Mar 27 13:45:26 2017 +0000
Revision:
26:4b21de8043a5
Parent:
25:326f00faa092
Child:
27:c90092f35d79
TLS now working

Who changed what in which revision?

UserRevisionLine numberNew contents of line
vpcola 23:06fac173529e 1 #ifndef _MQTT_THREADED_CLIENT_H_
vpcola 23:06fac173529e 2 #define _MQTT_THREADED_CLIENT_H_
vpcola 23:06fac173529e 3
vpcola 23:06fac173529e 4 #include "mbed.h"
vpcola 23:06fac173529e 5 #include "rtos.h"
vpcola 23:06fac173529e 6 #include "MQTTPacket.h"
vpcola 23:06fac173529e 7 #include "NetworkInterface.h"
vpcola 23:06fac173529e 8 #include "FP.h"
vpcola 23:06fac173529e 9
vpcola 25:326f00faa092 10
vpcola 23:06fac173529e 11 #include <cstdio>
vpcola 23:06fac173529e 12 #include <string>
vpcola 23:06fac173529e 13 #include <map>
vpcola 23:06fac173529e 14
vpcola 23:06fac173529e 15 #define COMMAND_TIMEOUT 5000
vpcola 23:06fac173529e 16 #define DEFAULT_SOCKET_TIMEOUT 1000
vpcola 23:06fac173529e 17 #define MAX_MQTT_PACKET_SIZE 200
vpcola 23:06fac173529e 18 #define MAX_MQTT_PAYLOAD_SIZE 100
vpcola 23:06fac173529e 19
vpcola 23:06fac173529e 20 typedef enum { QOS0, QOS1, QOS2 } QoS;
vpcola 23:06fac173529e 21
vpcola 23:06fac173529e 22 // all failure return codes must be negative
vpcola 23:06fac173529e 23 typedef enum { BUFFER_OVERFLOW = -3, TIMEOUT = -2, FAILURE = -1, SUCCESS = 0 } returnCode;
vpcola 23:06fac173529e 24
vpcola 23:06fac173529e 25
vpcola 23:06fac173529e 26 typedef struct
vpcola 23:06fac173529e 27 {
vpcola 23:06fac173529e 28 QoS qos;
vpcola 23:06fac173529e 29 bool retained;
vpcola 23:06fac173529e 30 bool dup;
vpcola 23:06fac173529e 31 unsigned short id;
vpcola 23:06fac173529e 32 void *payload;
vpcola 23:06fac173529e 33 size_t payloadlen;
vpcola 23:06fac173529e 34 }Message, *pMessage;
vpcola 23:06fac173529e 35
vpcola 23:06fac173529e 36 // TODO:
vpcola 23:06fac173529e 37 // Merge this struct with the one above, in order to use the same
vpcola 23:06fac173529e 38 // data structure for sending and receiving. I need to simplify
vpcola 23:06fac173529e 39 // the PubMessage to not contain pointers like the one above.
vpcola 23:06fac173529e 40 typedef struct
vpcola 23:06fac173529e 41 {
vpcola 23:06fac173529e 42 char topic[100];
vpcola 23:06fac173529e 43 QoS qos;
vpcola 23:06fac173529e 44 unsigned short id;
vpcola 23:06fac173529e 45 size_t payloadlen;
vpcola 23:06fac173529e 46 char payload[MAX_MQTT_PAYLOAD_SIZE];
vpcola 23:06fac173529e 47 }PubMessage, *pPubMessage;
vpcola 23:06fac173529e 48
vpcola 23:06fac173529e 49 struct MessageData
vpcola 23:06fac173529e 50 {
vpcola 23:06fac173529e 51 MessageData(MQTTString &aTopicName, Message &aMessage) : message(aMessage), topicName(aTopicName)
vpcola 23:06fac173529e 52 { }
vpcola 23:06fac173529e 53 Message &message;
vpcola 23:06fac173529e 54 MQTTString &topicName;
vpcola 23:06fac173529e 55 };
vpcola 23:06fac173529e 56
vpcola 23:06fac173529e 57 class PacketId
vpcola 23:06fac173529e 58 {
vpcola 23:06fac173529e 59 public:
vpcola 23:06fac173529e 60 PacketId()
vpcola 23:06fac173529e 61 {
vpcola 23:06fac173529e 62 next = 0;
vpcola 23:06fac173529e 63 }
vpcola 23:06fac173529e 64
vpcola 23:06fac173529e 65 int getNext()
vpcola 23:06fac173529e 66 {
vpcola 23:06fac173529e 67 return next = (next == MAX_PACKET_ID) ? 1 : ++next;
vpcola 23:06fac173529e 68 }
vpcola 23:06fac173529e 69
vpcola 23:06fac173529e 70 private:
vpcola 23:06fac173529e 71 static const int MAX_PACKET_ID = 65535;
vpcola 23:06fac173529e 72 int next;
vpcola 23:06fac173529e 73 };
vpcola 23:06fac173529e 74
vpcola 23:06fac173529e 75
vpcola 23:06fac173529e 76
vpcola 23:06fac173529e 77 class MQTTThreadedClient
vpcola 23:06fac173529e 78 {
vpcola 23:06fac173529e 79 public:
vpcola 25:326f00faa092 80 MQTTThreadedClient(NetworkInterface * aNetwork, const char * pem = NULL)
vpcola 23:06fac173529e 81 : network(aNetwork),
vpcola 25:326f00faa092 82 ssl_ca_pem(pem),
vpcola 26:4b21de8043a5 83 port((pem != NULL) ? 8883 : 1883),
vpcola 23:06fac173529e 84 queue(32 * EVENTS_EVENT_SIZE),
vpcola 26:4b21de8043a5 85 isConnected(false),
vpcola 26:4b21de8043a5 86 hasSavedSession(false),
vpcola 26:4b21de8043a5 87 useTLS(pem != NULL)
vpcola 25:326f00faa092 88 {
vpcola 25:326f00faa092 89 DRBG_PERS = "mbed TLS MQTT client";
vpcola 23:06fac173529e 90 tcpSocket = new TCPSocket();
vpcola 25:326f00faa092 91 setupTLS();
vpcola 25:326f00faa092 92 }
vpcola 25:326f00faa092 93
vpcola 25:326f00faa092 94 ~MQTTThreadedClient()
vpcola 25:326f00faa092 95 {
vpcola 25:326f00faa092 96 // TODO: signal the thread to shutdown
vpcola 25:326f00faa092 97 freeTLS();
vpcola 25:326f00faa092 98
vpcola 25:326f00faa092 99 if (isConnected)
vpcola 25:326f00faa092 100 disconnect();
vpcola 25:326f00faa092 101
vpcola 23:06fac173529e 102 }
vpcola 23:06fac173529e 103
vpcola 26:4b21de8043a5 104 void setConnectionParameters(const char * host, uint16_t port, MQTTPacket_connectData & options);
vpcola 23:06fac173529e 105 int publish(PubMessage& message);
vpcola 25:326f00faa092 106
vpcola 25:326f00faa092 107 void addTopicHandler(const char * topic, void (*function)(MessageData &));
vpcola 25:326f00faa092 108 template<typename T>
vpcola 25:326f00faa092 109 void addTopicHandler(const char * topic, T *object, void (T::*member)(MessageData &))
vpcola 25:326f00faa092 110 {
vpcola 25:326f00faa092 111 FP<void,MessageData &> fp;
vpcola 25:326f00faa092 112 fp.attach(object, member);
vpcola 25:326f00faa092 113
vpcola 26:4b21de8043a5 114 topicCBMap.insert(std::pair<std::string, FP<void,MessageData &> >(std::string(topic),fp));
vpcola 25:326f00faa092 115 }
vpcola 25:326f00faa092 116
vpcola 26:4b21de8043a5 117 // Start the listener thread and start polling
vpcola 26:4b21de8043a5 118 // MQTT server.
vpcola 23:06fac173529e 119 void startListener();
vpcola 26:4b21de8043a5 120 // Stop the listerner thread and closes connection
vpcola 26:4b21de8043a5 121 void stopListener();
vpcola 23:06fac173529e 122
vpcola 23:06fac173529e 123 protected:
vpcola 26:4b21de8043a5 124
vpcola 23:06fac173529e 125 int handlePublishMsg();
vpcola 26:4b21de8043a5 126 void disconnect();
vpcola 26:4b21de8043a5 127 int connect();
vpcola 23:06fac173529e 128
vpcola 23:06fac173529e 129
vpcola 23:06fac173529e 130 private:
vpcola 23:06fac173529e 131 NetworkInterface * network;
vpcola 25:326f00faa092 132 const char * ssl_ca_pem;
vpcola 23:06fac173529e 133 TCPSocket * tcpSocket;
vpcola 23:06fac173529e 134 PacketId packetid;
vpcola 25:326f00faa092 135 const char *DRBG_PERS;
vpcola 25:326f00faa092 136 nsapi_error_t _error;
vpcola 25:326f00faa092 137 // Connection options
vpcola 25:326f00faa092 138 std::string host;
vpcola 25:326f00faa092 139 uint16_t port;
vpcola 25:326f00faa092 140 MQTTPacket_connectData connect_options;
vpcola 23:06fac173529e 141 // Event queue
vpcola 23:06fac173529e 142 EventQueue queue;
vpcola 23:06fac173529e 143 bool isConnected;
vpcola 26:4b21de8043a5 144 bool hasSavedSession;
vpcola 23:06fac173529e 145
vpcola 23:06fac173529e 146 // TODO: Because I'm using a map, I can only have one handler
vpcola 23:06fac173529e 147 // for each topic (one that's mapped to the topic string).
vpcola 23:06fac173529e 148 // Attaching another handler on the same topic is not possible.
vpcola 23:06fac173529e 149 // In the future, use a vector instead of maps to allow multiple
vpcola 23:06fac173529e 150 // handlers for the same topic.
vpcola 23:06fac173529e 151 std::map<std::string, FP<void, MessageData &> > topicCBMap;
vpcola 25:326f00faa092 152
vpcola 23:06fac173529e 153 unsigned char sendbuf[MAX_MQTT_PACKET_SIZE];
vpcola 23:06fac173529e 154 unsigned char readbuf[MAX_MQTT_PACKET_SIZE];
vpcola 23:06fac173529e 155
vpcola 23:06fac173529e 156 unsigned int keepAliveInterval;
vpcola 23:06fac173529e 157 Timer comTimer;
vpcola 23:06fac173529e 158
vpcola 25:326f00faa092 159 // SSL/TLS functions
vpcola 26:4b21de8043a5 160 bool useTLS;
vpcola 25:326f00faa092 161 void setupTLS();
vpcola 25:326f00faa092 162 int initTLS();
vpcola 25:326f00faa092 163 void freeTLS();
vpcola 25:326f00faa092 164 int doTLSHandshake();
vpcola 25:326f00faa092 165
vpcola 25:326f00faa092 166 int processSubscriptions();
vpcola 23:06fac173529e 167 int readPacket();
vpcola 23:06fac173529e 168 int sendPacket(size_t length);
vpcola 23:06fac173529e 169 int readPacketLength(int* value);
vpcola 23:06fac173529e 170 int readUntil(int packetType, int timeout);
vpcola 23:06fac173529e 171 int readBytesToBuffer(char * buffer, size_t size, int timeout);
vpcola 23:06fac173529e 172 int sendBytesFromBuffer(char * buffer, size_t size, int timeout);
vpcola 23:06fac173529e 173 bool isTopicMatched(char* topic, MQTTString& topicName);
vpcola 23:06fac173529e 174 int sendPublish(PubMessage& message);
vpcola 23:06fac173529e 175 void resetConnectionTimer();
vpcola 23:06fac173529e 176 void sendPingRequest();
vpcola 23:06fac173529e 177 bool hasConnectionTimedOut();
vpcola 26:4b21de8043a5 178 int login();
vpcola 23:06fac173529e 179 };
vpcola 23:06fac173529e 180
vpcola 23:06fac173529e 181 #endif