OP-BTS Python 脚本使用规范与工具指引


OP-BTS Python 脚本使用规范与工具指引

一、脚本运行规则

OP-BTS 设备仅支持执行编译后的 .py.o 格式字节码文件，原始 .py 源码无法直接在设备上运行，请务必完成编译操作后再执行脚本。

二、命令行工作流（opman CLI）

1. 工具介绍

opman（@zenovate/opman）是 OP-BTS 脚本在开发机上的主要工具，支持 macOS（arm64/x64） 与 Windows x64。用于将 Python 编译为 .py.o、经串口/BLE 上传或部署，并打开 Python REPL；可脚本化，适合本地与自动化流程。

完整说明见：opman CLI 使用文档。

2. 安装

需要 Node.js ≥ 16。已发布的 npm 包不支持 Linux。

npm install -g @zenovate/opman
opman --version

3. 最小工作流

# 本地编译
opman compile hello.py

# 编译 + 上传 + 运行（按实际串口与波特率修改）
opman deploy hello.py -p COM3 -b 9600

# 可选：Python REPL
opman python -p COM3 -b 9600

若省略 -b，opman 默认串口波特率为 115200。许多光电头工装使用 9600——需要时请传 -b 9600。在 macOS 上通过 BLE 上传/部署时，建议使用 --packet-size 50。

设备上的脚本必须放在 /py 目录。

三、现场上传（OP Manager）

1. 工具介绍

OP Manager 用于连接 OP-BTS 设备、在现场上传已编译的 .py.o 脚本，以及设备参数配置、蓝牙管理、设备信息查看等。支持 iOS、Android 与 Windows。

2. 下载地址

官方下载入口：OP Manager

提示：该应用已上架 App Store 与 Google Play；Windows 版亦可从 Microsoft Store（微软商店） 获取。

3. 简要使用流程

  1. 打开 OP Manager，通过蓝牙扫描并连接目标 OP-BTS 设备；
  2. 进入设备管理界面，找到文档上传功能；
  3. 选中本地已编译好的 .py.o 脚本，完成上传；
  4. 上传成功后，可在设备端查看并运行对应脚本。

请先在电脑上用 opman 完成编译（见第二节），再按需使用 OP Manager 做现场分发。

四、OP File Manager（遗留）

OP File Manager（Windows GUI）此前用于编译/调试流程，现为遗留选项：新开发请使用 opman CLI。存量用户仍可查阅 OP File Manager 用户手册。

五、完整脚本开发参考文档

如需了解 OP-BTS 专属 Python 语法、设备 API、标准库、交互模式、异常排查等详细开发规则，请查阅官方脚本手册：

OP-BTS 脚本编程指南

六、示例脚本下载

官方提供一组 OP-BTS 脚本示例，涵盖 IEC1107 读表、ANSI 登录及设备状态检查等常见场景。压缩包内同时包含 .py 源码与已编译的 .py.o 字节码：可直接将 .py.o 上传至设备 /py 目录运行，也可打开 .py 源码学习、修改后，用 opman（opman compile / opman deploy）重新编译。

下载示例脚本包（scripts-examples.zip）

脚本 说明
e650-serial.py 通过 IEC1107（300 bps 识别 + ACK 切换至 9600）读取 E650 电表序列号，并在 LCD 上显示
e650-date.py IEC1107 读表：识别型号、切换 9600、解析 90()/11()/12() 获取序列号、时间和日期，LCD 显示
wasion.py 威胜（WASION）电表 ANSI C12.18 登录并读取型号，日志写入 /py/meter_read.txt
unlock.py 检查设备解锁状态并在 LCD 上显示结果

每个 .py 文件均附带对应的 .py.o 编译产物，解压后可直接使用。

七、工具分工总结

工具名称 适用平台 核心用途 适用场景
opman CLI macOS、Windows x64 编译、上传、部署、REPL、自动化 电脑端脚本开发与部署（首选）
OP Manager iOS、Android、Windows 设备连接、.py.o 脚本上传、参数配置 现场分发、日常设备运维
OP File Manager Windows 遗留 GUI 编译/调试/文件管理 仅存量流程 — 见用户手册

补充注意事项

  1. 所有上传至设备的脚本，存放路径统一为设备端 /py 目录，非该目录下的脚本无法正常运行；
  2. 请使用 Node.js ≥ 16 安装 opman：npm install -g @zenovate/opman。已发布的 npm 包不支持 Linux；
  3. 蓝牙连接时，建议设备与终端距离保持 1–2 米，信号强度优于 -65 dBm 可保障传输稳定性。