写在前面，本文用来收藏使用，内容皆为使用的命令细节。
本文主要以MTK无线芯片MT7603为例，记录MTK无线驱动开发过程中常用命令以及常规无线问题的排查手段。
| 对象 |
描述 |
|---|---|
| MT7603E | 高效能 802.11n，专为小型的 Wi-Fi 设备而设联发科技 MT7603E 是一款高度整合式 Wi-Fi 单芯片，支持 300 Mbps PHY 速率。它完全符合 IEEE 802.11n 及 IEEE 802.11 b/g 标准，提供高标准而功能丰富的无线连接，并可从更远的距离提供可靠稳定、具成本效益的处理能力。优化的射频架构及基频算法带来卓越的效能表现，以及可靠而低功耗的处理能力。它的智能型媒介访问控制 (MAC) 设计采用效率极高的直接内存访问 (DMA) 引擎，亦配备可减轻主处理器负荷的硬件信息处理加速器。MT7603E 的设计旨在提供符合安全性、服务品质及国际规范标准的功能，让终端用户在任何情况下也能随时享有最佳的效能表 |
| WiFi | IEEE 802.11:b/g/n Wi-Fi Frequency:2.4GHz Antenna:2T2R Data Throughput:300Mbit/s |
| Functions And Features | MAC:Yes RF:Yes ePA/eLNA:Yes BPP:Yes AP/Repeater:Linux AP/Repeater STA:Android,Linux Interface:PCI-Express 1.1 |
值：iwpriv ra0 show driverinfo && dmesg -c
| 对象 |
描述 |
|---|---|
| 无线芯片 | MT7603E |
| driver version | 4.0.1.0rev2.P1+ (Tue Apr 9 03:35:59 CST 2019 Tue Apr 9 03:35:59 CST 2019) |
| fw version | 0.0.00 build:4a |
| build time | FjXc |
值:iwpriv ra0/rai0 set [parameters]=[Value]
下文中以2.4G无线主接口ra0为例子。
值：iwpriv ra0 set Debug=3
日志级别:0~50:Debug Off1:Debug Error2:Debug Warning3:Debug Trace4:Debug Info
5:Debug Loud
值：iwpriv ra0 show driverinfo && dmesg -c
设置2.4G国家区域
值:iwpriv ra0 set CountryRegion=5
设置5G国家区域
值:iwpriv ra0 set CountryRegionABand=7
3.1.4 设置国家码
值：iwpriv ra0 set CountryCode=CN
2个字符，比如CN就表示中国，US表示美国。可忽略。
值：iwpriv ra0 set AccessPolicy=0
0: Disable this function1: Allow all entries of ACL table to associate AP2: Reject all entries of ACL table to associate AP
值：iwpriv ra0 set ResetCounter=1
值：iwpriv ra0 set SiteSurvey=1
主动扫描：“iwpriv ra0 set SiteSurvey=”被动扫描：“iwpriv ra0 set SiteSurvey=11ac-AP”
值：iwpriv ra0 set CountryString=CHINA
值：iwpriv ra0 set SSID=11n-AP
0~Z，1~32 ASCII字符串
值：iwpriv ra0 set WirelessMode=5
0: legacy 11b/g mixed1: legacy 11B only2: legacy 11A only3: legac 11a/b/g mixed4: legacy 11G only5: 11ABGN mixed6: 11N only7: 11GN mixed8: 11AN mixed9: 11BGN mixed10: 11AGN mixed11: 11N only in 5G band only14: 11A/AN/AC mixed 5G band only(Only 11AC chipset support)15: 11 AN/AC mixed 5G band only(Only 11AC chipset support)
值：iwpriv ra0 set FixedTxMode=CCK
CCKOFDMHT
值：iwpriv ra0 set BasicRate=
0~4095
3.1.13 设置WIFI信道
值：iwpriv ra0 set Channel=6
802.11b/g: 1 ~ 14 (it must agree with the CountryRegion setting)802.11a: 36~165 (it must agree with the CountryRegionABand setting)
值：iwpriv ra0 set AutoChannelSel=2
0: Disable1: Old Channel Selection Algorithm(AP Count)2: New Channel Selection Algorithm(CCA)3：Busytime5：AP count and not switch the best channel6：CCA and not switch the best channel7：Busytime and not switch the best channel
alg1-3：评估除最优信道，并切换到最优信道；alg5-7：只扫描出评分结果，不进行信道切换
值：iwpriv ra0 set ACSCheckTime=3
单位：小时0: Disable
值：iwpriv ra0 set AutoChannelSkipListFlag=1
单位：小时
0: Disable1: Enable
值：iwpriv ra0 set AutoChannelSkipList=
example:=2;3;4;5;7;8;9;10;11;
值：iwpriv ra0 set BeaconPeriod=100
20 ~ 1024 (unit is in milli-seconds)值：iwpriv ra0 set DtimPeriod=1
1~53.1.20 设置发射功率百分比
值：iwpriv ra0 set TxPower=100
0~100Note:91 ~ 100% & AUTO, treat as 100% in terms of mW61 ~ 90%, treat as 75% in terms of mW -1dBm31 ~ 60%, treat as 50% in terms of mW -3dBm16 ~ 30%, treat as 25% in terms of mW -6dBm10 ~ 15%, treat as 12.5% in terms of mW -9dBm0 ~ 9 %, treat as MIN(~3%) in terms of mW -12dBm
值：iwpriv ra0 set BGProtection=0
0: disable1: Always on2:Always off
值：iwpriv ra0 set DisableOLBC=0
0: disable1: enable
值：iwpriv ra0 set TxPreamble=1
0: disable1: enable
值：iwpriv ra0 set TxBurst=0
0: disable1: enable
Question 1：TX和RX性能始终不平衡
A：Wi-Fi性能测试中当遇到TX和RX性能不平衡问题时，请检查TxBurst选项处于关闭或打开状态。当TxBurst开启时，TX数据包的优先级将高于RX数据包。结果，WLAN-TX的性能将高于RX。这个问题经常出现在快速以太网+WLAN解决方案中。千兆位以太网+WLAN解决方案没有这样的问题。
Question 2：How to turn off TxBurst?
A:
By profile:
TxBurst=0
By iwpriv command:
iwpriv ra0 set TxBurst=0
Note: 当设置WMM时，关闭TxBurst
编辑
值：iwpriv ra0 set PktAggregate=1
0: disable1: enable
值：iwpriv ra0 set NoForwarding=0
0: disable1: enable
该命令可以做到一般的无线隔离，对于需要隔离特殊包的需要在增加指定滤包条件。
值：iwpriv ra0 set NoForwardingBTNBSSID=1
0: disable1: enable
值：iwpriv ra0 set NoForwardingMBCast=1
0: disable1: enable
值：iwpriv ra0 set HideSSID=1
0: disable1: enable
值：iwpriv ra0 set ShortSlot=0
0: disable1: enable
值：iwpriv ra0 set DisConnectSta=00:11:22:33:44:55
[MAC address]3.1.32 设置手动断开所有连接的STA
值：iwpriv ra0 set DisConnectAllSta=1
1: disconnect all STAs3.1.33 设置组播物理模式
值：iwpriv ra0 set McastPhyMode=0
0: Disable1: CCK2: OFDM3: HTMIX
值：iwpriv ra0 set McastMcs=0
0~15值：iwpriv ra0 set MaxStaNum=0
0: disable this function1~32 (default:32)
值：iwpriv ra0 set AutoFallBack=1
0: disable1: enable
值：iwpriv ra0 set GreenAP=0
0: disable1: enable
值：iwpriv ra0 set MBSSWirelessMode=9
0: 802.11 B/G mixed1: 802.11 B only2: 802.11 A only4: 802.11 G only6: 802.11 N only7: 802.11 G/N mixed8: 802.11 A/N mixed9: 802.11 B/G/N mixed10: 802.11 A/G/N mixed11: 802.11 N in 5G band only
值：iwpriv ra0 set HwAntDiv=0
0: disable1: enableNote: Only support in RT5350.
值：iwpriv ra0 set HtBw=1
0: 20 MHz1: 20/40 MHz
值：iwpriv ra0 set VhtBw=1
0: disable1: enableNote: 11AC chipset only
值：iwpriv ra0 set VhtStbc=1
0: disable1: enableNote: 11AC chipset only
值：iwpriv ra0 set VhtBwSignal=1
0: disable1: enableNote: 11AC chipset only
值：iwpriv ra0 set VhtDisallowNonVHT=1
0: disable1: enable to reject non-VHT STANote: 11AC chipset only
值：iwpriv ra0 set HtMcs=33
0 ~15, 32: Fix MCS rate for HT rate.33: Auto Rate Adaption, recommended
值：iwpriv ra0 set HtGi=1
0: long guard interval1: short guard interval
值：iwpriv ra0 set HtOpMode=0
0: HT mixed mode1: HT Greenfield mode
值：iwpriv ra0 set HtStbc=1
0: disable1: enable
值：iwpriv ra0 set HtExtcha=0
0: below 下面1: Above 上面
值：iwpriv ra0 set HtMpduDensity=4
0~70: no restriction 无限制1: 1/4 µs2: 1/2 µs3: 1 µs4: 2 µs5: 4 µs6: 8 µs7: 16 µs
值：iwpriv ra0 set HtRdg=1
0: disable1: enable
值：iwpriv ra0 set HtAmsdu=0
0: disable1: enable
值：iwpriv ra0 set HtAutoBa=1
0: disable1: enable
值：iwpriv ra0 set BADecline=0
0: disable1: enable
值：iwpriv ra0 set HtBaWinSize=64
1~643.1.56 设置一个传输burst的AMPDU聚合大小的数量
值：iwpriv ra0 set HtTxBASize=64
1~643.1.57 设置手动添加一个BA条目到BA 表里
值：iwpriv ra0 set BASetup=00:0c:43:01:02:03-1
16进制MAC地址-10进制tid值
值：iwpriv ra0 set BAOriTearDown=00:0c:43:01:02:03-1
值：iwpriv ra0 set BARecTearDown=00:0c:43:01:02:03-1
值：iwpriv ra0 set HtProtect=0
0: disable1: enable
值：iwpriv ra0 set HtMimoPs=0
0: disable1: enable
值：iwpriv ra0 set HtDisallowTKIP=0
0: disable1: enable
值：iwpriv ra0 set AP2040Rescan=1
1: trigger to rescan值：iwpriv ra0 set HtBssCoex=0
0: disable1: enable
值：iwpriv ra0 set HtTxStream=1 or 2 or 3 or 4
1~4: valid spatial streams3.1.66 设置接收的空间流的数量
值：iwpriv ra0 set HtRxStream=1 or 2 or 3 or 4
1~4: valid spatial streams值：iwpriv ra0 set PktAggregate=1
0: disable1: enable
值：iwpriv ra0 set RTSThreshold=2347
1~2347
值：iwpriv ra0 set FragThreshold=2346
256~23463.1.70 设置AP踢出STA的最低限制
值：iwpriv ra0 set KickStaRssiLow=0
0: Disable0 ~ -100
值：iwpriv ra0 set AssocReqRssiThres=0
0: Disable0~ -100
值：iwpriv ra0 stat
获取每秒wlan统计计数器的结果：
while true;do iwpriv ra0 set ResetCounter=1;sleep 1;iwpriv ra0 stat;done3.1.73 显示邻区扫描结果
值：iwpriv ra0 get_site_survey
需要先使用”iwpriv ra0 set SiteSurvey=”去进行邻区扫描，收集信息。
值：iwpriv ra0 get_mac_table
值：iwpriv ra0 get_ba_table
值：wpriv ra0 get_wsc_profile
值：//Read
iwpriv ra0 e2p offset//Write EEPROMiwpriv ra0 e2p offset=valueoffset = hex addressvalue= hex value
iwpriv ra0 set mnt_clr=1iwpriv ra0 set mnt_sta0=00:00:00:00:00:00iwpriv ra0 set mnt_en=1iwpriv ra0 set mnt_rule=1:1:1iwpriv ra0 set mnt_sta0=F8:9A:78:BC:12:98
值：iwpriv ra0/rai0 show [parameters]
下文中以ra0为例子。
| 序号 | parameters | 说明 |
|---|---|---|
| 1 | driverinfo | 驱动版本信息 |
| 2 | sta | STA TX/RX等统计信息。 |
| 3 | stainfo | STA信息，MAC地址/RSSI/MCS/Rate等。 |
| 4 | stacountinfo | STA TX/RX个数信息。 |
| 5 | stasecinfo | STA认证加密信息。 |
| 6 | bainfo | BlockAck信息。 |
| 7 | connStatus | AP-Clinet连接状态。 |
| 8 | reptinfo | MAC Repeater信息。 |
| 9 | wdsinfo | WDS连接列表。 |
| 10 | igmpinfo | IGMP Snooping列表。 |
| 11 | mbss | MBSS PHY 模式信息。 |
| 12 | blockch | DFS blocked 信道列表。 |
| 13 | devinfo | AP Mode, 信道, 带宽。 |
| 14 | sysinfo | WDEV信息。 |
| 15 | trinfo | TX/RX Ring配置信息.。 |
| 16 | pwrinfo | 功率内部信息。 |
| 17 | txqinfo | TxQ信息。 |
| 18 | sta_tr | AP BSSID/wcid等。 |
| 19 | stat_reset | 统计清零。 |
1、确认无线是否有无重启现象2、确认无线是否做完校准3、确认rssi大小，最宜：-30 > RSSI > -504、扫描周围无线信号，看是否存在名称相同的SSID以及相同MAC地址的无线5、更换sta测试
1、首先确认网络带宽是否满足要求，可以通过有线看视频是否也会出现该现象；2、在上述没问题的情况下，再排除硬件问题2.1）、确认板子是否做过校准，如果校准过，更换设备是否正常2.2）、确认wifi RF正常，请检查RF测试报告2.3）、有条件的话可以找对比设备，其他厂家的无线能否正常看视频3、确认环境，在环境较好的地方测试，看是否有改善4、检测无线信号是否稳定，检查RSSI4.1）、范围要在-30 > RSSI > -50，太强（>-30）会有Maximum input 问题4.2）、两个RSSI差异不能大于5，可通过调整天线（或衰减）调整RSSI4.3）、使用cable线时RSSI调整说明：两路天线加相同的衰减，RSSI数值应该相差不大如果两路天线加相同的衰减但RSSI数值相差较大，则可能是屏蔽线或天线的问题，此时的check方法：交换2根屏蔽线，看RSSI数值是否随屏蔽线交换而变化。如果随之变化则说明屏蔽线有问题，否则说明可能是信号差的那一路wifi RF有问题。5、检查Tx/Rx PER （iwpriv ra0 set ResetCounter=1,后间隔1s下几次iwpriv ra0 stat）PER最好 < 5%，PER太高会降rateTx retry count = 20, PER=1.8%Rx with CRC = 54, PER=10.1%
3.2.3 无线吞吐量问题
1、 HW RF Check确认wifi RF正常，请检查RF测试报告iwpriv ra0/rai0 e2p 确认eeprom 值是否异常（请硬件工程师确认）检查EfuseBufferMode（主要是5G）tcapi get Wlan_Common EfuseBufferMode (检查)tcapi set WLan11ac_Common EfuseBufferMode 0/1 （设置，用tcapi save 保存）5G如果为插卡方式，则EfuseBufferMode=05G如果为on-board，则EfuseBufferMode=12、RSSI (iwpriv ra0 show stainfo)范围要在-30 > RSSI > -50，太强（>-30）会有Maximum input 问题两个RSSI差异不能大于5，可通过调整天线（或衰减）调整Rssi使用cable线时RSSI调整说明：两路天线加相同的衰减，RSSI数值应该相差不大如果两路天线加相同的衰减但RSSI数值相差较大，则可能是屏蔽线或天线的问题，此时的check方法：交换2根屏蔽线，看RSSI数值是否随屏蔽线交换而变化，如果随之变化则说明屏蔽线有问题，否则说明可能是信号差的那一路wifi RF有问题。3、 检查Tx/Rx PER （iwpriv ra0 set ResetCounter=1,后间隔1s下几次iwpriv ra0 stat）PER最好 < 5%，PER太高会降rateTx retry count = 20, PER=1.8%Rx with CRC = 54, PER=10.1%4、检查每秒发包数量while true;do iwpriv ra0/rai0 set ResetCounter=1;sleep 1;iwpriv ra0/rai0 stat;done根据每秒的Tx/Rx Success的数值，以及sniffer抓包结果（其中有每个封包的大小），可以计算出WiFi每秒处理的数据量，进而检查进出WiFi driver的数据量是否正常。5、检查Tx/Rx data rate（MCS）是否有降(iwpriv ra0 show stainfo/iwpriv ra0 stat)查看Data Rate是否为高Rate: 11n MCS15（2x2 300Mbps, 1x1 144Mbps）;11ac MCS9（866Mbps）如果MCS有降，尝试Fixed Rate（profile设置MCS=15）看是否稳定选择几个固定rate，测试performance，并抓sniffer6、检查False CCA是否异常while true;do iwpriv ra0/rai0 set ResetCounter=1;sleep 1;iwpriv ra0/rai0 stat;done每秒下一次iwpriv ra0/rai0 stat,检查每秒false CCA增加的值如超过1000，则表示环境教差，可以换Channel尝试；如果在屏蔽室环境还是会到几千或者几万，请HW检查硬件（扫FFT），很有可能是板子上有nosie7、检查BA状态iwpriv ra0 show bainfo分析sniffer log8、AGG range 为aggregation 的个数iwpriv ra0 stat分析sniffer log9、检查是否和Channel有关页面配置channe或者iwpriv ra0 set Channel=xx 更改channel看下是否和channel相关如果不同channel差异很大请检查是否为环境原因，拿测试ok的板子对比或者在屏蔽室做确认HW本身原因，屏蔽室中某些channel有大量false CCA或者有nosie10、检查平台Switch相关检查LAN端是否使用的是千兆网口cat /proc/tc3162/gsw_link_st条件允许可的话，100M lan切成giga的etherwan测试11、检查LAN端是否有限速qdmamgr_lan get txratelimit/rxratelimit关闭限速
Tx方向
qdmamgr_lan set txratelimit 0 Disable 1000000qdmamgr_lan set txratelimit 1 Disable 1000000qdmamgr_lan set txratelimit 2 Disable 1000000qdmamgr_lan set txratelimit 3 Disable 1000000qdmamgr_lan set txratelimit 4 Disable 1000000
Rx方向
qdmamgr_lan set rxratelimit config Disable packet12、查看switch有无异常信息，类似crc error之类（实际的port以及port6）
cat /proc/tc3162/gsw_stats13、检查LAN端是否有丢包（diag工具）
检测工具：diag
使用命令：
insmod diag_2_6_36/diag_3_18.ko //加载模块，版本根据kernel选择echo dump > /proc/tc3126/diag //dump芯片关键信息echo start > /proc/tc3126/diag //设定起始点，记录数据和状态echo stop > /proc/tc3126/diag //设定结束点，并分析起始点和结束点的数据
注意1：统计过程中会有打印信息，但只分析echo stop > /proc/tc3162/diag后的信息
注意2：为保证统计准确性，待打流结束10秒后再echo stop > /proc/tc3162/diag
14、检查平台的4k buffer limit的问题 cat /proc/net/skbmgr_info查看是否alloc fail的情况
Dump信息如下所示，wifi吃的是skb_4k，因此需要观察红色部分
skbmgr_limit = 4096skbmgr_max_alloc_no = 791skbmgr_alloc_fail = 0skbmgr_alloc_no = 767skbmgr_max_list_len = 4skbmgr_4k_limit = 1024skbmgr_4k_max_alloc_no = 129skbmgr_4k_alloc_fail = 0skbmgr_4k_alloc_no = 128skbmgr_4k_max_list_len = 0skbmgr_queue_len CPU0 = 1skbmgr_4k_queue_len CPU0 = 1
增加SKB buffer命令：
echo xxxx > /proc/net/skbmgr_4K_limitecho xxxx > /proc/net/skbmgr_driver_max_skb
15、查看是否所有流都已经成功加速
hw_nat –g（只在AP有数据流量时（e.g. 测试throughput）才能学习硬加速规则）如果没有学到硬加速规则，封包均会由CPU处理，而CPU的性能瓶颈会影响throughput硬加速规则分为二层（MAC层）和三层（IP层），可使用如下命令查看：sys memrl bfb502940x08000000：二层加速0x00000000：三层加速sys memwl bfb50294 00000000 //修改硬加速规则为二层清除硬加速规则hw_nat -!目的是为验证是否有学到正确的硬加速规则，可在测试前清除一次
16、mpstat-P ALL 1检查是否有CPU loading大的情况
cat /proc/interrupt 检查中断绑定情况如果是多核的话尝试做更改中断绑定测试例如把rai0绑定到CPU 3处理echo 8 > /proc/irq/24/smp_affinity（8：每个bit代表一个CPU,24：代表是中断号）
17、对比测试
golden版本测试确认测试环境是否有问题golden版本测试无问题 —> 环境没问题golden版本测试有问题 —> 环境有问题无线连接与Cable线连接的对比确认是open mode环境原因还是软硬件问题cable线测试无问题 —> open mode环境问题cable线测试有问题 —> 开发板软件/硬件有问题demo板使用与我们的软件的对比确认是软件问题还是硬件问题无问题 —>硬件有问题有问题 —>软件有问题现有软件与正常版本软件的区别WiFi配置文件Driver 版本
推荐阅读
【1】jetson nano开发使用的基础详细分享
【2】Linux开发coredump文件分析实战分享
【3】CPU中的程序是怎么运行起来的 必读
【4】cartographer环境建立以及建图测试
【5】设计模式之简单工厂模式、工厂模式、抽象工厂模式的对比
本公众号全部原创干货已整理成一个目录，回复[ 资源 ]即可获得。
