soc_wifi_api.h

浏览该文件的文档.

/*
* Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2019-2023. All rights reserved.
* Description: header file for wifi api.
*/
 
#ifndef EXT_WIFI_API_H
#define EXT_WIFI_API_H
 
#include <stdint.h>
#include "osal_types.h"
#include "td_type.h"
 
#ifdef __cplusplus
#if __cplusplus
extern "C" {
#endif
#endif
 
#ifndef MACSTR
#define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x"
#endif
 
#ifndef MAC2STR
#define mac2str(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5]
#endif
 
#ifndef bit
#define bit(x) (1U << (x))
#endif
 
#define WIFI_CIPHER_TKIP                 bit(3)
 
#define WIFI_CIPHER_CCMP                 bit(4)
 
#define WIFI_24G_CHANNEL_NUMS 14
 
#define WIFI_IFNAME_MAX_SIZE             16
 
#define WIFI_MIN_RECONNECT_TIMEOUT   2
 
#define WIFI_MAX_RECONNECT_TIMEOUT   65535
 
#define WIFI_MIN_RECONNECT_PERIOD    1
 
#define WIFI_MAX_RECONNECT_PERIOD   65535
 
#define WIFI_MIN_RECONNECT_TIMES    1
 
#define WIFI_MAX_RECONNECT_TIMES   65535
 
#define WIFI_SCAN_AP_LIMIT               64
 
#define WIFI_STATUS_BUF_LEN_LIMIT        512
 
#define WIFI_WPS_PIN_LEN             8
 
#define WIFI_DEFAULT_MAX_NUM_STA 8
#define WIFI_SCAN_CNT_DEFAULT_ENABLE                     (1 << 0)
#define WIFI_SCAN_TIME_DEFAULT_ENABLE                    (1 << 1)
#define WIFI_SCAN_CHANNEL_INTERVAL_DEFAULT_ENABLE        (1 << 2)
#define WIFI_WORK_TIME_ON_HOME_CHANNEL_DEFAULT_ENABLE    (1 << 3)
 
#define WIFI_SINGLE_PROBE_REQ_SEND_TIMES_DEFAULT_ENABLE    (1 << 4)
 
#define EXT_WIFI_OK      0
 
#define EXT_WIFI_FAIL    (-1)
 
#define EXT_WIFI_MAX_SSID_LEN  32
 
#define EXT_WIFI_MAC_LEN        6
 
#define EXT_WIFI_DEV_TYPE_LEN        8
 
#define EXT_WIFI_DEV_NAME_LEN        32
 
#define EXT_WIFI_GROUP_NAME_LEN       100
 
#define EXT_WIFI_TXT_ADDR_LEN   17
 
#define EXT_WIFI_AP_KEY_LEN     64
 
#define EXT_WIFI_MAX_KEY_LEN    64
 
#define EXT_WIFI_INVALID_CHANNEL 0xFF
 
#define EXT_WIFI_VENDOR_IE_MAX_IDX 1
 
#define EXT_WIFI_VENDOR_IE_MAX_LEN 255
 
#define EXT_WIFI_CUSTOM_PKT_MIN_LEN 24
 
#define EXT_WIFI_CUSTOM_PKT_MAX_LEN 1400
 
#define EXT_WIFI_STA_PSK_LEN                 32
 
#define EXT_WIFI_RETRY_MAX_NUM               15
 
#define EXT_WIFI_RETRY_MAX_TIME              200
 
#define EXT_WIFI_CB_MIN_PRIO                 10
 
#define EXT_WIFI_CB_MAX_PRIO                 30
 
#define EXT_WIFI_USR_IE_MAX_SIZE 257
 
#define EXT_WIFI_IDENTITY_LEN 64
 
/* 驱动上报的私有断连错误码偏移量, 与驱动中mac_status_code_enum对应,大于此偏移的错误码认为是STA主动断开 */
#define WIFI_MAC_REPORT_DISCONNECT_OFFSET 5200
 /* 未找到network的私有错误码 */
#define WIFI_NETWORK_NOT_FOUND_ERROR 5300
#define WLAN_REASON_MIC_FAILURE 14
typedef enum {
    EXT_WIFI_CAP_DISABLE = 0,    
    EXT_WIFI_CAP_ENABLE,          
    EXT_WIFI_CAP_BUTT
} ext_wifi_cap;
 
typedef enum {
    EXT_WIFI_MONITOR_OFF,                
    EXT_WIFI_MONITOR_MCAST_DATA,         
    EXT_WIFI_MONITOR_UCAST_DATA,         
    EXT_WIFI_MONITOR_MCAST_MANAGEMENT,   
    EXT_WIFI_MONITOR_UCAST_MANAGEMENT,   
    EXT_WIFI_MONITOR_BUTT
} ext_wifi_monitor_mode;
 
typedef enum {
    WLAN_JOIN_RSP_TIMEOUT = 5200,
    WLAN_AUTH_RSP2_TIMEOUT = 5201,
    WLAN_AUTH_RSP4_TIMEOUT = 5202,
    WLAN_ASOC_RSP_TIMEOUT = 5203,
    WLAN_AUTH_RSP_TIMEOUT = 5204,
    WLAN_ACTIVE_DISCONNECT_OFFSET = 5205,
    WLAN_DISASOC_MISC_LINKLOSS = 5206,
    WLAN_MAC_EXT_AUTH_FAIL = 5210
} ext_wifi_mac_disconnect_reason; /* 驱动上报的私有断连状态 */
typedef enum {
    EXT_WIFI_PKT_TYPE_BEACON,        
    EXT_WIFI_PKT_TYPE_PROBE_REQ,     
    EXT_WIFI_PKT_TYPE_PROBE_RESP,    
    EXT_WIFI_PKT_TYPE_ASSOC_REQ,     
    EXT_WIFI_PKT_TYPE_ASSOC_RESP,    
    EXT_WIFI_PKT_TYPE_BUTT
}ext_wifi_pkt_type;
 
typedef enum {
    EXT_WIFI_IFTYPE_UNSPECIFIED,
    EXT_WIFI_IFTYPE_ADHOC,
    EXT_WIFI_IFTYPE_STATION = 2,         
    EXT_WIFI_IFTYPE_AP = 3,              
    EXT_WIFI_IFTYPE_AP_VLAN,
    EXT_WIFI_IFTYPE_WDS,
    EXT_WIFI_IFTYPE_MONITOR,
    EXT_WIFI_IFTYPE_MESH_POINT = 7,      
    EXT_WIFI_IFTYPE_P2P_CLIENT,
    EXT_WIFI_IFTYPE_P2P_GO,
    EXT_WIFI_IFTYPE_P2P_DEVICE,
 
    EXT_WIFI_IFTYPES_BUTT
} ext_wifi_iftype;
 
typedef enum {
    EXT_WIFI_BW_HIEX_5M,     
    EXT_WIFI_BW_HIEX_10M,    
    EXT_WIFI_BW_LEGACY_20M,  
    EXT_WIFI_BW_BUTT
} ext_wifi_bw;
 
typedef enum {
    WIFI_11B_PHY_PROTOCOL_MODE              = 0,    
    WIFI_LEGACY_OFDM_PHY_PROTOCOL_MODE      = 1,    
    WIFI_HT_PHY_PROTOCOL_MODE               = 2,    
    WIFI_HE_SU_FORMAT                       = 3,    
} ext_phy_protocol_enum;
 
typedef enum {
    EXT_WIFI_SEC_TYPE_INVALID = -1,          
    EXT_WIFI_SECURITY_OPEN,                  
    EXT_WIFI_SECURITY_WEP,                   
    EXT_WIFI_SECURITY_WPA2PSK,               
    EXT_WIFI_SECURITY_WPAPSK_WPA2PSK_MIX,    
    EXT_WIFI_SECURITY_WPAPSK,                
    EXT_WIFI_SECURITY_WPA,                   
    EXT_WIFI_SECURITY_WPA2,                  
    EXT_WIFI_SECURITY_SAE,                   
    EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX,     
    EXT_WIFI_SECURITY_WPA3,                  
    EXT_WIFI_SECURITY_OWE,                   
    EXT_WIFI_SECURITY_WAPI_PSK,              
    EXT_WIFI_SECURITY_WAPI_CERT,             
    EXT_WIFI_SECURITY_WPA3_WPA2_MIX,         
    EXT_WIFI_SECURITY_WEP_OPEN,              
    EXT_WIFI_SECURITY_WPA3_192BIT,           
    EXT_WIFI_SECURITY_UNKNOWN                
} ext_wifi_auth_mode;
 
typedef enum {
    EXT_WIFI_PARIWISE_UNKNOWN,               
    EXT_WIFI_PAIRWISE_AES,                   
    EXT_WIFI_PAIRWISE_TKIP,                  
    EXT_WIFI_PAIRWISE_TKIP_AES_MIX,          
    EXT_WIFI_PAIRWISE_CCMP256,               
    EXT_WIFI_PAIRWISE_CCMP256_CCMP,          
    EXT_WIFI_PAIRWISE_CCMP256_TKIP,          
    EXT_WIFI_PAIRWISE_BUTT
} ext_wifi_pairwise;
 
typedef enum {
    WIFI_SAE_PWE_UNSPECIFIED,     
    WIFI_SAE_PWE_HUNT_AND_PECK,   
    WIFI_SAE_PWE_HASH_TO_ELEMENT, 
    WIFI_SAE_PWE_BOTH             
} wifi_sae_pwe_option_enum;
 
typedef enum {
    EXT_WIFI_DISCONNECTED,   
    EXT_WIFI_CONNECTED,      
    EXT_WIFI_CONNECTING,      
} ext_wifi_conn_status;
 
typedef enum  {
    EXT_WIFI_EXTEND_IE1,
    EXT_WIFI_EXTEND_IE2,
    EXT_WIFI_EXTEND_IE3,
    EXT_WIFI_EXTEND_IE4,
    EXT_WIFI_EXTEND_IE_BUTT
} ext_wifi_extend_ie_index;
 
typedef enum {
    EXT_WIFI_BEACON_IE       = (1 << 0),
    EXT_WIFI_PROBE_REQ_IE    = (1 << 1),
    EXT_WIFI_PROBE_RSP_IE    = (1 << 2)
} ext_wifi_frame_type;
 
typedef enum {
    EXT_WIFI_EVT_UNKNOWN,                       
    EXT_WIFI_EVT_SCAN_DONE,                     
    EXT_WIFI_EVT_CONNECTED,                     
    EXT_WIFI_EVT_DISCONNECTED,                  
    EXT_WIFI_EVT_WPS_TIMEOUT,                   
    EXT_WIFI_EVT_WPS_SUCCESS,                   
    EXT_WIFI_EVT_WPS_FAIL,                      
    EXT_WIFI_EVT_MESH_CONNECTED,                
    EXT_WIFI_EVT_MESH_DISCONNECTED,             
    EXT_WIFI_EVT_AP_START,                      
    EXT_WIFI_EVT_AP_DISABLE,                    
    EXT_WIFI_EVT_STA_CONNECTED,                 
    EXT_WIFI_EVT_STA_DISCONNECTED,              
    EXT_WIFI_EVT_STA_NO_NETWORK,                
    EXT_WIFI_EVT_MESH_CANNOT_FOUND,             
    EXT_WIFI_EVT_MESH_SCAN_DONE,                
    EXT_WIFI_EVT_MESH_STA_SCAN_DONE,            
    EXT_WIFI_EVT_AP_SCAN_DONE,                  
    EXT_WIFI_EVT_P2P_FIND_STOP,                 
    EXT_WIFI_EVT_P2P_PROV_DISC_PBC_REQ,         
    EXT_WIFI_EVT_P2P_PROV_DISC_PBC_RESP,        
    EXT_WIFI_EVT_P2P_GO_NEG_REQUEST,            
    EXT_WIFI_EVT_P2P_GO_NEG_SUCCESS,            
    EXT_WIFI_EVT_P2P_GO_NEG_FAILURE,            
    EXT_WIFI_EVT_P2P_GROUP_FORMATION_SUCCESS,   
    EXT_WIFI_EVT_P2P_GROUP_FORMATION_FAILURE,   
    EXT_WIFI_EVT_P2P_GROUP_STARTED,             
    EXT_WIFI_EVT_P2P_INVITATION_RECIEVE,        
    EXT_WIFI_EVT_P2P_INVITATION_RESULT,         
    EXT_WIFI_EVT_P2P_INVITATION_ACCEPT,         
    EXT_WIFI_EVT_BUTT
} ext_wifi_event_type;
 
typedef enum {
    EXT_WIFI_BASIC_SCAN,             
    EXT_WIFI_CHANNEL_SCAN,           
    EXT_WIFI_SSID_SCAN,              
    EXT_WIFI_SSID_PREFIX_SCAN,       
    EXT_WIFI_BSSID_SCAN,             
} ext_wifi_scan_type;
 
typedef enum {
    EXT_WIFI_WPA_PSK_NOT_USE,        
    EXT_WIFI_WPA_PSK_USE_INNER,      
    EXT_WIFI_WPA_PSK_USE_OUTER,      
} ext_wifi_wpa_psk_usage_type;
 
typedef enum {
    EXT_WIFI_XLDO_VOLTAGE_0 = 0x00,      
    EXT_WIFI_XLDO_VOLTAGE_1 = 0x11,      
    EXT_WIFI_XLDO_VOLTAGE_2 = 0x22,      
    EXT_WIFI_XLDO_VOLTAGE_3 = 0x33,      
} ext_wifi_xldo_voltage;
 
typedef enum {
    EXT_WIFI_EAP_METHOD_TLS,      
    EXT_WIFI_EAP_METHOD_BUTT
} ext_wifi_eap_method;
 
typedef enum {
    EXT_WIFI_RETRY_FRAME_DATA,             
    EXT_WIFI_RETRY_FRAME_MGMT,             
    EXT_WIFI_RETRY_FRAME_BUTT,
} ext_wifi_retry_frame_type;
 
typedef struct {
    unsigned int rate_value;    
} ext_alg_param_stru;
 
typedef struct {
    uint8_t enable;       
    uint8_t resv;
    uint16_t duration;    
    uint32_t cycle;       
} psd_option_param;
 
typedef struct {
    int8_t mdata_en  : 1;   
    int8_t udata_en  : 1;   
    int8_t mmngt_en  : 1;   
    int8_t umngt_en  : 1;   
    int8_t custom_en : 1;   
    int8_t resvd     : 3;   
} ext_wifi_ptype_filter_stru;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];
    unsigned char bssid[EXT_WIFI_MAC_LEN];
    unsigned char ssid_len;
    unsigned char chan_list[WIFI_24G_CHANNEL_NUMS];
    unsigned char chan_num;
    ext_wifi_scan_type scan_type;
} ext_wifi_scan_params;
 
