自助洗车机设备入网通讯协议V1.0
1 通讯协议
后台服务器与洗车机设备之间的应用层通信连接采用UDP方式。
2 报文结构
报文由报文长度、报文头、报文体、校验四部分组成。
3 报文体定义
3.1 数据类型
数据类型
说明
范围
U32
无符号长整数 4字节
0x0~0xFFFFFFFF
U16
无符号整数 2字节
0x0~0xFFFF
U8
无符字符 1字节
0x0~0xFF
STR
字符串
多字节数值传输时,字节高位先传,低位后传。
3.2 心跳
3.2.1 心跳请求(上行)
命令:0x01报文体格式
序号
字段名
类型
字段说明
1
时间计数
U32
系统10ms计数值
2
设备状态
U8
Bit0:清水浮球状态
0:正常 1:缺水
Bit1:泡沫浮球1状态
0:正常 1:泡沫
Bit2: 泡沫浮球2状态
0:正常 1:少泡沫
Bit3:营业状态
0:正常营业
1:12小时未营业
说明:命令为0x01
3.2.2 心跳应答(下行)
命令:0x01 报文体格式
序号
字段名
类型
字段说明
1
年
U16
服务器当前时间
2
月
U8
3
日
U8
4
时
U8
5
分
U8
6
秒
U8
7
配置同步标志
U8
0:不同步
1:同步
如果标志为1,设备接下来从服务器上请求同步配置信息
3.3 配置信息同步
3.3.1 配置信息同步请求(上行)
命令:0x02 报文体格式
序号
字段名
类型
字段说明
说明:无报文体
3.3.2 配置信息(下行)
命令:0x02 报文体格式
序号
字段名
类型
字段说明
1
管理员电话
STR
字符串,15字节
2
单次消费
U32
单次消费金额 单位(分)
3
水价
U16
单位秒
4
泡沫价
U16
单位秒
5
上报方式
U8
0:关闭 1:短信 2:GPRS
6
上传标志
U8
0:定时 1:实时
7
上传时间
U8
定时上报时间点
8
主IP
U32
9
主端口
U16
10
从IP
U32
11
从端口
U16
12
网点编号
U16
13
网点名称
STR
字符串 20字节
14
开灯时间(时)
U8
照明灯工作时间
15
开灯时间(分)
U8
16
关灯时间(时)
U8
17
关灯时间(分)
U8
18
卡上余额提醒门限
U32
单位 分
3.3.3 配置信息确认(上行)
命令:0x06 报文体格式
序号
字段名
类型
字段说明
3.4 消费
记录
混凝土 养护记录下载土方回填监理旁站记录免费下载集备记录下载集备记录下载集备记录下载
上传
3.4.1 上报(上行)
命令:0x03 报文体格式
序号
字段名
类型
字段说明
1
卡号
U32
现金消费时,卡号无效
2
网点编号
U16
3
流水号
U16
4
消费金额
U16
单位分
5
充值金额
U16
单位分
6
消费类型
U8
1:现金消费 2:卡消费
7
时间(年)
U16
消费结束时间
8
时间(月)
U8
9
时间(日)
U8
10
时间(时)
U8
11
时间(分)
U8
12
时间(秒)
U8
3.4.2 应答(上行)
命令:0x03 报文体格式
序号
字段名
类型
字段说明
3.5 卡状态查询
3.5.1 请求(上行)
命令:0x04 报文体格式
序号
字段名
类型
字段说明
1
卡号
U32
3.5.2 应答(下行)
命令:0x04 报文体格式
序号
字段名
类型
字段说明
1
卡号
U32
2
卡状态
U8
0:未激活
1:激活
其他保留
3.6 设备故障上报
3.6.1 请求(上行)
命令:0x05 报文体格式
序号
字段名
类型
字段说明
1
设备状态
U32
Bit0:清水浮球状态
0:正常 1:缺水
Bit1:泡沫浮球1状态
0:正常 1:泡沫
Bit2: 泡沫浮球2状态
0:正常 1:少泡沫
Bit3:营业状态
0:正常营业
1:12小时未营业
3.6.2 应答(下行)
命令:0x05 报文体格式
序号
字段名
类型
字段说明