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

一、脚本运行规则

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

二、脚本上传操作（OP Manager）

1. 工具介绍

OP Manager 是适配移动端（iOS/Android）的管理工具，主要用于连接 OP-BTS 设备、上传已编译完成的 .py.o 脚本文件，同时支持设备参数配置、蓝牙管理、设备信息查看等功能。

2. 下载地址

官方下载入口：OP Manager

提示：该应用已上架 App Store 与 Google Play，可直接在应用商店搜索下载最新版本。

3. 简要使用流程

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

三、脚本编译与调试（OP File Manager）

1. 工具介绍

若需要对 Python 源码进行编译、测试、批量管理，请使用 Windows 端专属工具 OP-BT/BTS File Manager（MAUI 版本）。该工具具备源码编译、文件双向传输、Python 脚本运行调试、通信监控等全流程能力，是脚本开发与测试的核心工具。

2. 下载地址

官方手册及软件获取入口：OP File Manager 用户手册

3. 核心使用流程

安装并启动 OP File Manager，选择串口（Serial）或蓝牙 BLE 方式连接 OP-BTS 设备；
在左侧本地文件面板选中 .py 源码，使用编译功能，自动生成对应的 .py.o 字节码文件；
将编译后的 .py.o 文件上传至设备 /py 目录；
选中设备端的 .py.o 文件，点击运行按钮，完成脚本调试；
调试无误后，可使用 OP Manager 批量分发脚本至多台设备。

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

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

OP-BTS 脚本编程指南

手册涵盖环境搭建、代码示例、硬件接口调用、故障排查等全部开发内容，建议开发前通读参考。

五、示例脚本下载

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

下载示例脚本包（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 编译产物，解压后可直接使用。

六、工具分工总结

工具名称	适用平台	核心用途	适用场景
OP Manager	iOS、Android	设备连接、.py.o 脚本上传、设备参数配置	脚本成品分发、现场设备运维、日常设备管理
OP File Manager	Windows	源码编译、脚本调试、文件管理、通信监控	脚本开发、代码测试、批量编译

补充注意事项

所有上传至设备的脚本，存放路径统一为设备端 /py 目录，非该目录下的脚本无法正常运行；
编译工具依赖 op-py-compile.exe，若编译失败，请检查该工具是否放置在软件安装目录或系统环境路径中；
蓝牙连接时，建议设备与终端距离保持 1–2 米，信号强度优于 -65 dBm 可保障传输稳定性。