typedef struct {
    /* default_enable. CNcomment:默认值使能位，1表示使能 */
    unsigned int default_enable;
    /* scan_cnt. CNcomment:扫描次数，取值范围1~2，默认为2 */
    unsigned char scan_cnt;
    /* scan_time. CNcomment:扫描驻留时间，取值范围20~120，默认为20 */
    unsigned char scan_time;
    /* scan_channel_interval. CNcomment:间隔n个信道，切回工作信道工作一段时间，n取值范围1~6，默认6 */
    unsigned char scan_channel_interval;
    /* work_time_on_home_channel. CNcomment:背景扫描时，返回工作信道工作的时间，取值范围30~120，默认110 */
    unsigned char work_time_on_home_channel;
    /* single_probe_send_times. CNcomment:单个probe req报文的发送次数，取值范围1~3，默认1 */
    unsigned char single_probe_send_times;
    unsigned char rsv[3];
} ext_wifi_scan_param_stru;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];   
    unsigned char bssid[EXT_WIFI_MAC_LEN];  
    ext_wifi_auth_mode auth;                
    unsigned int channel;                   
    int rssi;                               
    unsigned char wps_flag : 1;             
    unsigned char wps_session : 1;          
    unsigned char wmm : 1;                  
    unsigned char ft_flag : 1;              
    unsigned char ext_mesh_flag : 1;        
    ext_wifi_pairwise pairwise;             
} ext_wifi_ap_info;
 
