大小黄蜂、信蜂系列云对接标准协议（停车场）

接口使用说明书

深圳信路通智能技术有限公司

Shenzhen Signaltone Intelligent Tech Co.,Ltd

版权声明

《大小黄蜂、信蜂系列云对接标准协议（停车场）接口使用说明书》的版权归深圳信路通智能技术有限公司所有。未经深圳信路通智能技术有限公司的书面准许，任何人、任何团体不得以任何形式、采用任何手段（电子的或机械的，包括照相复制或录制）、或为任何目的，进行复制或扩散本文的任何内容。

Copyright © 2001-2023 深圳信路通智能技术有限公司。版权所有，翻制必究。

商标声明

和其他信路通商标均为深圳信路通智能技术有限公司的注册商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。

深圳信路通智能技术有限公司

网址： http://www.signaltone.com.cn

地址： 深圳市南山区高新南一道 008 号创维大厦 A 座 603 室电话： (86)0755-86219229

传真： (86)0755-86219359

目 录

第一章 前言 3

第二章 协议说明 4

• 1. 协议约定 4
     1. 通讯方式 4
     2. 协议类型 4
     3. 字符集 4
     4. 数据体加密约束 4
     5. 设备返回码说明 4
  2. 报文主体说明示例 4
     1. 请求数据 4
     2. 响应数据 5

第三章 接口定义 6

• 1. 【设备—>服务】交互协议 6
     1. 设备车牌识别结果推送 6
     2. 心跳 6
     3. 全量设备下载广告规则 6
     4. 全量设备下载放行规则 7
     5. 全量设备下载停车场固定车信息 7
     6. 通知平台全量更新结果 8
  2. 【服务—>设备】交互协议 8
     1. 设备集合控制（显示、语音、闸机动作） 8
     2. 设备屏幕显示 9
     3. 设备语音播报 9
     4. 设备参数设置 10
     5. 开闸 10
     6. 落闸 10
     7. 抓拍 11
     8. 平台向设备发起更新请求 11
     9. 拍照 11

附件一 数据结构说明 13

• 1. RequestBody 说明 13
  2. ResponseBody 说明 13
  3. CarInfo 说明 13

附件二 显示模版（大小黄蜂） 14

模版 0 14

模版 1 14

模版 2 15

模版 3 17

模版 5 19

附件三 显示模版（信蜂） 20

模版 1 20

模版 2 20

附件四 设备语音播报映射 21

附件五 车辆出入图片数据推送(Http) 25

附件六 通道设备拍照图片数据推送(Http) 26

附件六 接口调用逻辑引导 27

1. 心跳 自动发送 5 秒/每次 27
2. 识别显示 27
3. 设置设备参数 28
4. 请求设备更新业务相关数据 28

第一章 前言

适用产品：大小黄蜂全系列、信蜂全系列设备。

本文旨在描述大小黄蜂、信蜂云对接标准协议接口的使用方法，内容包括大小黄蜂、信蜂云对接标准协议的协议接口约定、开发流程、编程指南、注意事项等。

为了安全和正确使用本系统，请仔细阅读具体描述过程中的“【注意】”。其安全等级如下：

1、【注意】包含有关接口的使用注意点，如果忽略，可能导致对接协议通信不正常，或者设备不能得到预期的控制。

2、对于举例部分，本文使用了“【举例】”字样以标识。

第二章 协议说明

协议约定

通讯方式

1、设备与服务器平台间间使用 WebSocket 协议做为业务数据通讯方式。

2、设备与服务器平台间间使用 Http 协议做为图片数据通讯方式。

协议类型

WebSocket 协议、Http 协议。

字符集

charset=UTF-8。

数据体加密约束

协议数据体 DataModel 统一采用 AES CBC 模式加密,加密块长度 128，填充模式 PKCS7

加密密钥 KEY:~(请联系设备提供商)

加密 IV:~ (请联系设备提供商)

设备返回码说明

1000 正常

1001 数据 json 化失败

1002 json 字段缺失

1003 设备控制异常

1004 未知协议类型

1005 数据体为空

报文主体说明示例

请求数据

