112 lines
5.4 KiB
C
112 lines
5.4 KiB
C
/**
|
|
******************************************************************************
|
|
* @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
|
|
|