/* 公共结构体定义 */
typedef struct {
    unsigned short length;          /* 不仅是本公共结构体长度，该字段是发送到驱动的参数结构体的总长度, frw消息时使用 */
    unsigned char type;             /* 业务类型 */
    unsigned char rsv;              /* 预留 */
    int (*wifi_app_service_cb)(void *param); /* 统一的回调函数 */
} wifi_app_common_input_param;
 
typedef struct {
    unsigned char *ssid;            /* 链表元素ssid ie;   从驱动回填 */
    unsigned char *bssid;           /* 链表元素bssid;   从驱动回填 */
    unsigned short caps;            /* 链表元素能力位;  从驱动回填 */
    unsigned short beacon_int;      /* 链表元素beacon周期;  从驱动回填 */
    int freq;                       /* 链表元素信道中心频率;  从驱动回填 */
    int level;                      /* 链表元素rssi;  从驱动回填 */
    unsigned char *frame_ie;        /* 链表元素ie指针;  从驱动回填 */
    unsigned short frame_ie_len;    /* 链表元素ie长度;  从驱动回填 */
    unsigned char ssid_ie_len;      /* 链表元素ssid ie长度; 从驱动回填 */
    unsigned char channel;          /* 链表元素所在信道, 目前仅获取扫描结果时使用 */
    unsigned char index;            /* 链表元素索引值, 目前仅获取扫描结果时使用 */
    unsigned char rsv[3];           /* 预留 */
} wifi_app_common_output_param;
 
