package emulator

Get desktop application:
View/edit binary Protocol Buffers messages

• required MsgType msg_type = 1

• optional Status status = 2

  Only for RESP messages

• repeated VehiclePropGet prop = 3

  Provided for getConfig, getProperty commands

• repeated VehiclePropConfig config = 4

• repeated VehiclePropValue value = 5

CMD messages are from workstation --> VHAL RESP messages are from VHAL --> workstation

Used in: EmulatorMessage

• GET_CONFIG_CMD = 0

• GET_CONFIG_RESP = 1

• GET_CONFIG_ALL_CMD = 2

• GET_CONFIG_ALL_RESP = 3

• GET_PROPERTY_CMD = 4

• GET_PROPERTY_RESP = 5

• GET_PROPERTY_ALL_CMD = 6

• GET_PROPERTY_ALL_RESP = 7

• SET_PROPERTY_CMD = 8

• SET_PROPERTY_RESP = 9

• SET_PROPERTY_ASYNC = 10

Data structure for sensor session files. NEXT TAG: 3

• optional SensorSession.SessionMetadata session_metadata = 1

• repeated SensorSession.SensorRecord sensor_records = 2

A record of a captured on-device sensor event. NEXT TAG: 6

Used in: SensorSession

• optional int64 timestamp_ns = 1

  Timestamp of the record relative to session start.

• repeated SensorRecord.PositionProto locations = 2

• map<int32, SensorRecord.CarPropertyValue> car_property_values = 3

  The map's key is the property ID.

• optional bytes image = 4

  For VPS testing. Records image from usb camera in png format.

• map<string, SensorRecord.SensorEvent> sensor_events = 5

  The map's key is the sensor's string type concatenated with its name with an underscore between the two. For example, the key for an accelerometer with the name of TestAccel: "android.sensor.accelerometer_TestAccell". Type and name allows a sensor to be uniquely identified.

Message stores the data of a CarPropertyValue object.

Used in: SensorRecord

• optional int32 area_id = 1

• optional int32 status = 2

• optional bool bool_value = 3

• repeated sint32 int32_values = 4

• repeated sint64 int64_values = 5

• repeated float float_values = 6

• optional string string_value = 7

• optional bytes bytes_value = 8

Used in: SensorRecord

• optional PositionProto.PositionProvider provider = 8

• optional PositionProto.PointProto point = 1

• optional int32 accuracy_mm = 2

• optional float bearing_deg_full_accuracy = 9

• optional float speed_mps = 5

• optional double altitude_m = 6

• optional double vertical_accuracy_meters = 11

• optional string level_id = 3

  These fields are only used in the unit test. Should we keep them?

• optional string cluster_id = 4

• optional int32 level_number_e3 = 12

Used in: PositionProto

• optional fixed32 lat_e7 = 1

• optional fixed32 lng_e7 = 2

Used in: PositionProto

• GPS = 0

  Position came from gps

• WIFI = 1

  Position came from wifi scans

• CELL = 2

  Position came from cell tower

• GPS_INJECTED = 3

  Position came from an external gps source (not on the device)

• CELL_WITH_NEIGHBORS = 5

  Position came from cell tower with at least one neighbors

• UNKNOWN = 4

  No provider has been set

Message stores the data of a SensorEvent object. We are not storing the sensor information here because it is already saved in the metadata.

Used in: SensorRecord

• repeated float values = 1

• optional int32 accuracy = 2

A header containing information pertaining to the session. NEXT TAG: 8

Used in: SensorSession

• optional int64 unix_timestamp_ms = 1

• optional SessionMetadata.Version version = 2

• optional string name = 3

  Reserved for future functionality.

• optional string description = 4

  Reserved for future functionality.

• repeated SessionMetadata.SensorType sensors = 5

  List of sensors recorded in this session.

• map<int32, SessionMetadata.CarPropertyConfig> car_property_configs = 6

  A map of all the car properties subscribed to during this session. The map's key is the property ID.

• map<string, SessionMetadata.Sensor> subscribed_sensors = 7

  A map of all the sensors subscribed to during this session. The map's key is the sensor's string type concatenated with its name with an underscore between the two. For example, the key for an accelerometer with the name of TestAccel: "android.sensor.accelerometer_TestAccell". Type and name allows a sensor to be uniquely identified.

