WiFi Basic Settings

结构体
struct	ext_wifi_scan_params
struct	ext_wifi_scan_param_stru
struct	ext_wifi_ap_info
struct	ext_wifi_assoc_request
struct	ext_wifi_fast_assoc_request
struct	ext_wifi_status
struct	event_wifi_scan_done
struct	event_wifi_connected
struct	event_wifi_disconnected
struct	event_wifi_interface_name
struct	event_wifi_wps_fail
struct	event_ap_sta_connected
struct	event_ap_sta_disconnected
struct	event_mesh_connected
struct	event_mesh_disconnected
struct	event_p2p_prov_disc_pbc_request
struct	event_p2p_prov_disc_pbc_response
struct	event_p2p_go_neg_request
struct	event_p2p_go_neg_success
struct	event_p2p_go_neg_failure
struct	event_p2p_group_started
struct	event_p2p_invite_recieve
struct	event_p2p_invite_result
struct	event_p2p_invite_accept
union	ext_wifi_event_info
struct	ext_wifi_event
struct	ext_wifi_softap_config
struct	ext_wifi_ap_sta_info
struct	ext_wifi_sta_psk_config
struct	ext_wifi_report_tx_params
struct	ext_wifi_ent_import_callback

宏定义
#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
#define	P2P_MAC_LEN   6
#define	P2P_MAX_SSID_LEN   32
#define	WIFI_DEFAULT_P2P_MAX_NUM_CLIENT   4
#define	WPS_DEV_TYPE_LEN   8
#define	MAX_METHOND_CONFIG_LEN   44
#define	PSK_LEN   32
#define	MAX_CLINET_SAVE_ADDR_LEN   48
#define	PREFIX_NAME_LEN   32
#define	P2P_MAX_PERSISTENT_CNT   10

类型定义
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 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)
typedef unsigned int(*	uapi_wifi_report_tx_params_callback) (ext_wifi_report_tx_params *)
typedef int32_t(*	wifi_rx_mgmt_cb) (void *recv_buf, int32_t frame_len, int8_t rssi)

枚举
enum	ext_wifi_cap { EXT_WIFI_CAP_DISABLE = 0 , EXT_WIFI_CAP_ENABLE , EXT_WIFI_CAP_BUTT }
enum	ext_wifi_monitor_mode {   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 }
enum	ext_wifi_pkt_type {   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 }
enum	ext_wifi_iftype {   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 }
enum	ext_wifi_bw { EXT_WIFI_BW_HIEX_5M , EXT_WIFI_BW_HIEX_10M , EXT_WIFI_BW_LEGACY_20M , EXT_WIFI_BW_BUTT }
enum	ext_wifi_auth_mode {   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 }
enum	ext_wifi_pairwise {   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 }
enum	wifi_sae_pwe_option_enum { WIFI_SAE_PWE_UNSPECIFIED , WIFI_SAE_PWE_HUNT_AND_PECK , WIFI_SAE_PWE_HASH_TO_ELEMENT , WIFI_SAE_PWE_BOTH }
enum	ext_wifi_conn_status { EXT_WIFI_DISCONNECTED , EXT_WIFI_CONNECTED , EXT_WIFI_CONNECTING }
enum	ext_wifi_extend_ie_index {   EXT_WIFI_EXTEND_IE1 , EXT_WIFI_EXTEND_IE2 , EXT_WIFI_EXTEND_IE3 , EXT_WIFI_EXTEND_IE4 ,   EXT_WIFI_EXTEND_IE_BUTT }
enum	ext_wifi_event_type {   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 }
enum	ext_wifi_scan_type {   EXT_WIFI_BASIC_SCAN , EXT_WIFI_CHANNEL_SCAN , EXT_WIFI_SSID_SCAN , EXT_WIFI_SSID_PREFIX_SCAN ,   EXT_WIFI_BSSID_SCAN }
enum	ext_wifi_wpa_psk_usage_type { EXT_WIFI_WPA_PSK_NOT_USE , EXT_WIFI_WPA_PSK_USE_INNER , EXT_WIFI_WPA_PSK_USE_OUTER }
enum	ext_wifi_xldo_voltage { EXT_WIFI_XLDO_VOLTAGE_0 = 0x00 , EXT_WIFI_XLDO_VOLTAGE_1 = 0x11 , EXT_WIFI_XLDO_VOLTAGE_2 = 0x22 , EXT_WIFI_XLDO_VOLTAGE_3 = 0x33 }
enum	ext_wifi_eap_method { EXT_WIFI_EAP_METHOD_TLS , EXT_WIFI_EAP_METHOD_BUTT }
enum	ext_wifi_retry_frame_type { EXT_WIFI_RETRY_FRAME_DATA , EXT_WIFI_RETRY_FRAME_MGMT , EXT_WIFI_RETRY_FRAME_BUTT }

函数
int	uapi_wifi_sta_set_protocol_mode (protocol_mode_enum mode)
	Set protocol mode of sta.CNcomment:设置station接口的protocol模式.CNend
protocol_mode_enum	uapi_wifi_sta_get_protocol_mode (void)
	Get protocol mode of.CNcomment:获取station接口的protocol模式.CNend
int	uapi_wifi_softap_set_protocol_mode (protocol_mode_enum mode)
	Set protocol mode of softap.CNcomment:设置softap接口的protocol模式.CNend
protocol_mode_enum	uapi_wifi_softap_get_protocol_mode (void)
	Get protocol mode of softap.CNcomment:获取softap接口的protocol模式.CNend
int	uapi_wifi_set_pmf (wifi_pmf_option_enum pmf)
	Config pmf settings of sta.CNcomment:配置station的pmf.CNend
struct ext_wifi_dev *	wifi_dev_get (ext_wifi_iftype iftype)
	Get wifi device config.CNcomment:获取wifi device的配置.CNend
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)
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)
	Set wow switch.CNcomment:设置wow特性开关.CNend
int	uapi_wifi_set_wow_pattern (unsigned char type, unsigned char index, unsigned char *pattern)
	Set wow switch.CNcomment:配置wow特定唤醒报文格式.CNend
td_s32	uapi_wifi_init (const td_u8 vap_res_num, const td_u8 user_res_num)
	Wifi initialize.CNcomment:wifi初始化.CNend
int	uapi_wifi_deinit (void)
	Wifi de-initialize.CNcomment:wifi去初始化.CNend
unsigned char	uapi_wifi_get_init_status (void)
	Get wifi initialize status.CNcomment:获取wifi初始化状态.CNend
int	wifi_sta_set_sae_pwe (wifi_sae_pwe_option_enum pwe)
	Config sae pwe settings of sta.CNcomment:配置station的sae pwe.CNend
int	wifi_softap_set_sae_pwe (wifi_sae_pwe_option_enum pwe)
	Config sae pwe settings of softap.CNcomment:配置softap的sae pwe.CNend
int	uapi_wifi_sta_start (char *ifname, int *len)
	Start wifi station.CNcomment:开启STA.CNend
int	uapi_wifi_sta_stop (void)
	Close wifi station.CNcomment:关闭STA.CNend
int	uapi_wifi_sta_scan (void)
	Start sta basic scanning in all channels.CNcomment:station进行全信道基础扫描.CNend
int	uapi_wifi_sta_advance_scan (ext_wifi_scan_params *sp)
	Start station scanning with specified parameter.CNcomment:station执行带特定参数的扫描.CNend
int	uapi_wifi_sta_scan_results (ext_wifi_ap_info *ap_list, unsigned int *ap_num)
	sta start scan.CNcomment:station进行扫描.CNend
int	uapi_wifi_sta_scan_results_clear (void)
	Clear sta scan result.CNcomment:清除sta扫描链表.CNend
int	uapi_wifi_wnm_bss_query (int reason_code, int candidate_list)
	Clear sta scan result.CNcomment:发送bss query报文.CNend
int	uapi_wifi_wnm_notify (const char *param, unsigned int len)
	Clear sta scan result.CNcomment:发送wnm notify query报文.CNend
int	uapi_wifi_sta_connect (const ext_wifi_assoc_request *req)
	sta start connect.CNcomment:station进行连接网络.CNend
int	uapi_wifi_sta_fast_connect (const ext_wifi_fast_assoc_request *fast_request)
	Start fast connect.CNcomment:station进行快速连接网络.CNend
int	uapi_wifi_sta_disconnect (void)
	Disconnect from network.CNcomment:station断开相连的网络.CNend
int	uapi_wifi_sta_set_reconnect_policy (int enable, unsigned int seconds, unsigned int period, unsigned int max_try_count)
	Set reconnect policy.CNcomment:station设置重新连接网络机制.CNend
int	uapi_wifi_sta_reconnect_for_wfa_test (void)
	STA reconnect without deleting the network configuration, only used for WFA tests. CNcomment:station模式下重新发起关联但不删除network配置信息,仅WFA测试使用.CNend
int	uapi_wifi_sta_get_connect_info (ext_wifi_status *connect_status)
	Get status of sta.CNcomment:获取station连接的网络状态.CNend
int	uapi_wifi_sta_wps_pbc (const unsigned char *bssid, unsigned int bssid_len)
	Start pbc connect in WPS.CNcomment:设置WPS进行pbc连接.CNend
int	uapi_wifi_sta_wps_pin (const char *pin, unsigned int pin_len, const unsigned char *bssid, unsigned int bssid_len)
	Start pin connect in WPS.CNcomment:WPS通过pin码连接网络.CNend
int	uapi_wifi_sta_wps_pin_get (char *pin, unsigned int len)
	Get pin code.CNcomment:WPS获取pin码.CNend
int	uapi_wifi_sta_get_ap_rssi (void)
	Get rssi value.CNcomment:获取rssi值.CNend
int	uapi_wifi_sta_get_ap_snr (void)
	Get snr value.CNcomment:获取snr值.CNend
td_s32	uapi_wifi_ap_get_sta_info (td_char *mac_addr, td_s8 *rssi, td_u32 *best_rate)
	Get info of sta which ap connected to.CNcomment:获取ap连接的sta信息.CNend
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)
	Set sta powersave configuration.CNcomment:设置STA的低功耗参数.CNend
int	uapi_wifi_psk_calc (ext_wifi_sta_psk_config psk_config, unsigned char *get_psk, unsigned int psk_len)
	WPA PSK Calculate.CNcomment:计算WPA PSK.CNend
int	uapi_wifi_psk_calc_and_store (ext_wifi_sta_psk_config psk_config)
	WPA PSK Calculate，then keep it inside .CNcomment:计算WPA PSK, 并做内部保存.CNend
int	uapi_wifi_config_callback (unsigned char mode, unsigned char task_prio, unsigned short stack_size)
	config calling mode of user's callback interface.CNcomment:配置用户回调接口的调用方式.CNend
int	uapi_wifi_register_event_callback (uapi_wifi_event_cb event_cb)
	register user callback interface.CNcomment:注册回调函数接口.CNend
int	uapi_wifi_softap_set_beacon_period (int beacon_period)
	Set softap's beacon interval.CNcomment:设置softap的beacon周期.CNend
int	uapi_wifi_softap_set_dtim_period (int dtim_period)
	Set softap's dtim count.CNcomment:设置softap的dtim周期.CNend
int	uapi_wifi_softap_set_group_rekey (int wifi_group_rekey)
	Set update time of softap's group key.CNcomment:配置softap组播秘钥更新时间.CNend
int	uapi_wifi_softap_set_shortgi (int flag)
	Set short-gi of softap.CNcomment:设置softap的SHORT-GI功能.CNend
int	uapi_wifi_softap_start (ext_wifi_softap_config *conf, char *ifname, int *len)
	Start softap interface.CNcomment:开启SoftAP.CNend
int	uapi_wifi_softap_stop (void)
	Close softap interface.CNcomment:关闭SoftAP.CNend
int	uapi_wifi_softap_get_connected_sta (ext_wifi_ap_sta_info *sta_list, unsigned int *sta_num)
	Get all user's information of softap.CNcomment:softap获取已连接的station的信息.CNend
int	uapi_wifi_softap_deauth_sta (const unsigned char *addr, unsigned char addr_len)
	Softap deauth user by mac address.CNcomment:softap指定断开连接的station网络.CNend
int	uapi_wifi_softap_set_pairwise (int pairwise)
	Set softap pairwise.CNcomment:设置pairwise.CNend
td_s32	uapi_wifi_set_country (const td_char *cc, td_u8 cc_len)
	Set country code.CNcomment:设置国家码.CNend
td_s32	uapi_wifi_get_country (td_char *cc, td_u8 *len)
	Get country code.CNcomment:获取国家码.CNend
td_s32	uapi_wifi_set_bandwidth (const td_char *ifname, td_u8 ifname_len, ext_wifi_bw bw)
	Set bandwidth.CNcomment:设置带宽.CNend
ext_wifi_bw	uapi_wifi_get_bandwidth (const td_char *ifname, td_u8 ifname_len)
	Get bandwidth.CNcomment:获取带宽.CNend
td_s32	uapi_wifi_set_channel (const td_char *ifname, td_u8 ifname_len, td_s32 channel)
	Set channel.CNcomment:设置信道.CNend
td_s32	uapi_wifi_get_channel (const td_char *ifname, td_u8 ifname_len)
	Get channel.CNcomment:获取信道.CNend
int	uapi_wifi_set_scan_param (const td_char *ifname, ext_wifi_scan_param_stru *scan_param)
	Set scan.param.CNcomment:设置扫描参数.CNend
osal_s32	uapi_wifi_promis_enable (const osal_char *ifname, osal_s32 enable, const ext_wifi_ptype_filter_stru *filter)
	Set monitor mode.CNcomment:设置混杂模式.CNend
int	uapi_wifi_sdp_enable (const osal_char *ifname, osal_s32 enable, osal_s32 ratio)
	Set wifi aware enable.CNcomment:设置wifi aware使能.CNend
int	uapi_wifi_sdp_subscribe (const osal_char *ifname, osal_char *sdp_subscribe, osal_s32 local_handle)
	Set wifi aware subscribe.CNcomment:设置wifi aware订阅.CNend
int	uapi_wifi_promis_set_rx_callback (wifi_promis_cb data_cb)
	Register receive callback in monitor mode.CNcomment:注册混杂模式的收包回调函数.CNend
td_s32	uapi_wifi_set_pm_switch (td_u8 enable, td_u32 sleep_time)
	Open/close system power save.CNcomment:开启/关闭WiFi低功耗模式并配置预期休眠时间.CNend
