更新时间:2024-10-24 GMT+08:00
分享

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参数

表1 请求Body参数

参数

是否必选

参数类型

描述

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:空档

  • 1:停止档

  • 2:前进档

  • 3:倒档

  • 7:不可用

  • 4-6:预留

最小值: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

表2 ReportedPosition3D

参数

是否必选

参数类型

描述

lat

Object

参数说明:定义纬度数值,北纬为正,南纬为负。单位°,精度小数点后7位。

最小值:-90

最大值:90.0000001

lon

Object

参数说明:定义经度数值。东经为正,西经为负。单位°,精度小数点后7位。

最小值:-179.9999999

最大值:180.0000001

ele

Object

参数说明:定义车辆海拔高程,可选,单位为分米。数值-4096 表示无效数值。

最小值:-4096

最大值:61439

表3 Brakes

参数

是否必选

参数类型

描述

abs

Integer

参数说明:刹车防抱死系统(ABS)状态。

取值范围

  • 0:系统未装备或不可用

  • 1:系统处于关闭状态

  • 2:系统处于开启状态,但未触发

  • 3:系统被触发,处于作用状态

最小值:0

最大值:3

scs

Integer

参数说明:车辆动态稳定控制系统状态。

取值范围

  • 0:系统未装备或不可用

  • 1:系统处于关闭状态

  • 2:系统处于开启状态,但未触发

  • 3:系统被触发,处于作用状态

最小值:0

最大值:3

brake_boost

Integer

参数说明:刹车助力系统作用情况。通过刹车辅助系统的状态,指示车辆紧急刹车状态。刹车辅助系统通过判断紧急情况是否需要急刹车,从而接管刹车系统,在驾驶员未来得及做出反应时进行刹车。辅助系统可能通过监测油门踏板的突然松开或前置检测器,来判断紧急刹车的需求。

取值范围

  • 0:系统未装备或不可用

  • 1:系统处于关闭状态

  • 2:系统处于开启状态

最小值:0

最大值:2

aux_brakes

Integer

参数说明:辅助制动系统(一般指手刹)情况。

取值范围

  • 0:系统未装备或不可用

  • 1:系统处于关闭状态

  • 2:代表系统处于开启状态

  • 3:预留

最小值:0

最大值:3

brake_pedal

Integer

参数说明:指示刹车踏板状态,是否处在被踩下状态。

取值范围

  • 0:不可用

  • 1:非踩下状态

  • 2:踩下状态

最小值:0

最大值:2

traction

Integer

参数说明:牵引力控制系统实时状态。

取值范围

  • 0:系统未装备或不可用

  • 1:系统处于关闭状态

  • 2:系统处于开启状态,但未触发

  • 3:系统被触发,处于作用状态

最小值: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

表4 VehicleClass

参数

是否必选

参数类型

描述

classification

Integer

参数说明:定义车辆基本类型。车辆基本类型说明参见“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。

最小值:0

最大值:255

fuel_type

Integer

参数说明:定义车辆的燃料动力类型,10-15暂未定义。

取值范围

  • 0:未知

  • 1:汽油

  • 2:乙醇

  • 3:柴油

  • 4:电动

  • 5:混合燃料类型

  • 6:氢气

  • 7:液化天然气

  • 8:压缩天然气

  • 9:丙烷

最小值:0

最大值:15

表5 AccelSet

参数

是否必选

参数类型

描述

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

表6 ReportedVehicleSize

参数

是否必选

参数类型

描述

width

Integer

参数说明:车辆车身宽度。单位为0.01米。值为0时代表无效数值。

最小值:0

最大值:1023

length

Integer

参数说明:车辆车身长度。单位为0.01米。值为0时代表无效数值。

最小值:0

最大值:4095

height

Integer

参数说明:车辆车身高度。单位为0.05米。值为0时代表无效数值。

最小值:0

最大值:127

表7 MotionCfd

参数

是否必选

参数类型

描述

speed_cfd

Integer

参数说明:数值描述了95%置信水平的速度精度。 取值范围

  • 0:不可用

  • 1:100m/s

  • 2:10m/s

  • 3:5m/s

  • 4:1m/s

  • 5:0.1m/s

  • 6:0.05m/

  • 7:0.01m/s

最小值:0

最大值:7

heading_cfd

Integer

参数说明:数值描述了95%置信水平的航向精度。 取值范围

  • 0:不可用

  • 1:10°

  • 2:5°

  • 3:1°

  • 4:0.1°

  • 5:0.05°

  • 6:0.01°

  • 7:0.0125°

最小值:0

最大值:7

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
}

相关文档