• • • • DataModel 填充(详情请查看接口定义)
      • JSON 序列化 DataModel 得到 Json_DataModel
      • 使用 AES 加密 Json_DataModel
      • 填充 RequestBody 得到 RequestData
      • 序列化 RequestData 得到 Json_RequestBody
      • 示例以协议 2.1.2 的请求举例说明

{

“cmd”: “Dev.HB”,

“devNO”: “PTR-200-LS18010007”, “devIP”: “192.168.1.2”,

“time”: “2019-10-10 12:10:10”,

“data”: “{“ver”: “2.0”}”

}

【注意】示例的 data 的 value 部分会在真实通信过程中使用 AES 加密，其余部分不加

密。

响应数据

• • • • DataModel 填充(详情请查看接口定义)
      • JSON 序列化 DataModel 得到 Json_DataModel
      • 填充 ResponseBody 得到 ResponseData
      • 序列化 ResponseData 得到 Json_ResponseBody
      • 示例以协议 2.1.2 的响应举例说明

{“cmd”: “Dev.HB.Rep“,” resCode “: 0,” resMsg “: “”,” data “: “”}

第三章 接口定义

【设备—>服务】交互协议

设备车牌识别结果推送

• 请求消息类型 Dev.Result
• 请求数据体 DataModel

名称	数据类型	说明
carNO	string	车牌号码
carNOColor	string	车牌颜色
trigTime	string	触发时间 (yyyy-MM-dd HH:mm:ss)
picMax	string	大图名称
picMin	string	小图名称
confidence	int	数据可信度(0-1000)
memo	string	备注

• 响应消息类型 Dev.Result.Rep
• 响应数据体 DataModel

名称	数据类型	说明

心跳

• 请求消息类型 Dev.HB
• 请求数据 DataModel

名称	数据类型	说明
ver	string	当前设备协议版本版本
devType	string	当前设备类型

• 响应消息类型 Dev.HB.Rep
• 响应数据 DataModel

名称	数据类型	说明

全量设备下载广告规则

• 请求消息类型 Dev.AdRule
• 请求数据 DataModel

名称	数据类型	说明

• 响应消息类型 Dev.AdRule.Rep
• 响应数据 DataModel

名称	数据类型	说明
showTime	int	广告显示时长 注：仅大小黄蜂系列设备有效
sleepTime	int	显示后休眠时长 注：仅大小黄蜂系列设备有效
stayTime1	int	非二维码界面显示时长 注：即非模板 2、3 显 示时长
stayTime2	int	二维码界面显示时长 注：即模板 2、3 显示时长

【注意】：单位/秒

全量设备下载放行规则

• 请求消息类型 Dev.PassRule
• 请求数据 DataModel

名称	数据类型	说明

• 响应消息类型 Dev.PassRule.Rep
• 响应数据 DataModel

名称	数据类型	说明
free	int	启用机制(0:离线 1:在线 2:优先)
temp	int	启用机制(0:离线 1:在线 2:优先)
black	int	启用机制(0:离线 1:在线 2:优先)
freeRule	string	Json< Spa.Control >
tempRule	string	Json< Spa.Control >
blackRuler	string	Json< Spa.Control >

全量设备下载停车场固定车信息

• 请求消息类型 Dev.CarInfo
• 请求数据 DataModel

名称	数据类型	说明
page	int	请求页(初始为 0)

size

int

每页返回条数( 默认 500 条)

• 响应消息类型 Dev.CarInfo.Rep
• 响应数据 DataModel

名称	数据类型	说明
nCount	int	数据总条数
nPages	int	数据总页数
page	int	当前页数
info	string	（默认返回 500 条数据） 参考固定车辆信息说明

【注意】：根据总页数进行循环请求，指导获取所有的固定车数据,且所有固定车数据默认有效。

字段 info 结构：info=＂CarNO:CarType＂

示例：＂京 A12345:1,京 A12346:1,京 A12347:2,京 A12348:4,….. 京 A12355:5＂

通知平台全量更新结果

• 请求消息类型 Dev.OverUpdate
• 请求数据 DataModel

名称	数据类型	说明
adruler	int	广告规则 1-已更新 0-未更新 -1-更新失败
passruler	int	放行规则 1-已更新 0-未更新 -1-更新失败
carinfo	int	固定车数据 1-已更新 0-未更新 -1-更新失败

