@@ -8,14 +8,17 @@ import "osi_object.proto";
88
99package osi3 ;
1010
11+ // \brief The vehicle-class is about the non-perceivable information, that is measured or
12+ // calculated and transported by the board net.
13+ // A dynamic model can serve as input provider.
14+ // Sensors, mockups or other modules can make usage of the host vehicle data.
15+ // It consists of different messages categorizing the vehicle in:
16+ // Vehicle-Basics, Vehicle-Powermanagement, Vehicle-Powertrain, Vehicle-SteeringWheel, Vehicle-Wheels, Vehicle-Localization.
1117//
12- // \brief Interface for updating internal states of host vehicle data to simulation environment.
13- // Sensors, mockups and other functions can access the host vehicle data.
14- // A Usecase like simulation of vehicle model is also possible by extending the OSI with host vehicle data.
15-
1618// \image html OSI_HostVehicle.svg
1719//
1820// All coordinates and orientations are relative to the global ground truth coordinate system.
21+ // Otherwise it is mentioned explicitly.
1922//
2023message HostVehicleData
2124{
@@ -33,75 +36,38 @@ message HostVehicleData
3336 // \note Note that dimension and base_polygon need not be set.
3437 //
3538 optional BaseMoving location_rmse = 2 ;
36-
37- // The interface version used by the sender (i.e. the simulation
38- // environment).
39- //
40- optional InterfaceVersion version = 3 ;
41-
42- // The data timestamp of the simulation environment. The zero time point is
43- // arbitrary but must be identical for all messages.
44- // Recommendation: Zero time point for start point of the simulation.
45- //
46- // \note Zero time point does not need to coincide with the UNIX epoch.
47- //
48- // \note For ground truth data this timestamp coincides both with the
49- // notional simulation time the data applies to and the time it was sent
50- // (there is no inherent latency for ground truth data, as opposed to
51- // sensor data).
52- //
53- optional Timestamp timestamp = 4 ;
54-
55- // Contains all the perceivable information.
56- //
57- optional MovingObject moving_object = 5 ;
5839
59- // Contains all the non-perceivable information, that is measured or
60- // calculated and transported by the board net.
61- //
62- optional HostVehicleDataClass host_vehicle_data = 6 ;
63- }
64-
65- //
66- // \brief The vehicle-class is about the non-perceivable information, that is measured or
67- // calculated and transported by the board net.
68- // It consists of different messages categorizing the vehicle in:
69- // Vehicle-Basics, Vehicle-Powermanagement, Vehicle-Powertrain, Vehicle-SteeringWheel, Vehicle-Wheels, Vehicle-Localization.
70- // As it is an description of the whole vehicle (focus on cars) it can be used as interface for various reasons.
71- //
72- message HostVehicleDataClass
73- {
74- // The ID of the object.
40+ // The ID of the object. Can be discussed.
7541 //
7642 // \rules
7743 // is_globally_unique
7844 // \endrules
7945 //
80- optional Identifier id = 1 ;
46+ optional Identifier id = 3 ;
8147
8248 // The basic parameters of the vehicle.
8349 //
84- optional VehicleBasics vehicle_basics = 2 ;
50+ optional VehicleBasics vehicle_basics = 4 ;
8551
8652 // Interface regarding the powermanagement.
8753 //
88- optional VehiclePowermanagement vehicle_powermanagement = 3 ;
54+ optional VehiclePowermanagement vehicle_powermanagement = 5 ;
8955
9056 // Interface regarding the powertrain.
9157 //
92- optional VehiclePowertrain vehicle_powertrain = 4 ;
58+ optional VehiclePowertrain vehicle_powertrain = 6 ;
9359
9460 // Interface regarding the steering wheel.
9561 //
96- optional VehicleSteeringWheel vehicle_steering_wheel = 5 ;
62+ optional VehicleSteeringWheel vehicle_steering_wheel = 7 ;
9763
9864 // Interface regarding the wheels.
9965 //
100- optional VehicleWheels vehicle_wheels = 6 ;
66+ optional VehicleWheels vehicle_wheels = 8 ;
10167
10268 // Interface regarding the navigation.
10369 //
104- optional VehicleLocalization vehicle_localization = 7 ;
70+ optional VehicleLocalization vehicle_localization = 9 ;
10571
10672 //
10773 // \brief The absolute base parameters of the vehicle.
@@ -292,20 +258,20 @@ message HostVehicleDataClass
292258 // \par References:
293259 // - http://adaptivemap.ma.psu.edu/websites/6_friction/dry_friction/dryfriction.html
294260 //
295- optional double kinetic_friction_coefficient = 3 ;
261+ // optional double kinetic_friction_coefficient = 3;
296262
297263 // Contact point of the mid of the tire tread with the world.
298264 // Absolute coordinates (x, y, z).
299265 //
300266 // Unit: m
301267 //
302- optional Vector3d contact_point = 4 ;
268+ // optional Vector3d contact_point = 4;
303269
304270 // Contains the rotational speed of each wheel per second.
305271 //
306272 // Unit: rad/s
307273 //
308- optional double rotational_speed = 5 ;
274+ // optional double rotational_speed = 5;
309275
310276 // Contains the longitudinal slip of the tire.
311277 // \par References:
@@ -318,9 +284,10 @@ message HostVehicleDataClass
318284 }
319285
320286 //
321- // \brief This message contains all the necessary information of the localization solution.
287+ // \brief This message contains all the information the vehicle knows about its kinematic states.
288+ // Usually
322289 //
323- message VehicleLocalization
290+ message VehicleKinematics
324291 {
325292 //
326293 // \brief This message contains information about the vehicle's knowledge about its own cartesian position.
@@ -329,7 +296,11 @@ message HostVehicleDataClass
329296 {
330297 // To be discussed.
331298 // xyz, pitch,roll,yaw., velocities, accelerations, one level higher
332- optional BaseMoving cartesian_data
299+ optional BaseMoving cartesian_data = 1 ;
300+
301+ // To be discussed.
302+ // xyz, pitch,roll,yaw., velocities, accelerations, one level higher
303+ optional BaseMoving cartesian_data_rmse
333304 }
334305
335306 //
0 commit comments