typedef struct {
    wifi_app_common_input_param input_para;
    wifi_app_common_output_param output_para;
} wifi_app_common_param;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];    
    ext_wifi_auth_mode auth;                 
    char key[EXT_WIFI_MAX_KEY_LEN + 1];      
    unsigned char bssid[EXT_WIFI_MAC_LEN];   
    ext_wifi_pairwise pairwise;              
    unsigned char hex_flag;                  
    unsigned char ft_flag;                   
    unsigned char resv[3];                   
} ext_wifi_assoc_request;
 
typedef struct {
    ext_wifi_assoc_request req;              
    unsigned char channel;                  
    unsigned char psk[EXT_WIFI_STA_PSK_LEN]; 
    ext_wifi_wpa_psk_usage_type psk_flag;    
} ext_wifi_fast_assoc_request;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];    
    unsigned char bssid[EXT_WIFI_MAC_LEN];   
    unsigned int channel;                   
    ext_wifi_conn_status status;             
} ext_wifi_status;
 
typedef struct {
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];      
    unsigned short bss_num;
} event_wifi_scan_done;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];    
    unsigned char bssid[EXT_WIFI_MAC_LEN];   
    unsigned char ssid_len;                 
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];  
} event_wifi_connected;
 
typedef struct {
    unsigned char bssid[EXT_WIFI_MAC_LEN];    
    unsigned short reason_code;              
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];   
    unsigned char locally_generated;         
    unsigned char wpa_state;                 
} event_wifi_disconnected;
 
