wifi-iface

Name	Type	Required	Default	Description
ampdu	Boolean	No	No	Enable/disable Tx AMPDU aggregation for the entire interface.
amsdu	Boolean	No	No	Sets maximum number of AMSDU subframes.
ani_enable	Integer	No	No	Enables/Disables ANI.
ant_ps_on	Boolean	No	（driver default)	Enables (1) or disables (0) Green AP power save logic. The default value is 1.
bintval	Integer	No	No	Sets the AP beacon interval (in ms).
blockdfschan	Integer	No	No	Block the DFS channel in the selection process.
bssid	BSSID address	No	(driver default)	Override the BSSID of the network, only applicable in adhoc or STA mode. In the WDS mode, specifies the BSSID of another AP to create WDS with.
chwidth	Integer	No	(driver default)	Sets the Channel Width field in the AP beacon High Throughput Information Element (HT IE). If this command is not executed, then the channel width is taken from the device settings. The get parameter returns the current value. The default value is 0. Sets the current channel width setting. Not necessarily the value set by cwmode, because it can be automatically overridden
dbgLVL	Hexadecimal	No	(driver default)	Controls the debug level of the VAP-based debug print statements. It is normally set to zero, eliminating all prints
device	String	Yes	(first device id)	Specifies the used wireless adapter, must refer to one of the defined wifi- device sections.
doth	Boolean	No	0	Enables 802.11h support.
dtim_period	Integer	No	2 (hostapd default)	Set the DTIM (delivery traffic information message) period. There is one DTIM per this many beacon frames. This value may be set between 1 and 255. This option only has an effect on AP wifi-ifaces.
extprotmode	bool	No	(driver default)	Sets the protection mode used on the extension (secondary) channel when using 40 MHz channels. The default is 0. The get parameter returns the current value.
hidden	Boolean	No	0	Turns off SSID broadcasting if set to 1.
ieee80211w	Integer	No	0	Enables MFP (802.11w) support (0 = disabled, 1 = optional, 2 = required).
ieee80211w_m ax_timeout	Integer	No	(hostapd default)	Specifies the 802.11w association SA query maximum timeout.
ieee80211w_r etry_timeout	Integer	No	(hostapd default)	Specifies the 802.11w association SA query retry timeout.
isolate	Boolean	No	0	Isolate wireless clients from each other, only applicable in AP mode.
key	Integer/ String	No	(None)	In any WPA-PSK mode, this is a string that specifies the preshared passphrase from which the preshared key will be derived. If a 64-character hexadecimal string is supplied, it is used directly as the preshared key instead. In WEP mode, this can be an integer specifying which key index to use (key1, key2, key3, orkey4.) Alternatively, it can be a string specifying a passphrase or key directly, as in key1. In any WPA-Enterprise AP mode, this option has a different interpretation.
key1	String	No	(None)	WEP passphrase or key # 1 (selected by the index in key). This string is treated as a passphrase from which the WEP key is derived. If a 10-character or 26-character hexadecimal string is supplied, it is used directly as the WEP key instead
key2	String	No	(None)	WEP passphrase or key # 2 (selected by the index in key), as in key1.
key3	String	No	(None)	WEP passphrase or key # 3 (selected by the index in key), as in key1.
key4	String	No	(None)	WEP passphrase or key # 4 (selected by the index in key), as in key1.
macfilter	String	No	disable	Specifies the MAC filter policy, disable to disable the filter, allow to treat it as whitelist or deny treating it as blacklist.
maclist	List of MAC addresses	No	(None)	List of MAC addresses (divided by spaces) to put into the MAC filter
maxampdu	Integer	No	No	Maximum AMPDU length exponent.
mcast_rate	Integer	No	(driver default)	Sets the fixed multicast rate, in Kbps
mcastenhance	int	No	(driver default)	Set multicast enhancement mode. ▪ 0 Enabled True multicast packet is sent if any interested member is present. ▪ 1 Enabled Tunnelled unicast packet is sent to interested members. ▪ 2 Enabled Translated unicast packet is sent to interested members. ▪ 4-F Enabled Disabled (set bit 2 = 1)
metimeout	int	No	(driver default)	Sets timeout in ms for STA to be removed from the snoop table if idle. The param value may be any unsigned integer value. The default is 120000 (2 minutes). The get parameter returns the current value.
metimer	int	No	(driver default)	Sets timer in ms to check snoop table status. The timer value may be any unsigned integer. The default is 30000 (30 sec). The get parameter returns the current value.
mode	String	Yes	ap	Selects operation mode of the wireless network interface controller (some are supported simultaneously by some drivers): ▪ ap for Access Point ▪ sta for managed (client) mode ▪ adhoc for Ad hoc ▪ wds for static WDS monitor for monitor mode
network	String	Yes	lan	Specifies the network interface to attach the wireless to.
protmode	bool	No	(driver default)	Enables or disables 802.11g protection mode. Causes the RTS/CTS sequence (or CTS to self) to be sent when 802.11b devices are detected on the 802.11g network. Used to protect against Tx by devices that do not recognize OFDM modulated frames. The default is 0. The get parameter returns the current value.
ps_timeout	int	No	(driver default)	Sets the transition time in seconds between power save off to power save on mode. The default value is 20
retrydur	int	No	(driver default)	Sets the retry threshold in 1 s. Feature is disabled if set to 0.
rsn_preauth	Boolean	No	0	Allow pre-authentication for WPA2- EAP networks (and advertise it in WLAN beacons). Only works if the specified network interface is a bridge.
rx_stbc tx_stbc	bool	No	(driver default)	Enables (1) or disables (0) the Space Time Coding Block (STBC) feature, as described in the 802.11n specification, in the transmit (txstbc) or receive (rxtsbc) direction. The default value is 1. This option has an effect only on chips supporting STBC. On other chips, this option has no effect
ssid	String	Yes	OpenWrt	The broadcasted SSID of the wireless network (for managed mode the SSID of the network to connect to).
vhtmaxampdu	Integer	No	No	VHT maximum AMPDU length exponent.
wds	Boolean	No	0	This sets the 4-address mode
wmm	Boolean	No	1	Enables WMM (802.11e) support; required for the 802.11n support.
encryption	String	No	None	Wireless encryption method. The values are none for an open network, wep for WEP, psk for WPA-PSK, or psk2 for WPA2- PSK. See WPA modes in section 6.2.3 for additional possible values. For an access point in WEP mode, the default is “open system” authentication. Use wep+shared for “shared key” authentication (less secure), wep+open to explicitly use “open system,” or wep+mixed to allow either. wep+mixed is supported only by hostapd.

