全新的 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 脚本直达完整受控烧录工位的捷径——无论该工位位于开发用工作站,还是嵌入在产线之中。