1. 上行报文(设备 → 平台)
平台以 POST 方式向应用配置的回调地址推送:
{
"appId": "ym1a2b3c4d5e6f7g8",
"expires": "1761004215",
"sign": "9f2c1d...",
"deviceNo": "CM53A1B2C3D4",
"cmd": "barrierGatewayLaneEvent",
"data": "{\"deviceNo\":\"CM53A1B2C3D4\",\"eventNo\":\"20261021093015001\",\"typeNo\":\"136\",...}"
}| 字段 | 说明 |
|---|---|
| appId | 应用 appId |
| expires | 签名过期时间(秒级时间戳) |
| sign | 签名,算法与开放接口一致(data 参与签名,规则见《开放接口签名说明》) |
| deviceNo | 设备序列号 |
| cmd | 固定 barrierGatewayLaneEvent |
| data | 事件内容 |
1.2 data 字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| deviceNo | String | 是 | 设备序列号(与消息体 deviceNo 一致) |
| eventNo | String | 是 | 事件流水号,设备内唯一,建议 yyyyMMddHHmmss + 3 位序号 |
| typeNo | String | 是 | 事件类型编号,见 2.3 |
| eventCode | String | 否 | 事件子码;typeNo = 300 时为道闸故障码,见 2.4 |
| eventName | String | 否 | 事件名称,平台未匹配到 typeNo 时兜底展示 |
| eventLevel | Integer | 否 | 事件级别,1:提示,2:告警,3:严重 |
| carNo | String | 否 | 关联车牌号,无车牌时为空串 |
| img | String | 否 | 事件抓拍图地址(OSS/HTTP),无图时为空串 |
| video | String | 否 | 事件短视频地址,无视频时为空串 |
| msgData | String | 否 | 事件描述/附加信息 |
| timeStamp | String | 是 | 事件发生时间,秒级时间戳字符串 |
2.3 事件类型 typeNo
| typeNo | 事件 | typeNo | 事件 |
|---|---|---|---|
| 004 | 折返事件 | 143 | 地感无车 |
| 005 | 跟车事件 | 144 | 车队模式 |
| 129 | 遥控开闸 | 145 | 防砸信号输入 |
| 130 | 遥控关闸 | 146 | 防砸地感消失 |
| 132 | 长时间滞留 | 147 | 遥控停闸 |
| 134 | 开关闸异常 | 148 | 人工开闸 |
| 135 | 强行抬杆 | 151 | 开到位 |
| 136 | 强行冲杆 | 152 | 关到位 |
| 137 | 强行撞杆 | 153 | 离开开到位 |
| 138 | 闸杆异常 | 154 | 离开关到位 |
| 140 | 车过关闸 | 161 | 按键开闸 |
| 141 | 超时关闸 | 162 | 按键关闸 |
| 142 | 地感有车 | 163 | 按键停闸 |
| 300 | 道闸故障(eventCode 必填) |
2.4 道闸故障码 eventCode(typeNo = 300 时)
| eventCode | 故障名称 | 故障原因 |
|---|---|---|
| NUL | 未找限位 | 控制器未找开关闸限位 |
| E01 | 电机堵转 | 闸杆运行过程中出现阻塞 |
| E02 | 电机未接或霍尔故障 | 控制器没有收到电机霍尔信号 |
| E03 | 电机过流 | 电机工作过程电流超出设置范围 |
| E04 | 未找零 | 控制器未完成原点归零校准 |
| E05 | 未学习行程 | 控制器里没有保存行程数据 |
| E08 | 电源电压低 | 开关电源电压过低 |
| E09 | 后备电源电压低 | 后备蓄电池电量不足或已经失效 |
| E10 | 被抬杆 | 闸杆关到位后,杆被人为抬起 |
| IDLE | 电机未接或霍尔故障 | 控制器没有收到电机霍尔信号 |
| Err2 | 电机过流 | 速度过快引起 |
| Err3 | 电机堵转 | 闸杆运行过程中出现阻塞 |
| Err4 | 电机堵转 | 闸杆运行过程中出现阻塞 |
| Err7 | 电机类型错误 | 参数设置错误 |
| Err9 | 电机反转 | 起杆过程中,出现弹簧断了 |
应用返回体(平台据此判断是否重试):
{ "resultCode": "1", "message": "success" }resultCode = "1"→ 平台判定成功,停止重试;- 其他或超时 → 平台重试 4 次,每次间隔 1 秒。
作者:吴勇 创建时间:2026-10-24 15:54
最后编辑:吴勇 更新时间:2026-10-24 16:18
最后编辑:吴勇 更新时间:2026-10-24 16:18