typedef struct {
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];   
} event_wifi_interface_name;
 
typedef struct {
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];     
    int msg;                                  
    unsigned short int config_error;          
    unsigned short int error_indication;      
} event_wifi_wps_fail;
 
typedef struct {
    char addr[EXT_WIFI_MAC_LEN];    
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];
} event_ap_sta_connected;
 
typedef struct {
    unsigned char addr[EXT_WIFI_MAC_LEN];    
    unsigned short reason_code;             
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];
} event_ap_sta_disconnected;
 
typedef struct {
    unsigned char addr[EXT_WIFI_MAC_LEN];    
} event_mesh_connected;
 
typedef struct {
    unsigned char addr[EXT_WIFI_MAC_LEN];    
    unsigned short reason_code;             
} event_mesh_disconnected;
 
typedef struct {
    unsigned char dev_addr[EXT_WIFI_MAC_LEN];           
    unsigned char pri_dev_type[EXT_WIFI_DEV_TYPE_LEN];  
    char dev_name[EXT_WIFI_DEV_NAME_LEN + 1];           
    unsigned short int supp_config_methods;             
    unsigned char dev_capab;                            
    unsigned char group_capab;                          
    char group[EXT_WIFI_GROUP_NAME_LEN];                
} event_p2p_prov_disc_pbc_request;
 
typedef struct {
    int peer_go;                              
    unsigned char peer[EXT_WIFI_MAC_LEN];     
} event_p2p_prov_disc_pbc_response;
 
typedef struct {
    unsigned char addr[EXT_WIFI_MAC_LEN];    
    unsigned short int dev_passwd_id;        
    unsigned char go_intent;                 
} event_p2p_go_neg_request;
 
typedef struct {
    int role_go;                                            
    int freq;                                               
    unsigned char peer_device_addr[EXT_WIFI_MAC_LEN];       
    unsigned char peer_interface_addr[EXT_WIFI_MAC_LEN];    
    int wps_method;                                         
} event_p2p_go_neg_success;
 
typedef struct {
    int status;                                            
} event_p2p_go_neg_failure;
 
typedef struct {
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];            
    int go;                                       
    char ssid_txt[EXT_WIFI_MAX_SSID_LEN * 4 + 1]; 
    int freq;                                     
    unsigned char go_dev_addr[EXT_WIFI_MAC_LEN];  
    int persistent;                               
} event_p2p_group_started;
 
typedef struct {
    unsigned char sa[EXT_WIFI_MAC_LEN];                  
    unsigned char go_dev_addr[EXT_WIFI_MAC_LEN];         
    unsigned char bssid[EXT_WIFI_MAC_LEN];               
    int op_freq;                                         
    int persistent_id;                                   
    int unknow_network;                                  
} event_p2p_invite_recieve;
 
typedef struct {
    int status;
} event_p2p_invite_result;
 
typedef struct {
    unsigned char sa[EXT_WIFI_MAC_LEN];                  
    unsigned char go_dev_addr[EXT_WIFI_MAC_LEN];         
    unsigned char bssid[EXT_WIFI_MAC_LEN];               
    int op_freq;                                         
    int persistent_id;                                   
} event_p2p_invite_accept;
 
typedef union {
    event_wifi_scan_done wifi_scan_done;                    
    event_wifi_connected wifi_connected;                    
    event_wifi_disconnected wifi_disconnected;              
    event_wifi_interface_name wifi_wps_timeout;             
    event_wifi_interface_name wifi_wps_success;             
    event_wifi_wps_fail wifi_wps_fail;                      
    event_wifi_interface_name wifi_ap_start;                
    event_wifi_interface_name wifi_ap_fail;                 
    event_ap_sta_connected ap_sta_connected;                
    event_ap_sta_disconnected ap_sta_disconnected;          
    event_wifi_interface_name scan_no_network;              
    event_mesh_connected mesh_connected;                    
    event_mesh_disconnected mesh_disconnected;              
    event_p2p_prov_disc_pbc_request p2p_disc_pbc_request;   
    event_p2p_prov_disc_pbc_response p2p_disc_pbc_response; 
    event_p2p_go_neg_request p2p_go_neg_request;            
    event_p2p_go_neg_success p2p_go_neg_success;            
    event_p2p_go_neg_failure p2p_go_neg_failure;            
    event_p2p_group_started p2p_go_group_started;           
    event_p2p_invite_recieve p2p_invite_recieve;            
    event_p2p_invite_result p2p_invite_result;              
    event_p2p_invite_accept p2p_invite_accept;              
} ext_wifi_event_info;
 
