/**
  ******************************************************************************
  * @file    wifi_ind.h
  * @author
  * @version
  * @brief   This file provides the functions related to event handler mechanism.
  ******************************************************************************
  * @attention
  *
  * This module is a confidential and proprietary property of RealTek and
  * possession or use of this module requires written permission of RealTek.
  *
  * Copyright(c) 2016, Realtek Semiconductor Corporation. All rights reserved.
  ****************************************************************************** 
  */
  
#ifndef _WIFI_INDICATE_H
#define _WIFI_INDICATE_H

/** @addtogroup nic NIC
 *  @ingroup    wlan
 *  @brief      NIC functions
 *  @{
 */
 
#include "wifi_conf.h"  

typedef void (*rtw_event_handler_t)(char *buf, int buf_len, int flags, void* handler_user_data );

typedef struct
{
//	rtw_event_indicate_t	event_cmd;
	rtw_event_handler_t	handler;
	void*	handler_user_data;
} event_list_elem_t;

/** 
 * @brief  Initialize the event callback list.
 * @warning  Please make sure this function has been invoked before
 *  	 using the event handler related mechanism. 
 * @param  None
 * @return  None
 */
void init_event_callback_list(void);

/**
  * @brief  Wlan driver indicate event to upper layer through wifi_indication.
  * @param[in]  event: An event reported from driver to upper layer application. Please refer to rtw_event_indicate_t enum.
  * @param[in]  buf: If it is not NUL, buf is a pointer to the buffer for message string.
  * @param[in]  buf_len: The length of the buffer.
  * @param[in]  flags: Indicate some extra information, sometimes it is 0.
  * @retval None
  * @note  If upper layer application triggers additional operations on receiving of wext_wlan_indicate, 
  *			please strictly check current stack size usage (by using uxTaskGetStackHighWaterMark() ), 
  *			and tries not to share the same stack with wlan driver if remaining stack space is not available
  *			for the following operations. 
  *			ex: using semaphore to notice another thread instead of handing event directly in wifi_indication(). 
  * -	Wifi event list
  *
	* 0. WIFI_EVENT_CONNECT									: Indicate station connect to AP
  * 1. WIFI_EVENT_DISCONNECT							: Indicate station disconnect with AP 
  * 2. WIFI_EVENT_FOURWAY_HANDSHAKE_DONE 	: Indicate fourway handshake done in station mode when connects to WPA/WPA2 AP.
  * 3. WIFI_EVENT_SCAN_RESULT_REPORT			: Indicate wifi scan result report event. The event is for application to get the wifi scan result
  * 4. WIFI_EVENT_SCAN_DONE								: Indicate wifi scan done
  * 5. WIFI_EVENT_RECONNECTION_FAIL				: Indicate wifi reconnection failed
  * 6. WIFI_EVENT_SEND_ACTION_DONE				: Indicate the action frame status in p2p. Need to define CONFIG_P2P_NEW in wlan library, default is disable.
  * 7. WIFI_EVENT_RX_MGNT									: Indicate managerment frame receive
  * 8. WIFI_EVENT_STA_ASSOC								: Indicate client associate in AP mode
  * 9. WIFI_EVENT_STA_DISASSOC						: Indicate client disassociate in AP mode
  * 10. WIFI_EVENT_STA_WPS_START					: Indicate WPS process starting. This event is used in wps process.
  * 11. WIFI_EVENT_WPS_FINISH							: Indicate WPS process finish. This event is used in wps process.
  * 12. WIFI_EVENT_EAPOL_START						: Indicate receiving EAPOL_START packets in eap process. This event is used in eap process.
  * 13. WIFI_EVENT_EAPOL_RECVD						: Indicate receiving EAPOL packets in wps process. This event is used in wps process.
  * 14. WIFI_EVENT_NO_NETWORK							: Indicate the event that wifi connect failed cause of wifi scan can't scan the specific AP.
  * 15. WIFI_EVENT_BEACON_AFTER_DHCP			: Indicate station receive beacon after DHCP done. It is used to know the wifi connection is OK by receiving beacon after getting IP.
  * 16. WIFI_EVENT_IP_CHANGED							: Indicate IP has changed. It is application layer event, it is demoed in example_wifi_roaming.c
  * 17. WIFI_EVENT_ICV_ERROR							:	Indicate that the receiving packets has ICV error.
  * 18. WIFI_EVENT_CHALLENGE_FAIL					: Indicate authentication failed because of challenge failure
  * 19. WIFI_EVENT_MAX										: It stands for the end of wifi event.
  */
extern void wifi_indication( rtw_event_indicate_t event, char *buf, int buf_len, int flags);

/** 
 * @brief  Register the event listener.
 * @param[in] event_cmds : The event command number indicated.
 * @param[in] handler_func : the callback function which will 
 *  			  receive and process the event.
 * @param[in] handler_user_data : user specific data that will be 
 *  			   passed directly to the callback function.
 * @return  RTW_SUCCESS : if successfully registers the event.
 * @return  RTW_ERROR : if an error occurred.
 * @note  Set the same event_cmds with empty handler_func will
 *  	 unregister the event_cmds.
 */
extern void wifi_reg_event_handler(unsigned int event_cmds, rtw_event_handler_t handler_func, void *handler_user_data);

/**
 * @brief  Un-register the event listener.
 * @param[in] event_cmds : The event command number indicated.
 * @param[in] handler_func : the callback function which will 
 *  			  receive and process the event.
 *  
 * @return  RTW_SUCCESS : if successfully un-registers the event .
 * @return  RTW_ERROR : if an error occurred.
 */
extern void wifi_unreg_event_handler(unsigned int event_cmds, rtw_event_handler_t handler_func);

/*\@}*/

#endif //_WIFI_INDICATE_H