--- mqtt/inc/Attic/aitmqtt.h 2011/11/28 10:17:12 1.1.1.1.2.22 +++ mqtt/inc/Attic/aitmqtt.h 2011/12/09 09:53:54 1.1.1.1.2.31 @@ -178,11 +178,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 +214,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 ***/ @@ -279,9 +287,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 +370,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 + * @psWillMessage = Will Message, may be NULL + * return: .reserved == 1 is error or == 0 connection flags & msg ok + */ +mqtthdr_connflgs_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