Message stores the data of a CarPropertyConfig object. NEXT TAG: 10

Used in: SessionMetadata

• optional int32 access = 1

• optional int32 area_type = 2

• optional int32 change_mode = 3

• repeated int32 config_array = 4

• optional string config_string = 5

• optional float max_sample_rate = 6

• optional float min_sample_rate = 7

• repeated CarPropertyConfig.SupportedArea supported_areas = 8

• optional string type = 9

Used in: CarPropertyConfig

• optional int32 area_id = 1

• optional SupportedArea.AreaConfig area_config = 2

Used in: SupportedArea

• optional sint32 min_int32_value = 1

• optional sint32 max_int32_value = 2

• optional sint64 min_int64_value = 3

• optional sint64 max_int64_value = 4

• optional float min_float_value = 5

• optional float max_float_value = 6

Message stores the data of a Sensor object. This is defined outside the metadata and record messages below because it is used by both. NEXT TAG: 24

Used in: SessionMetadata

• optional string name = 1

• optional string vendor = 2

• optional int32 version = 3

• optional int32 handle = 4

• optional int32 type = 5

• optional float max_range = 6

• optional float resolution = 7

• optional float power_ma = 8

• optional int32 min_delay_us = 9

• optional int32 fifo_reserved_event_count = 10

• optional int32 fifo_max_event_count = 11

• optional string string_type = 12

• optional string required_permission = 13

• optional int32 max_delay_us = 14

• optional int32 flags = 15

• optional int32 id = 16

• optional int32 reporting_mode = 17

  Since mFlags in Sensor.java is marked @UnsupportedAppUsage, these members record the different information stored in mFlags that is available through getters.

• optional int32 highest_direct_report_rate_level = 18

• optional bool direct_channel_memory_file_supported = 19

• optional bool direct_channel_hardware_buffer_supported = 20

• optional bool wake_up_sensor = 21

• optional bool dynamic_sensor = 22

• optional bool additional_info_supported = 23

List of supported sensors.

Used in: SessionMetadata

• SENSOR_TYPE_PLATFORM_LOCATION = 0

• SENSOR_TYPE_CAR_PROPERTY = 1

• SENSOR_TYPE_CAMERA = 2

• SENSOR_TYPE_SENSOR_EVENT = 3

• SENSOR_TYPE_FUSED_LOCATION = 4

Used in: SessionMetadata

• optional uint32 major = 1

• optional uint32 minor = 2

• optional uint32 patch = 3

Used in: EmulatorMessage

• RESULT_OK = 0

• ERROR_UNKNOWN = 1

• ERROR_UNIMPLEMENTED_CMD = 2

• ERROR_INVALID_PROPERTY = 3

• ERROR_INVALID_AREA_ID = 4

• ERROR_PROPERTY_UNINITIALIZED = 5

• ERROR_WRITE_ONLY_PROPERTY = 6

• ERROR_MEMORY_ALLOC_FAILED = 7

• ERROR_INVALID_OPERATION = 8

Used in: VehiclePropConfig

• required int32 area_id = 1

• optional sint32 min_int32_value = 2

• optional sint32 max_int32_value = 3

• optional sint64 min_int64_value = 4

• optional sint64 max_int64_value = 5

• optional float min_float_value = 6

• optional float max_float_value = 7

Used in: EmulatorMessage

• required int32 prop = 1

• optional int32 access = 2

• optional int32 change_mode = 3

• optional int32 value_type = 4

• optional int32 supported_areas = 5

• repeated VehicleAreaConfig area_configs = 6

• optional int32 config_flags = 7

• repeated int32 config_array = 8

• optional string config_string = 9

• optional float min_sample_rate = 10

• optional float max_sample_rate = 11

This structure is used to notify what values to get from the Vehicle HAL

Used in: EmulatorMessage

• required int32 prop = 1

• optional int32 area_id = 2

Used in: EmulatorMessage

• required int32 prop = 1

  common data

• optional int32 value_type = 2

• optional int64 timestamp = 3

  required for valid data from HAL, skipped for set

• optional int32 area_id = 4

  values

• repeated sint32 int32_values = 5

  this also covers boolean value.

• repeated sint64 int64_values = 6

• repeated float float_values = 7

• optional string string_value = 8

• optional bytes bytes_value = 9