全新的 fr_comm 库让 Python 3.10 及以上版本可在 Windows、Linux 与 ARM Linux 上完整控制 FlashRunner 2.0,中间不再需要 C/C++ 或 C# 封装层。
现代产线与自动化测试环境对 Python 的依赖日益加深。Python 可原生运行于嵌入式 Linux 板卡,能直接集成到 CI/CD 流水线中,也支撑着无数厂内工具的自动化层。然而在此之前,若要将这些环境连接到 FlashRunner 2.0,必须通过 C/C++ 或 C# 的集成层来衔接——而这层额外的依赖,并非每个团队都有余力长期维护。
fr_comm Python 库解除了这项限制。它以标准的 pip 安装包(wheel)形式提供,让您在 Windows、Linux 与 ARM Linux 上,直接以 Python 3.10 及以上版本使用完整的 FlashRunner 通信接口,包括设备命令、文件传输、项目运行、数据加密与实时日志。
- 可通过局域网与 USB/串口完整控制设备,速率最高达 3 Mbaud
- 可运行于 Windows、Linux 与 ARM Linux
- 只需一条 pip 命令即可安装,运行时仅有两个依赖包
- 沿用 C/C++ 与 C# 库的惯例,现有的集成人员几乎无须重新学习
- 需要 Python 3.10 及以上版本
开始使用
安装 wheel 包:
python -m pip install fr_comm_python-1.0.0.0-py3-none-any.whl
确认安装结果:
python -c "import fr_comm; print('import ok')"
python -c "from fr_comm import FR_GetDllVersion; print(FR_GetDllVersion())"
设置到此就已完成。下面这个最精简的示例会建立一个局域网连接会话、查询设备状态并处理错误,可直接扩展成完整的量产脚本:
from fr_comm import FlashRunner, FR_Comm_Exception
try:
with FlashRunner("LAN", "192.168.1.100:1234") as fr:
fr.FR_SendCommand("#GETENGSTATUS")
print(fr.FR_GetAnswer(1500))
except FR_Comm_Exception as exc:
print(exc)
精简而稳定的公开 API
客户端应用程序只需通过六个公开符号即可完成操作。接口刻意保持精简,让集成工作保持简单,日后的升级路径也更为清楚:
- FlashRunner——主类,负责建立设备连接会话并提供所有操作功能。
- FR_Logger——独立的实时日志客户端,可通过局域网使用。
- FR_Comm_Exception——所有通信与协议错误共用的单一异常类型。
- FR_FileType——所支持文件类型的枚举:FRB、PRJ、LIC、LOG、LIB。
- ProgressHandler——可选的回调接口,用于报告文件传输进度。
- FR_GetDllVersion()——返回库的版本字符串,供运行时校验之用。
灵活的连接方式
FlashRunner 对象在创建时就会立即打开连接。建议采用 with 块的写法:即使操作过程中发生异常,连接会话也会被自动、正确地关闭。
FlashRunner("LAN", "192.168.1.100:1234") # 局域网,最常见的量产配置
FlashRunner("COM3", "115200") # Windows 上的 USB/串口
FlashRunner("/dev/ttyUSB0", "115200") # Linux 上的 USB/串口
系统同时支持 115200 与 3000000 两种波特率。FlashRunner 启动时默认为 115200;若要切换到 3 Mbaud,请先在 115200 的状态下发送 #55*SETSERIALBAUDRATE HIGH,再将主机端的波特率调整为相同设置后继续操作。这样一来,即使是直接的 USB 连接也能实现高吞吐量的传输。
设备操作
命令的执行采用简单的发送/接收模式。FR_SendCommand() 可发送任何 FlashRunner 命令字符串,FR_GetAnswer() 则在可设置的超时时间内接收设备的响应:
fr.FR_SendCommand("#GETENGSTATUS")
answer = fr.FR_GetAnswer(1500) # 超时时间,单位为毫秒
在多通道的场景下,FR_SendCommand_Ex() 可指定明确的通道列表,并自动生成通道头,省去在调用方手动拼接字符串的麻烦:
fr.FR_SendCommand_Ex([1, 2], "RUN Project.prj")
answer = fr.FR_GetAnswer(1500)
文件传输支持双向操作。可选的 ProgressHandler 会报告百分比进度,在传输时间较长时,可用于控制台信息或界面上的进度条:
fr.FR_SendFile(r"C:\FlashRunner\app.frb", FR_FileType.FRB)
fr.FR_GetFile("app.frb", r"C:\FlashRunner\dest", FR_FileType.FRB)
运行项目只需一次调用。FR_RunProject() 会一直等待,直到所有通道完成或超时为止。配合可选的逐通道回调函数,即可将结果直接送入 MES 或测试报告系统:
def on_done(channel: int, result: bool) -> None:
print(f"channel {channel}: {'OK' if result else 'FAIL'}")
fr.FR_RunProject("demo.prj", [1, 2, 3], 120000, on_done)
动态存储器的内置数据加密
若应用程序需要将受保护的内容写入 FlashRunner 的动态存储器,可完全在 Python 内完成 RSA/AES 加密,无须额外工具。FR_GetPublicKey() 会获取并保存设备的公钥;之后可根据工作负载选择两种加密模式:
- 单次加密(FR_EncryptData)——每次调用都会生成新的 AES 密钥与 IV,并同时返回加密后的数据与经 RSA 封装的头部。每发送一个数据块之前,都必须先将头部传给设备。做法简单且自成一体,适合零星或次数不多的写入。
- 会话加密(FR_DynMem*)——FR_DynMemBeginEncryption() 只需建立一次会话密钥,并返回单一头部供发送至设备;之后 FR_DynMemEncryptData() 便可连续加密多个数据块,并自动处理 CBC 的 IV 链接,因此无须重复发送头部,也没有管理会话的额外开销。最后以 FR_DynMemResetEncryption() 结束该会话。需要将一连串数据块写入同一块动态存储器区域时,建议采用这种方式。
典型的应用场景
- 自动化测试治具:烧录固件、在多个通道上运行验证项目,并将合格/不合格结果送入测试框架或 MES——全程通过局域网完成,不需要 Windows 主机。
- 运行于嵌入式 Linux 板卡上的产线控制器:管理 FlashRunner 的连接会话,并将烧录结果实时报告给中央系统。
- CI/CD 流水线:将更新后的固件文件上传至 FlashRunner、触发烧录,并在构建验证阶段以编程方式判定结果。
- 现有 Python 厂内工具的迁移路径:让这些工具支持 FlashRunner,而不必在项目中引入 C/C++ 或 C# 依赖。
重要效益
- 跨平台且无须修改代码:同一个 wheel 包可在 Windows 工作站、Linux 服务器与车间现场的嵌入式 Linux 板卡上运行。
- 集成成本极低:一条 pip 命令、两个依赖包、一行 import——几分钟内就能从零建立起可工作的设备连接。
- 熟悉的 API:沿用现有 C/C++ 与 C# 库的惯例,已在使用 FlashRunner 的团队无须重新学习集成方式即可转用 Python。
- 以会话为核心的设计:单个 FlashRunner 对象即可管理整个连接的生命周期,让集成代码保持简洁、可预测。
- 结构化的错误处理:所有失败都以 FR_Comm_Exception 的形式抛出,并可附带机器可读的错误码,让自动化的错误分类变得简单。
fr_comm 库毫不妥协地将 FlashRunner 2.0 扩展到基于 Python 的生产与测试环境。凡是 C/C++ 与 C# 库能够执行的操作——命令、文件传输、项目运行、加密与实时日志——都可以通过这一个 pip 安装包获得,适用于任何能运行 Python 3.10 的平台。
对于正在围绕 FlashRunner 构建自动化的团队而言,这意味着更短的集成周期、更少的工具链依赖,以及从一段 Python 脚本直达完整受控烧录工位的捷径——无论该工位位于开发用工作站,还是嵌入在产线之中。