unsigned char	uapi_wifi_arp_offload_setting (const char *ifname, unsigned char en, unsigned int ip)
	Set arp offload on/off.CNcomment:设置arp offload 打开/关闭.CNend
unsigned int	uapi_wifi_nd_offload_setting (const char *ifname, unsigned char en, unsigned char *ip6)
	Set nd offload on/off.CNcomment:设置nd offload 打开/关闭.CNend
td_s32	uapi_wifi_set_txpower_up_limit (const td_char *ifname, td_s32 power)
	Set tx power.CNcomment:设置发送功率上限.CNend
td_s32	uapi_wifi_get_txpower_up_limit (const td_char *ifname)
	Get tx power.CNcomment:获取发送功率上限.CNend
td_u32	uapi_wifi_set_retry_params (const td_char *ifname, td_u8 type, td_u8 limit)
	Set retry params.CNcomment:设置软件重传策略.CNend
td_u32	uapi_wifi_set_cca_threshold (td_u8 mode, td_s8 threshold)
	Set cca threshold.CNcomment:设置CCA门限.CNend
td_u32	uapi_wifi_set_tx_pwr_offset (const td_char *ifname, td_s16 offset)
	Set tx power offset.CNcomment:设置发送功率偏移.CNend
int	uapi_wifi_send_custom_pkt (const char *ifname, const unsigned char *data, unsigned int len)
	Send a custom frame.CNcomment:发送用户定制报文.CNend
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)
	Add user IEs to management frame.CNcomment:在管理帧中添加用户IE字段。CNend
int	uapi_wifi_delete_usr_app_ie (ext_wifi_iftype iftype, ext_wifi_extend_ie_index ie_index, const unsigned char frame_type_bitmap)
	Delete user IEs from management frame.CNcomment:在管理帧中删除用户IE字段。CNend
td_u32	uapi_wifi_set_tpc (td_u32 tpc_value)
	Set tcp mode.CNcomment:设置tpc开关.CNend
short	uapi_wifi_get_mac_status_code (void)
	Get Status Codes for Authentication and Association Frames. CNcomment:查询Authentication与Association帧status code.CNend
td_u32	uapi_wifi_set_evm_para (td_u8 pa_bias, const ext_wifi_xldo_voltage *osc_drv_vals, td_u8 size)
	Set evm para.CNcomment:设置evm参数.CNend
int	uapi_wifi_sta_ent_set_eap_method (ext_wifi_eap_method method)
	Set wpa-enterprise eap method.CNcomment:设置企业级方法.CNend
int	uapi_wifi_sta_ent_set_identity (const char *identity, unsigned int len)
	Set wpa-enterprise identity.CNcomment:设置企业级身份信息.CNend
int	uapi_wifi_sta_ent_set_import_callback (ext_wifi_ent_import_callback *cb)
	Set wpa-enterprise read callback.CNcomment:设置企业级证书/密钥读取的回调接口.CNend
int	uapi_wifi_set_mgmt_report (wifi_rx_mgmt_cb data_cb, uint8_t mode)
	Register receive callback for management frame.CNcomment:注册管理帧收包回调函数.CNend
osal_u32	uapi_alg_ar_fix_cfg_etc (osal_u32 value)
	Set wpa-enterprise read callback.CNcomment:autorate配置速率模式函数接口.CNend
int	uapi_wifi_set_psd_enable (psd_option_param *psd_option)
	Set psd enable mode.CNcomment:配置PSD状态函数接口.CNend
int	uapi_wifi_set_psd_cb (wifi_psd_cb data_cb)
	Set psd callback.CNcomment:配置PSD回调.CNend
int	uapi_wifi_send_pkt (osal_void *dev, const data_segment_t *seg, uint8_t seg_len)
	获取数据发包.CNcomment:配置发包接口.CNend
int	uapi_wifi_set_brctl (const char *oper, const char *if_name)
	配置Repeater开关及接口.CNcomment:配置Repeater开关及接口.CNend

详细描述

宏定义说明

EXT_WIFI_AP_KEY_LEN

#define EXT_WIFI_AP_KEY_LEN   64

Length of Key.CNcomment:KEY 密码长度定义.CNend

EXT_WIFI_CB_MAX_PRIO

#define EXT_WIFI_CB_MAX_PRIO   30

Max priority of callback task.CNcomment:事件回调task的最大优先级.CNend

EXT_WIFI_CB_MIN_PRIO

#define EXT_WIFI_CB_MIN_PRIO   10

Minimum priority of callback task.CNcomment:事件回调task的最小优先级.CNend

EXT_WIFI_CUSTOM_PKT_MAX_LEN

#define EXT_WIFI_CUSTOM_PKT_MAX_LEN   1400

Max length of custom's frame.CNcomment:用户定制报文最大长度值.CNend

EXT_WIFI_CUSTOM_PKT_MIN_LEN

#define EXT_WIFI_CUSTOM_PKT_MIN_LEN   24

Minimum length of custom's frame.CNcomment:用户定制报文最小长度值.CNend

EXT_WIFI_DEV_NAME_LEN

#define EXT_WIFI_DEV_NAME_LEN   32

Length of device name.CNcomment:device name长度定义.CNend

EXT_WIFI_DEV_TYPE_LEN

#define EXT_WIFI_DEV_TYPE_LEN   8

Length of device type.CNcomment:device type长度定义.CNend

EXT_WIFI_FAIL

#define EXT_WIFI_FAIL   (-1)

return failed value.CNcomment:返回值错误标识.CNend

EXT_WIFI_GROUP_NAME_LEN

#define EXT_WIFI_GROUP_NAME_LEN   100

Length of group name.CNcomment:group name长度定义.CNend

EXT_WIFI_IDENTITY_LEN

#define EXT_WIFI_IDENTITY_LEN   64

max identity length.CNcomment:身份字段最大长度CNend

EXT_WIFI_INVALID_CHANNEL

#define EXT_WIFI_INVALID_CHANNEL   0xFF

Return value of invalid channel.CNcomment:无效信道返回值.CNend

EXT_WIFI_MAC_LEN

#define EXT_WIFI_MAC_LEN   6

Length of MAC address.CNcomment:MAC地址长度定义.CNend

EXT_WIFI_MAX_KEY_LEN

#define EXT_WIFI_MAX_KEY_LEN   64

Maximum length of Key.CNcomment:KEY 最大密码长度.CNend

EXT_WIFI_MAX_SSID_LEN

#define EXT_WIFI_MAX_SSID_LEN   32

Max length of SSID.CNcomment:SSID最大长度定义.CNend

EXT_WIFI_OK

#define EXT_WIFI_OK   0

return success value.CNcomment:返回成功标识.CNend

EXT_WIFI_RETRY_MAX_NUM

#define EXT_WIFI_RETRY_MAX_NUM   15

Max num of retry.CNcomment:软件重传的最大次数.CNend

EXT_WIFI_RETRY_MAX_TIME

#define EXT_WIFI_RETRY_MAX_TIME   200

Max time of retry.CNcomment:软件重传的最大时间.CNend

EXT_WIFI_STA_PSK_LEN

#define EXT_WIFI_STA_PSK_LEN   32

Length of wpa psk.CNcomment:wpa psk的长度.CNend

EXT_WIFI_TXT_ADDR_LEN

#define EXT_WIFI_TXT_ADDR_LEN   17

String length of bssid, eg. 00:00:00:00:00:00.CNcomment:bssid字符串长度定义(00:00:00:00:00:00).CNend

EXT_WIFI_USR_IE_MAX_SIZE

#define EXT_WIFI_USR_IE_MAX_SIZE   257

max usr ie length.CNcomment:用户IE字段最大长度CNend

EXT_WIFI_VENDOR_IE_MAX_IDX

#define EXT_WIFI_VENDOR_IE_MAX_IDX   1

Index of Vendor IE.CNcomment:Vendor IE 最大索引.CNend

EXT_WIFI_VENDOR_IE_MAX_LEN

#define EXT_WIFI_VENDOR_IE_MAX_LEN   255

Max length of Vendor IE.CNcomment:Vendor IE 最大长度.CNend

MAX_CLINET_SAVE_ADDR_LEN

#define MAX_CLINET_SAVE_ADDR_LEN   48

Total address length of the maximum number of clients.CNcomment:最大数client的地址总长度.CNend

MAX_METHOND_CONFIG_LEN

#define MAX_METHOND_CONFIG_LEN   44

length of methond config.CNcomment:关联方法的长度.CNend

P2P_MAC_LEN

#define P2P_MAC_LEN   6

Length of MAC address.CNcomment:MAC地址长度定义.CNend

P2P_MAX_PERSISTENT_CNT

#define P2P_MAX_PERSISTENT_CNT   10

Max num of persistent group.CNcomment:永久网络最大数量.CNend

P2P_MAX_SSID_LEN

#define P2P_MAX_SSID_LEN   32

Max length of SSID.CNcomment:SSID最大长度定义.CNend

PREFIX_NAME_LEN

#define PREFIX_NAME_LEN   32

Len of Prefix name.CNcomment:网络前缀名称长度.CNend

PSK_LEN

#define PSK_LEN   32

Max length of PSK.CNcomment:PSK长度.CNend

WIFI_24G_CHANNEL_NUMS

#define WIFI_24G_CHANNEL_NUMS   14

Channel numbers of 2.4G frequency.CNcomment:2.4G频段的信道数量.CNend

WIFI_CIPHER_CCMP

#define WIFI_CIPHER_CCMP   bit(4)

CCMP of cipher mode.CNcomment:加密方式为CCMP.CNend

WIFI_CIPHER_TKIP

#define WIFI_CIPHER_TKIP   bit(3)

TKIP of cipher mode.CNcomment:加密方式为TKIP.CNend

WIFI_DEFAULT_MAX_NUM_STA

#define WIFI_DEFAULT_MAX_NUM_STA   8

default max num of station.CNcomment:默认支持的station最大个数.CNend

WIFI_DEFAULT_P2P_MAX_NUM_CLIENT

#define WIFI_DEFAULT_P2P_MAX_NUM_CLIENT   4

Max num of p2p client.CNcomment:p2p默认支持client的最大数量.CNend

WIFI_IFNAME_MAX_SIZE

#define WIFI_IFNAME_MAX_SIZE   16

max interiface name length.CNcomment:网络接口名最大长度.CNend

WIFI_MAX_RECONNECT_PERIOD

#define WIFI_MAX_RECONNECT_PERIOD   65535

The maximum auto reconnect interval.CNcomment:最大自动重连间隔时间.CNend

WIFI_MAX_RECONNECT_TIMEOUT

#define WIFI_MAX_RECONNECT_TIMEOUT   65535

The maximum timeout of a single reconnection, representing an infinite number of loop reconnections. CNcomment:最大单次重连超时时间，表示无限次循环重连.CNend

WIFI_MAX_RECONNECT_TIMES

#define WIFI_MAX_RECONNECT_TIMES   65535

The maximum times of auto reconnect.CNcomment:最大自动重连连接次数.CNend

WIFI_MIN_RECONNECT_PERIOD

#define WIFI_MIN_RECONNECT_PERIOD   1

The minimum auto reconnect interval.CNcomment:最小自动重连间隔时间.CNend

WIFI_MIN_RECONNECT_TIMEOUT

#define WIFI_MIN_RECONNECT_TIMEOUT   2

The minimum timeout of a single reconnection.CNcomment:最小单次重连超时时间.CNend

WIFI_MIN_RECONNECT_TIMES

#define WIFI_MIN_RECONNECT_TIMES   1

The minmum times of auto reconnect.CNcomment:最小自动重连连接次数.CNend

WIFI_SCAN_AP_LIMIT

#define WIFI_SCAN_AP_LIMIT   64

max scan number of ap.CNcomment:支持扫描ap的最多数目.CNend

WIFI_SCAN_CHANNEL_INTERVAL_DEFAULT_ENABLE

#define WIFI_SCAN_CHANNEL_INTERVAL_DEFAULT_ENABLE   (1 << 2)

scan_channel_interval default value enable bit 0B0100.CNcomment:scan_channel_interval默认值使能位0B0100.CNend

WIFI_SCAN_CNT_DEFAULT_ENABLE

#define WIFI_SCAN_CNT_DEFAULT_ENABLE   (1 << 0)

scan_cnt default value enable bit 0B0001.CNcomment:scan_cnt默认值使能位0B0001.CNend

WIFI_SCAN_TIME_DEFAULT_ENABLE

#define WIFI_SCAN_TIME_DEFAULT_ENABLE   (1 << 1)

scan_time default value enable bit 0B0010.CNcomment:scan_time默认值使能位0B0010.CNend

WIFI_SINGLE_PROBE_REQ_SEND_TIMES_DEFAULT_ENABLE

#define WIFI_SINGLE_PROBE_REQ_SEND_TIMES_DEFAULT_ENABLE   (1 << 4)

single_probe_req_send_times default value enable bit 0B10000.CNcomment:probe_req_send_cnt默认值使能位0B10000.CNend

WIFI_STATUS_BUF_LEN_LIMIT

#define WIFI_STATUS_BUF_LEN_LIMIT   512

length of status buff.CNcomment:获取连接状态字符串的长度.CNend

WIFI_WORK_TIME_ON_HOME_CHANNEL_DEFAULT_ENABLE

#define WIFI_WORK_TIME_ON_HOME_CHANNEL_DEFAULT_ENABLE   (1 << 3)

work_time_on_home_channel default value enable bit 0B1000.CNcomment:work_time_on_home_channel默认值使能位0B1000.CNend

WIFI_WPS_PIN_LEN

#define WIFI_WPS_PIN_LEN   8

Decimal only WPS pin code length.CNcomment:WPS中十进制pin码长度.CNend

WPS_DEV_TYPE_LEN

#define WPS_DEV_TYPE_LEN   8

length of device type.CNcomment:device type的长度.CNend

类型定义说明

ext_wifi_scan_no_save_cb

typedef void(* ext_wifi_scan_no_save_cb) (ext_wifi_scan_result_stru *scan_result)

callback function definition of wpa-enterprise param import.CNcommment:定制化扫描回调函数.CNend

uapi_wifi_ent_import_cb

typedef int(* uapi_wifi_ent_import_cb) (unsigned char **buf, unsigned int *len)

callback function definition of wpa-enterprise param import.CNcommment:企业级导入回调接口定义.CNend

uapi_wifi_event_cb

typedef void(* uapi_wifi_event_cb) (const ext_wifi_event *event)

