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"
接口清单#
接口名称 |
功能简述 |
|---|---|
设置 TX 方向发送报文的速率模式 |
|
获取用户当前的最优速率 |
|
设置 TPC 模式 |
|
设置 RTS 模式 |
|
设置 CCA 门限 |
|
设置抗干扰模式 |
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 |
速率参数结构体指针,包含固定速率值 |
非 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 |
固定速率值 |