// The MIT License (MIT) // // Copyright (c) 2015 Adafruit Industries // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. #include "Adafruit_MQTT.h" #ifdef ARDUINO_SAMD_ZERO static char *dtostrf (double val, signed char width, unsigned char prec, char *sout) { char fmt[20]; sprintf(fmt, "%%%d.%df", width, prec); sprintf(sout, fmt, val); return sout; } #endif void printBuffer(uint8_t *buffer, uint8_t len) { for (uint8_t i=0; i> 8; p++; p[0] = len & 0xFF; p++; memcpy(p, s, len); return p+len; } */ static uint8_t *stringprint_P(uint8_t *p, const char *s, uint16_t maxlen=0) { // If maxlen is specified (has a non-zero value) then use it as the maximum // length of the source string to write to the buffer. Otherwise write // the entire source string. uint16_t len = strlen_P(s); if (maxlen > 0 && len > maxlen) { len = maxlen; } /* for (uint8_t i=0; i> 8; p++; p[0] = len & 0xFF; p++; strncpy_P((char *)p, s, len); return p+len; } // Adafruit_MQTT Definition //////////////////////////////////////////////////// Adafruit_MQTT::Adafruit_MQTT(const char *server, uint16_t port, const char *cid, const char *user, const char *pass) { servername = server; portnum = port; clientid = cid; username = user; password = pass; // reset subscriptions for (uint8_t i=0; itopic, subscriptions[i]->qos); if (!sendPacket(buffer, len)) return -1; // Check for SUBACK if using MQTT 3.1.1 or higher // TODO: The Server is permitted to start sending PUBLISH packets matching the // Subscription before the Server sends the SUBACK Packet. // if(MQTT_PROTOCOL_LEVEL > 3) { // len = readPacket(buffer, 5, CONNECT_TIMEOUT_MS); // DEBUG_PRINT(F("SUBACK:\t")); // DEBUG_PRINTBUFFER(buffer, len); // if ((len != 5) || (buffer[0] != (MQTT_CTRL_SUBACK << 4))) { // return 6; // failure to subscribe // } // } } return 0; } const __FlashStringHelper* Adafruit_MQTT::connectErrorString(int8_t code) { switch (code) { case 1: return F("Wrong protocol"); case 2: return F("ID rejected"); case 3: return F("Server unavail"); case 4: return F("Bad user/pass"); case 5: return F("Not authed"); case 6: return F("Failed to subscribe"); case -1: return F("Connection failed"); default: return F("Unknown error"); } } bool Adafruit_MQTT::disconnect() { // Construct and send disconnect packet. uint8_t len = disconnectPacket(buffer); if (! sendPacket(buffer, len)) DEBUG_PRINTLN(F("Unable to send disconnect packet")); return disconnectServer(); } bool Adafruit_MQTT::publish(const char *topic, const char *data, uint8_t qos) { // Construct and send publish packet. uint8_t len = publishPacket(buffer, topic, data, qos); if (!sendPacket(buffer, len)) return false; // If QOS level is high enough verify the response packet. if (qos > 0) { len = readPacket(buffer, 4, PUBLISH_TIMEOUT_MS); DEBUG_PRINT(F("Publish QOS1+ reply:\t")); DEBUG_PRINTBUFFER(buffer, len); if (len != 4) return false; if ((buffer[0] >> 4) != MQTT_CTRL_PUBACK) return false; uint16_t packnum = buffer[2]; packnum <<= 8; packnum |= buffer[3]; // we increment the packet_id_counter right after publishing so inc here too to match packnum++; if (packnum != packet_id_counter) return false; } return true; } bool Adafruit_MQTT::will(const char *topic, const char *payload, uint8_t qos, uint8_t retain) { if (connected()) { DEBUG_PRINT(F("Will defined after connect")); return false; } will_topic = topic; will_payload = payload; will_qos = qos; will_retain = retain; return true; } bool Adafruit_MQTT::subscribe(Adafruit_MQTT_Subscribe *sub) { uint8_t i; // see if we are already subscribed for (i=0; itopic); // sending unsubscribe failed if (! sendPacket(buffer, len)) return false; // if QoS for this subscription is 1 or 2, we need // to wait for the unsuback to confirm unsubscription if(subscriptions[i]->qos > 0 && MQTT_PROTOCOL_LEVEL > 3) { // wait for UNSUBACK len = readPacket(buffer, 5, CONNECT_TIMEOUT_MS); DEBUG_PRINT(F("UNSUBACK:\t")); DEBUG_PRINTBUFFER(buffer, len); if ((len != 5) || (buffer[0] != (MQTT_CTRL_UNSUBACK << 4))) { return false; // failure to unsubscribe } } subscriptions[i] = 0; return true; } } // subscription not found, so we are unsubscribed return true; } Adafruit_MQTT_Subscribe *Adafruit_MQTT::readSubscription(int16_t timeout) { uint8_t i, topiclen, datalen; // Check if data is available to read. uint16_t len = readPacket(buffer, MAXBUFFERSIZE, timeout, true); // return one full packet if (!len) return NULL; // No data available, just quit. DEBUG_PRINTBUFFER(buffer, len); // Parse out length of packet. topiclen = buffer[3]; DEBUG_PRINT(F("Looking for subscription len ")); DEBUG_PRINTLN(topiclen); // Find subscription associated with this packet. for (i=0; itopic) != topiclen) continue; // Stop if the subscription topic matches the received topic. Be careful // to make comparison case insensitive. if (strncasecmp_P((char*)buffer+4, subscriptions[i]->topic, topiclen) == 0) { DEBUG_PRINT(F("Found sub #")); DEBUG_PRINTLN(i); break; } } } if (i==MAXSUBSCRIPTIONS) return NULL; // matching sub not found ??? // zero out the old data memset(subscriptions[i]->lastread, 0, SUBSCRIPTIONDATALEN); datalen = len - topiclen - 4; if (datalen > SUBSCRIPTIONDATALEN) { datalen = SUBSCRIPTIONDATALEN-1; // cut it off } // extract out just the data, into the subscription object itself memcpy(subscriptions[i]->lastread, buffer+4+topiclen, datalen); subscriptions[i]->datalen = datalen; DEBUG_PRINT(F("Data len: ")); DEBUG_PRINTLN(datalen); DEBUG_PRINT(F("Data: ")); DEBUG_PRINTLN((char *)subscriptions[i]->lastread); // return the valid matching subscription return subscriptions[i]; } void Adafruit_MQTT::flushIncoming(uint16_t timeout) { // flush input! DEBUG_PRINTLN(F("Flushing input buffer")); while (readPacket(buffer, MAXBUFFERSIZE, timeout)); } bool Adafruit_MQTT::ping(uint8_t num) { flushIncoming(100); while (num--) { // Construct and send ping packet. uint8_t len = pingPacket(buffer); if (!sendPacket(buffer, len)) continue; // Process ping reply. len = readPacket(buffer, 2, PING_TIMEOUT_MS); if (buffer[0] == (MQTT_CTRL_PINGRESP << 4)) return true; } return false; } // Packet Generation Functions ///////////////////////////////////////////////// // The current MQTT spec is 3.1.1 and available here: // http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718028 // However this connect packet and code follows the MQTT 3.1 spec here (some // small differences in the protocol): // http://public.dhe.ibm.com/software/dw/webservices/ws-mqtt/mqtt-v3r1.html#connect uint8_t Adafruit_MQTT::connectPacket(uint8_t *packet) { uint8_t *p = packet; uint16_t len; // fixed header, connection messsage no flags p[0] = (MQTT_CTRL_CONNECT << 4) | 0x0; p+=2; // fill in packet[1] last #if MQTT_PROTOCOL_LEVEL == 3 p = stringprint_P(p, PSTR("MQIsdp")); #elif MQTT_PROTOCOL_LEVEL == 4 p = stringprint_P(p, PSTR("MQTT")); #else #error "MQTT level not supported" #endif p[0] = MQTT_PROTOCOL_LEVEL; p++; // always clean the session p[0] = MQTT_CONN_CLEANSESSION; // set the will flags if needed if (will_topic && pgm_read_byte(will_topic) != 0) { p[0] |= MQTT_CONN_WILLFLAG; if(will_qos == 1) p[0] |= MQTT_CONN_WILLQOS_1; else if(will_qos == 2) p[0] |= MQTT_CONN_WILLQOS_2; if(will_retain == 1) p[0] |= MQTT_CONN_WILLRETAIN; } if (pgm_read_byte(username) != 0) p[0] |= MQTT_CONN_USERNAMEFLAG; if (pgm_read_byte(password) != 0) p[0] |= MQTT_CONN_PASSWORDFLAG; p++; p[0] = MQTT_CONN_KEEPALIVE >> 8; p++; p[0] = MQTT_CONN_KEEPALIVE & 0xFF; p++; if(MQTT_PROTOCOL_LEVEL == 3) { p = stringprint_P(p, clientid, 23); // Limit client ID to first 23 characters. } else { if (pgm_read_byte(clientid) != 0) { p = stringprint_P(p, clientid); } else { p[0] = 0x0; p++; p[0] = 0x0; p++; DEBUG_PRINTLN(F("SERVER GENERATING CLIENT ID")); } } if (will_topic && pgm_read_byte(will_topic) != 0) { p = stringprint_P(p, will_topic); p = stringprint_P(p, will_payload); } if (pgm_read_byte(username) != 0) { p = stringprint_P(p, username); } if (pgm_read_byte(password) != 0) { p = stringprint_P(p, password); } len = p - packet; packet[1] = len-2; // don't include the 2 bytes of fixed header data DEBUG_PRINTLN(F("MQTT connect packet:")); DEBUG_PRINTBUFFER(buffer, len); return len; } // as per http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718040 uint8_t Adafruit_MQTT::publishPacket(uint8_t *packet, const char *topic, const char *data, uint8_t qos) { uint8_t *p = packet; uint16_t len; p[0] = MQTT_CTRL_PUBLISH << 4 | qos << 1; // fill in packet[1] last p+=2; // topic comes before packet identifier p = stringprint_P(p, topic); // add packet identifier. used for checking PUBACK in QOS > 0 if(qos > 0) { p[0] = (packet_id_counter >> 8) & 0xFF; p[1] = packet_id_counter & 0xFF; p+=2; // increment the packet id packet_id_counter++; } memcpy(p, data, strlen(data)); p+=strlen(data); len = p - packet; packet[1] = len-2; // don't include the 2 bytes of fixed header data DEBUG_PRINTLN(F("MQTT publish packet:")); DEBUG_PRINTBUFFER(buffer, len); return len; } uint8_t Adafruit_MQTT::subscribePacket(uint8_t *packet, const char *topic, uint8_t qos) { uint8_t *p = packet; uint16_t len; p[0] = MQTT_CTRL_SUBSCRIBE << 4 | MQTT_QOS_1 << 1; // fill in packet[1] last p+=2; // packet identifier. used for checking SUBACK p[0] = (packet_id_counter >> 8) & 0xFF; p[1] = packet_id_counter & 0xFF; p+=2; // increment the packet id packet_id_counter++; p = stringprint_P(p, topic); p[0] = qos; p++; len = p - packet; packet[1] = len-2; // don't include the 2 bytes of fixed header data DEBUG_PRINTLN(F("MQTT subscription packet:")); DEBUG_PRINTBUFFER(buffer, len); return len; } uint8_t Adafruit_MQTT::unsubscribePacket(uint8_t *packet, const char *topic) { uint8_t *p = packet; uint16_t len; p[0] = MQTT_CTRL_UNSUBSCRIBE << 4 | 0x1; // fill in packet[1] last p+=2; // packet identifier. used for checking UNSUBACK p[0] = (packet_id_counter >> 8) & 0xFF; p[1] = packet_id_counter & 0xFF; p+=2; // increment the packet id packet_id_counter++; p = stringprint_P(p, topic); len = p - packet; packet[1] = len-2; // don't include the 2 bytes of fixed header data DEBUG_PRINTLN(F("MQTT unsubscription packet:")); DEBUG_PRINTBUFFER(buffer, len); return len; } uint8_t Adafruit_MQTT::pingPacket(uint8_t *packet) { packet[0] = MQTT_CTRL_PINGREQ << 4; packet[1] = 0; DEBUG_PRINTLN(F("MQTT ping packet:")); DEBUG_PRINTBUFFER(buffer, 2); return 2; } uint8_t Adafruit_MQTT::disconnectPacket(uint8_t *packet) { packet[0] = MQTT_CTRL_DISCONNECT << 4; packet[1] = 0; DEBUG_PRINTLN(F("MQTT disconnect packet:")); DEBUG_PRINTBUFFER(buffer, 2); return 2; } // Adafruit_MQTT_Publish Definition //////////////////////////////////////////// Adafruit_MQTT_Publish::Adafruit_MQTT_Publish(Adafruit_MQTT *mqttserver, const char *feed, uint8_t q) { mqtt = mqttserver; topic = feed; qos = q; } Adafruit_MQTT_Publish::Adafruit_MQTT_Publish(Adafruit_MQTT *mqttserver, const __FlashStringHelper *feed, uint8_t q) { mqtt = mqttserver; topic = (const char *)feed; qos = q; } bool Adafruit_MQTT_Publish::publish(int32_t i) { char payload[18]; itoa(i, payload, 10); return mqtt->publish(topic, payload, qos); } bool Adafruit_MQTT_Publish::publish(double f, uint8_t precision) { char payload[40]; // Need to technically hold float max, 39 digits and minus sign. dtostrf(f, 0, precision, payload); return mqtt->publish(topic, payload, qos); } bool Adafruit_MQTT_Publish::publish(uint32_t i) { char payload[18]; itoa(i, payload, 10); return mqtt->publish(topic, payload, qos); } bool Adafruit_MQTT_Publish::publish(const char *payload) { return mqtt->publish(topic, payload, qos); } // Adafruit_MQTT_Subscribe Definition ////////////////////////////////////////// Adafruit_MQTT_Subscribe::Adafruit_MQTT_Subscribe(Adafruit_MQTT *mqttserver, const char *feed, uint8_t q) { mqtt = mqttserver; topic = feed; qos = q; } Adafruit_MQTT_Subscribe::Adafruit_MQTT_Subscribe(Adafruit_MQTT *mqttserver, const __FlashStringHelper *feed, uint8_t q) { mqtt = mqttserver; topic = (const char *)feed; qos = q; }