callback function definition of wifi event.CNcommment:wifi事件回调接口定义.CNend

uapi_wifi_report_tx_params_callback

typedef unsigned int(* uapi_wifi_report_tx_params_callback) (ext_wifi_report_tx_params *)

callback function definition of wifi event to get goodput and average send times. CNcommment:wifi获取吞吐量、平均发送次数事件回调接口定义.CNend

wifi_csi_data_cb

typedef void(* wifi_csi_data_cb) (unsigned char *csi_data, int len)

callback function definition of wpa-enterprise param import.CNcommment:CSI调接口定义.CNend

wifi_promis_cb

typedef int32_t(* wifi_promis_cb) (void *recv_buf, int32_t frame_len, int8_t rssi)

callback function definition of monitor mode.CNcommment:混杂模式收包回调接口定义.CNend

wifi_psd_cb

typedef int32_t(* wifi_psd_cb) (void *recv_buf, uint32_t data_len)

callback function definition of psd data report.CNcommment:PSD数据上报回调接口定义.CNend

wifi_rx_mgmt_cb

typedef int32_t(* wifi_rx_mgmt_cb) (void *recv_buf, int32_t frame_len, int8_t rssi)

callback function definition of management frame report.CNcommment:管理帧收包回调接口定义.CNend

枚举类型说明

ext_wifi_auth_mode

enum ext_wifi_auth_mode

Authentification type enum.CNcomment:认证类型(连接网络不支持EXT_WIFI_SECURITY_WPAPSK).CNend

枚举值
EXT_WIFI_SEC_TYPE_INVALID	INVALID. CNcomment: 认证类型:非法值.CNend
EXT_WIFI_SECURITY_OPEN	OPEN. CNcomment: 认证类型:开放.CNend
EXT_WIFI_SECURITY_WEP	WEP. CNcomment: 认证类型:WEP.CNend
EXT_WIFI_SECURITY_WPA2PSK	WPA-PSK. CNcomment: 认证类型:WPA2-PSK.CNend
EXT_WIFI_SECURITY_WPAPSK_WPA2PSK_MIX	WPA/WPA2-PSK MIX. CNcomment: 认证类型:WPA-PSK/WPA2-PSK混合.CNend
EXT_WIFI_SECURITY_WPAPSK	WPA-PSK. CNcomment: 认证类型:WPA-PSK.CNend
EXT_WIFI_SECURITY_WPA	WPA-Enterprise. CNcomment: 认证类型:WPA企业级.CNend
EXT_WIFI_SECURITY_WPA2	WPA2-Enterprise. CNcomment: 认证类型:WPA2企业级.CNend
EXT_WIFI_SECURITY_SAE	SAE. CNcomment: 认证类型:SAE.CNend
EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX	WPA3/WPA2-PSK MIX. CNcomment: 认证类型:WPA3/WPA2-PSK混合.CNend
EXT_WIFI_SECURITY_WPA3	WPA3-Enterprise. CNcomment: 认证类型:WPA3企业级.CNend
EXT_WIFI_SECURITY_OWE	OWE. CNcomment: 认证类型:OWE.CNend
EXT_WIFI_SECURITY_WAPI_PSK	WAPI-PSK. CNcomment: 认证类型:WAPI-PSK.CNend
EXT_WIFI_SECURITY_WAPI_CERT	WAPI-CERT. CNcomment: 认证类型:WAPI企业级.CNend
EXT_WIFI_SECURITY_WPA3_WPA2_MIX	WPA3/WPA2-Enterprise MIX. CNcomment: 认证类型:WPA3/WPA2企业级混合.CNend
EXT_WIFI_SECURITY_WEP_OPEN	WEP-OPEN. CNcomment: 认证类型:WEP-OPEN.CNend
EXT_WIFI_SECURITY_WPA3_192BIT	WPA3-Enterprise 192bit. CNcomment: 认证类型:WPA3企业级192位.CNend
EXT_WIFI_SECURITY_UNKNOWN	UNKNOWN. CNcomment: 其他认证类型:UNKNOWN.CNend

ext_wifi_bw

enum ext_wifi_bw

Definition of bandwith type.CNcomment:接口带宽定义.CNend

枚举值
EXT_WIFI_BW_HIEX_5M	5M bandwidth. CNcomment: 窄带5M带宽.CNend
EXT_WIFI_BW_HIEX_10M	10M bandwidth. CNcomment: 窄带10M带宽.CNend
EXT_WIFI_BW_LEGACY_20M	20M bandwidth. CNcomment: 20M带宽.CNend
EXT_WIFI_BW_BUTT

ext_wifi_cap

enum ext_wifi_cap

Event type of WiFi event.CNcomment:WiFi的事件类型CNend

枚举值
EXT_WIFI_CAP_DISABLE	关闭某项WIFI能力
EXT_WIFI_CAP_ENABLE	使能某项WIFI能力
EXT_WIFI_CAP_BUTT

ext_wifi_conn_status

enum ext_wifi_conn_status

Type of connect's status.CNcomment:连接状态.CNend

枚举值
EXT_WIFI_DISCONNECTED	Disconnected. CNcomment: 连接状态:未连接.CNend
EXT_WIFI_CONNECTED	Connected. CNcomment: 连接状态:已连接.CNend
EXT_WIFI_CONNECTING	Connecting. CNcomment: 连接状态:连接中.CNend

ext_wifi_eap_method

enum ext_wifi_eap_method

eap method.CNcomment: EAP方法.CNend

枚举值
EXT_WIFI_EAP_METHOD_TLS	EAP-TLS. CNcomment: EAP-TLS方法.CNend
EXT_WIFI_EAP_METHOD_BUTT

ext_wifi_event_type

enum ext_wifi_event_type

Event type of WiFi event.CNcomment:WiFi的事件类型.CNend

枚举值
EXT_WIFI_EVT_UNKNOWN	UNKNWON. CNcomment: UNKNOWN.CNend
EXT_WIFI_EVT_SCAN_DONE	Scan finish. CNcomment: STA扫描完成.CNend
EXT_WIFI_EVT_CONNECTED	Connected. CNcomment: 已连接.CNend
EXT_WIFI_EVT_DISCONNECTED	Disconnected. CNcomment: 断开连接.CNend
EXT_WIFI_EVT_WPS_TIMEOUT	WPS timeout. CNcomment: WPS事件超时.CNend
EXT_WIFI_EVT_WPS_SUCCESS	WPS success. CNcomment: WPS事件成功.CNend
EXT_WIFI_EVT_WPS_FAIL	WPS fail. CNcomment: WPS事件失败.CNend
EXT_WIFI_EVT_MESH_CONNECTED	MESH connected. CNcomment: MESH已连接.CNend
EXT_WIFI_EVT_MESH_DISCONNECTED	MESH disconnected. CNcomment: MESH断开连接.CNend
EXT_WIFI_EVT_AP_START	AP start. CNcomment: AP开启.CNend
EXT_WIFI_EVT_AP_DISABLE	AP disable. CNcomment: AP未使能.CNend
EXT_WIFI_EVT_STA_CONNECTED	STA connected with ap. CNcomment: AP和STA已连接.CNend
EXT_WIFI_EVT_STA_DISCONNECTED	STA disconnected from ap. CNcomment: AP和STA断开连接.CNend
EXT_WIFI_EVT_STA_NO_NETWORK	STA or P2P connect, but can't find network CNcomment: STA或P2P连接时扫描不到网络.CNend
EXT_WIFI_EVT_MESH_CANNOT_FOUND	MESH can't find network. CNcomment: MESH关联扫不到对端.CNend
EXT_WIFI_EVT_MESH_SCAN_DONE	MESH AP scan finish. CNcomment: MESH AP扫描完成.CNend
EXT_WIFI_EVT_MESH_STA_SCAN_DONE	MESH STA scan finish. CNcomment: MESH STA扫描完成.CNend
EXT_WIFI_EVT_AP_SCAN_DONE	AP scan finish. CNcomment: AP扫描完成.CNend
EXT_WIFI_EVT_P2P_FIND_STOP	P2P find stop. CNcomment: p2p查找停止.CNend
EXT_WIFI_EVT_P2P_PROV_DISC_PBC_REQ	p2p provision discovery pbc requets. CNcomment: p2p pbc发现请求.CNend
EXT_WIFI_EVT_P2P_PROV_DISC_PBC_RESP	p2p provision discovery pbc response. CNcomment: p2p pbc发现回应.CNend
EXT_WIFI_EVT_P2P_GO_NEG_REQUEST	p2p go neg request. CNcomment: p2p go协商请求.CNend
EXT_WIFI_EVT_P2P_GO_NEG_SUCCESS	p2p go neg success. CNcomment: p2p go协商成功.CNend
EXT_WIFI_EVT_P2P_GO_NEG_FAILURE	p2p go neg failure. CNcomment: p2p go协商失败.CNend
EXT_WIFI_EVT_P2P_GROUP_FORMATION_SUCCESS	p2p group formation success. CNcomment: p2p组网成功.CNend
EXT_WIFI_EVT_P2P_GROUP_FORMATION_FAILURE	p2p group formation failure. CNcomment: p2p组网失败.CNend
EXT_WIFI_EVT_P2P_GROUP_STARTED	p2p group start. CNcomment: p2p组网开始.CNend
EXT_WIFI_EVT_P2P_INVITATION_RECIEVE	p2p invite result. CNcomment: p2p收到邀请事件.CNend
EXT_WIFI_EVT_P2P_INVITATION_RESULT	p2p invite result. CNcomment: p2p邀请结果.CNend
EXT_WIFI_EVT_P2P_INVITATION_ACCEPT	p2p invite result. CNcomment: p2p邀请接收结果.CNend
EXT_WIFI_EVT_BUTT

ext_wifi_extend_ie_index

enum ext_wifi_extend_ie_index

Frame type that usr ies will insert into.CNcomment: 待插入ie字段的帧类型.CNend

枚举值
EXT_WIFI_EXTEND_IE1
EXT_WIFI_EXTEND_IE2
EXT_WIFI_EXTEND_IE3
EXT_WIFI_EXTEND_IE4
EXT_WIFI_EXTEND_IE_BUTT

ext_wifi_iftype

enum ext_wifi_iftype

Interface type of wifi.CNcomment:wifi 接口类型.CNend

枚举值
EXT_WIFI_IFTYPE_UNSPECIFIED
EXT_WIFI_IFTYPE_ADHOC
EXT_WIFI_IFTYPE_STATION	Station. CNcomment: STA类型.CNend
EXT_WIFI_IFTYPE_AP	SoftAp. CNcomment: SoftAp类型.CNend
EXT_WIFI_IFTYPE_AP_VLAN
EXT_WIFI_IFTYPE_WDS
EXT_WIFI_IFTYPE_MONITOR
EXT_WIFI_IFTYPE_MESH_POINT	Mesh. CNcomment: Mesh类型.CNend
EXT_WIFI_IFTYPE_P2P_CLIENT
EXT_WIFI_IFTYPE_P2P_GO
EXT_WIFI_IFTYPE_P2P_DEVICE
EXT_WIFI_IFTYPES_BUTT

ext_wifi_monitor_mode

enum ext_wifi_monitor_mode

Reporting data type of monitor mode.CNcomment:混杂模式上报的数据类型.CNend

枚举值
EXT_WIFI_MONITOR_OFF	close monitor mode. CNcomment: 关闭混杂模式.CNend
EXT_WIFI_MONITOR_MCAST_DATA	report multi-cast data frame. CNcomment: 上报组播(广播)数据包.CNend
EXT_WIFI_MONITOR_UCAST_DATA	report single-cast data frame. CNcomment: 上报单播数据包.CNend
EXT_WIFI_MONITOR_MCAST_MANAGEMENT	report multi-cast mgmt frame. CNcomment: 上报组播(广播)管理包.CNend
EXT_WIFI_MONITOR_UCAST_MANAGEMENT	report sigle-cast mgmt frame. CNcomment: 上报单播管理包.CNend
EXT_WIFI_MONITOR_BUTT

ext_wifi_pairwise

enum ext_wifi_pairwise

Encryption type enum.CNcoment:加密类型.CNend

枚举值
EXT_WIFI_PARIWISE_UNKNOWN	UNKNOWN. CNcomment: 加密类型:UNKNOWN.CNend
EXT_WIFI_PAIRWISE_AES	AES. CNcomment: 加密类型:AES.CNend
EXT_WIFI_PAIRWISE_TKIP	TKIP. CNcomment: 加密类型:TKIP.CNend
EXT_WIFI_PAIRWISE_TKIP_AES_MIX	TKIP/AES MIX. CNcomment: 加密类型:TKIP AES混合.CNend
EXT_WIFI_PAIRWISE_CCMP256	CCMP-256. CNcomment: 加密类型:CCMP-256.CNend
EXT_WIFI_PAIRWISE_CCMP256_CCMP	CCMP-256/CCMP. CNcomment: 加密类型:CCMP-256 CCMP.CNend
EXT_WIFI_PAIRWISE_CCMP256_TKIP	CCMP-256/TKIP. CNcomment: 加密类型:CCMP-256 TKIP.CNend
EXT_WIFI_PAIRWISE_BUTT

ext_wifi_pkt_type

enum ext_wifi_pkt_type

Definition of protocol frame type.CNcomment:协议报文类型定义.CNend

枚举值
EXT_WIFI_PKT_TYPE_BEACON	Beacon packet. CNcomment: Beacon包.CNend
EXT_WIFI_PKT_TYPE_PROBE_REQ	Probe Request packet. CNcomment: Probe Request包.CNend
EXT_WIFI_PKT_TYPE_PROBE_RESP	Probe Response packet. CNcomment: Probe Response包.CNend
EXT_WIFI_PKT_TYPE_ASSOC_REQ	Assoc Request packet. CNcomment: Assoc Request包.CNend
EXT_WIFI_PKT_TYPE_ASSOC_RESP	Assoc Response packet. CNcomment: Assoc Response包.CNend
EXT_WIFI_PKT_TYPE_BUTT

ext_wifi_retry_frame_type

enum ext_wifi_retry_frame_type

Scan type enum.CNcomment:重传报文类型.CNend

枚举值
EXT_WIFI_RETRY_FRAME_DATA	data frame retrans. CNcomment: 重传数据帧.CNend
EXT_WIFI_RETRY_FRAME_MGMT	mgmt frame retrans. CNcomment: 重传管理帧.CNend
EXT_WIFI_RETRY_FRAME_BUTT

