osi3::HostVehicleData::VehicleAutomatedDrivingFunction Struct Reference

State of one automated driving function on the host vehicle. More...

Collaboration diagram for osi3::HostVehicleData::VehicleAutomatedDrivingFunction:

Classes

struct	DriverOverride
	Driver override information. More...

Public Types

enum	Name { NAME_UNKNOWN = 0, NAME_OTHER = 1, NAME_BLIND_SPOT_WARNING = 2, NAME_FORWARD_COLLISION_WARNING = 3, NAME_LANE_DEPARTURE_WARNING = 4, NAME_PARKING_COLLISION_WARNING = 5, NAME_REAR_CROSS_TRAFFIC_WARNING = 6, NAME_AUTOMATIC_EMERGENCY_BRAKING = 7, NAME_AUTOMATIC_EMERGENCY_STEERING = 8, NAME_REVERSE_AUTOMATIC_EMERGENCY_BRAKING = 9, NAME_ADAPTIVE_CRUISE_CONTROL = 10, NAME_LANE_KEEPING_ASSIST = 11, NAME_ACTIVE_DRIVING_ASSISTANCE = 12, NAME_BACKUP_CAMERA = 13, NAME_SURROUND_VIEW_CAMERA = 14, NAME_ACTIVE_PARKING_ASSISTANCE = 15, NAME_REMOTE_PARKING_ASSISTANCE = 16, NAME_TRAILER_ASSISTANCE = 17, NAME_AUTOMATIC_HIGH_BEAMS = 18, NAME_DRIVER_MONITORING = 19, NAME_HEAD_UP_DISPLAY = 20, NAME_NIGHT_VISION = 21, NAME_URBAN_DRIVING = 22, NAME_HIGHWAY_AUTOPILOT = 23, NAME_CRUISE_CONTROL = 24, NAME_SPEED_LIMIT_CONTROL = 25 }
	A list of possible automated driving features. More...

enum	State { STATE_UNKNOWN = 0, STATE_OTHER = 1, STATE_ERRORED = 2, STATE_UNAVAILABLE = 3, STATE_AVAILABLE = 4, STATE_STANDBY = 5, STATE_ACTIVE = 6 }
	The state that the feature is in. More...

Public Attributes

optional Name	name = 1
	The particular driving function being reported about. More...

optional string	custom_name = 2
	Custom driving function name. More...

optional State	state = 3
	The state of the function. More...

optional string	custom_state = 4
	Custom state. More...

optional DriverOverride	driver_override = 5
	Whether, and how, the driver has overridden this function. More...

repeated KeyValuePair	custom_detail = 6
	Custom detail. More...

Detailed Description

State of one automated driving function on the host vehicle.

Member Enumeration Documentation

◆ Name

enum osi3::HostVehicleData::VehicleAutomatedDrivingFunction::Name

A list of possible automated driving features.

Note: This can span (in theory) from Level 0 all the way to Level 5.

References:: [1] CLEARING THE CONFUSION: Recommended Common Naming for Advanced Driver Assistance Technologies, SAE International, Retrieved October 22, 2021, from https://www.sae.org/binaries/content/assets/cm/content/miscellaneous/adas-nomenclature.pdf [2] Automated Driving, German Association of the Automotive Industry (VDA), Retrieved October 22, 2021, from https://www.vda.de/en/topics/innovation-and-technology/automated-driving/automated-driving

Enumerator
NAME_UNKNOWN	Unknown feature, should not be used.
NAME_OTHER	Custom feature, see custom_name.
NAME_BLIND_SPOT_WARNING	Blind spot warning.
NAME_FORWARD_COLLISION_WARNING	Forward collision warning.
NAME_LANE_DEPARTURE_WARNING	Lane departure warning.
NAME_PARKING_COLLISION_WARNING	Parking collision warning.
NAME_REAR_CROSS_TRAFFIC_WARNING	Rear cross-traffic warning.
NAME_AUTOMATIC_EMERGENCY_BRAKING	Automatic emergency braking.
NAME_AUTOMATIC_EMERGENCY_STEERING	Emergency steering.
NAME_REVERSE_AUTOMATIC_EMERGENCY_BRAKING	Reverse automatic emergency braking.
NAME_ADAPTIVE_CRUISE_CONTROL	Adaptive cruise control.
NAME_LANE_KEEPING_ASSIST	Lane keeping assist.
NAME_ACTIVE_DRIVING_ASSISTANCE	Active driving assistance.
NAME_BACKUP_CAMERA	Backup camera.
NAME_SURROUND_VIEW_CAMERA	Surround view camera.
NAME_ACTIVE_PARKING_ASSISTANCE	Active parking assistance.
NAME_REMOTE_PARKING_ASSISTANCE	Remote parking assistance.
NAME_TRAILER_ASSISTANCE	Trailer assistance.
NAME_AUTOMATIC_HIGH_BEAMS	Automatic high beams.
NAME_DRIVER_MONITORING	Driver monitoring.
NAME_HEAD_UP_DISPLAY	Head up display.
NAME_NIGHT_VISION	Night vision.
NAME_URBAN_DRIVING	Urban driving.
NAME_HIGHWAY_AUTOPILOT	Highway autopilot.
NAME_CRUISE_CONTROL	Cruise control.
NAME_SPEED_LIMIT_CONTROL	Speed limit control.

◆ State

enum osi3::HostVehicleData::VehicleAutomatedDrivingFunction::State

The state that the feature is in.

Note: Not all of these will be applicable for all vehicles and features.

Enumerator
STATE_UNKNOWN	An unknown state, this should not be used.
STATE_OTHER	Used for custom states not covered by the definitions below. A string state can be specified in custom_state.
STATE_ERRORED	The function has thrown an error in some way that renders it ineffective.
STATE_UNAVAILABLE	The function cannot be used due to unfulfilled preconditions, for example it is a highway only feature and the vehicle is in an urban environment.
STATE_AVAILABLE	The function can be used as all preconditions are satisfied, but it hasn't been enabled.
STATE_STANDBY	The function is available but conditions have not caused it to be triggered, for example, no vehicles in front to trigger a forward collision warning.
STATE_ACTIVE	The function is currently active, for example, a warning is being shown to the driver, or emergency braking is being applied/.

Member Data Documentation

◆ name

optional Name osi3::HostVehicleData::VehicleAutomatedDrivingFunction::name = 1

The particular driving function being reported about.

◆ custom_name

optional string osi3::HostVehicleData::VehicleAutomatedDrivingFunction::custom_name = 2

Custom driving function name.

Only used if name is set to NAME_OTHER.

◆ state

optional State osi3::HostVehicleData::VehicleAutomatedDrivingFunction::state = 3

The state of the function.

This is whether the function has actually been triggered, for example, a warning has been raised, or additional braking is in effect.

◆ custom_state

optional string osi3::HostVehicleData::VehicleAutomatedDrivingFunction::custom_state = 4

Custom state.

Only used if the state is set to STATE_OTHER.

◆ driver_override

optional DriverOverride osi3::HostVehicleData::VehicleAutomatedDrivingFunction::driver_override = 5

Whether, and how, the driver has overridden this function.

◆ custom_detail

repeated KeyValuePair osi3::HostVehicleData::VehicleAutomatedDrivingFunction::custom_detail = 6

Custom detail.

An opaque set of key-value pairs which capture any user specific details that may be relevant. This could include details about how a warning was raised (dashboard, audible, etc.) or it could be about settings which would influence evaluation, such as sensitivity settings.

osi_hostvehicledata.proto