typedef struct {
    ext_wifi_event_type event;   
    ext_wifi_event_info info;    
} ext_wifi_event;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];    
    char key[EXT_WIFI_AP_KEY_LEN + 1];       
    unsigned char channel_num;              
    int ssid_hidden;                        
    ext_wifi_auth_mode authmode;             
    ext_wifi_pairwise pairwise;              
} ext_wifi_softap_config;
 
typedef struct {
    unsigned char mac[EXT_WIFI_MAC_LEN];     
} ext_wifi_ap_sta_info;
 
typedef struct {
    unsigned char ssid[EXT_WIFI_MAX_SSID_LEN + 1]; 
    char key[EXT_WIFI_AP_KEY_LEN + 1];             
} ext_wifi_sta_psk_config;
 
typedef struct {
    char ssid[EXT_WIFI_MAX_SSID_LEN + 1];        
    unsigned char bssid[EXT_WIFI_MAC_LEN];   
    char reserved;
    int security_type;       
    int rssi;               
    int band;               
    int channel_num;         
} ext_wifi_scan_result_stru;
 
typedef struct {
    unsigned int best_rate;
} ext_wifi_report_tx_params;
 
typedef void (*ext_wifi_scan_no_save_cb)(ext_wifi_scan_result_stru *scan_result);
 
typedef int (*uapi_wifi_ent_import_cb)(unsigned char **buf, unsigned int *len);
 
typedef int32_t (*wifi_psd_cb)(void *recv_buf, uint32_t data_len);
 
typedef struct {
    uapi_wifi_ent_import_cb  ca_cert_import;   
    uapi_wifi_ent_import_cb  cli_cert_import;  
    uapi_wifi_ent_import_cb  cli_key_import;   
} ext_wifi_ent_import_callback;
 
typedef struct {
    unsigned char user_idx;                     /* CSI白名单用户index 取值范围0~3，最多4个用户 */
    unsigned char enable;                       /* CSI白名单用户开关，0去使能，忽略以下所有参数， 1使能，校验后续参数 */
    unsigned char cfg_match_ta_ra_sel;          /* CSI白名单地址过滤类型 0 RA 1 TA */
    unsigned char resv;                         
    unsigned char mac_addr[EXT_WIFI_MAC_LEN];   /* 白名单MAC地址 */
    unsigned char frame_type_filter_bitmap;     /* 帧类型过滤具体参数 取值范围0~7，bit0管理帧 bit1控制帧 bit2数据帧 */
    unsigned char sub_type_filter_enable;       /* 帧子类型过滤开关，0关闭 1打开，只有在1时才会校验sub_type_filter_bitmap */
    unsigned char sub_type_filter;              /* 帧子类型过滤具体参数 4位二进制数对应的十进制结果（如 1100即为12） */
    unsigned char ppdu_filter_bitmap;           /* ppdu format过滤具体参数 取值范围0~63
                                               bit[0]:non-HT
                                               bit[1]:HE_(ER)SU
                                               bit[2]:HE_MU_MIMO
                                               bit[3]:HE_MU_OFDMA
                                               bit[4]:HT
                                               bit[5]:VHT */
    unsigned short period;                      /* CSI上报时间间隔 单位ms */
} ext_csi_config;
 
typedef int32_t (*wifi_promis_cb)(void* recv_buf, int32_t frame_len, int8_t rssi);
 
typedef void (*uapi_wifi_event_cb)(const ext_wifi_event *event);
 
typedef void (*wifi_csi_data_cb)(unsigned char *csi_data, int len);
 
unsigned int uapi_wifi_force_scan_complete(void);
 
unsigned int uapi_wifi_scan_results_clear(void);
 
int uapi_wifi_get_scan_flag(void);
 
int uapi_wifi_ap_scan(void);
 
int uapi_wifi_sta_raw_scan(ext_wifi_scan_params *sp, ext_wifi_scan_no_save_cb cb);
 
int uapi_wifi_csi_set_config(const char *ifname, const ext_csi_config *config);
 