ext_wifi_scan_type

enum ext_wifi_scan_type

Scan type enum.CNcomment:扫描类型.CNend

枚举值
EXT_WIFI_BASIC_SCAN	Common and all channel scan. CNcomment: 普通扫描.CNend
EXT_WIFI_CHANNEL_SCAN	Specified channel scan. CNcomment: 指定信道扫描.CNend
EXT_WIFI_SSID_SCAN	Specified SSID scan. CNcomment: 指定SSID扫描.CNend
EXT_WIFI_SSID_PREFIX_SCAN	Prefix SSID scan. CNcomment: SSID前缀扫描.CNend
EXT_WIFI_BSSID_SCAN	Specified BSSID scan. CNcomment: 指定BSSID扫描.CNend

ext_wifi_wpa_psk_usage_type

enum ext_wifi_wpa_psk_usage_type

WPA PSK usage type.CNcomment: WPA PSK使用策略.CNend

枚举值
EXT_WIFI_WPA_PSK_NOT_USE	Not use. CNcomment: 不使用.CNend
EXT_WIFI_WPA_PSK_USE_INNER	Inner PSK. CNcomment: 使用内部PSK.CNend
EXT_WIFI_WPA_PSK_USE_OUTER	Outer PSK. CNcomment: 使用外部PSK.CNend

ext_wifi_xldo_voltage

enum ext_wifi_xldo_voltage

XLDO voltage.CNcomment: XLDO控制电压.CNend

枚举值
EXT_WIFI_XLDO_VOLTAGE_0	1.5V. CNcomment: 1.5V.CNend
EXT_WIFI_XLDO_VOLTAGE_1	1.8V. CNcomment: 1.8V.CNend
EXT_WIFI_XLDO_VOLTAGE_2	2.1V. CNcomment: 2.1V.CNend
EXT_WIFI_XLDO_VOLTAGE_3	2.4V. CNcomment: 2.4V.CNend

wifi_sae_pwe_option_enum

enum wifi_sae_pwe_option_enum

sae_pwe type enum.CNcomment:SAE PWE 生成类型.CNend

枚举值
WIFI_SAE_PWE_UNSPECIFIED	UNSPECIFIED
WIFI_SAE_PWE_HUNT_AND_PECK	hunting-and-pecking loop only.
WIFI_SAE_PWE_HASH_TO_ELEMENT	hash-to-element only
WIFI_SAE_PWE_BOTH	<both hunting-and-pecking loop and hash-to-element enabled

函数说明

uapi_alg_ar_fix_cfg_etc()

osal_u32 uapi_alg_ar_fix_cfg_etc

(

osal_u32

value

)

Set wpa-enterprise read callback.CNcomment:autorate配置速率模式函数接口.CNend

Description:

Set wpa-enterprise read callback.CNcomment:autorate配置速率模式函数接口.CNend

注意

NULL

参数

value

[IN] Type #unsigned int, switch value.CNcomment:autorate配置速率模式函数接口.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_csi_register_data_report_cb()

void uapi_csi_register_data_report_cb

(

wifi_csi_data_cb

data_cb

)

function definition of wifi event.CNcommment:CSI注册回调函数接口定义.CNend

uapi_set_low_current_boot_mode()

td_s32 uapi_set_low_current_boot_mode

(

td_u16

flag

)

function definition of wifi event.CNcommment:设置低功耗函数接口定义.CNend

uapi_wifi_add_usr_app_ie()

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
	)

Add user IEs to management frame.CNcomment:在管理帧中添加用户IE字段。CNend

Description:

Add user IEs to management frame.CNcomment:在管理帧中添加用户IE字段。CNend

注意

1.Input ie_len must be the same as the len of ie.CNcomment:1.输入的ie_len的长度必须和ie的长度保持一致.CNend

参数

iftype

[IN] Type ext_wifi_iftype, interface type. CNcomment:接口类型。CNend ie_index [IN] Type ext_wifi_extend_ie_index, Ie index, there are four indexes to choose。 CNcomment:ie索引,有四个索引可供选择。CNend frame_type_bitmap [IN] Type #const unsigned char, frame type bitmap,bit0 is beacon,bit1 is probe request, bit2 is probe response. CNcomment:帧类型，bit0代表beacon,bit1代表probe request,bit2代表probe response。CNend ie [IN] Type #const unsigned char *, user IE value.CNcomment:用户IE字段内容。CNend ie_len [IN] Type #unsigned short, user IE length.CNcomment:用户IE字段内容长度。CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_ap_get_sta_info()

td_s32 uapi_wifi_ap_get_sta_info	(	td_char *	mac_addr,
		td_s8 *	rssi,
		td_u32 *	best_rate
	)

Get info of sta which ap connected to.CNcomment:获取ap连接的sta信息.CNend

Description:

Get current rssi and rate of ap sta which ap connected to.CNcomment:获取ap当前关联的sta的rssi和rate值.CNend

注意

NULL

参数

mac_addr	[IN] Type #char, mac address of connected sta. CNcomment:ap连接的sta的mac地址.CNend
rssi	[OUT] Type #signed char, signal strength of last packet. CNcomment: ap上一次接收相连的station报文的rssi.CNend
best_rate	[OUT] Type #unsigned int, best sending rate. CNcomment: ap与相连的station报文的最佳发送速率.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_ap_scan()

int uapi_wifi_ap_scan

(

void

)

function definition of wifi event.CNcommment:AP扫描接口定义.CNend

uapi_wifi_arp_offload_setting()

unsigned char uapi_wifi_arp_offload_setting	(	const char *	ifname,
		unsigned char	en,
		unsigned int	ip
	)

Set arp offload on/off.CNcomment:设置arp offload 打开/关闭.CNend

Description:

Set arp offload on with ip address, or set arp offload off. CNcomment:设置arp offload打开、并且设置相应ip地址，或者设置arp offload关闭.CNend

注意

NULL

参数

ifname	[IN] Type #const char *, device name.
en	[IN] Type #unsigned char, arp offload type, 1-on, 0-off.
ip	[IN] Type #unsigned int, ip address in network byte order, eg:192.168.50.4 -> 0x0432A8C0.

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_config_callback()

int uapi_wifi_config_callback	(	unsigned char	mode,
		unsigned char	task_prio,
		unsigned short	stack_size
	)

config calling mode of user's callback interface.CNcomment:配置用户回调接口的调用方式.CNend

Description:

config calling mode of user's callback interface.CNcomment:配置用户回调接口的调用方式.CNend

注意

1. Wpa's task has high priority and call wifi's api directly may be cause error. CNcomment:1. wpa线程优先级高,直接调用方式下在该回调接口内再次调用某些api会导致线程卡死.CNend

1. If you have create a task in your app, you should use mode:0, or mode:1 is adervised. CNcomment:2. 上层应用已创建task来处理事件回调建议使用直接调用方式,否则建议使用线程调用方式.CNend
2. Configuration will keep till system reboot, set again when you start a new station. CNcomment:3. 参数会保持上一次设置值直到系统重启,重新启动station后建议再配置一次.CNend
3. Configuration will work immediately whenever you set. CNcomment:4. 可随时配置该参数,配置成功即生效.CNend

参数

mode	[IN] Type #unsigned char , call mode, 1:direct and 0:create task[default]. CNcomment:回调调用方式,1:wpa线程直接调用,0:新建一个低优先级线程调用,默认.CNend
task_prio	[IN] Type #unsigned char , task priority, range(10-50) . CNcomment:新建线程优先级,取值范围(10-50).CNend
stack_size	[IN] Type #unsigned short , task stack size, more than 1K bytes, default: 2k. CNcomment:新建线程栈空间,需大于宏LOS_TASK_MIN_STACK_SIZE的大小,默认2k.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_csi_set_config()

int uapi_wifi_csi_set_config	(	const char *	ifname,
		const ext_csi_config *	config
	)

function definition of wifi event.CNcommment:设置CSI配置函数接口定义.CNend

uapi_wifi_csi_start()

int uapi_wifi_csi_start

(

void

)

function definition of wifi event.CNcommment:CSI启动函数接口定义.CNend

uapi_wifi_csi_stop()

int uapi_wifi_csi_stop

(

void

)

function definition of wifi event.CNcommment:CSI关闭函数接口定义.CNend

uapi_wifi_deinit()

int uapi_wifi_deinit

(

void

)

Wifi de-initialize.CNcomment:wifi去初始化.CNend

Description:

Wifi driver de-initialize.CNcomment:wifi驱动去初始化.CNend

注意

NULL

参数

NULL

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_delete_usr_app_ie()

int uapi_wifi_delete_usr_app_ie	(	ext_wifi_iftype	iftype,
		ext_wifi_extend_ie_index	ie_index,
		const unsigned char	frame_type_bitmap
	)

Delete user IEs from management frame.CNcomment:在管理帧中删除用户IE字段。CNend

Description:

Delete user IEs from management frame.CNcomment:在管理帧中删除用户IE字段。CNend

注意

NULL

参数

iftype

[IN] Type ext_wifi_iftype, interface type. CNcomment:接口类型。CNend ie_index [IN] Type ext_wifi_extend_ie_index, Ie index, there are four indexes to choose。 CNcomment:ie索引,有四个索引可供选择。CNend frame_type_bitmap [IN] Type #const unsigned char, frame type bitmap,bit0 is beacon,bit1 is probe request, bit2 is probe response. CNcomment:帧类型，bit0代表beacon,bit1代表probe request,bit2代表probe response。CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_enable_intrf_mode()

td_u32 uapi_wifi_enable_intrf_mode	(	const td_char *	ifname,
		td_u8	enable,
		td_u16	flag
	)

function definition of wifi event.CNcommment:设置算法抗干扰函数接口定义.CNend

uapi_wifi_force_scan_complete()

unsigned int uapi_wifi_force_scan_complete

(

void

)

function definition of wifi event.CNcommment:扫描完成接口定义.CNend

uapi_wifi_get_bandwidth()

ext_wifi_bw uapi_wifi_get_bandwidth	(	const td_char *	ifname,
		td_u8	ifname_len
	)

Get bandwidth.CNcomment:获取带宽.CNend

Description:

Get bandwidth.CNcomment:获取带宽.CNend

注意

NULL

参数

ifname	[IN] Type #const char *, interface name.CNcomment:接口名.CNend
ifname_len	[IN] Type #unsigned char, interface name length.CNcomment:接口名长度.CNend

返回值

#bandwidth

enum.CNcomment:带宽的枚举值.CNend

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_get_channel()

td_s32 uapi_wifi_get_channel	(	const td_char *	ifname,
		td_u8	ifname_len
	)

Get channel.CNcomment:获取信道.CNend

Description:

Get channel.CNcomment:获取信道.CNend

注意

NULL

参数

ifname	[IN] Type #const char *, interface name.CNcomment:接口名.CNend
ifname_len	[IN] Type #unsigned char, interface name length.CNcomment:接口名长度.CNend

返回值

EXT_WIFI_INVALID_CHANNEL
#Other	chanel value.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_get_country()

td_s32 uapi_wifi_get_country	(	td_char *	cc,
		td_u8 *	len
	)

Get country code.CNcomment:获取国家码.CNend

Description:

Get country code.CNcomment:获取国家码，由两个大写字符组成.CNend

注意

1.Before getting the country code, you must call uapi_wifi_init to complete the initialization. CNcomment:获取国家码之前，必须调用uapi_wifi_init初始化完成.CNend

参数

cc	[OUT] Type #char *, country code.CNcomment:国家码.CNend
len	[IN/OUT] Type #int *, country code length.CNcomment:国家码长度.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_get_init_status()

unsigned char uapi_wifi_get_init_status

(

void

)

Get wifi initialize status.CNcomment:获取wifi初始化状态.CNend

Description:

Get wifi initialize status.CNcomment:获取wifi初始化状态.CNend

注意

NULL

参数

NULL

返回值

#1	Wifi is initialized.CNcoment:Wifi已经初始化.CNend
#0	Wifi is not initialized.CNcoment:Wifi没有初始化.CNend

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_get_mac_status_code()

short uapi_wifi_get_mac_status_code

(

void

)

Get Status Codes for Authentication and Association Frames. CNcomment:查询Authentication与Association帧status code.CNend

Description:

Get Status Codes for Authentication and Association Frames. CNcomment:查询Authentication与Association帧status code.CNend

注意

1.the return value is Status Codes for Authentication and Association Frames in 802.11. 2.used when STA connect AP fail. 3.the -1 return value means no status code, then if you want to get the reason of connect fail, use event_wifi_disconnected.reason_code. CNcomment: 1.返回值为802.11协议中Authentication reponse与Association reponse帧的status code 2.网卡类型为STA时使用，在STA发起路由器连接并失败时调用 3.如果返回值为-1，表示无status code信息，此时获取连接失败的原因请使用event_wifi_disconnected结构体中的 reason_code值.CNend

参数

NULL

返回值

#Status

Codes value

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_get_scan_flag()

int uapi_wifi_get_scan_flag

(

void

)

function definition of wifi event.CNcommment:获取扫描状态接口定义.CNend

uapi_wifi_get_tx_params()

td_s32 uapi_wifi_get_tx_params	(	const td_char *	mac_addr,
		td_u8	mac_len,
		td_u32 *	tx_best_rate
	)

function definition of wifi event.CNcommment:获取发送参数函数接口定义.CNend

uapi_wifi_get_txpower_up_limit()

td_s32 uapi_wifi_get_txpower_up_limit

(

const td_char *

ifname

)

Get tx power.CNcomment:获取发送功率上限.CNend

Description:

Get maximum tx power setting.CNcomment:获取接口的最大发送功率限制值.CNend

注意

NULL

参数

ifname

[IN] Type #const char * interface name.

返回值

#tx	power value.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_init()

td_s32 uapi_wifi_init	(	const td_u8	vap_res_num,
		const td_u8	user_res_num
	)

Wifi initialize.CNcomment:wifi初始化.CNend

Description:

Wifi driver initialize.CNcomment:wifi驱动初始化，不创建wifi设备.CNend

注意

NULL

参数

vap_res_num	[IN] Type #const unsigned char, vap num[rang: 1-3].CNcomment:vap资源个数，取值[1-3].CNend
user_res_num	[IN] Type #const unsigned char, user resource num[1-7]. CNcomment:用户资源个数，多vap时共享，取值[1-7].CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_mac_phy_reset()

int uapi_wifi_mac_phy_reset

(

void

)

