1. 概述
rtw_proc.c 是 Realtek WiFi 驱动的 procfs 调试/查询接口注册表。通过读取（或写入）proc 节点，可获取驱动版本、硬件能力、连接状态、协议特性、射频/功率、统计信息等。
1.1 挂载路径
| 层级 |
路径 |
说明 |
| 驱动级 |
/proc/net/rtl8733bu/ |
驱动全局信息 |
| 网卡级 |
/proc/net/rtl8733bu/wlan0/ |
主 STA 接口 |
| 网卡级 |
/proc/net/rtl8733bu/p2p0/ |
P2P 虚拟接口（并发模式） |
| PHYDM 子目录 |
/proc/net/rtl8733bu/wlan0/odm/ |
数字 PHY 算法调试 |
| MCC 子目录 |
/proc/net/rtl8733bu/wlan0/mcc/ |
多信道并发（需 CONFIG_MCC_MODE） |
1.2 访问方式
# 只读
cat /proc/net/rtl8733bu/wlan0/hal_spec
# 读写（部分节点支持写入配置）
echo "value" > /proc/net/rtl8733bu/wlan0/bw_mode
1.3 节点类型说明
| 标记 |
含义 |
| R |
只读（proc_get_*） |
| RW |
可读可写（proc_get_* + proc_set_*） |
| W |
只写（测试/触发类） |
| 条件 |
依赖 CONFIG_* 宏，未开启则不编译 |
2. 驱动级节点（/proc/net/rtl8733bu/）
注册于 drv_proc_hdls[]。
| 节点 |
类型 |
可获取的 Feature / 信息 |
ver_info |
R |
驱动版本、编译日期、Git 信息 |
log_level |
RW |
驱动日志级别 |
drv_cfg |
R |
驱动编译配置摘要 |
mstat |
R |
内存分配统计（需 DBG_MEM_ALLOC） |
country_chplan_map |
R |
国家码与信道规划映射表 |
chplan_id_list |
R |
支持的信道规划 ID 列表 |
chplan_test |
R |
信道规划测试（需 CONFIG_RTW_DEBUG） |
chplan_ver |
R |
信道规划数据库版本 |
global_op_class |
R |
802.11 全局 Operating Class 定义 |
hw_rate_map_test |
R |
硬件速率映射测试（需 CONFIG_RTW_DEBUG） |
halmac_info |
R |
HALMAC 框架信息（8733B 已启用 RTW_HALMAC） |
3. 网卡级节点（/proc/net/rtl8733bu/<iface>/）
注册于 adapter_proc_hdls[]。以下按 Feature 类别 分组。
3.1 硬件能力与芯片规格（★ 查能力首选）
| 节点 |
类型 |
可获取的 Feature |
hal_spec |
R |
芯片硬件规格总览 ：macid_num、RF 路径数、TX/RX NSS、band_cap（2G/5G）、bw_cap（频宽能力：20M/40M/80M 等） 、proto_cap（b/g/n/ac）、wl_func（P2P/Miracast/TDLS）、安全能力、TX GI 等 |
tx_rate_bmp |
R |
各频宽 下支持的 CCK/OFDM/HT/VHT 速率位图（通过 hal_is_bw_support() 过滤） |
phy_cap |
R |
PHY 层能力：STBC、LDPC、Beamforming（SU/MU）等 |
rx_stbc / stbc_cap |
RW |
STBC 接收开关 / 驱动 STBC 能力配置 |
ldpc_cap |
RW |
LDPC 能力配置 |
txbf_cap |
RW |
Tx Beamforming 能力（需 CONFIG_BEAMFORMING） |
hal_trx_mode |
R |
HAL 收发模式 |
efuse_map |
R |
eFuse 映射内容 |
fw_info |
R |
固件版本与状态 |
mac_addr |
R |
当前 MAC 地址 |
skip_band |
RW |
跳过某频段（2G/5G） |
wifi_spec |
R |
WiFi 规格标志（registry wifi_spec） |
hal_spec 关键字段（RTL8733BU 典型值）
band_cap: 2G 5G
bw_cap: 20M 40M ← 硬件频宽上限
proto_cap: b g n ← 8733B 驱动初始化未开 ac
tx_nss_num / rx_nss_num: 1 ← 1x1
wl_func: P2P MIRACAST TDLS
底层字段定义见 include/hal_data.h → struct hal_spec_t，打印逻辑见 hal/hal_com.c → dump_hal_spec()。
3.2 协议与频宽（802.11n/ac、HT/VHT）
| 节点 |
类型 |
可获取的 Feature |
ht_option |
R |
HT（802.11n）是否启用 |
ht_enable |
RW |
HT 开关 |
bw_mode |
RW |
驱动配置的最大频宽 （registrypriv.bw_mode，低 4 bit=2.4G，高 4 bit=5G） |
tx_bw_mode |
RW |
当前** TX 频宽**（2.4G/5G 分开显示） |
bw_ctl |
RW |
固定频宽控制（Auto / FIXED 20M 等） |
ampdu_enable |
RW |
A-MPDU 聚合开关 |
rx_ampdu |
RW |
RX A-MPDU 参数 |
rx_ampdu_size_limit |
RW |
RX A-MPDU 最大聚合长度 |
rx_ampdu_factor |
RW |
RX A-MPDU 因子 |
rx_ampdu_density |
RW |
RX A-MPDU 密度 |
tx_ampdu_density |
RW |
TX A-MPDU 密度 |
tx_max_agg_num |
RW |
TX 最大聚合数 |
tx_quick_addba_req |
RW |
快速 ADDBA 请求 |
tx_amsdu |
RW |
TX A-MSDU（需 CONFIG_TX_AMSDU） |
tx_amsdu_rate |
RW |
A-MSDU 速率门限 |
vht_24g_enable |
RW |
2.4G VHT 开关（需 CONFIG_80211AC_VHT） |
rtw_amsdu_mode |
RW |
A-MSDU 模式（SPP/非 SPP） |
dynamic_agg_enable |
RW |
动态聚合开关 |
qos_option |
R |
QoS/WMM 是否启用 |
区分 ：hal_spec.bw_cap = 硬件能力；bw_mode / tx_bw_mode = 软件配置/当前使用频宽。
3.3 射频、信道与功率
| 节点 |
类型 |
可获取的 Feature |
rf_info |
R |
当前信道、当前频宽、信道偏移（cur/oper） |
country_code |
RW |
国家码及对应信道规划 |
chan_plan |
RW |
当前信道规划 |
cap_spt_op_class_ch |
RW |
能力支持的 Operating Class 信道 |
reg_spt_op_class_ch |
RW |
法规支持的 Operating Class 信道 |
cur_spt_op_class_ch |
RW |
当前支持的 Operating Class 信道 |
ch_sel_policy |
RW |
信道选择策略 |
best_channel |
RW |
最优信道（需 CONFIG_FIND_BEST_CHANNEL） |
acs / chan_info |
RW/R |
自动信道选择（需 CONFIG_RTW_ACS） |
noise_monitor |
RW |
背景噪声监测（需 CONFIG_BACKGROUND_NOISE_MONITOR） |
tx_power_offset |
RW |
TX 功率偏移 |
hal_txpwr_info |
R |
HAL TX 功率信息 |
target_tx_power |
R |
目标 TX 功率表 |
tx_power_by_rate |
R |
按速率 TX 功率 |
tx_power_limit |
R |
TX 功率限制（需 CONFIG_TXPWR_LIMIT） |
tpc_settings |
RW |
TPC 设置 |
antenna_gain |
RW |
天线增益 |
tx_power_ext_info |
RW |
TX 功率扩展信息 |
tx_power_idx |
RW |
TX 功率索引 dump |
txpwr_total_dbm |
RW |
总 TX 功率 (dBm) dump |
tx_gain_offset |
W |
RF 功率校准偏移（需 CONFIG_RF_POWER_TRIM） |
kfree_flag / kfree_bb_gain / kfree_thermal |
RW |
K-free 校准参数 |
rx_signal |
RW |
RX 信号强度相关配置 |
hw_info |
RW |
硬件状态信息 |
3.4 连接状态与 MLME
| 节点 |
类型 |
可获取的 Feature |
fwstate |
R |
固件/MLME 状态机（扫描、关联、认证等） |
mlmext_state |
R |
MLME 扩展状态 |
adapters_status |
R |
多接口（并发）状态汇总 |
survey_info |
RW |
扫描结果 / 站点勘测信息 |
scan_param |
RW |
扫描参数（信道驻留时间、A-MPDU 等） |
scan_abort |
R |
中止扫描 |
scan_deny |
RW |
扫描拒绝策略 |
scan_interval_thr |
RW |
忙时拒绝扫描阈值（需 RTW_BUSY_DENY_SCAN） |
linked_info_dump |
RW |
已连接 STA/AP 详细信息 dump |
sta_tp_info / sta_tp_dump |
R/RW |
吞吐量统计 |
ap_info |
R |
当前关联 AP 信息 |
all_sta_info |
R |
AP 模式下所有 STA 信息（需 CONFIG_AP_MODE） |
aid_status |
RW |
AP AID 分配状态 |
roam_flags / roam_param |
RW |
Layer2 漫游参数（HCRTOS 已启用） |
ft_flags |
RW |
802.11r Fast Transition（需 CONFIG_RTW_80211R） |
tdls_info / tdls_enable |
R/RW |
TDLS 信息与开关（HCRTOS 未启用） |
monitor |
RW |
Monitor 监听模式（HCRTOS 已启用 CONFIG_WIFI_MONITOR） |
3.5 安全与加密
| 节点 |
类型 |
可获取的 Feature |
sec_info |
R |
安全协议信息（WPA/WPA2/WPA3 等） |
sec_cam |
RW |
Security CAM 表 |
sec_cam_cache |
R |
Security CAM 缓存 |
macaddr_acl |
RW |
MAC 地址 ACL（需 CONFIG_RTW_MACADDR_ACL） |
pre_link_sta |
RW |
预连接 STA（需 CONFIG_RTW_PRE_LINK_STA） |
cur_beacon_keys |
R |
当前 Beacon 密钥 |
11w_tx_sa_query / 11w_tx_deauth / 11w_tx_auth |
RW |
802.11w PMF 测试（HCRTOS 未启用） |
3.6 AP / SoftAP 模式
需 CONFIG_AP_MODE = y（HCRTOS 已启用）
| 节点 |
类型 |
可获取的 Feature |
all_sta_info |
R |
已连接客户端列表与详情 |
aid_status |
RW |
Association ID 状态 |
ap_isolate |
RW |
AP 客户端隔离 |
bmc_tx_rate |
RW |
广播/组播 TX 速率 |
ap_b2u_flags |
RW |
广播转单播标志 |
change_bss_chbw |
W |
动态修改 BSS 信道/频宽 |
ap_csa_cnt |
RW |
AP 信道切换 Announce 计数（并发+AP 模式） |
3.7 收发统计与调试
| 节点 |
类型 |
可获取的 Feature |
trx_info |
R/RW |
TX/RX 包计数、错误统计 |
trx_info_debug |
R |
详细 TRX 调试信息 |
tx_stat / rx_stat |
R |
TX/RX 统计 |
tx_info_msg / rx_info_msg |
R/RW |
TX/RX 消息级调试 |
rate_ctl |
RW |
速率控制 / 固定速率测试 |
mac_qinfo |
R |
MAC 队列信息 |
macid_info |
R |
MAC ID 分配信息 |
bcmc_info |
R |
广播/组播信息 |
rx_logs / tx_logs / int_logs |
R |
中断/TRX 日志（需 CONFIG_DBG_COUNTER） |
dump_rx_cnt_mode |
RW |
RX 计数器 dump 模式（需 DBG_RX_COUNTER_DUMP） |
dis_turboedca |
RW |
Turbo EDCA 控制 |
ack_timeout |
RW |
ACK 超时 |
napi_info |
R |
NAPI 收包信息（HCRTOS 已启用 CONFIG_RTW_NAPI） |
3.8 寄存器 / 硬件 Dump（底层调试）
| 节点 |
类型 |
可获取的信息 |
read_reg / write_reg |
RW |
读写 MAC/BB/RF 寄存器 |
mac_reg_dump |
R |
MAC 寄存器 dump |
bb_reg_dump / bb_reg_dump_ex |
R |
Baseband 寄存器 dump |
rf_reg_dump |
R |
RF 寄存器 dump |
mac_rptbuf |
R |
MAC 报告缓冲区 |
fifo_dump |
RW |
FIFO 内容 dump（需 CONFIG_SUPPORT_FIFO_DUMP） |
rsvd_page |
RW |
固件保留页 dump |
3.9 省电与 WoWLAN
HCRTOS 当前 CONFIG_POWER_SAVING = n 、CONFIG_WOWLAN = n，以下节点默认不编译。
| 节点 |
类型 |
Feature |
ps_info / wmmps_info |
RW |
IPS/LPS 省电状态 |
en_fwps |
RW |
FW PS 开关 |
ps_dbg_info |
RW |
省电调试信息 |
wow_enable / wow_pattern_info 等 |
RW |
WoWLAN 唤醒配置 |
lps_chk_tp |
RW |
按吞吐量检查 LPS |
3.10 蓝牙共存
HCRTOS CONFIG_BT_COEXIST = n，以下节点默认不编译。
| 节点 |
Feature |
btcoex |
BT 共存状态 |
btcoex_dbg |
BT 共存调试 |
btinfo_evt |
注入 BT 信息事件 |
btreg_read / btreg_write |
BT 寄存器读写 |
btc_reduce_wl_txpwr |
BT 共存时降低 WiFi TX 功率 |
3.11 DFS / 雷达检测
需 CONFIG_DFS_MASTER
| 节点 |
Feature |
dfs_test_case |
DFS 测试 |
radar_detect |
触发雷达检测 |
update_non_ocp |
更新非占用信道 |
dfs_ch_sel_e_flags / dfs_ch_sel_d_flags |
DFS 信道选择标志 |
3.12 Mesh / WDS / Multi-AP
| 功能 |
条件 |
主要节点 |
| 802.11s Mesh |
CONFIG_RTW_MESH |
mesh_networks, mesh_mpath, mesh_stats 等 |
| WDS |
CONFIG_RTW_WDS |
wds_en, wds_gptr, wds_path |
| Multi-AP |
CONFIG_RTW_MULTI_AP |
multi_ap_opmode, ch_utilization 等 |
HCRTOS RTL8733BU 默认均未启用。
3.13 IQK / 射频校准
需 CONFIG_DBG_RF_CAL
| 节点 |
Feature |
iqk |
IQ 校准信息与触发 |
lck |
LO 校准信息与触发 |
4. ODM 子目录（/proc/net/rtl8733bu/<iface>/odm/）
注册于 odm_proc_hdls[]，对接 PHYDM 数字 PHY 算法层。
| 节点 |
类型 |
可获取的 Feature |
adaptivity |
RW |
自适应灵敏度（Adaptivity）、EDCCA 阈值 |
cmd |
RW |
PHYDM 命令行（phydm_cmd），可查询 DIG、RA、天线分集等内部状态 |
5. MCC 子目录（/proc/net/rtl8733bu/<iface>/mcc/）
需 CONFIG_MCC_MODE = y （HCRTOS 当前 未启用）
| 节点 |
Feature |
mcc_info |
多信道并发（MCC）总体状态 |
mcc_enable |
MCC 开关 |
mcc_duration |
MCC 时隙时长 |
mcc_ap_bw20/40/80_target_tp |
AP 侧各频宽目标吞吐量 |
mcc_sta_bw20/40/80_target_tp |
STA 侧各频宽目标吞吐量 |
mcc_policy_table |
MCC 策略表 |
6. RTL8733BU @ HCRTOS 可用节点速查
以下为 CONFIG_PROC_DEBUG = y 且当前 Makefile 已开启的功能对应的常用查询节点：
| 需求 |
推荐 proc 节点 |
示例命令 |
| 硬件频宽能力 |
hal_spec |
`cat .../wlan0/hal_spec |
| 硬件频段/协议 |
hal_spec |
`grep -E 'band_cap |
| 各频宽支持速率 |
tx_rate_bmp |
cat .../wlan0/tx_rate_bmp |
| PHY 能力 (STBC/LDPC) |
phy_cap |
cat .../wlan0/phy_cap |
| 当前工作信道/频宽 |
rf_info |
cat .../wlan0/rf_info |
| 驱动配置频宽上限 |
bw_mode |
cat .../wlan0/bw_mode |
| 当前 TX 频宽 |
tx_bw_mode |
cat .../wlan0/tx_bw_mode |
| HT 是否开启 |
ht_option |
cat .../wlan0/ht_option |
| 连接/扫描状态 |
fwstate |
cat .../wlan0/fwstate |
| 国家码/信道规划 |
country_code |
cat .../wlan0/country_code |
| 固件版本 |
fw_info |
cat .../wlan0/fw_info |
| MAC 地址 |
mac_addr |
cat .../wlan0/mac_addr |
| 收发统计 |
trx_info |
cat .../wlan0/trx_info |
| AP 下客户端 |
all_sta_info |
cat .../wlan0/all_sta_info |
| 漫游配置 |
roam_flags |
cat .../wlan0/roam_flags |
| Monitor 模式 |
monitor |
cat .../wlan0/monitor |
| 驱动版本 |
ver_info |
cat /proc/net/rtl8733bu/ver_info |
7. 与代码 API 的对应关系
若无法使用 proc（如 HCRTOS 默认关闭 CONFIG_PROC_DEBUG），可直接调用等价 API：
| proc 节点 |
等价代码 |
hal_spec |
GET_HAL_SPEC(adapter)->bw_cap / dump_hal_spec() |
hal_spec.bw_cap |
hal_is_bw_support(adapter, CHANNEL_WIDTH_40) |
rf_info |
adapter->mlmeextpriv.cur_channel / cur_bwmode |
bw_mode |
adapter->registrypriv.bw_mode |
tx_bw_mode |
adapter->driver_tx_bw_mode |
ht_option |
adapter->mlmepriv.htpriv.ht_option |
fwstate |
get_fwstate(&adapter->mlmepriv) |
phy_cap |
rtw_dump_phy_cap() |
HiChip 已在 hc-porting.c 中实现 rtw_print_hal_bw_cap()，在 USB 驱动挂载完成后用 printf 输出 hal_spec.bw_cap，无需 proc。
8. 附录：Feature 分类总表
┌─────────────────────────────────────────────────────────────┐
│ rtw_proc 可查询 Feature │
├─────────────────┬───────────────────────────────────────────┤
│ 芯片硬件能力 │ hal_spec, tx_rate_bmp, phy_cap, efuse_map │
│ 协议/频宽 │ ht_*, bw_*, vht_*, ampdu_*, amsdu_* │
│ 射频/信道/功率 │ rf_info, country_code, chan_plan, txpwr_* │
│ 连接/漫游 │ fwstate, linked_info_*, roam_*, survey_* │
│ 安全 │ sec_info, sec_cam, macaddr_acl, 11w_* │
│ AP/P2P │ all_sta_info, ap_*, monitor │
│ 统计/调试 │ trx_info, tx/rx_stat, rate_ctl, reg_dump │
│ 省电/WoWLAN │ ps_info, wow_* (HCRTOS 默认关闭) │
│ BT 共存 │ btcoex_* (HCRTOS 默认关闭) │
│ PHYDM 算法 │ odm/adaptivity, odm/cmd │
│ MCC 多信道 │ mcc/* (HCRTOS 默认关闭) │
└─────────────────┴───────────────────────────────────────────┘