CM53 道闸网关 — 车道事件协议(设备 → 平台 → 应用)

项目 说明
协议名称 车道事件上报 / 车道事件回调
上行 cmd laneIncident
下发回调 cmd(平台 → 应用) barrierGatewayLaneEvent
协议版本
适用设备 CM53 道闸网关(typeId = 12)
上行通道 NSQ 主题 nqDeviceV2
回调通道 平台按应用配置的回调地址主动 POST
平台入口 应用中心 → 接口调试 → 道闸网关接口 → 「车道事件[回调]」

说明:本协议是上行协议。CM53 检测到车道事件后主动上报平台,平台再按「应用」维度的
车道事件回调开关,将事件转发给第三方应用的回调地址。设备侧不需要等待平台响应即可继续运行。


1. 业务说明

CM53 道闸网关
   │ 检测到车道事件(跟车、折返、强行冲杆、防砸、故障等)
   │ 上报 NSQ:{"cmd":"laneIncident","deviceNo":"...","data":{...}}
   ▼
物联网平台(consumer:DeviceNsqMessageDeal)
   │ 1. 校验设备版本为 V2、设备存在
   │ 2. 记录/统计事件(同一设备 + typeNo + eventCode 计数)
   │ 3. 转发车场坐席(原有逻辑,与设备是否绑定应用无关)
   │ 4. 查询设备所属应用的【车道事件回调】开关
   ▼
应用(第三方平台回调地址)
   │ 返回 {"resultCode":"1"} 表示接收成功
   ▼
平台按 4 次重试、每次间隔 1s 的策略重发,直到对端返回成功

1.1 回调开关(开启上行回调接口的 laneEventStatus 字段)

车道事件是否转发给应用,由【开启上行回调】接口中的 laneEventStatus 字段控制:

POST /openApi/gateway/openCallback
cmd = barrierGatewayOpenCallback

{
  "onlineStatus": 1,
  "laneEventStatus": 1     // 0:关闭车道事件回调,1:开启(不传按关闭处理)
}

平台将该配置保存在「应用 - 设备」关联记录上,设备上报事件时读取一次:

  • laneEventStatus = 1 → 满足权限时转发回调
作者:吴勇  创建时间:2026-10-24 15:52
最后编辑:吴勇  更新时间:2026-10-24 16:18