function definition of wifi event.CNcommment:mac_phy重置函数接口定义.CNend

uapi_wifi_nd_offload_setting()

unsigned int uapi_wifi_nd_offload_setting	(	const char *	ifname,
		unsigned char	en,
		unsigned char *	ip6
	)

Set nd offload on/off.CNcomment:设置nd offload 打开/关闭.CNend

Description:

Set nd offload on with ipv6 address, or set nd offload off. CNcomment:设置nd offload打开、设置正确的解析后的ipv6地址，或设置nd offload关闭.CNend

注意

NULL

参数

ifname	[IN] Type #const char *, device name.
en	[IN] Type #unsigned char, nd offload type, 1-on, 0-off.
ip6	[IN] Type #unsigned char *, ipv6 address after parsing. eg:FE80::F011:31FF:FEE8:DB6E -> 0xfe80000000f01131fffee8db6e

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_promis_enable()

osal_s32 uapi_wifi_promis_enable	(	const osal_char *	ifname,
		osal_s32	enable,
		const ext_wifi_ptype_filter_stru *	filter
	)

Set monitor mode.CNcomment:设置混杂模式.CNend

Description:

Enable/disable monitor mode of interface.CNcomment:设置指定接口的混杂模式使能.CNend

注意

NULL

参数

ifname	[IN] Type #const char * interface name.CNcomment:接口名.CNend
enable	[IN] Type #int enable(1) or disable(0).CNcomment:开启/关闭.CNend
filter	[IN] Type #const wifi_ptype_filter_stru * filtered frame type enum.CNcomment:过滤列表.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_promis_set_rx_callback()

int uapi_wifi_promis_set_rx_callback

(

wifi_promis_cb

data_cb

)

Register receive callback in monitor mode.CNcomment:注册混杂模式的收包回调函数.CNend

Description:

1.Register receive callback in monitor mode.CNcomment:1.注册混杂模式的收包回调函数.CNend
2.Wifi driver will put the receive frames to this callback. CNcomment:2.驱动将混杂模式的收到的报文递交到注册的回调函数处理.CNend

注意

NULL

参数

data_cb

[IN] Type wifi_promis_cb callback function pointer.CNcomment:混杂模式回调函数.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_psk_calc()

int uapi_wifi_psk_calc	(	ext_wifi_sta_psk_config	psk_config,
		unsigned char *	get_psk,
		unsigned int	psk_len
	)

WPA PSK Calculate.CNcomment:计算WPA PSK.CNend

Description:

PSK Calculate.CNcomment:计算psk.CNend

注意

1. support only WPA/WPA2 PSK. CNcomment:1. 只支持WPA/WPA2 PSK计算.CNend

1. SSID only supports ASCII characters. CNcomment:2. SSID 只支持ASCII字符.CNend

参数

psk_config	[IN] Type ext_wifi_sta_psk_config
get_psk	[IN/OUT] Type #unsigned char *，Psk to be obtained, length is 32 Bytes. The memory is requested by the caller. CNcomment:待获取psk,长度为32 Bytes。由调用者申请内存.CNend
psk_len	[IN] Type #unsigned int

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_psk_calc_and_store()

int uapi_wifi_psk_calc_and_store

(

ext_wifi_sta_psk_config

psk_config

)

WPA PSK Calculate，then keep it inside .CNcomment:计算WPA PSK, 并做内部保存.CNend

Description:

psk Calculate.CNcomment:计算psk.CNend

注意

1. support only WPA/WPA2 PSK. CNcomment:1. 只支持WPA/WPA2 PSK计算.CNend

1. SSID only supports ASCII characters. CNcomment:2. SSID 只支持ASCII字符.CNend
   
2. The cached PSK will be cleared after the first quick connection.
   CNcomment:3. PSK缓存将在第一次执行快速连接后清除.CNend

参数

psk_config

[IN] Type ext_wifi_sta_psk_config

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_register_event_callback()

int uapi_wifi_register_event_callback

(

uapi_wifi_event_cb

event_cb

)

register user callback interface.CNcomment:注册回调函数接口.CNend

Description:

register user callback interface.CNcomment:注册回调函数接口.CNend

注意

NULL

参数

event_cb

[OUT] Type uapi_wifi_event_cb, event callback .CNcomment:回调函数.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_scan_results_clear()

unsigned int uapi_wifi_scan_results_clear

(

void

)

function definition of wifi event.CNcommment:删除驱动扫描链表接口定义.CNend

uapi_wifi_sdp_enable()

int uapi_wifi_sdp_enable	(	const osal_char *	ifname,
		osal_s32	enable,
		osal_s32	ratio
	)

Set wifi aware enable.CNcomment:设置wifi aware使能.CNend

Description:

Enable/disable wifi aware of interface.CNcomment:设置指定接口的wifi aware使能.CNend

注意

NULL

参数

ifname	[IN] Type #const char * interface name.CNcomment:接口名.CNend
enable	[IN] Type #int enable(1) or disable(2).CNcomment:开启/关闭.CNend
ratio	[IN] Type #int ratio(1-9) channel switching percentage.CNcomment:信道切换百分比.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sdp_subscribe()

int uapi_wifi_sdp_subscribe	(	const osal_char *	ifname,
		osal_char *	sdp_subscribe,
		osal_s32	local_handle
	)

Set wifi aware subscribe.CNcomment:设置wifi aware订阅.CNend

Description:

Enable/disable wifi aware subscribe of interface.CNcomment:设置指定接口的wifi aware订阅.CNend

注意

NULL

参数

ifname	[IN] Type #const char * interface name.CNcomment:接口名.CNend
sdp_subscribe	[IN] Type #char * Subscription Service Account.CNcomment:订阅服务号.CNend
local_handle	[IN] Type #int local_handle local service number.CNcomment:本机服务号.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_send_custom_pkt()

int uapi_wifi_send_custom_pkt	(	const char *	ifname,
		const unsigned char *	data,
		unsigned int	len
	)

Send a custom frame.CNcomment:发送用户定制报文.CNend

Description:

Send a custom frame.CNcomment:发送用户定制报文.CNend

注意

1.Maximum length is 1400 bytes.CNcomment:1.最大支持发送1400字节的报文.CNend
2.Require to 802.11 prcotocol.CNcomment:2.报文须按照802.11协议格式封装.CNend
3.Send by management rate.CNcomment:3.采用管理帧速率发送,发送长包效率较低.CNend
4.Return status only specify the data has injected to send queue, isn't real send status. CNcomment:4.返回值仅表示数据是否成功进入发送队列,不表示空口发送状态.CNend
5.The chip is in a low-power state and does not support sending. CNcomment:5.芯片工作在低功耗状态下,不能调用该接口发送报文.CNend

参数

ifname	[IN] Type #const char *, device name. CNcomment:接口名.CNend
data	[IN] Type #const unsigned char *, frame. CNcomment:帧内容.CNend
len	[IN] Type #unsigned int, frame length. CNcomment:帧长度.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_send_pkt()

int uapi_wifi_send_pkt	(	osal_void *	dev,
		const data_segment_t *	seg,
		uint8_t	seg_len
	)

获取数据发包.CNcomment:配置发包接口.CNend

Description:

Send data packet.CNcomment:配置发包接口.CNend

注意

NULL

参数

data_segment_t

[IN] Type #eth_data seg_len [IN] Type #length

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_bandwidth()

td_s32 uapi_wifi_set_bandwidth	(	const td_char *	ifname,
		td_u8	ifname_len,
		ext_wifi_bw	bw
	)

Set bandwidth.CNcomment:设置带宽.CNend

Description:

Set bandwidth, support 5M/10M/20M.CNcomment:设置接口的工作带宽，支持5M 10M 20M带宽的设置.CNend

注意

NULL

参数

ifname	[IN] Type #const char *, interface name.CNcomment:接口名.CNend
ifname_len	[IN] Type #unsigned char, interface name length.CNcomment:接口名长度.CNend
bw	[IN] Type ext_wifi_bw, bandwidth enum.CNcomment:带宽.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_brctl()

int uapi_wifi_set_brctl	(	const char *	oper,
		const char *	if_name
	)

配置Repeater开关及接口.CNcomment:配置Repeater开关及接口.CNend

Description:

Set Repeater switch and interface.CNcomment:配置Repeater开关及接口.CNend

注意

NULL

参数

oper	[IN] Type #const char *, identity string.CNcomment:配置操作.CNend if_name [IN] Type #const char *, identity string.CNcomment:接口名.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_cca_threshold()

td_u32 uapi_wifi_set_cca_threshold	(	td_u8	mode,
		td_s8	threshold
	)

Set cca threshold.CNcomment:设置CCA门限.CNend

Description:

Set cca threshold.CNcomment:设置CCA门限.CNend

注意

CNcomment:1.threshold设置范围是-128~126时，阈值固定为设置值.CNend
CNcomment:2.threshold设置值为127时，恢复默认阈值-62dBm，并使能动态调整.CNend

参数

ifname	[IN] Type #const char *, device name. CNcomment:接口名.CNend
threshold	[IN] Type #char, threshold. CNcomment:门限值.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_channel()

td_s32 uapi_wifi_set_channel	(	const td_char *	ifname,
		td_u8	ifname_len,
		td_s32	channel
	)

Set channel.CNcomment:设置信道.CNend

Description:

Set channel.CNcomment:设置信道.CNend

注意

NULL

参数

ifname	[IN] Type #const char *, interface name.CNcomment:接口名.CNend
ifname_len	[IN] Type #unsigned char, interface name length.CNcomment:接口名长度.CNend
channel	[IN] Type #int , listen channel.CNcomment:信道号.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_country()

td_s32 uapi_wifi_set_country	(	const td_char *	cc,
		td_u8	cc_len
	)

Set country code.CNcomment:设置国家码.CNend

Description:

Set country code(two uppercases).CNcomment:设置国家码，由两个大写字符组成.CNend

注意

1.Before setting the country code, you must call uapi_wifi_init to complete the initialization. CNcomment:设置国家码之前，必须调用uapi_wifi_init初始化完成.CNend
2.cc_len should be greater than or equal to 3.CNcomment:cc_len应大于等于3.CNend

参数

cc	[IN] Type #const char *, country code.CNcomment:国家码.CNend
cc_len	[IN] Type #unsigned char, country code length.CNcomment:国家码长度.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_evm_para()

td_u32 uapi_wifi_set_evm_para	(	td_u8	pa_bias,
		const ext_wifi_xldo_voltage *	osc_drv_vals,
		td_u8	size
	)

Set evm para.CNcomment:设置evm参数.CNend

Description:

Set evm para.CNcomment:设置evm参数.CNend

注意

1.Should be called before uapi_wifi_init(). CNcomment:只能在uapi_wifi_init()函数前调用.CNend

参数

pa_bias	[IN] Type #unsigned char, PA bias setting.0:0xfe83,default value.1:0xfcc3.Others:invalid. CNcomment:PA偏置,0:0xfe83,默认值;1:0xfcc3;其它值:不支持.CNend
osc_drv_vals	[IN] Type ext_wifi_xldo_voltage *, OSC driver values ch1~14. CNcomment:信道1~14的OSC驱动强度值.CNend
size	[IN] Type #unsigned char, OSC driver values' size.Should be 14. CNcomment:OSC驱动强度值数组大小,只能为14.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_mgmt_report()

int uapi_wifi_set_mgmt_report	(	wifi_rx_mgmt_cb	data_cb,
		uint8_t	mode
	)

Register receive callback for management frame.CNcomment:注册管理帧收包回调函数.CNend

Description:

1.Register receive callback for management frame.CNcomment:1.注册管理帧收包回调函数.CNend
2.Wifi driver will put the management frames received to this callback,except for beacon frame. CNcomment:2.驱动将收到的管理帧报文递交到注册的回调函数处理，收到的beacon帧不会递交到该回调函数.CNend 3.The buffer of the frame reacived will be alloc and free by the wifi driver. CNcomment:3.报文的buffer内存由驱动申请和释放，回调函数中不应释放，回调函数运行于驱动任务，不应在回调函数中执行耗时操作.CNend

注意

1.need to invoke uapi_wifi_set_mgmt_report(NULL) before enable low power mode. CNcomment:开启低功耗睡眠之前需要调用uapi_wifi_set_mgmt_report(NULL)关闭管理帧上报，不然会引起功耗偏高。

参数

data_cb	[IN] Type wifi_rx_mgmt_cb callback function pointer.CNcomment:管理帧上报回调函数.CNend
mode	[IN] Mode of receiving management frame:上报管理帧模式.CNend

返回值

#EXT_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_phy_txrate()

uint32_t uapi_wifi_set_phy_txrate	(	td_u8	auto_rate,
		ext_alg_param_stru *	alg_param
	)

function definition of wifi event.CNcommment:设置phy发送速率函数接口定义.CNend

uapi_wifi_set_pkt_retry_policy()

td_s32 uapi_wifi_set_pkt_retry_policy	(	td_u8	frame_type,
		td_u8	retry_count
	)

function definition of wifi event.CNcommment:设置报文重传函数接口定义.CNend

uapi_wifi_set_pm_switch()

td_s32 uapi_wifi_set_pm_switch	(	td_u8	enable,
		td_u32	sleep_time
	)

Open/close system power save.CNcomment:开启/关闭WiFi低功耗模式并配置预期休眠时间.CNend

Description:

Open/close system power save.CNcomment:开启/关闭WiFi低功耗模式并配置预期休眠时间.CNend

注意

NULL

参数

enable	[IN] Type #unsigned char, enable(1) or disable(0).CNcomment:开启/关闭WiFi低功耗.CNend
sleep_time	[IN] Type #unsigned int, expected sleep time(uint: ms). CNcomment:预期休眠时间(单位: 毫秒), 参考有效范围33ms~4000ms, 准确的时间根据dtim*beacon和sleep_time值计算, 关闭低功耗或者不配置有效休眠时间时需要将sleep_time配置为0(休眠时间由关联的ap决定).CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_pmf()

int uapi_wifi_set_pmf

(

wifi_pmf_option_enum

pmf

)

Config pmf settings of sta.CNcomment:配置station的pmf.CNend

Description:

Config pmf settings of sta, set before sta start.CNcomment:配置station的pmf, 在sta start之前调用.CNend

注意

Default pmf enum value 1. CNcomment:默认pmf枚举值1.CNend

参数

pmf	[IN] Type wifi_pmf_option_enum, pmf enum value.CNcoment:pmf枚举值.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_psd_cb()

int uapi_wifi_set_psd_cb

