Device#

Device 提供 Wi-Fi(Wireless Fidelity)STA 模式的初始化、扫描、连接、断连等基础能力,支持协议模式配置、PMF(Protected Management Frames)设置、CSI(Channel State Information)数据采集、管理帧收包回调注册、混杂模式报文接收、WoW(Wake on Wireless)模式配置、MAC 地址管理、国家码设置、PSD(Power Spectral Density)数据采集等功能。

模块公共头文件

#include "middleware/services/wifi/wifi_device.h"

接口清单#

接口名称

功能简述

wifi_init

WiFi 初始化

wifi_deinit

WiFi 去初始化

wifi_is_wifi_inited

获取 WiFi 初始化状态

wifi_sta_enable

开启 STA

wifi_sta_disable

关闭 STA

wifi_is_sta_enabled

获取 STA 使能状态

wifi_get_dev

获取 WiFi 设备结构体指针

wifi_sta_set_protocol_mode

设置 STA 协议模式

wifi_sta_get_protocol_mode

获取 STA 协议模式

wifi_sta_scan

STA 全信道基础扫描

wifi_sta_scan_advance

STA 带特定参数的扫描

wifi_sta_set_scan_policy

设置 STA 扫描策略

wifi_raw_scan

STA 带特定参数的原始扫描

wifi_sta_scan_stop

强制停止 STA 扫描

wifi_sta_get_scan_info

获取 STA 扫描结果

wifi_sta_scan_result_clear

清空 STA 扫描结果

wifi_set_channel

设置 WiFi 信道

wifi_get_channel

获取 WiFi 信道

wifi_sta_wnm_bss_query

发送 BSS 查询报文

wifi_sta_wnm_notify

发送 WNM 通知报文

wifi_sta_connect

STA 连接网络

wifi_sta_disconnect

STA 断开网络连接

wifi_sta_get_ap_info

获取 STA 连接的 AP 信息

wifi_sta_set_reconnect_policy

设置 STA 重连策略

wifi_sta_set_pmf_mode

设置 STA 的 PMF 模式

wifi_sta_get_pmf_mode

获取 STA 的 PMF 模式

wifi_sta_get_connect_status_code

获取 STA 连接状态码

wifi_set_mgmt_frame_rx_cb

注册管理帧收包回调

wifi_set_promis_mode

设置混杂模式

wifi_set_promis_rx_pkt_cb

注册混杂模式收包回调

wifi_sta_fast_connect

STA 快速连接网络

wifi_register_event_cb

注册 WiFi 事件回调

wifi_unregister_event_cb

去注册 WiFi 事件回调

wifi_set_app_ie

在管理帧中添加用户 IE

wifi_del_app_ie

在管理帧中删除用户 IE

wifi_set_wow_pattern

设置 WoW Pattern 模式

wifi_set_wow_sleep_mode

设置 WoW 休眠使能

wifi_csi_start

开启 CSI 上报

wifi_csi_stop

关闭 CSI 上报

wifi_set_csi_config

配置 CSI 参数

wifi_register_csi_report_cb

注册 CSI 数据上报回调

wifi_send_custom_pkt

发送用户定制报文

wifi_set_pkt_retry_policy

设置帧最大软件重传次数

wifi_reset_mac_phy

复位 MAC 和 PHY 接口

wifi_set_linkloss_config

设置 Linkloss 参数

wifi_set_base_mac_addr

设置基础 MAC 地址

wifi_get_base_mac_addr

获取基础 MAC 地址

wifi_softap_set_mac_addr

设置 SoftAP MAC 地址

wifi_softap_get_mac_addr

获取 SoftAP MAC 地址

wifi_set_mac_derivation_ptr

设置 MAC 派生策略回调

wifi_set_low_current_boot_mode

设置低启动电流模式

wifi_get_country_code

获取国家码

wifi_set_country_code

设置国家码

wifi_sta_set_pm

设置 STA 低功耗模式

wifi_set_sdp_mode

设置 SDP 模式

wifi_set_sdp_subscribe

设置 SDP 订阅

wifi_set_psd_mode

设置 PSD 模式

wifi_set_psd_cb

设置 PSD 数据上报回调

wifi_sta_config_probe_req_max_times

配置 STA beacon miss 后 probe request 最大发送次数

Functions#

wifi_init #