• 响应消息类型 Dev.OverUpdate.Rep
• 响应数据 DataModel

【服务—>设备】交互协议

设备集合控制（显示、语音、闸机动作）

• 请求消息类型 Spa.Control
• 请求数据 DataModel

名称	数据类型	说明
cmdName	string	命令名称 (默认: SetLCDItems)
template	int	模板 id(0, 1, 2, 3,5) ( template =0 为广告界面) 模板显示效果详见附录二、三

adID	int	广告 id 取值范围(1-2)
items	string	显示内容(模版id 不为 0 生效)
voice	string (Value:Content,Value:Conten t)	语音内容(模版 id 不为 0 生效)参考：设备语音播报
action	int	闸机动作 (1-开闸 0-不动作)

【注意】：items 字段请参考显示模版下的报文结构说明

【注意】：voice 字段说明

voice=＂Value:Content＂

【举例】：＂16:欢迎光临,…..＂

• 响应消息类型 Spa.Control.Rep
• 响应数据 DataModel

名称	数据类型	说明

设备屏幕显示

• 请求消息类型 Spa.Show
• 请求数据 DataModel

名称	数据类型	说明
cmdName	string	命令名称 (默认: SetLCDItems)
template	int	模板 id(0,1, 2, 3,5) 模板显示效果详见附录二、三
items	string	显示内容

• 响应消息类型 Spa.Show.Rep
• 响应数据 DataModel

名称	数据类型	说明

. 【注意】：items 字段请参考显示模版下的报文结构说明

设备语音播报

• 请求消息类型 Spa.Horn
• 请求数据 DataModel

名称	数据类型	说明
voice	string (Value:Content,Value:Conten t)	语音内容 参考：设备语音播报

• 响应消息类型 Spa.Horn.Rep
• 响应数据 DataModel

名称	数据类型	说明

【注意】： voice 字段说明

voice=＂Value:Content＂

【举例】：＂16:欢迎光临,…..＂

设备参数设置

• 请求消息类型 Spa.Set
• 请求数据 DataModel

名称	数据类型	说明
voluem	int	设备音量（0-100）
ad_voluem	int	视频广告音量（0-100） (仅适用大黄蜂)
brightness	int	LCD 屏幕亮度（0-100） （仅适用黄蜂系列）
status	int	屏幕 0-休眠 1-显示 （仅适用黄蜂系列）

• 响应消息类型 Spa.Set.Rep
• 响应数据 DataModel

名称	数据类型	说明

开闸

• 请求消息类型 Spa.Open
• 请求数据 DataModel

名称	数据类型	说明

• 响应消息类型 Spa.Open.Rep
• 响应数据 DataModel

名称	数据类型	说明

落闸

• 请求消息类型 Spa.Close
• 请求数据 DataModel

名称	数据类型	说明

• 响应消息类型 Spa.Close.Rep
• 响应数据 DataModel

名称	数据类型	说明

抓拍

• 请求消息类型 Spa.Photograph
• 请求数据 DataModel

名称	数据类型	说明

• 响应消息类型 Spa.Photograph.Rep
• 响应数据 DataModel

名称	数据类型	说明

平台向设备发起更新请求

• 请求消息类型 Spa.Update
• 请求数据 DataModel

名称	数据类型	说明
updateCarInfo	int	是否启动设备固定车信息更新 （0 不启动 1-启动）
updateAdRuler	int	是否启动设备广告规则更新 （0 不启动 1-启动）
updatePassRuler	int	是否启动设备放行规则更新 （0 不启动 1-启动）

• 响应消息类型 Spa.Update.Rep
• 响应数据 DataModel

名称	数据类型	说明

拍照

• 请求消息类型 Spa.SnapshotPic
• 请求数据 DataModel

名称	数据类型	说明
snapshotId	string	字符串长度 ≤ 32

• 响应消息类型 Spa.SnapshotPic.Rep
• 响应数据 DataModel

名称	数据类型	说明

附件一 数据结构说明

RequestBody 说明