(

wifi_psd_cb

data_cb

)

Set psd callback.CNcomment:配置PSD回调.CNend

Description:

Set psd callback.CNcomment:配置PSD回调.CNend

注意

NULL

参数

data_cb

[IN] Type wifi_psd_cb CNcomment:配置PSD回调.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_psd_enable()

int uapi_wifi_set_psd_enable

(

psd_option_param *

psd_option

)

Set psd enable mode.CNcomment:配置PSD状态函数接口.CNend

Description:

Set psd enable mode.CNcomment:配置PSD状态函数接口.CNend

注意

NULL

参数

psd_option

[IN] Type ext_psd_option_param CNcomment:配置PSD状态函数接口.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_retry_params()

td_u32 uapi_wifi_set_retry_params	(	const td_char *	ifname,
		td_u8	type,
		td_u8	limit
	)

Set retry params.CNcomment:设置软件重传策略.CNend

Description:

Set retry params.CNcomment:设置指定接口的软件重传策略.CNend

注意

1.Need call befora start sta or softap.CNcomment:1.本API需要在STA或AP start之后调用.CNend

参数

ifname	[IN] Type #const char * interface name.CNcomment:接口名.CNend
type	[IN] Type #unsigned char retry type. CNcomment:0:次数重传（数据帧）; 1:次数重传（管理帧）; 2:时间重传.CNend
limit	[IN] Type #unsigned char limit value. CNcomment:重传次数(0~15次)/重传时间(0~200个时间粒度,时间粒度10ms).CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_rts_threshold()

td_u32 uapi_wifi_set_rts_threshold	(	td_u8	mode,
		td_u16	pkt_length
	)

function definition of wifi event.CNcommment:设置RTS阈值函数接口定义.CNend

uapi_wifi_set_scan_param()

int uapi_wifi_set_scan_param	(	const td_char *	ifname,
		ext_wifi_scan_param_stru *	scan_param
	)

Set scan.param.CNcomment:设置扫描参数.CNend

Description:

Set scan_param, support the largest scan_cnt is 10, support the largest scan_time is 120, support the largest scan_channel_interval is 6, support the largest work_time_on_home_channel is 120. CNcomment:设置扫描参数，支持最大扫描次数为10，支持最长驻留时间为120, 支持最多间隔6信道返回工作信道工作，支持背景扫描时，返回工作信道工作的最长时间为120.CNend

注意

1.Set scan_param before starting the scan. CNcomment:扫描参数需在扫描之前设置. 2.Restart can restore default scan_param. CNcomment:关闭STA/AP命令再启动STA/AP可以恢复默认值. 3.Valid default_enable:0B0000~0B1111. WIFI_SCAN_CNT_DEFAULT_ENABLE: enable scan_cnt default. WIFI_SCAN_TIME_DEFAULT_ENABLE: enable scan_time default. WIFI_SCAN_CHANNEL_INTERVAL_DEFAULT_ENABLE: enable scan_channel_interval default. WIFI_WORK_TIME_ON_HOME_CHANNEL_DEFAULT_ENABLE: enable work_time_on_home_channel default. CNcomment:表示使用默认值使能. WIFI_SCAN_CNT_DEFAULT_ENABLE: 表示使能scan_cnt的默认值. WIFI_SCAN_TIME_DEFAULT_ENABLE: 表示使能scan_time的默认值. WIFI_SCAN_CHANNEL_INTERVAL_DEFAULT_ENABLE: 表示使能scan_channel_interval的默认值. WIFI_WORK_TIME_ON_HOME_CHANNEL_DEFAULT_ENABLE: 表示使能work_time_on_home_channel的默认值. 4.Valid scan_cnt:0,1~10. Default scan_cnt is 2. 0 indicates default value. CNcomment:有效扫描次数为1~10.默认扫描次数为2，0表示默认值. 5.Valid scan_time:0,20~120. Default scan_time is 20. 0 indicates default value. CNcomment:有效驻留时间为20~120.默认扫描驻留时间为20，0表示默认值. 6.Valid scan_channel_interval:0,1~6. Default scan_channel_interval is 6.0 indicates default value. CNcomment:设置间隔n个信道返回工作信道工作一段时间，有效范围为1~6，默认为6，0表示默认值. 7.Valid work_time_on_home_channel:0,30~120. Default work_time_on_home_channel is 110.0 indicates default value. CNcomment:设置背景扫描时，返回工作信道工作的时间，有效范围为30~120，默认为110，0表示默认值. 8.If scan_cnt does not enable the default value, and scan_cnt is equal to 0, it means that scan_cnt uses the most recently set value. Same for other scan parameters. CNcomment:如果scan cnt不使能默认值,同时scan cnt等于0,则表示scan_cnt使用最近设置的值. 其他扫描参数同理. 9.If scan_cnt enables the default value, and scan_cnt is equal to 0, it means that scan_cnt uses default value. Same for other scan parameters. CNcomment:如果scan cnt使能默认值,同时scan cnt等于0,则表示scan_cnt使用默认值. 其他扫描参数同理. 10.If the value of scan_cnt is set to a non-zero value,regardless of whether the default value is enabled, it is set to a non-zero value. Same for other scan parameters. CNcomment:如果scan_cnt的值设置为非零值，无论是否启用默认值，都设置为非零值. 其他扫描参数同理. 11.Total scan time: foreground scan time = scan_cnt * scan_time * scan_channel_num, background scan time = foreground scan time + (scan_channel_num / scan_channel_interval) * work_time_on_home_channel CNcomment:扫描时间：前景扫描时间 = 扫描次数 * 扫描驻留时间 * 扫描信道个数， 背景扫描时间 = 前景扫描时间 + (扫描信道个数 / n信道间隔) * 工作信道工作时间 12.Total scan time must less than 4.5s. CNcomment:扫描时间需要小于4.5s

参数

ifname	[IN] Type #const char *, interface name.CNcomment:接口名.CNend
scan_param	[IN] Type ext_wifi_scan_param_stru *scan_param:扫描参数结构体.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

uapi_wifi_set_tpc()

td_u32 uapi_wifi_set_tpc

(

td_u32

tpc_value

)

Set tcp mode.CNcomment:设置tpc开关.CNend

Description:

Set tpc mode.CNcomment:设置tpc开关.CNend

注意

1.Mode set to 1, enable auto power control. set to 0, disbale it. CNcomment:1.mode范围是0~1,1:打开发送功率自动控制,0:关闭发送功率自动控制.CNend

参数

ifname	[IN] Type #const char *, device name. CNcomment:接口名.CNend
ifname_len	[IN] Type #unsigned char, interface name length.CNcomment:接口名长度.CNend
tpc_value	[IN] Type #unsigned int, tpc_value. CNcomment:tpc开关.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_tx_pwr_offset()

td_u32 uapi_wifi_set_tx_pwr_offset	(	const td_char *	ifname,
		td_s16	offset
	)

Set tx power offset.CNcomment:设置发送功率偏移.CNend

Description:

Set tx power offset.CNcomment:设置发送功率偏移.CNend

注意

CNcomment:1.offset设置范围是-100~40，单位0.1dB.参数超出范围按最接近的边界值设置CNend
CNcomment:2.offset设置,可能会影响信道功率平坦度和evm.CNend

参数

ifname	[IN] Type #const char *, device name. CNcomment:接口名.CNend
offset	[IN] Type #signed short, offset. CNcomment:门限值.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_txpower_up_limit()

td_s32 uapi_wifi_set_txpower_up_limit	(	const td_char *	ifname,
		td_s32	power
	)

Set tx power.CNcomment:设置发送功率上限.CNend

Description:

Set maximum tx power.CNcomment:设置指定接口的发送功率上限.CNend

注意

1/only softAP can set maximum tx power.CNcomment:只有AP可以设置最大发送功率.CNend 2/should start softAP before set tx power.CNcomment:只有在AP start之后才可以设置.CNend

参数

ifname	[IN] Type #const char * interface name.
power	[IN] Type #int maximum tx power value, range (0-23]dBm.

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_wow_pattern()

int uapi_wifi_set_wow_pattern	(	unsigned char	type,
		unsigned char	index,
		unsigned char *	pattern
	)

Set wow switch.CNcomment:配置wow特定唤醒报文格式.CNend

Description:

Set wow pattern.CNcomment:配置wow特性唤醒报文格式, 支持添加/删除/清除操作 .CNend

注意

1.Should be called before uapi_wifi_init(). CNcomment:只能在uapi_wifi_init()函数前调用.CNend

参数

type	[IN] Type #unsigned char, 0:add. 1:del. 2:clr Others:invalid index [IN] Type #unsigned char, range [0-3]. Others:invalid pattern [IN] Type #unsigned char *, 自定义唤醒报文格式, HEX格式字符串

返回值

#EXT_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_set_wow_switch()

int uapi_wifi_set_wow_switch

(

uint8_t

enable

)

Set wow switch.CNcomment:设置wow特性开关.CNend

Description:

Set wow switch.CNcomment:设置wow 特性开关.CNend

注意

1.Should be called before uapi_wifi_init(). CNcomment:只能在uapi_wifi_init()函数前调用.CNend

参数

enable

[IN] Type #unsigned char,0:disable. 1:enable. Others:invalid

返回值

#EXT_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_deauth_sta()

int uapi_wifi_softap_deauth_sta	(	const unsigned char *	addr,
		unsigned char	addr_len
	)

Softap deauth user by mac address.CNcomment:softap指定断开连接的station网络.CNend

Description:

Softap deauth user by mac address.CNcomment:softap指定断开连接的station网络.CNend

注意

Address length must be 6 bytes.CNcomment:地址长度必须为6字节。CNend
;

参数

addr	[IN] Type #const unsigned char *, station mac address.CNcomment:MAC地址.CNend
addr_len	[IN] Type #unsigned char, station mac address length, must be 6. CNcomment:MAC地址长度,必须为6.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_get_connected_sta()

int uapi_wifi_softap_get_connected_sta	(	ext_wifi_ap_sta_info *	sta_list,
		unsigned int *	sta_num
	)

Get all user's information of softap.CNcomment:softap获取已连接的station的信息.CNend

Description:

Get all user's information of softap.CNcomment:softap获取已连接的station的信息.CNend

注意

1.sta_list: malloc by user.CNcomment:1.扫描结果参数。由用户动态申请。CNend
2.sta_list: max size is ext_wifi_ap_sta_info * 6. CNcomment:2.sta_list 足够的结构体大小，最大为ext_wifi_ap_sta_info * 6。CNend
3.sta_num:parameters can be passed in to specify the number of connected sta.The maximum is 6. CNcomment:3.可以传入参数，指定获取已接入的sta个数，最大为6。CNend
4.sta_num should be the same with number of ext_wifi_ap_sta_info structures applied, Otherwise, it will cause memory overflow.
CNcomment:4.sta_num和申请的ext_wifi_ap_sta_info结构体数量一致，否则可能造成内存溢出。CNend
5.Only the sta that are successfully associated are displayed. CNcomment:5.只显示关联成功的sta。CNend

参数

sta_list	[IN/OUT] Type ext_wifi_ap_sta_info *, station information.CNcomment:STA信息.CNend
sta_num	[IN/OUT] Type #unsigned int *, station number.CNcomment:STA个数.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_get_protocol_mode()

protocol_mode_enum uapi_wifi_softap_get_protocol_mode

(

void

)

Get protocol mode of softap.CNcomment:获取softap接口的protocol模式.CNend

Description:

Get protocol mode of softap.CNcomment:获取softap接口的protocol模式.CNend

注意

NULL

参数

NULL

返回值

protocol_mode_enum

protocol mode. If fail, return WIFI_MODE_UNDEFINE.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_set_beacon_period()

int uapi_wifi_softap_set_beacon_period

(

int

beacon_period

)

Set softap's beacon interval.CNcomment:设置softap的beacon周期.CNend

Description:

Set softap's beacon interval.CNcomment:设置softap的beacon周期.CNend
Initialized config sets before interface starts.CNcomment:初始配置softap启动之前调用.CNend

注意

NULL

参数

beacon_period

[IN] Type #int beacon period in milliseconds, range(33ms~1000ms), default(100ms)

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_set_dtim_period()

int uapi_wifi_softap_set_dtim_period

(

int

dtim_period

)

Set softap's dtim count.CNcomment:设置softap的dtim周期.CNend

Description:

Set softap's dtim count.CNcomment:设置softap的dtim周期.CNend
Initialized config sets before interface starts.CNcomment:初始配置softap启动之前调用.CNend

注意

NULL

参数

dtim_period

[IN] Type #int, dtim period , range(1~30), default(2)

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_set_group_rekey()

int uapi_wifi_softap_set_group_rekey

(

int

wifi_group_rekey

)

Set update time of softap's group key.CNcomment:配置softap组播秘钥更新时间.CNend

Description:

Set update time of softap's group key.CNcomment:配置softap组播秘钥更新时间.CNend
Initialized config sets before interface starts.CNcomment:初始配置softap启动之前调用.CNend

参数

wifi_group_rekey

[IN] Type #int, update time in seconds, range(30s-86400s), default(86400s) CNcomment:更新时间以秒为单位，范围（30s-86400s）,默认（86400s）.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_set_pairwise()

int uapi_wifi_softap_set_pairwise

(

int

pairwise

)

Set softap pairwise.CNcomment:设置pairwise.CNend

Description:

Set softap pairwise, from bit 1 to bit 14.CNcomment:设置pairwise，取值为bit 1到bit 14.CNend

注意

NULL

参数

pairwise

[IN] Type #int, softap pairwise.CNcomment:softap pairwise.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_set_protocol_mode()

int uapi_wifi_softap_set_protocol_mode

(

protocol_mode_enum

mode

)

Set protocol mode of softap.CNcomment:设置softap接口的protocol模式.CNend

Description:

Set protocol mode of softap.CNcomment:设置softap接口的protocol模式.CNend
Initiallize config, set before softap start.CNcomment:初始配置,在softap start之前调用.CNend

注意

Default mode(802.11BGN) CNcomment:默认模式（802.11BGN）.CNend

参数

mode	[IN] Type protocol_mode_enum protocol mode.

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_set_shortgi()

int uapi_wifi_softap_set_shortgi

(

int

flag

)

Set short-gi of softap.CNcomment:设置softap的SHORT-GI功能.CNend

Description:

Enable or disable short-gi of softap.CNcomment:开启或则关闭softap的SHORT-GI功能.CNend
Initialized config sets before interface starts.CNcomment:初始配置softap启动之前调用.CNend

