通讯测试软件:sscom32 手机蓝牙连接软件:蓝牙调试软件均可
蓝牙:安卓系统要求使用SPP方式通讯,IOS则使用BLE方式通讯 列出的蓝牙设备,蓝牙名称必须有特定的字串,OPBT,TES,EDMI,LAND,TP,SPP,BLE,TOOL OPBT系列图标 TP系列图标
OP系列命令通讯协议
支持通过串口或蓝牙与设备进行通讯。
命令格式
命令为类JSON格式,可以多个参数同时设置,命令总长度不超过150个字符 例如:
- {“AtCommandMode”:true}
- {“LcdScreenFlag”:true,“UartSelectedIndex”:1,“UserConfigSave”:true}
命令说明
1,进入命令状态,{“AtCommandMode”:true},一次进入成功后,会一直处于命令状态 2,设置或查询参数 3,如果需要保存参数,{“UserConfigSave”:true} 4, 退出命令状态,{“AtCommandMode”:false}
**设备默认为透传模式,如需要参数设置,则必须进入命令模式
命令列表
1. 命令模式控制
进入命令模式
- 命令:
{"AtCommandMode":true} - 返回:
{"OK":true}表示成功进入命令模式 - 说明:进入后会一直保持在命令状态,如果需要重新进入透传模式,需退出命令模式
- 默认值:false
退出命令模式
- 命令:
{"AtCommandMode":false} - 返回:
{"OK":false}表示成功退出命令模式 - 说明:退出后恢复为透传模式
- 默认值:false
2. 系统参数操作
恢复用户出厂设置
- 命令:
{"UserDefault":true} - 返回:
{"OK":“”}表示设置成功 - 说明:将系统参数恢复成用户出厂默认值,需发送保存配置命令,并重新开机才会生效
保存当前配置到用户
- 命令:
{"UserConfigSave":true} - 返回:
{"OK":“”}表示保存成功 - 说明:将当前参数保存为用户默认值
3. 配置查询
4. 蓝牙相关配置
SPP 名称查询和设置
-
命令:
{"BtSppName":"?"} -
返回示例:
{"BT Name SPP":"ZENOVATE SPP"} -
说明:查询当前SPP蓝牙名称
-
默认值:“ZENOVATE SPP”
-
命令:
{"BtSppName":"XXXXX"} -
返回:
{"OK":"XXXXX"} -
说明:设置SPP蓝牙名称,最长支持20个字节,重新开机才会生效
-
默认值:“ZENOVATE SPP”
BLE 名称设置
-
命令:
{"BtBleName":"?"} -
返回:
{"BT Name BLE":"ZENOVATE BLE"} -
说明:查询当前BLE蓝牙名称
-
默认值:“ZENOVATE BLE”
-
命令:
{"BtBleName":"XXXXX"} -
返回:
{"OK":"XXXXX"} -
说明:设置BLE蓝牙名称,最长支持15个字节
-
默认值:“ZENOVATE BLE”
PIN 码设置
-
命令:
{"BtPin":"?"} -
返回:
{"BT PIN":"1234"} -
说明:查询当前PIN码,默认值为1234
-
默认值:“1234”
-
命令:
{"BtPin":"XXXX"} -
返回:
{"OK":"XXXX"} -
说明:设置新的PIN码,必须为4位10进制数
-
默认值:“1234”
5. 系统参数配置
USB通讯模式 (USB Mode)
-
命令:
{"ExternalUsbMode":"?"} -
返回:
{"ExternalUsbMode":true|false} -
说明:查询当前USB通讯模式设置,返回true或false
-
默认值:true
-
命令:
{"ExternalUsbMode":true|false} -
返回:
{"OK":true|false} -
说明:true=支持USB串口(如果串口存在),false=不支持USB串口
-
默认值:true
快速充电设置 (Quick Charge)
-
命令:
{"QuickChargeFlag":"?"} -
返回:
{"QuickChargeFlag":false} -
说明:查询当前充电模式设置,返回true或false
-
默认值:false
-
命令:
{"QuickChargeFlag":true|false} -
返回:
{"OK":true|false} -
说明:true=快速充电,false=普通充电
-
默认值:false
临时波特率设置
-
命令:
{"OP BaudRate":"?"} -
返回:
{"OP BaudRate":"9600,N,8,1"} -
说明:查询当前临时波特率设置，返回值为字符串
-
默认值:9600,N,8,1
-
命令:
{"OP BaudRate":"9600,N,8,1"} -
返回:
{"OK":"9600,N,8,1"} -
说明:设置当前临时波特率，设置值马上生效，设置参数格式参看下面
-
默认值:9600,N,8,1
波特率预设表查询或设置
-
命令:
{"UartSelectedIndex":"?"} -
返回:
{"UartSelectedIndex":0} -
说明:查询当前使用的预设波特率索引
-
默认值:0
-
命令:
{"UartSelectedIndex":N} -
返回:
{"OK":N} -
说明:设置预设波特率索引,N范围0-9
-
默认值:0
-
命令:
{"OP Preset BaudRate":"?"} -
返回例子:
{
"OP Preset BaudRate": [
"9600,N,8,1", // 波特率9600，无校验，8数据位，1停止位
"19200,N,8,1", // 波特率19200，无校验，8数据位，1停止位
"300,E,7,1", // 波特率300，偶校验，7数据位，1停止位
"38400,N,8,1", // 波特率38400，无校验，8数据位，1停止位
"4800,N,8,1", // 波特率4800，无校验，8数据位，1停止位
"9600,E,7,1", // 波特率9600，偶校验，7数据位，1停止位
"2400,E,7,1", // 波特率2400，偶校验，7数据位，1停止位
"300,E,7,1", // 波特率300，偶校验，7数据位，1停止位
"9600,N,8,1", // 波特率9600，无校验，8数据位，1停止位
"19200,N,8,1" // 波特率19200，无校验，8数据位，1停止位
]
}
-
说明:查询预设的波特率配置列表
-
命令:
{"OP Preset BaudRate":["9600,N,8,1","115200,N,8,1",.....]}光电头波特率10组 -
返回例子:
{"OK|FAIL":""} -
说明:设置预设的波特率配置列表，OK=设置成功，FAIL=设置失败
波特率参数格式说明:
- 波特率:300-115200（300,600,1200,2400,4800,9600,19200,38400,57600,115200）
- 校验位:N=无校验,E=偶校验,O=奇校验
- 数据位:5-8位
- 停止位:0/1=1位停止位,2=2位停止位
7. 与硬件相关系统信息查询和设置
硬件设备版本号查询和设置
- 命令:
{"HardwareVersion":"?"} - 返回例子:
{"HardwareVersion":"V3.08-585_20241208"} - 说明:查询硬件设备的版本号
硬件设备序列号查询和设置
- 命令:
{"HardwareSerialNo":"?"} - 返回例子:
{"HardwareSerialNo":"1234567890"} - 说明:查询硬件设备的序列号
固件版本号查询和设置
- 命令:
{"SoftwareVersion":"?"} - 返回例子:
{"SoftwareVersion":"V4.1-585_20241208"} - 说明:查询固件的版本号
Flash空间的查询
- 命令:
{"FlashSize":"?"} - 返回:
{"FlashSize":"2MB"} - 说明:查询产品的Flash空间大小，字符串
电池电压的查询
- 命令:
{"BatteryVoltage":"?"} - 返回:
{"BatteryVoltage":N} - 说明:查询产品的电池电压，单位毫伏
系统温度的查询
- 命令:
{"SystemTemp":"?"} - 返回:
{"SystemTemp":N} - 说明:查询产品的系统温度，单位摄氏度*10，例如246表示24.6摄氏度