Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Fork of MQTT by
MQTTClient.h@16:91c2f9a144d4, 2014-04-14 (annotated)
- Committer:
- icraggs
- Date:
- Mon Apr 14 18:51:52 2014 +0000
- Revision:
- 16:91c2f9a144d4
- Parent:
- 15:64a57183aa03
- Child:
- 19:57f6f976e878
Add subscriptions
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
icraggs | 6:4d312a49200b | 1 | /******************************************************************************* |
icraggs | 6:4d312a49200b | 2 | * Copyright (c) 2014 IBM Corp. |
sam_grove | 0:fe461e4d7afe | 3 | * |
icraggs | 6:4d312a49200b | 4 | * All rights reserved. This program and the accompanying materials |
icraggs | 6:4d312a49200b | 5 | * are made available under the terms of the Eclipse Public License v1.0 |
icraggs | 6:4d312a49200b | 6 | * and Eclipse Distribution License v1.0 which accompany this distribution. |
sam_grove | 0:fe461e4d7afe | 7 | * |
icraggs | 6:4d312a49200b | 8 | * The Eclipse Public License is available at |
icraggs | 6:4d312a49200b | 9 | * http://www.eclipse.org/legal/epl-v10.html |
icraggs | 6:4d312a49200b | 10 | * and the Eclipse Distribution License is available at |
icraggs | 6:4d312a49200b | 11 | * http://www.eclipse.org/org/documents/edl-v10.php. |
sam_grove | 0:fe461e4d7afe | 12 | * |
icraggs | 6:4d312a49200b | 13 | * Contributors: |
icraggs | 6:4d312a49200b | 14 | * Ian Craggs - initial API and implementation and/or initial documentation |
icraggs | 6:4d312a49200b | 15 | *******************************************************************************/ |
sam_grove | 0:fe461e4d7afe | 16 | |
icraggs | 2:dcfdd2abfe71 | 17 | #if !defined(MQTTCLIENT_H) |
icraggs | 2:dcfdd2abfe71 | 18 | #define MQTTCLIENT_H |
icraggs | 2:dcfdd2abfe71 | 19 | |
icraggs | 2:dcfdd2abfe71 | 20 | #include "FP.h" |
icraggs | 3:dbff6b768d28 | 21 | #include "MQTTPacket.h" |
icraggs | 6:4d312a49200b | 22 | #include "stdio.h" |
icraggs | 2:dcfdd2abfe71 | 23 | |
icraggs | 3:dbff6b768d28 | 24 | namespace MQTT |
icraggs | 3:dbff6b768d28 | 25 | { |
icraggs | 3:dbff6b768d28 | 26 | |
icraggs | 2:dcfdd2abfe71 | 27 | |
icraggs | 2:dcfdd2abfe71 | 28 | enum QoS { QOS0, QOS1, QOS2 }; |
sam_grove | 0:fe461e4d7afe | 29 | |
icraggs | 2:dcfdd2abfe71 | 30 | |
icraggs | 3:dbff6b768d28 | 31 | struct Message |
icraggs | 2:dcfdd2abfe71 | 32 | { |
icraggs | 2:dcfdd2abfe71 | 33 | enum QoS qos; |
icraggs | 2:dcfdd2abfe71 | 34 | bool retained; |
icraggs | 2:dcfdd2abfe71 | 35 | bool dup; |
Ian Craggs |
12:cc7f2d62a393 | 36 | unsigned short id; |
icraggs | 2:dcfdd2abfe71 | 37 | void *payload; |
icraggs | 2:dcfdd2abfe71 | 38 | size_t payloadlen; |
sam_grove | 0:fe461e4d7afe | 39 | }; |
sam_grove | 0:fe461e4d7afe | 40 | |
icraggs | 4:4ef00243708e | 41 | |
icraggs | 9:01b8cc7d94cc | 42 | class PacketId |
icraggs | 9:01b8cc7d94cc | 43 | { |
icraggs | 9:01b8cc7d94cc | 44 | public: |
icraggs | 9:01b8cc7d94cc | 45 | PacketId(); |
icraggs | 9:01b8cc7d94cc | 46 | |
icraggs | 15:64a57183aa03 | 47 | int getNext(); |
Ian Craggs |
12:cc7f2d62a393 | 48 | |
icraggs | 9:01b8cc7d94cc | 49 | private: |
icraggs | 9:01b8cc7d94cc | 50 | static const int MAX_PACKET_ID = 65535; |
icraggs | 9:01b8cc7d94cc | 51 | int next; |
icraggs | 9:01b8cc7d94cc | 52 | }; |
icraggs | 9:01b8cc7d94cc | 53 | |
icraggs | 9:01b8cc7d94cc | 54 | typedef void (*messageHandler)(Message*); |
icraggs | 16:91c2f9a144d4 | 55 | |
icraggs | 16:91c2f9a144d4 | 56 | typedef struct limits |
icraggs | 16:91c2f9a144d4 | 57 | { |
icraggs | 16:91c2f9a144d4 | 58 | int MAX_MQTT_PACKET_SIZE; // |
icraggs | 16:91c2f9a144d4 | 59 | int MAX_MESSAGE_HANDLERS; // each subscription requires a message handler |
icraggs | 16:91c2f9a144d4 | 60 | int MAX_CONCURRENT_OPERATIONS; // each command which runs concurrently can have a result handler, when we are in multi-threaded mode |
icraggs | 16:91c2f9a144d4 | 61 | int command_timeout; |
icraggs | 16:91c2f9a144d4 | 62 | |
icraggs | 16:91c2f9a144d4 | 63 | limits() |
icraggs | 16:91c2f9a144d4 | 64 | { |
icraggs | 16:91c2f9a144d4 | 65 | MAX_MQTT_PACKET_SIZE = 100; |
icraggs | 16:91c2f9a144d4 | 66 | MAX_MESSAGE_HANDLERS = 5; |
icraggs | 16:91c2f9a144d4 | 67 | MAX_CONCURRENT_OPERATIONS = 1; // 1 indicates single-threaded mode - set to >1 for multithreaded mode |
icraggs | 16:91c2f9a144d4 | 68 | command_timeout = 30; |
icraggs | 16:91c2f9a144d4 | 69 | } |
icraggs | 16:91c2f9a144d4 | 70 | } Limits; |
icraggs | 2:dcfdd2abfe71 | 71 | |
icraggs | 16:91c2f9a144d4 | 72 | |
icraggs | 16:91c2f9a144d4 | 73 | template<class Network, class Timer, class Thread, class Mutex> class Client |
icraggs | 2:dcfdd2abfe71 | 74 | { |
icraggs | 2:dcfdd2abfe71 | 75 | |
icraggs | 15:64a57183aa03 | 76 | public: |
icraggs | 15:64a57183aa03 | 77 | |
Ian Craggs |
12:cc7f2d62a393 | 78 | struct Result |
Ian Craggs |
12:cc7f2d62a393 | 79 | { |
Ian Craggs |
12:cc7f2d62a393 | 80 | /* success or failure result data */ |
icraggs | 16:91c2f9a144d4 | 81 | Client<Network, Timer, Thread, Mutex>* client; |
Ian Craggs |
12:cc7f2d62a393 | 82 | int connack_rc; |
icraggs | 15:64a57183aa03 | 83 | }; |
icraggs | 15:64a57183aa03 | 84 | |
icraggs | 16:91c2f9a144d4 | 85 | typedef void (*resultHandler)(Result*); |
icraggs | 4:4ef00243708e | 86 | |
icraggs | 16:91c2f9a144d4 | 87 | Client(Network* network, const Limits limits = Limits()); |
icraggs | 16:91c2f9a144d4 | 88 | |
icraggs | 9:01b8cc7d94cc | 89 | int connect(MQTTPacket_connectData* options = 0, resultHandler fn = 0); |
icraggs | 2:dcfdd2abfe71 | 90 | |
icraggs | 9:01b8cc7d94cc | 91 | template<class T> |
icraggs | 9:01b8cc7d94cc | 92 | int connect(MQTTPacket_connectData* options = 0, T *item = 0, void(T::*method)(Result *) = 0); // alternative to pass in pointer to member function |
icraggs | 9:01b8cc7d94cc | 93 | |
icraggs | 9:01b8cc7d94cc | 94 | int publish(const char* topic, Message* message, resultHandler rh = 0); |
sam_grove | 0:fe461e4d7afe | 95 | |
icraggs | 9:01b8cc7d94cc | 96 | int subscribe(const char* topicFilter, enum QoS qos, messageHandler mh, resultHandler rh = 0); |
icraggs | 2:dcfdd2abfe71 | 97 | |
Ian Craggs |
12:cc7f2d62a393 | 98 | int unsubscribe(const char* topicFilter, resultHandler rh = 0); |
icraggs | 9:01b8cc7d94cc | 99 | |
icraggs | 9:01b8cc7d94cc | 100 | int disconnect(int timeout, resultHandler rh = 0); |
sam_grove | 0:fe461e4d7afe | 101 | |
icraggs | 8:c46930bd6c82 | 102 | void run(void const *argument); |
icraggs | 8:c46930bd6c82 | 103 | |
icraggs | 2:dcfdd2abfe71 | 104 | private: |
icraggs | 2:dcfdd2abfe71 | 105 | |
icraggs | 15:64a57183aa03 | 106 | int cycle(int timeout); |
icraggs | 16:91c2f9a144d4 | 107 | int waitfor(int packet_type, Timer& atimer); |
Ian Craggs |
12:cc7f2d62a393 | 108 | int keepalive(); |
icraggs | 16:91c2f9a144d4 | 109 | int findFreeOperation(); |
icraggs | 2:dcfdd2abfe71 | 110 | |
icraggs | 3:dbff6b768d28 | 111 | int decodePacket(int* value, int timeout); |
icraggs | 16:91c2f9a144d4 | 112 | int readPacket(int timeout); |
icraggs | 16:91c2f9a144d4 | 113 | int sendPacket(int length, int timeout); |
icraggs | 15:64a57183aa03 | 114 | int deliverMessage(MQTTString* topic, Message* message); |
icraggs | 3:dbff6b768d28 | 115 | |
icraggs | 4:4ef00243708e | 116 | Thread* thread; |
icraggs | 4:4ef00243708e | 117 | Network* ipstack; |
icraggs | 16:91c2f9a144d4 | 118 | |
icraggs | 16:91c2f9a144d4 | 119 | Limits limits; |
icraggs | 4:4ef00243708e | 120 | |
icraggs | 16:91c2f9a144d4 | 121 | char* buf; |
icraggs | 4:4ef00243708e | 122 | char* readbuf; |
icraggs | 15:64a57183aa03 | 123 | |
icraggs | 16:91c2f9a144d4 | 124 | Timer ping_timer, connect_timer; |
icraggs | 15:64a57183aa03 | 125 | unsigned int keepAliveInterval; |
Ian Craggs |
12:cc7f2d62a393 | 126 | bool ping_outstanding; |
icraggs | 4:4ef00243708e | 127 | |
icraggs | 9:01b8cc7d94cc | 128 | PacketId packetid; |
icraggs | 9:01b8cc7d94cc | 129 | |
icraggs | 9:01b8cc7d94cc | 130 | typedef FP<void, Result*> resultHandlerFP; |
icraggs | 9:01b8cc7d94cc | 131 | resultHandlerFP connectHandler; |
icraggs | 9:01b8cc7d94cc | 132 | |
icraggs | 9:01b8cc7d94cc | 133 | typedef FP<void, Message*> messageHandlerFP; |
icraggs | 16:91c2f9a144d4 | 134 | struct MessageHandlers |
icraggs | 15:64a57183aa03 | 135 | { |
icraggs | 16:91c2f9a144d4 | 136 | const char* topic; |
icraggs | 15:64a57183aa03 | 137 | messageHandlerFP fp; |
icraggs | 16:91c2f9a144d4 | 138 | } *messageHandlers; // Message handlers are indexed by subscription topic |
icraggs | 15:64a57183aa03 | 139 | |
icraggs | 15:64a57183aa03 | 140 | // how many concurrent operations should we allow? Each one will require a function pointer |
icraggs | 16:91c2f9a144d4 | 141 | struct Operations |
icraggs | 15:64a57183aa03 | 142 | { |
icraggs | 15:64a57183aa03 | 143 | unsigned short id; |
icraggs | 15:64a57183aa03 | 144 | resultHandlerFP fp; |
icraggs | 16:91c2f9a144d4 | 145 | const char* topic; // if this is a publish, store topic name in case republishing is required |
icraggs | 16:91c2f9a144d4 | 146 | Message* message; // for publish, |
icraggs | 16:91c2f9a144d4 | 147 | Timer timer; // to check if the command has timed out |
icraggs | 16:91c2f9a144d4 | 148 | } *operations; // result handlers are indexed by packet ids |
icraggs | 15:64a57183aa03 | 149 | |
Ian Craggs |
12:cc7f2d62a393 | 150 | static void threadfn(void* arg); |
icraggs | 11:db15da110a37 | 151 | |
sam_grove | 0:fe461e4d7afe | 152 | }; |
sam_grove | 0:fe461e4d7afe | 153 | |
icraggs | 15:64a57183aa03 | 154 | } |
icraggs | 15:64a57183aa03 | 155 | |
icraggs | 15:64a57183aa03 | 156 | |
icraggs | 16:91c2f9a144d4 | 157 | template<class Network, class Timer, class Thread, class Mutex> void MQTT::Client<Network, Timer, Thread, Mutex>::threadfn(void* arg) |
icraggs | 15:64a57183aa03 | 158 | { |
icraggs | 16:91c2f9a144d4 | 159 | ((Client<Network, Timer, Thread, Mutex>*) arg)->run(NULL); |
icraggs | 11:db15da110a37 | 160 | } |
icraggs | 11:db15da110a37 | 161 | |
icraggs | 11:db15da110a37 | 162 | |
icraggs | 16:91c2f9a144d4 | 163 | template<class Network, class Timer, class Thread, class Mutex> MQTT::Client<Network, Timer, Thread, Mutex>::Client(Network* network, Limits limits) : limits(limits), packetid() |
icraggs | 8:c46930bd6c82 | 164 | { |
icraggs | 16:91c2f9a144d4 | 165 | this->thread = 0; |
icraggs | 16:91c2f9a144d4 | 166 | this->ipstack = network; |
icraggs | 16:91c2f9a144d4 | 167 | this->ping_timer = Timer(); |
icraggs | 16:91c2f9a144d4 | 168 | this->ping_outstanding = 0; |
icraggs | 16:91c2f9a144d4 | 169 | |
icraggs | 16:91c2f9a144d4 | 170 | // How to make these memory allocations portable? I was hoping to avoid the heap |
icraggs | 16:91c2f9a144d4 | 171 | buf = new char[limits.MAX_MQTT_PACKET_SIZE]; |
icraggs | 16:91c2f9a144d4 | 172 | readbuf = new char[limits.MAX_MQTT_PACKET_SIZE]; |
icraggs | 16:91c2f9a144d4 | 173 | this->operations = new struct Operations[limits.MAX_CONCURRENT_OPERATIONS]; |
icraggs | 16:91c2f9a144d4 | 174 | for (int i = 0; i < limits.MAX_CONCURRENT_OPERATIONS; ++i) |
icraggs | 16:91c2f9a144d4 | 175 | operations[i].id = 0; |
icraggs | 16:91c2f9a144d4 | 176 | this->messageHandlers = new struct MessageHandlers[limits.MAX_MESSAGE_HANDLERS]; |
icraggs | 16:91c2f9a144d4 | 177 | for (int i = 0; i < limits.MAX_MESSAGE_HANDLERS; ++i) |
icraggs | 16:91c2f9a144d4 | 178 | messageHandlers[i].topic = 0; |
icraggs | 8:c46930bd6c82 | 179 | } |
icraggs | 8:c46930bd6c82 | 180 | |
icraggs | 8:c46930bd6c82 | 181 | |
icraggs | 16:91c2f9a144d4 | 182 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::sendPacket(int length, int timeout) |
icraggs | 8:c46930bd6c82 | 183 | { |
icraggs | 8:c46930bd6c82 | 184 | int sent = 0; |
icraggs | 8:c46930bd6c82 | 185 | |
icraggs | 8:c46930bd6c82 | 186 | while (sent < length) |
icraggs | 16:91c2f9a144d4 | 187 | sent += ipstack->write(&buf[sent], length, timeout); |
Ian Craggs |
12:cc7f2d62a393 | 188 | if (sent == length) |
icraggs | 16:91c2f9a144d4 | 189 | ping_timer.countdown(this->keepAliveInterval); // record the fact that we have successfully sent the packet |
icraggs | 8:c46930bd6c82 | 190 | return sent; |
icraggs | 8:c46930bd6c82 | 191 | } |
icraggs | 8:c46930bd6c82 | 192 | |
icraggs | 8:c46930bd6c82 | 193 | |
icraggs | 16:91c2f9a144d4 | 194 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::decodePacket(int* value, int timeout) |
icraggs | 8:c46930bd6c82 | 195 | { |
icraggs | 8:c46930bd6c82 | 196 | char c; |
icraggs | 8:c46930bd6c82 | 197 | int multiplier = 1; |
icraggs | 8:c46930bd6c82 | 198 | int len = 0; |
icraggs | 15:64a57183aa03 | 199 | const int MAX_NO_OF_REMAINING_LENGTH_BYTES = 4; |
icraggs | 8:c46930bd6c82 | 200 | |
icraggs | 8:c46930bd6c82 | 201 | *value = 0; |
icraggs | 8:c46930bd6c82 | 202 | do |
icraggs | 8:c46930bd6c82 | 203 | { |
icraggs | 8:c46930bd6c82 | 204 | int rc = MQTTPACKET_READ_ERROR; |
icraggs | 8:c46930bd6c82 | 205 | |
icraggs | 8:c46930bd6c82 | 206 | if (++len > MAX_NO_OF_REMAINING_LENGTH_BYTES) |
icraggs | 8:c46930bd6c82 | 207 | { |
icraggs | 8:c46930bd6c82 | 208 | rc = MQTTPACKET_READ_ERROR; /* bad data */ |
icraggs | 8:c46930bd6c82 | 209 | goto exit; |
icraggs | 8:c46930bd6c82 | 210 | } |
icraggs | 8:c46930bd6c82 | 211 | rc = ipstack->read(&c, 1, timeout); |
icraggs | 8:c46930bd6c82 | 212 | if (rc != 1) |
icraggs | 8:c46930bd6c82 | 213 | goto exit; |
icraggs | 8:c46930bd6c82 | 214 | *value += (c & 127) * multiplier; |
icraggs | 8:c46930bd6c82 | 215 | multiplier *= 128; |
icraggs | 8:c46930bd6c82 | 216 | } while ((c & 128) != 0); |
icraggs | 8:c46930bd6c82 | 217 | exit: |
icraggs | 8:c46930bd6c82 | 218 | return len; |
icraggs | 8:c46930bd6c82 | 219 | } |
icraggs | 8:c46930bd6c82 | 220 | |
icraggs | 8:c46930bd6c82 | 221 | |
icraggs | 8:c46930bd6c82 | 222 | /** |
icraggs | 8:c46930bd6c82 | 223 | * If any read fails in this method, then we should disconnect from the network, as on reconnect |
icraggs | 8:c46930bd6c82 | 224 | * the packets can be retried. |
icraggs | 8:c46930bd6c82 | 225 | * @param timeout the max time to wait for the packet read to complete, in milliseconds |
icraggs | 8:c46930bd6c82 | 226 | * @return the MQTT packet type, or -1 if none |
icraggs | 8:c46930bd6c82 | 227 | */ |
icraggs | 16:91c2f9a144d4 | 228 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::readPacket(int timeout) |
icraggs | 8:c46930bd6c82 | 229 | { |
icraggs | 8:c46930bd6c82 | 230 | int rc = -1; |
icraggs | 8:c46930bd6c82 | 231 | MQTTHeader header = {0}; |
icraggs | 8:c46930bd6c82 | 232 | int len = 0; |
icraggs | 8:c46930bd6c82 | 233 | int rem_len = 0; |
icraggs | 8:c46930bd6c82 | 234 | |
icraggs | 8:c46930bd6c82 | 235 | /* 1. read the header byte. This has the packet type in it */ |
icraggs | 8:c46930bd6c82 | 236 | if (ipstack->read(readbuf, 1, timeout) != 1) |
icraggs | 8:c46930bd6c82 | 237 | goto exit; |
icraggs | 8:c46930bd6c82 | 238 | |
icraggs | 8:c46930bd6c82 | 239 | len = 1; |
icraggs | 8:c46930bd6c82 | 240 | /* 2. read the remaining length. This is variable in itself */ |
icraggs | 8:c46930bd6c82 | 241 | decodePacket(&rem_len, timeout); |
icraggs | 8:c46930bd6c82 | 242 | len += MQTTPacket_encode(readbuf + 1, rem_len); /* put the original remaining length back into the buffer */ |
icraggs | 8:c46930bd6c82 | 243 | |
icraggs | 8:c46930bd6c82 | 244 | /* 3. read the rest of the buffer using a callback to supply the rest of the data */ |
icraggs | 8:c46930bd6c82 | 245 | if (ipstack->read(readbuf + len, rem_len, timeout) != rem_len) |
icraggs | 8:c46930bd6c82 | 246 | goto exit; |
icraggs | 8:c46930bd6c82 | 247 | |
icraggs | 8:c46930bd6c82 | 248 | header.byte = readbuf[0]; |
icraggs | 8:c46930bd6c82 | 249 | rc = header.bits.type; |
icraggs | 8:c46930bd6c82 | 250 | exit: |
icraggs | 8:c46930bd6c82 | 251 | return rc; |
icraggs | 3:dbff6b768d28 | 252 | } |
icraggs | 3:dbff6b768d28 | 253 | |
icraggs | 8:c46930bd6c82 | 254 | |
icraggs | 16:91c2f9a144d4 | 255 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::deliverMessage(MQTTString* topic, Message* message) |
icraggs | 15:64a57183aa03 | 256 | { |
icraggs | 16:91c2f9a144d4 | 257 | int rc = -1; |
icraggs | 16:91c2f9a144d4 | 258 | |
icraggs | 16:91c2f9a144d4 | 259 | // we have to find the right message handler - indexed by topic |
icraggs | 16:91c2f9a144d4 | 260 | for (int i = 0; i < limits.MAX_MESSAGE_HANDLERS; ++i) |
icraggs | 16:91c2f9a144d4 | 261 | { |
icraggs | 16:91c2f9a144d4 | 262 | if (messageHandlers[i].topic && MQTTPacket_equals(topic, (char*)messageHandlers[i].topic)) |
icraggs | 16:91c2f9a144d4 | 263 | { |
icraggs | 16:91c2f9a144d4 | 264 | messageHandlers[i].fp(message); |
icraggs | 16:91c2f9a144d4 | 265 | rc = 0; |
icraggs | 16:91c2f9a144d4 | 266 | break; |
icraggs | 16:91c2f9a144d4 | 267 | } |
icraggs | 16:91c2f9a144d4 | 268 | } |
icraggs | 16:91c2f9a144d4 | 269 | |
icraggs | 16:91c2f9a144d4 | 270 | return rc; |
icraggs | 15:64a57183aa03 | 271 | } |
icraggs | 15:64a57183aa03 | 272 | |
icraggs | 15:64a57183aa03 | 273 | |
icraggs | 16:91c2f9a144d4 | 274 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::cycle(int timeout) |
icraggs | 8:c46930bd6c82 | 275 | { |
icraggs | 8:c46930bd6c82 | 276 | /* get one piece of work off the wire and one pass through */ |
icraggs | 8:c46930bd6c82 | 277 | |
Ian Craggs |
12:cc7f2d62a393 | 278 | // read the socket, see what work is due |
icraggs | 9:01b8cc7d94cc | 279 | int packet_type = readPacket(timeout); |
icraggs | 8:c46930bd6c82 | 280 | |
icraggs | 8:c46930bd6c82 | 281 | printf("packet type %d\n", packet_type); |
icraggs | 15:64a57183aa03 | 282 | |
Ian Craggs |
12:cc7f2d62a393 | 283 | int len, rc; |
icraggs | 8:c46930bd6c82 | 284 | switch (packet_type) |
icraggs | 8:c46930bd6c82 | 285 | { |
icraggs | 15:64a57183aa03 | 286 | case CONNACK: |
icraggs | 15:64a57183aa03 | 287 | if (this->thread) |
icraggs | 15:64a57183aa03 | 288 | { |
icraggs | 15:64a57183aa03 | 289 | Result res = {this, 0}; |
icraggs | 16:91c2f9a144d4 | 290 | if (MQTTDeserialize_connack(&res.connack_rc, readbuf, limits.MAX_MQTT_PACKET_SIZE) == 1) |
icraggs | 15:64a57183aa03 | 291 | ; |
icraggs | 15:64a57183aa03 | 292 | connectHandler(&res); |
icraggs | 15:64a57183aa03 | 293 | connectHandler.detach(); // only invoke the callback once |
icraggs | 15:64a57183aa03 | 294 | } |
icraggs | 16:91c2f9a144d4 | 295 | break; |
icraggs | 8:c46930bd6c82 | 296 | case PUBACK: |
icraggs | 16:91c2f9a144d4 | 297 | if (this->thread) |
icraggs | 16:91c2f9a144d4 | 298 | ; //call resultHandler |
icraggs | 8:c46930bd6c82 | 299 | case SUBACK: |
icraggs | 8:c46930bd6c82 | 300 | break; |
icraggs | 15:64a57183aa03 | 301 | case PUBLISH: |
icraggs | 15:64a57183aa03 | 302 | MQTTString topicName; |
icraggs | 15:64a57183aa03 | 303 | Message msg; |
icraggs | 15:64a57183aa03 | 304 | rc = MQTTDeserialize_publish((int*)&msg.dup, (int*)&msg.qos, (int*)&msg.retained, (int*)&msg.id, &topicName, |
icraggs | 16:91c2f9a144d4 | 305 | (char**)&msg.payload, (int*)&msg.payloadlen, readbuf, limits.MAX_MQTT_PACKET_SIZE); |
icraggs | 15:64a57183aa03 | 306 | if (msg.qos == QOS0) |
icraggs | 15:64a57183aa03 | 307 | deliverMessage(&topicName, &msg); |
Ian Craggs |
12:cc7f2d62a393 | 308 | break; |
icraggs | 15:64a57183aa03 | 309 | case PUBREC: |
Ian Craggs |
12:cc7f2d62a393 | 310 | int type, dup, mypacketid; |
icraggs | 16:91c2f9a144d4 | 311 | if (MQTTDeserialize_ack(&type, &dup, &mypacketid, readbuf, limits.MAX_MQTT_PACKET_SIZE) == 1) |
icraggs | 15:64a57183aa03 | 312 | ; |
icraggs | 15:64a57183aa03 | 313 | // must lock this access against the application thread, if we are multi-threaded |
icraggs | 16:91c2f9a144d4 | 314 | len = MQTTSerialize_ack(buf, limits.MAX_MQTT_PACKET_SIZE, PUBREL, 0, mypacketid); |
icraggs | 16:91c2f9a144d4 | 315 | rc = sendPacket(len, timeout); // send the PUBREL packet |
icraggs | 15:64a57183aa03 | 316 | if (rc != len) |
icraggs | 15:64a57183aa03 | 317 | goto exit; // there was a problem |
Ian Craggs |
12:cc7f2d62a393 | 318 | |
icraggs | 8:c46930bd6c82 | 319 | break; |
icraggs | 8:c46930bd6c82 | 320 | case PUBCOMP: |
icraggs | 8:c46930bd6c82 | 321 | break; |
icraggs | 15:64a57183aa03 | 322 | case PINGRESP: |
icraggs | 15:64a57183aa03 | 323 | ping_outstanding = false; |
icraggs | 8:c46930bd6c82 | 324 | break; |
icraggs | 15:64a57183aa03 | 325 | } |
icraggs | 15:64a57183aa03 | 326 | keepalive(); |
Ian Craggs |
12:cc7f2d62a393 | 327 | exit: |
icraggs | 8:c46930bd6c82 | 328 | return packet_type; |
icraggs | 15:64a57183aa03 | 329 | } |
icraggs | 15:64a57183aa03 | 330 | |
icraggs | 15:64a57183aa03 | 331 | |
icraggs | 16:91c2f9a144d4 | 332 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::keepalive() |
icraggs | 15:64a57183aa03 | 333 | { |
icraggs | 15:64a57183aa03 | 334 | int rc = 0; |
icraggs | 15:64a57183aa03 | 335 | |
icraggs | 15:64a57183aa03 | 336 | if (keepAliveInterval == 0) |
icraggs | 15:64a57183aa03 | 337 | goto exit; |
icraggs | 15:64a57183aa03 | 338 | |
icraggs | 16:91c2f9a144d4 | 339 | if (ping_timer.expired()) |
icraggs | 15:64a57183aa03 | 340 | { |
icraggs | 15:64a57183aa03 | 341 | if (ping_outstanding) |
icraggs | 15:64a57183aa03 | 342 | rc = -1; |
icraggs | 15:64a57183aa03 | 343 | else |
icraggs | 15:64a57183aa03 | 344 | { |
icraggs | 16:91c2f9a144d4 | 345 | int len = MQTTSerialize_pingreq(buf, limits.MAX_MQTT_PACKET_SIZE); |
icraggs | 16:91c2f9a144d4 | 346 | rc = sendPacket(len, 1000); // send the ping packet |
icraggs | 15:64a57183aa03 | 347 | if (rc != len) |
icraggs | 15:64a57183aa03 | 348 | rc = -1; // indicate there's a problem |
icraggs | 15:64a57183aa03 | 349 | else |
icraggs | 15:64a57183aa03 | 350 | ping_outstanding = true; |
icraggs | 15:64a57183aa03 | 351 | } |
icraggs | 15:64a57183aa03 | 352 | } |
icraggs | 15:64a57183aa03 | 353 | |
icraggs | 15:64a57183aa03 | 354 | exit: |
Ian Craggs |
12:cc7f2d62a393 | 355 | return rc; |
icraggs | 8:c46930bd6c82 | 356 | } |
icraggs | 8:c46930bd6c82 | 357 | |
icraggs | 8:c46930bd6c82 | 358 | |
icraggs | 16:91c2f9a144d4 | 359 | template<class Network, class Timer, class Thread, class Mutex> void MQTT::Client<Network, Timer, Thread, Mutex>::run(void const *argument) |
icraggs | 15:64a57183aa03 | 360 | { |
icraggs | 15:64a57183aa03 | 361 | while (true) |
icraggs | 16:91c2f9a144d4 | 362 | cycle(ping_timer.left_ms()); |
icraggs | 8:c46930bd6c82 | 363 | } |
icraggs | 8:c46930bd6c82 | 364 | |
icraggs | 8:c46930bd6c82 | 365 | |
icraggs | 16:91c2f9a144d4 | 366 | // only used in single-threaded mode where one command at a time is in process |
icraggs | 16:91c2f9a144d4 | 367 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::waitfor(int packet_type, Timer& atimer) |
icraggs | 15:64a57183aa03 | 368 | { |
icraggs | 16:91c2f9a144d4 | 369 | int rc = -1; |
icraggs | 16:91c2f9a144d4 | 370 | |
icraggs | 16:91c2f9a144d4 | 371 | do |
icraggs | 16:91c2f9a144d4 | 372 | { |
icraggs | 16:91c2f9a144d4 | 373 | if (atimer.expired()) |
icraggs | 16:91c2f9a144d4 | 374 | break; // we timed out |
icraggs | 16:91c2f9a144d4 | 375 | } |
icraggs | 16:91c2f9a144d4 | 376 | while ((rc = cycle(atimer.left_ms())) != packet_type); |
icraggs | 16:91c2f9a144d4 | 377 | |
icraggs | 16:91c2f9a144d4 | 378 | return rc; |
icraggs | 16:91c2f9a144d4 | 379 | } |
icraggs | 16:91c2f9a144d4 | 380 | |
icraggs | 16:91c2f9a144d4 | 381 | |
icraggs | 16:91c2f9a144d4 | 382 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::connect(MQTTPacket_connectData* options, resultHandler resultHandler) |
icraggs | 16:91c2f9a144d4 | 383 | { |
icraggs | 16:91c2f9a144d4 | 384 | connect_timer.countdown(limits.command_timeout); |
icraggs | 8:c46930bd6c82 | 385 | |
Ian Craggs |
12:cc7f2d62a393 | 386 | MQTTPacket_connectData default_options = MQTTPacket_connectData_initializer; |
icraggs | 8:c46930bd6c82 | 387 | if (options == 0) |
Ian Craggs |
12:cc7f2d62a393 | 388 | options = &default_options; // set default options if none were supplied |
icraggs | 8:c46930bd6c82 | 389 | |
icraggs | 15:64a57183aa03 | 390 | this->keepAliveInterval = options->keepAliveInterval; |
icraggs | 16:91c2f9a144d4 | 391 | ping_timer.countdown(this->keepAliveInterval); |
icraggs | 16:91c2f9a144d4 | 392 | int len = MQTTSerialize_connect(buf, limits.MAX_MQTT_PACKET_SIZE, options); |
icraggs | 16:91c2f9a144d4 | 393 | int rc = sendPacket(len, connect_timer.left_ms()); // send the connect packet |
icraggs | 15:64a57183aa03 | 394 | if (rc != len) |
Ian Craggs |
12:cc7f2d62a393 | 395 | goto exit; // there was a problem |
icraggs | 8:c46930bd6c82 | 396 | |
Ian Craggs |
12:cc7f2d62a393 | 397 | if (resultHandler == 0) // wait until the connack is received |
icraggs | 15:64a57183aa03 | 398 | { |
icraggs | 8:c46930bd6c82 | 399 | // this will be a blocking call, wait for the connack |
icraggs | 16:91c2f9a144d4 | 400 | if (waitfor(CONNACK, connect_timer) == CONNACK) |
icraggs | 16:91c2f9a144d4 | 401 | { |
icraggs | 16:91c2f9a144d4 | 402 | int connack_rc = -1; |
icraggs | 16:91c2f9a144d4 | 403 | if (MQTTDeserialize_connack(&connack_rc, readbuf, limits.MAX_MQTT_PACKET_SIZE) == 1) |
icraggs | 16:91c2f9a144d4 | 404 | rc = connack_rc; |
icraggs | 16:91c2f9a144d4 | 405 | } |
icraggs | 8:c46930bd6c82 | 406 | } |
icraggs | 8:c46930bd6c82 | 407 | else |
icraggs | 8:c46930bd6c82 | 408 | { |
icraggs | 8:c46930bd6c82 | 409 | // set connect response callback function |
icraggs | 9:01b8cc7d94cc | 410 | connectHandler.attach(resultHandler); |
icraggs | 8:c46930bd6c82 | 411 | |
Ian Craggs |
12:cc7f2d62a393 | 412 | // start background thread |
icraggs | 16:91c2f9a144d4 | 413 | this->thread = new Thread((void (*)(void const *argument))&MQTT::Client<Network, Timer, Thread, Mutex>::threadfn, (void*)this); |
icraggs | 8:c46930bd6c82 | 414 | } |
icraggs | 15:64a57183aa03 | 415 | |
icraggs | 15:64a57183aa03 | 416 | exit: |
icraggs | 8:c46930bd6c82 | 417 | return rc; |
icraggs | 8:c46930bd6c82 | 418 | } |
icraggs | 8:c46930bd6c82 | 419 | |
icraggs | 8:c46930bd6c82 | 420 | |
icraggs | 16:91c2f9a144d4 | 421 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::findFreeOperation() |
icraggs | 15:64a57183aa03 | 422 | { |
icraggs | 16:91c2f9a144d4 | 423 | int found = -1; |
icraggs | 16:91c2f9a144d4 | 424 | for (int i = 0; i < limits.MAX_CONCURRENT_OPERATIONS; ++i) |
icraggs | 16:91c2f9a144d4 | 425 | { |
icraggs | 16:91c2f9a144d4 | 426 | if (operations[i].id == 0) |
icraggs | 16:91c2f9a144d4 | 427 | { |
icraggs | 16:91c2f9a144d4 | 428 | found = i; |
icraggs | 16:91c2f9a144d4 | 429 | break; |
icraggs | 16:91c2f9a144d4 | 430 | } |
icraggs | 16:91c2f9a144d4 | 431 | } |
icraggs | 16:91c2f9a144d4 | 432 | return found; |
icraggs | 16:91c2f9a144d4 | 433 | } |
Ian Craggs |
12:cc7f2d62a393 | 434 | |
icraggs | 16:91c2f9a144d4 | 435 | |
icraggs | 16:91c2f9a144d4 | 436 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::subscribe(const char* topicFilter, enum QoS qos, messageHandler messageHandler, resultHandler resultHandler) |
icraggs | 16:91c2f9a144d4 | 437 | { |
icraggs | 16:91c2f9a144d4 | 438 | int index = 0; |
icraggs | 16:91c2f9a144d4 | 439 | if (this->thread) |
icraggs | 16:91c2f9a144d4 | 440 | index = findFreeOperation(); |
icraggs | 16:91c2f9a144d4 | 441 | Timer& atimer = operations[index].timer; |
icraggs | 16:91c2f9a144d4 | 442 | |
icraggs | 16:91c2f9a144d4 | 443 | atimer.countdown(limits.command_timeout); |
icraggs | 8:c46930bd6c82 | 444 | MQTTString topic = {(char*)topicFilter, 0, 0}; |
icraggs | 8:c46930bd6c82 | 445 | |
icraggs | 16:91c2f9a144d4 | 446 | int len = MQTTSerialize_subscribe(buf, limits.MAX_MQTT_PACKET_SIZE, 0, packetid.getNext(), 1, &topic, (int*)&qos); |
icraggs | 16:91c2f9a144d4 | 447 | int rc = sendPacket(len, atimer.left_ms()); // send the subscribe packet |
icraggs | 15:64a57183aa03 | 448 | if (rc != len) |
Ian Craggs |
12:cc7f2d62a393 | 449 | goto exit; // there was a problem |
icraggs | 8:c46930bd6c82 | 450 | |
icraggs | 8:c46930bd6c82 | 451 | /* wait for suback */ |
icraggs | 8:c46930bd6c82 | 452 | if (resultHandler == 0) |
icraggs | 8:c46930bd6c82 | 453 | { |
icraggs | 8:c46930bd6c82 | 454 | // this will block |
icraggs | 16:91c2f9a144d4 | 455 | if (waitfor(SUBACK, atimer) == SUBACK) |
icraggs | 8:c46930bd6c82 | 456 | { |
icraggs | 9:01b8cc7d94cc | 457 | int count = 0, grantedQoS = -1, mypacketid; |
icraggs | 16:91c2f9a144d4 | 458 | if (MQTTDeserialize_suback(&mypacketid, 1, &count, &grantedQoS, readbuf, limits.MAX_MQTT_PACKET_SIZE) == 1) |
icraggs | 8:c46930bd6c82 | 459 | rc = grantedQoS; // 0, 1, 2 or 0x80 |
icraggs | 16:91c2f9a144d4 | 460 | if (rc != 0x80) |
icraggs | 16:91c2f9a144d4 | 461 | { |
icraggs | 16:91c2f9a144d4 | 462 | for (int i = 0; i < limits.MAX_MESSAGE_HANDLERS; ++i) |
icraggs | 16:91c2f9a144d4 | 463 | { |
icraggs | 16:91c2f9a144d4 | 464 | if (messageHandlers[i].topic == 0) |
icraggs | 16:91c2f9a144d4 | 465 | { |
icraggs | 16:91c2f9a144d4 | 466 | messageHandlers[i].topic = topicFilter; |
icraggs | 16:91c2f9a144d4 | 467 | messageHandlers[i].fp.attach(messageHandler); |
icraggs | 16:91c2f9a144d4 | 468 | rc = 0; |
icraggs | 16:91c2f9a144d4 | 469 | break; |
icraggs | 16:91c2f9a144d4 | 470 | } |
icraggs | 16:91c2f9a144d4 | 471 | } |
icraggs | 16:91c2f9a144d4 | 472 | } |
icraggs | 8:c46930bd6c82 | 473 | } |
icraggs | 8:c46930bd6c82 | 474 | } |
icraggs | 8:c46930bd6c82 | 475 | else |
icraggs | 8:c46930bd6c82 | 476 | { |
icraggs | 8:c46930bd6c82 | 477 | // set subscribe response callback function |
icraggs | 8:c46930bd6c82 | 478 | |
icraggs | 8:c46930bd6c82 | 479 | } |
icraggs | 15:64a57183aa03 | 480 | |
icraggs | 15:64a57183aa03 | 481 | exit: |
Ian Craggs |
12:cc7f2d62a393 | 482 | return rc; |
icraggs | 15:64a57183aa03 | 483 | } |
icraggs | 15:64a57183aa03 | 484 | |
icraggs | 15:64a57183aa03 | 485 | |
icraggs | 16:91c2f9a144d4 | 486 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::unsubscribe(const char* topicFilter, resultHandler resultHandler) |
icraggs | 15:64a57183aa03 | 487 | { |
icraggs | 16:91c2f9a144d4 | 488 | int index = 0; |
icraggs | 16:91c2f9a144d4 | 489 | if (this->thread) |
icraggs | 16:91c2f9a144d4 | 490 | index = findFreeOperation(); |
icraggs | 16:91c2f9a144d4 | 491 | Timer& atimer = operations[index].timer; |
Ian Craggs |
12:cc7f2d62a393 | 492 | |
Ian Craggs |
12:cc7f2d62a393 | 493 | MQTTString topic = {(char*)topicFilter, 0, 0}; |
icraggs | 8:c46930bd6c82 | 494 | |
Ian Craggs |
12:cc7f2d62a393 | 495 | int len = MQTTSerialize_unsubscribe(buf, buflen, 0, packetid.getNext(), 1, &topic); |
icraggs | 16:91c2f9a144d4 | 496 | int rc = sendPacket(len, atimer); // send the subscribe packet |
icraggs | 15:64a57183aa03 | 497 | if (rc != len) |
Ian Craggs |
12:cc7f2d62a393 | 498 | goto exit; // there was a problem |
Ian Craggs |
12:cc7f2d62a393 | 499 | |
icraggs | 16:91c2f9a144d4 | 500 | /* wait for unsuback */ |
Ian Craggs |
12:cc7f2d62a393 | 501 | if (resultHandler == 0) |
Ian Craggs |
12:cc7f2d62a393 | 502 | { |
Ian Craggs |
12:cc7f2d62a393 | 503 | // this will block |
icraggs | 16:91c2f9a144d4 | 504 | if (waitfor(UNSUBACK) == UNSUBACK) |
Ian Craggs |
12:cc7f2d62a393 | 505 | { |
Ian Craggs |
12:cc7f2d62a393 | 506 | int mypacketid; |
Ian Craggs |
12:cc7f2d62a393 | 507 | if (MQTTDeserialize_unsuback(&mypacketid, readbuf, readbuflen) == 1) |
Ian Craggs |
12:cc7f2d62a393 | 508 | rc = 0; |
Ian Craggs |
12:cc7f2d62a393 | 509 | } |
Ian Craggs |
12:cc7f2d62a393 | 510 | } |
Ian Craggs |
12:cc7f2d62a393 | 511 | else |
Ian Craggs |
12:cc7f2d62a393 | 512 | { |
Ian Craggs |
12:cc7f2d62a393 | 513 | // set unsubscribe response callback function |
Ian Craggs |
12:cc7f2d62a393 | 514 | |
Ian Craggs |
12:cc7f2d62a393 | 515 | } |
icraggs | 15:64a57183aa03 | 516 | |
icraggs | 15:64a57183aa03 | 517 | exit: |
icraggs | 15:64a57183aa03 | 518 | command_timer.stop(); |
Ian Craggs |
12:cc7f2d62a393 | 519 | command_timer.reset(); |
Ian Craggs |
12:cc7f2d62a393 | 520 | return rc; |
icraggs | 15:64a57183aa03 | 521 | } |
icraggs | 15:64a57183aa03 | 522 | |
icraggs | 15:64a57183aa03 | 523 | |
icraggs | 15:64a57183aa03 | 524 | |
icraggs | 16:91c2f9a144d4 | 525 | template<class Network, class Timer, class Thread, class Mutex> int MQTT::Client<Network, Timer, Thread, Mutex>::publish(const char* topicName, Message* message, resultHandler resultHandler) |
icraggs | 15:64a57183aa03 | 526 | { |
icraggs | 15:64a57183aa03 | 527 | command_timer.start(); |
Ian Craggs |
12:cc7f2d62a393 | 528 | |
icraggs | 15:64a57183aa03 | 529 | MQTTString topic = {(char*)topicName, 0, 0}; |
icraggs | 15:64a57183aa03 | 530 | |
Ian Craggs |
12:cc7f2d62a393 | 531 | message->id = packetid.getNext(); |
icraggs | 15:64a57183aa03 | 532 | |
Ian Craggs |
12:cc7f2d62a393 | 533 | int len = MQTTSerialize_publish(buf, buflen, 0, message->qos, message->retained, message->id, topic, message->payload, message->payloadlen); |
icraggs | 15:64a57183aa03 | 534 | int rc = sendPacket(len); // send the subscribe packet |
icraggs | 15:64a57183aa03 | 535 | if (rc != len) |
Ian Craggs |
12:cc7f2d62a393 | 536 | goto exit; // there was a problem |
Ian Craggs |
12:cc7f2d62a393 | 537 | |
Ian Craggs |
12:cc7f2d62a393 | 538 | /* wait for acks */ |
Ian Craggs |
12:cc7f2d62a393 | 539 | if (resultHandler == 0) |
Ian Craggs |
12:cc7f2d62a393 | 540 | { |
icraggs | 15:64a57183aa03 | 541 | if (message->qos == QOS1) |
Ian Craggs |
12:cc7f2d62a393 | 542 | { |
icraggs | 16:91c2f9a144d4 | 543 | if (waitfor(PUBACK) == PUBACK) |
Ian Craggs |
12:cc7f2d62a393 | 544 | { |
Ian Craggs |
12:cc7f2d62a393 | 545 | int type, dup, mypacketid; |
Ian Craggs |
12:cc7f2d62a393 | 546 | if (MQTTDeserialize_ack(&type, &dup, &mypacketid, readbuf, readbuflen) == 1) |
Ian Craggs |
12:cc7f2d62a393 | 547 | rc = 0; |
icraggs | 15:64a57183aa03 | 548 | } |
icraggs | 15:64a57183aa03 | 549 | } |
icraggs | 15:64a57183aa03 | 550 | else if (message->qos == QOS2) |
icraggs | 15:64a57183aa03 | 551 | { |
icraggs | 16:91c2f9a144d4 | 552 | if (waitfor(PUBCOMP) == PUBCOMP) |
icraggs | 15:64a57183aa03 | 553 | { |
icraggs | 15:64a57183aa03 | 554 | int type, dup, mypacketid; |
icraggs | 15:64a57183aa03 | 555 | if (MQTTDeserialize_ack(&type, &dup, &mypacketid, readbuf, readbuflen) == 1) |
icraggs | 15:64a57183aa03 | 556 | rc = 0; |
icraggs | 15:64a57183aa03 | 557 | } |
icraggs | 15:64a57183aa03 | 558 | |
Ian Craggs |
12:cc7f2d62a393 | 559 | } |
Ian Craggs |
12:cc7f2d62a393 | 560 | } |
Ian Craggs |
12:cc7f2d62a393 | 561 | else |
Ian Craggs |
12:cc7f2d62a393 | 562 | { |
Ian Craggs |
12:cc7f2d62a393 | 563 | // set publish response callback function |
Ian Craggs |
12:cc7f2d62a393 | 564 | |
Ian Craggs |
12:cc7f2d62a393 | 565 | } |
icraggs | 15:64a57183aa03 | 566 | |
icraggs | 15:64a57183aa03 | 567 | exit: |
icraggs | 15:64a57183aa03 | 568 | command_timer.stop(); |
Ian Craggs |
12:cc7f2d62a393 | 569 | command_timer.reset(); |
icraggs | 8:c46930bd6c82 | 570 | return rc; |
icraggs | 8:c46930bd6c82 | 571 | } |
icraggs | 8:c46930bd6c82 | 572 | |
icraggs | 8:c46930bd6c82 | 573 | |
sam_grove | 0:fe461e4d7afe | 574 | #endif |