高通平台WIFI国家码与信道配置实战指南

1. 高通平台WIFI国家码与信道配置基础

刚接触高通平台WIFI开发时，最让我头疼的就是国家码和信道配置。这就像给路由器办"护照"和"通行证"——不同国家允许使用的WIFI频段和功率限制各不相同。记得第一次调试日本客户设备时，就因为没配置好MKK标准信道，导致5G频段无法正常使用。

国家码（Country Code）本质上是个两位字母代码，比如CN代表中国、JP代表日本。它决定了设备在特定地区可用的无线电频段、发射功率等参数。而信道配置则是具体落实这些规则，明确设备能使用哪些频段。在高通平台上，这套规则通过Excel表格和二进制配置文件来管理。

关键配置文件主要存放在WLAN.MSL.3.0.1\wlan_proc\wlan\phyrf_svc_li\tools\bdfUtil\Regulatory_BDF_tools目录下：

• Regulatory_BDF_6G_In_Data.xlsx：核心规则定义文件
• RegDB_excel2bin.py：转换脚本
• 生成的regdb.bin和regdb.txt：最终生效的配置文件

2. 配置文件深度解析

2.1 Excel表格结构剖析

打开Regulatory_BDF_6G_In_Data.xlsx，你会看到十几个sheet页。别慌，其实它们分为两大类：

定义类（LOOKUP结尾）：

• COUNTRY_LOOKUP：国家码定义
• REG_DMN_PAIR_LOOKUP：2.4G和5G域组合
• REG_DOMAINS_5G_LOOKUP：5G频段域定义
• REG_RULES_5G_LOOKUP：5G信道段规则

赋值类（INPUT结尾）：

• ALL_COUNTRIES_INPUT：国家码参数配置
• REG_DOMAIN_PAIRS_INPUT：域组合参数
• REG_RULES_5G_INPUT：5G信道具体参数

举个实际例子：要添加日本JP国家码支持，需要在COUNTRY_LOOKUP最后追加一行，格式为CTRY_JAPAN加唯一数字ID。就像给新同学分配学号，不能与已有ID重复。

2.2 关键参数详解

在REG_RULES_5G_INPUT中，每个信道段包含这些核心参数：

• 起始/结束信道号（如5170-5250）
• 最大带宽（20/40/80/160MHz）
• 发射功率限制（单位dBm）
• FLAGS标记（控制特殊限制）

FLAGS就像交通信号灯，控制着信道使用规则。常见的有：

• REGULATORY_CHAN_NO_IR：禁止主动发射信号
• REGULATORY_CHAN_RADAR：需要雷达检测
• REGULATORY_CHAN_INDOOR_ONLY：仅限室内使用

修改这些标记时，要特别注意参数间的联动关系。比如某信道设置了NO_80MHZ，却配置了80MHz带宽，就会导致配置冲突。

3. 日本信道配置实战

3.1 配置流程分解

以配置日本5G频段为例，完整流程如下：

1. 国家码定位：

   • 在ALL_COUNTRIES_INPUT找到JP对应行
   • 记录区域码MKK5_MKKC

2. 域组合查询：

   • 在REG_DMN_PAIR_LOOKUP搜索MKK5_MKKC
   • 获取对应的5G域IDMKK5_id

3. 信道段映射：

   • 在REG_DOMAINS_5G_LOOKUP定位MKK5_id行号
   • 在REG_DOMAINS_5G_INPUT对应行查看关联的信道段

4. 具体参数调整：

   • 根据信道段名称（如CHAN_5170_5250_15）
   • 在REG_RULES_5G_INPUT修改功率、带宽等参数

3.2 典型配置示例

日本5G主要使用三组信道：

1. 5180-5240MHz（对应信道36-48）
2. 5260-5320MHz（对应信道52-64）
3. 5550-5720MHz（对应信道100-144）

在REG_RULES_5G_INPUT中需要配置：

| 行号 | 起始信道 | 结束信道 | 带宽 | 中心频段... | |------|----------|----------|------|--------------| | 107 | 5170 | 5250 | 80MHz| 5180,5200... | | 108 | 5250 | 5330 | 80MHz| 5260,5280... | | 115 | 5490 | 5730 | 160MHz| 5500,5520... |

特别注意：日本要求某些信道必须支持DFS（动态频率选择），需要在FLAGS中启用REGULATORY_CHAN_RADAR标记。这就像开车遇到救护车要主动避让，检测到雷达信号时设备需要自动切换信道。

4. 配置验证与调试

4.1 快速验证方案

不想等待完整编译？试试这个临时方案：

adb root adb remount adb shell mount -o rw,remount /dev/block/sde6 /vendor/firmware_mnt adb push regdb.bin /vendor/firmware_mnt/image/qca6750/regdb.bin adb shell sync adb reboot

重启后检查两个关键点：

1. 国家码是否生效：

   adb shell iw reg get

2. 可用信道是否正确：

   adb shell iw list

4.2 常见问题排查

问题1：配置不生效

• 检查regdb.txt中regDbEnable是否为1
• 确认文件推送路径与设备芯片型号匹配

问题2：信道显示不全

• 检查REG_DOMAINS_5G_INPUT中的RULE数量是否与UM_REG_RULES一致
• 确认没有冲突的FLAGS限制

问题3：功率异常

• 核对REG_RULES_5G_INPUT中的PWR值
• 检查CTL_LOOKUP中的区域功率限制

5. 版本管理与协作规范

吃过亏才明白：只提交regdb.bin是远远不够的。必须同步更新：

1. Regulatory_BDF_6G_In_Data.xlsx源文件
2. 生成的regdb.txt
3. 修改记录（更新REGDB_VERSION_HISTORY）

建议每次修改都在REGDB_VERSION_HISTORY中添加记录，格式如：

2024-03-15 | v1.2 | 新增JP国家码支持 | 作者：张三

团队协作时，强烈建议：

• 使用Git等版本控制工具
• 修改前先更新最新版本
• 提交时填写详细的变更说明

记得有次因为同事只提交了bin文件，导致后续版本更新时配置丢失，排查了整整两天。现在我们都养成了修改-生成-验证-提交全套流程的习惯。