rts_fixed_rate
mgmt_rate

标准	MCS Index	调制方式	编码率	Rate Code
802.11a	MCS0	BPSK	1/2	`0x0B`
802.11a	MCS1	BPSK	3/4	`0x0F`
802.11a	MCS2	QPSK	1/2	`0x0A`
802.11a	MCS3	QPSK	3/4	`0x0E`
802.11a	MCS4	16-QAM	1/2	`0x09`
802.11a	MCS5	16-QAM	3/4	`0x0D`
802.11a	MCS6	64-QAM	2/3	`0x08`
802.11a	MCS7	64-QAM	3/4	`0x0C`
802.11n/ac/ax	MCS0	BPSK	1/2	`0x80`
802.11n/ac/ax	MCS1	QPSK	1/2	`0x81`
802.11n/ac/ax	MCS2	QPSK	3/4	`0x82`
802.11n/ac/ax	MCS3	16-QAM	1/2	`0x83`
802.11n/ac/ax	MCS4	16-QAM	3/4	`0x84`
802.11n/ac/ax	MCS5	64-QAM	2/3	`0x85`
802.11n/ac/ax	MCS6	64-QAM	3/4	`0x86`
802.11n/ac/ax	MCS7	64-QAM	5/6	`0x87`

tx_chain_mask: 发送链掩码。指定物理上哪些天线（或射频链）用于发送数据。例如，0x5 (二进制 0101) 表示使用链 0 和链 2。
rx_chain_mask: 接收链掩码。指定物理上哪些天线（或射频链）用于接收数据。
txpower_limit2g: 2.4GHz 频段的最大发射功率限制（通常单位是 dBm 或 0.5 dBm 步进，具体看固件定义）。
txpower_limit5g: 5GHz 频段的最大发射功率限制。
txpower_scale: 发射功率缩放因子/类型。可能用于不同的功率回退策略或百分比调整。
beacon_gen_mode: Beacon 生成模式。决定 Beacon 帧是由主机 CPU 生成还是由 Wi-Fi 固件/硬件生成。
beacon_tx_mode: Beacon 发送模式。可能涉及 Beacon 如何调度和发送，例如是否使用 STBC (Space-Time Block Coding) 等。
resmgr_offchan_mode: 资源管理器的离信道 (off-channel) 模式。用于管理当设备需要扫描或操作在非当前服务信道时的行为。
protection_mode: 保护模式。例如，在 802.11g 网络中与 802.11b 设备共存时，启用 RTS/CTS 或 CTS-to-self 保护机制。
dynamic_bw: 动态带宽。允许设备根据信道条件动态调整使用的带宽 (20MHz, 40MHz, 80MHz, 160MHz)。
non_agg_sw_retry_th: 非聚合帧软件重传阈值。单个 MSDU (MAC Service Data Unit) 软件层面重传的最大次数。
agg_sw_retry_th: 聚合帧软件重传阈值。A-MPDU (Aggregated MAC Protocol Data Unit) 软件层面重传的最大次数。
sta_kickout_th: STA (Station, 客户端) 踢出阈值。通常基于不活动时间或过多失败的尝试。
ac_aggrsize_scaling: 基于 AC (Access Category, 接入类别) 的聚合大小缩放。允许为不同优先级的流量（如语音、视频、尽力而为、背景）设置不同的聚合帧大小。
ltr_enable: 启用 LTR (Latency Tolerance Reporting)。一种 PCIe 电源管理特性，设备向主机报告其延迟容忍度。
ltr_ac_latency_be: LTR AC 延迟 - Best Effort (尽力而为)。BE 队列的延迟容忍值。
ltr_ac_latency_bk: LTR AC 延迟 - Background (背景)。BK 队列的延迟容忍值。
ltr_ac_latency_vi: LTR AC 延迟 - Video (视频)。VI 队列的延迟容忍值。
ltr_ac_latency_vo: LTR AC 延迟 - Voice (语音)。VO 队列的延迟容忍值。
ltr_ac_latency_timeout: LTR AC 延迟超时。
ltr_sleep_override: LTR 睡眠覆盖。
ltr_rx_override: LTR 接收覆盖。
ltr_tx_activity_timeout: LTR 发送活动超时。在没有发送活动多长时间后，LTR 机制可以进入更深睡眠状态。
l1ss_enable: 启用 L1 Substates (PCIe 电源管理特性)。允许 PCIe 链路进入更低功耗状态。
dsleep_enable: 启用深度睡眠 (Deep Sleep) 模式。一种更深层次的 Wi-Fi 芯片节能模式。
pcielp_txbuf_flush: PCIe 低功耗 (Low Power) 时发送缓冲区刷新。
pcielp_txbuf_watermark: PCIe 低功耗时发送缓冲区水印。
pcielp_txbuf_tmo_en: 启用 PCIe 低功耗时发送缓冲区超时。
pcielp_txbuf_tmo_value: PCIe 低功耗时发送缓冲区超时值。
pdev_stats_update_period: 物理设备统计信息更新周期 (ms)。固件向主机报告 pdev 相关统计数据的频率。
vdev_stats_update_period: 虚拟设备 (VDEV, Virtual Device - 例如一个 AP 或 STA 接口) 统计信息更新周期。
peer_stats_update_period: 对端 (Peer, 已连接的 STA) 统计信息更新周期。
bcnflt_stats_update_period: Beacon 过滤统计信息更新周期。
pmf_qos: PMF (Protected Management Frames, 802.11w) 的 QoS 设置。可能用于指示 PMF 帧使用哪个 AC。
arp_ac_override: ARP (Address Resolution Protocol) 帧的 AC (Access Category) 覆盖。允许将 ARP 帧映射到特定的 QoS 队列。
dcs: 启用/配置 DCS (Dynamic Channel Selection) 动态信道选择或干扰检测机制。0 = 关闭, 1 = 启用某种模式。
ani_enable: 启用 ANI (Adaptive Noise Immunity) 自适应噪声抗扰。根据环境噪声自动调整接收机参数。
ani_poll_period: ANI 轮询周期 (ms)。ANI 算法检查噪声水平的频率。
ani_listen_period: ANI 监听周期 (ms)。ANI 算法在一个周期内监听信道的时间。
ani_ofdm_level: ANI OFDM (Orthogonal Frequency-Division Multiplexing) 信号的抗扰级别。
ani_cck_level: ANI CCK (Complementary Code Keying) 信号的抗扰级别。
dyntxchain: 动态发送链管理。允许根据条件（如低功耗、干扰）动态改变使用的发送链数量。
proxy_sta: 代理 STA 模式。AP 代表休眠的 STA 回应某些网络请求（如 ARP），以延长 STA 的电池寿命。
idle_ps_config: 空闲节能配置。配置当设备空闲时的节能行为。
power_gating_sleep: 电源门控睡眠。更激进的节能措施，关闭芯片中未使用部分的电源。
fast_channel_reset: 快速信道重置。可能用于快速从干扰或错误中恢复。
burst_dur: 突发持续时间 (us)。配置 TXOP (Transmission Opportunity) 或帧突发的最大持续时间。
burst_enable: 启用帧突发。允许在一个 TXOP 内发送多个帧。
cal_period: 校准周期。无线电硬件定期校准的周期。
aggr_burst: 聚合突发。与聚合帧发送相关的突发参数。
rx_decap_mode: 接收解封装模式。指定固件如何处理接收到的聚合帧（如 A-MSDU, A-MPDU）并将其解封装。
smart_antenna_default_antenna: 智能天线默认天线选择。
igmpmld_override: IGMP/MLD (Internet Group Management Protocol / Multicast Listener Discovery) 覆盖。用于组播增强功能。
igmpmld_tid: IGMP/MLD 帧使用的 TID (Traffic Identifier)。
antenna_gain: 天线增益 (通常是 dBi)。
rx_filter: 接收过滤器设置。用于配置固件应传递给主机的帧类型（例如，只传数据帧，或也传管理帧、控制帧）。
set_mcast_to_ucast_tid: 将组播转换为单播时使用的 TID。
proxy_sta_mode: Proxy STA 的具体工作模式。
set_mcast2ucast_mode: 组播到单播转换的模式。
set_mcast2ucast_buffer: 组播到单播转换使用的缓冲区大小。
remove_mcast2ucast_buffer: 移除组播到单播转换缓冲区。
peer_sta_ps_statechg_enable: 启用对端 STA 节能状态改变通知。
igmpmld_ac_override: IGMP/MLD 帧的 AC (Access Category) 覆盖。
block_interbss: 阻止 Inter-BSS (基本服务集之间) 流量。防止 AP 转发来自一个 BSS 到另一个 BSS 的流量。
set_disable_reset_cmdid: 设置禁用复位命令的 ID。特定 WMI 命令的 ID。
set_msdu_ttl_cmdid: 设置 MSDU 生存时间 (Time-To-Live) 命令的 ID。
set_ppdu_duration_cmdid: 设置 PPDU (Physical Layer Protocol Data Unit) 持续时间命令的 ID。
txbf_sound_period_cmdid: 发送波束成形 (Tx Beamforming) 探测帧周期命令的 ID。
set_promisc_mode_cmdid: 设置混杂模式命令的 ID。
set_burst_mode_cmdid: 设置突发模式命令的 ID。
en_stats: 启用统计信息收集。
mu_group_policy: MU-MIMO (Multi-User Multiple-Input, Multiple-Output) 分组策略。
noise_detection: 噪声检测启用/禁用。
noise_threshold: 噪声检测阈值。
dpd_enable: 启用 DPD (Digital Pre-Distortion) 数字预失真。一种改善功放线性度，提高信号质量和效率的技术。
set_mcast_bcast_echo: 设置组播/广播回显。AP 是否将自己发送的组播/广播帧回传给发送接口。
atf_strict_sch: ATF (Airtime Fairness) 严格调度。确保每个客户端获得公平的空口时间。
atf_sched_duration: ATF 调度持续时间。
ant_plzn: 天线极化 (Antenna Polarization) 设置。
mgmt_retry_limit: 管理帧重传限制。
sensitivity_level: 接收灵敏度级别。调整接收机检测微弱信号的能力。
signed_txpower_2g: 带符号的 2.4GHz 发射功率。可能用于支持负值调整或更精细的控制。
signed_txpower_5g: 带符号的 5GHz 发射功率。
enable_per_tid_amsdu: 启用基于 TID 的 A-MSDU (Aggregated MAC Service Data Unit)。
enable_per_tid_ampdu: 启用基于 TID 的 A-MPDU (Aggregated MAC Protocol Data Unit)。
cca_threshold: CCA (Clear Channel Assessment) 门限。无线设备决定信道是否空闲的能量检测阈值。
rts_fixed_rate: RTS (Request To Send) 帧使用的固定速率。
pdev_reset: 触发物理设备复位。
wapi_mbssid_offset: WAPI (WLAN Authentication and Privacy Infrastructure) 在 MBSSID (Multiple BSSID) 场景下的偏移量。
arp_srcaddr: 用于某些 ARP 响应的源 IP 地址 (低 32 位，如果需要整个地址可能还需要其他参数)。
arp_dstaddr: ARP 目标 IP 地址。

Contents