MQTT / MQTTPacket

Basic C library for MQTT packet serialization and deserialization

Dependents:   MQTT MQTT MQTT MQTT ... more

Fork of MQTTPacket by MQTT

This library is part of the EclipseTM Paho project; specifically the embedded client.

A basic MQTT library in C for packet serialization and deserialization

MQTTPacket.h@18:bf36e077e7b8, 2014-09-29 (annotated)

Committer:
icraggs
Date:
Mon Sep 29 11:31:13 2014 +0000
Revision:
18:bf36e077e7b8
Parent:
14:c2052aee81de
Child:
23:7a52009beba1
Add packet formatting

Who changed what in which revision?

UserRevisionLine numberNew contents of line
icraggs 0:7734401cc1b4 1 /*******************************************************************************
icraggs 0:7734401cc1b4 2 * Copyright (c) 2014 IBM Corp.
icraggs 0:7734401cc1b4 3 *
icraggs 0:7734401cc1b4 4 * All rights reserved. This program and the accompanying materials
icraggs 0:7734401cc1b4 5 * are made available under the terms of the Eclipse Public License v1.0
icraggs 0:7734401cc1b4 6 * and Eclipse Distribution License v1.0 which accompany this distribution.
icraggs 0:7734401cc1b4 7 *
icraggs 0:7734401cc1b4 8 * The Eclipse Public License is available at
icraggs 0:7734401cc1b4 9 * http://www.eclipse.org/legal/epl-v10.html
icraggs 0:7734401cc1b4 10 * and the Eclipse Distribution License is available at
icraggs 0:7734401cc1b4 11 * http://www.eclipse.org/org/documents/edl-v10.php.
icraggs 0:7734401cc1b4 12 *
icraggs 0:7734401cc1b4 13 * Contributors:
icraggs 0:7734401cc1b4 14 * Ian Craggs - initial API and implementation and/or initial documentation
icraggs 0:7734401cc1b4 15 *******************************************************************************/
icraggs 0:7734401cc1b4 16
icraggs 0:7734401cc1b4 17 #ifndef MQTTPACKET_H_
icraggs 0:7734401cc1b4 18 #define MQTTPACKET_H_
icraggs 0:7734401cc1b4 19
icraggs 0:7734401cc1b4 20 #if defined(__cplusplus) /* If this is a C++ compiler, use C linkage */
icraggs 0:7734401cc1b4 21 extern "C" {
icraggs 0:7734401cc1b4 22 #endif
icraggs 0:7734401cc1b4 23
icraggs 0:7734401cc1b4 24 enum errors
icraggs 0:7734401cc1b4 25 {
icraggs 0:7734401cc1b4 26 MQTTPACKET_BUFFER_TOO_SHORT = -2,
icraggs 0:7734401cc1b4 27 MQTTPACKET_READ_ERROR = -1,
icraggs 0:7734401cc1b4 28 MQTTPACKET_READ_COMPLETE,
icraggs 0:7734401cc1b4 29 };
icraggs 0:7734401cc1b4 30
icraggs 0:7734401cc1b4 31 enum msgTypes
icraggs 0:7734401cc1b4 32 {
icraggs 0:7734401cc1b4 33 CONNECT = 1, CONNACK, PUBLISH, PUBACK, PUBREC, PUBREL,
icraggs 0:7734401cc1b4 34 PUBCOMP, SUBSCRIBE, SUBACK, UNSUBSCRIBE, UNSUBACK,
icraggs 0:7734401cc1b4 35 PINGREQ, PINGRESP, DISCONNECT
icraggs 0:7734401cc1b4 36 };
icraggs 0:7734401cc1b4 37
icraggs 0:7734401cc1b4 38 /**
icraggs 0:7734401cc1b4 39 * Bitfields for the MQTT header byte.
icraggs 0:7734401cc1b4 40 */
icraggs 0:7734401cc1b4 41 typedef union
icraggs 0:7734401cc1b4 42 {
Ian Craggs 12:cd99ac9cb25a 43 unsigned char byte; /**< the whole byte */
icraggs 0:7734401cc1b4 44 #if defined(REVERSED)
icraggs 0:7734401cc1b4 45 struct
icraggs 0:7734401cc1b4 46 {
icraggs 0:7734401cc1b4 47 unsigned int type : 4; /**< message type nibble */
icraggs 0:7734401cc1b4 48 unsigned int dup : 1; /**< DUP flag bit */
icraggs 0:7734401cc1b4 49 unsigned int qos : 2; /**< QoS value, 0, 1 or 2 */
icraggs 0:7734401cc1b4 50 unsigned int retain : 1; /**< retained flag bit */
icraggs 0:7734401cc1b4 51 } bits;
icraggs 0:7734401cc1b4 52 #else
icraggs 0:7734401cc1b4 53 struct
icraggs 0:7734401cc1b4 54 {
icraggs 0:7734401cc1b4 55 unsigned int retain : 1; /**< retained flag bit */
icraggs 0:7734401cc1b4 56 unsigned int qos : 2; /**< QoS value, 0, 1 or 2 */
icraggs 0:7734401cc1b4 57 unsigned int dup : 1; /**< DUP flag bit */
icraggs 0:7734401cc1b4 58 unsigned int type : 4; /**< message type nibble */
icraggs 0:7734401cc1b4 59 } bits;
icraggs 0:7734401cc1b4 60 #endif
icraggs 0:7734401cc1b4 61 } MQTTHeader;
icraggs 0:7734401cc1b4 62
icraggs 0:7734401cc1b4 63 typedef struct
icraggs 0:7734401cc1b4 64 {
icraggs 0:7734401cc1b4 65 int len;
icraggs 0:7734401cc1b4 66 char* data;
icraggs 0:7734401cc1b4 67 } MQTTLenString;
icraggs 0:7734401cc1b4 68
icraggs 0:7734401cc1b4 69 typedef struct
icraggs 0:7734401cc1b4 70 {
icraggs 0:7734401cc1b4 71 char* cstring;
icraggs 0:7734401cc1b4 72 MQTTLenString lenstring;
icraggs 0:7734401cc1b4 73 } MQTTString;
icraggs 0:7734401cc1b4 74
icraggs 0:7734401cc1b4 75 #define MQTTString_initializer {NULL, {0, NULL}}
icraggs 0:7734401cc1b4 76
icraggs 0:7734401cc1b4 77 int MQTTstrlen(MQTTString mqttstring);
icraggs 0:7734401cc1b4 78
icraggs 0:7734401cc1b4 79 #include "MQTTConnect.h"
icraggs 0:7734401cc1b4 80 #include "MQTTPublish.h"
icraggs 0:7734401cc1b4 81 #include "MQTTSubscribe.h"
icraggs 0:7734401cc1b4 82 #include "MQTTUnsubscribe.h"
icraggs 0:7734401cc1b4 83
Ian Craggs 14:c2052aee81de 84 int MQTTSerialize_ack(unsigned char* buf, int buflen, unsigned char type, unsigned char dup, unsigned short packetid);
Ian Craggs 14:c2052aee81de 85 int MQTTDeserialize_ack(unsigned char* packettype, unsigned char* dup, unsigned short* packetid, unsigned char* buf, int buflen);
icraggs 0:7734401cc1b4 86
icraggs 0:7734401cc1b4 87 int MQTTPacket_len(int rem_len);
icraggs 5:eea71419676a 88 int MQTTPacket_equals(MQTTString* a, char* b);
icraggs 0:7734401cc1b4 89
Ian Craggs 14:c2052aee81de 90 int MQTTPacket_encode(unsigned char* buf, int length);
Ian Craggs 14:c2052aee81de 91 int MQTTPacket_decode(int (*getcharfn)(unsigned char*, int), int* value);
Ian Craggs 14:c2052aee81de 92 int MQTTPacket_decodeBuf(unsigned char* buf, int* value);
icraggs 0:7734401cc1b4 93
Ian Craggs 14:c2052aee81de 94 int readInt(unsigned char** pptr);
Ian Craggs 14:c2052aee81de 95 char readChar(unsigned char** pptr);
Ian Craggs 14:c2052aee81de 96 void writeChar(unsigned char** pptr, char c);
Ian Craggs 14:c2052aee81de 97 void writeInt(unsigned char** pptr, int anInt);
Ian Craggs 14:c2052aee81de 98 int readMQTTLenString(MQTTString* mqttstring, unsigned char** pptr, unsigned char* enddata);
Ian Craggs 14:c2052aee81de 99 void writeCString(unsigned char** pptr, const char* string);
Ian Craggs 14:c2052aee81de 100 void writeMQTTString(unsigned char** pptr, MQTTString mqttstring);
icraggs 0:7734401cc1b4 101
Ian Craggs 14:c2052aee81de 102 int MQTTPacket_read(unsigned char* buf, int buflen, int (*getfn)(unsigned char*, int));
Ian Craggs 12:cd99ac9cb25a 103
icraggs 18:bf36e077e7b8 104 char* MQTTPacket_toString(char* strbuf, int strbuflen, unsigned char* buf, int buflen);
icraggs 18:bf36e077e7b8 105
icraggs 0:7734401cc1b4 106 #ifdef __cplusplus /* If this is a C++ compiler, use C linkage */
icraggs 0:7734401cc1b4 107 }
icraggs 0:7734401cc1b4 108 #endif
icraggs 0:7734401cc1b4 109
icraggs 0:7734401cc1b4 110
icraggs 0:7734401cc1b4 111 #endif /* MQTTPACKET_H_ */