引言

做离线语音产品的工程师大多遇到过这种场景：工程在智能公元平台上已经配置完毕，唤醒词、命令词、引脚复用、PWM 输出、变量与动作绑定都调好了，此时硬件侧因料号、供货或功能升级，需要把 CI-73T1 换成 CI-73T2。如果新建工程重配一遍，所有命令词、触发条件和动作逻辑都要手动再来一次，既费时又容易漏配。 本文整理官方技术支持给出的标准做法：通过导出、修改、再导入 JSON 工程文件，在更换模组型号的同时保留全部已有配置。

平台为何不能直接改型号

首先要明确：平台目前不支持在已建好的工程上直接修改模组型号。模组型号在工程创建时即已确定，它决定了芯片资源、可用引脚与固件生成模板，属于工程的"根属性"，因此界面上没有"改型号"的入口。官方技术支持给出的方案是：把当前工程文件导出为 JSON，手动修改其中标识模组型号的字段，再导入平台按新型号生成固件。核心动作就是"手动改 JSON 文件"。

第一步：导出工程 JSON

在智能公元平台打开当前基于 CI-73T1 的工程，使用工程导出功能，将工程保存为 JSON 格式的文件，并妥善备份原件。这样即使后续修改出错，也能随时回到原始配置。

第二步：修改 JSON 中的模组型号字段

用任意文本或代码编辑器打开导出的 JSON 文件，先熟悉整体结构，再定位到工程文件中标识模组型号的字段，把原来的 CI-73T1 改为 CI-73T2。修改时注意三点：

1. 只改型号相关内容，不要顺手调整命令词、引脚等其他字段，避免引入新的差异。
2. 保持 JSON 格式合法：不要多删或漏掉逗号、引号、大括号，保存前最好用 JSON 校验工具检查一遍。
3. 若两个型号在可用外设或引脚复用上存在差异，需回头核对本工程用到的引脚功能在新型号上是否仍然可用，不可用的部分单独调整。

第三步：导入并重新生成固件

把修改后的 JSON 文件通过平台的工程导入功能重新导入，确认工程能正常打开、型号已显示为 CI-73T2 且原有配置项完整保留，再按常规流程编译生成固件，烧录到新模组。

验证与注意事项

烧录后建议做一轮回归验证：唤醒与识别是否正常、各 IO 触发是否有效、PWM 输出的频率与占空比是否符合预期、变量记忆与超时逻辑是否与原先一致。特别提醒：迁移只解决"配置保留"的问题，新旧模组在封装、电气特性与天线设计上的差异，仍需硬件工程师自行确认。

FAQ

Q：某引脚需要固定频率输出（如 1Hz）怎么配？ 将该引脚配置为 PWM 输出，并设置目标频率即可。

Q：PA1、PA2 两路要同步输出 1Hz 呢？ 分别建立两个 PWM 配置，一个绑定 A1、一个绑定 A2，参数设成一致即可。

Q：配置成 PWM 后想停止输出怎么办？ 把占空比设为 0 即可停止输出。

Q：超时退出后变量会自动恢复吗？ 不会。超时退出后变量保持当前值，重新上电才会恢复。若需跨断电保持，可在变量配置里打开"记忆功能"。若希望某个动作只生效一次，在执行完后把变量设回原值。

Q：引脚一直维持高电平，为什么不会重复触发？ IO 电平触发只在电平"变化"时触发（低变高或高变低），持续的高电平不会重复触发。"延时恢复"只是恢复变量值，并不产生电平变化，不能借此模拟再次触发。如果 MCU 与模块之间实现组合触发比较困难，可改用串口通信（A2、A3 等引脚也可复用为串口），实现起来更省事。

小结

在智能公元平台上更换离线语音模组型号而又不想重配工程，正确姿势是"导出 JSON → 手动改型号字段 → 导入生成固件"三步走，改完务必回归验证。同时熟练掌握 PWM 配置、变量记忆与电平触发语义，能让迁移后的功能验证事半功倍。