Algorithm

Algorithm（ALG）提供 Wi-Fi 算法配置能力，包括固定速率设置、协商速率查询、TPC（Transmit Power Control）模式配置、RTS（Request To Send）模式配置、CCA（Clear Channel Assessment）门限设置及抗干扰模式配置。

模块公共头文件

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

接口清单

接口名称	功能简述
wifi_set_fixed_tx_rate	设置 TX 方向发送报文的速率模式
wifi_get_negotiated_rate	获取用户当前的最优速率
wifi_set_tpc_mode	设置 TPC 模式
wifi_set_rts_mode	设置 RTS 模式
wifi_set_cca_threshold	设置 CCA 门限
wifi_set_intrf_mode	设置抗干扰模式

Functions

wifi_set_fixed_tx_rate

errcode_t wifi_set_fixed_tx_rate(unsigned char auto_rate, alg_param_stru *alg_param)

声明头文件

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

功能说明

设置 TX 方向发送报文的速率模式，可选择固定速率或自动速率。

前置条件

Wi-Fi 已初始化并启动。

入参

名称	参数类型	说明	约束取值范围
auto_rate	unsigned char	速率模式选择，0 表示固定速率，非 0 表示自动速率	-
alg_param	alg_param_stru *	速率参数结构体指针，包含固定速率值	非 NULL

返回值

返回值	文字含义	触发场景
ERRCODE_SUCC	0	成功
ERROR_WIFI_NOT_STARTED	-7	Wi-Fi 未初始化或未启动
ERROR_WIFI_INVALID_ARGS	-1	参数无效（alg_param 为 NULL）
ERROR_WIFI_UNKNOWN	-128	未知错误（底层设置失败）

参考案例

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

wifi_get_negotiated_rate

errcode_t wifi_get_negotiated_rate(const uint8_t *mac, int32_t mac_len, uint32_t *tx_best_rate)

声明头文件

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

功能说明

获取指定用户当前协商的最优速率。

前置条件

Wi-Fi 已初始化并启动。

入参

名称	参数类型	说明	约束取值范围
mac	const uint8_t *	用户的 MAC 地址	非 NULL
mac_len	int32_t	MAC 地址长度	-
tx_best_rate	uint32_t *	获取的用户最佳速率输出缓冲区	非 NULL

出参

名称	数据类型	输出说明
tx_best_rate	uint32_t *	用户当前协商的最优速率值

返回值

返回值	文字含义	触发场景
ERRCODE_SUCC	0	成功
ERROR_WIFI_NOT_STARTED	-7	Wi-Fi 未初始化或未启动
ERROR_WIFI_INVALID_ARGS	-1	参数无效（mac 为 NULL）
ERROR_WIFI_UNKNOWN	-128	未知错误（底层查询失败）

参考案例

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

wifi_set_tpc_mode

errcode_t wifi_set_tpc_mode(uint32_t tpc_value)

声明头文件

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

功能说明

设置 TPC 模式，用于控制发射功率的动态调整策略。

前置条件

Wi-Fi 已初始化并启动。

入参

名称	参数类型	说明	约束取值范围
tpc_value	uint32_t	TPC 模式值：0-关闭动态调整，1-功率提升模式，2-自动调整模式	0~2

返回值

返回值	文字含义	触发场景
ERRCODE_SUCC	0	成功
ERROR_WIFI_NOT_STARTED	-7	Wi-Fi 未初始化或未启动
ERROR_WIFI_UNKNOWN	-128	未知错误（底层设置失败）

参考案例

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

wifi_set_rts_mode

errcode_t wifi_set_rts_mode(uint8_t mode, uint16_t pkt_length)

声明头文件

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

功能说明

设置 RTS 模式，控制发送报文时是否使用 RTS/CTS 握手机制。

前置条件

Wi-Fi 已初始化并启动。

入参

名称	参数类型	说明	约束取值范围
mode	uint8_t	RTS 模式：0-自动模式，1-超过配置报文长度发送 RTS 未超过不发，2-不发 RTS	0~2
pkt_length	uint16_t	RTS 模式为 1 时配置的 RTS 报文长度门限（字节）	mode 为 1 时有效

返回值

返回值	文字含义	触发场景
ERRCODE_SUCC	0	成功
ERROR_WIFI_NOT_STARTED	-7	Wi-Fi 未初始化或未启动
ERROR_WIFI_UNKNOWN	-128	未知错误（底层设置失败）

参考案例

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

wifi_set_cca_threshold

errcode_t wifi_set_cca_threshold(uint8_t mode, int8_t threshold)

声明头文件

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

功能说明

设置 CCA 门限值，用于信道空闲检测的判定阈值。

前置条件

Wi-Fi 已初始化并启动。

入参

名称	参数类型	说明	约束取值范围
mode	uint8_t	带宽模式：0-20M，1-40M	0~1
threshold	int8_t	CCA 门限值	-

返回值

返回值	文字含义	触发场景
ERRCODE_SUCC	0	成功
ERROR_WIFI_NOT_STARTED	-7	Wi-Fi 未初始化或未启动
ERROR_WIFI_UNKNOWN	-128	未知错误（底层设置失败）

参考案例

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

wifi_set_intrf_mode

errcode_t wifi_set_intrf_mode(const char *ifname, uint8_t enable, uint16_t flag)

声明头文件

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

功能说明

设置抗干扰模式，配置干扰检测与规避策略的使能及措施标志。

前置条件

Wi-Fi 已初始化并启动。
宏 _PRE_WLAN_FEATURE_INTRF_MODE 已在构建配置中使能。

入参

名称	参数类型	说明	约束取值范围
ifname	const char *	设备名	非 NULL
enable	uint8_t	是否使能抗干扰模式	0 或 1
flag	uint16_t	抗干扰措施使能 bit 配置	-

返回值

返回值	文字含义	触发场景
ERRCODE_SUCC	0	成功
ERROR_WIFI_NOT_STARTED	-7	Wi-Fi 未初始化或未启动
ERROR_WIFI_INVALID_ARGS	-1	参数无效（ifname 为 NULL）
ERROR_WIFI_UNKNOWN	-128	未知错误（底层设置失败）

Kconfig配置

配置项	宏类型	说明	默认值
_PRE_WLAN_FEATURE_INTRF_MODE	特性宏	使能抗干扰模式功能	由构建目标决定

参考案例

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

Structures

alg_param_stru

typedef struct {
    uint32_t rate_value;    /*!< 固定速率值。 */
} alg_param_stru;

成员说明

成员名称	数据类型	描述
rate_value	uint32_t	固定速率值