读头标品HTTP&TCP协议文档（DejaOS版本）

# 读头标品HTTP&TCP协议文档

本协议支持：
 **http/https/tcp**

## 格式

应答数据格式：`code=`xxxx 结果码，后续数据用`&&`间隔，格式为`key=val`

## 结果码
0000~0008 成功、语音，执行成功行为，其他动作执行失败行为

|结果码|描述|动作|
|--|--|--|
|0000|成功|成功|
|00ff|http协议下升级|失败|
|01ff|获取配置|失败|
|02ff|显示UI信息|失败|
|03ff|http协议下升级（仅带语音或UI设备支持）|失败|
|0001|5/9.wav（仅带语音设备支持）|成功|
|----|.... （仅带语音设备支持）|成功|
|0008|12/16.wav（仅带语音设备支持）|成功|

## 后续数据

1. code=0000时：（带UI设备支持）
目前仅支持json格式
`如:code=0000&&desc=json&&{"resultCode":"0000","wavFileName":"0","msg":"message","msgTimeout":2000}`
json 支持字段如下表

| 参数名 | 说 明 | 类 型 | 必 须 | 备 注 |
| :----------: | :-----------: | :------: | :----: | :---------------------------|
| msg | 提示信息 | String | 否 | 当设备支持UI时将弹窗显示此信息 |
| msgTimeout | 提示时间 | Int | 否 | 单位:`ms`，当设备支持UI时，UI显示`msg`的时间 此项不存在默认显示时间:`1500ms` |
| wavFileName | 音频文件名 | String | 否 | 此项不存在播放默认语音 此项存在则播放对应名称的语音 如`"wavFileName":"9"`则播放`9.wav` 注：若此项存在需关闭网络传输行为中的`播报语音` |
| resultCode | 结果码 | String | 否 | 若此项存在且不等于`"0000"`如`"resultCode":"0001"` 设备将不执行成功动作（继电器不会动作） |

2. code=00ff时：
`code=00ff&&url=http://10.102.106.229/vbar.tar.xz&&reboot=1`

- code=03ff时：（带语音或UI设备支持）
`code=03ff&&url=http://10.102.106.229/vbar.tar.xz&&reboot=1`
  |字段|描述|
  |--|--|
  |url|升级包下载链接|
  |reboot|设备是否自动重启|

3. code=01ff时：
服务器应答时，无后续数据；
收到此应答，设备再次发送请求，输出配置信息：
`vgdevicecfginforesult=`XXX
4. code=02ff时：（带UI设备支持）
`code=02ff&&msg=message`
5. code=0001~0008时：（带语音设备支持）
无后续数据，播放音频；
	 |描述|音频|
   |--|--|
   |old|5~12.wav|
   |new|9~16.wav|