立项背景与目标:
在 Nordic nRF 及配套电源管理芯片(CPS、TPS)的产测与研发调试中,烧录流程往往依赖 J-Link 命令行、OpenOCD、工装 RPC 上电、固件 SCP 上传等多套工具,操作步骤多、易出错,且不同工站(PowerDFU、DataDFU、PowerFCT、DataFCT)流程不一致。本项目旨在用 Python 开发统一的一键烧录与工装控制 CLI,将「选固件 → 选工位 Slot → 自动上电 → 烧录 → 校验 → 下电」串联为可重复的标准流程,并支持打包为 macOS 单文件可执行程序,便于产线工程师与硬件研发人员开箱即用。
核心功能模块:
1)多工站模式:支持 PowerDFU、DataDFU、PowerFCT、DataFCT 四类 Station,按 Slot(1–4)自动映射 RPC 端点 IP/端口;
2)Nordic nRF 一键烧录:集成 SEGGER JLinkExe,自动扫描/选择 J-Link 序列号,生成并执行 Commander 脚本,支持 .bin/.hex、擦除、校验及烧录结果智能判定;
3)PowerDFU 扩展烧录:CPS/TPS 通过 RPC 控制继电器与 I2C 自动烧录,固件经 SCP 上传至工装;ULPOD 走 OpenOCD program_onefile 链路;
4)工装 RPC 自动化:烧录前后自动执行上电/下电、继电器切换、电压测量等 mixdevice 调用,减少人工拨码与接线失误;
5)交互与可观测:彩色终端 UI、进度条/Spinner、固件 SHA256 与路径校验、J-Link 日志解析与失败原因提示;支持 PyInstaller 打包 universal2 单文件分发。
业务流程与功能路径:
工程师启动 CLI(或 MagicTool 可执行文件)→ 选择 Station 与 Slot → 选择操作(烧录 / 一键上电 / 一键下电)→ 拖入或输入固件路径(.bin/.hex)→ 工具按工站 profile 调用 RPC 完成 DUT 上电与继电器配置 → 执行 J-Link 烧录或 CPS/TPS/ULPOD 对应烧录链路 → 实时展示烧录进度与日志 → 自动解析 success/verify 等关键字判定结果 → 烧录结束后 RPC 下电复位 → 提示是否继续下一台 DUT。该工具将分散的嵌入式烧录与产测工装操作收敛为「一条命令、一套交互」,显著提升产线烧录效率与操作一致性。
一、整体架构与技术选型
本项目采用 Python 3 单入口 CLI 架构,核心脚本为 nrf_oneclick_program.py,按「交互层 → 业务编排层 → 设备驱动层」分层设计:
• 交互层:基于 argparse 解析命令行参数,提供 Station/Slot/操作类型等交互式菜单,并用 ANSI 彩色输出、Spinner、进度条提升产线可读性;
• 业务编排层:根据 PowerDFU、DataDFU、PowerFCT、DataFCT 四类工站,编排「上电 → 烧录 → 校验 → 下电」流程,并维护固件路径、J-Link 序列号等会话状态,支持连续多台 DUT 操作;
• 设备驱动层:通过 subprocess 调用 SEGGER JLinkExe 完成 Nordic nRF SWD 烧录;通过 mix.lynx RPC 客户端控制工装继电器与 I2C 烧录(CPS/TPS);通过 SCP/SSH 将固件上传至工装板;ULPOD 场景调用 OpenOCD program_onefile 完成烧录。打包层使用 PyInstaller 将 Python 运行时、mix 资源目录及可选 sshpass 打成 macOS universal2 单文件 MagicTool,便于离线分发。
二、个人负责模块与成果
本人独立完成该工具从 0 到 1 的设计与实现,主要包括:
1)J-Link 自动化:实现 ShowEmuList 扫描、多调试器交互选择、J-Link Commander 脚本自动生成与落盘,以及基于日志关键字(download/verify/O.K. 等)的烧录结果判定;
2)多工站烧录链路:实现 PowerDFU 下 CPS/TPS RPC+I2C 烧录与 ULPOD OpenOCD 链路;DataDFU/PowerFCT 下 nRF 烧录前后 RPC 上电/下电;Slot 1–4 与 IP/端口自动映射;
3)固件与可靠性:支持 .bin/.hex 拖入解析、目录自动选固件、SHA256 校验、烧录文件路径一致性检查,降低选错固件风险;
4)跨平台兼容:针对 Apple Silicon 上 RPC 动态库架构不匹配,实现 arch -x86_64 自动重执行;SCP 支持内置 sshpass 与 SSH_ASKPASS 双路径;
5)交付形态:编写 package_nrf_tool.sh,一键产出 dist_universal2/MagicTool 可执行文件。成果上,将原先分散在 J-Link 命令行、RPC 脚本、SCP 手工步骤的操作收敛为单工具交互,产线单台烧录操作步骤由十余步降至「选工站 → 选固件 → 确认」3 步内完成。