cmd	string	消息类型
packageID	string	包 ID
devNO	string	设备序列号(唯一性)
devIP	string	设备 IP 地址
time	string (yyyy-MM-dd hh:mm:ss)	请使用当前时间，精确到 秒，用于设备与平台间的时间同步，同步误差<=2s
data	string	Json<DataModel>

ResponseBody 说明

cmd	string	消息类型
packageID	string	包 ID
resCode	int	错误码返回说明
resMsg	string	异常状态描述信息
time	string (yyyy-MM-dd hh:mm:ss)	请使用当前时间，精确到秒，用于设备与平台间的时 间同步，同步误差<=2s
data	string	Json<DataModel>

CarInfo 说明

CarType	int	固定车类型 月租车 产权车 储值车 贵宾车 黑名单
CarNO	string	车牌号码

附件二 显示模版（大小黄蜂）

模版示例只体现不同模版的风格以及初步的应用场景，具体显示内容可以根据实际情况进行调整。

模版 0

无控件，专门拿来发广告位图 ID=0

根据显示接口以及集合控制接口

1、template = 0 的情况下为调用广告模版。

2、adID 为控制广告显示图的序号 1 或 2(目前小黄蜂仅支持 2 张广告图)。

3、当 template=0 时，items 可以赋值为空字符串.

4、大黄蜂设备在设备配置里分为特定时间段显示视频还是图片，当配置为显示视频的时候，那个时间段控制显示广告图，则不生效。

其余请参照接口说明，这里不再另行说明.

模版 1

【举例】

(根据不同的设备类型，显示风格上有差异，以上三张图示从上至下分别是小黄蜂 3、大黄蜂 3、大黄蜂 3Max 模板 1 效果图)

说明：显示车辆信息 ID=1

1. 欢迎光临请您缴费（举例内容）控件 ID 1

控件类型 text

1. 月租车车牌号（举例内容）控件 ID 2

控件类型 text

1. 车牌号金额（举例内容）控件 ID 3

控件类型 text

1. 入场时间停车时长（举例内容）控件 ID 4

控件类型 text

大黄蜂报文结构：”1,欢迎光临,月租车,蓝桂 A12345,入场时间：2018-11-30 12:36:50” 按照 ID

顺序传如用逗号间隔 value，不填项请用空格字符替代。

【注意】：蓝 指车牌颜色

模版 2

【举例】

(根据不同的设备类型，显示风格上有差异，以上三张图示从上至下分别是小黄蜂 3、大黄蜂 3、大黄蜂 3Max 模板 1 效果图)

说明：显示用户入场未识别，出场未匹配界面 ID=2

1. 通道名称（举例内容）控件 ID 1

控件类型 text

1. 提示信息（举例内容）控件 ID 2

控件类型 text

1. 提示信息（举例内容）控件 ID 3

控件类型 text

1. 入场时间（举例内容）控件 ID 4

控件类型 text

1. 入场时间的值（举例内容）控件 ID 5

控件类型 text

1. 二维码（举例内容）控件 ID 6

控件类型 qrcode

报 文 结 构 ： ”2, 停 车 场 4- 车 道 名 称 全 , 微 信 , 扫 一 扫 , 入 场 时 间 ,2018-11-21 12:36:50,http://baidu.com” 按照 ID 顺序传如用逗号间隔 value，不填项请用空格字符替代。

模版 3

【举例】

(根据不同的设备类型，显示风格上有差异，以上三张图示从上至下分别是小黄蜂 3、大黄蜂 3、大黄蜂 3Max 模板 1 效果图)

说明：显示用户缴费界面 ID=3

1. 请您缴费（举例内容）控件 ID 1

控件类型 text

1. 车牌号（举例内容）控件 ID 2

控件类型 text

1. 金额（举例内容）控件 ID 3

控件类型 text

1. 停车时长（举例内容）控件 ID 4

控件类型 text

1. 停车时长的值（举例内容）控件 ID 5

控件类型 text

1. 二维码（举例内容）控件 ID 6

控件类型 qrcode

1. 通道名称（举例内容）控件 ID 7

控件类型 text

报文结构：”3, 请您缴费,蓝桂A23456,387.67 元,停车时长,361 天20 小时23 分,http://baidu.com,辽宁南出口 2” 按照 ID 顺序传如用逗号间隔 value，不填项请用空格字符替代。

