# 红绿灯信号接口文档

## 1. 上报接口定义

### 1.1 信号机实时状态上报

#### Topic

| Topic | cuse/v2/{tenantCode}/{deviceId}/data |
|-------|--------------------------------------|
| 消息发送方 | 设备 |
| 消息接收方 | 物联网平台 |

#### 参数说明

| 参数 | 必选/可选 | 类型 | 描述 |
|------|-----------|------|------|
| topic | 必选 | String | 设备参数上报固定为"deviceReq" |
| encryptFlag | 必选 | Short | 加密方式，0-不加密 1-AES128 加密 |
| serviceId | 必选 | String | 上报服务的标识 |
| reportTime | 必选 | Long | 设备参数上报时间 |
| serviceType | 必选 | String | 服务类型(设备上报数据类型) 固定值"ras-traffic-lights" |
| serviceData | 必选 | Object | 具体上报的数据集合，若采用 SM4 加密方式，则进行数据加密 |

#### serviceData

| 参数 | 必选/可选 | 类型 | 描述 |
|------|-----------|------|------|
| collectTime | 必选 | Long | 上报时间 |
| deviceSn | 可选 | String | 终端设备序列号 |
| deviceName | 可选 | String | 终端设备名称 |
| manufacturer | 可选 | String | 厂商编码 |
| modelName | 可选 | String | 设备类型名称 |
| trafficLightId | 必选 | String | 红绿灯设备 ID |
| signalStatus | 必选 | String | 信号灯状态 |
| longitude | 必选 | Double | 经度坐标，14位小数 |
| latitude | 必选 | Double | 纬度坐标，14位小数 |
| altitude | 必选 | Double | 海拔高度，6位小数 |
| areaId | 必选 | String | 信号机所处区域 ID |
| intersection | 必选 | String | 信号机所处路口名称 |
| generateTime | 必选 | Long | unix 时间戳 |