注意

NULL

参数

flag	[IN] Type #int, enable(1) or disable(0). default enable(1). CNcomment:使能标志，默认使能（1）.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_start()

int uapi_wifi_softap_start	(	ext_wifi_softap_config *	conf,
		char *	ifname,
		int *	len
	)

Start softap interface.CNcomment:开启SoftAP.CNend

Description:

Start softap interface.CNcomment:开启SoftAP.CNend

注意

1. Multiple interfaces of the same type are not supported.CNcomment:不支持使用多个同类型接口.CNend

1. Dual interface coexistence support: STA + AP. CNcomment:双接口共存支持：STA + AP.CNend
   
2. Start timeout 5s.CNcomment:启动超时时间5s。CNend
   
3. Softap key length range(8 Bytes - 64 Bytes).CNcomment:softap key长度范围（8 Bytes - 64 Bytes）.CNend
   
4. Only support auth mode as bellow:
   EXT_WIFI_SECURITY_WPAPSK_WPA2PSK_MIX,
   EXT_WIFI_SECURITY_WPA2PSK,
   EXT_WIFI_SECURITY_OPEN,
   EXT_WIFI_SECURITY_SAE,
   EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX
   CNcomment:5. 只支持以下认证模式：
   EXT_WIFI_SECURITY_WPAPSK_WPA2PSK_MIX,
   EXT_WIFI_SECURITY_WPA2PSK,
   EXT_WIFI_SECURITY_OPEN.CNend
   EXT_WIFI_SECURITY_SAE.CNend
   EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX.CNend
   
5. The memories of <ifname> and <len> should be requested by the caller， the input value of len must be the same as the length of ifname (The minimum length is 4 bytes and the recommended length is 17 bytes).
   CNcomment:3. <ifname>和<len>由调用者申请内存，用户写入len的值必须与ifname长度一致。 (最小长度是4字节，建议长度为17Bytes).CNend
   
6. SSID only supports ASCII characters. CNcomment:7. SSID 只支持ASCII字符.CNend
   
7. This is a blocking function.CNcomment:8．此函数为阻塞函数.CNend
   
8. In WPA2 / WPA3 mode, the encryption method is CCMP.CNcomment:9．WPA2/WPA3混合模式下加密方式为CCMP.CNend
   
9. The PMF of WPA3 is REQUIRE, and the PMF of WPA2/WPA3 is OPTIONAL. CNcomment:10．WPA3的PMF为强制，WPA2/WPA3的PMF为可选.CNend
   
10. The PMKID connection is supported. The PMKID is stored in the memory for 12 hours. CNcomment:11．支持PMKID连接，PMKID保存时间为12小时CNend

参数

conf	[IN] Type ext_wifi_softap_config *, softap's configuration.CNcomment:SoftAP配置.CNend
ifname	[IN/OUT] Type #char *, interface name.CNcomment:接口名字.CNend
len	[IN/OUT] Type #int *, interface name length.CNcomment:接口名字长度.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_softap_stop()

int uapi_wifi_softap_stop

(

void

)

Close softap interface.CNcomment:关闭SoftAP.CNend

Description:

Close softap interface.CNcomment:关闭SoftAP.CNend

注意

1. This is a blocking function.CNcomment:1．此函数为阻塞函数.CNend

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_advance_scan()

int uapi_wifi_sta_advance_scan

(

ext_wifi_scan_params *

sp

)

Start station scanning with specified parameter.CNcomment:station执行带特定参数的扫描.CNend

Description:

Start station scanning with specified parameter.CNcomment:station执行带特定参数的扫描.CNend

注意

1. advance scan can scan with ssid only,channel only,bssid only,prefix_ssid only， and the combination parameters scanning does not support.
CNcomment:1. 高级扫描分别单独支持 ssid扫描，信道扫描，bssid扫描，ssid前缀扫描, 不支持组合参数扫描方式.CNend

1. Scanning mode, subject to the type set by scan_type. CNcomment:2 .扫描方式，以scan_type传入的类型为准。CNend
   
2. SSID only supports ASCII characters. CNcomment:3. SSID 只支持ASCII字符.CNend

参数

sp	[IN] Type ext_wifi_scan_params * parameters of scan.CNcomment:扫描网络参数设置.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_connect()

int uapi_wifi_sta_connect

(

const ext_wifi_assoc_request *

req

)

sta start connect.CNcomment:station进行连接网络.CNend

Description:

sta start connect.CNcomment:station进行连接网络.CNend

注意

1.<ssid> and <bssid> cannot be empty at the same time. CNcomment:1. <ssid>与<bssid>不能同时为空.CNend

1. When <auth_type> is set to OPEN/EXT_WIFI_SECURITY_WPA2/EXT_WIFI_SECURITY_WPA3/ EXT_WIFI_SECURITY_WPA3_WPA2_MIX, the <passwd> parameter is not required. CNcomment:2. <auth_type>设置为OPEN/EXT_WIFI_SECURITY_WPA2/EXT_WIFI_SECURITY_WPA3/ EXT_WIFI_SECURITY_WPA3_WPA2_MIX,时，无需<passwd>参数.CNend
   
2. This function is non-blocking.CNcomment:3. 此函数为非阻塞式.CNend
   
3. Pairwise can be set, default is 0.CNcomment:4. pairwise 可设置, 默认为0.CNend
   
4. If the station is already connected to a network, disconnect the existing connection and then connect to the new network.
   CNcomment:5. 若station已接入某个网络，则先断开已有连接，然后连接新网络.CNend
   
5. If the wrong SSID, BSSID or key is passed in, the EXT_WIFI_OK will be returned, but sta cannot connect the ap. CNcomment:6. 如果传入错误的ssid，bssid或者不正确的密码，返回成功，但连接ap失败。CNend
   
6. SSID only supports ASCII characters. CNcomment:7. SSID 只支持ASCII字符.CNend
   
7. Only support auth mode as bellow: EXT_WIFI_SECURITY_SAE, EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX, EXT_WIFI_SECURITY_WPAPSK_WPA2PSK_MIX, EXT_WIFI_SECURITY_WPA2PSK, EXT_WIFI_SECURITY_WPA2, EXT_WIFI_SECURITY_WPA3, EXT_WIFI_SECURITY_WPA3_WPA2_MIX, EXT_WIFI_SECURITY_WAPI_PSK, EXT_WIFI_SECURITY_WEP, EXT_WIFI_SECURITY_OPEN CNcomment:8. 只支持以下认证模式： EXT_WIFI_SECURITY_SAE, EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX, EXT_WIFI_SECURITY_WPAPSK_WPA2PSK_MIX, EXT_WIFI_SECURITY_WPA2PSK, EXT_WIFI_SECURITY_WPA2, EXT_WIFI_SECURITY_WPA3, EXT_WIFI_SECURITY_WPA3_WPA2_MIX, EXT_WIFI_SECURITY_WAPI_PSK, EXT_WIFI_SECURITY_WEP, EXT_WIFI_SECURITY_OPEN
   
8. WEP supports 64 bit and 128 bit encryption. for 64 bit encryption, the encryption key is 10 hexadecimal characters or 5 ASCII characters; for 128 bit encryption, the encryption key is 26 hexadecimal characters or 13 ASCII characters。
   CNcomment:9. WEP支持64位和128位加密，对于64位加密，加密密钥为10个十六进制字符或5个ASCII字符； 对于128位加密，加密密钥为26个十六进制字符或13个ASCII字符。CNend
   

1. When the key of WEP is in the form of ASCII character, the key in the input struct needs to be added with double quotation marks; when the key of WEP is in the form of hexadecimal character, the key in the input struct does not need to add double quotation marks.
   CNcomment:10. WEP的秘钥为ASCIl字符形式时，入参结构体中的key需要添加双引号； WEP的秘钥为为十六进制字符时，入参结构体中的key不需要添加双引号。CNend
   
2. If the auth type is EXT_WIFI_SECURITY_SAE, PMF is temporarily enabled as required.
   CNcomment:11. 当使用EXT_WIFI_SECURITY_SAE进行认证时，默认临时开启PMF（强制）。CNend
   
3. If the auth type is EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX, PMF is temporarily enabled as optional.
   CNcomment:12. 当使用EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX进行认证时，默认临时开启PMF（可选）。CNend
   
4. If the auth type is EXT_WIFI_SECURITY_WPA3, PMF is temporarily enabled as required.
   CNcomment:13. 当使用EXT_WIFI_SECURITY_WPA3进行认证时，默认临时开启PMF（强制）。CNend
   
5. If the auth type is EXT_WIFI_SECURITY_WPA3_WPA2_MIX, PMF is temporarily enabled as optional.
   CNcomment:14. 当使用EXT_WIFI_SECURITY_WPA3_WPA2_MIX进行认证时，默认临时开启PMF（可选）。CNend
   

   参数

   req	[IN] Type #const ext_wifi_assoc_request * connect parameters of network.CNcomment:连接网络参数设置.CNend

   返回值

   EXT_WIFI_OK	Execute successfully.
   EXT_WIFI_FAIL	Execute failed.

   Dependency:

   • soc_wifi_api.h: WiFi API

   参见

   NULL

   自从

uapi_wifi_sta_disconnect()

int uapi_wifi_sta_disconnect

(

void

)

Disconnect from network.CNcomment:station断开相连的网络.CNend

Description:

Disconnect from network.CNcomment:station断开相连的网络.CNend

注意

NULL

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_ent_set_eap_method()

int uapi_wifi_sta_ent_set_eap_method

(

ext_wifi_eap_method

method

)

Set wpa-enterprise eap method.CNcomment:设置企业级方法.CNend

Description:

Set wpa-enterprise eap method:设置企业级方法.CNend

注意

NULL

参数

method

[IN] Type ext_wifi_eap_method, eap method type.CNcomment:eap方法类型.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_ent_set_identity()

int uapi_wifi_sta_ent_set_identity	(	const char *	identity,
		unsigned int	len
	)

Set wpa-enterprise identity.CNcomment:设置企业级身份信息.CNend

Description:

Set wpa-enterprise identity.CNcomment:设置企业级身份信息.CNend

注意

1. strlen(identity) == len.CNcomment:1.strlen(identity)等于len.CNend

1. len <= EXT_WIFI_IDENTITY_LEN.CNcomment:2.len不大于EXT_WIFI_IDENTITY_LEN_MAX.CNend

参数

identity	[IN] Type #const char *, identity string.CNcomment:身份字符串.CNend
len	[IN] Type #unsigned int, identity string length.CNcomment:身份字符串长度.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_ent_set_import_callback()

int uapi_wifi_sta_ent_set_import_callback

(

ext_wifi_ent_import_callback *

cb

)

Set wpa-enterprise read callback.CNcomment:设置企业级证书/密钥读取的回调接口.CNend

Description:

Set wpa-enterprise read callback.CNcomment:设置企业级证书/密钥读取的回调接口.CNend

注意

NULL

参数

cb	[IN] Type ext_wifi_ent_import_callback *, read callback.CNcomment:回调接口.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_fast_connect()

int uapi_wifi_sta_fast_connect

(

const ext_wifi_fast_assoc_request *

fast_request

)

Start fast connect.CNcomment:station进行快速连接网络.CNend

Description:

Start fast connect.CNcomment:station进行快速连接网络.CNend

注意

1. <ssid> and <bssid> cannot be empty at the same time. CNcomment:1．<ssid>与<bssid>不能同时为空.CNend

1. When <auth_type> is set to OPEN, the <passwd> parameter is not required. CNcomment:2．<auth_type>设置为OPEN时，无需<passwd>参数.CNend
   
2. <chn> There are differences in the range of values, and China is 1-13. CNcomment:3．<chn>取值范围不同区域有差异，中国为1-13.CNend
   
3. This is a blocking function.CNcomment:4．此函数为阻塞函数.CNend
   
4. Pairwise can be set, set to zero by default.CNcomment:5. pairwise 可设置,默认置零.CNend
   
5. <psk> and <psk_flag> are optional parameters, set to zero by default.
   CNcomment:6. <psk>和<psk_flag>为可选参数，无需使用时填0.CNend
   
6. If the wrong SSID, BSSID or key is passed in, the EXT_WIFI_FAIL will be returned, and sta cannot connect the ap. CNcomment:7. 如果传入错误的ssid，bssid或者不正确的密码，返回失败并且连接ap失败。CNend
   
7. SSID only supports ASCII characters. CNcomment:8. SSID 只支持ASCII字符.CNend
   
8. The PSK internal cache calculated in advance will be cleared after the function execution is completed. CNcomment:9. 提前计算的PSK内部缓存将在函数执行完成后清除.CNend
   
9. The PSK calculated in advance do not support WPA3-PSK. CNcomment:10. PSK提前计算不支持WPA3-PSK.CNend
10. If the auth type is EXT_WIFI_SECURITY_SAE, PMF is temporarily enabled as required.
    CNcomment:11. 当使用EXT_WIFI_SECURITY_SAE进行认证时，默认临时开启PMF（强制）。CNend
    
11. If the auth type is EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX, PMF is temporarily enabled as optional.
    CNcomment:12. 当使用EXT_WIFI_SECURITY_WPA3_WPA2_PSK_MIX进行认证时，默认临时开启PMF（可选）。CNend
    

参数

fast_request

[IN] Type #const ext_wifi_fast_assoc_request *, fast connect parameters. CNcomment:快速连接网络参数.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_get_ap_rssi()

int uapi_wifi_sta_get_ap_rssi

(

void

)

Get rssi value.CNcomment:获取rssi值.CNend

Description:

Get current rssi of ap which sta connected to.CNcomment:获取sta当前关联的ap的rssi值.CNend

注意

NULL

参数

NULL

返回值

#0x7F	Invalid value.
#Other	rssi

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_get_ap_snr()

int uapi_wifi_sta_get_ap_snr

(

void

)

Get snr value.CNcomment:获取snr值.CNend

Description:

Get current snr of ap which sta connected to.CNcomment:获取sta当前关联的ap的snr值.CNend

注意

NULL

参数

NULL

返回值

#Other

snr

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_get_connect_info()

int uapi_wifi_sta_get_connect_info

(

ext_wifi_status *

connect_status

)

Get status of sta.CNcomment:获取station连接的网络状态.CNend

Description:

Get status of sta.CNcomment:获取station连接的网络状态.CNend

注意

NULL

参数

connect_status

