OBU上报BSM
功能介绍
OBU上报bsm消息到平台。车辆基本安全消息,用来在车辆之间交换安全状态数据。车辆通过该消息的广播,将自身的实时状态告知周围车辆,以此支持一系列协同安全等应用。
上行TOPIC
oc/devices/{vehicle_id}/user/obu/bsm/up
topic中{vehicle_id}替换为创建车辆时填写的vehicle_id(车辆唯一标识符)。例如vehicle_id为test123,topic:oc/devices/test123/user/obu/bsm/up。
Message参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
vehicle_id |
是 |
String |
参数说明:车辆唯一标识符。 取值范围:长度不超过128,只允许字母、数字、以及_-等字符的组合。 |
time_stamp |
是 |
String |
"参数说明:数据采集UTC时间。格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z',例如 2021-01-08T02:03:41.907Z。 |
speed |
是 |
Integer |
参数说明:车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值:0 最大值:8191 |
heading |
是 |
Integer |
参数说明:车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值:0 最大值:28800 |
transmission |
是 |
Integer |
参数说明:车辆档位状态。 取值范围: 最小值:0 最大值:7 |
pos |
是 |
ReportedPosition3D object |
参数说明:位置信息。 |
brakes |
否 |
Brakes object |
参数说明:车辆的刹车系统状态,包括7种不同类型的状态。 |
vehicle_class |
是 |
VehicleClass object |
参数说明:车辆类型,包含车辆基本类型以及燃料动力类型。 |
accel_set |
是 |
AccelSet object |
参数说明:车辆四轴加速度。 |
size |
是 |
ReportedVehicleSize object |
参数说明:定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸,其中高度数值为可选项。 |
motion_cfd |
否 |
MotionCfd object |
参数说明:车辆运行状态的精度。包括车速精度、航向精度。 |
pos_confidence |
否 |
Integer |
参数说明:数值描述了95%置信水平的车辆位置精度。位置精度说明参见“API参考 > 附录 > 参数说明列表 > 位置精度”。 最小值:0 最大值:15 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
lat |
是 |
Object |
参数说明:定义纬度数值,北纬为正,南纬为负。单位°,精度小数点后7位。 最小值:-90 最大值:90.0000001 |
lon |
是 |
Object |
参数说明:定义经度数值。东经为正,西经为负。单位°,精度小数点后7位。 最小值:-179.9999999 最大值:180.0000001 |
ele |
否 |
Object |
参数说明:定义车辆海拔高程,可选,单位为分米。数值-4096 表示无效数值。 最小值:-4096 最大值:61439 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
abs |
否 |
Integer |
参数说明:刹车防抱死系统(ABS)状态。 取值范围: 最小值:0 最大值:3 |
scs |
否 |
Integer |
参数说明:车辆动态稳定控制系统状态。 取值范围: 最小值:0 最大值:3 |
brake_boost |
否 |
Integer |
参数说明:刹车助力系统作用情况。通过刹车辅助系统的状态,指示车辆紧急刹车状态。刹车辅助系统通过判断紧急情况是否需要急刹车,从而接管刹车系统,在驾驶员未来得及做出反应时进行刹车。辅助系统可能通过监测油门踏板的突然松开或前置检测器,来判断紧急刹车的需求。 取值范围: 最小值:0 最大值:2 |
aux_brakes |
否 |
Integer |
参数说明:辅助制动系统(一般指手刹)情况。 取值范围: 最小值:0 最大值:3 |
brake_pedal |
否 |
Integer |
参数说明:指示刹车踏板状态,是否处在被踩下状态。 取值范围: 最小值:0 最大值:2 |
traction |
否 |
Integer |
参数说明:牵引力控制系统实时状态。 取值范围: 最小值:0 最大值:3 |
wheel_brakes |
否 |
Array of integers |
参数说明:车辆车轮制动情况,定义四轮分别的刹车状态。 将车辆的轮胎分为左前、右前、左后、右后四组。当车辆进行刹车时,对应值分别指示了四组轮胎的刹车情况。 当车辆为单排轮胎(摩托车等)时,以左前和左后表示其前后轮。 当车辆某一组轮胎由多个组成时,其状态将等效到一个数值来表示。 取值范围:数组长度固定为5,数组元素类型为0或1的整数。例如:[1,0,0,1,1],表示含义:车辆整体车轮制动可用;左前轮刹车未激活;左后轮刹车未激活;右前轮刹已激活;右后轮刹车已激活。 第1个元素取值含义:车辆整体车轮制动是否可用。0:不可用,1:可用。 第2个元素取值含义:左前轮刹车是否处于激活状态。0:否,1:是。 第3个元素取值含义:左后轮刹车是否处于激活状态。0:否,1:是。 第4个元素取值含义:右前轮刹车是否处于激活状态。0:否,1:是。 第5个元素取值含义:右后轮刹车是否处于激活状态。0:否,1:是。 最小值:0 最大值:1 数组长度:5 - 5 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
classification |
否 |
Integer |
参数说明:定义车辆基本类型。车辆基本类型说明参见“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。 最小值:0 最大值:255 |
fuel_type |
否 |
Integer |
参数说明:定义车辆的燃料动力类型,10-15暂未定义。 取值范围: 最小值:0 最大值:15 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
long |
否 |
Integer |
参数说明:车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值:-2000 最大值:2001 |
lat |
否 |
Integer |
参数说明:车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值:-2000 最大值:2001 |
vert |
否 |
Integer |
参数说明:定义Z轴方向的加速度大小,Z轴方向竖直向下,沿着Z轴方向为正。 分辨率为0.02G,G为重力加速度值9.80665m/s2。 最小值:-127 最大值:127 |
yaw |
否 |
Integer |
参数说明:车辆横摆角速度。指汽车绕垂直轴的偏转,该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值,说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正,逆时针为负。 数据分辨率为0.01°/s。 最小值:-127 最大值:127 |
Message示例
{ "vehicle_id" : "test_v_001", "time_stamp" : "2021-01-08T02:03:41.907Z", "speed" : 3000, "heading" : 10000, "transmission" : 2, "pos" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "brakes" : { "abs" : 1, "scs" : 1, "brake_boost" : 1, "aux_brakes" : 1, "brake_pedal" : 1, "traction" : 1, "wheel_brakes" : [ 1, 0, 0, 1, 1 ] }, "vehicle_class" : { "classification" : 54, "fuel_type" : 5 }, "accel_set" : { "long" : 0, "lat" : 0, "vert" : 0, "yaw" : 0 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 }, "motion_cfd" : { "speed_cfd" : 5, "heading_cfd" : 5 }, "pos_confidence" : 10 }