void uapi_csi_register_data_report_cb(wifi_csi_data_cb data_cb);
 
int uapi_wifi_csi_start(void);
 
int uapi_wifi_csi_stop(void);
 
 
td_s32 uapi_wifi_set_pkt_retry_policy(td_u8 frame_type, td_u8 retry_count);
 
int uapi_wifi_mac_phy_reset(void);
 
td_u32 uapi_wifi_set_rts_threshold(td_u8 mode, td_u16 pkt_length);
 
uint32_t uapi_wifi_set_phy_txrate(td_u8 auto_rate, ext_alg_param_stru *alg_param);
 
typedef unsigned int (*uapi_wifi_report_tx_params_callback)(ext_wifi_report_tx_params*);
 
td_u32 uapi_wifi_enable_intrf_mode(const td_char *ifname, td_u8 enable, td_u16 flag);
 
td_s32 uapi_wifi_get_tx_params(const td_char *mac_addr, td_u8 mac_len, td_u32 *tx_best_rate);
 
td_s32 uapi_set_low_current_boot_mode(td_u16 flag);
 
int uapi_wifi_set_wow_switch(uint8_t enable);
 
int uapi_wifi_set_wow_pattern(unsigned char type, unsigned char index, unsigned char *pattern);
 
td_s32 uapi_wifi_init(const td_u8 vap_res_num, const td_u8 user_res_num);
 
int uapi_wifi_deinit(void);
 
unsigned char uapi_wifi_get_init_status(void);
 
int wifi_sta_set_sae_pwe(wifi_sae_pwe_option_enum pwe);
 
int wifi_softap_set_sae_pwe(wifi_sae_pwe_option_enum pwe);
 
int uapi_wifi_sta_start(char *ifname, int *len);
 
int uapi_wifi_sta_stop(void);
 
int uapi_wifi_sta_scan(void);
 
int uapi_wifi_sta_advance_scan(ext_wifi_scan_params *sp);
 
int uapi_wifi_sta_scan_results(ext_wifi_ap_info *ap_list, unsigned int *ap_num);
 
int uapi_wifi_sta_scan_results_clear(void);
 
int uapi_wifi_wnm_bss_query(int reason_code, int candidate_list);
 
int uapi_wifi_wnm_notify(const char *param, unsigned int len);
 
int uapi_wifi_sta_connect(const ext_wifi_assoc_request *req);
 
int uapi_wifi_sta_fast_connect(const ext_wifi_fast_assoc_request *fast_request);
 
int uapi_wifi_sta_disconnect(void);
 
int uapi_wifi_sta_set_reconnect_policy(int enable, unsigned int seconds,
    unsigned int period, unsigned int max_try_count);
 
int uapi_wifi_sta_reconnect_for_wfa_test(void);
 
int uapi_wifi_sta_get_connect_info(ext_wifi_status *connect_status);
 
int uapi_wifi_sta_wps_pbc(const unsigned char *bssid, unsigned int bssid_len);
 
int uapi_wifi_sta_wps_pin(const char *pin, unsigned int pin_len, const unsigned char *bssid, unsigned int bssid_len);
 
int uapi_wifi_sta_wps_pin_get(char *pin, unsigned int len);
 
int uapi_wifi_sta_get_ap_rssi(void);
 
int uapi_wifi_sta_get_ap_snr(void);
 
td_s32 uapi_wifi_ap_get_sta_info(td_char *mac_addr, td_s8 *rssi, td_u32 *best_rate);
 
td_s32 uapi_wifi_sta_set_pm_param(td_u8 pm_timeout, td_u8 pm_timer_cnt, td_u8 bcn_timeout,
    td_u8 mcast_timeout, td_u16 sleep_time);
 
int uapi_wifi_psk_calc(ext_wifi_sta_psk_config psk_config, unsigned char *get_psk, unsigned int psk_len);
 
int uapi_wifi_psk_calc_and_store(ext_wifi_sta_psk_config psk_config);
 
int uapi_wifi_config_callback(unsigned char mode, unsigned char task_prio, unsigned short stack_size);
 
int uapi_wifi_register_event_callback(uapi_wifi_event_cb event_cb);
 
int uapi_wifi_softap_set_beacon_period(int beacon_period);
 
int uapi_wifi_softap_set_dtim_period(int dtim_period);
 
int uapi_wifi_softap_set_group_rekey(int wifi_group_rekey);
 
int uapi_wifi_softap_set_shortgi(int flag);
 
int uapi_wifi_softap_start(ext_wifi_softap_config *conf, char *ifname, int *len);
 
int uapi_wifi_softap_stop(void);
 
int uapi_wifi_softap_get_connected_sta(ext_wifi_ap_sta_info *sta_list, unsigned int *sta_num);
 
