饮水机对服务端通讯文档
目录
业务协议
打开或关闭出水阀(出水板)
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器发送指令打开或关闭出水阀 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WSF |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 出水阀编号(1byte)：0 – 9
出水阀状态(1byte)：0-关闭；1-打开 脉冲值(10byte)：0000000000-2147483648 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 023 WSF DSfFGd / 1 1 00000 <0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备向服务器返回，执行打开或关闭命令，的结果 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WSF |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 出水阀编码：0 – 9 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WSF DSfFGd 001 1 <0x0D> <0x0A>
出水完成后上报
| 发送方 | 通信模块 |
| 说明 | 出水结束后，设备上报出水结果 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WSF |
| 会话ID | 6byte，A90003 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 出水阀编码：0 – 9
/ 已用脉冲数: 0 - int最大值, 不超过10byte / 状态码：0-关闭；1-打开 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RP WSF A90003 009 1 / 27824 / 0 <0x0D> <0x0A>
打开出水板总开关（出水板）
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器打开或关闭出水板总开关 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WCS |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 0-关，1-开 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 017 WCS DSfFGd / 1 <0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器状态查询 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WCS |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | S-成功，F-失败 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WCS DSfFGd 001 S <0x0D> <0x0A>
出水板模式转换（出水板）
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器转换出水板工作模式 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WMS |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 0-租金滤芯模式，1-流量计费模式 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 017 WMS DSfFGd / 1 <0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器状态查询 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WMS |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | S-成功，F-失败 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WMS DSfFGd 001 S <0x0D> <0x0A>
系统总开关（控制板）
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器打开或关闭控制板总开关 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WKG |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 0-关，1-开 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 017 WKG DSfFGd / 1 <0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器状态查询 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WKG |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | S-成功，F-失败 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WKG DSfFGd 001 S <0x0D> <0x0A>
整体状态（控制板）
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器查询饮水机当前状态 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WZT |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 0 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 017 WZT DSfFGd / 0 <0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器状态查询 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WZT |
| 会话ID | 6byte，A90002 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 热水温度：000 - 100（摄氏度）
/ 总用水量：00 – 99（吨） / 状态A（8byte）: 待用：0或1、待用：0或1、待用：0或1、总开关状态值：0或1
排空：0或1、消毒：0或1、进水：0或1、加热：0或1
（0 - 为否，1 - 为是）
/ 状态B（8byte）: 待用：0或1、待用：0或1、待用：0或1、待用：0或1
待用：0或1、满水：0或1、低水位有效：0或1、缺水：0或1
（0 - 为否，1 - 为是）
/ 故障报警（8byte）： 待用：0或1、超温：0或1、溢水：0或1、缺水：0或1
流量：0或1、传感器3：0或1、传感器2：0或1、传感器1：0或1
（0 - 为否，1 - 为是）
/ 出水TDS值：0000 / 原水TDS值：0000 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WZT A90002 043 100 / 05 / 00000000 / 00000000 / 00000000 / 0000 / 0000 <0x0D> <0x0A>
线上卡刷卡
设备上报数据（已知端口号）
| 发送方 | 通信模块 |
| 说明 | 设备上报线上卡卡号（知道端口号时） |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WKH |
| 会话ID | 6byte，A90004 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 端口号（1byte）
/ 卡号（10 byte，不足前面补零） |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WKH A90004 012 1 / 0123456789 <0x0D> <0x0A>
服务器数据响应
| 发送方 | 服务器 |
| 说明 | 服务器返回线上卡刷卡结果，若卡可用直接下发出水命令，若卡不可用则返回该响应。 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WKH |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | F |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 017 WKH DSfFGd / F <0x0D> <0x0A>
设备上报数据（不知端口号）
| 发送方 | 通信模块 |
| 说明 | 设备上报线上卡卡号（不知道端口号时） |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WSK |
| 会话ID | 6byte，A90014 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 卡号（10 byte，不足前面补零） |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WSK A90005 010 0123456789 <0x0D> <0x0A>
服务器数据响应
| 发送方 | 服务器 |
| 说明 | 服务器返回线上卡刷卡结果，若卡可用直接下发出水命令，若卡不可用则返回该响应。 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WSK |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | F-不可用，S-可用
/ 卡号（10 byte，不足前面补零） |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 028 WSK DSfFGd / S / 1234567890 <0x0D> <0x0A>
获取扫码URL和绑卡URL
设备请求扫码URL和绑卡URL
| 发送方 | 通信模块 |
| 说明 | 设备上报设备号, 向后台请求当前环境扫码URL前缀和绑卡URL前缀 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，CBK |
| 会话ID | 6byte，A90017 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 设备号, 一般是IMEI |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RP CBK A90017 015 861231234512345 <0x0D> <0x0A>
服务器数据响应
| 发送方 | 服务器 |
| 说明 | 服务器返回当前环境的扫码URL和绑卡URL, 设备异常时不会下发该接口 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，CBK |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 绑卡URL #/# 扫码URL
例如绑卡URL: https://mobile.supeeder.com/web-wechart/card/bind/861231234512345?cd= 例如扫码URL: https://mobile.supeeder.com/web-wechart/wechart/combo/choose?deviceNo= |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 158 CBK ABCDEF / https://mobile.supeeder.com/web-wechart/card/bind/861231234512345?cd=#/#https://mobile.supeeder.com/web-wechart/wechart/combo/choose?deviceNo= <0x0D> <0x0A>
租赁剩余天数（控制板）
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器下发租赁剩余天数 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WZL |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 9999-租赁剩余天数，4bytes |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 020 WZL DSfFGd / 9999 <0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器设置是否成功 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WZL |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | S-成功，F-失败 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WZL DSfFGd 001 S <0x0D> <0x0A>
设备请求服务器租赁剩余天数
| 发送方 | 通信模块 |
| 说明 | 设备请求服务器下发租赁剩余天数 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WZL |
| 会话ID | 6byte，A90021 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 0 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RP WZL DSfFGd 001 0 <0x0D> <0x0A>
滤芯寿命百分比（控制板）
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器下发滤芯寿命百分比 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WSM |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 100（滤芯1寿命百分比-3bytes）
100（滤芯2寿命百分比-3bytes） 100（滤芯3寿命百分比-3bytes） 003（滤芯4寿命百分比-3bytes） 010（滤芯5寿命百分比-3bytes） |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 031 WSM DSfFGd / 100100100003010<0x0D> <0x0A>
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器设置是否成功 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WSM |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | S-成功，F-失败 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WSM DSfFGd 001 S <0x0D> <0x0A>
设备请求服务器滤芯寿命百分比
| 发送方 | 通信模块 |
| 说明 | 设备请求服务器下发滤芯寿命百分比 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WSM |
| 会话ID | 6byte，A90020 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 0 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RP WSM DSfFGd 001 0 <0x0D> <0x0A>
开水器状态（控制板）
设备主动上报
| 发送方 | 通信模块 |
| 说明 | 设备上报服务器开水器状态 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WKS |
| 会话ID | 6byte，A90022 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | 状态A（8byte）:
UV杀菌、冲洗状态、过滤状态、过滤功能、待用、加热状态、加热功能、开关机
0或1 0或1 0或1 0或1 0 0或1 0或1 0或1
（0 - 为否，1 - 为是）
/ 状态B（8byte）: 待用、待用、待用、待用、满水位状态、高水位状态、中水位状态、低水位状态
0 0 0 0 0或1 0或1 0或1 0或1
（0 - 为否，1 - 为是）
/ 故障报警（8byte）： 干烧故障、过滤故障、加热故障、热水传感器短路、热水传感器开路、待用、漏水故障、有无故障
0或1 0或1 0或1 0或1 0或1 0 0或1 0或1
（0 - 为否，1 - 为是）
|
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RP WKS A90022 026 00000000 / 00000000 / 00000000 <0x0D> <0x0A>
水质上报
设备主动上报
| 发送方 | 通信模块 |
| 说明 | 设备上报服务器TOC值和COD值 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RP |
| 命令 | 3byte，WQA |
| 会话ID | 6byte，A90023 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | TOC值（3byte）:180
/ COD值（3byte）:003 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RP WQA A90023 007 180 / 003 <0x0D> <0x0A>
控制消毒、排空功能
服务器发送指令
| 发送方 | 服务器 |
| 说明 | 服务器启动或停止消毒、排空功能 |
| 开始标志 | 1byte，“_” |
| 报文长度 | 3byte，表示整个报文的总长度，ASCII数字表示 |
| 命令 | 3byte，WXD |
| 会话ID | 6byte，服务器生成 |
| 分隔符 | 1byte，“/” |
| 参数 | 消毒命令（2byte）：24-关，01-开（01代表开始时间，除24外都是开启）
排空命令（2byte）：24-关，01-开（01代表开始时间，除24外都是开启） |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ 018 WXD DSfFGd / 01 02 <0x0D> <0x0A> //1点启动消毒，2点启动排空
_ 018 WXD DSfFGd / 21 22 <0x0D> <0x0A> //21点启动消毒，22点启动排空
_ 018 WXD DSfFGd / 24 24 <0x0D> <0x0A> //关闭消毒功能，关闭排空功能
设备响应
| 发送方 | 通信模块 |
| 说明 | 设备响应服务器消毒、排空控制 |
| 开始标志 | 1byte，“_” |
| 响应类型 | 2byte，RS |
| 命令 | 3byte，WXD |
| 会话ID | 6byte，服务器生成 |
| 内容长度 | 3byte，表示内容长度，ASCII数字表示 |
| 内容 | S-成功，F-失败 |
| 结束标志 | 2byte，\r\n（0x0D 0x0A） |
示例:
_ RS WXD DSfFGd 001 S <0x0D> <0x0A>
