--- mqtt/inc/Attic/aitmqtt.h 2011/11/22 15:25:19 1.1.1.1.2.21 +++ mqtt/inc/Attic/aitmqtt.h 2011/12/13 15:23:43 1.1.1.1.2.34 @@ -95,9 +95,9 @@ typedef union { } mqtt_v_t; typedef struct { - mqtt_v_t sub_sb; - char *sub_data; - unsigned char sub_qos; + unsigned char sub_ret; + struct __sbuf sub_topic; + struct __sbuf sub_value; } mqtt_subscr_t; typedef struct { @@ -108,14 +108,17 @@ typedef struct { typedef unsigned char mqtthdr_protover_t; -typedef struct { - unsigned char reserved:1, - clean_sess:1, - will_flg:1, - will_qos:2, - will_retain:1, - password:1, - username:1; +typedef union { + struct { + unsigned char reserved:1, + clean_sess:1, + will_flg:1, + will_qos:2, + will_retain:1, + password:1, + username:1; + }; + unsigned char flags; } __packed mqtthdr_connflgs_t; typedef struct { @@ -178,11 +181,11 @@ inline unsigned int mqtt_encodeLen(unsigned int num); /* * mqtt_decodeLen() Decode length from MQTT packet * - * @len = length + * @len = length from MQTT header * @n = sizeof bytes, if !=NULL * return: -1 error, >-1 length of message */ -inline unsigned int mqtt_decodeLen(unsigned int len, char *n); +inline unsigned int mqtt_decodeLen(void * __restrict len, int * __restrict n); /* * mqtt_sizeLen Return sizeof len field * @@ -214,6 +217,14 @@ inline void mqtt_subFree(mqtt_subscr_t ** __restrict s * return: NULL error or subscribe array, after use must call mqtt_subFree() */ inline mqtt_subscr_t *mqtt_subAlloc(unsigned short num); +/* + * mqtt_subRealloc() Reallocate array from subscribe variables + * + * @subs = Subscribe array + * @num = Number of elements + * return: NULL error or subscribe array, after use must call mqtt_subFree() + */ +inline mqtt_subscr_t *mqtt_subRealloc(mqtt_subscr_t * __restrict subs, unsigned short num); /*** SENDER FUNCTIONS ***/ @@ -223,6 +234,7 @@ inline mqtt_subscr_t *mqtt_subAlloc(unsigned short num * * @buf = Message buffer * @csConnID = ConnectID + * @kasec = Keep alive timeout * @csUser = Username if !=NULL * @csPass = Password for Username, only if csUser is set * @csWillTopic = Will Topic if !=NULL Will Flags set into message @@ -233,7 +245,7 @@ inline mqtt_subscr_t *mqtt_subAlloc(unsigned short num * return: -1 error or >-1 message size for send */ int mqtt_msgCONNECT(mqtt_msg_t * __restrict buf, const char *csConnID, - const char *csUser, const char *csPass, + unsigned short kasec, const char *csUser, const char *csPass, const char *csWillTopic, const char *csWillMessage, unsigned char ClrSess, unsigned char WillQOS, unsigned char WillRetain); /* @@ -279,9 +291,9 @@ int mqtt_msgPINGRESP(mqtt_msg_t * __restrict buf); * @datlen = Publish data length * return: -1 error or >-1 message size for send */ -int mqtt_msgPUBLISH(mqtt_msg_t * __restrict buf, const char *csTopic, unsigned short msgID, - unsigned char Dup, unsigned char QOS, unsigned char Retain, - const void *pData, unsigned short datlen); +int mqtt_msgPUBLISH(mqtt_msg_t * __restrict buf, const char *csTopic, + unsigned short msgID, unsigned char Dup, unsigned char QOS, + unsigned char Retain, const void *pData, int datlen); /* * mqtt_msgPUBACK() Create PUBACK message * @@ -362,6 +374,135 @@ int mqtt_msgUNSUBACK(mqtt_msg_t * __restrict buf, unsi /*** RECEIVER FUNCTIONS ***/ + +/* + * mqtt_readCONNECT() Read elements from CONNECT message + * + * @buf = Message buffer + * @kasec = Keep Alive in seconds for current connection + * @psConnID = ConnectID + * @connLen = ConnectID length + * @psUser = Username if !=NULL + * @userLen = Username length + * @psPass = Password for Username, only if csUser is set + * @passLen = Password length + * @psWillTopic = Will Topic if !=NULL Will Flags set into message and must be free() + * @psWillMessage = Will Message, may be NULL if !NULL must be free() after use! + * return: .reserved == 1 is error or == 0 connection flags & msg ok + */ +mqtthdr_connack_t mqtt_readCONNECT(mqtt_msg_t * __restrict buf, unsigned short *kasec, + char * __restrict psConnID, int connLen, + char * __restrict psUser, int userLen, char * __restrict psPass, int passLen, + char ** __restrict psWillTopic, char ** __restrict psWillMessage); +/* + * mqtt_readCONNACK() Read CONNACK message + * + * @buf = Message buffer + * return: -1 error or >-1 CONNECT message return code + */ +unsigned char mqtt_readCONNACK(mqtt_msg_t * __restrict buf); +/* + * mqtt_readDISCONNECT() Read DISCONNECT message + * + * @buf = Message buffer + * return: -1 error, 0 ok, >0 undefined result + */ +int mqtt_readDISCONNECT(mqtt_msg_t * __restrict buf); +/* + * mqtt_readPINGREQ() Read PINGREQ message + * + * @buf = Message buffer + * return: -1 error, 0 ok, >0 undefined result + */ +int mqtt_readPINGREQ(mqtt_msg_t * __restrict buf); +/* + * mqtt_readPINGRESP() Read PINGRESP message + * + * @buf = Message buffer + * return: -1 error, 0 ok, >0 undefined result + */ +int mqtt_readPINGRESP(mqtt_msg_t * __restrict buf); + +/* + * mqtt_readPUBLISH() Read PUBLISH message + * + * @buf = Message buffer + * @psTopic = Topic + * @topicLen = Topic length + * @msgID = MessageID + * @pData = Data buffer + * @datLen = Data buffer length, if *datLen == 0 allocate memory for pData + * return: NULL error or !=NULL MQTT fixed header + */ +struct mqtthdr *mqtt_readPUBLISH(mqtt_msg_t * __restrict buf, char * __restrict psTopic, + int topicLen, unsigned short *msgID, void * __restrict pData, int *datLen); +/* + * mqtt_readPUBACK() Read PUBACK message + * + * @buf = Message buffer + * return: -1 error or MessageID + */ +u_short mqtt_readPUBACK(mqtt_msg_t * __restrict buf); +/* + * mqtt_readPUBREC() Read PUBREC message + * + * @buf = Message buffer + * return: -1 error or MessageID + */ +u_short mqtt_readPUBREC(mqtt_msg_t * __restrict buf); +/* + * mqtt_readPUBREL() Read PUBREL message + * + * @buf = Message buffer + * return: -1 error or MessageID + */ +u_short mqtt_readPUBREL(mqtt_msg_t * __restrict buf); +/* + * mqtt_readPUBCOMP() Read PUBCOMP message + * + * @buf = Message buffer + * return: -1 error or MessageID + */ +u_short mqtt_readPUBCOMP(mqtt_msg_t * __restrict buf); + +/* + * mqtt_readSUBSCRIBE() Read SUBSCRIBE message + * + * @buf = Message buffer + * @msgID = MessageID + * @subscr = Subscriptions, must be free after use with mqtt_subFree() + * return: NULL error or !=NULL MQTT fixed header + */ +struct mqtthdr *mqtt_readSUBSCRIBE(mqtt_msg_t * __restrict buf, unsigned short *msgID, + mqtt_subscr_t **subscr); +/* + * mqtt_readSUBACK() Read SUBACK message + * + * @buf = Message buffer + * @msgID = MessageID + * @subqos = Subscribes QoS, must be free after use with free() + * return: -1 error or >-1 readed subscribes QoS elements + */ +int mqtt_readSUBACK(mqtt_msg_t * __restrict buf, u_short *msgID, unsigned char **subqos); +/* + * mqtt_readUNSUBSCRIBE() Read UNSUBSCRIBE message + * + * @buf = Message buffer + * @msgID = MessageID + * @subscr = Subscriptions, must be free after use with mqtt_subFree() + * return: NULL error or !=NULL MQTT fixed header + */ +struct mqtthdr *mqtt_readUNSUBSCRIBE(mqtt_msg_t * __restrict buf, unsigned short *msgID, + mqtt_subscr_t **subscr); +/* + * mqtt_readUNSUBACK() Read UNSUBACK message + * + * @buf = Message buffer + * return: -1 error or MessageID + */ +u_short mqtt_readUNSUBACK(mqtt_msg_t * __restrict buf); + +/*** ENGINE FUNCTIONS ***/ /* * mqttInitCallbacks() Init callback array for dispatcher