美容设备通讯文档
描述
1、模块指我们提供的通信模块。
2、设备指调用“模块”的主机设备,一般指充电站、游戏机等自助设备。
通讯数据格式
模块采用UART串口协议与主机进行问答式串行通讯,波特率为9600,8位数据位,1位停止位,无校验位。
命令格式
SOP | LEN | CMD | SESSION_ID | DATA | SUM |
SOP:单字节字头。命令为EE,应答为66 。
LEN:单字节。从CMD到SUM的字节数(含CMD和SUM)
CMD:单字节,命令字节。
SESSION_ID:服务端回话编号,6个字节,用户服务端识别通讯会话。如果服务端发起的会话设备应答服务端需要带上服务端下发的会话ID。如果设备发起会话则会话ID为“000000”
DATA:数据字节,不定长。
SUM:单字节,LEN、CMD、SESSION_ID、DATA的异或值
业务接口
读取设备内剩余次数
服务器命令:TOW
描述:服务器读取设备每个端口当前的状态。
数据方向:模块→设备
命令:0x01
CMD | 0x01 |
---|
数据(上面表示数据含义,下面表示示例数据):
NULL |
---|
0x00 |
参数 | 是否必填 | 说明 |
---|---|---|
NULL | 是 | 固定为0x00 |
回复数据(上面表示数据含义,下面表示示例数据):
剩余次数 | 使用次数 | 设备状态 |
---|---|---|
0x00000A | 0x00000A | 01 |
参数 | 是否必填 | 说明 |
---|---|---|
剩余次数 | 是 | 设备内剩余的次数 |
使用次数 | 是 | 设备已经使用的次数,无使用次数或者没有累计输入0 |
设备状态 | 是 | 设备状态:
0x01:启用;0x02:停用;0x03:故障。 |
示例:模块发送:EE 09 01 31 32 33 34 35 36 00 08
模块接收:66 0F 01 31 32 33 34 35 36 00 00 0A 00 00 0A 01 08
用户付款成功,通知主设备
服务器命令:LOS
描述:当用户付款以后,通知主设备付款的信息。
数据方向:模块→设备
命令:0x02
CMD! 0x02 |
---|
数据(上面表示数据含义,下面表示示例数据):
0x00000A |
---|
0x01 |
参数 | 是否必填 | 说明 |
---|---|---|
次数 | 是 | 表示本次支付下发的次数 |
下发方式 | 是 | 0x01,表示下发次数,即设备设备的剩余次数=设备内原有剩余次数+本次下发的次数
0x02,表示修正次数,表示将设备内剩余次数修改成当前下发的次数 (设备可以不支持0x02 方式,也就是默认一般是0x01,0x02 方式为预留) |
回复数据(上面表示数据含义,下面表示示例数据):
COUNT | RESULT |
---|---|
0x00000A | 0x01 |
参数 | 是否必填 | 说明 |
---|---|---|
COUNT | 是 | 目前设备内部的总共次数 |
RESULT | 是 | 0x01,成功
0x02,失败 |
示例:模块发送:EE 0C 02 30 30 30 30 30 30 00 00 0A 01 05
模块接收:66 0C 02 30 30 30 30 30 30 00 00 0A 01 05