本页面列出了 VHAL 中支持的系统属性。VHAL 支持的属性必须是下方列表中的系统属性或供应商属性。在 Android 14 及更高版本中,属性定义在 hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
中定义。
属性定义在 AIDL 接口 (android.hardware.automotive.vehicle.property
) 中定义,该接口与 VHAL 接口 (android.hardware.automotive.vehicle
) 是分开的。VHAL 实现和 VHAL 客户端必须依赖这两个接口。
自动生成的访问模式和更改模式
在 Android 14 及更高版本中,为了支持 VHAL 实现,我们提供了自动生成的 C++ 头文件和 Java 类文件,其中包含允许对系统属性使用的更改模式或访问模式。供应商 VHAL 实现可以使用这些属性来确保属性配置符合规范。
A 到 D
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
使用自适应巡航控制 (ACC) 或预测性巡航控制 (PCC) 时测量的与前车的距离。返回前车最后端点与 ACC 车辆最前端点之间的测量距离,单位为毫米。必须定义 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。minInt32Value
应为 0。maxInt32Value
应填充距离传感器支持的最大范围。此值应为非负值。
如果未检测到前车(即,没有前车;或与前车相距太远,传感器无法检测到),此属性应返回 StatusCode.NOT_AVAILABLE
如果此属性因 CC 处于停用状态(例如 StatusCode#NOT_AVAILABLE_DISABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:MILLIMETER
版本:Android 14
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
ACC 或 PCC 的当前目标时间间隔(以毫秒为单位)。 此属性应指定与前车的目标时间间隔。此时间间隔定义为,从前车的最后端点行驶到 ACC 车辆的最前端点所需的时间。与前车的实际时间间隔可能会高于或低于此值。
应在 configArray 中按升序指定可为目标时间间隔设置的值。所有值都必须为正数。如果该属性可写入,则所有值都必须可写入。如果此属性因 CC 处于停用状态(例如 CRUISE_CONTROL_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但原始设备制造商 (OEM) 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:VehicleUnit:MILLI_SECS
版本:Android 14
ABS_ACTIVE
自动制动系统 (ABS) 处于启用状态。当 ABS 处于启用状态时设置为 true,当 ABS 处于关闭状态时重置为 false。此属性可根据 ABS 系统的实时状态间歇性设置(脉冲式)。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
ANDROID_EPOCH_TIME
采用纪元时间编码的当前日期和时间(以毫秒为单位)。此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。
此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。
如果 VHAL 支持此属性,CarServices 会向此值执行 WRITE
,以向 VHAL 提供 Android 系统的时间。这对于使其他车载系统(仪表盘时钟)与 Android 时间保持同步非常有用。
AAOS 会在启动期间对此属性执行一次 WRITE
,之后仅会在时间源变化被传播时才会执行 WRITE
。AAOS 会正确填充 VehiclePropValue.timestamp。AAOS 不会因时间自然流逝而发送更新。int64Values[0] 表示提供的 Unix 时间(以毫秒为单位)。
该属性可能需要超过 0 毫秒的时间才能通过堆栈传播,而拥有带着时间戳的属性有助于减少时移。因此,对于向该属性执行的所有 WRITE
,时间戳都可用于消除这种时移:
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:VehicleUnit:MILLI_SECS
版本:Android 13
AP_POWER_BOOTUP_REASON
用于报告当前开机原因的属性。这是一个 STATIC
属性,在设备关机前的整个时间段内都不会改变。例如,在系统因车门解锁而自动开机后,即使用户再次按下电源按钮,开机原因仍会保持为 VehicleApPowerBootupReason#USER_UNLOCK
,int32Values[0]
必须为 VehicleApPowerBootupReason
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
AP_POWER_STATE_REPORT
用于报告应用处理器电源状态的属性。 假设 AP 的电源状态由单独的电源控制器控制。
int32Values[0]
VehicleApPowerStateReport 枚举值int32Values[1]
唤醒所需的时间,以毫秒 (ms) 为单位,如有必要的话(否则为 0)
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
AP_POWER_STATE_REQ
用于控制应用处理器电源状态的属性。 假设 AP 的电源状态由单独的电源控制器控制。对于配置信息,VehiclePropConfig.configArray
必须在 VehicleApPowerStateConfigFlag
中具有位标志组合值
int32Values[0]
VehicleApPowerStateReq 枚举值int32Values[1]
与每个状态相关的额外参数;如果未使用,则为 0。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
AUTOMATIC_EMERGENCY_BRAKING_ENABLED
启用或停用自动紧急制动 (AEB)。
设置为 true 可启用 AEB,设置为 false 可停用 AEB。当 AEB 处于启用状态时,车辆中的 ADAS 系统应保持开启并进行监控,以避免可能发生的碰撞。此属性应仅适用于车速较高的应用场景。如需启用低速自动紧急制动功能,应使用 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
。
一般来说,AUTOMATIC_EMERGENCY_BRAKING_ENABLED
应始终返回 true 或 false。如果该功能因某种临时状态(例如车速过低)而不可用,则必须通过 AUTOMATIC_EMERGENCY_BRAKING_STATE
属性中的 ErrorState
值传达此信息。
此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
AUTOMATIC_EMERGENCY_BRAKING_STATE
自动紧急制动 (AEB) 状态。返回 AEB 的当前状态。此属性必须始终返回 AutomaticEmergencyBrakingState 或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。此属性应仅适用于车速较高的应用场景。如需表示低速自动紧急制动系统的状态,应使用 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE
。
如果 AEB 在启用刹车之前包含前向碰撞警告,这些警告必须通过前向碰撞警告 (FCW) 属性显示。
对于全局区域 ID (0),必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 AutomaticEmergencyBrakingState
(包括不推荐的 OTHER
)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:ForwardCollisionWarningState/ErrorState
单位类型:无
版本:Android 14
BLIND_SPOT_WARNING_ENABLED
启用和停用盲点警告 (BSW)。 设置为 true 可启用 BSW,设置为 false 可停用 BSW。当 BSW 处于启用状态时,车辆中的 ADAS 系统应保持开启,并监控车辆的盲点区域是否有物体。
一般来说,BLIND_SPOT_WARNING_ENABLED
应始终返回 true 或 false。 如果该功能因某种临时状态(例如车速过低)而不可用,则必须通过 BLIND_SPOT_WARNING_STATE
属性中的 ErrorState
值传达此信息。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
BLIND_SPOT_WARNING_STATE
盲点警告 (BSW) 状态。 返回 BSW 的当前状态。此属性必须始终返回 BlindSpotWarningState
或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。
对于每个受支持的区域 ID,必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 BlindSpotWarningState
(包括不推荐的 OTHER
)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:BlindSpotWarningState/ErrorState
单位类型:无
版本:Android 14
CABIN_LIGHTS_STATE
返回车厢灯的状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleLightState
单位类型:无
版本:Android 13
CABIN_LIGHTS_SWITCH
车厢灯开关。 控制车厢灯的实体开关的位置。如果灯开着是因为门打开了或因为语音指令,则可能与 CABIN_LIGHTS_STATE
不同。例如,当开关处于关闭或自动位置时。
此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleLightSwitch
单位类型:无
版本:Android 13
CLUSTER_DISPLAY_STATE
更改仪表板屏幕的状态。
- 边界:用于渲染仪表集群 activity 的区域。
- 边衬区:activity 不应在该区域放置重要信息。
可能的值为:
int32[0]
开启、关闭:0 - 关闭,1 - 开启,-1 - 随意int32[1]
边界 - 左:正数 - 左侧位置(以像素为单位)-1 - 随意(应设置所有边界字段)int32[2]
边界 - 上:与“左”格式相同int32[3]
边界 - 右:与“左”格式相同int32[4]
边界 - 下:与“左”格式相同int32[5]
边衬区 - 左:正数 - 实际左边衬区值(以像素为单位)-1 - 随意(应将所有边衬区字段设置为“随意”)int32[6]
边衬区 - 上:与“左”格式相同int32[7]
边衬区 - 右:与“左”格式相同int32[8]
边衬区 - 下:与“左”格式相同
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
CLUSTER_NAVIGATION_STATE
通知当前导航状态。字节:NavigationStateProto 的序列化消息。
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:
单位类型:无
版本:Android 13
CLUSTER_REPORT_STATE
报告当前显示状态和 ClusterUI 状态。
ClusterHome
在处理 CLUSTER_SWITCH_UI
、CLUSTER_DISPLAY_STATE
时发送此消息。此外,ClusterHome
应在首次启动时发送此消息。当 ClusterOS 收到此消息时,如果内部预期与收到的消息不同,那么它应会再次发送 CLUSTER_SWITCH_UI
、CLUSTER_DISPLAY_STATE
以匹配状态。
int32[0]
开启/关闭:0 - 关闭,1 - 开启int32[1]
边界 - 左int32[2]
边界 - 上int32[3]
边界 - 右int32[4]
边界 - 下int32[5]
边衬区 - 左int32[6]
边衬区 - 上int32[7]
边衬区 - 右int32[8]
边衬区 - 下int32[9]
全屏或主屏幕中的 ClusterUI 类型。0 表示ClusterHome
。其他值则按照 OEM 的定义。int32[10]
子屏幕中的 ClusterUI 类型,如果当前显示两个界面的话。-1 表示该区域不再使用。字节:表示 ClusterUI 可用性的数组。0 表示不可用,1 表示可用。例如,如果汽车支持 OEM 定义的三个 ClusterUI(例如 HOME、MAPS 和 CALL),并且仅在移动网络可用时支持 CALL 界面。然后,如果网络可用,它发送 [1 1 1];如果网络不可用,则发送 [1 1 0]。
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:VehicleLightSwitch
单位类型:无
版本:Android 13
CLUSTER_REQUEST_DISPLAY
用于更改仪表板显示屏状态以显示某些 ClusterUI 的请求。 当前显示状态为关闭时,ClusterHome
会将此消息发送到 ClusterOS,请求开启显示屏以显示特定的 ClusterUI。ClusterOS 应使用 CLUSTER_DISPLAY_STATE
响应此请求
int32
要显示的 ClusterUI 类型
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
CLUSTER_SWITCH_UI
在仪表板显示屏中启动 ClusterUI。
int32
要显示的 ClusterUI 类型,0 表示ClusterHome
,即仪表集群显示屏的主屏幕,并为仪表集群显示屏提供默认界面和一种启动器功能。其他值则按照 OEM 的定义。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
CREATE_USER
创建 Android 用户后由 Android 系统调用。 HAL 可以使用此属性来创建其相应的用户。这是一个异步请求:Android 通过设置 VehiclePropValue 发出请求,HAL 必须通过属性更改进行响应,指明请求是成功还是失败。如果失败,Android 系统会移除该用户。
请求的格式由 CreateUserRequest 定义,响应的格式由 CreateUserResponse 定义。例如,如果系统有两位用户(0 和 10),并且创建了第三位用户(即临时访客),请求将如下所示:
int32[0]
42 // 请求 IDint32[1]
11 // 所创建用户的 Android IDint32[2]
6 // 所创建用户的 Android 标志(临时访客)int32[3]
10 // 当前用户int32[4]
0 // 当前用户标志(无)int32[5]
3 // 用户数量int32[6]
0 // 第一位用户(用户 0)int32[7]
0 // 第一位用户标志(无)int32[8]
10 // 第二位用户(用户 10)int32[9]
0 // 第二位用户标志(无)int32[10]
11 // 第三位用户(用户 11)int32[11]
6 // 第三位用户标志(临时访客)字符串:"ElGuesto" // 新用户的名称
如果请求成功,HAL 会返回:
int32[0]
42 // 请求 IDint32[1]
1 // CreateUserStatus::SUCCESS
但如果失败,则返回:
int32[0]
42 // 请求 IDint32[1]
2 // CreateUserStatus::FAILURE 字符串:"D'OH!" //
含义是黑箱,并传递给调用方(例如设置界面),后者会执行适当的操作。
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
CRITICALLY_LOW_TIRE_PRESSURE
此属性表示每个轮胎的极低胎压阈值。它表示何时更换或修理轮胎。此值必须小于或等于 TIRE_PRESSURE 中的 minFloatValue。最小和最大属性值(minFloatValue 和 maxFloatValue)不适用于此属性。
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:KILOPASCAL
版本:Android 13
CRUISE_CONTROL_COMMAND
WRITE
巡航控制 (CC) 指令。如需详细了解每个受支持的指令,请参阅 CruiseControlCommand。对于全局区域 ID (0),必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 CruiseControlState
的所有状态。通过此属性发送的任何不受支持的指令都必须返回 StatusCode#INVALID_ARG
。如果此属性因 CC 处于停用状态(例如 CRUISE_CONTROL_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:CruiseControlCommand
单位类型:无
版本:Android 14
CRUISE_CONTROL_ENABLED
启用或停用巡航控制 (CC)。 设置为 true 表示启用 CC,设置为 false 表示停用 CC。此属性由所有形式的 CruiseControlType 共享。当 CC 处于启用状态时,车辆中的 ADAS 系统应处于开启状态并响应指令。一般来说,CRUISE_CONTROL_ENABLED
应始终返回 true 或 false。如果该功能因某种临时状态(例如车速过低)而不可用,则必须通过 CRUISE_CONTROL_STATE
属性中的 ErrorState
值传达此信息。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
CRUISE_CONTROL_STATE
巡航控制 (CC) 的当前状态。 此属性会返回 CC 当前的状态。通常,此属性应返回 CruiseControlState 或 ErrorState
中定义的有效状态。例如,如果该功能因某种临时状态而不可用,则应通过 ErrorState
传达此信息。对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValue
数组,除非同时支持 CruiseControlState(包括不推荐的 OTHER)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:CruiseControlState/ErrorState
单位类型:无
版本:Android 14
CRUISE_CONTROL_TARGET_SPEED
巡航控制 (CC) 的当前目标速度。 OEM 应为此属性设置 minFloatValue 和 maxFloatValue 值,以定义最小和最大目标速度值。这些值必须是非负值。maxFloatValue 表示目标速度的上限。minFloatValue 表示目标速度的下限。如果此属性因 CC 处于停用状态(例如 CRUISE_CONTROL_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState 值,则此属性必须返回与 ErrorState 值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:METER_PER_SEC
版本:Android 14
CRUISE_CONTROL_TYPE
巡航控制 (CC) 的当前类型。 当 CRUISE_CONTROL_ENABLED
为 true 时,此属性会返回当前启用的 CC 类型(例如标准 CC 和自适应 CC、预测性 CC)。通常,此属性应返回 CruiseControlType
或 ErrorState
中定义的有效状态。例如,如果该功能因某种临时状态而不可用,则应通过 ErrorState
传达此信息。对于全局区域 ID (0),必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非支持 CruiseControlType
(包括不推荐的 OTHER
)和 ErrorState
的所有状态。尝试将 CruiseControlType#OTHER
或 ErrorState
WRITE
到此属性会抛出 IllegalArgumentException
。此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:CruiseControlType
ErrorState
单位类型:无
版本:Android 14
CURRENT_GEAR
当前档位。在非手动情况下,所选档位可能与当前档位不符。例如,所选档位是 GEAR_DRIVE
,而当前档位是 GEAR_1
、GEAR_2
等档位中的一个,这反映了变速器当前运行的实际档位。配置数据中的值必须表示此车辆的受支持档位列表。例如,自动变速器的配置数据必须包含 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}
,而手动变速器的列表必须为 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
。此列表不必与 GEAR_SELECTION
中报告的受支持档位列表相同。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleGear
单位类型:无
版本:Android 13
CURRENT_POWER_POLICY
向 VHAL 层通知当前电源政策。 当前电源政策发生变化时,汽车电源政策服务会设置此属性
string: "sample_policy_id" // power policy ID
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
DISABLED_OPTIONAL_FEATURES
允许在 VHAL 中停用可选功能。此属性会报告应停用的可选功能。系统的所有允许可选功能均在汽车服务叠加层中声明,即 config_allowed_optional_car_features
。此属性允许停用叠加层中定义的功能。如果没有此属性,叠加层中声明的所有功能都将被启用。值 READ
应包含所有已停用的功能,并以英文逗号 (,
) 分隔。例如:com.android.car.user.CarUserNoticeService,storage_monitoring
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
DISPLAY_BRIGHTNESS
用于表示显示屏亮度的属性。 某些车辆只有一个用于控制所有显示屏亮度的控件。此属性用于共享对该控件的更改。如果配备了亮度受单独控制的显示屏,汽车必须使用 PER_DISPLAY_BRIGHTNESS
。应仅实现 DISPLAY_BRIGHTNESS
和 PER_DISPLAY_BRIGHTNESS
中的一个。如果这两者都可用,AAOS 会使用 PER_DISPLAY_BRIGHTNESS
。如果此属性可写入,Android 可以在用户通过“设置”更改显示屏亮度时设置此值。如果仅为 READ
,用户仍可通过“设置”更改显示屏亮度,但更改不得反映在其他显示屏上。
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
DISTANCE_DISPLAY_UNITS
显示距离单位。 表示汽车使用哪些单位向用户显示距离。例如,英里、米或公里。距离单位在 VehicleUnit 中定义。VehiclePropConfig.configArray 用于表示支持的距离显示单位。例如,configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE
。如果更新 DISTANCE_DISPLAY_UNITS
会影响其他 *_DISPLAY_UNITS
属性的值,则必须更新它们的值,并也将其传达给 AAOS 框架。此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleUnit
单位类型:无
版本:Android 13
DOOR_CHILD_LOCK_ENABLED
已启用车门童锁功能。 如果已启用车门童锁功能,则返回 true;如果已停用,则返回 false。如果已启用,门就无法从内部打开。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
DOOR_LOCK
门锁为 true 表示门已上锁。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
DOOR_MOVE
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。maxInt32Value
表示车门在打开时的最快移动速度。minInt32Value
表示车门在关闭时的最慢移动速度。
绝对值越大(无论是正值还是负值),表示移动速度就越快。门达到位置极限后,该值必须重置为 0。如果 DOOR_MOVE
的值为 0,则表示目前没有发生任何移动。
此属性不采用任何特定单位,而是采用相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
DOOR_POS
车门位置。 必须定义 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。minInt32Value
表示车门已关闭。minInt32Value
必须是 0。maxInt32Value
表示车门已完全打开。介于 minInt32Value
和 maxInt32Value
之间的值表示门处于关闭位置和完全打开位置之间的过渡状态。
此属性不采用任何特定单位,而是采用相对位置的指定范围。某些车辆(小型货车)可以通过电动方式打开车门。因此,具备 WRITE
此属性的能力。此属性定义为 VehiclePropertyAccess
READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
E 到 G
ELECTRONIC_TOLL_COLLECTION_CARD_STATUS
Electronic Toll Collection card status. This property indicates the status of ETC card in this
vehicle. If the head unit is aware of an ETC card attached to the vehicle,
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
gives that status of the card. Otherwise, this
property should be UNAVAILABLE
Change mode: ON_CHANGE
Access mode: READ
Enum type: ElectronicTollCollectionCardStatus
Unit type: N/A
Release: Android 13
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
Electronic Toll Collection (ETC) card type. This property indicates the type of ETC card in this
vehicle. If the head unit is aware of an ETC card attached to the vehicle, this property should
return the type of card attached; otherwise, this property should be UNAVAILABLE
Change mode: ON_CHANGE
Access mode: READ
Enum type: ElectronicTollCollectionCardType
Unit type: N/A
Release: Android 13
EMERGENCY_LANE_KEEP_ASSIST_ENABLED
Enable or disable Emergency Lane Keep Assist (ELKA). Set true to enable ELKA and false to
disable ELKA. When ELKA is enabled, the ADAS system in the vehicle should be on and monitoring
for unsafe lane changes by the driver. When an unsafe maneuver is detected, ELKA alerts the
driver and applies steering corrections to keep the vehicle in its original lane.
In general, EMERGENCY_LANE_KEEP_ASSIST_ENABLED
should always return true or false.
If the feature is not available due to some temporary state, such as the vehicle speed being too
low, that information must be conveyed through the ErrorState
values in the
EMERGENCY_LANE_KEEP_ASSIST_STATE
property. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
EMERGENCY_LANE_KEEP_ASSIST_STATE
Emergency Lane Keep Assist (ELKA) state. Returns the current state of ELKA. Generally, this
property should return a valid state defined in the EmergencyLaneKeepAssistState
or
ErrorState
For example, if the feature is not available due to some temporary state, that information
should be conveyed through ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValues
array must be defined unless all states of
EmergencyLaneKeepAssistState
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: EmergencyLaneKeepAssistState/ErrorState
Unit type: N/A
Release: Android 14
ENGINE_COOLANT_TEMP
Temperature of engine coolant.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
ENGINE_IDLE_AUTO_STOP_ENABLED
Represents feature for engine idle automatic stop. If true, the vehicle may automatically shut
off the engine when it is not needed and then automatically restart it when needed.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
ENGINE_OIL_LEVEL
Engine oil level.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleOilLevel
Unit type: N/A
Release: Android 13
ENGINE_OIL_TEMP
Temperature of engine oil.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
ENGINE_RPM
Engine revolutions per minute (RPM).
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:RPM
Release: Android 13
ENV_OUTSIDE_TEMPERATURE
Outside temperature. This property must communicate the temperature reading of the environment outside the vehicle. If there are multiple sensors for measuring the outside temperature, this property should be populated with the mean or a meaningful weighted average of the readings that best represent the temperature of the outside environment.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
EV_BATTERY_DISPLAY_UNITS
EV battery units for display. Indicates which units the car is using to display EV battery
information to the user. For example, watt-hours (Wh), kilowatt-hours (kWh) or ampere-hours (Ah).
VehiclePropConfig.configArray
is used to indicate the supported electrical energy.
units. Electrical energy units are defined in VehicleUnit
For example:
configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR
If updating EV_BATTERY_DISPLAY_UNITS
affects the values of other
*_DISPLAY_UNITS
properties,
then their values must be updated and communicated to the AAOS framework as well.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
EV_BATTERY_INSTANTANEOUS_CHARGE_RATE
EV instantaneous charge rate in milliwatts. A positive value indicates the battery is being charged. A negative value indicates the battery being discharged.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MW
Release: Android 13
EV_BATTERY_LEVEL
Returns the current battery level, whether EV or hybrid. This value will not exceed
EV_CURRENT_BATTERY_CAPACITY
To calculate the battery percentage, use
(EV_BATTERY_LEVEL
, EV_CURRENT_BATTERY_CAPACITY
)*100.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13
EV_BRAKE_REGENERATION_LEVEL
Regenerative braking level of a electronic vehicle. The maxInt32Value
and
minInt32Value
in VehicleAreaConfig must be defined. All values between
minInt32Value
and maxInt32Value
must be
supported. The minInt32Value
must be 0. The maxInt32Value
indicates
the setting for the maximum amount of energy regenerated from braking. The
minInt32Value
indicates the setting for no
regenerative braking. This property is a more granular form of
EV_REGENERATIVE_BRAKING_STATE
It allows the user to set a more specific level of regenerative braking if the states in
EvRegenerativeBrakingState
are not granular enough for the OEM. This property is
defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_CURRENT_DRAW_LIMIT
Indicates the maximum current draw threshold for charging set by the user.
EvChargeState::configArray[0]
is
used to specify the max current draw allowed by the vehicle in Amperes. This property is defined
as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITEREAD
Enum type: N/A
Unit type: VehicleUnit:AMPERE
Release: Android 13
EV_CHARGE_PERCENT_LIMIT
Indicates the maximum charge percent threshold set by the user. Indicates the maximum charge
percent threshold set by the user. Returns a float value from 0 to 100.
configArray is used to specify the valid values. For example, if the vehicle supports the
following charge percent limit values: [20, 40, 60, 80, 100] then the configArray should be
{20, 40, 60, 80, 100} If the configArray is empty then all values from 0 to 100 must be valid.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE,
, READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_PORT_CONNECTED
EV charge port connected. If the vehicle has multiple charging ports, this property must return
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_PORT_OPEN
EV charge port open. If the vehicle has multiple charging ports, this property must return
true if any of the charge ports are open. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITEREAD
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_STATE
Charging state of the car
Returns the current charging state of the car.
If the vehicle has a target charge percentage other than 100, this property must return
EvChargeState::STATE_FULLY_CHARGED
when the battery charge level has reached the
target level. See EvChargeState::EV_CHARGE_PERCENT_LIMIT
for more context.
Change mode: ON_CHANGE
Access mode: READ
Enum type: EvChargeState
Unit type: N/A
Release: Android 13
EV_CHARGE_SWITCH
Start or stop charging the EV battery. The setting wanted by the user. Setting this property
to true starts the battery charging, and false to stop charging. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITEREAD
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_TIME_REMAINING
Estimated charge time remaining in seconds. Returns 0 if the vehicle is not charging.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:SECS
Release: Android 13
EV_CURRENT_BATTERY_CAPACITY
Current usable battery capacity for and EV or hybrid vehicle. Returns the actual value of
battery capacity, when EV or hybrid. This property captures the real-time usable battery capacity
taking into account factors such as battery aging and temperature dependency. This value might
differ from INFO_EV_BATTERY_CAPACITY
because INFO_EV_BATTERY_CAPACITY
returns the nominal battery capacity from when the vehicle was new.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 14
EV_REGENERATIVE_BRAKING_STATE
Regenerative braking or one-pedal drive setting of the car. Returns the current setting
associated with the regenerative braking setting in the car. If the OEM requires more setting
than those provided in EvRegenerativeBrakingState
, the
EV_BRAKE_REGENERATION_LEVEL
property can be used instead, which provides more
granular information.
Change mode: ON_CHANGE
Access mode: READ
Enum type: EvRegenerativeBrakingState
Unit type: N/A
Release: Android 13
EV_STOPPING_MODE
Represents property for the current stopping mode of the vehicle. For the global area ID (0),
the VehicleAreaConfig#supportedEnumValues
must be defined unless all enum values of
EvStoppingMode
are supported. The EvStoppingMode
enum may be extended to
include more states in the future. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs have the option to implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: EvStoppingMode
Unit type: N/A
Release: Android 14
EVS_SERVICE_REQUEST
Enable and request an EVS service. The property provides a way to trigger EVS services. The VHAL should use this property to request Android to start or stop EVS service.
int32Values[0]
Type of EVS service. The value must be and enum in EvsServiceType.int32Values[1]
State of the EVS service. The value must be one of enums in EvsServiceState.
For example, to enable rear view EVS service, Android can set the property value as:
[EvsServiceType::REAR_VIEW, EvsServiceState::ON]
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EXTERNAL_CAR_TIME
Current date and time suggestion for the cr, encoded as Epoch time (in milliseconds). This value denotes the number of milliseconds seconds that have elapsed since 1/1/1970 UTC. This property signals a change in CarTime to Android. If the property is supported, VHAL must report the most accurate current CarTime when this property is read, and publish a change to this property when the CarTime value has changed.
An on-change event for this property must be published when CarTime changes for any reason other than the natural elapse of time (time delta smaller than 500ms should not trigger an on change event). Android will read and subscribe to this property to fetch time from VHAL. This can be useful to synchronize Android's time with other vehicle systems (dash clock). int64Values[0] = provided Epoch time (in milliseconds) Whenever a new Value for the property is received, AAOS creates and sends an ExternalTimeSuggestion to the TimeDetectorService.
If other sources do not have a higher priority, Android will use this to set the system time. For information on how to adjust time source priorities and how time suggestions are handled (including how Android handles gitter, drift, and minimum resolution), see the Time Detector Service documentation.
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
We strongly recommend that this propertynot be used to retrieve time from ECUs using protocols (such as GNSS, NTP, and Telephony). Since these protocols are already supported by Android, we recommend you use Android systems instead of wiring through the VHAL with this property.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLI_SECS
Release: Android 13
FOG_LIGHTS_STATE
Fog light state. Return the current state of fog lights. If the:
- Car has front and rear fog lights. Front and rear fog lights can only be controlled
together.
FOG_LIGHTS_STATE
must be implemented.FRONT_FOG_LIGHTS_STATE
andREAR_FOG_LIGHTS_STATE
must not be implemented. - Front and rear fog lights can only be controlled independently.
FOG_LIGHTS_STATE
must not be implemented andFRONT_FOG_LIGHTS_STATE
andREAR_FOG_LIGHTS_STATE
must be implemented. - Car has only front fog lights. Only one of
FOG_LIGHTS_STATE
orFRONT_FOG_LIGHTS_STATE
must be implemented (not both).REAR_FOG_LIGHTS_STATE
must not be implemented. - Car has only rear fog lights. Only one of
FOG_LIGHTS_STATE
orREAR_FOG_LIGHTS_STATE
must be implemented (not both).FRONT_FOG_LIGHTS_STATE
must not be implemented.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
FOG_LIGHTS_SWITCH
Fog light switch. The setting wanted by the user. If the:
- Car has both front and rear fog lights. If front and rear fog lights can only be controlled
together,
FOG_LIGHTS_SWITCH
must be implemented.FRONT_FOG_LIGHTS_SWITCH
andREAR_FOG_LIGHTS_SWITCH
must not be implemented. - Front and rear fog lights can only be controlled independently.
FOG_LIGHTS_SWITCH
must not be implemented.FRONT_FOG_LIGHTS_SWITCH
andREAR_FOG_LIGHTS_SWITCH
must be implemented. - Car has only front fog lights. Only one of
FOG_LIGHTS_SWITCH
orFRONT_FOG_LIGHTS_SWITCH
must be implemented (not both).REAR_FOG_LIGHTS_SWITCH
must not be implemented. - Car has only rear fog lights. Only one of
FOG_LIGHTS_SWITCH
orREAR_FOG_LIGHTS_SWITCH
must be implemented (and not both).FRONT_FOG_LIGHTS_SWITCH
must not be implemented.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
FORWARD_COLLISION_WARNING_ENABLED
Enable or disable Forward Collision Warning (FCW). Set to true to enable FCW and false to
disable FCW. When FCW is enabled, the ADAS system in the vehicle should be turned on and
monitoring for potential collisions. In general, FORWARD_COLLISION_WARNING_ENABLED
should always return true or false. If the feature is not available due to some temporary state,
such as the vehicle speed being too low, that information must be conveyed through the
ErrorState
values in the FORWARD_COLLISION_WARNING_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
FORWARD_COLLISION_WARNING_STATE
Forward Collision Warning (FCW) state. Returns the current state of FCW. This property must
always return a valid state defined in ForwardCollisionWarningState
or
ErrorState
It must not
surface errors through StatusCode and must use the supported error states instead.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be
defined unless all states of both ForwardCollisionWarningState
(including OTHER,
which is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enun type: ForwardCollisionWarningState/ErrorState
Unit type: N/A
Release: Android 14
FRONT_FOG_LIGHTS_STATE
Front fog lights state. Returns the current state of the front fog lights. Only one of
FOG_LIGHTS_STATE
or FRONT_FOG_LIGHTS_STATE
must be implemented.
Refer to the documentation on FOG_LIGHTS_STATE
for more information.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
FRONT_FOG_LIGHTS_SWITCH
Front fog lights switch. The setting wanted by the user. Only one of
FOG_LIGHTS_SWITCH
or FRONT_FOG_LIGHTS_SWITCH
must be implemented. Refer
to the documentation on FOG_LIGHTS_SWITCH
for more information.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME
Fuel consumption units for display.
Indicates type of units the car is using to display fuel consumption information to user
True indicates units are distance over volume such as MPG. False indicates units are volume
over distance such as L/100KM. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
FUEL_DOOR_OPEN
Fuel door open. This property must communicate if the fuel door on the vehicle is open or not.
This property does not apply to EVs. That is, if INFO_FUEL_TYPE
only
contains FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For
EVs, implement EV_CHARGE_PORT_OPEN
. This property is defined as
VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
FUEL_LEVEL
Fuel remaining in the vehicle, in milliliters. This property must communicate the current
amount of fuel remaining in the vehicle in milliliters. This property does not apply to electric
vehicles. That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For EVs, implement
EV_BATTERY_LEVEL
Value can not exceed INFO_FUEL_CAPACITY
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13
FUEL_LEVEL_LOW
Warning for fuel low level. This property corresponds to the low fuel warning on the dashboard.
Once FUEL_LEVEL_LOW
is set, it should not be cleared until more fuel is added to the
vehicle. This property can account for all fuel sources in a vehicle. For example, in a:
- Gas-powered vehicle, this property is based solely on gas level.
- Battery powered vehicle, this property is based only on battery level.
- Hybrid vehicle, this property may can based on a combination of gas and battery levels, at the OEM's discretion.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
FUEL_VOLUME_DISPLAY_UNITS
Fuel volume units for display. Indicates which units the car is using to display fuel volume
to the user. For example, Liter or Gallon. VehiclePropConfig.configArray
is used to
indicate the supported fuel volume display units. Volume units are defined in
VehicleUnit
For example, configArray[0] = LITER configArray[1] = GALLON
If updating FUEL_VOLUME_DISPLAY_UNITS
affects the values of other
*_DISPLAY_UNITS
properties,
then their values must be updated and communicated to the AAOS framework, too.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
GEAR_SELECTION
The gear selected by the user. Values in the config data must represent the list of supported
gears for this vehicle. For example, config data for an automatic transmission must contain
{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK,
and for
manual transmission the list must be GEAR_DRIVE
, GEAR_1, GEAR_2,...}{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
For an automatic transmission vehicle that allows the driver to select specific gears on demand
(for example, manual mode), the value for GEAR_SELECTION
must be set to the specific
gear selected by the driver instead of GEAR_DRIVE
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleGear
Unit type: N/A
Release: Android 13
GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
EU's General security regulation compliance requirement. Returns a value to indicate if general security regulation compliance is required and, if so, the type of requirement.
Change mode: STATIC
Access mode: READ
Enum type: GsrComplianceRequirementType
Unit type: N/A
Release: Android 14
GLOVE_BOX_DOOR_POS
Property that represents the current position of the glove box door. The
maxInt32Value
and minInt32Value
in VehicleAreaConfig must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The minInt32Value
indicates that the glove box door is closed.
The minInt32Value
must be 0. The maxInt32Value
indicates that the
glove box door is in the fully open position. Values in between minInt32Value
and
maxInt32Value
indicate a transition state between the closed and fully open
positions.
This property is not in any particular unit but in a specified range of relative positions.
The area ID must match the seat by which the glove box is intended to be used. For example if the
front right dashboard has a glove box embedded in it, then the area ID should be
SEAT_1_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
GLOVE_BOX_LOCKED
Lock or unlock the glove box. If true, the glove box is locked. If false, the glove box is
unlocked. The area ID must match the seat by which the glove box is intended to be used. For
example, if the front right dashboard has an embedded glove box embedded, then the area ID should
be VehicleAreaSeat#ROW_1_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
H 到 I
HANDS_ON_DETECTION_DRIVER_STATE
Hands On Detection (HOD) driver state. Returns whether the driver's hands are on the steering
wheel. Generally, this property should return a valid state defined in the
HandsOnDetectionDriverState
or ErrorState
For example, if the feature
is not available due to
some temporary state, that information should be conveyed through ErrorState
If the vehicle wants to send a warning to the user because the driver's hands have been off the
steering wheel for too long, the warning should be surfaced through
HANDS_ON_DETECTION_WARNING
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must
be defined
unless all states of both HandsOnDetectionDriverState
(including OTHER, which is
not recommended)
and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionDriverState/ErrorState
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_ENABLED
Enable or disable Hands On Detection (HOD). Set true to enable HOD and false to disable HOD.
When HOD is enabled, a system inside the vehicle should be monitoring the presence of the driver's
hands on the steering wheel and send a warning if it detects that the driver's hands are no longer
on the steering wheel. In general, HANDS_ON_DETECTION_ENABLED
should always return
true or false.
If the feature is not available due to some temporary state, that information must be conveyed
through the ErrorState
values in the HANDS_ON_DETECTION_STATE
property.
This property is defined as minInt32Value
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it is
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_WARNING
Hands On Detection (HOD) warning. Returns whether a warning is being sent to the driver for
having their hands off the wheel for too long a duration. Generally, this property should return
a valid state defined in HandsOnDetectionWarning
or ErrorState
For
example, if the feature is not available due to some temporary state, that information should
be conveyed through an ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValues
array must be defined unless all states
of both HandsOnDetectionWarning
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionWarning/ErrorState
Unit type: N/A
Release: Android 14
HAZARD_LIGHTS_STATE
Hazard light status. Return the current status of hazard lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HAZARD_LIGHTS_SWITCH
Hazard light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HEADLIGHTS_STATE
Headlights state. Returns the current state of headlights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HEADLIGHTS_SWITCH
Headlight switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_STATE
High beam lights state. Returns the current state of high beam lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_SWITCH
High beam light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HVAC_AC_ON
Turn AC on and off AC for the designated areaId. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ACTUAL_FAN_SPEED_RPM
Actual fan speed.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_ON
Turn automatic climate control on and off.
If true, automatic climate control is on. If false, automatic climate control is off.
If the vehicle does not support directly turning off automatic climate control, then OEMs should
add logic in their VHAL implementation to set HVAC_AUTO_ON
to false, which changes
the necessary HVAC settings to indirectly turn off HVAC_AUTO_ON
Ideally, this
should not disrupt the user. OEMs should revert to the previous state any settings that were
modified when automatic climate control is off. This way, the only outcome should be that
HVAC_AUTO_ON
is off. If restoring HVAC settings to previous settings is not possible,
then the OEM should implement the least disruptive change.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_RECIRC_ON
Automatic recirculation on or off. When automatic recirculation is on, the HVAC system may
automatically switch to recirculation mode if the vehicle detects poor incoming air quality.
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DEFROSTER
Fan-based defrost for designated window. This property is defined as
VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DUAL_ON
Enable temperature coupling between areas. The AreaIDs
for the
HVAC_DUAL_ON
property
shall contain a combination of HVAC_TEMPERATURE_SET
AreaIDs
that can be
coupled
together. If HVAC_TEMPERATURE_SET
is mapped to AreaIDs
[a_1, a_2, ..., a_n]
and if HVAC_DUAL_ON
can be enabled to couple a_i and a_j, then
HVAC_DUAL_ON
property must be mapped to [a_i | a_j]. Further, if
a_k and a_l can also be coupled together separately, then
HVAC_DUAL_ON
must be mapped to [a_i | a_j, a_k | a_l].
For example, a car has two front seats (ROW_1_LEFT
and ROW_1_RIGHT
) and
three back seats (ROW_2_LEFT, ROW_2_CENTER, and ROW_2_RIGHT).
There are two temperature control units, driver side and passenger side, which can be optionally
synchronized. This can be expressed this way in the AreaIDs
:
HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT] HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
When the property is enabled, the ECU must synchronize the temperature for the affected areas.
Any parameters modified as a side effect of turning on or off the DUAL_ON parameter shall generate
onPropertyEvent()
callbacks to the VHAL. In addition, if setting a temperature
(for example, driver temperature) changes another temperature (such as front passenger
temperature), then the appropriate onPropertyEvent()
callbacks must be generated.
If a user changes a temperature that breaks the coupling (for example, sets passenger temperature
independently), then the VHAL must send the appropriate onPropertyEvent()
callbacks
(including HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
).
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
Electric defrosters' status.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION
Fan direction setting. This property is defined as VehiclePropertyAccess.READ_WRITE
,
but OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
Fan positions available. This is a bit mask of fan positions available for the zone. Each
available fan direction is denoted by a separate entry in the vector. A fan direction can have
multiple bits from vehicle_hvac_fan_direction
set. For instance, a typical car may have these
fan positions:
- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)
Change mode: STATIC
Access mode: READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_SPEED
Fan speed setting. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig must be defined. All integers between minInt32Value
and
maxInt32Value
must be supported.
minInt32Value
lowest fan speedmaxInt32Value
highest fan speed
This property is not in any specific unit but in a specified range of relative speeds. This
property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can elect to
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_AC_ON
MAX AC on or off. When MAX AC is on, the ECU can adjust items such as vent position, fan speed,
and temperature as needed to cool the vehicle as quickly as possible. Any parameters modified as
a side effect of turning on or off the MAX AC parameter generates onPropertyEvent()
callbacks to the VHAL. This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_DEFROST_ON
Turn MAX DEFROST on and off. When MAX DEFROST is on, the ECU can adjust items such as vent
position, fan speed, and temperature as needed to defrost the windows as quickly as possible.
Any parameters modified as a side effect of turning on or off MAX DEFROST parameter generates
onPropertyEvent()
callbacks to the VHAL. The AreaIDs
for
HVAC_MAX_DEFROST_ON
indicate MAX DEFROST can be controlled in the area. For example,
areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
indicates that
HVAC_MAX_DEFROST_ON
can only be controlled for the front rows. This property is
defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it
as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_POWER_ON
Represents the global power state for HVAC. Setting this property to false MAY mark some properties that control individual HVAC features and subsystems in the UNAVAILABLE state. Setting this property to true MAY mark some properties that control individual HVAC features and subsystems to the AVAILABLE state (unless any or all of the properties are UNAVAILABLE on their own individual merits).
HvacPower_DependentProperties
are those properties that require HVAC to be powered
on to enable functionality. In some cars, for example, to turn on the AC, HVAC must first be
powered on. The HvacPower_DependentProperties
list must be set in the
VehiclePropConfig.configArray
HvacPower_DependentProperties
must only
contain those properties associated with VehicleArea:SEAT
AreaID mapping for HVAC_POWER_ON
property must contain all AreaIDs
that
HvacPower_DependentProperties
are mapped to. For example, a car has two:
- Front seats (
ROW_1_LEFT
,ROW_1_RIGHT
) and three back seats (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). If the HVAC features (AC, Temperature etc.) throughout the car are dependent on a single HVAC power controller, thenHVAC_POWER_ON
must be mapped to [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- Seats in the front row (
ROW_1_LEFT
,ROW_1_RIGHT
) and three seat in the second (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) and third rows (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). If the car has temperature controllers in the front row that can operate entirely independently of temperature controllers in the back of the vehicle, thenHVAC_POWER_ON
must be mapped to a two element array:- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_RECIRC_ON
Recirculation on and off. Controls the supply of exterior air to the cabin. Recirc
on means most of the airflow into the cabin originates in the cabin. Recirc
off means most of the airflow into the cabin comes from outside the car. This
property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_TEMPERATURE
Seat heating and cooling. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum seat temperature heating setting.
The minInt32Value
must be 0, unless the vehicle supports seat cooling. In this case,
minInt32Value
indicates the maximum seat temperature cooling setting.
This property is not in any specific unit, but in a specified range of relative temperature
settings. This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs
can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_VENTILATION
Seat ventilation. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported. The minInt32Value
must be 0. The
maxInt32Value
indicates the maximum ventilation setting available for the seat.
This property is not in any particular unit but in the specified range of ventilation settings.
Used by HVAC apps and Assistant to enable, change, or read state of seat ventilation. This is different than seating cooling. It can be on at the same time as cooling, or not.
This property is defined as >VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SIDE_MIRROR_HEAT
Side mirror heat. Increasing values denote higher heating levels for side mirrors.
You must define maxInt32Value
and minInt32Value
in
VehicleAreaConfig
All integers between minInt32Value
and
maxInt32Value
must be supported. In config data:
maxInt32Value
represents maximum heating level.minInt32Value
MUST be 0 and indicates no heating.
This property is not in any particular unit but in a specified range of relative heating settings.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_STEERING_WHEEL_HEAT
Sets the amount of heating and cooling for the steering wheel. The maxInt32Value
and
minInt32Value
in VehicleAreaConfig
must be defined. All integers between
minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum steering wheel heating setting. The
minInt32Value
should be 0, unless the vehicle supports steering wheel
cooling, too. In this case, the minInt32Value
indicates the maximum steering wheel
cooling setting. This property is not in any particular unit but in a specified range of heating
settings. This property is defined as VehiclePropertyAccess.READ
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_CURRENT
HVAC current temperature.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
Temperature units for display. Indicates if temperature is displayed in Celsius or Fahrenheit.
VehiclePropConfig.configArray
indicates the supported temperature display units. For
example,
configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
This parameter MAY be used to
display any HVAC temperature in the system. Values must be one of
VehicleUnit.CELSIUS
or VehicleUnit.FAHRENHEIT
If updating HVAC_TEMPERATURE_DISPLAY_UNITS affects the values of other
*_DISPLAY_UNITS
properties, then their values must be updated and communicated to
the AAOS framework.
This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it is VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_SET
HVAC target temperature set in Celsius.
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be defined:
minFloatValue
minimum temperature setting in Celsius.maxFloatValue
maximum temperature setting in Celsius.
If all the values between minFloatValue
and maxFloatValue
are not
supported, use the configArray
to list the valid temperature values that can be set.
This also describes a lookup table to convert the temperature from Celsius to Fahrenheit (and
vice versa) for the vehicle. The configArray
must be defined if standard unit
conversion is not supported on the vehicle.
The configArray
is set as follows:
configArray[0]
[lower bound of supported temperature in Celsius] * 10configArray[1]
[upper bound of supported temperature in Celsius] * 10configArray[2]
[increment in Celsius] * 10configArray[3]
[lower bound of the supported temperature in Fahrenheit] * 10configArray[4]
[upper bound of the supported temperature in Fahrenheit] * 10configArray[5]
[increment in Fahrenheit] * 10
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be equal to configArray[0]
and
configArray[1]
respectively. For example, if the vehicle supports temperature values
as [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
in
Fahrenheit, the configArray
should be
configArray = {160, 280, 5, 605, 845, 10}
Ideally, the ratio of the Celsius increment to the Fahrenheit increment should be as close to
the actual ratio of 1 degree Celsius to 1.8 degrees Fahrenheit. There must be a one-to-one mapping
of all Celsius values to Fahrenheit values defined by the configArray
The
configArray
is used by
clients to convert this property's temperature from Celsius to Fahrenheit. Also, it lets clients
know what Celsius value to set the property to achieve their desired Fahreneheit value for the
system. If the ECU does not have a one-to-one mapping of all Celsius values to Fahrenheit values,
then the configArray
should only define the list of Celsius and Fahrenheit values
that have a one-to-one mapping.
For example, if the ECU supports Celsius values from 16 to 28 and Fahrenheit values from 60 to
85, each with an increment of 1, then one possible configArray
is
code>{160, 280, 10, 600, 840, 20}In this case, 85 is not a supported temperature.
Any value set in between a valid value should be rounded to the closest valid value. We highly
recommended that the OEM also implement the HVAC_TEMPERATURE_VALUE_SUGGESTION
vehicle property because it provides applications with a simple method for determining temperature
values that can be set for a vehicle and for converting values between Celsius and Fahrenheit.
This property is defined as VehiclePropertyAccess.READ
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
Suggested values for setting HVAC temperature.
Implement the property to help applications understand the closest supported temperature value in Celsius or Fahrenheit.
floatValues[0]
Requested value that an app wants to set a temperature to.floatValues[1]
Unit forfloatValues[0]
and should be one of{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2]
Value OEMs suggested in CELSIUS (this value is not included in the request).floatValues[3]
Value OEMs suggested in FAHRENHEIT (this value is not included in the request).
An application calls set(VehiclePropValue propValue)
with the requested value
and unit for the value. OEMs need to return the suggested values in
floatValues[2]
and floatValues[3]
by onPropertyEvent()
callbacks.
The suggested values must conform to the values that can be derived from the
HVAC_TEMPERATURE_SET
configArray
In other words, the suggested values
and the table of values
from the configArray
should be the same.
We recommended that the OEM add custom logic in their VHAL implementation to avoid making requests to the HVAC ECU. The logic can be as follows. To convert temperature from Celsius to Fahrenheit:
// Given tempC and the configArray float minTempC = configArray[0] / 10.0; float temperatureIncrementCelsius = configArray[2] / 10.0; float minTempF = configArray[3] / 10.0; float temperatureIncrementFahrenheit = configArray[5] / 10.0; // Round to the closest increment int numIncrements = round((tempC - minTempC) / temperatureIncrementCelsius); tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;
For example, when a driver uses the voice assistant to set HVAC temperature to 66.2 in Fahrenheit.
First, an application sets this property with the value
[66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
If an OEM suggests to set 19.0 in Celsius or 66.5 in Fahrenheit at the user's request, then VHAL
must generate a callback with a property value
[66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
After the voice assistant gets the callback, it informs the user and sets the HVAC temperature to
the suggested value.
Another example, an app receives 21 Celsius as the current temperature value by querying
HVC_TEMPERATURE_SET
but the app needs to know what value is displayed on the car's
UI in Fahrenheit. For this, the app sets the property to
[21, (float)VehicleUnit.CELSIUS, 0, 0]
If the suggested value by the OEM for 21 Celsius is 70 Fahrenheit, then VHAL must generate a
callback with property value [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
In this
case, the app can know that the value is 70.0 Fahrenheit in the car's UI.
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_CUSTOM_INPUT
Defines a custom OEM partner input event. This input event must be used by OEM partners who want to propagate events not supported by Android. It is composed by an array of int32 values only. The Android properties are:
int32Values[0]
Input code identifying the function representing this event. Valid event types are defined byCustomInputType.CUSTOM_EVENT_F1
up toCustomInputType.CUSTOM_EVENT_F10
They represent the custom event to be defined by OEM partners.int32Values[1]
Target display type defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32Values[2]
Repeat counter, if 0 then event is not repeated. Values 1 or higher indicate how many times this event has been repeated.
Change mode: ON_CHANGE
Access mode: READ
Enum type: CustomInputType
Unit type: N/A
Release: Android 13
HW_KEY_INPUT
Property to feed hardware input events to Android.
int32Values[0]
Action defined by VehicleHwKeyInputActionint32Values[1]
Key code, must use standard android key codeint32Values[2]
Target display defined inVehicleDisplay
Events not tied to specific display must be sent toVehicleDisplay#MAIN
int32Values[3]
(Optional) Number of ticks. The value must be equal o greater than 1. When omitted, Android defaults to 1.
Change mode: .ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_KEY_INPUT_V2
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1]
Key code, must use the standard Android key code, such asKEYCODE_HOME
andKEYCODE_BACK
int32array[2]
action defined in VehicleHwKeyInputAction, such as:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
int32array[3]
Repeat count of the event. For key down events, this is the repeat count with the first down starting at 0 and counting up from there. For key up events, this is always equal to 0.int64array[0]
Down time in elapsed nanoseconds since the last boot. Denotes the time of the most recent key down event. For the down event, this is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_MOTION_INPUT
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
, such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
int32array[1]
Input type defined in VehicleHwMotionInputSource, such as:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
Action code defined in VehicleHwMotionInputAction, such as:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
int32array[3]
Button state flag defined in VehicleHwMotionButtonStateFlag, such as:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
Pointer events count, N. N must be a positive integer.int32array[5:5+N-1]
Pointer id, length Nint32array[5+N:5+2*N-1]
Tool type, length N. As defined inVehicleHwMotionToolType
, such as:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x data, length NfloatArray[N:2*N-1]
y data, length NfloatArray[2*N:3*N-1]
pressure data, length NfloatArray[3*N:4*N-1]
size data, length Nint64array[0]
Down time, elapsed nanoseconds since boot. Denotes the time when the user originally pressed down to start a stream of position events. For the down event, it is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_ROTARY_INPUT
Property to feed hardware rotary events to Android.
int32Values[0]
RotaryInputType to identify which rotary knob is rotated.int32Values[1]
Number of detents (clicks), positive for clockwise, negative for counterclockwise.int32Values[2]
Target display defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2]
Nanosecond deltas between pairs of consecutive detents when the number of detents is more than 1 or less than -1.VehiclePropValue.timestamp
When the rotation took place. If the number of detents is more than 1 or less than -1, when the first detent of rotation took place.
Change mode: ON_CHANGE
Access mode: READ
Enum type: RotaryInputType
Unit type: N/A
Release: Android 13
IGNITION_STATE
Represents ignition state.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleIgnitionState
Unit type: N/A
Release: Android 13
INFO_DRIVER_SEAT
Driver's seat location VHAL implementations must ignore the areaId. Use
VehicleArea:GLOBAL
Change mode: STATIC
Access mode: READ
Enum type: VehicleAreaSeat
Unit type: N/A
Release: Android 13
INFO_EV_BATTERY_CAPACITY
Nominal battery capacity for EV or hybrid vehicle. Returns the nominal battery capacity, EV
or hybrid. This is the total usable battery capacity when the vehicle is new. This value may
differ from EV_CURRENT_BATTERY_CAPACITY
because
EV_CURRENT_BATTERY_CAPACITY
returns the real-time usable battery capacity taking
into account factors such as battery aging and temperature dependency.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13
INFO_EV_CONNECTOR_TYPE
List of connectors this EV may use. If the vehicle has multiple charging ports, this property must return all possible connector types that can be used by at least one charging port on the vehicle.
Change mode: STATIC
Access mode: READ
Enum type: EvConnectorType
Unit type: N/A
Release: Android 13
INFO_EV_PORT_LOCATION
This property must communicate the location of the charging port on the EV using the
PortLocationType enum. If a vehicle has multiple ports, this property must return
the port that allows the fastest charging. To communicate all port locations, use
INFO_MULTI_EV_PORT_LOCATIONS
Access mode: READ
Enum type:
PortLocationType
Unit type: N/A
Release: Android 13
INFO_EXTERIOR_DIMENSIONS
Exterior dimensions of vehicle:
- Height:
int32Values[0]
- Length:
int32Values[1]
- Width:
int32Values[2]
- Width, including mirrors:
int32Values[3]
- Wheel base, including mirrors:
int32Values[4]
- Track width front:
int32Values[5]
- Track width rear:
int32Values[6]
- Curb-to-curb turning diameter:
int32Values[7]
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLIMETER
Release: Android 13
INFO_FUEL_CAPACITY
Fuel capacity of the vehicle in milliliters. This property must communicate the maximum amount
of fuel that can be stored in the vehicle in milliliters. This property does not apply to electric
vehicles (EV). That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, INFO_FUEL_CAPACITY must not be implemented.
For EVs, implement INFO_EV_BATTERY_CAPACITY.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13
INFO_FUEL_DOOR_LOCATION
Fuel door location. This property must communicate the location of the fuel door on the vehicle.
This property does not apply to EVs. That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For EVs,
implement INFO_EV_PORT_LOCATION
or INFO_MULTI_LOCATIONS
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_FUEL_TYPE
List of fuels the vehicle may use. FuelType::FUEL_TYPE_ELECTRIC
must only be
included if the vehicle can plug-in rechargeable. For example, a Fully Hybrid Electric Vehicle
(FHEV) must not include FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC
value for INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC value for
INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such,
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
Change mode: STATIC
Access mode: READ
Enum type: FuelType
Unit type: N/A
Release: Android 13
INFO_MAKE
Manufacturer of vehicle. This property must communicate the vehicle's public brand name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL
Model of vehicle. This property must communicate the vehicle's public model name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL_YEAR
Model year of vehicle in `YYYY` format based on the Gregorian calendar.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:YEAR
Release: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
Multiple EV port locations. Implement this property if the vehicle has multiple EV ports. Port locations are defined in PortLocationType. For example, a car has one port front left and one port rear left:
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
If a vehicle has only one port, this property's value should list one element. To describe one port location, see INFO-EV-PORT-LOCATION
.
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_VIN
VIN of vehicle.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INITIAL_USER_INFO
Defines the Android user to be used during initialization. This property is called by
the Android system when it initializes and lets the HAL define which Android user should be
started. This request is made by setting a VehiclePropValue (defined by
InitialUserInfoRequest
), and the HAL must respond with a property change event (defined
by InitialUserInfoResponse).
If the HAL doesn't respond after a time defined by the Android system, the Android system proceeds
as if HAL returned a response of action InitialUserInfoResponseAction:DEFAULT.
For example, on first boot, the request could be:
int32[0] 42 // request id (arbitrary number set by Android system) int32[1] 1 // InitialUserInfoRequestType::FIRST_BOOT int32[2] 0 // id of current user (usersInfo.currentUser.userId) int32[3] 1 // flag of current user (usersInfo.currentUser.flags = SYSTEM) int32[4] 1 // number of existing users (usersInfo.numberUsers); int32[5] 0 // user #0 (usersInfo.existingUsers[0].userId) int32[6] 1 // flags of user #0 (usersInfo.existingUsers[0].flags)
int32[0] 42 // must match the request id from the request int32[1] 2 // action = InitialUserInfoResponseAction::CREATE int32[2] -10000 // userToSwitchOrCreate.userId (not used as user will be created) int32[3] 8 // userToSwitchOrCreate.flags = ADMIN string: "||Owner" // userLocales + separator + userNameToCreate
InitialUserInfoResponseAction:CREATE
). For example, to create the
same Owner user with en-US and pt-BR locales, the string value of the response is
en-US,pt-BR||Owner. As such, neither the locale nor the name can contain two vertical bars
(||
) in their values, although you can use a single vertical bar (|
).
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
J 到 R
LANE_CENTERING_ASSIST_COMMAND
车道居中辅助 (LCA) 命令。此类命令用于启用和暂停 LCA。来自 LaneCenteringAssistCommand
的命令 ACTIVATE
发出时,LANE_CENTERING_ASSIST_STATE
必须设置为 LaneCenteringAssistState#ACTIVATION_REQUESTED
。当 ACTIVATE
命令成功时,LANE_CENTERING_ASSIST_STATE
必须设置为 LaneCenteringAssistState#ACTIVATED
。当来自 LaneCenteringAssistCommand
的命令 DEACTIVATE
成功时,LANE_CENTERING_ASSIST_STATE
必须设置为 LaneCenteringAssistState#ENABLED
。
对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValues
,除非同时支持 LaneCenteringAssistCommand
的所有枚举值。如果此属性因 LCA 处于停用状态(例如 LANE_CENTERING_ASSIST_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 LANE_CENTERING_ASSIST_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 LANE_CENTERING_ASSIST_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:LaneCenteringAssistCommand
单位类型:无
版本:Android 14
LANE_CENTERING_ASSIST_ENABLED
启用或停用车道居中辅助 (LCA)。设置为 true 表示启用 LCA,设置为 false 表示停用 LCA。当 LCA 处于启用状态时,车辆中的 ADAS 系统应处于开启状态并等待来自驾驶员的启用信号。此功能启用后,ADAS 系统应驾驶车辆,使其保持在当前车道中间行驶。
这与车道保持辅助 (LKA) 不同,后者用于监测驾驶员是否无意中向车道标线偏移或越过车道标线。如果检测到车道意外偏离,系统会应用转向控制让车辆返回到当前车道。一般来说,LANE_CENTERING_ASSIST_ENABLED
应始终返回 true 或 false。 如果该功能因某种临时状态(例如车速过慢或过快)而不可用,则必须通过 LANE_CENTERING_ASSIST_STATE
属性中的 ErrorState
值传达此信息。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 14
LANE_CENTERING_ASSIST_STATE
车道居中辅助 (LCA) 状态。返回 LCA 的当前状态。此属性必须始终返回 LaneCenteringAssistState
或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。
如果 LCA 包含车道偏离警告,这些警告必须通过车道偏离警告 (LDW) 属性显示。
对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 LaneCenteringAssistState
(包括不推荐的 OTHER)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:LaneCenteringAssistState/ErrorState
单位类型:无
版本:Android 14
LANE_DEPARTURE_WARNING_ENABLED
启用或停用车道偏离警告 (LDW)。设置为 true 表示启用 LDW,设置为 false 表示停用 LDW。当 LDW 处于启用状态时,车辆中的 ADAS 系统应保持开启,并监测车辆是否接近或越过车道线;如果是,则会发出警告。
一般来说,LANE_DEPARTURE_WARNING_ENABLED
应始终返回 true 或 false。 如果该功能因某种临时状态(例如车速过慢或过快)而不可用,则必须通过 LANE_DEPARTURE_WARNING_STATE
属性中的 ErrorState
值传达此信息。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 14
LANE_DEPARTURE_WARNING_STATE
车道偏离警告 (LDW) 状态。返回 LDW 的当前状态。此属性必须始终返回 LaneDepartureWarningState
或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。
对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 LaneDepartureWarningState
(包括不推荐的 OTHER)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:LaneDepartureWarningState/ErrorState
单位类型:无
版本:Android 14
LANE_KEEP_ASSIST_ENABLED
启用或停用车道保持辅助 (LKA)。设置为 true 表示启用 LKA,设置为 false 表示停用 LKA。当 LKA 处于启用状态时,车辆中的 ADAS 系统应保持开启,并监测驾驶员是否无意中向车道标线偏移或越过车道标线。如果检测到车道意外偏离,系统会应用转向控制让车辆返回到当前车道。这与车道居中辅助 (LCA) 不同,LCA 在启用后会应用连续转向控制,让车辆保持在当前车道中间行驶。
一般来说,LANE_KEEP_ASSIST_ENABLED
应始终返回 true 或 false。 如果该功能因某种临时状态(例如车速过慢或过快)而不可用,则必须通过 LANE_KEEP_ASSIST_STATE
属性中的 ErrorState
值传达此信息。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 14
LANE_KEEP_ASSIST_STATE
车道保持辅助 (LKA) 状态。返回 LKA 的当前状态。此属性必须始终返回 LaneKeepAssistState
或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。
如果 LKA 包含在应用转向修正之前发出车道偏离警告,这些警告必须通过车道偏离警告 (LDW) 属性显示。
对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 LaneKeepAssistState
(包括不推荐的 OTHER)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:LaneKeepAssistState/ErrorState
单位类型:无
版本:Android 14
LOCATION_CHARACTERIZATION
对用于计算位置的输入内容的特性描述。此属性必须指明:系统在计算通过 GNSS HAL 与 Android 共享的车辆位置信息时会考虑哪些数据和传感器输入(如果有)。
该值必须返回一组位标志。位标志在 LocationCharacterization 中定义。该值还必须在其位标志集合中确切包含 DEAD_RECKONED
或 RAW_GNSS_ONLY
之一。
如果不支持此属性,则假定没有其他传感器输入会融合到通过 GNSS HAL 提供的 GNSS 更新中。除非通过 GNSS HAL 接口另行指定。
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 14
MIRROR_AUTO_FOLD_ENABLED
表示车镜自动折叠功能的属性。当启用自动折叠车辆侧视镜的功能(例如当驾驶员离开并锁车后,车镜自动向内折叠)时,此属性为 true。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 14
MIRROR_AUTO_TILT_ENABLED
表示车镜自动倾斜功能的属性。当启用自动倾斜车辆侧视镜的功能(例如当驾驶员倒车时,车镜自动向下倾斜)时,此属性为 true。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 14
MIRROR_FOLD
车镜折叠。true 表示车镜已折叠。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 13
MIRROR_LOCK
车镜锁定。true 表示车镜位置已锁定且不可更改。此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 13
MIRROR_Y_MOVE
车镜在 Y 轴上的移动。必须定义每个 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。
maxInt32Value
表示车镜在向右倾斜时的最快移动速度。minInt32Value
表示车镜在向左倾斜时的最快移动速度。
绝对值越大(无论是正值还是负值),表示移动速度就越快。车镜达到位置极限后,该值必须重置为 0。如果 MIRROR_Y_MOVE 的值目前为 0,则表示目前没有发生任何移动。
此属性不采用任何特定单位,而是采用相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 13
MIRROR_Y_POS
车镜在 Y 轴上的位置。必须定义 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。minInt32Value
表示车镜完全向左倾斜。
此值必须为非正值。maxInt32Value
表示车镜完全向右倾斜。此值必须是非负值。0 表示镜子没有向任一方向倾斜。
如果值介于 minInt32Value
和 maxInt32Value
之间,表示车镜处于左极限位置和右极限位置之间的过渡状态。
此属性不采用任何特定单位,而是采用相对位置的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 13
MIRROR_Z_MOVE
车镜在 Z 轴上的移动。必须定义每个 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。
maxInt32Value
表示车镜在向上倾斜时的最快移动速度。minInt32Value
表示车镜在向下倾斜时的最快移动速度。绝对值越大(无论是正值还是负值),表示移动速度就越快。车镜达到位置极限后,该值必须重置为 0。如果 MIRROR_Z_MOVE 的值目前为 0,则表示目前没有发生任何移动。
此属性不采用任何特定单位,而是采用相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 13
MIRROR_Z_POS
车镜在 Z 轴上的位置。必须定义 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。 必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。minInt32Value
表示车镜完全向下倾斜。此值必须是非正值。maxInt32Value
表示车镜完全向上倾斜。此值必须是非负值。0 表示车镜没有向任一方向倾斜。
如果值介于 minInt32Value
和 maxInt32Value
之间,表示车镜处于完全向下位置和完全向上位置之间的过渡状态。
此属性不采用任何特定单位,而是采用相对位置的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:无
单位类型:无
版本:Android 13
NIGHT_MODE
true 表示夜间模式传感器检测到车厢环境光线较弱。例如,平台可以利用此信息启用适当的界面,以便在黑暗或弱光环境中获得更好的视效。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
OBD2_FREEZE_FRAME
报告在故障发生并被检测到时可用的 OBD2 传感器值的快照。提供的 configArray 的含义必须与为 OBD2_LIVE_FRAME
定义的含义相同
此属性的值的解读方式与 OBD2_LIVE_FRAME
类似,只不过 stringValue 字段可能包含非空的诊断问题排查代码 (DTC)。
此属性的 IVehicle#get 请求必须为 int64Values[0] 提供值。系统会将其解读为要检索的冻结帧的时间戳。可以通过 IVehicle#get 的 OBD2_FREEZE_FRAME_INFO
获取时间戳列表
如果在给定时间戳处没有可用的冻结帧,实现必须返回 NOT_AVAILABLE
响应。由于车辆的冻结帧存储空间可能有限,因此即使最近通过 OBD2_FREEZE_FRAME_INFO
获取了关联的时间戳,帧请求也可能会以 NOT_AVAILABLE
响应。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
OBD2_FREEZE_FRAME_CLEAR
清除冻结帧。报告在故障发生并被检测到时可用的 OBD2 传感器值的快照。提供的 configArray 的含义必须与为 OBD2_LIVE_FRAME
定义的含义相同
此属性的值的解读方式与 OBD2_LIVE_FRAME
类似,只不过 stringValue 字段可能包含非空的诊断问题排查代码 (DTC)。
此属性的 IVehicle#get 请求必须为 int64Values[0] 提供值。系统会将其解读为要检索的冻结帧的时间戳。可以通过 IVehicle#get 的 OBD2_FREEZE_FRAME_INFO
获取时间戳列表
如果在给定时间戳处没有可用的冻结帧,实现必须返回 NOT_AVAILABLE
响应。由于车辆的冻结帧存储空间可能有限,因此即使最近通过 OBD2_FREEZE_FRAME_INFO
获取了关联的时间戳,帧请求也可能会以 NOT_AVAILABLE
响应
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
OBD2_FREEZE_FRAME_INFO
此属性描述了存储在车辆内存中且可通过 OBD2_FREEZE_FRAME
检索的当前冻结帧。这些值的解读如下。int64Values 的每个元素都必须是检测到故障代码并存储相应冻结帧的时间戳,并且每个此类元素都可以用作 OBD2_FREEZE_FRAME
的键来检索相应的冻结帧。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
OBD2_LIVE_FRAME
报告可用 OBD2 传感器的当前(实时)值的快照。configArray 的设置如下所示:
configArray[0]
供应商特定的整数值传感器的数量configArray[1]
供应商特定的浮点值传感器的数量
此属性的值应按以下示例进行解读。考虑 configArray = {2,3} int32Values
必须是一个包含 Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX
和两个元素(即 33 个元素)的向量。floatValues
必须是一个包含 Obd2FloatSensorIndex.LAST_SYSTEM_INDEX
和三个元素(即 73 个元素)的向量。
每个帧都可能包含不同的传感器值子集,既有系统提供的传感器,又有特定供应商的传感器。为了支持这一点,属性值的字节元素会用作位掩码。字节数必须足以表示可能的传感器总数(在本例中,14 个字节表示 106 个可能的值)。它应被读取为连续的位掩码,以便每个位都表示帧中是否存在传感器,从与 int32Values
大小相同数量的位开始,紧接着读取与 floatValues 大小相同数量的位。
例如,如果 bytes[0] = 0x4C (0b01001100)
,则表示:
int32Values[0 and 1]
不是有效的传感器值int32Values[2 and 3]
是有效的传感器值int32Values[4 and 5]
不是有效的传感器值int32Values[6]
是有效传感器值int32Values[7]
不是有效的传感器值int32Values[0 and 1]
不是有效的传感器值int32Values[2 and 3]
是有效的传感器值int32Values[4 and 5]
不是有效的传感器值int32Values[6]
是有效传感器值int32Values[7]
不是有效的传感器值
如果 bytes[5] = 0x61 (0b01100001)
,则:
int32Values[32]
是有效的传感器值floatValues[0 thru 3]
是无效的传感器值floatValues[4 and 5]
是有效的传感器值floatValues[6]
不是有效的传感器值。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
ON_CHANGE
更改模式:
访问模式:READ_WRITE/READ
枚举类型:
VehicleLightSwitch
单位类型:无
版本:Android 13
PARKING_BRAKE_AUTO_APPLY
自动应用驻车制动。如果为 true,此属性表示汽车的自动驻车制动功能已启用。false 表示汽车的自动驻车制动功能已停用。此属性经常与 PARKING_BRAKE_ON
混淆。区别在于 PARKING_BRAKE_ON
表示实际驻车制动处于开启还是关闭状态;而 PARKING_BRAKE_AUTO_APPLY
表示自动驻车制动功能处于启用还是停用状态,并不描述实际驻车制动的当前状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
PARKING_BRAKE_ON
驻车制动状态。如果此属性为 true,表示汽车的驻车制动已启用。false 表示汽车的驻车制动处于解除状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
PER_DISPLAY_BRIGHTNESS
此属性用于表示单独受控制的显示屏的亮度。某些汽车有一个或多个亮度可单独控制的显示屏,此属性用于告知每个乘客显示屏的亮度。如果所有显示屏的亮度都一起受控,汽车必须使用 DISPLAY_BRIGHTNESS
应仅实现 PER_DISPLAY_BRIGHTNESS
和 PER_DISPLAY_BRIGHTNESS
中的一项。如果这两者都可用,AAOS 会使用 PER_DISPLAY_BRIGHTNESS
。
显示屏端口唯一性地标识设备上针对显示屏输出的实体连接器,范围从 0 到 255。
int32Values[0]
显示屏端口int32Values[1]
亮度
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 14
PERF_ODOMETER
车辆的当前里程表值。
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:KILOMETER
版本:Android 13
PERF_REAR_STEERING_ANGLE
车辆的自行车模型后轮转向角度。角度以度为单位。左侧为负数。 此属性与方向盘的角度无关。此属性必须传达后轮相对于车辆的角度,而不是方向盘的角度。
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:DEGREES
版本:Android 13
PERF_STEERING_ANGLE
车辆的自行车模型前轮转向角度。角度以度为单位。左侧为负数。此属性与方向盘的角度无关。此属性必须传达前轮相对于车辆的角度,而不是方向盘的角度。
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:DEGREES
版本:Android 13
PERF_VEHICLE_SPEED
车辆的速度。当车辆前进时,该值必须为正值;当车辆倒车时,该值必须为负值。此值与档位值(CURRENT_GEAR
或 GEAR_SELECTION
)无关。例如,如果 GEAR_SELECTION
为 GEAR_NEUTRAL
,则 PERF_VEHICLE_SPEED
在车辆前进时为正数,在车辆倒车时为负数,在车辆不动时为零。
更改模式:CONTINUOUS
访问模式:READ
单位类型:无
单位类型:VehicleUnit:METER_PER_SEC
版本:Android 13
PERF_VEHICLE_SPEED_DISPLAY
显示屏上车辆的速度,某些汽车的速度表上显示的速度会比实际速度略慢。
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:METER_PER_SEC
版本:Android 13
POWER_POLICY_GROUP_REQ
定义了一项请求,用于设置电源策略组,以便在每次电源状态转换时决定默认电源策略。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
POWER_POLICY_REQ
定义应用电源策略的请求。VHAL 会设置此属性以更改汽车电源策略。汽车电源策略服务会订阅此属性,并实际更改电源策略。该请求是通过使用在 /vendor/etc/automotive/power_policy.xml
中定义的电源策略的 ID 设置 VehiclePropValue 来发出的。如果未定义给定 ID,汽车电源策略服务会忽略该请求,并保持当前电源策略。
string: "sample_policy_id" // power policy ID
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
POWER_POLICY_GROUP_REQ
定义了一项请求,用于设置电源策略组,以便在每次电源状态转换时决定默认电源策略。VHAL 使用电源策略组的 ID 设置此属性,以设置在电源状态转换时应用的默认电源策略。电源策略组在 /vendor/etc/power_policy.xml 中定义。如果未定义给定 ID,汽车电源策略服务会忽略该请求。汽车电源策略服务会订阅此属性并设置电源策略组。当系统电源状态发生变化且有针对新电源状态的有效映射电源策略时,系统会实际应用电源策略。
string: "sample_policy_group_id" // power policy group ID
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
RANGE_REMAINING
剩余续航里程。剩余燃料和电量可行驶的里程数(以米为单位)。剩余续航里程应考虑车辆中的所有能量来源。例如,混动车的续航里程是基于燃油和电池的续航里程之和。此属性定义为 VehiclePropertyAccess.READ_WRITE
,因为导航应用如果能根据后续路线得到更准确的估算值,便可能会更新续航里程。此属性可由 OEM 自行决定实现为仅 VehiclePropertyAccess.READ
。
更改模式:CONTINUOUS
访问模式:READ_WRITE
枚举类型:无
单位类型:VehicleUnit:METER
版本:Android 13
READING_LIGHTS_STATE
返回阅读灯的当前状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleLightState
单位类型:无
版本:Android 13
READING_LIGHTS_SWITCH
用于控制阅读灯的开关。如果灯开着是因为门打开了或因为语音指令,则可能与 READING_LIGHTS_STATE
不同。例如,当开关处于关闭或自动位置时。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
REAR_FOG_LIGHTS_STATE
返回后雾灯的当前状态。只能实现 FOG_LIGHTS_STATE
或 REAR_FOG_LIGHTS_STATE
之一。请参见 FOG_LIGHTS_STATE
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleLightState
单位类型:无
版本:Android 13
REAR_FOG_LIGHTS_SWITCH
用户所需的设置。必须实现 FOG_LIGHTS_SWITCH
或 REAR_FOG_LIGHTS_SWITCH
中的一个。如需了解详情,请参阅 FOG_LIGHTS_SWITCH
。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE/READ
枚举类型:VehicleLightSwitch
单位类型:无
版本:Android 13
REMOVE_USER
在某个 Android 用户被移除后由 Android 系统调用。HAL 可以使用此属性来移除相应的用户。这是只写调用。Android 系统不会预期 HAL 发来回复。因此,此请求不应失败。如果无法移除相应 HAL 用户,则 HAL 应将其标记为非活跃状态或通过另一方式恢复。
该请求是通过使用 RemoveUserRequest
定义的内容设置 VehiclePropValue 来发出的。例如,如果系统有 3 位用户(0、10 和 11),并且移除了用户 11,请求如下所示:
int32[0]
42 // 请求 IDint32[1]
11 //(被移除用户的 Android 用户 ID)int32[2]
0 //(被移除用户的 Android 用户标志)int32[3]
10 // 当前用户int32[4]
0 // 当前用户标志(无)int32[5]
2 // 用户数量int32[6]
0 // 第一位用户(用户 0)int32[7]
0 // 第一位用户标志(无)int32[8]
10 // 第二位用户(用户 10)int32[9
] 0 // 第二位用户标志(无)
更改模式:STATIC
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
S 到 Z
SEAT_AIRBAG_ENABLED
表示在被触发时允许和停用座椅的安全气囊开启功能的功能
(例如,在碰撞中)。如果为 true
,则表示已启用座椅的安全气囊功能;
它们会在触发后部署如果为 true
,则安全座椅的安全气囊会停用,它们会停用
在任何情况下都不部署。此属性未指示安全气囊是否已展开。
此属性可设置为 VehiclePropertyAccess.READ
只读,
法规或安全问题。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_BACKREST_ANGLE_1_MOVE
座椅靠背角度 1 移动。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义每个 VehicleAreaConfig
。介于以下两者之间的所有整数
必须支持 minInt32Value
和 maxInt32Value
。
maxInt32Value
表示在
minInt32Value
表示座椅的最大移动速度
靠背。
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
座椅靠背达到位置限制,则该值必须重置为 0。如果
SEAT_BACKREST_ANGLE_1_MOVE
为 0,表示未发生任何移动。
此属性在特定的相对移动速度范围内表示。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_BACKREST_ANGLE_1_POS
座椅靠背角度 1 位置。靠背角度 1 是最靠近
座位。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。minInt32Value
表示
座椅靠背相对于座椅底部的致动器的完整倾斜位置。通过
maxInt32Value
表示座椅靠背最直立或最向前的位置,
关于座椅底部的致动器
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
与完全倾斜位置之间的状态
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
仅将其实现为 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_BACKREST_ANGLE_2_MOVE
座椅靠背角度 2 移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
maxInt32Value
表示在
minInt32Value
表示座椅的最大移动速度
靠背。
绝对值越大(正值或负值)表示移动速度越快。部署
座椅靠背达到位置限制,则该值必须重置为 0。如果
SEAT_BACKREST_ANGLE_2_MOVE
当前为 0,未进行任何操作。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 13
SEAT_BACKREST_ANGLE_2_POS
座椅靠背角度 2 的位置。靠背角度 2 是从底座底部向上的下一个致动器 座位。
VehicleAreaConfig
的maxInt32Value
和minInt32Value
。介于 minInt32Value
到 maxInt32Value
之间的所有整数
必须支持 #0。
minInt32Value
表示与座椅靠背相关的完全倾斜位置
从座椅底端的执行器传到靠背中的下一个致动器(请参阅
SEAT_BACKREST_ANGLE_1_POS
了解详情)。maxInt32Value
表示
相对于靠背中的下一个致动器,座椅靠背最垂直和最向前的位置
(如需了解详情,请参阅 SEAT_BACKREST_ANGLE_1_POS
)。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_BELT_BUCKLED 卡
已系好安全带。true 表示皮带已系好。写入权限表示自动系安全座
功能。此属性定义为 VehiclePropertyAccess.READ_WRITE
,但原始设备制造商 (OEM)
只能以 VehiclePropertyAccess.READ
的形式实现。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_BELT_HEIGHT_MOVE
安全带高度移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
maxInt32Value
表示安全带肩部的最大移动速度
固定位置minInt32Value
表示
固定在安全带肩膀处,同时向下移动。
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
安全带达到位置限制时,该值必须重置为 0。如果
SEAT_BELT_HEIGHT_MOVE
为 0,表示未执行任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_BELT_HEIGHT_POS
安全带高度位置。调整肩带定位点。
VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
必须为
。介于 minInt32Value
和 maxInt32Value
之间的所有整数都必须是
支持。
minInt32Value
表示安全带的肩部锚位于最低位置
排名。maxInt32Value
表示安全带的肩部锚处位于
最高排名。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
最低排名和最高排名之间。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_CUSHION_SIDE_SUPPORT_MOVE
表示座椅靠垫侧支撑的移动方向和速度属性。
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。介于 minInt32Value
和 maxInt32Value
之间的所有整数都必须是
支持。
maxInt32Value
表示座椅靠垫侧的最大移动速度
扩大支持范围(例如支持减少)。minInt32Value
表示座椅靠垫侧支撑物变窄时的最大移动速度
(例如,支持服务在不断增加)。
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
座垫侧面支撑物达到位置限制时,必须将值重置为 0。如果
SEAT_CUSHION_SIDE_SUPPORT_MOVE
为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_CUSHION_SIDE_SUPPORT_POS
表示座椅的臀部(坐垫底部)支撑位置的属性。
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。所有整数
介于 minInt32Value
和 maxInt32Value
之间。
maxInt32Value
表示座椅靠垫侧支撑物处于最宽的位置(例如,
。minInt32Value
表示座椅坐垫侧面支撑物处于最薄状态
排名(例如,大多数支持)。
minInt32Value
和 maxInt32Value
之间的值表示
最薄最宽的位置。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
将其实现为 <covehiclepropertyaccess.read<code=""></covehiclepropertyaccess.read<>
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_DEPTH_MOVE
座位深度变动。
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。介于 minInt32Value
和 maxInt32Value
之间的所有整数都必须是
支持。
maxInt32Value
表示在抵达目的地时,座椅的最大移动速度
minInt32Value
表示座椅的最大移动速度,
越来越浅
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
座椅靠背达到位置限制,则该值必须重置为 0。如果
SEAT_DEPTH_MOVE
当前为 0,未进行任何操作。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
SEAT_DEPTH_POS
座位深度位置。设置座椅深度,即从靠后靠背到座椅前边缘的距离。
必须定义 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。所有整数
介于 minInt32Value
和 maxInt32Value
之间。
minInt32Value
表示座椅位于最浅的位置(例如,带有
坐垫前边缘与座椅后端之间的最小距离。
maxInt32Value
表示座位处于最深位置(例如,
坐垫前边缘与座椅后端之间的最大距离)。
minInt32Value
和 maxInt32Value
之间的值表示
最浅和最深的位置。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
将其实现为 <covehiclepropertyaccess.read<code=""></covehiclepropertyaccess.read<>
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_EASY_ACCESS_ENABLED
表示座位轻松访问功能的属性。如果为 true,系统会自动调整座位
方便乘客上下车。每个区域 ID 都必须映射到
用户尝试进入/退出的位置。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
将其实现为 <covehiclepropertyaccess.read<code=""></covehiclepropertyaccess.read<>
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_FOOTWELL_LIGHTS_STATE
表示座椅脚井灯状态的属性。SEAT_FOOTWELL_LIGHTS_STATE
反映了
随时了解灯具的当前状态它与
SEAT_FOOTWELL_LIGHTS_SWITCH
,表示控制灯的开关的位置。
因此, SEAT_FOOTWELL_LIGHTS_STATE
可能与 SEAT_FOOTWELL_LIGHTS_SWITCH
的值不匹配
(例如 SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
和 SEAT_FOOTWELL_LIGHTS_SWITCH=ON
)。
仅当 SEAT_FOOTWELL_LIGHTS_STATE
的值可能不同时,才应实现此属性
CABIN_LIGHTS_STATE。
对于每个受支持的区域 ID,必须定义 VehicleAreaConfig#supportedEnumValues,除非 支持 VehicleLightState 的所有枚举值。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleLightState
单位类型:不适用
版本:Android 14
SEAT_FOOTWELL_lightS_SWITCH
表示座椅脚井灯开关的属性。SEAT_FOOTWELL_LIGHTS_SWITCH
表示
控制灯的开关的位置。它与
SEAT_FOOTWELL_LIGHTS_STATE,用于反映灯在任何时间点的当前状态。
因此,SEAT_FOOTWELL_LIGHTS_SWITCH
可能与 SEAT_FOOTWELL_LIGHTS_STATE 的值不匹配
(例如 SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
和 SEAT_FOOTWELL_LIGHTS_SWITCH=ON
)。
仅当 SEAT_FOOTWELL_LIGHTS_SWITCH 的值可能不同时,才应实现此属性 。
对于每个受支持的区域 ID,必须定义 VehicleAreaConfig#supportedEnumValues,除非所有 支持 VehicleLightSwitch 的枚举值。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleLightSwitch
单位类型:不适用
版本:Android 13
SEAT_FORE_AFT_MOVE
座椅前后移动。此属性可将整个座椅向前/向后移动 这个对象面对的
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。介于 minInt32Value
和 maxInt32Value
之间的所有整数都必须是
支持。
maxInt32Value
表示座椅移动时的最大移动速度
。minInt32Value
表示在
向后移动。
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
则该值必须重置为 0。如果
SEAT_FORE_AFT_MOVE
为 0,表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_FORE_AFT_POS
座椅前置和后置位置。设置向前和向后的位置。
必须定义 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。
minInt32Value
表示座椅位于最后方的线性位置。
maxInt32Value
表示座椅位于最前方的线性位置。值
minInt32Value
和 maxInt32Value
之间的值表示过渡状态
距离最近的和最近的位置。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_ANGLE_MOVE
头枕角度移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
maxInt32Value
表示当座椅头枕处于使用状态时,
从而保持竖直或向前移动。minInt32Value
表示
座椅靠枕的浅层移动速度。
绝对值越大(无论是正值还是负值),表示移动速度就越快。一次
安全座椅的头枕达到位置限制时,该值必须重置为 0。如果
SEAT_HEADREST_ANGLE_MOVE
为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
将其实现为 <covehiclepropertyaccess.read<code=""></covehiclepropertyaccess.read<>
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_ANGLE_POS
头枕的角度位置。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
minInt32Value
表示头枕处于完全倾斜位置。通过
maxInt32Value
表示头枕处于最直立且最向前的位置。
介于 minInt32Value
和 maxInt32Value
之间的值表示
完全倾斜与最直立和最前两种位置之间的过渡状态。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
仅将其实现为 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_FORE_AFT_MOVE
头枕前方和尾部移动。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义每个 VehicleAreaConfig
。介于以下两者之间的所有整数
必须支持 minInt32Value
和 maxInt32Value
。
maxInt32Value
表示座椅靠背的最大移动速度
minInt32Value
表示
向后移动时保持在座椅头枕上
绝对值越大(无论是正值还是负值),表示移动速度就越快。一次
安全座椅的头枕达到位置限制时,该值必须重置为 0。如果
SEAT_HEADREST_FORE_AFT_MOVE
为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_FORE_AFT_POS
头枕前方和尾部位置。maxInt32Value
和minInt32Value
必须在 VehicleAreaConfig
中定义。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
minInt32Value
表示头枕位于最靠后的线性位置。
maxInt32Value
表示头枕处于最前方的线性位置。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
一个状态。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_HEIGHT_MOVE
头枕高度移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
maxInt32Value
表示当座椅头枕处于使用状态时,
向上移动minInt32Value
表示座椅座椅的最大移动速度。
头枕头往下移动。
绝对值越大(无论是正值还是负值),表示移动速度就越快。一次
安全座椅的头枕达到位置限制时,该值必须重置为 0。如果
SEAT_HEADREST_HEIGHT_MOVE
为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_HEIGHT_POS
(已弃用)头枕高度位置。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEADREST_HEIGHT_POS_V2
头枕的高度位置。设置受支持的座椅的头枕高度。 VehiclePropConfig.areaConfigs 用于指定支持的座椅。
VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
必须为
。介于 minInt32Value
和 maxInt32Value
之间的所有整数都必须是
支持。
minInt32Value
表示头枕处于最低位置。通过
maxInt32Value
表示头枕处于最高位置。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
最低排名和最高排名之间。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_HEIGHT_MOVE
座位高度变动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。
maxInt32Value
表示座椅上移时座椅的最大移动速度。
minInt32Value
表示座椅下移时的最大移动速度。
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
则该值必须重置为 0。如果
SEAT_HEIGHT_MOVE
值为 0,表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_HEIGHT_POS
座位高度位置。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。
minInt32Value
表示座位处于最低位置。通过
maxInt32Value
表示座位处于最高位置。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
最低排名和最高排名之间。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_LUMBAR_FORE_AFT_MOVE
腰前和向后移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。
maxInt32Value
表示座椅腰部支撑物的最大移动速度
minInt32Value
表示
在向后移动时支撑座椅的腰部支撑。
绝对值越大(正值或负值)表示移动速度越快。
当座椅的腰部支撑物达到位置限制时,该值必须重置为 0。
如果 SEAT_LUMBAR_FORE_AFT_MOVE
的值为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_LUMBAR_FORE_AFT_POS
前方和尾部的木材位置。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。
minInt32Value
表示腰部支撑物位于最靠后的位置
(例如,最能起到支撑作用的姿势)。maxInt32Value
表示腰部
支撑物置于最前方(例如,最支撑物的位置)。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
一个状态。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问权限类型:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 13
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
腰部支撑物移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig
。介于 minInt32Value
之间的所有整数
和 maxInt32Value
。
maxInt32Value
表示座椅腰部一侧的最大移动速度
同时获得支持minInt32Value
表示最大移动
同时逐渐变薄。
绝对值越大(无论是正值还是负值),表示移动速度就越快。一次
座椅的腰侧支撑物达到位置限制时,该值必须重置为 0。如果
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
值为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问权限类型:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
腰部侧支撑姿势。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。minInt32Value
表示腰部侧支撑物处于最薄的位置(例如,大多数支撑物)。通过
maxInt32Value
表示腰部支撑物处于最宽的位置(
(例如,最低支持)。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
最窄和最宽位置之间的所有状态。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问权限类型:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_LUMBAR_VERTical_MOVE
表示座椅腰部支撑的垂直移动方向和速度属性。
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。maxInt32Value
表示腰部支撑物以最快的速度移动
提升速度minInt32Value
表示腰部支撑物以最快的速度移动
降低速度
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署 座垫侧面支撑物达到位置限制时,必须将值重置为 0。如果 SEAT_LUMBAR_VERTical_MOVE 为 0,则表示未发生任何移动。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_LUMBAR_VERTical_POS
表示座椅腰部支撑垂直位置的属性。maxInt32Value
每个 VehicleAreaConfig 中的 minInt32Value
都必须定义。介于以下两者之间的所有整数
必须支持 minInt32Value
和 maxInt32Value
。
maxInt32Value
表示腰部支撑物的最高位置。
minInt32Value
表示腰部支撑物的最低位置。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
最低排名和最高排名之间。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_MEMORY_SELECT
此参数用于选择内存预设,用于选择座椅位置。通过
必须定义 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。
minInt32Value
始终为 0,由 maxInt32Value
决定
可用的座椅预设内存槽数(例如 numSeatPresets - 1)。例如,
如果驾驶座具有三个内存预设,则 maxInt32Value
为 2。当
用户选择某个预设,则所需的预设编号(0、1 或 2)已设置。
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
SEAT_MEMORY_SET
此设置允许用户将当前座椅位置设置保存到所选预设中
。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig
。minInt32Value
必须为 0,并且
maxInt32Value
每个座位位置都必须与maxInt32Value
SEAT_MEMORY_SELECT
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
SEAT_OCCUPANCY
指示特定座位是否有人,系统会尽最大努力判断汽车是否有人就座。有效
值来自 VehicleSeatOccupancyState
枚举。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleSeatOccupancyState
单位类型:不适用
版本:Android 13
SEAT_TILT_MOVE
座椅倾斜移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。maxInt32Value
表示在座椅上移时座椅前边缘的最大移动速度。通过
minInt32Value
表示座椅前边缘的最大移动速度
同时向下移动
绝对值越大(无论是正值还是负值),表示移动速度就越快。一次 底部达到位置限制,则该值必须重置为 0。如果 SEAT_TILT_MOVE 值为 0,表示未执行任何操作。
此属性表示为相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
SEAT_TILT_POS
座椅倾斜位置。以下国家/地区的maxInt32Value
和minInt32Value
:
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。minInt32Value
表示座椅底部处于最低角度位置。这对应于座位的
尽可能低的位置(相对于座椅后端)。
maxInt32Value
表示座椅底部处于最大角度位置。
这对应于座椅前边缘(相对于后部最高位置)
一开始。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
最低排名和最高排名之间。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SEAT_WALK_IN_POS
表示表示座位的当前到店位置的属性。通过
minInt32Value
表示正常的座椅位置。minInt32Value
必须为 0。maxInt32Value
表示座位处于无人入座状态。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
状态。
此属性表示为指定的相对位置范围。
区域 ID 必须与到店功能启用时实际移动的座位一致,而不是与 。
此属性定义为 VehiclePropertyAccess.READ_WRITE,但 OEM 可以
仅将其实现为 VehiclePropertyAccess.READ。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
请求关闭
请求车机关闭。
要在车机关闭时执行任务(远程任务功能),必须安装该指令。 车机接通电源以执行任务后,应关闭车机。头部 并在任务完成后发送此消息。
当用户想要关闭车机时,此属性不适用。
这通常需要将车机外的独立系统(例如,电源线) 控制器)来准备关闭车机。
外部系统必须通过检查车辆是否处于 。如果用户在 SHUTDOWN_REQUEST 后进入车辆,系统必须忽略 此请求。建议在电源控制器中存储 VehicleInUse 属性,并 它通过 VEHICLE_IN_USE 属性公开。如果 VehicleInUse 存在,必须忽略关闭请求 为 true。
如果允许,外部系统将向车机发送关闭信号,导致 VHAL 向 Android 发送 SHUTDOWN_PREPARE 消息。然后,Android 会通过 处理消息。
此属性仅用于发出请求,且仅支持写入。每次此媒体资源时 值,则无论当前属性值是什么,都会发出关闭请求。 当前的属性值没有任何意义。
由于此属性为只写属性,因此不允许订阅,也不提供属性更改事件 。
要设置的值表示关闭选项,它必须是以下之一
{@code VehicleApPowerStateShutdownParam}
例如,
VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY
。此关闭选项
。在这种情况下,不会返回错误。
对于配置信息,VehiclePropConfig.configArray
必须具有位标志
合并 {@code VehicleApPowerStateConfigFlag}
中的值,以指明哪个关停
选项。
如果未能将关闭请求发送到其他系统,则返回错误。
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:VehicleApPowerStateShutdownParam
>
单位类型:不适用
版本:Android 14
STEERING_WHEEL_DEPTH_MOVE
方向盘深度移动。maxInt32Value
和minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有值
必须支持 maxInt32Value
。
maxInt32Value
表示方向盘正在远离驾驶员处。通过
minInt32Value
表示方向盘正在朝向驾驶员方向移动。
较大的整数(正整数或负整数)表示移动速度较快。部署
值必须重置为 0。如果
STEERING_WHEEL_DEPTH_MOVE
当前为 0,未进行任何操作。
此属性表示为相对的指定范围, 移动速度
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STEERING_WHEEL_DEPTH_POS
方向盘深度位置。所有方向盘属性从 0x0BE0 开始。
VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
必须为
。介于 minInt32Value
和 maxInt32Value
之间的所有值都必须是
支持。maxInt32Value
表示最远的方向盘位置
驾驶员。minInt32Value
表示最靠近
介于 minInt32Value
和 maxInt32Value
之间的值表示
状态与
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STEERING_WHEEL_EASY_ACCESS_ENABLED
已启用方向盘轻松访问功能。如果值为 true,则自动驾驶员的方向盘 调整后,驾驶员可以更轻松地进出车辆。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STEERING_WHEEL_HEIGHT_MOVE
方向盘高度移动。maxInt32Value
和minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有值
必须支持 maxInt32Value
。
maxInt32Value
表示方向盘正在上移。通过
minInt32Value
表示方向盘正在下移。
较大的整数(正整数或负整数)表示移动速度较快。部署
值必须重置为 0。如果
STEERING_WHEEL_HEIGHT_MOVE
的值当前为 0,则表示没有任何移动
当前发生的事件
此属性表示为相对的指定范围, 移动速度
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STEERING_WHEEL_HEIGHT_POS
方向盘的高度位置。
VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
必须为
。介于 minInt32Value
和 maxInt32Value
之间的所有值都必须是
支持。maxInt32Value
表示方向盘位于最高位置
排名。minInt32Value
表示方向盘位于最低位置
排名。
介于 minInt32Value
和 maxInt32Value
之间的值表示
在最低和最高位置之间转换状态。
此属性表示为指定的相对位置范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STEERING_WHEEL_LIGHTS_STATE
方向盘灯的状态。表示方向盘灯的当前状态。这是
与表示开关位置的 STEERING_WHEEL_LIGHTS_SWITCH
不同
控制灯具因此,STEERING_WHEEL_LIGHTS_STATE
可能与
STEERING_WHEEL_LIGHTS_SWITCH
(例如
和
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
STEERING_WHEEL_LIGHTS_STATE=ON
)。
仅当 STEERING_WHEEL_LIGHTS_STATE
的值可能不同时,才应实现此属性
CABIN_LIGHTS_STATE。
对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValues,除非所有 支持 VehicleLightState 的枚举值。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleLightState
单位类型:不适用
版本:Android 14
STEERING_WHEEL_lightS_SWITCH
方向盘灯的开关。表示控制方向的开关的位置
车轮灯。它与 不同,后者表示当前状态。
方向盘灯的位置因此,STEERING_WHEEL_LIGHTS_SWITCH
可能会不匹配
STEERING_WHEEL_LIGHTS_STATE
的值。例如:
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
和
STEERING_WHEEL_LIGHTS_STATE=ON
。
只有当
STEERING_WHEEL_LIGHTS_SWITCH
可以不同于
CABIN_LIGHTS_SWITCH
。
对于全球区域 ID (0),VehicleAreaConfig#supportedEnumValues
必须为
已定义,除非支持 VehicleLightSwitch 的所有枚举值。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleLightSwitch
单位类型:不适用
版本:Android 14
向车轮方向锁
方向盘已锁定。如果为 true,方向盘的位置将处于锁定状态且无法更改。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
将其实现为 <covehiclepropertyaccess.read<code="">/p>
</covehiclepropertyaccess.read<>
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STEERING_WHEEL_THEFT_LOCK_已启用
已启用方向盘防盗锁功能。如果为 true,方向盘会自动锁定到 以防止在某些情况下盗窃。此属性定义为 VehiclePropertyAccess.READ_WRITE, 但原始设备制造商 (OEM) 只能将其实现为 VehiclePropertyAccess.READ。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
STORAGE_ENCRYPTION_BINDING_SEED 文件
外部加密绑定种子。此值与本地密钥存储加密密钥混合使用。 该属性包含 16 个字节,预计保留在与 IVI 分开的 ECU 上。 该属性最初由 AAOS 设置,AAOS 使用 CSRNG 生成该属性。然后,AAOS 读取 属性。绑定种子应可靠地持久保留。任何损失 种子会导致 IVI 恢复出厂设置。
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
SUPPORT_CUSTOMIZE_VENDOR_PERMISSION
支持为供应商属性自定义权限。
如果 VHAL 支持自定义供应商权限功能,请实现此属性。
VehiclePropConfig.configArray 用于指明供应商属性和权限,
您为该供应商媒体资源选择的定位条件该权限必须是 VehicleVendorPermission 中的枚举之一。
configArray 设置如下,configArray[n]: propId : property ID
表示
供应商属性,其中 configArray[n+1] 是 VehicleVendorPermission 中的枚举,并表示
读取属性值的权限。
configArray[n+2] 是 VehicleVendorPermission 中的枚举,表示写入权限 属性值。例如:
configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }
如果供应商属性不在此数组中,则它们具有默认供应商权限。如果是供应商 PERMISSION_NOT_ACCESSIBLE,则 Android 将无权访问该属性。在本示例中, Android 无法为 vendor_prop_2 写入值。
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
SUPPORTED_PROPERTY_IDS
(已弃用)所有受支持的媒体资源 ID 的列表。
更改模式:STATIC
访问模式:READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
SWITCH_USER
定义切换前台 Android 用户的请求。
此属性主要供 Android 系统使用,用于告知 HAL:当前的 前台 Android 用户正在切换,但 HAL 也可以使用它来请求 Android 系统来切换用户。当 Android 发出请求时,它会设置一个 VehiclePropValue 并且 HAL 必须以属性更改事件进行响应。当 HAL 发出请求时, 也可以通过属性更改事件来完成此操作(主要区别在于请求 ID 是 在前一种情况下为正值,在后情况下为负值)。SwitchUserMessageType 也有所不同。
两个请求的格式由 SwitchUserRequest 定义,而响应的格式(使用 由 SwitchUserResponse 定义。HAL(或 Android 系统)应如何继续操作取决于 针对消息类型(由 SwitchUserMessageType 参数定义),如下所述。LEGACY_ANDROID_SWITCH
:由 Android 系统调用,以指明 Android 用户 即将更改时,更改请求的方式与 HAL(例如,通过 adb shell am switch-user)。HAL 可以切换其内部用户一次 但无需回复 Android 系统。如果 由于某种原因无法更改内部用户,则必须等到SWITCH_USER(type=ANDROID_POST_SWITCH)
调用进行恢复(例如,它可能会引发 用于切换回上一个用户的SWITCH_USER(type=VEHICLE_REQUEST)
)。理想情况下 它绝不会失败(因为切换回去可能会让最终用户感到困惑)。
例如,如果系统中有用户 (0, 10, 11),并且用户数量从 0 切换到 11 (其中都没有任何特殊标记),请求应为:
<ph type="x-smartling-placeholder">- </ph>
int32[0]
42 // 请求 IDint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // 目标用户 IDint32[3]
0 // 目标用户标志(无)int32[4]
10 // 当前用户int32[5]
0 // 当前用户标志(无)int32[6]
3 // 用户数量int32[7]
0 // 用户 0(Android 用户 ID 0)int32[8]
0 // 用户 0 的标志(无)int32[9]
10 // 用户 1(Android 用户 ID 10)int32[10]
0 // 用户 1 的标志(无)int32[11]
11 // 用户 2(Android 用户 ID 11)int32[12]
0 // 用户 2 的标志(无)
ANDROID_SWITCH
:Android 系统通过调用此方法来指示 Android 用户即将更改, 但 Android 会等待 HAL 的响应(最多一段时间),然后再继续。HAL 必须 在收到此请求后切换其内部用户,然后用SWITCH_USER(type=VEHICLE_RESPONSE)
,用于指明其内部用户是否已切换 (通过 SwitchUserStatus 枚举)。例如,如果 Android 有用户 (0, 10, 11), 从 10 切换到 11(其中都没有任何特殊标记),请求将为: <ph type="x-smartling-placeholder">- </ph>
int32[0]
42 // 请求 IDint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // 目标用户 IDint32[3]
0 // 目标用户标志(无)int32[4]
10 // 当前用户int32[5]
0 // 当前用户标志(无)int32[6]
3 // 用户数量int32[7]
0 // 第一个用户(用户 0)int32[8]
1 // 带来用户首次互动的标志 (SYSTEM)int32[9]
10 // 秒用户(用户 10)int32[10]
0 // 第二位用户标志(无)int32[11]
11 // 第 3 名用户(用户 11)int32[12]
0 // 第 3 个用户标记(无)
如果请求成功,HAL 必须使用以下命令更新该属性:
int32[0]
42 // 请求 IDint32[1]
3 // messageType:SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // 状态:SwitchUserStatus::SUCCESS
如果请求失败,响应将如下所示:
int32[0]
42 // 请求 IDint32[1]
3 // messageType:SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
2 // 状态:SwitchUserStatus::FAILURE 字符串:“108-D'OH!”- 特定于 OEM 的错误消息
VEHICLE_RESPONSE
:由 HAL 调用,以指明请求类型是否为 ANDROID_SWITCH 应继续或中止。另请参阅 ANDROID_SWITCH。VEHICLE_REQUEST
由 HAL 调用,以请求请求当前前台 Android 用户 已切换。如果 Android 以一位用户的身份启动,但车辆 将驾驶员识别为另一个用户。例如,用户 A 使用遥控钥匙解锁汽车 的用户 B。INITIAL_USER_INFO 请求返回了用户 B,但随后又返回了人脸识别 子系统将用户标识为 A。HAL 通过属性更改事件发出此请求 (传递否定请求 ID),而 Android 系统响应则是发出 ANDROID_POST_SWITCH 调用具有相同请求 ID。例如,如果当前前台 Android 用户为 10,并且 HAL 要求切换到 11,请求将为: <ph type="x-smartling-placeholder">- </ph>
int32[0]
-108 // 请求 IDint32[1]
4 // messageType:SwitchUserMessageType::VEHICLE_REQUESTint32[2]
11 // Android 用户 ID
如果请求成功且 Android 有三个用户(0、10 和 11),则响应为:
int32[0]
-108 // 请求 IDint32[1]
5 // messageType:SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // 目标用户 IDint32[3]
0 // 目标用户 ID 标记(无)int32[4]
11 // 当前用户int32[5]
0 // 当前用户标志(无)int32[6]
3 // 用户数量int32[7]
0 // 第一个用户(用户 0)int32[8]
0 // 带来用户首次互动的标志(无)int32[9]
10 // 秒用户(用户 10)int32[10]
4 // 秒用户标记(无)int32[11]
11 // 第三用户(用户 11)int32[12]
3 // 第三个用户标志(无)
当前用户 ID 和目标用户 ID 相同。如果请求失败,则结果会有所不同。 例如,目标用户将是 11,而当前用户仍然是 10。
ANDROID_POST_SWITCH
在发出切换用户的请求后由 Android 系统调用。 此属性会在任何类型的切换请求(例如 >code>LEGACY_ANDROID_SWITCH、 >code>ANDROID_SWITCH 或VEHICLE_REQUEST
),并且可用于确定请求是否成功或 已失败。- 如果成功,则当 Android 用户处于已解锁状态且 响应中的当前用户 ID 和目标用户 ID 的值相同。这是 等同于在 Android 应用中接收 Intent.ACTION_USER_UNLOCKED。
- 如果调用失败,则立即调用,并显示当前用户和目标用户 ID 的值 不同(因为当前用户没有更改为目标)。
- 在 HAL 响应前一个请求之前或之前发出了新的切换请求 用户已解锁,则系统不会发出 ANDROID_POST_SWITCH 请求。例如, 驱动程序可能会意外切换到错误的用户,这些用户具有锁定凭据, 请先切换到正确的用户,然后再输入凭据。
收到此请求后,HAL 可以更新其内部状态,但不需要 回复 Android 系统
- 请求。由
INITIAL_USER_INFO
定义的前 N 个值(其中 索引 1 处的值为SwitchUserMessageType::ANDROID_POST_SWITCH
),则还有两个值: 目标用户 ID(例如,请求切换到的 Android 用户 ID) 及其标记(由 UserFlags 定义)。 - 响应:无。有关示例,请参阅
VEHICLE_REQUEST
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
TIRE_PRESSURE
轮胎压力。每个轮胎都由其 regionConfig.areaId 配置标识。通过 minFloatValue 和 maxFloatValue 分别用于存储 OEM- 建议的压力范围。minFloatValue 和 maxFloatValue 的值 必须定义 VehicleAreaConfig。
regionConfig 数据中的 minFloatValue 表示推荐轮胎的下限 压力。regionConfig 数据中的 maxFloatValue 表示 建议的轮胎压力。例如,以下 regionConfig 表示推荐的 左侧轮胎的轮胎压力为 200.0kPa 到 240.0kPa。
.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }
更改模式:CONTINUOUS
访问模式:READ
枚举类型:不适用
单位类型:VehicleUnit:KILOPASCAL
版本:Android 13
TIRE_PRESSURE_DISPLAY_UNITS
用于显示的轮胎压力单位。指示汽车显示轮胎压力的单位 。例如,PSI、Bar 或 Kilopascal。VehiclePropConfig.configArray 用于 表示支持的压力显示单位。压力单位在 VehicleUnit 中定义。 例如,configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR
如果更新 TIRE_PRESSURE_DISPLAY_UNITS 会影响其他 *_DISPLAY_UNITS 属性的值,
那么,它们的值也必须更新并传达给 AAOS 框架。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
将其实现为 <covehiclepropertyaccess.read<code="">/p>
</covehiclepropertyaccess.read<>
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleUnit
单位类型:不适用
版本:Android 13
TRACTION_CONTROL_ACTIVE
当牵引控制 (TC) 处于启用状态时,设为 true;当 TC 处于关闭状态时,设为 false。这个 属性可根据 TC 系统的实时状态进行间歇性设置(脉冲)。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
预告片
返回汽车的拖车状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:TrailerState
单位类型:不适用
版本:Android 13
TURN_SIGNAL_STATE
车辆转向灯的状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleTurnSignal
单位类型:不适用
版本:Android 13
USER_IDENTIFICATION_ASSOCIATION
用于将当前用户与车辆专用关联(或查询关联)的属性 识别机制(例如主要 FOB)。
这是一项可选的用户管理属性。如果不使用“用户管理”功能 定义它。事实上,在使用此属性时,无需支持与核心用户相关的 函数(如 INITIAL_USER_INFO 中所述)。
为了查询关联,Android 系统会获取该属性,并传递 VehiclePropValue 包含要查询的关联类型的 UserIdentificationGetRequest 的 ID。HAL 必须立即返回,返回带有 UserIdentificationResponse 中的一部分。
请注意,在系统加载和存储内容时, 启动。Takehe VHAL 实现应仅返回已确定的关联 (例如用于解锁汽车的钥匙 FOB),而不是从 get 调用。
为了关联类型,Android 系统会设置该属性,并传递一个包含 VehiclePropValue 的值 要设置的关联的类型和值,如 UserIdentificationSetRequest 所定义。
然后,HAL 使用属性更改事件(其 VehiclePropValue 由 UserIdentificationResponse)用于表示请求后类型的当前状态。
例如,查询当前用户 (10) 是否与解锁汽车的 FOB 相关联 和 OEM 提供的自定义机制,则该请求为:
int32[0]
42 // 请求 IDint32[1]
10(Android 用户 ID)int32[2]
0(Android 用户标志)int32[3]
2(查询的类型数量)int32[4]
1(查询的第一个类型,UserIdentificationAssociationType::KEY_FOB)int32[5]
101(查询的秒类型,UserIdentificationAssociationType::CUSTOM_1)
如果用户与 FOB 相关联,但未与自定义机制相关联,则响应为:
int32[0]
42 // 请求 IDint32[1]
2(响应中的关联数量)int32[2]
1(第一个类型:UserIdentificationAssociationType::KEY_FOB)int32[3]
2(第一个值:UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)int32[4]
101(第一个类型:UserIdentificationAssociationType::CUSTOM_1)int32[5]
4(第二个值:UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)
然后,发出一个 set 请求,以将用户与自定义机制相关联:
int32[0]
43 // 请求 IDint32[1]
10(Android 用户 ID)int32[2]
0(Android 用户标志)int32[3]
1(要设置的关联数量)int32[4]
101(第一个类型:UserIdentificationAssociationType::CUSTOM_1)
如果请求成功,响应将是:
int32[0]
43 // 请求 IDint32[1]
1(响应中的关联数量)int32[2]
101(第一个类型:UserIdentificationAssociationType::CUSTOM_1)int32[3]
1(第一个值:UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
设置请求会添加关联,但不会移除现有关联。在上一个 则结束状态将是两个关联(FOB 和 CUSTOM_1)。要将用户与 CUSTOM_1 而非 FOB,请求将为:
int32[0]
43 // 请求 IDint32[1]
10(Android 用户 ID)int32[2]
2(集的类型数量)int32[3]
1(第一个类型:UserIdentificationAssociationType::KEY_FOB)int32[4]
2(第一个值:UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)int32[5]
101(秒类型:UserIdentificationAssociationType::CUSTOM_1)int32[6]
1(第二个值:UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
VEHICLE_CURB_WEIGHT
返回车辆的整备质量(以千克为单位)。整备质量是车辆的总重量 配备标准设备以及所有必要的操作消耗品,如机油、变速箱 机油、制动液、冷却剂、空调制冷剂和标称油箱中的燃料重量 在不载客的情况下增加容量。
configArray[0] 用于指定车辆的总重量(以千克为单位)。车辆的毛 “重量”是指制造商规定的车辆的最大操作重量 包括车辆的底盘、车身、引擎、发动机液体、燃料、配件、驾驶员 客车和货物,但不包括拖车。
更改模式:STATIC
访问模式:READ
枚举类型:不适用
单位类型:VehicleUnit:KILOGRAM
版本:Android 13
VEHICLE_IN_USE
指明车辆是否正在使用中。“使用中”是指人类用户存在并且意图用于 。这并不一定意味着真人用户在车内。例如,如果 真人用户远程解锁车辆,则车辆会被视为正在使用中。如果此属性 :
- 每当用户启动车辆或系统检测到用户存在时,
VEHICLE_IN_USE
必须设置为 true。每次用户关闭车辆电源时,或 如果系统检测到用户不存在,则必须将VEHICLE_IN_USE
设置为 false。 - 如果用户将车辆关机,或系统检测到用户不存在,
VEHICLE_IN_USE
必须设置为 false。 - 如果用户接通车辆电源,或系统检测到用户存在,
VEHICLE_IN_USE
必须设置为 true。
此属性与 AP_POWER_BOOTUP_REASON
的不同之处在于
AP_POWER_BOOTUP_REASON
在系统启动期间仅设置一次。不过,这个媒体资源
在系统启动周期内可能会更改多次。例如,某台设备目前尚未
使用中。用于执行远程任务的系统启动。VEHICLE_IN_USE
为 false。虽然
远程任务正在执行时,用户进入车辆并启动车辆。
VEHICLE_IN_USE
设置为 true。在驾驶会话结束后,用户将车辆关机,
VEHICLE_IN_USE
设置为 false。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:不适用
单位类型:不适用
版本:Android 14
VEHICLE_MAP_SERVICE
车载地图服务 (VMS) 消息。此属性使用 MIXED 数据来传达 VMS 消息。
其内容的解释如下。VmsMessageIntegerValuesInde 中定义的索引
用于从 int32Values 中读取数据。bytes 是 VMS 中定义的序列化 VMS 消息
协议,这对框架是不透明的。IVehicle#get 必须始终返回
StatusCode::NOT_AVAILABLE
。
更改模式:ON_CHANGEREAD_WRITE
访问模式:READ_WRITE
枚举类型:不适用
单位类型:不适用
版本:Android 13
VEHICLE_SPEED_DISPLAY_UNITS
显示的速度单位。用于指明向用户显示速度的单位类型。 例如,m/s、km/h 或 mph。VehiclePropConfig.configArray 表示支持的速度 。压力单位在 VehicleUnit 中定义。例如:
.configArray: { VehicleUnit::METER_PER_SEC, VehicleUnit::KILOMETERS_PER_HOUR, VehicleUnit::MILES_PER_HOUR }
configArray[0]
METER_PER_SEC
configArray[1]
MILES_PER_HOUR
configArray[2]
KILOMETERS_PER_HOUR
如果更新 VEHICLE_SPEED_DISPLAY_UNITS
会影响
*_DISPLAY_UNITS properties
,则必须更新这些值并传达给
AAOS 框架
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
VHAL_HEARTBEAT
定义由 VHAL 发出信号的事件 汽车监控计时器 作为检测信号如果 VHAL 支持此属性,则 VHAL 应将系统正常运行时间写入此属性。 刷新一次汽车监控计时器会订阅此属性,并检查该属性是否 每三秒更新一次当缓冲时间为 3 秒时,汽车监控计时器会等待 检测信号会在距离上次检测信号最多 6 秒时发出信号。否则,汽车监控计时器会考虑 VHAL 运行状况不佳并终止它。如果 VHAL 不支持此属性,汽车监控计时器也不会 检查 VHAL 运行状况。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
WATCHDOG_ALIVE
定义汽车监控计时器会更新以指明其为活动的事件。汽车监控计时器会设置此项 属性来设定系统正常运行时间(以毫秒为单位)。在启动时,更新可能 用时更长
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
WATCHDOG_TERMINATED_PROCESS
定义由汽车监控计时器终止的进程以及终止的原因。
int32Values[0] 1 // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
轮滑
报告转盘滴答声。矢量中的第一个元素是重置计数。如果重置,则表示 之前的基点计数无法与此次和未来的基点进行比较。出现某种不连续性 计时器事件发生的变化。
接下来的四个元素表示各个车轮的刻度线,顺序如下:
- 前左
- 前右
- 后右
- 左后
所有基点计数均为累计。当车辆向前行驶时,滴答次数会递增,并且 在汽车向后移动时减少。当车辆被盗时, 。
int64Values[0]
重置计数int64Values[1]
前左勾号int64Values[2]
个前右勾号int64Values[3]
(右后方)int64Values[4]
后左旋律
configArray
用于表示每轮刻度的微米值,以及
wheels 是受支持的 configArray 设置如下:
configArray[0], bits [0:3] Supported wheels
使用枚举 Wheel。例如,如果支持所有车轮,则:
configArray[0]
VehicleAreaWheel::LEFT_FRONT |VehicleAreaWheel::RIGHT_FRONT |VehicleAreaWheel::LEFT_REAR |VehicleAreaWheel::RIGHT_REAR- 每个前左轮刻度线
configArray[1]
微米 - 每个前右轮刻度线
configArray[2]
微米 - 每个后右轮刻度线
configArray[3]
微米 - 每个左后轮刻度线
configArray[4]
微米。
如果某个轮盘不受支持,其值应始终设为 0。
必须填写VehiclePropValue.timestamp
。
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
WINDOW_LOCK
窗口儿童锁定。True 表示窗口被子锁定。此属性定义为
VehiclePropertyAccess.READ_WRITE
,但原始设备制造商 (OEM) 可以将其实现为
仅限 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
WINDOW_MOVE
窗口移动。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。maxInt32Value
表示窗户在飞机上开口/在飞机外以最快的速度关闭
速度。minInt32Value
表示窗户在平面上关闭/在
以最快的速度离开飞机方向
绝对值越大(无论是正值还是负值),表示移动速度就越快。部署
窗口达到位置上限时,该值必须重置为 0。如果
WINDOW_MOVE
为 0,表示未执行任何移动。此属性采用
指定的相对移动速度范围。
对于可能从平面打开的窗户(天窗的通风模式),此参数将作如下作用: 。如果:
- 天窗已打开:
<ph type="x-smartling-placeholder">
- </ph>
Max
进一步打开天窗,完全打开后自动停止。Min
关闭天窗,在关闭天窗时自动停止。
- 通风口已打开:
<ph type="x-smartling-placeholder">
- </ph>
Max
关闭出风口,在出风口关闭时自动停止停止。Min
进一步打开出风口,在出风口完全打开时自动停止。
- 天窗已关闭:
<ph type="x-smartling-placeholder">
- </ph>
Max
打开天窗,在天窗完全打开时自动停止。Min
打开出风口,在出风口完全打开时自动停止。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
WINDOW_POS
窗口位置。maxInt32Value
和 minInt32Value
必须定义 VehicleAreaConfig。介于 minInt32Value
到 1 之间的所有整数
必须支持 maxInt32Value
。minInt32Value
指示窗口
在平面之外完全打开或关闭如果窗户不能在平面之外打开,那么
minInt32Value
是窗口完全关闭时的位置,必须为 0。如果
窗口可在平面之外打开,minInt32Value
表示窗口已完全打开
是负值。有关更详细的信息,请参见下面的示例
解释。maxInt32Value
表示窗口已完全打开。
介于 minInt32Value
和 maxInt32Value
之间的值表示过渡
处于关闭/完全打开的平面外与完全打开位置之间的状态。此媒体资源并非
处于任意特定单位内,但要在指定的相对位置范围内。例如,这是
属性应该适用于可移出平面的窗口:对于可能会从平面打开的窗口
平面(天窗的通风模式),该参数可与负值配合使用,如下所示:
Max
天窗完全打开(0 表示天窗关闭)。Min
天窗出风口完全打开(0 表示天窗关上)。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
WINDSHIELD_WIPERS_PERIOD
雨刷周期(毫秒)。返回一整秒的瞬时时间段
雨刷的个数周期(以毫秒为单位)。一个完整的循环定义为雨刷从
然后回到静止位置选择间歇性雨刷设置后,此属性
值必须在间歇擦除暂停期内设为 0。通过
必须定义 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。
每个区域 ID 的 maxInt32Value
都必须指定最长的雨刷周期。通过
每个区域 ID 的 minInt32Value
都必须设置为 0。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:不适用
单位类型:VehicleUnit:MILLI_SECS
版本:Android 14
WINDSHIELD_WIPERS_STATE
挡风玻璃雨刷状态。返回雨刷的当前状态。
“WINDSHIELD_WIPERS_STATE
”的值可能与以下值不匹配:
WINDSHIELD_WIPERS_SWITCH
。例如 WINDSHIELD_WIPERS_STATE: ON
和
WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO
如果 WINDSHIELD_WIPERS_STATE: ON
且 WINDSHIELD_WIPERS_PERIOD
那么 WINDSHIELD_WIPERS_PERIOD
必须反映
雨刷的持续循环。
对于每个受支持的区域 ID,VehicleAreaConfig#supportedEnumValues
数组都必须
除非 WindshieldWipersState
中的所有州均受支持(包括 OTHER,
(不建议这样做)。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:WindshieldWipersState
单位类型:不适用
版本:Android 14
WINDSHIELD_WIPERS_SWITCH
挡风玻璃雨刷已切换。表示控制挡风玻璃的开关的位置
雨刷。“WINDSHIELD_WIPERS_SWITCH
”的值可能与以下值不匹配:
WINDSHIELD_WIPERS_STATE
。例如 WINDSHIELD_WIPERS_SWITCH: AUTO
和
WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON
对于每个支持的区域 ID,
必须定义 VehicleAreaConfig#supportedEnumValues
数组,除非其中的所有状态
支持 WindshieldWipersSwitch
(包括不建议使用 OTHER)。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以
仅将其实现为 VehiclePropertyAccess.READ
。如果此属性以
VehiclePropertyAccess.READ_WRITE
,而“其他”状态会列在
“VehicleAreaConfig#supportedEnumValues
”数组,那么“OTHER”不是支持的值
它只是一个支持读取的值。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:WindshieldWipersSwitch
单位类型:不适用
版本:Android 14