--- libaitmqtt/inc/mqttapi.h 2012/05/05 13:31:48 1.1.2.7 +++ libaitmqtt/inc/mqttapi.h 2012/07/03 08:57:04 1.4 @@ -3,7 +3,7 @@ * by Michael Pounov * * $Author: misho $ -* $Id: mqttapi.h,v 1.1.2.7 2012/05/05 13:31:48 misho Exp $ +* $Id: mqttapi.h,v 1.4 2012/07/03 08:57:04 misho Exp $ * ************************************************************************** The ELWIX and AITNET software is distributed under the following @@ -59,6 +59,7 @@ typedef struct { mqtt_cb_t cmds[MQTT_TYPE_MAX]; int sock; + unsigned short timeout; mqtt_msg_t *buf; } mqtt_srv_t; #define mqtt_srv_setCmd(x, _cmd, _func) (assert((x)), (x)->cmds[(_cmd)] = (_func)) @@ -66,29 +67,57 @@ typedef struct { /* - * mqtt_srv_Init() Init server side actor + * mqtt_srv_cliInit() Init MQTT server side support for clients * * @sock = Client socket from accept() * @buf = Message buffer + * @timeout = timeout + * @nb = Non block socket * return: NULL error or !=NULL allocated server handle */ -mqtt_srv_t *mqtt_srv_Init(int sock, mqtt_msg_t * __restrict buf); +mqtt_srv_t *mqtt_srv_cliInit(int sock, mqtt_msg_t * __restrict buf, + unsigned short timeout, int nb); /* - * mqtt_srv_Fini() Finish MQTT server side support + * mqtt_srv_Fini() Finish MQTT server side support for clients * * @psrv = Server handle * return: none */ -void mqtt_srv_Fini(mqtt_srv_t ** __restrict psrv); +void mqtt_srv_cliFini(mqtt_srv_t ** __restrict psrv); /* - * mqtt_srv_Dispatch() MQTT server dispatcher + * mqtt_srv_Dispatch() MQTT server dispatcher for clients * * @srv = Server handle * @rlen = Ready bytes to parse * @arg = Argument pass to command callback * return: -1 error or 0 ok */ -int mqtt_srv_Dispatch(mqtt_srv_t * __restrict srv, int rlen, void *arg); +int mqtt_srv_cliDispatch(mqtt_srv_t * __restrict srv, int rlen, void *arg); + +/* + * mqtt_srv_Create() - Create server socket + * + * @sa = Server bind address + * @salen = Server struct sockaddr size + * return: -1 error or >-1 server socket + */ +int mqtt_srv_Create(struct sockaddr * __restrict sa, int salen); +/* + * mqtt_srv_Destroy() - Close server socket + * + * @sock = Server socket + * return: -1 error or 0 ok + */ +int mqtt_srv_Destroy(int sock); +/* + * mqtt_srv_Listen() - Listen server socket + * + * @sock = Server socket + * @maxconn = max number of pending connections + * @nb = Non block socket + * return: -1 error or 0 ok + */ +int mqtt_srv_Listen(int sock, int maxconn, int nb); #endif /* @@ -100,6 +129,16 @@ int mqtt_srv_Dispatch(mqtt_srv_t * __restrict srv, int * return: -1 error, 0 host is alive, 1 timeout session or 2 broken session */ int mqtt_KeepAlive(int sock, unsigned short ka, unsigned char tries); +/* + * mqtt_WillMessage() - Publish WILL message + * + * @sock = connected socket + * @ka = keep alive timeout + * @topic = will topic + * @data = will message + * return: -1 error, 1 timeout, 2 not ack or 0 ok + */ +int mqtt_WillMessage(int sock, unsigned short ka, const char *topic, const char *data); #ifdef API_CLIENT_SIDE @@ -107,6 +146,7 @@ int mqtt_KeepAlive(int sock, unsigned short ka, unsign typedef struct { int sock; + unsigned short timeout; mqtt_msg_t *buf; } mqtt_cli_t; @@ -115,9 +155,10 @@ typedef struct { * mqtt_cli_Open() - Open client connection to MQTT broker * * @addr = brokers address + * @timeout = timeout * return: NULL error or !=NULL connected to broker */ -mqtt_cli_t *mqtt_cli_Open(struct sockaddr *addr); +mqtt_cli_t *mqtt_cli_Open(struct sockaddr *addr, unsigned short timeout); /* * mqtt_cli_Close() - Close client connection * @@ -125,6 +166,50 @@ mqtt_cli_t *mqtt_cli_Open(struct sockaddr *addr); * return: -1 error or 0 disconnected client and freed all resources */ int mqtt_cli_Close(mqtt_cli_t ** __restrict cli); + +/* + * mqtt_cli_Subscribe() - Subscribe to broker + * + * @cli = connected client + * @Topics = Topics for subscribes + * @msgID = Message ID + * @Dup = Duplicated request + * @QoS = Message QoS + * return: NULL error or !=NULL allocated array with subscribed QoS responses, + * must be free() result! + */ +unsigned char *mqtt_cli_Subscribe(mqtt_cli_t * __restrict cli, + mqtt_subscr_t * __restrict Topics, unsigned short msgID, + unsigned char Dup, unsigned char QoS); +/* + * mqtt_cli_Unsubscribe() - Unsubscribe from broker + * + * @cli = connected client + * @Topics = Topics for unsubscribes + * @msgID = Message ID + * @Dup = Duplicated request + * @QoS = Message QoS + * return: -1 error or 0 ok + */ +int mqtt_cli_Unsubscribe(mqtt_cli_t * __restrict cli, + mqtt_subscr_t * __restrict Topics, unsigned short msgID, + unsigned char Dup, unsigned char QoS); +/* + * mqtt_cli_Publish() - Publish message to broker + * + * @cli = connected client + * @msgID = Message ID + * @Dup = Duplicated request + * @QoS = Message QoS + * @Retain = Retain message + * @csTopic = Topic + * @pData = Data + * @datLen = Data length + * return: -1 error or > -1 sended bytes + */ +int mqtt_cli_Publish(mqtt_cli_t * __restrict cli, unsigned short msgID, + unsigned char Dup, unsigned char QoS, unsigned char Retain, + const char *csTopic, const void *pData, int datLen); #endif