D:/Project/SimpleLink/mqtt/doxygen/server/sl_mqtt_server.h

Go to the documentation of this file.

/*******************************************************************************
Copyright (c) (2014) Texas Instruments Incorporated
All rights reserved not granted herein.

Limited License.  

Texas Instruments Incorporated grants a world-wide, royalty-free, non-exclusive 
license under copyrights and patents it now or hereafter owns or controls to make, 
have made, use, import, offer to sell and sell ("Utilize") this software subject 
to the terms herein.  With respect to the foregoing patent license, such license 
is granted  solely to the extent that any such patent is necessary to Utilize the 
software alone.  The patent license shall not apply to any combinations which 
include this software, other than combinations with devices manufactured by or 
for TI (�TI Devices�).  No hardware patent is licensed hereunder.

Redistributions must preserve existing copyright notices and reproduce this license 
(including the above copyright notice and the disclaimer and (if applicable) source 
code license limitations below) in the documentation and/or other materials provided 
with the distribution

Redistribution and use in binary form, without modification, are permitted provided 
that the following conditions are met:
* No reverse engineering, decompilation, or disassembly of this software is 
  permitted with respect to any software provided in binary form.
* any redistribution and use are licensed by TI for use only with TI Devices.
* Nothing shall obligate TI to provide you with source code for the software 
  licensed and provided to you in object code.

If software source code is provided to you, modification and redistribution of the 
source code are permitted provided that the following conditions are met;
* any redistribution and use of the source code, including any resulting derivative 
  works, are licensed by TI for use only with TI Devices.
* any redistribution and use of any object code compiled from the source code and 
  any resulting derivative works, are licensed by TI for use only with TI Devices.

Neither the name of Texas Instruments Incorporated nor the names of its suppliers 
may be used to endorse or promote products derived from this software without 
specific prior written permission.

DISCLAIMER.

THIS SOFTWARE IS PROVIDED BY TI AND TI�S LICENSORS "AS IS" AND ANY EXPRESS OR IMPLIED 
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TI AND TI�S 
LICENSORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

******************************************************************************/

#include <stdio.h>
#include <string.h>
#include <stdbool.h>
#include "simplelink.h"

#ifndef __SL_MQTT_SRVR_H__
#define __SL_MQTT_SRVR_H__

#ifdef __cplusplus
extern "C"
{
#endif

#define SL_MQTT_SRVR_EVT_PUBACK   0x11  
#define SL_MQTT_SRVR_EVT_NOCONN   0x12   /* End SL MQTT Server events */
        
           
        typedef struct {
                
                _u16  (*sl_ExtLib_MqttConn)(_const char *clientId_str, _i32 clientId_len,
                                            _const char *username_str, _i32 username_len,
                                            _const char *password_str, _i32 password_len,
                                            void **usr);

                                      
                void (*sl_ExtLib_MqttRecv)(_const char *topstr,   _i32 toplen,
                                            _const void *payload, _i32 pay_len,
                                            bool dup, _u8 qos,
                                            bool retain);

                // Note: Double check whether retain, dup, qos would be required for a server app (with no topic management)

                void (*sl_ExtLib_MqttDisconn)(void *usr, bool due2err);

                
                void (*sl_ExtLib_MqttEvent)(void *usr, _i32 evt, _const void *buf, _u32 len);
                
        } SlMqttServerCbs_t;

        typedef struct {

                #define SL_MQTT_SRVR_NETCONN_IP6  0x01  
                #define SL_MQTT_SRVR_NETCONN_URL  0x02  
                #define SL_MQTT_SRVR_NETCONN_SEC  0x04  
                _u32         netconn_flags; 
                _const char          *server_addr;   
                _u16       port_number;   
                _u8        method;        
                _u32         cipher;        
                _u32         n_files;       
                char * _const        *secure_files; /*SL needs 4 files*/
                
        } SlMqttServerParams_t;
        

        typedef struct
        {
                SlMqttServerParams_t  server_info;      
                _u16  loopback_port;    
                _u32   rx_tsk_priority;  
                _u32    resp_time;        
                bool aux_debug_en;  
                _i32 (*dbg_print)(_const char *pcFormat, ...); 
        } SlMqttServerCfg_t;
    
        _i32 sl_ExtLib_MqttServerInit(_const SlMqttServerCfg_t *cfg,
                                       _const SlMqttServerCbs_t *cbs);

        _i32 sl_ExtLib_MqttTopicEnroll(_const char *topic);

        static inline _i32 sl_ExtLib_MqttTopicSub(_const char *topic)
        {
                return sl_ExtLib_MqttTopicEnroll(topic);
        }
        
        _i32 sl_ExtLib_MqttTopicDisenroll(_const char *topic);

        static inline _i32 sl_ExtLib_MqttTopicUnsub(_const char *topic)
        {
                return sl_ExtLib_MqttTopicDisenroll(topic);
        }

        _i32 sl_ExtLib_MqttServerSend(_const char *topic, _const void *data, _i32 len,
                                       _u8 qos, bool retain, _u32 flags);
 /* End SL MQTT Server API */

#ifdef __cplusplus  
}
#endif  



#endif // __SL_MQTT_SRVR_H__