[IN/OUT] Type ext_wifi_status *, connect status， memory is requested by the caller. CNcomment:连接状态, 由调用者申请内存.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_get_protocol_mode()

protocol_mode_enum uapi_wifi_sta_get_protocol_mode

(

void

)

Get protocol mode of.CNcomment:获取station接口的protocol模式.CNend

Description:

Get protocol mode of station.CNcomment:获取station接口的protocol模式.CNend

注意

NULL

参数

NULL

返回值

protocol_mode_enum

protocol mode.If fail, return EXT_WIFI_PHY_MODE_BUTT.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_raw_scan()

int uapi_wifi_sta_raw_scan	(	ext_wifi_scan_params *	sp,
		ext_wifi_scan_no_save_cb	cb
	)

function definition of wifi event.CNcommment:可自定义回调函数扫描接口定义.CNend

uapi_wifi_sta_reconnect_for_wfa_test()

int uapi_wifi_sta_reconnect_for_wfa_test

(

void

)

STA reconnect without deleting the network configuration, only used for WFA tests. CNcomment:station模式下重新发起关联但不删除network配置信息,仅WFA测试使用.CNend

Description:

STA reconnect without deleting the network configuration, only used for WFA tests. CNcomment:station模式下重新发起关联但不删除network配置信息,仅WFA测试使用.CNend

注意

1. It is recommended called after STA connected successfully, Otherwise, it is invalid. CNcomment:1. 建议在STA关联成功后调用该接口,否则无效CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_scan()

int uapi_wifi_sta_scan

(

void

)

Start sta basic scanning in all channels.CNcomment:station进行全信道基础扫描.CNend

Description:

Start sta basic scanning in all channels.CNcomment:启动station全信道基础扫描.CNend

注意

NULL

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_scan_results()

int uapi_wifi_sta_scan_results	(	ext_wifi_ap_info *	ap_list,
		unsigned int *	ap_num
	)

sta start scan.CNcomment:station进行扫描.CNend

Description:

Get station scan result.CNcomment:获取station扫描结果.CNend

注意

1. The memories of <ap_list> and <ap_num> memories are requested by the caller.
The <ap_list> size up to : OAL_SIZEOF(ext_wifi_ap_info ap_list) * 32.
CNcomment:1. <ap_list>和<ap_num>由调用者申请内存, <ap_list>size最大为：OAL_SIZEOF(ext_wifi_ap_info ap_list) * 32.CNend

1. ap_num: parameters can be passed in to specify the number of scanned results.The maximum is 32.
   CNcomment:2. ap_num: 可以传入参数，指定获取扫描到的结果数量，最大为32。CNend
   
2. If the user callback function is used, ap num refers to bss_num in event_wifi_scan_done.
   CNcomment:3. 如果使用上报用户的回调函数，ap_num参考event_wifi_scan_done中的bss_num。CNend
   
3. ap_num should be same with number of ext_wifi_ap_info structures applied, Otherwise, it will cause memory overflow.
   CNcomment:4. ap_num和申请的ext_wifi_ap_info结构体数量一致，否则可能造成内存溢出。CNend
   
4. SSID only supports ASCII characters.
   CNcomment:5. SSID 只支持ASCII字符.CNend
   
5. The rssi in the scan results needs to be divided by 100 to get the actual rssi.
   CNcomment:6. 扫描结果中的rssi需要除以100才能获得实际的rssi.CNend

参数

ap_list	[IN/OUT] Type ext_wifi_ap_info * scan result.CNcomment:扫描的结果.CNend
ap_num	[IN/OUT] Type #unsigned int *, number of scan result.CNcomment:扫描到的网络数目.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_scan_results_clear()

int uapi_wifi_sta_scan_results_clear

(

void

)

Clear sta scan result.CNcomment:清除sta扫描链表.CNend

Description:

Clear sta scan result.CNcomment:清除sta扫描链表.CNend

注意

1. This is a blocking function.CNcomment:1．此函数为阻塞函数.CNend

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_set_pm_param()

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
	)

Set sta powersave configuration.CNcomment:设置STA的低功耗参数.CNend

Description:

Set sta powersave configuration.CNcomment:设置STA的低功耗参数.CNend

注意

CNcomment:1.参数值越小,功耗越低但性能表现和抗干扰会越差,建议使用默认值或根据流量动态配置.CNend
CNcomment:2.所有参数配置0,表示该参数使用默认值.CNend
CNcomment:3.仅支持设置STA的低功耗参数.CNend
CNcomment:4.需要在关联成功后配置,支持动态配置.CNend
CNcomment:5.定时器首次启动不计数,故实际睡眠时间为配置的重启次数+1乘以周期.CNend

参数

timer	[IN] Type #unsigned char CNcomment:低功耗定时器周期,默认50ms,取值[0-100]ms.CNend
time_cnt	[IN] Type #unsigned char CNcomment:低功耗定时器重启次数,达到该次数后wifi无数据收发则进入休眠, 默认为4,取值[0-10].CNend
bcn_timeout	[IN] Type #unsigned char CNcomment:等待接收beacon的超时时间,默认10ms,取值[0-100]ms.CNend
mcast_timeout	[IN] Type #unsigned char CNcomment:等待接收组播/广播帧的超时时间,默认30ms,取值[0-100]ms.CNend

返回值

EXT_WIFI_OK	Excute successfully
#Other	Error code

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_set_protocol_mode()

int uapi_wifi_sta_set_protocol_mode

(

protocol_mode_enum

mode

)

Set protocol mode of sta.CNcomment:设置station接口的protocol模式.CNend

Description:

Set protocol mode of sta, set before calling uapi_wifi_sta_start().
CNcomment:配置station接口的protocol模式, 在sta start之前调用.CNend

注意

Default mode 802.11BGN CNcomment:默认模式 802.11BGN.CNend

参数

mode	[IN] Type protocol_mode_enum, protocol mode.

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_set_reconnect_policy()

int uapi_wifi_sta_set_reconnect_policy	(	int	enable,
		unsigned int	seconds,
		unsigned int	period,
		unsigned int	max_try_count
	)

Set reconnect policy.CNcomment:station设置重新连接网络机制.CNend

Description:

Set reconnect policy.CNcomment:station设置重新连接网络机制.CNend

注意

1. It is recommended called after STA start or connected successfully. CNcomment:1. 在STA启动后或者关联成功后调用该接口.CNend

1. The reconnection policy will be triggered when the station is disconnected from ap.
   CNcomment:2. 重连机制将于station下一次去关联时生效,当前已经去关联设置无效.CNend
   
2. The Settings will take effect on the next reconnect timer.
   CNcomment:3. 重关联过程中更新重关联配置将于下一次重连计时生效.CNend
   
3. After calling station connect/disconnect or station stop, stop reconnecting. CNcomment:4. 调用station connect/disconnect或station stop，停止重连.CNend
   
4. If the target network cannot be found by scanning, the reconnection policy cannot trigger to take effect.
   CNcomment:5. 若扫描不到目标网络，重连机制无法触发生效.CNend
   
5. When the <seconds> value is 65535, it means infinite loop reconnection. CNcomment:6. <seconds>取值为65535时，表示无限次循环重连.CNend
   7.Enable reconnect, user and lwip will not receive disconnect event when disconnected from ap until 15 seconds later and still don't reconnect to ap successfully. CNcomment:7. 使能自动重连,wifi将在15s内尝试自动重连并在此期间不上报去关联事件到用户和lwip协议栈, 做到15秒内重连成功用户和上层网络不感知.CNend
   8.Must call again if add/down/delete SoftAp or MESH's interface status after last call. CNcomment:8. 调用后如果添加/禁用/删除了SoftAp,MESH接口的状态,需要再次调用该接口.CNend
   

参数

enable	[IN] Type #int enable reconnect.0-disable/1-enable.CNcomment:使能重连网络参数.CNend
seconds	[IN] Type #unsigned int reconnect timeout in seconds for once, range:[2-65535]. CNcomment:单次重连超时时间，取值[2-65535].CNend
period	[IN] Type #unsigned int reconnect period in seconds, range:[1-65535]. CNcomment:重连间隔周期，取值[1-65535].CNend
max_try_count	[IN] Type #unsigned int max reconnect try count number，range:[1-65535]. CNcomment:最大重连次数，取值[1-65535].CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_start()

int uapi_wifi_sta_start	(	char *	ifname,
		int *	len
	)

Start wifi station.CNcomment:开启STA.CNend

Description:

Start wifi station.CNcomment:开启STA.CNend

注意

1. Multiple interfaces of the same type are not supported.CNcomment:1. 不支持使用多个同类型接口.CNend

1. Dual interface coexistence support: STA + AP or STA + MESH. CNcomment:2. 双接口共存支持：STA + AP or STA + MESH.CNend
   
2. The memories of <ifname> and <len> should be requested by the caller， the input value of len must be the same as the length of ifname (The minimum length is 6 bytes and the recommended length is 17 bytes).
   CNcomment:3. <ifname>和<len>由调用者申请内存，用户写入len的值必须与ifname长度一致。 (最小长度是6字节，建议长度为17Bytes).CNend
   
3. This is a blocking function.CNcomment:4．此函数为阻塞函数.CNend

参数

ifname	[IN/OUT] Type #char *, device name.CNcomment:接口名.CNend
len	[IN/OUT] Type #int *, length of device name.CNcomment:接口名长度.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_stop()

int uapi_wifi_sta_stop

(

void

)

Close wifi station.CNcomment:关闭STA.CNend

Description:

Close wifi station.CNcomment:关闭STA.CNend

注意

1. This is a blocking function.CNcomment:1．此函数为阻塞函数.CNend

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_wps_pbc()

int uapi_wifi_sta_wps_pbc	(	const unsigned char *	bssid,
		unsigned int	bssid_len
	)

Start pbc connect in WPS.CNcomment:设置WPS进行pbc连接.CNend

Description:

Start pbc connect in WPS.CNcomment:设置WPS进行pbc连接.CNend

注意

1. bssid can be NULL or MAC. CNcomment:1. bssid 可以指定mac或者填NULL.CNend

1. Bssid length must be 6 bytes.CNcomment:地址长度必须为6字节。CNend
   ;

参数

bssid	[IN] Type #const unsigned char * mac address
bssid_len	[IN] Type #unsigned int the length of mac address

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_wps_pin()

int uapi_wifi_sta_wps_pin	(	const char *	pin,
		unsigned int	pin_len,
		const unsigned char *	bssid,
		unsigned int	bssid_len
	)

Start pin connect in WPS.CNcomment:WPS通过pin码连接网络.CNend

Description:

Start pin connect in WPS.CNcomment:WPS通过pin码连接网络.CNend

注意

1. Bssid can be NULL or MAC. CNcomment:1. bssid 可以指定mac或者填NULL.CNend

1. Decimal only WPS pin code length is 8 Bytes.CNcomment:2. WPS中pin码仅限十进制，长度为8 Bytes.CNend
2. Bssid length must be 6 bytes.CNcomment:地址长度必须为6字节。CNend
   ;

参数

pin	[IN] Type #const char * pin code
bssid	[IN] Type #const unsigned char * mac address
bssid_len	[IN] Type #unsinged int the length of mac address

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_sta_wps_pin_get()

int uapi_wifi_sta_wps_pin_get	(	char *	pin,
		unsigned int	len
	)

Get pin code.CNcomment:WPS获取pin码.CNend

Description:

Get pin code.CNcomment:WPS获取pin码.CNend

注意

Decimal only WPS pin code length is 8 Bytes.CNcomment:WPS中pin码仅限十进制，长度为8 Bytes.CNend

参数

pin	[IN/OUT] Type #char *, pin code buffer, should be obtained, length is 9 Bytes. The memory is requested by the caller. CNcomment:待获取pin码,长度为9 Bytes。由调用者申请内存.CNend
len	[IN] Type #unsigned int, length of pin code。CNcomment:pin码的长度.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_wnm_bss_query()

int uapi_wifi_wnm_bss_query	(	int	reason_code,
		int	candidate_list
	)

Clear sta scan result.CNcomment:发送bss query报文.CNend

Description:

Clear sta scan result.CNcomment:发送bss query报文.CNend

注意

1. This is a blocking function.CNcomment:1．此函数为阻塞函数.CNend

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

uapi_wifi_wnm_notify()

int uapi_wifi_wnm_notify	(	const char *	param,
		unsigned int	len
	)

Clear sta scan result.CNcomment:发送wnm notify query报文.CNend

Description:

Clear sta scan result.CNcomment:发送wnm notify query报文.CNend

注意

1. This is a blocking function.CNcomment:1．此函数为阻塞函数.CNend

参数

NULL

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

wifi_dev_get()

struct ext_wifi_dev * wifi_dev_get

(

ext_wifi_iftype

iftype

)

Get wifi device config.CNcomment:获取wifi device的配置.CNend

Description:

Get wifi device config.CNcomment:获取wifi device的配置.CNend

注意

NULL

参数

iftype

[IN] Type ext_wifi_iftype, iftype enum value.CNcoment:iftype枚举值.CNend

返回值

#struct	ext_wifi_dev * Execute successfully.
NULL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

wifi_softap_set_sae_pwe()

int wifi_softap_set_sae_pwe

(

wifi_sae_pwe_option_enum

pwe

)

Config sae pwe settings of softap.CNcomment:配置softap的sae pwe.CNend

Description:

Config sae pwe settings of softap, set before softap start. CNcomment:配置softap的sae pwe, 在softap start之前调用.CNend

注意

Default sae pwe enum value 2. CNcomment:默认sae pwe枚举值2.CNend

参数

pwe	[IN] Type wifi_sae_pwe_option_enum, sae pwe enum value.CNcoment:sae pwe枚举值.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从

wifi_sta_set_sae_pwe()

int wifi_sta_set_sae_pwe

(

wifi_sae_pwe_option_enum

pwe

)

Config sae pwe settings of sta.CNcomment:配置station的sae pwe.CNend

Description:

Config sae pwe settings of sta, set before sta start.CNcomment:配置station的sae pwe, 在sta start之前调用.CNend

注意

Default sae pwe enum value 2. CNcomment:默认sae pwe枚举值2.CNend

参数

pwe	[IN] Type wifi_sae_pwe_option_enum, sae pwe enum value.CNcoment:sae pwe枚举值.CNend

返回值

EXT_WIFI_OK	Execute successfully.
EXT_WIFI_FAIL	Execute failed.

Dependency:

• soc_wifi_api.h: WiFi API

参见

NULL

自从