int uapi_wifi_softap_deauth_sta(const unsigned char *addr, unsigned char addr_len);
 
int uapi_wifi_softap_set_pairwise(int pairwise);
 
td_s32 uapi_wifi_set_country(const td_char *cc, td_u8 cc_len);
 
td_s32 uapi_wifi_get_country(td_char *cc, td_u8 *len);
 
td_s32 uapi_wifi_set_bandwidth(const td_char *ifname, td_u8 ifname_len, ext_wifi_bw bw);
 
ext_wifi_bw uapi_wifi_get_bandwidth(const td_char *ifname, td_u8 ifname_len);
 
td_s32 uapi_wifi_set_channel(const td_char *ifname, td_u8 ifname_len, td_s32 channel);
 
td_s32 uapi_wifi_get_channel(const td_char *ifname, td_u8 ifname_len);
 
int uapi_wifi_set_scan_param(const td_char *ifname, ext_wifi_scan_param_stru *scan_param);
 
osal_s32 uapi_wifi_promis_enable(const osal_char *ifname, osal_s32 enable, const ext_wifi_ptype_filter_stru *filter);
 
int uapi_wifi_sdp_enable(const osal_char *ifname, osal_s32 enable, osal_s32 ratio);
 
int uapi_wifi_sdp_subscribe(const osal_char *ifname, osal_char *sdp_subscribe, osal_s32 local_handle);
 
int uapi_wifi_promis_set_rx_callback(wifi_promis_cb data_cb);
 
td_s32 uapi_wifi_set_pm_switch(td_u8 enable, td_u32 sleep_time);
 
osal_s32 uapi_wifi_set_linkloss_paras(osal_u8 probe_request_ratio, osal_u16 linkloss_threshold);
 
 
unsigned char uapi_wifi_arp_offload_setting(const char *ifname, unsigned char en, unsigned int ip);
 
unsigned int uapi_wifi_nd_offload_setting(const char *ifname, unsigned char en, unsigned char *ip6);
 
td_s32 uapi_wifi_set_txpower_up_limit(const td_char *ifname, td_s32 power);
 
td_s32 uapi_wifi_get_txpower_up_limit(const td_char *ifname);
 
td_u32 uapi_wifi_set_retry_params(const td_char *ifname, td_u8 type, td_u8 limit);
 
td_u32 uapi_wifi_set_cca_threshold(td_u8 mode, td_s8 threshold);
 
td_u32 uapi_wifi_set_tx_pwr_offset(const td_char *ifname, td_s16 offset);
 
int uapi_wifi_send_custom_pkt(const char* ifname, const unsigned char *data, unsigned int len);
 
int uapi_wifi_add_usr_app_ie(ext_wifi_iftype iftype, ext_wifi_extend_ie_index ie_index,
                             const unsigned char frame_type_bitmap, const unsigned char *ie, unsigned short ie_len);
 
 
int uapi_wifi_delete_usr_app_ie(ext_wifi_iftype iftype, ext_wifi_extend_ie_index ie_index,
                                const unsigned char frame_type_bitmap);
 
 
td_u32 uapi_wifi_set_tpc(td_u32 tpc_value);
 
short uapi_wifi_get_mac_status_code(void);
 
td_u32 uapi_wifi_set_evm_para(td_u8 pa_bias, const ext_wifi_xldo_voltage *osc_drv_vals, td_u8 size);
 
int uapi_wifi_sta_ent_set_eap_method(ext_wifi_eap_method method);
 
int uapi_wifi_sta_ent_set_identity(const char *identity, unsigned int len);
 
int uapi_wifi_sta_ent_set_import_callback(ext_wifi_ent_import_callback *cb);
 
typedef int32_t (*wifi_rx_mgmt_cb)(void *recv_buf, int32_t frame_len, int8_t rssi);
 
int uapi_wifi_set_mgmt_report(wifi_rx_mgmt_cb data_cb, uint8_t mode);
 
 
osal_u32 uapi_alg_ar_fix_cfg_etc(osal_u32 value);
 
int uapi_wifi_set_psd_enable(psd_option_param *psd_option);
 
int uapi_wifi_set_psd_cb(wifi_psd_cb data_cb);
 
typedef struct data_segment {
    uint8_t* data; /* 数据指针 */
    size_t len; /* 数据长度 */
} data_segment_t;
 
int uapi_wifi_send_pkt(osal_void *dev, const data_segment_t *seg, uint8_t seg_len);
 
int uapi_wifi_set_brctl(const char *oper, const char *if_name);
 
#ifdef __cplusplus
#if __cplusplus
    }
#endif
#endif
 
#endif /* end of soc_wifi_api.h */