TP系列 客户命令参考手册
目录
1. 命令使用说明
命令使用文本格式,通过蓝牙连接设备成功后发送。
对于Windows系统,请使用文本编辑器将命令复制到剪贴板,然后使用串口调试工具连接设备后将剪贴板中的命令发送给设备。
对于android和ios系统,请使用文本编辑器将命令复制到剪贴板,然后使用蓝牙调试工具连接设备后将剪贴板中的命令发送给设备。
命令格式为:命令名\r\n
命令中的<参数>是一定要有的参数。[参数]是可以选的
2. 查询TP版本号
功能说明
查询TP设备的版本号信息。
命令格式
- 命令:
version?\r\n - 返回:
OK,VER=01.00\r\n - 说明:
- 返回格式:
OK,VER=版本号
- 返回格式:
使用示例
示例1:查询设备版本号
发送: version?\r\n
返回: OK,VER=01.00\r\n
说明: 当前TP设备版本号为01.00
示例3:使用串口工具发送命令
在windows串口调试工具(如sscom32)中:
- 选择正确的串口号和波特率
- 在发送框中输入:
version? - 点击发送(确保发送时包含回车换行符
\r\n) - 接收区显示:
OK,VER=01.00
示例4:通过蓝牙发送命令
在蓝牙调试软件中:
- 连接设备
- 发送命令:
version?\r\n - 接收返回:
OK,VER=01.00\r\n
注意事项
- 命令格式: 必须包含回车换行符
\r\n - 实时查询: 此命令返回的是设备固件版本信息s
3. 设置波特率参数(BaudTran)
功能说明
设置TP设备的串口通信参数,包括波特率、校验位、数据位和停止位。此命令用于配置设备与电表之间的通信参数。
命令格式
此命令使用文本格式,通过串口或蓝牙发送。
- 命令:
BaudTran,<baudrate>,<parity>,<datalen>,<stopbit>[,]\r\n- 格式说明:
BaudTran,然后是逗号和波特率参数
- 格式说明:
- 返回:
OK,VER=01.00\r\n
参数说明
| 参数 | 说明 | 取值范围 | 示例 |
|---|---|---|---|
| 模式选择 | 通信模式选择 | i, n, p, q, m, r | n |
baudrate |
波特率 | 300-115200 | 9600, 19200, 38400 |
parity |
校验位 | N, E, O | N=无校验, E=偶校验, O=奇校验 |
datalen |
数据位长度 | 5, 6, 7, 8 | 8 |
stopbit |
停止位 | 0, 1, 2 | 0或1=1位停止位, 2=2位停止位 |
常用波特率配置
| 波特率 | 校验位 | 数据位 | 停止位 | 命令示例 |
|---|---|---|---|---|
| 9600 | 无校验 | 8 | 1 | BaudTran,9600,N,8,1\r\n |
| 19200 | 无校验 | 8 | 1 | BaudTran,19200,N,8,1\r\n |
| 300 | 偶校验 | 7 | 1 | BaudTran,300,E,7,1\r\n |
| 2400 | 偶校验 | 7 | 1 | BaudTran,2400,E,7,1\r\n |
| 4800 | 无校验 | 8 | 1 | BaudTran,4800,N,8,1\r\n |
| 38400 | 无校验 | 8 | 1 | BaudTran,38400,N,8,1\r\n |
| 57600 | 无校验 | 8 | 1 | BaudTran,57600,N,8,1\r\n |
| 115200 | 无校验 | 8 | 1 | BaudTran,115200,N,8,1\r\n |
注意: 命令格式为 BaudTran + 逗号 + 参数,
使用示例
示例1:设置9600波特率,无校验,8数据位,1停止位(正常模式)
发送: BaudTran,9600,N,8,1\r\n
返回: OK,VER=01.00\r\n
说明: 成功设置TP设备波特率为9600,无校验,8数据位,1停止位。
示例2:设置300波特率,偶校验,7数据位,1停止位(IEC标准)
发送: BaudTran,300,E,7,1\r\n
返回: OK,VER=01.00\r\n
说明: 成功设置TP设备波特率为300,偶校验,7数据位,1停止位(符合IEC 62056-21标准)
示例4:完整通信流程
步骤1: 设置波特率参数
发送: BaudTran,9600,N,8,1\r\n
返回: OK,VER=01.00\r\n
步骤2: 开始与电表通信
(发送电表协议命令)
步骤3: 如需切换波特率,重新发送设置命令
发送: BaudTran,300,E,7,1\r\n
返回: OK,VER=01.00\r\n
参数格式说明
波特率(baudrate)
- 范围: 300-115200
- 常用值: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
- 说明: 通信速率,单位:位/秒
校验位(parity)
- N: 无校验(None)
- E: 偶校验(Even)
- O: 奇校验(Odd)
- 说明: 用于检测数据传输错误
数据位(datalen)
- 范围: 5-8位
- 常用值: 7(IEC标准), 8(标准ASCII)
- 说明: 每个字符的数据位数
停止位(stopbit)
- 0 或 1: 1位停止位
- 2: 2位停止位
- 说明: 用于标识字符结束
注意事项
-
命令格式:
- 命令格式:
BaudTran+ 逗号 + 波特率参数 - 例如:
BaudTran,9600,N,8,1 - 参数之间用逗号分隔
- 末尾可选逗号,但建议不添加
- 必须包含回车换行符
\r\n
- 命令格式:
-
参数匹配: 设置的参数必须与电表设备的通信参数完全匹配,否则无法正常通信
-
IEC标准配置:
- IEC 62056-21标准通常使用:300波特率,偶校验,7数据位,1停止位
- 命令示例:
BaudTran,300,E,7,1\r\n
-
实时生效: 设置后立即生效,无需重启设备
附录
命令协议说明
TP运行时系列命令
- 格式: 文本格式
- 要求: 无需进入命令模式,可直接发送
- 结束符: 必须包含
\r\n(回车换行符)
通信方式
串口通信
- windows下使用串口调试工具(如sscom32)- 选择正确的串口号和波特率
- 发送命令时确保包含正确的结束符
蓝牙通信
- 安卓系统:使用蓝牙调试工具通过SPP或BLE方式通讯
- iOS系统:使用蓝牙调试工具通过BLE方式通讯
常见问题
Q1: 为什么发送命令后没有返回?
- 检查命令格式是否正确,特别是结束符
\r\n - 检查串口或蓝牙连接是否正常
- 确认设备是否支持TP系列命令
Q2: 如何确认当前波特率设置?
- TP系列命令为运行时命令,设置后立即生效
- 可通过实际通信测试验证波特率是否正确
版本信息
- 文档版本: 1.1
- 更新日期: 2026-01-31
- 适用设备: TP系列设备