errcode_t wifi_init(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • Wi-Fi 模块初始化,完成 Wi-Fi 子系统资源分配与底层驱动加载。

  • 重复调用返回错误码。

前置条件

  • Wi-Fi 硬件已上电就绪。

  • 系统内核及 OSAL(Operating System Abstraction Layer)模块已初始化完成。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

Wi-Fi 初始化成功

Other

其他错误码,参考errcode_t

执行失败

wifi_deinit #

errcode_t wifi_deinit(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • Wi-Fi 去初始化,释放 Wi-Fi 子系统资源。

  • 需在 Wi-Fi 模块不再使用时调用。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA/AP 接口已关闭。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

Wi-Fi 去初始化成功

Other

其他错误码,参考errcode_t

执行失败

wifi_is_wifi_inited #

int32_t wifi_is_wifi_inited(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 查询 Wi-Fi 模块是否已初始化。

  • 用于其他模块判断 Wi-Fi 初始化状态。

返回值

返回值

文字含义

触发场景

1

WiFi 已初始化

wifi_init() 已成功调用

0

WiFi 未初始化

wifi_init() 未调用或未成功

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_sta_enable #

errcode_t wifi_sta_enable(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 开启 STA 模式。

  • 使能后可进行扫描、连接等 STA 操作。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 未使能。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

STA 使能成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_sta_disable #

errcode_t wifi_sta_disable(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 关闭 STA 模式。

  • 关闭后 STA 相关功能不可用。

前置条件

  • STA 已通过 wifi_sta_enable() 使能。

  • STA 已断开与 AP 的连接。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

STA 关闭成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/middleware/utils/at/at_wifi_cmd/at/at_wifi.c

wifi_is_sta_enabled #

int32_t wifi_is_sta_enabled(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 查询 STA 是否已使能。

  • 用于判断 STA 模式当前状态。

返回值

返回值

文字含义

触发场景

1

STA 已使能

wifi_sta_enable() 已成功调用

0

STA 未使能

wifi_sta_enable() 未调用或未成功

wifi_get_dev #

wifi_dev_t *wifi_get_dev(wifi_iftype_t iftype)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 根据接口类型获取 Wi-Fi 设备结构体指针。

  • 返回 NULL 表示设备未使能。

  • 用于获取设备信息及操作句柄。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_iftype_t

Wi-Fi 接口类型

wifi_iftype_t 全体成员

返回值

返回值

文字含义

触发场景

非 NULL

WiFi 设备结构体指针

设备已使能

NULL

设备未使能

设备未初始化

wifi_sta_set_protocol_mode #

errcode_t wifi_sta_set_protocol_mode(protocol_mode_enum mode)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 STA 的协议模式。

  • 协议模式决定 STA 支持的 802.11 协议标准。

  • 需在 STA 使能前设置。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

mode

protocol_mode_enum

协议模式

protocol_mode_enum 全体成员

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_get_protocol_mode #

protocol_mode_enum wifi_sta_get_protocol_mode(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

返回值

返回值

文字含义

触发场景

protocol_mode_enum

STA 协议模式

获取成功

wifi_sta_scan #

errcode_t wifi_sta_scan(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 启动 STA 全信道基础扫描。

  • 扫描结果通过事件回调或 wifi_sta_get_scan_info() 获取。

  • 扫描完成触发 WIFI_STATE_AVALIABLE 事件。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

扫描启动成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_sta_scan_advance #

errcode_t wifi_sta_scan_advance(const wifi_scan_params_stru *scan_param)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 启动 STA 带特定参数的扫描。

  • 支持指定 SSID(Service Set Identifier)、BSSID(Basic Service Set Identifier)、信道等过滤条件。

  • 扫描结果通过事件回调或 wifi_sta_get_scan_info() 获取。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

入参

名称

参数类型

说明

约束取值范围

scan_param

const wifi_scan_params_stru *

扫描网络参数设置

非 NULL,指向有效扫描参数结构体

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

扫描启动成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/middleware/utils/at/at_wifi_cmd/at/at_wifi.c

wifi_sta_set_scan_policy #

errcode_t wifi_sta_set_scan_policy(wifi_if_type_enum iftype, wifi_scan_strategy_stru *scan_strategy)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 STA 扫描策略参数。

  • 可配置每个信道停留时间、扫描 slot 数、probe req 发送次数等。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

scan_strategy

wifi_scan_strategy_stru *

扫描策略参数配置

非 NULL,指向有效策略结构体

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_raw_scan #

errcode_t wifi_raw_scan(wifi_scan_params_stru *scan_param, wifi_scan_no_save_cb cb)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 启动 STA 带特定参数的原始扫描,不经过 wpa,回调由用户指定。

  • 扫描结果通过回调函数直接返回,不保存到扫描缓存。

  • 回调入参为 wifi_scan_info_stru 类型。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

入参

名称

参数类型

说明

约束取值范围

scan_param

wifi_scan_params_stru *

扫描网络参数设置

非 NULL

cb

wifi_scan_no_save_cb

扫描完成回调函数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

原始扫描启动成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_scan_stop #

errcode_t wifi_sta_scan_stop(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 强制停止 STA 全信道扫描。

  • 扫描正在进行时调用此接口可中止扫描。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

  • 扫描正在进行中。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

扫描停止成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_get_scan_info #

errcode_t wifi_sta_get_scan_info(wifi_scan_info_stru *result, uint32_t *size)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取 STA 扫描结果。

  • 扫描结果存入 result 数组,size 返回扫描到的网络数目。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能且扫描已完成。

入参

名称

参数类型

说明

约束取值范围

size

uint32_t *

扫描到的网络数目

非 NULL,输入时为缓冲区最大容量,输出时为实际数目

出参

名称

数据类型

输出说明

result

wifi_scan_info_stru

扫描结果数组

size

uint32_t

扫描到的网络数目

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

获取成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_sta_scan_result_clear #

errcode_t wifi_sta_scan_result_clear(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 清空 STA 扫描结果缓存。

  • 清空后无法再通过 wifi_sta_get_scan_info() 获取上次扫描结果。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

清空成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_channel #

errcode_t wifi_set_channel(wifi_if_type_enum iftype, int32_t channel)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 Wi-Fi 工作信道。

  • 根据接口类型指定 STA 或 AP 的信道。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

channel

int32_t

信道号

1~14(2.4GHz)

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_get_channel #

errcode_t wifi_get_channel(wifi_if_type_enum iftype, int32_t *channel)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取 Wi-Fi 当前工作信道。

  • 根据接口类型获取 STA 或 AP 的信道。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

出参

名称

数据类型

输出说明

channel

int32_t

当前工作信道号

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

获取成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_wnm_bss_query #

errcode_t wifi_sta_wnm_bss_query(int32_t reason_code, int32_t candidate_list)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 发送 BSS query 报文。

  • 用于 WNMBSS 转换管理。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

reason_code

int32_t

原因码

有效 reason code 值

candidate_list

int32_t

候选列表标记

0 或 1

Kconfig配置

配置项

宏类型

说明

默认值

CONFIG_WNM

特性宏

支持 WNM BSS 转换管理功能

由构建目标决定

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

发送成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_wnm_notify #

errcode_t wifi_sta_wnm_notify(const char *param, uint32_t len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 发送 WNM notify 报文。

  • 用于 WNM 通知交互。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

param

const char *

WNM notify 参数

非 NULL

len

uint32_t

参数长度

大于 0

Kconfig配置

配置项

宏类型

说明

默认值

CONFIG_WNM

特性宏

支持 WNM BSS 转换管理功能

由构建目标决定

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

发送成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_connect #

errcode_t wifi_sta_connect(const wifi_sta_config_stru *config)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • STA 发起连接网络请求。

  • 根据配置参数连接指定 AP。

  • 连接结果通过事件回调通知。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

  • 已完成扫描获取目标 AP 信息。

入参

名称

参数类型

说明

约束取值范围

config

const wifi_sta_config_stru *

连接网络参数设置

非 NULL,指向有效连接配置结构体

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

连接请求发起成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_sta_disconnect #

errcode_t wifi_sta_disconnect(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • STA 断开与当前连接的网络。

  • 断连结果通过事件回调通知。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能且处于已连接状态。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

断连请求发起成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/middleware/utils/at/at_wifi_cmd/at/at_wifi.c

wifi_sta_get_ap_info #

errcode_t wifi_sta_get_ap_info(wifi_linked_info_stru *result)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取 STA 当前连接的网络状态信息。

  • 包括 SSID、BSSID、RSSI(Received Signal Strength Indicator)、连接状态等。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

出参

名称

数据类型

输出说明

result

wifi_linked_info_stru

STA 连接的 AP 信息

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

获取成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_sta_set_reconnect_policy #

errcode_t wifi_sta_set_reconnect_policy(int32_t enable, uint32_t seconds, uint32_t period, uint32_t max_try_count)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 STA 重连网络策略。

  • 可配置重连使能、单次超时、重连间隔、最大重连次数。

  • 断连后根据策略自动发起重连。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

enable

int32_t

使能重连网络

0:关闭,1:开启

seconds

uint32_t

单次重连超时时间(秒)

2~65535

period

uint32_t

重连间隔周期(秒)

1~65535

max_try_count

uint32_t

最大重连次数

1~65535

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/middleware/utils/at/at_wifi_cmd/at/at_wifi.c

wifi_sta_set_pmf_mode #

errcode_t wifi_sta_set_pmf_mode(wifi_pmf_option_enum pmf)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 配置 STA 的 PMF 模式。

  • PMF 用于管理帧保护,增强安全性。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

pmf

wifi_pmf_option_enum

PMF 模式

wifi_pmf_option_enum 全体成员

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_get_pmf_mode #

wifi_pmf_option_enum wifi_sta_get_pmf_mode(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取 STA 当前 PMF 设置。

  • 返回 PMF 模式枚举值。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

返回值

返回值

文字含义

触发场景

wifi_pmf_option_enum枚举值

PMF 模式

获取成功

WIFI_MGMT_FRAME_PROTECTION_BUTT(3)

获取失败

执行失败

wifi_sta_get_connect_status_code #

int16_t wifi_sta_get_connect_status_code(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 查询 Authentication 与 Association 帧的 status code。

  • 用于诊断连接失败原因。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

返回值

返回值

文字含义

触发场景

Status Codes value

状态码值

获取成功

-1

执行失败

获取失败

wifi_set_mgmt_frame_rx_cb #

errcode_t wifi_set_mgmt_frame_rx_cb(wifi_rx_mgmt_cb data_cb, uint8_t mode)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 注册管理帧收包回调函数。

  • 收到管理帧后通过回调通知上层。

  • 可配置上报管理帧模式。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

data_cb

wifi_rx_mgmt_cb

管理帧上报回调函数

非 NULL

mode

uint8_t

上报管理帧模式

有效模式值

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

注册成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_promis_mode #

errcode_t wifi_set_promis_mode(wifi_if_type_enum iftype, int32_t enable, const wifi_ptype_filter_stru *filter)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置混杂模式(Monitor/Promiscuous mode)。

  • 可配置接收帧类型过滤规则。

  • 开启后可接收非本地址的数据帧。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

enable

int32_t

开启/关闭

0:关闭,1:开启

filter

const wifi_ptype_filter_stru *

帧类型过滤列表

开启时非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_promis_rx_pkt_cb #

errcode_t wifi_set_promis_rx_pkt_cb(wifi_promis_cb data_cb)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 注册混杂模式的收包回调函数。

  • 混杂模式下收到数据帧后通过回调通知。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • 混杂模式已通过 wifi_set_promis_mode() 开启。

入参

名称

参数类型

说明

约束取值范围

data_cb

wifi_promis_cb

混杂模式回调函数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

注册成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_fast_connect #

errcode_t wifi_sta_fast_connect(const wifi_fast_connect_stru *fast_request)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • STA 快速连接网络。

  • 使用预计算的 PSK(Pre-Shared Key)和信道信息加速连接。

  • 适用于已知 AP 信息的重连场景。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

  • 已有目标 AP 的连接信息(含 PSK)。

入参

名称

参数类型

说明

约束取值范围

fast_request

const wifi_fast_connect_stru *

快速连接网络参数

非 NULL,指向有效快速连接参数结构体

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

快速连接请求发起成功

Other

其他错误码,参考errcode_t

执行失败

wifi_register_event_cb #

errcode_t wifi_register_event_cb(const wifi_event_stru *event)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 注册 Wi-Fi 事件回调函数。

  • 包括连接状态变化、扫描状态变化、AP 状态变化、STA 加入/离开等事件。

  • 注册后相关事件通过回调通知上层。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

event

const wifi_event_stru *

事件回调函数结构体

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

注册成功

Other

其他错误码,参考errcode_t

执行失败

参考案例

  • src/application/samples/wifi/sta_sample/sta_sample.c

wifi_unregister_event_cb #

errcode_t wifi_unregister_event_cb(const wifi_event_stru *event)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 去注册 Wi-Fi 事件回调函数。

  • 去注册后不再接收对应 Wi-Fi 事件通知。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • 已通过 wifi_register_event_cb() 注册回调。

入参

名称

参数类型

说明

约束取值范围

event

const wifi_event_stru *

待撤销的回调函数结构体

非 NULL,与注册时一致

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

去注册成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_app_ie #

errcode_t wifi_set_app_ie(wifi_if_type_enum iftype, ie_index_enmu ie_index, uint8_t frame_type_bitmap, const uint8_t *ie, uint16_t ie_len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 在管理帧中添加用户自定义 IE。

  • 最多支持 4 个用户 IE 的插入。

  • 可指定插入 IE 的帧类型(beacon、probe request、probe response)。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

ie_index

ie_index_enmu

IE 索引

ie_index_enmu 全体成员

frame_type_bitmap

uint8_t

可插入 IE 的帧类型位图

bit0:beacon,bit1:probe request,bit2:probe response

ie

const uint8_t *

用户 IE 字段内容

非 NULL

ie_len

uint16_t

用户 IE 字段内容长度

大于 0

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

添加成功

Other

其他错误码,参考errcode_t

执行失败

wifi_del_app_ie #

errcode_t wifi_del_app_ie(wifi_if_type_enum iftype, ie_index_enmu ie_index, uint8_t frame_type_bitmap)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 在管理帧中删除用户自定义 IE。

  • 根据索引和帧类型位图删除指定 IE。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • 已通过 wifi_set_app_ie() 添加过 IE。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

ie_index

ie_index_enmu

IE 索引

ie_index_enmu 全体成员

frame_type_bitmap

uint8_t

可删除 IE 的帧类型位图

bit0:beacon,bit1:probe request,bit2:probe response

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

删除成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_wow_pattern #

errcode_t wifi_set_wow_pattern(int32_t type, uint8_t index, int8_t *pattern)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 WoWPattern 模式。

  • 可配置 TCP/UDP 模式匹配 pattern。

  • 用于低功耗唤醒场景。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

type

int32_t

WoW Pattern 模式

有效 pattern 类型值

index

uint8_t

位置索引

有效索引值

pattern

int8_t *

16 进制 TCP/UDP pattern 数据

非 NULL

Kconfig配置

配置项

宏类型

说明

默认值

_PRE_WLAN_FEATURE_WOW_OFFLOAD

特性宏

支持 WoW Offload 功能

由构建目标决定

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_wow_sleep_mode #

errcode_t wifi_set_wow_sleep_mode(uint8_t en)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • WoW 休眠使能配置。

  • 仅在 STA 模式下才能使能 WoW 休眠。

  • 0 代表 WoW 休眠去使能,1 代表 WoW 休眠使能。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已使能。

入参

名称

参数类型

说明

约束取值范围

en

uint8_t

使能/去使能 WoW 休眠

0:去使能,1:使能

Kconfig配置

配置项

宏类型

说明

默认值

_PRE_WLAN_FEATURE_WOW_OFFLOAD

特性宏

支持 WoW Offload 功能

由构建目标决定

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_csi_start #

errcode_t wifi_csi_start(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 开启 CSI 上报。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • CSI 已通过 wifi_set_csi_config() 配置完成。

  • CSI 上报回调已通过 wifi_register_csi_report_cb() 注册。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

CSI 上报开启成功

Other

其他错误码,参考errcode_t

执行失败

wifi_csi_stop #

errcode_t wifi_csi_stop(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 关闭 CSI 上报。

  • 停止后不再接收 CSI 数据回调。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • CSI 已通过 wifi_csi_start() 开启。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

CSI 上报关闭成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_csi_config #

errcode_t wifi_set_csi_config(const int8_t *ifname, const csi_config_stru *config)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 配置 CSI 参数。

  • 包括用户 ID、白名单、帧类型过滤、上报周期等。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

ifname

const int8_t *

使能 CSI 的接口名

非 NULL,如"wlan0"

config

const csi_config_stru *

CSI 配置参数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

配置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_register_csi_report_cb #

errcode_t wifi_register_csi_report_cb(wifi_csi_data_cb data_cb)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 注册 CSI 数据上报回调函数。

  • CSI 数据通过回调函数上报给上层。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

data_cb

wifi_csi_data_cb

CSI 数据上报回调函数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

注册成功

Other

其他错误码,参考errcode_t

执行失败

wifi_send_custom_pkt #

errcode_t wifi_send_custom_pkt(const wifi_if_type_enum iftype, const uint8_t *data, uint32_t len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 发送用户定制报文,报文须按照 802.11 协议格式封装。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

data

const uint8_t*

待发送帧的内容

非 NULL,须按 802.11 协议格式封装

len

uint32_t

待发送报文的长度

10 ~ 1400(实现边界 WIFI_SENDPKT_MIN_LEN = 10;
WIFI_SENDPKT_MAX_LEN = 1400)。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

发送成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_pkt_retry_policy #

errcode_t wifi_set_pkt_retry_policy(uint8_t type, uint8_t limit)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置数据帧和管理帧的最大软件重传次数。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

type

uint8_t

帧类型

数据帧/管理帧

limit

uint8_t

需要设置的软件最大重传次数

大于 0

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_reset_mac_phy #

errcode_t wifi_reset_mac_phy(void)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 复位 MAC 和 PHY 接口,解决 MAC、PHY 挂死问题。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

复位成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_linkloss_config #

errcode_t wifi_set_linkloss_config(linkloss_paras_stru *linkloss_paras)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 Linkloss 的参数。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

入参

名称

参数类型

说明

约束取值范围

linkloss_paras

linkloss_paras_stru*

设置 linkloss 相关参数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_base_mac_addr #

errcode_t wifi_set_base_mac_addr(const int8_t *mac_addr, uint8_t mac_len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置基础 MAC 地址。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

mac_addr

const int8_t*

MAC 地址指针

非 NULL

mac_len

uint8_t

MAC 地址长度

WIFI_MAC_LEN(6)

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_get_base_mac_addr #

errcode_t wifi_get_base_mac_addr(int8_t *mac_addr, uint8_t mac_len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取基础 MAC 地址。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

mac_len

uint8_t

MAC 地址长度

WIFI_MAC_LEN(6)

出参

名称

数据类型

输出说明

mac_addr

int8_t*

基础 MAC 地址,由调用方分配内存、函数填充

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

获取成功

Other

其他错误码,参考errcode_t

执行失败

wifi_softap_set_mac_addr #

errcode_t wifi_softap_set_mac_addr(const int8_t *mac_addr, uint8_t mac_len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 SoftAP 的 MAC 地址。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

mac_addr

const int8_t*

MAC 地址指针

非 NULL

mac_len

uint8_t

MAC 地址长度

WIFI_MAC_LEN(6)

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_softap_get_mac_addr #

errcode_t wifi_softap_get_mac_addr(int8_t *mac_addr, uint8_t mac_len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取 SoftAP 的 MAC 地址。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

mac_len

uint8_t

MAC 地址长度

WIFI_MAC_LEN(6)

出参

名称

数据类型

输出说明

mac_addr

int8_t*

SoftAP 的 MAC 地址,由调用方分配内存、函数填充

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

获取成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_mac_derivation_ptr #

errcode_t wifi_set_mac_derivation_ptr(wifi_mac_derivation_ptr ptr)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 MAC 派生策略。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

ptr

wifi_mac_derivation_ptr

派生方法指针

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_low_current_boot_mode #

errcode_t wifi_set_low_current_boot_mode(uint8_t flag)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置低启动电流模式。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

flag

uint8_t

模式设置

0:关闭;
1:开启。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_get_country_code #

errcode_t wifi_get_country_code(int8_t *country_code, uint8_t *len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 获取国家码。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

len

uint8_t*

国家码数组长度

非 NULL,输入时为缓冲区容量,输出时为实际长度

出参

名称

数据类型

输出说明

country_code

int8_t*

国家码,由调用方分配内存、函数填充

len

uint8_t*

国家码的实际长度

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

获取成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_country_code #

errcode_t wifi_set_country_code(const int8_t* country_code, uint8_t len)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置国家码。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

country_code

const int8_t*

国家码

非 NULL

len

uint8_t

国家码数组长度

大于 0

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_set_pm #

errcode_t wifi_sta_set_pm(uint8_t ps_switch)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置低功耗模式。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

  • STA 已通过 wifi_sta_enable() 使能。

入参

名称

参数类型

说明

约束取值范围

ps_switch

uint8_t

低功耗模式

0:关闭;
1:开启。

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_sdp_mode #

errcode_t wifi_set_sdp_mode(wifi_if_type_enum iftype, int32_t enable, int32_t ratio)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 SDP 模式。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

enable

int32_t

使能开关

0:关闭;
1:开启。

ratio

int32_t

比例

大于 0

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_sdp_subscribe #

errcode_t wifi_set_sdp_subscribe(wifi_if_type_enum iftype, char *sdp_subscribe, int32_t local_handle)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 SDP 订阅。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

iftype

wifi_if_type_enum

接口类型

wifi_if_type_enum 全体成员

sdp_subscribe

char*

SDP 订阅

非 NULL

local_handle

int32_t

当前句柄

有效句柄值

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_psd_mode #

errcode_t wifi_set_psd_mode(ext_psd_option_param *psd_option)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 PSD 模式。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

psd_option

ext_psd_option_param*

PSD 参数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_set_psd_cb #

errcode_t wifi_set_psd_cb(wifi_psd_cb data_cb)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 设置 PSD 回调接口。

前置条件

  • Wi-Fi 已通过 wifi_init() 初始化完成。

入参

名称

参数类型

说明

约束取值范围

data_cb

wifi_psd_cb

PSD 回调函数

非 NULL

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

设置成功

Other

其他错误码,参考errcode_t

执行失败

wifi_sta_config_probe_req_max_times #

errcode_t wifi_sta_config_probe_req_max_times(uint8_t max_times)

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • 配置 STA beacon miss 后 probe request 最大发送次数。

入参

名称

参数类型

说明

约束取值范围

max_times

uint8_t

快速连接所需的扫描次数

1 ~ 33(实现上界 WIFI_STA_SEND_PROBE_REQ_MAX = 33,拒绝 0 与超界值;头文件注释同为 [1,33])

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

成功

配置成功

Other

其他错误码,参考errcode_t

配置失败

Type definitions#

wifi_csi_data_cb #

typedef void (*wifi_csi_data_cb)(uint8_t *csi_data, int32_t len);

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 用户注册的回调函数,用于处理 CSI 上报的数据。

使用说明

名称

参数类型

说明

约束取值范围

csi_data

uint8_t*

4 字节扩展时间戳+758 字节 64 位小端存储格式的 CSI 数据

非 NULL

len

int32_t

数据长度,固定为 762 字节

762

返回值

无(void)

wifi_promis_cb #

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

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 混杂模式收包回调接口定义。

使用说明

名称

参数类型

说明

约束取值范围

recv_buf

void*

帧数据

非 NULL

frame_len

int32_t

帧长度

大于 0

rssi

int8_t

信号强度

-

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

处理成功

Other

其他错误码,参考errcode_t

执行失败

wifi_rx_mgmt_cb #

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

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 管理帧收包回调接口定义。

使用说明

名称

参数类型

说明

约束取值范围

recv_buf

void*

帧数据

非 NULL

frame_len

int32_t

帧长度

大于 0

rssi

int8_t

信号强度

-

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

处理成功

Other

其他错误码,参考errcode_t

执行失败

wifi_psd_cb #

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

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • PSD 数据上报回调接口定义。

使用说明

名称

参数类型

说明

约束取值范围

recv_buf

void*

PSD 数据

非 NULL

data_len

uint32_t

PSD 数据长度

大于 0

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

处理成功

Other

其他错误码,参考errcode_t

执行失败

wifi_scan_no_save_cb #

typedef void (*wifi_scan_no_save_cb)(wifi_scan_info_stru *scan_result);

声明头文件

#include "include/middleware/services/wifi/wifi_scan_info.h"

功能说明

  • 定制化扫描回调函数。

使用说明

名称

参数类型

说明

约束取值范围

scan_result

wifi_scan_info_stru*

扫描结果

非 NULL

返回值

无(void)

wifi_mac_derivation_ptr #

typedef unsigned int(*wifi_mac_derivation_ptr)(unsigned char *origin_mac, unsigned char num, unsigned char type, unsigned char *output_mac, unsigned char out_put_num);

声明头文件

#include "include/middleware/services/wifi/wifi_device.h"

功能说明

  • MAC 派生方法指针定义。

使用说明

名称

参数类型

说明

约束取值范围

origin_mac

unsigned char*

输入 MAC 地址

非 NULL

num

unsigned char

输入 MAC 地址长度

WIFI_MAC_LEN(6)

type

unsigned char

派生类型

2:STA;
3:SoftAP;
7~10:P2P(Peer-to-Peer)。

output_mac

unsigned char*

输出 MAC 地址

非 NULL

out_put_num

unsigned char

输出 MAC 地址长度

WIFI_MAC_LEN(6)

返回值

返回值

文字含义

触发场景

ERRCODE_SUCC:0

执行成功

派生成功

Other

其他错误码,参考errcode_t

执行失败

errcode_t #

typedef uint32_t errcode_t;

声明头文件

#include "include/errcode.h"

功能说明

  • 错误码定义,ERRCODE_SUCC 为 0,ERRCODE_FAIL 为 0xFFFFFFFF。

Enumerations#

wifi_pmf_option_enum #

typedef enum {
    WIFI_MGMT_FRAME_PROTECTION_CLOSE,
    WIFI_MGMT_FRAME_PROTECTION_OPTIONAL,
    WIFI_MGMT_FRAME_PROTECTION_REQUIRED,
    WIFI_MGMT_FRAME_PROTECTION_BUTT
} wifi_pmf_option_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • PMF 管理帧保护模式类型。

使用说明

枚举成员

取值

描述

WIFI_MGMT_FRAME_PROTECTION_CLOSE

0

管理帧保护模式:关闭

WIFI_MGMT_FRAME_PROTECTION_OPTIONAL

1

管理帧保护模式:可选

WIFI_MGMT_FRAME_PROTECTION_REQUIRED

2

管理帧保护模式:必须

WIFI_MGMT_FRAME_PROTECTION_BUTT

3

枚举边界值,不可使用

wifi_if_type_enum #

typedef enum {
    IFTYPE_STA,
    IFTYPE_AP,
    IFTYPE_P2P_CLIENT,
    IFTYPE_P2P_GO,
    IFTYPE_P2P_DEVICE,
    IFTYPES_BUTT
} wifi_if_type_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • Wi-Fi 接口类型。

使用说明

枚举成员

取值

描述

IFTYPE_STA

0

STATION

IFTYPE_AP

1

HOTSPOT

IFTYPE_P2P_CLIENT

2

P2P CLIENT

IFTYPE_P2P_GO

3

P2P GO(Group Owner)

IFTYPE_P2P_DEVICE

4

P2P DEVICE

IFTYPES_BUTT

5

枚举边界值,不可使用

ie_index_enmu #

typedef enum ie_index_enmu {
    IE_FIRST,
    IE_SECOND,
    IE_THIRD,
    IE_FORTH,
    IE_BUTT
} ie_index_enmu;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • IE 索引,有四个索引可供选择。

使用说明

枚举成员

取值

描述

IE_FIRST

0

索引 1

IE_SECOND

1

索引 2

IE_THIRD

2

索引 3

IE_FORTH

3

索引 4

IE_BUTT

4

枚举边界值,不可使用

wifi_security_enum #

typedef enum wifi_security_enum {
    WIFI_SEC_TYPE_INVALID = -1,
    WIFI_SEC_TYPE_OPEN,
    WIFI_SEC_TYPE_WEP,
    WIFI_SEC_TYPE_WPA2PSK,
    WIFI_SEC_TYPE_WPA2_WPA_PSK_MIX,
    WIFI_SEC_TYPE_WPAPSK,
    WIFI_SEC_TYPE_WPA,
    WIFI_SEC_TYPE_WPA2,
    WIFI_SEC_TYPE_SAE,
    WIFI_SEC_TYPE_WPA3_WPA2_PSK_MIX,
    WIFI_SEC_TYPE_WPA3,
    WIFI_SEC_TYPE_OWE,
    WIFI_SEC_TYPE_WAPI_PSK,
    WIFI_SEC_TYPE_WAPI_CERT,
    WIFI_SEC_TYPE_WPA3_WPA2_MIX,
    WIFI_SEC_TYPE_WEP_OPEN,
    WIFI_SEC_TYPE_UNKNOWN
} wifi_security_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • Wi-Fi 安全类型枚举。

使用说明

枚举成员

取值

描述

WIFI_SEC_TYPE_INVALID

-1

无效安全类型

WIFI_SEC_TYPE_OPEN

0

Open

WIFI_SEC_TYPE_WEP

1

WEP(Wired Equivalent Privacy)

WIFI_SEC_TYPE_WPA2PSK

2

WPA2-Personal

WIFI_SEC_TYPE_WPA2_WPA_PSK_MIX

3

WPA-Personal 和 WPA2-Personal 混合

WIFI_SEC_TYPE_WPAPSK

4

WPA-Personal

WIFI_SEC_TYPE_WPA

5

WPA-Enterprise

WIFI_SEC_TYPE_WPA2

6

WPA2-Enterprise

WIFI_SEC_TYPE_SAE

7

SAE(Simultaneous Authentication of Equals)

WIFI_SEC_TYPE_WPA3_WPA2_PSK_MIX

8

WPA2-Personal 和 WPA3-Personal 混合

WIFI_SEC_TYPE_WPA3

9

WPA3-Enterprise

WIFI_SEC_TYPE_OWE

10

OWE

WIFI_SEC_TYPE_WAPI_PSK

11

WAPI(WLAN Authentication and Privacy Infrastructure)个人级

WIFI_SEC_TYPE_WAPI_CERT

12

WAPI 企业级

WIFI_SEC_TYPE_WPA3_WPA2_MIX

13

WPA2-Enterprise 和 WPA3-Enterprise 混合

WIFI_SEC_TYPE_WEP_OPEN

14

WEP-OPEN

WIFI_SEC_TYPE_UNKNOWN

15

其它认证类型

wifi_iftype_t #

typedef enum {
    WIFI_IFTYPE_UNSPECIFIED,
    WIFI_IFTYPE_ADHOC,
    WIFI_IFTYPE_STATION = 2,
    WIFI_IFTYPE_AP = 3,
    WIFI_IFTYPE_AP_VLAN,
    WIFI_IFTYPE_WDS,
    WIFI_IFTYPE_MONITOR,
    WIFI_IFTYPE_MESH_POINT = 7,
    WIFI_IFTYPE_P2P_CLIENT,
    WIFI_IFTYPE_P2P_GO,
    WIFI_IFTYPE_P2P_DEVICE,
    WIFI_IFTYPES_BUTT
} wifi_iftype_t;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • Wi-Fi 接口类型。

使用说明

枚举成员

取值

描述

WIFI_IFTYPE_UNSPECIFIED

0

UNSPECIFIED

WIFI_IFTYPE_ADHOC

1

ADHOC

WIFI_IFTYPE_STATION

2

STATION

WIFI_IFTYPE_AP

3

HOTSPOT

WIFI_IFTYPE_AP_VLAN

4

HOTSPOT VLAN

WIFI_IFTYPE_WDS

5

WDS

WIFI_IFTYPE_MONITOR

6

MONITOR

WIFI_IFTYPE_MESH_POINT

7

MESH(Mesh Network) POINT

WIFI_IFTYPE_P2P_CLIENT

8

P2P CLIENT

WIFI_IFTYPE_P2P_GO

9

P2P GO

WIFI_IFTYPE_P2P_DEVICE

10

P2P DEVICE

WIFI_IFTYPES_BUTT

11

枚举边界值,不可使用

wifi_conn_state_enum #

typedef enum {
    WIFI_DISCONNECTED,
    WIFI_CONNECTED,
    WIFI_CONNECTING,
    WIFI_CONN_STATUS_BUTT,
} wifi_conn_state_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_linked_info.h"

功能说明

  • Wi-Fi 的连接状态。

使用说明

枚举成员

取值

描述

WIFI_DISCONNECTED

0

断连

WIFI_CONNECTED

1

已连接

WIFI_CONNECTING

2

连接中

WIFI_CONN_STATUS_BUTT

3

枚举边界值,不可使用

wifi_scan_type_enum #

typedef enum {
    WIFI_BASIC_SCAN,
    WIFI_CHANNEL_SCAN,
    WIFI_SSID_SCAN,
    WIFI_SSID_PREFIX_SCAN,
    WIFI_BSSID_SCAN,
    STA_SCAN_BUTT
} wifi_scan_type_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • Wi-Fi 扫描的类型。

使用说明

枚举成员

取值

描述

WIFI_BASIC_SCAN

0

普通扫描

WIFI_CHANNEL_SCAN

1

基于指定信道的扫描

WIFI_SSID_SCAN

2

基于指定 SSID 的扫描

WIFI_SSID_PREFIX_SCAN

3

基于指定前缀 SSID 的扫描

WIFI_BSSID_SCAN

4

基于指定 BSSID 的扫描

STA_SCAN_BUTT

5

枚举边界值,不可使用

protocol_mode_enum #

typedef enum {
    WIFI_MODE_UNDEFINE,
    WIFI_MODE_11B,
    WIFI_MODE_11B_G,
    WIFI_MODE_11B_G_N,
    WIFI_MODE_11B_G_N_AX,
} protocol_mode_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • SoftAP 和 Station 接口的协议模式。

使用说明

枚举成员

取值

描述

WIFI_MODE_UNDEFINE

0

未配置

WIFI_MODE_11B

1

11b

WIFI_MODE_11B_G

2

11b/g

WIFI_MODE_11B_G_N

3

11b/g/n

WIFI_MODE_11B_G_N_AX

4

11b/g/n/ax

ip_type_stru_enum #

typedef enum {
    STATIC_IP,
    DHCP,
    UNKNOWN
} ip_type_stru_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • IP(Internet Protocol)的分配类型。

使用说明

枚举成员

取值

描述

STATIC_IP

0

静态 IP 地址

DHCP(Dynamic Host Configuration Protocol)

1

由 DHCP 动态分配的 IP 地址

UNKNOWN

2

未知的 IP 地址类型

wifi_wpa_psk_type_enum #

typedef enum {
    WIFI_WPA_PSK_NOT_USE,
} wifi_wpa_psk_type_enum;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • PSK 的类型。

使用说明

枚举成员

取值

描述

WIFI_WPA_PSK_NOT_USE

0

不用提前计算 PSK,本情况下不使用 wifi_fast_connect_stru 中的 psk

Structures#

wifi_dev_t #

typedef struct {
    uint32_t iftype;
    void *priv;
    uint32_t network_id;
    uint32_t ifname_len;
    char ifname[WIFI_IFNAME_MAX_SIZE + 1];
    char reserve[1];
} wifi_dev_t;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • WIFI_DEV 的相关参数。

成员说明

成员名称

数据类型

描述

iftype

uint32_t

IFTYPE,值参考wifi_iftype_t

priv

void*

priv

network_id

uint32_t

network_id

ifname_len

uint32_t

ifname_len

ifname

char[WIFI_IFNAME_MAX_SIZE + 1]

ifname

reserve

char[1]

保留

ip_config_stru #

typedef struct {
    uint32_t ip_address;
    uint32_t gateway;
    uint32_t dns_servers[WIFI_MAX_DNS_NUM];
    uint32_t netmask;
} ip_config_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • IPV4 的配置。

成员说明

成员名称

数据类型

描述

ip_address

uint32_t

Wi-Fi device 的 IP 地址

gateway

uint32_t

Wi-Fi device 的 Gateway

dns_servers

uint32_t[WIFI_MAX_DNS_NUM]

Wi-Fi device 的 DNS(Domain Name System)服务器地址

netmask

uint32_t

Wi-Fi device 的子网掩码

ipv6_config_stru #

typedef struct {
    uint8_t ipv6_address[WIFI_IPV6_ADDR_LEN];
    uint8_t ipv6_dns_servers[WIFI_MAX_DNS_NUM][WIFI_IPV6_DNS_LEN];
} ipv6_config_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • IPV6(Internet Protocol Version 6)的配置。

成员说明

成员名称

数据类型

描述

ipv6_address

uint8_t[WIFI_IPV6_ADDR_LEN]

IPV6 地址

ipv6_dns_servers

uint8_t[WIFI_MAX_DNS_NUM][WIFI_IPV6_DNS_LEN]

DNS 服务器地址

wifi_sta_config_stru #

typedef struct wifi_sta_config_stru {
    int8_t ssid[WIFI_MAX_SSID_LEN];
    uint8_t bssid[WIFI_MAC_LEN];
    int8_t pre_shared_key[WIFI_MAX_KEY_LEN];
    wifi_security_enum security_type;
    int8_t wifi_psk_type;
    int8_t strengthen_verify;
    uint8_t channel;
    int8_t rsv;
    ip_type_stru_enum ip_type;
    ip_config_stru static_ip;
    ipv6_config_stru static_ipv6;
} wifi_sta_config_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 连接到指定 Wi-Fi device 的 Wi-Fi STA 配置。

成员说明

成员名称

数据类型

描述

ssid

int8_t[WIFI_MAX_SSID_LEN]

SSID

bssid

uint8_t[WIFI_MAC_LEN]

BSSID

pre_shared_key

int8_t[WIFI_MAX_KEY_LEN]

预共享密钥

security_type

wifi_security_enum

安全类型

wifi_psk_type

int8_t

PSK 的类型

strengthen_verify

int8_t

加强校验,非零值表示 open 模式下需要校验密码长度是否为 0,默认为 0 不校验

channel

uint8_t

关联的指定信道号,可选参数

rsv

int8_t

保留 1 字节

ip_type

ip_type_stru_enum

IP 的分配类型

static_ip

ip_config_stru

静态 IPV4 地址

static_ipv6

ipv6_config_stru

静态 IPV6 地址

wifi_scan_params_stru #

typedef struct {
    int8_t ssid[WIFI_MAX_SSID_LEN];
    int8_t ssid_len;
    int8_t bssid[WIFI_MAC_LEN];
    int32_t channel_num;
    wifi_scan_type_enum scan_type;
} wifi_scan_params_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 扫描参数的设置。

成员说明

成员名称

数据类型

描述

ssid

int8_t[WIFI_MAX_SSID_LEN]

SSID

ssid_len

int8_t

SSID 的长度

bssid

int8_t[WIFI_MAC_LEN]

BSSID

channel_num

int32_t

信道号

scan_type

wifi_scan_type_enum

Wi-Fi 的扫描类型

wifi_scan_strategy_stru #

typedef struct {
    uint8_t scan_time;
    uint8_t scan_cnt;
    uint8_t single_probe_send_times;
    uint8_t reserved;
} wifi_scan_strategy_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 扫描策略设置。

成员说明

成员名称

数据类型

描述

scan_time

uint8_t

每个信道停留时间,单位 ms,范围 20~120ms,默认 20ms,扫描总时间不能超过 4.5s

scan_cnt

uint8_t

扫描 slot 数,一个 slot 20ms

single_probe_send_times

uint8_t

单个 probe req 报文的发送次数,范围 1~3,默认 1

reserved

uint8_t

保留

csi_config_stru #

typedef struct {
    uint8_t user_index;
    uint8_t enable;
    uint8_t match_ta_ra_select;
    uint8_t resv;
    uint8_t mac_addr[WIFI_MAC_LEN];
    uint8_t frame_filter_bitmap;
    uint8_t sub_type_filter_enable;
    uint8_t sub_type_filter;
    uint8_t ppdu_filter_bitmap;
    uint16_t period;
} csi_config_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • CSI 的配置。

成员说明

成员名称

数据类型

描述

user_index

uint8_t

用户 ID,取值范围 0~3,最多 4 个用户

enable

uint8_t

CSI 白名单用户开关

match_ta_ra_select

uint8_t

CSI 白名单地址过滤类型,0:RA / 1:TA。

resv

uint8_t

保留 1 字节对齐

mac_addr

uint8_t[WIFI_MAC_LEN]

MAC 地址

frame_filter_bitmap

uint8_t

帧类型过滤具体参数

sub_type_filter_enable

uint8_t

帧子类型过滤开关

sub_type_filter

uint8_t

帧子类型过滤具体参数

ppdu_filter_bitmap

uint8_t

PPDU format 过滤具体参数

period

uint16_t

CSI 上报时间间隔

wifi_fast_connect_stru #

typedef struct wifi_fast_connect_stru {
    wifi_sta_config_stru config;
    uint8_t psk[WIFI_PSK_LEN];
    wifi_wpa_psk_type_enum psk_flag;
    uint8_t channel_num;
} wifi_fast_connect_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 快速连接的参数设置。

成员说明

成员名称

数据类型

描述

config

wifi_sta_config_stru

连接到指定 Wi-Fi device 的 Wi-Fi STA 配置

psk

uint8_t[WIFI_PSK_LEN]

PSK

psk_flag

wifi_wpa_psk_type_enum

PSK 的标志,不需指定时置 0

channel_num

uint8_t

信道号

wifi_ptype_filter_stru #

typedef struct {
    int8_t mdata_en  : 1;
    int8_t udata_en  : 1;
    int8_t mmngt_en  : 1;
    int8_t umngt_en  : 1;
    int8_t custom_en : 1;
    int8_t resvd     : 3;
} wifi_ptype_filter_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 混杂模式报文接收过滤设置。

成员说明

成员名称

数据类型

描述

mdata_en

int8_t:1

使能接收组播(广播)数据包

udata_en

int8_t:1

使能接收单播数据包

mmngt_en

int8_t:1

使能接收组播(广播)管理包

umngt_en

int8_t:1

使能接收单播管理包

custom_en

int8_t:1

使能接收 beacon/probe request 包

resvd

int8_t:3

保留字段

linkloss_paras_stru #

typedef struct {
    uint16_t linkloss_threshold;
    uint8_t send_probe_request_ratio;
    uint8_t resv[1];
} linkloss_paras_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 设置 linkloss 相关参数。

成员说明

成员名称

数据类型

描述

linkloss_threshold

uint16_t

取值范围[50, 500],设置为 n 时,表示 linkloss 阈值基础时间为(100*n)ms

send_probe_request_ratio

uint8_t

取值范围[1, 10],设置为 n 时,表示 linkloss 计数达到阈值的(n/10)时,开始发送探测帧保活

resv

uint8_t[1]

保留

ext_psd_option_param #

typedef struct {
    uint8_t enable;
    uint8_t resv;
    uint16_t duration;
    uint32_t cycle;
} ext_psd_option_param;

声明头文件

#include "include/middleware/services/wifi/wifi_device_config.h"

功能说明

  • 设置 PSD 状态。

成员说明

成员名称

数据类型

描述

enable

uint8_t

PSD 使能标记,0:关 / 1:开。

resv

uint8_t

保留

duration

uint16_t

采样时长,取值 1~65535,单位 min

cycle

uint32_t

采样间隔,单位 ms,取值 100~1000

wifi_linked_info_stru #

typedef struct {
    int8_t ssid[WIFI_MAX_SSID_LEN];
    uint8_t bssid[WIFI_MAC_LEN];
    int8_t wpa_state;
    int32_t rssi;
    int32_t channel_num;
    int32_t snr;
    wifi_conn_state_enum conn_state;
} wifi_linked_info_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_linked_info.h"

功能说明

  • 有关连接到此 STA 的 AP 信息。

成员说明

成员名称

数据类型

描述

ssid

int8_t[WIFI_MAX_SSID_LEN]

SSID

bssid

uint8_t[WIFI_MAC_LEN]

BSSID

wpa_state

int8_t

断连时 WPA(Wi-Fi Protected Access)状态

rssi

int32_t

RSSI

channel_num

int32_t

AP 的 Wi-Fi 信道信息

snr

int32_t

AP 的 Wi-Fi 信噪比信息

conn_state

wifi_conn_state_enum

Wi-Fi 的连接状态

wifi_scan_info_stru #

typedef struct {
    char ssid[WIFI_MAX_SSID_LEN];
    uint8_t bssid[WIFI_MAC_LEN];
    int8_t reserved;
    wifi_security_enum security_type;
    int32_t rssi;
    int32_t band;
    int32_t channel_num;
} wifi_scan_info_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_scan_info.h"

功能说明

  • Wi-Fi 扫描结果信息。

成员说明

成员名称

数据类型

描述

ssid

char[WIFI_MAX_SSID_LEN]

SSID

bssid

uint8_t[WIFI_MAC_LEN]

BSSID

reserved

int8_t

保留字段

security_type

wifi_security_enum

安全类型

rssi

int32_t

信号强度

band

int32_t

频带

channel_num

int32_t

信道号

wifi_event_stru #

typedef struct {
    void (*wifi_event_connection_changed)(int32_t state, const wifi_linked_info_stru *info, int32_t reason_code);
    void (*wifi_event_scan_state_changed)(int32_t state, int32_t size);
    void (*wifi_event_softap_state_changed)(int32_t state);
    void (*wifi_event_softap_sta_join)(const wifi_sta_info_stru *info);
    void (*wifi_event_softap_sta_leave)(const wifi_sta_info_stru *info);
    void (*wifi_event_p2p_receive_connect)(const uint8_t *bssid, int8_t wps_method);
    void (*wifi_event_p2p_go_neg_result)(int32_t state, int32_t mode);
    void (*wifi_event_p2p_go_start)(int32_t state);
    void (*wifi_event_p2p_invitation_result)(int32_t state);
    void (*wifi_event_p2p_gc_connection_changed)(int32_t state, const p2p_status_info_stru *status);
    void (*wifi_event_p2p_go_connection_changed)(int32_t state, const p2p_client_info_stru *client);
    void (*wifi_event_wps_result)(int32_t state, wifi_if_type_enum wifi_if_type);
} wifi_event_stru;

声明头文件

#include "include/middleware/services/wifi/wifi_event.h"

功能说明

  • 指向用于 STA 和 Hotspot 连接、断开连接或扫描的 Wi-Fi 事件回调的指针。

成员说明

成员名称

数据类型

描述

wifi_event_connection_changed

void(*)(int32_t, const wifi_linked_info_stru*, int32_t)

连接状态改变回调

wifi_event_scan_state_changed

void(*)(int32_t, int32_t)

扫描状态改变回调

wifi_event_softap_state_changed

void(*)(int32_t)

Hotspot 状态改变回调

wifi_event_softap_sta_join

void(*)(const wifi_sta_info_stru*)

Station 连接回调

wifi_event_softap_sta_leave

void(*)(const wifi_sta_info_stru*)

Station 断连回调

wifi_event_p2p_receive_connect

void(*)(const uint8_t*, int8_t)

P2P 接收连接请求回调

wifi_event_p2p_go_neg_result

void(*)(int32_t, int32_t)

P2P GO 协商结果回调

wifi_event_p2p_go_start

void(*)(int32_t)

P2P GO 建立结果回调

wifi_event_p2p_invitation_result

void(*)(int32_t)

P2P 邀请结果回调

wifi_event_p2p_gc_connection_changed

void(*)(int32_t, const p2p_status_info_stru*)

P2P GC(Group Client)关联结果回调

wifi_event_p2p_go_connection_changed

void(*)(int32_t, const p2p_client_info_stru*)

P2P GO 关联结果回调

wifi_event_wps_result

void(*)(int32_t, wifi_if_type_enum)

WPS 关联结果回调

wifi_sta_info_stru #

typedef struct {
    uint8_t mac_addr[WIFI_MAC_LEN];
    int8_t rssi;
    int8_t rsv;
    uint32_t best_rate;
} wifi_sta_info_stru;

声明头文件

#include "include/middleware/services/wifi/station_info.h"

功能说明

  • 返回与 AP 相连的 STA 信息。

成员说明

成员名称

数据类型

描述

mac_addr

uint8_t[WIFI_MAC_LEN]

MAC 地址

rssi

int8_t

RSSI

rsv

int8_t

保留字段

best_rate

uint32_t

SoftAP 上一次接收相连的 Station 报文最佳发送速率值(kbps)