【注意】：蓝 指车牌颜色

模版 5

【举例】

(模板 5 仅支持大黄蜂 3)

【注意】：该模版仅支持大黄蜂。 说明：显示用户缴费界面 template=5

1. 车位已满（举例内容）控件 ID 1

控件类型 text

1. 车牌号（举例内容）控件 ID 2

控件类型 text

1. 禁止入场（举例内容）控件 ID 3

控件类型 text

报文结构：” 5, 车位已满, 桂 A12345,禁止入场” 按照 ID 顺序传如用逗号间隔 value，不填项请用空格字符替代。

附件三 显示模版（信蜂）

模版示例只体现不同模版的风格以及初步的应用场景，具体显示内容可以根据实际情况进行调整。

模版 1

【举例】

说明：显示车辆信息 ID=1 1.欢迎光临（举例内容）

控件 ID 1

控件类型 text

2.桂 A12345（举例内容）控件 ID 2

控件类型 text

注：每列最多可显示 4 个字符，若超出则自动滚动。滚动速度与字体颜色可在设备网页配置界面进行配置。

信蜂报文结构：”1,欢迎光临,桂 A12345” 按照 ID 顺序传如用逗号间隔 value，不填项请用空格字符替代。

模版 2

与模板 1 相比显示效果一致，唯一区别是停留时间不同（即停留 N 秒（可配）跳转到闲时显示内容），建议要显示缴费金额等内容时，可选择模板 2，停留时间会稍长。

附件四 设备语音播报映射

Value	Content	Value	Content
0	0	39	已超时请回收费处补缴
1	1	40	大车场
2	2	41	小车场
3	3	42	入口
4	4	43	出口
5	5	44	中央收费点
6	6	45	中央收费出口
7	7	46	A
8	8	47	B
9	9	48	C
10	点	49	D
11	十	50	E
12	百	51	F
13	千	52	G
14	万	53	H
15	元	54	I
16	角	55	J
17	分	56	K
18	年	57	L
19	月	58	M
20	日	59	N
21	天	60	O
22	号	61	P
23	时	62	Q
24	分钟	63	R
25	秒	64	S
26	欢迎光临	65	T
27	一路顺风	66	U
28	一路平安	67	V
29	您好	68	W
30	请稍候	69	X
31	请缴费	70	Y
32	请补缴	71	Z
33	请扫码	72	澳
34	请入场	73	藏
35	谢谢	74	川
36	车场满位	75	鄂
37	未授权 请选其它通道	76	甘
38	未缴费请到收费处缴费	77	赣

78	港	120	请及时延期
79	贵	121	请及时充值
80	桂	122	月卡剩余
81	黑	123	临时车
82	沪	124	时租车
83	吉	125	月租车
84	冀	126	免费车
85	津	127	储值车
86	晋	128	军警车
87	京	129	贵宾车
88	警	130	已过期 请延期
89	军	131	使
90	辽	132	领
91	鲁	133	两
92	蒙	134	小时
93	闽	135	月租今天到期，请立即续期
94	宁	136	月租明天到期，请立即续期
95	青	137	月租还有
96	琼	138	天到期
97	陕	139	请尽快续期
98	苏	140	会车，请倒车
99	台	141	会车，请等待
100	皖	142	关闸请注意
101	湘	143	请减速通过
102	新	144	请注意：车道开启，正常通行
103	渝	145	请注意：车道关闭，请绕行
104	豫	146	查询中
105	粤	147	确认中
106	云	148	请等待
107	浙	149	车位已满
108	余额不足 请充值	150	无牌车
109	已过期	151	长租车
110	车牌不存在	152	请联系管理员
111	未到启用时间	153	有牌车请倒车重试
112	黑名单车牌	154	非预约车
113	车辆冻结	155	禁止入场
114	车辆判断错误	156	或倒车重试
115	此车已入场	157	如识别错请倒车重试
116	此车已出场	158	共享车位已被使用
117	重复车牌 处理无效	159	入场
118	车主车位已满 组内车不 允许入场	160	且临时车位已满
119	有效期	161	违规车辆

