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