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_MODE1.2 访问方式# 只读cat/proc/net/rtl8733bu/wlan0/hal_spec# 读写部分节点支持写入配置echovalue/proc/net/rtl8733bu/wlan0/bw_mode1.3 节点类型说明标记含义R只读proc_get_*RW可读可写proc_get_*proc_set_*W只写测试/触发类条件依赖CONFIG_*宏未开启则不编译2. 驱动级节点/proc/net/rtl8733bu/注册于drv_proc_hdls[]。节点类型可获取的 Feature / 信息ver_infoR驱动版本、编译日期、Git 信息log_levelRW驱动日志级别drv_cfgR驱动编译配置摘要mstatR内存分配统计需DBG_MEM_ALLOCcountry_chplan_mapR国家码与信道规划映射表chplan_id_listR支持的信道规划 ID 列表chplan_testR信道规划测试需CONFIG_RTW_DEBUGchplan_verR信道规划数据库版本global_op_classR802.11 全局 Operating Class 定义hw_rate_map_testR硬件速率映射测试需CONFIG_RTW_DEBUGhalmac_infoRHALMAC 框架信息8733B已启用RTW_HALMAC3. 网卡级节点/proc/net/rtl8733bu/iface/注册于adapter_proc_hdls[]。以下按Feature 类别分组。3.1 硬件能力与芯片规格★ 查能力首选节点类型可获取的 Featurehal_specR芯片硬件规格总览macid_num、RF 路径数、TX/RX NSS、band_cap2G/5G、bw_cap频宽能力20M/40M/80M 等、proto_capb/g/n/ac、wl_funcP2P/Miracast/TDLS、安全能力、TX GI 等tx_rate_bmpR各频宽下支持的 CCK/OFDM/HT/VHT 速率位图通过hal_is_bw_support()过滤phy_capRPHY 层能力STBC、LDPC、BeamformingSU/MU等rx_stbc/stbc_capRWSTBC 接收开关 / 驱动 STBC 能力配置ldpc_capRWLDPC 能力配置txbf_capRWTx Beamforming 能力需CONFIG_BEAMFORMINGhal_trx_modeRHAL 收发模式efuse_mapReFuse 映射内容fw_infoR固件版本与状态mac_addrR当前 MAC 地址skip_bandRW跳过某频段2G/5Gwifi_specRWiFi 规格标志registrywifi_spechal_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节点类型可获取的 Featureht_optionRHT802.11n是否启用ht_enableRWHT 开关bw_modeRW驱动配置的最大频宽registrypriv.bw_mode低 4 bit2.4G高 4 bit5Gtx_bw_modeRW当前** TX 频宽**2.4G/5G 分开显示bw_ctlRW固定频宽控制Auto / FIXED 20M 等ampdu_enableRWA-MPDU 聚合开关rx_ampduRWRX A-MPDU 参数rx_ampdu_size_limitRWRX A-MPDU 最大聚合长度rx_ampdu_factorRWRX A-MPDU 因子rx_ampdu_densityRWRX A-MPDU 密度tx_ampdu_densityRWTX A-MPDU 密度tx_max_agg_numRWTX 最大聚合数tx_quick_addba_reqRW快速 ADDBA 请求tx_amsduRWTX A-MSDU需CONFIG_TX_AMSDUtx_amsdu_rateRWA-MSDU 速率门限vht_24g_enableRW2.4G VHT 开关需CONFIG_80211AC_VHTrtw_amsdu_modeRWA-MSDU 模式SPP/非 SPPdynamic_agg_enableRW动态聚合开关qos_optionRQoS/WMM 是否启用区分hal_spec.bw_cap 硬件能力bw_mode/tx_bw_mode 软件配置/当前使用频宽。3.3 射频、信道与功率节点类型可获取的 Featurerf_infoR当前信道、当前频宽、信道偏移cur/opercountry_codeRW国家码及对应信道规划chan_planRW当前信道规划cap_spt_op_class_chRW能力支持的 Operating Class 信道reg_spt_op_class_chRW法规支持的 Operating Class 信道cur_spt_op_class_chRW当前支持的 Operating Class 信道ch_sel_policyRW信道选择策略best_channelRW最优信道需CONFIG_FIND_BEST_CHANNELacs/chan_infoRW/R自动信道选择需CONFIG_RTW_ACSnoise_monitorRW背景噪声监测需CONFIG_BACKGROUND_NOISE_MONITORtx_power_offsetRWTX 功率偏移hal_txpwr_infoRHAL TX 功率信息target_tx_powerR目标 TX 功率表tx_power_by_rateR按速率 TX 功率tx_power_limitRTX 功率限制需CONFIG_TXPWR_LIMITtpc_settingsRWTPC 设置antenna_gainRW天线增益tx_power_ext_infoRWTX 功率扩展信息tx_power_idxRWTX 功率索引 dumptxpwr_total_dbmRW总 TX 功率 (dBm) dumptx_gain_offsetWRF 功率校准偏移需CONFIG_RF_POWER_TRIMkfree_flag/kfree_bb_gain/kfree_thermalRWK-free 校准参数rx_signalRWRX 信号强度相关配置hw_infoRW硬件状态信息3.4 连接状态与 MLME节点类型可获取的 FeaturefwstateR固件/MLME 状态机扫描、关联、认证等mlmext_stateRMLME 扩展状态adapters_statusR多接口并发状态汇总survey_infoRW扫描结果 / 站点勘测信息scan_paramRW扫描参数信道驻留时间、A-MPDU 等scan_abortR中止扫描scan_denyRW扫描拒绝策略scan_interval_thrRW忙时拒绝扫描阈值需RTW_BUSY_DENY_SCANlinked_info_dumpRW已连接 STA/AP 详细信息 dumpsta_tp_info/sta_tp_dumpR/RW吞吐量统计ap_infoR当前关联 AP 信息all_sta_infoRAP 模式下所有 STA 信息需CONFIG_AP_MODEaid_statusRWAP AID 分配状态roam_flags/roam_paramRWLayer2 漫游参数HCRTOS已启用ft_flagsRW802.11r Fast Transition需CONFIG_RTW_80211Rtdls_info/tdls_enableR/RWTDLS 信息与开关HCRTOS未启用monitorRWMonitor 监听模式HCRTOS已启用CONFIG_WIFI_MONITOR3.5 安全与加密节点类型可获取的 Featuresec_infoR安全协议信息WPA/WPA2/WPA3 等sec_camRWSecurity CAM 表sec_cam_cacheRSecurity CAM 缓存macaddr_aclRWMAC 地址 ACL需CONFIG_RTW_MACADDR_ACLpre_link_staRW预连接 STA需CONFIG_RTW_PRE_LINK_STAcur_beacon_keysR当前 Beacon 密钥11w_tx_sa_query/11w_tx_deauth/11w_tx_authRW802.11w PMF 测试HCRTOS未启用3.6 AP / SoftAP 模式需CONFIG_AP_MODE yHCRTOS已启用节点类型可获取的 Featureall_sta_infoR已连接客户端列表与详情aid_statusRWAssociation ID 状态ap_isolateRWAP 客户端隔离bmc_tx_rateRW广播/组播 TX 速率ap_b2u_flagsRW广播转单播标志change_bss_chbwW动态修改 BSS 信道/频宽ap_csa_cntRWAP 信道切换 Announce 计数并发AP 模式3.7 收发统计与调试节点类型可获取的 Featuretrx_infoR/RWTX/RX 包计数、错误统计trx_info_debugR详细 TRX 调试信息tx_stat/rx_statRTX/RX 统计tx_info_msg/rx_info_msgR/RWTX/RX 消息级调试rate_ctlRW速率控制 / 固定速率测试mac_qinfoRMAC 队列信息macid_infoRMAC ID 分配信息bcmc_infoR广播/组播信息rx_logs/tx_logs/int_logsR中断/TRX 日志需CONFIG_DBG_COUNTERdump_rx_cnt_modeRWRX 计数器 dump 模式需DBG_RX_COUNTER_DUMPdis_turboedcaRWTurbo EDCA 控制ack_timeoutRWACK 超时napi_infoRNAPI 收包信息HCRTOS已启用CONFIG_RTW_NAPI3.8 寄存器 / 硬件 Dump底层调试节点类型可获取的信息read_reg/write_regRW读写 MAC/BB/RF 寄存器mac_reg_dumpRMAC 寄存器 dumpbb_reg_dump/bb_reg_dump_exRBaseband 寄存器 dumprf_reg_dumpRRF 寄存器 dumpmac_rptbufRMAC 报告缓冲区fifo_dumpRWFIFO 内容 dump需CONFIG_SUPPORT_FIFO_DUMPrsvd_pageRW固件保留页 dump3.9 省电与 WoWLANHCRTOS 当前CONFIG_POWER_SAVING n、CONFIG_WOWLAN n以下节点默认不编译。节点类型Featureps_info/wmmps_infoRWIPS/LPS 省电状态en_fwpsRWFW PS 开关ps_dbg_infoRW省电调试信息wow_enable/wow_pattern_info等RWWoWLAN 唤醒配置lps_chk_tpRW按吞吐量检查 LPS3.10 蓝牙共存HCRTOSCONFIG_BT_COEXIST n以下节点默认不编译。节点FeaturebtcoexBT 共存状态btcoex_dbgBT 共存调试btinfo_evt注入 BT 信息事件btreg_read/btreg_writeBT 寄存器读写btc_reduce_wl_txpwrBT 共存时降低 WiFi TX 功率3.11 DFS / 雷达检测需CONFIG_DFS_MASTER节点Featuredfs_test_caseDFS 测试radar_detect触发雷达检测update_non_ocp更新非占用信道dfs_ch_sel_e_flags/dfs_ch_sel_d_flagsDFS 信道选择标志3.12 Mesh / WDS / Multi-AP功能条件主要节点802.11s MeshCONFIG_RTW_MESHmesh_networks,mesh_mpath,mesh_stats等WDSCONFIG_RTW_WDSwds_en,wds_gptr,wds_pathMulti-APCONFIG_RTW_MULTI_APmulti_ap_opmode,ch_utilization等HCRTOS RTL8733BU 默认均未启用。3.13 IQK / 射频校准需CONFIG_DBG_RF_CAL节点FeatureiqkIQ 校准信息与触发lckLO 校准信息与触发4. ODM 子目录/proc/net/rtl8733bu/iface/odm/注册于odm_proc_hdls[]对接PHYDM数字 PHY 算法层。节点类型可获取的 FeatureadaptivityRW自适应灵敏度Adaptivity、EDCCA 阈值cmdRWPHYDM 命令行phydm_cmd可查询 DIG、RA、天线分集等内部状态5. MCC 子目录/proc/net/rtl8733bu/iface/mcc/需CONFIG_MCC_MODE yHCRTOS 当前未启用节点Featuremcc_info多信道并发MCC总体状态mcc_enableMCC 开关mcc_durationMCC 时隙时长mcc_ap_bw20/40/80_target_tpAP 侧各频宽目标吞吐量mcc_sta_bw20/40/80_target_tpSTA 侧各频宽目标吞吐量mcc_policy_tableMCC 策略表6. RTL8733BU HCRTOS 可用节点速查以下为CONFIG_PROC_DEBUG y且当前 Makefile 已开启的功能对应的常用查询节点需求推荐 proc 节点示例命令硬件频宽能力hal_speccat .../wlan0/hal_spec | grep bw_cap硬件频段/协议hal_specgrep -E band_cap各频宽支持速率tx_rate_bmpcat .../wlan0/tx_rate_bmpPHY 能力 (STBC/LDPC)phy_capcat .../wlan0/phy_cap当前工作信道/频宽rf_infocat .../wlan0/rf_info驱动配置频宽上限bw_modecat .../wlan0/bw_mode当前 TX 频宽tx_bw_modecat .../wlan0/tx_bw_modeHT 是否开启ht_optioncat .../wlan0/ht_option连接/扫描状态fwstatecat .../wlan0/fwstate国家码/信道规划country_codecat .../wlan0/country_code固件版本fw_infocat .../wlan0/fw_infoMAC 地址mac_addrcat .../wlan0/mac_addr收发统计trx_infocat .../wlan0/trx_infoAP 下客户端all_sta_infocat .../wlan0/all_sta_info漫游配置roam_flagscat .../wlan0/roam_flagsMonitor 模式monitorcat .../wlan0/monitor驱动版本ver_infocat /proc/net/rtl8733bu/ver_info7. 与代码 API 的对应关系若无法使用 proc如 HCRTOS 默认关闭CONFIG_PROC_DEBUG可直接调用等价 APIproc 节点等价代码hal_specGET_HAL_SPEC(adapter)-bw_cap/dump_hal_spec()hal_spec.bw_caphal_is_bw_support(adapter, CHANNEL_WIDTH_40)rf_infoadapter-mlmeextpriv.cur_channel / cur_bwmodebw_modeadapter-registrypriv.bw_modetx_bw_modeadapter-driver_tx_bw_modeht_optionadapter-mlmepriv.htpriv.ht_optionfwstateget_fwstate(adapter-mlmepriv)phy_caprtw_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 默认关闭) │ └─────────────────┴───────────────────────────────────────────┘