162	此车为违规车辆，下次禁 止入场	201	请减速通行
163	未匹配到进场记录，如果 扫码进场，请扫码出场	202	祝您平安
164	车辆被锁定，请解锁后出 场	203	欢迎再次光临
165	租期已经过期，请先续费 再出	204	武警
166	请付费或授权后出场	205	学
167	超长时间停车	206	普通车
168	停车费	207	包月车
169	请交费	208	产权车
170	请补交	209	非 VIP 车辆
171	请用	210	个
172	微信	211	所属车位已满
173	支付宝	212	谢绝进入
174	云闪付	213	路侧停车欠费
175	银联	214	请使用微信扫码
176	刷卡	215	谢绝入场
177	扫码	216	应急
178	付款码	217	余额
179	无感支付	218	停车时长
180	或	219	月卡
181	已通过	220	储值卡
182	将通过	221	此次收费
183	支付停车费	222	临时卡
184	补交停车费	223	未找到进场记录
185	扣款失败	224	停车
186	请支付停车费	225	识别成功
187	请补交停车费	226	请上磅
188	扣款停车费	227	正在过磅
189	本次停车费	228	称重完毕
190	扣款	229	请离开
191	支付成功	230	空白
192	成功	231	果
193	已付费	232	菜
194	已为您免单	233	副
195	本次不需支付停车费	234	葵
196	实名临租车	235	欢迎回家
197	交通卡	236	请入场车辆倒车 让出场车辆 离场
198	余额不足	237	人车信息未报备 请核查
199	设备故障	238	人车信息异常 请核查

200	欢迎归来	239	报备人数
		240	人
		241	购票
		242	张

附件五 车辆出入图片数据推送(Http)

图片数据用于完善业务数据，便于接收 采用 Http File 协议进行传输。协议数据分为图片数据部分 文本数据部分。协议主体如下：

• 请求 Http URL：跟图片服务器地址配置相关
• 请求数据

名称	数据类型	说明
devSeqNO	string	设备序列号
dtype	Text	二次识别类型
carno	Text	车牌号码
confid	Text	数据可信度(0-1000)
imgTime	Text	图片时间格式：yyyyMMddHHmmss
coordinate	Text	图片坐标 示例(0,30,100,100)，单位%
picMax	Text	大图名称
picMin	Text	小图名称（当识别到结果为无车牌时，此项 值为空字符串）
bigImage	File	图片数据 < 500KB
littleImage	File	图片数据 < 500KB

• 响应数据

名称	数据类型	说明
state	int	数据响应状态 0-成功 1-失败

此处的图片名称与协议 2.1.1 中的图片名称字段保持一致且唯一

【注意】：Http 服务去读取设备推送的数据时，请分成 text、bigImage、littleImage 分别读取。

附件六 通道设备拍照图片数据推送(Http)

图片数据用于完善业务数据，便于接收 采用 Http File 协议进行传输。协议数据分为图片数据部分 文本数据部分。协议主体如下：

• 请求 Http URL：跟图片服务器地址/snapshot

（举例：图片服务器地址为 http://192.168.1.2:7788/ServerPic,则当前设备拍照图片上传地址为 http://192.168.1.2:7788/ServerPic/snapshot）

• 请求数据

名称	数据类型	说明
devSeqNO	Text	设备序列号
snapshotId	Text	平台下发的 snapshotId
time	Text	拍照时间 yyyy-MM-dd hh:mm:ss
image	File	图片数据 < 500KB

• 响应数据

名称	数据类型	说明
state	int	数据响应状态 0-成功 1-失败

附件六 接口调用逻辑引导

以下接口引导只是对基本场景中的涉及接口进行调用引导,接口本身并无先后顺序.

心跳 自动发送 5 秒/每次

识别显示

第一步 上传识别结果

第二步 平台集合控制设备显示 语音 闸机动作

或 平台分别控制设备显示 语音 闸机动作

设置设备参数

请求设备更新业务相关数据

第一步 发起更新命令

第二步 设备根据更新命令启动自动更新接口，更新完成后分别通知

建议：当有平台响应数据变更时 在合适的时间通知设备更新，以免影响设备对业务的正常响应。更新数据永久存储且全量更新。