背景：
硬件测试平台需要把 JSON 格式的 TIB2/TIB3 配置通过 gRPC 下发到服务端。旧脚本只能识别 TIB2，且 CLI 参数写死，用户大喊「TIB3 还是没有！」——于是有了这次重构。
1. 需求一句话
- CLI 从 3 个参数减到 2 个：profile 路径 + 服务器地址（去掉 hw_target，自动加载全部配置）。
- 一份 JSON 里同时支持 TIB2/TIB3，空配置不再发空请求。
- 所有枚举（波特率、电压、启动模式）必须自动映射到 Protobuf 定义，不能硬编码。
2. 文件地图
| 文件 | 作用 |
|---|---|
profile_client.py |
核心逻辑：读 JSON → 构造 SetProfileRequest → 发 gRPC |
load_profile.py |
CLI 入口，调 profile_client |
proto_python/*_pb2.py |
protoc 生成的消息/枚举定义，只读 |
Raptor2.*.json |
真实嵌套配置（含注释） |
test |
期望的 gRPC 文本格式，用于 diff 验证 |
3. JSON → Protobuf 的「万能翻译器」
核心函数 _get_proto_enum_string 做了 4 层回退：
| 回退层级 | 举例 | 输出 |
|---|---|---|
| ① 特殊字典 | "115200" → BAUD_115200 |
UART_BAUDRATE_BAUD_115200 |
| ② 全大/小写 | "NONE" → NONE |
UART_PARITY_NONE |
| ③ 驼峰转蛇形 | "EnterDutBootModeInternal" → ENTER_DUT_BOOT_MODE_INTERNAL |
BOOT_MODE_SELECTION_ENTER_DUT_BOOT_MODE_INTERNAL |
| ④ 后缀模糊 | "TX" 命中 UART_PARITY_TX |
直接返回 |
代码片段（已折叠重复）：
def _get_proto_enum_string(self, json_value, enum_type_name, enum_keys):special_maps = {"UartBaudrate": {"115200": "BAUD_115200", ...},"IOVoltageLevel": {"V3P3": "V_3P3"},...}...# 1. 特殊映射if enum_type_name in special_maps and json_value in special_maps[enum_type_name]:snake_json_value = special_maps[enum_type_name][json_value]else:# 2. 通用驼峰→蛇形snake_json_value = self._pascal_to_snake(json_value)# 3. 类型前缀特殊处理：UartDataBits → UART_DATABITSif enum_type_name.startswith("Uart"):snake_enum_type = "UART_" + enum_type_name[4:].upper()else:snake_enum_type = self._pascal_to_snake(enum_type_name)full_name = f"{snake_enum_type}_{snake_json_value}"if full_name in enum_keys: # 4. 第一次命中return full_nameif snake_json_value in enum_keys: # 5. 无前缀再试return snake_json_valuefor k in enum_keys: # 6. 后缀模糊if k.endswith(f"_{snake_json_value}"):return kreturn f"{snake_enum_type}_UNSPECIFIED"
4. 嵌套 JSON 导航
真实文件结构：
{"TestInterfaceConfiguration": {"AIR1672": { // ← profile_group"TIB2": { ... }, // ← hw_target"TIB3": { ... }}}
}
代码用 next(iter(...)) 一把拿到 AIR1672，再 for hw_target, profile_details in profile_group.items() 遍历，再也不用手动指定 hw_target。
5. Protobuf 重复字段的正确姿势
| 错误写法 | 正确写法 |
|---|---|
one_profile.boot_modes.add() |
one_profile.boot_mode_config.boot_mode_configs.add() |
uart_config = one_profile.uart_configuration |
uart_config = one_profile.uart_configuration.data.add() |
踩坑：一开始把
boot_mode_config当成普通字段，结果AttributeError: boot_modes；用dir()现场侦查才发现boot_mode_config本身就是BootModeConfigurations（repeated）。
6. 最终 CLI 体验
python load_profile.py \--profile_path Raptor2.TestInterface.AIR1672.Configuration.json \--server localhost:50051
日志：
INFO Building profile for HW target 'TIB2'
INFO Building profile for HW target 'TIB3'
INFO Successfully set profile.
服务端收到完整请求，与 test 文件 diff 零差异。
7. 小结
- 枚举映射用 4 层回退，再也不怕 JSON 写法不统一。
- 嵌套结构用
next(iter())自动导航，新增硬件目标零代码改动。 - repeated 字段记得
.add()，现场dir()比盲猜快 10 倍。 - 注释 JSON先
re.sub(r"//.*", "", ...)再json.loads，优雅兼容带注释的配置。
8. 彩蛋：正则拆解 _pascal_to_snake
def _pascal_to_snake(self, name):# EnterDutBootModeInternal → ENTER_DUT_BOOT_MODE_INTERNALs1 = re.sub(r'(.)([A-Z][a-z]+)', r'\1_\2', name)return re.sub(r'([a-z0-9])([A-Z])', r'\1_\2', s1).upper()
([A-Z][a-z]+)匹配大写开头后面跟小写的单词，如Dut、Boot、Mode。([a-z0-9])([A-Z])把数字或小写后跟大写的地方加下划线，如eInternal→e_Internal。
两步搞定，零第三方依赖。
现在，TIB3 真的有了。