지원되는 시스템 속성

이 페이지에는 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 구현을 지원하기 위해 자동 생성된 API를 제공합니다. C++ 헤더 파일Java 클래스 파일 시스템 속성의 변경 허용 모드 또는 액세스 모드로 설정할 수 있습니다 공급업체 VHAL 구현 이를 사용하여 속성 구성이 사양을 충족하는지 확인할 수 있습니다.

ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

어댑티브 크루즈 컨트롤 (ACC) 또는 예측 기능을 사용할 때 앞차와의 측정 거리 크루즈 컨트롤 (PCC) 가장 뒤에 있는 점 사이의 측정된 거리를 밀리미터 단위로 반환합니다. 선행 차량의 최전방 지점과 ACC 차량의 가장 앞쪽 지점에 해당합니다. maxInt32Value VehicleAreaConfigminInt32Value가 정의되어야 합니다. 이 minInt32Value는 0이어야 합니다. maxInt32Value는 거리 센서가 지원할 수 있는 최대 범위. 이 값은 음수가 아니어야 합니다.

리드 차량이 감지되지 않는 경우 (즉, 선행 차량이 없거나 선행 차량이 없는 경우) 센서가 감지하기에 너무 멀리 있는 경우 이 속성은 StatusCode.NOT_AVAILABLE

참조가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: StatusCode#NOT_AVAILABLE_DISABLED가 false인 경우) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED CRUISE_CONTROL_STATE인 경우 구현되고 상태가 ErrorState 값으로 설정되면 이 속성이 ErrorState 값에 맞는 StatusCode를 반환해야 합니다. 대상 예를 들어 CRUISE_CONTROL_STATE가 다음과 같이 설정된 경우 ErrorState#NOT_AVAILABLE_SPEED_LOW이면 이 속성이 <ph type="x-smartling-placeholder">StatusCode#NOT_AVAILABLE_SPEED_LOW</ph>

변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLIMETER
출시: Android 14

ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

ACC 또는 PCC의 현재 목표 시간 간격(밀리초)입니다. 이 속성은 주요 차량과의 목표 시간 간격을 줄입니다. 이 간격은 거리를 이동하는 데 걸리는 시간으로 정의됩니다. 선행 차량의 가장 뒤쪽 지점과 ACC 차량의 가장 앞쪽 지점 사이를 연결합니다. 실제 선행 차량과의 시간 간격은 이 값보다 크거나 작을 수 있습니다.

목표 시간 간격에 설정할 수 있는 값은 다음의 configArray에 지정되어야 합니다. 오름차순으로 정렬하세요. 모든 값은 양수여야 합니다. 속성을 쓸 수 있는 경우 모든 값은 쓰기 가능한 클래스입니다. 참조가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: CRUISE_CONTROL_ENABLED가 false인 경우) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED

CRUISE_CONTROL_STATE가 구현되고 상태가 ErrorState 값인 경우 이 속성은 StatusCode ErrorState 값과 일치합니다. 예를 들어 CRUISE_CONTROL_STATEErrorState#NOT_AVAILABLE_SPEED_LOW로 설정된 경우 이 속성은 StatusCode#NOT_AVAILABLE_SPEED_LOW를 반환해야 합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현합니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 14

ABS_ACTIVE

자동 브레이크 시스템 (ABS)이 활성 상태입니다. ABS가 활성화된 경우 true로 설정 거짓으로 재설정됩니다. 이 속성은 간헐적으로 설정 (깜빡임)될 수 있음 ABS 시스템의 실시간 상태를 기반으로 작동합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

ANDROID_EPOCH_TIME

에포크 시간(밀리초)으로 인코딩된 현재 날짜 및 시간입니다. 이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다.

이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다. 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
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 13

AP_POWER_BOOTUP_REASON

현재 전원이 켜져 있는 부팅 이유를 보고하는 속성입니다. STATIC 속성입니다. 전원이 꺼질 때까지 전체 시간 동안 변경되지 않습니다. 예를 들어 사용자가 전원 버튼을 눌러도 도어 잠금 해제로 전원이 자동으로 켜지면 부팅 이유는 다음과 같아야 합니다. VehicleApPowerBootupReason#USER_UNLOCK int32Values[0]은(는) 다음과 같아야 합니다. VehicleApPowerBootupReason

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

AP_POWER_STATE_REPORT

앱 프로세서의 전원 상태를 보고하는 속성입니다. AP의 전원 상태는 작동시킬 수 있습니다.

  • int32Values[0] VehicleApPowerStateReport 열거형 값
  • int32Values[1] 필요한 경우 절전 모드 해제 시간(밀리초)(그렇지 않으면 0)

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

AP_POWER_STATE_REQ

앱 프로세서의 전원 상태를 제어하는 속성입니다. AP의 전원 상태는 별도의 전원 컨트롤러로 제어됩니다. 구성 정보의 경우 VehiclePropConfig.configArray에는 값을 결합하는 비트 플래그가 있어야 합니다. VehicleApPowerStateConfigFlag

  • int32Values[0] VehicleApPowerStateReq enum 값
  • int32Values[1] 각 상태와 관련된 추가 매개변수입니다. 사용하지 않을 경우 0입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

AUTOMATIC_EMERGENCY_BRAKING_ENABLED

자동 비상 제동(AEB)을 사용 설정 또는 사용 중지합니다. AEB를 사용 설정하려면 true로, AEB를 사용 중지하려면 false로 설정합니다. AEB가 사용 설정되면 잠재적 충돌을 방지하기 위해 차량의 시동을 켜고 모니터링해야 합니다. 이 속성은 보다 빠른 속도의 애플리케이션에만 적용됩니다. 저속 자동 비상 제동을 사용 설정하려면 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED를 사용해야 합니다.

일반적으로 AUTOMATIC_EMERGENCY_BRAKING_ENABLED는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 느려지는 등 일시적인 상태로 인해 기능을 사용할 수 없는 경우 낮음이면 해당 정보는 ErrorState 값을 통해 전달되어야 합니다. AUTOMATIC_EMERGENCY_BRAKING_STATE 속성

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 이를 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

AUTOMATIC_EMERGENCY_BRAKING_STATE

자동 비상 제동 (AEB) 상태입니다. AEB의 현재 상태를 반환합니다. 이 속성은 항상AutomaticEmergencyBrakingState 또는 ErrorState에 정의된 유효한 상태를 반환합니다. StatusCode를 통해 오류가 표시되면 안 되며 지원되는 오류 상태를 사용해야 합니다. 하세요. 이 속성은 고속 애플리케이션에만 적용되어야 합니다. 상태를 나타내는 데 사용됩니다. 저속 자동 비상 브레이킹 시스템의 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE를 사용해야 합니다.

AEB에 브레이크를 활성화하기 전에 전방 충돌 경고가 포함되어 있는 경우 이러한 경고는 전방 충돌 경고 (FCW) 속성을 통해 표시됩니다.

전역 영역 ID (0)의 경우 StatusCode#VehicleAreaConfig#supportedEnumValuesAutomaticEmergencyBrakingState의 모든 상태가 아니면 배열을 정의해야 합니다. (권장되지 않는 OTHER 포함) 및 ErrorState는 다음과 같습니다. 지원됩니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ForwardCollisionWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14

BLIND_SPOT_WARNING_ENABLED

사각지대 경고(BSW)를 사용 설정 또는 사용 중지합니다. BSW를 사용 설정하려면 true로, BSW를 사용 중지하려면 false로 설정합니다. BSW가 사용 설정되면 차량의 ADAS 시스템이 켜지고 다음 차량에 대한 모니터링이 이루어져야 합니다. 차량의 사각지대에 물체를 방지합니다.

일반적으로 BLIND_SPOT_WARNING_ENABLED는 항상 true 또는 false를 반환해야 합니다. 만약 차량 속도가 너무 느림, ErrorState 값을 통해 전달되어야 한다는 것을 BLIND_SPOT_WARNING_STATE 속성

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의됩니다. OEM은 이를 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

BLIND_SPOT_WARNING_STATE

사각지대 경고(BSW) 상태입니다. BSW의 현재 상태를 반환합니다. 이 속성은 항상 BlindSpotWarningState 또는 ErrorState에 정의된 유효한 상태를 반환합니다. StatusCode를 통해 오류가 표시되면 안 되며 지원되는 오류 상태를 사용해야 합니다. 하세요.

지원되는 각 영역 ID의 경우 StatusCode#VehicleAreaConfig#supportedEnumValuesBlindSpotWarningState의 모든 상태( OTHER(권장되지 않음) 및 ErrorState가 지원됩니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: BlindSpotWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14

CABIN_LIGHTS_STATE

차량 조명의 상태를 반환합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13

CABIN_LIGHTS_SWITCH

운전석 조명 스위치입니다. 운전석 조명을 제어하는 물리적 스위치의 위치입니다. 문이 고장났기 때문에 조명이 켜져 있다면 CABIN_LIGHTS_STATE과(와) 다를 수 있습니다 열 수 있습니다. 예를 들어 스위치가 꺼짐 또는 자동으로 전환합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 이를 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13

CLUSTER_DISPLAY_STATE

계기판 디스플레이 상태를 변경합니다.

  • 경계: 클러스터 활동을 렌더링하는 영역입니다.
  • 삽입: Activity가 중요한 정보를 배치해서는 안 되는 영역입니다.

가능한 값:

  • int32[0] 사용, 사용 중지: 0 - 사용 중지, 1 - 사용, -1 - 상관없음
  • int32[1] 경계 - 왼쪽: 양수 - 왼쪽 위치(픽셀) -1 - 상관없음(모든 경계 필드를 설정해야 함)
  • int32[2] 경계 - 상단: '왼쪽'과 동일한 형식
  • int32[3] 경계 - 오른쪽: '왼쪽'과 동일한 형식
  • int32[4] 경계 - 하단: '왼쪽'과 동일한 형식
  • int32[5] 인셋 - 왼쪽: 양수 - 실제 왼쪽 인셋 값(픽셀) -1 - 상관없음(모든 인셋 필드를 '상관없음'으로 설정해야 함)
  • int32[6] 인셋 - 상단: '왼쪽'과 동일한 형식
  • int32[7] 인셋 - 오른쪽: 'left'와 동일한 형식
  • int32[8] 인셋 - 하단: '왼쪽'과 동일한 형식

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

CLUSTER_NAVIGATION_STATE

현재 내비게이션 상태를 알립니다. 바이트: NavigationStateProto의 직렬화된 메시지입니다.

모드 변경: ON_CHANGE
액세스 모드: WRITE
enum 유형:
단위 유형: 해당 사항 없음
출시: 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] 현재 두 개의 UI가 표시되는 경우 하위 화면의 ClusterUI 유형입니다. -1은 영역이 더 이상 사용되지 않음을 나타냅니다. 바이트: 바이트의 가용성을 나타내는 배열입니다. 합니다. 0은 사용 불가를 나타내고 1은 사용 가능을 나타냅니다. 예를 들어 자동차가 는 세 가지 OEM 정의 ClusterUI(예: HOME, MAPS, CALL)를 지원하고 이동통신망을 사용할 수 있는 경우에만 UI를 호출합니다. 그런 다음 Nework를 사용할 수 있는 경우 [1 1 1] 을 전송하고 네트워크 외부에 있을 경우 [1 1 0]을 전송합니다.

변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13

CLUSTER_REQUEST_DISPLAY

일부 ClusterUI를 표시하도록 계기판 디스플레이 상태의 변경을 요청합니다. 현재 디스플레이 시간 상태가 꺼져 있고 ClusterHome은 이 메시지를 ClusterOS에 전송하여 사용 설정을 요청합니다. 특정 ClusterUI를 표시할 수 있습니다. ClusterOS는 다음과 같이 응답해야 합니다. CLUSTER_DISPLAY_STATE

  • int32 표시할 ClusterUI 유형

모드 변경: ON_CHANGE
액세스 모드: WRITE
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

CLUSTER_SWITCH_UI

계기판 디스플레이에서 ClusterUI를 시작합니다.

  • int32 0으로 표시되는 ClusterUI 유형은 ClusterHome을 나타냅니다. 화면에 표시되며 기본 UI와 계기판 디스플레이용 런처 기능입니다. 다른 값은 OEM의 정의에 따른 것입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

CREATE_USER

Android 사용자가 생성된 후 Android 시스템에서 호출됩니다. HAL은 이 속성을 사용할 수 있음 동일한 사용자를 만듭니다. 이는 비동기 요청입니다. Android는 VehiclePropValue, HAL은 요청이 추가되었는지 여부를 나타내는 속성 변경으로 응답해야 함 확인할 수 있습니다 실패하면 Android 시스템에서 사용자를 삭제합니다.

요청의 형식은 CreateUserRequest로 정의되고 응답 형식은 CreateUserResponse. 예를 들어 시스템에 두 명의 사용자 (0과 10)와 세 번째 사용자( 임시 게스트)가 생성되면 요청은 다음과 같습니다.

  • int32[0] 42 // 요청 ID
  • int32[1] 11 // 생성된 사용자의 Android ID입니다.
  • int32[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 // 요청 ID
  • int32[1] 1 // CreateUserStatus::SUCCESS

하지만 실패할 경우 다음과 같은 결과가 발생합니다.

  • int32[0] 42 // 요청 ID
  • int32[1] 2 // CreateUserStatus::FAILURE string: "D'OH!" //

의미는 블랙박스이며 호출자 (예: 설정 UI)에게 전달되며 적절한 조치를 취할 수 있습니다

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

CRITICALLY_LOW_TIRE_PRESSURE

이 속성은 각 타이어의 최저 압력 임계값을 나타냅니다. 이는 타이어를 교체하거나 수리합니다. 값은 minFloatValue 이하여야 합니다. TIRE_PRESSURE에 있습니다. 최소 및 최대 속성 값 (minFloatValue 및 maxFloatValue)은 적용되지 않습니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:KILOPASCAL
출시: Android 13

CRUISE_CONTROL_COMMAND

WRITE 크루즈 컨트롤 (CC) 명령어 지원되는 각 명령어에 관한 자세한 내용은 CruiseControlCommand를 참고하세요. 전역 영역 ID (0)의 경우 StatusCode#VehicleAreaConfig#supportedEnumValues 배열을 정의해야 합니다. CruiseControlState의 상태가 지원됩니다. 다음을 통해 전송된 지원되지 않는 명령어는 이 속성을 사용할 수 없는 경우 이 속성은 StatusCode#INVALID_ARG를 반환해야 합니다. CC가 사용 중지되었기 때문에 (예: CRUISE_CONTROL_ENABLED가 false인 경우) 이 속성은 CRUISE_CONTROL_STATE인 경우 StatusCode#NOT_AVAILABLE_DISABLED을 반환해야 합니다. 구현되고 상태가 ErrorState 값으로 설정되면 속성은 ErrorState 값에 맞는 StatusCode를 반환해야 합니다. 예를 들어 CRUISE_CONTROL_STATE이 다음과 같이 설정된 경우 ErrorState#NOT_AVAILABLE_SPEED_LOW이면 이 속성이 <ph type="x-smartling-placeholder">StatusCode#NOT_AVAILABLE_SPEED_LOW</ph>

모드 변경: ON_CHANGE
액세스 모드: WRITE
enum 유형: CruiseControlCommand
단위 유형: 해당 사항 없음
출시: Android 14

CRUISE_CONTROL_ENABLED

크루즈 컨트롤(CC)을 사용 설정하거나 사용 중지합니다. CC를 사용 설정하려면 true로 설정하고 CC를 사용 중지하려면 false로 설정합니다. 이 속성은 모든 형식의 CruiseControlType에서 공유됩니다. CC가 사용 설정되면 ADAS 시스템은 차량의 시동을 켜고 명령에 응답해야 합니다. 일반적으로 CRUISE_CONTROL_ENABLED 항상 true 또는 false를 반환해야 합니다. 일시적인 상태로 인해 기능을 사용할 수 없는 경우 예를 들어 차량 속도가 너무 낮은 경우 해당 정보는 ErrorState 값을 CRUISE_CONTROL_STATE 속성에 저장합니다. 이 속성은 다음과 같이 정의됩니다. VehiclePropertyAccess.READ_WRITE이지만 OEM은 이를 구현할 수 있습니다. VehiclePropertyAccess.READ만 해당됩니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

CRUISE_CONTROL_STATE

크루즈 컨트롤(CC)의 현재 상태입니다. 이 속성은 CC의 현재 상태를 반환합니다. 일반적으로 이 속성은 CruiseControlState에 정의된 유효한 상태를 반환해야 합니다. ErrorState 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 ErrorState를 통해 전달되어야 합니다. 전역 영역 ID (0)의 경우 VehicleAreaConfig#supportedEnumValue 배열을 정의해야 합니다. CruiseControlState (OTHER는 권장되지 않음) 및 ErrorState 는 지원됩니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: CruiseControlState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14

CRUISE_CONTROL_TARGET_SPEED

크루즈 컨트롤(CC)의 현재 목표 속도입니다. OEM은 minFloatValue 및 이 속성의 maxFloatValue 값을 사용하여 최소 및 최대 목표 속도 값을 정의합니다. 이러한 값은 음수가 아니어야 합니다. maxFloatValue는 목표 속도의 상한값을 나타냅니다. minFloatValue는 목표 속도의 하한을 나타냅니다. 참조가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: CRUISE_CONTROL_ENABLED false인 경우) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED을 반환해야 합니다. CRUISE_CONTROL_STATE: 상태가 ErrorState 값으로 설정되면 이 속성은 ErrorState 값에 맞는 StatusCode입니다. 예를 들어 CRUISE_CONTROL_STATE 설정됨 ErrorState#NOT_AVAILABLE_SPEED_LOW로 지정하면 이 속성은 <ph type="x-smartling-placeholder">StatusCode#NOT_AVAILABLE_SPEED_LOW</ph>

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:METER_PER_SEC
출시: Android 14

CRUISE_CONTROL_TYPE

현재 크루즈 컨트롤(CC) 유형입니다. CRUISE_CONTROL_ENABLED가 true인 경우 이 속성은 현재 사용 설정된 CC 유형 (예: 표준 CC 및 적응형 CC, 예측) 기본적으로 이 속성은 CruiseControlType에 정의된 유효한 상태를 반환해야 합니다. 또는 ErrorState 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 저것 정보는 ErrorState를 통해 전달되어야 함 전역 영역 ID (0)의 경우 StatusCode#VehicleAreaConfig#supportedEnumValues 배열을 정의해야 합니다. CruiseControlType의 모든 상태 (OTHER는 권장) 및 ErrorState만 지원됩니다. WRITE 시도 중 CruiseControlType#OTHER 또는 ErrorState 속성에서 IllegalArgumentException 발생 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현합니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 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,...}이어야 합니다. 이 목록은 에 보고된 지원되는 톱니바퀴의 목록과 동일할 필요는 없습니다. <ph type="x-smartling-placeholder">GEAR_SELECTION</ph>

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleGear
단위 유형: 해당 사항 없음
출시: Android 13

CURRENT_POWER_POLICY

VHAL 레이어에 현재 전원 정책을 알립니다. 자동차 전원 정책 서비스가 이 속성을 설정합니다. 현재 전원 정책이 변경될 때

string: "sample_policy_id" // power policy ID

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

DISABLED_OPTIONAL_FEATURES

VHAL의 선택적 기능 사용 중지를 허용합니다. 이 속성은 사용 중지해야 합니다. 시스템에 허용되는 모든 선택적 기능이 자동차 서비스에 선언됩니다. 오버레이, config_allowed_optional_car_features 이 속성을 사용하면 오버레이에 정의된 기능을 사용 중지할 수 있습니다. 이 속성이 없으면 모든 오버레이에 선언된 기능이 사용 설정됩니다. READ 값에는 쉼표 (,)로 사용 중지된 모든 기능을 포함해야 합니다. 분리할 수 있습니다. 예: com.android.car.user.CarUserNoticeService,storage_monitoring

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

DISPLAY_BRIGHTNESS

디스플레이의 밝기를 나타내는 속성입니다. 일부 자동차에는 밝기를 조절합니다. 이 속성은 해당 컨트롤의 변경사항을 공유하기 위한 것입니다. 자동차에서 밝기가 별도로 제어되는 디스플레이의 경우 PER_DISPLAY_BRIGHTNESS DISPLAY_BRIGHTNESSPER_DISPLAY_BRIGHTNESS 중 하나만 있습니다. 둘 다 PER_DISPLAY_BRIGHTNESS는 AAOS에서 사용합니다. 쓰기 가능한 경우 Android는 이거 설정 값을 설정할 수 있습니다. READ 전용인 경우 사용자는 여전히 디스플레이 밝기는 설정에서 변경할 수 있지만 다른 디스플레이에는 반영되지 않아야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

DISTANCE_DISPLAY_UNITS

디스플레이의 길이 단위입니다. 차량이 있습니다. 예: 마일, 미터, 킬로미터 거리 단위는 VehicleUnit에 정의되어 있습니다. VehiclePropConfig.configArray는 지원되는 거리 표시 단위를 나타내는 데 사용됩니다. 예: configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE DISTANCE_DISPLAY_UNITS 업데이트가 다른 <ph type="x-smartling-placeholder">*_DISPLAY_UNITS</ph> 속성이 있는 경우, 그 값도 업데이트되어 AAOS 프레임워크에 전달되어야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현합니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13

DOOR_CHILD_LOCK_ENABLED

아동 보호 잠금 기능이 사용 설정되었습니다. 자녀 보호 잠금 기능이 활성화되어 있고 사용 중지되면 false입니다. 사용 설정하면 문이 내부에서 열 수 없습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 구현 가능하지만 OEM은 이를 다음과 같이 구현할 수 있습니다. VehiclePropertyAccess.READ만 해당됩니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

DOOR_LOCK

도어락 잠금 true는 문이 잠겼음을 나타냅니다. 이 속성은 다음과 같이 정의됩니다. VehiclePropertyAccess.READ_WRITE이지만 OEM은 이를 구현할 수 있습니다. VehiclePropertyAccess.READ만 해당됩니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

DOOR_MOVE

각 VehicleAreaConfig의 maxInt32ValueminInt32Value는 정의할 수 있습니다 minInt32Value에서 maxInt32Value 사이의 모든 정수는 지원됩니다. maxInt32Value는 문에서 최대 이동 속도를 나타내며 있습니다. minInt32Value는 문에서 최대 이동 속도를 나타내며 종료.

양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 일단 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. 값이 DOOR_MOVE가 0입니다. 이는 현재 발생하고 있는 움직임이 없음을 의미합니다.

이 속성은 특정 단위가 아니라 상대적 이동 속도의 지정된 범위 내에 있습니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현합니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

DOOR_POS

도어 위치입니다. maxInt32ValueminInt32Value VehicleAreaConfig을(를) 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다. minInt32Value는 문이 닫혔음을 나타냅니다. minInt32Value 0이어야 합니다. maxInt32Value는 문이 완전히 열려 있음을 나타냅니다. 사이의 값 minInt32ValuemaxInt32Value는 닫힘과 완전 종료 사이의 전환 상태를 나타냅니다. 있습니다.

이 속성은 특정 단위가 아닌 지정된 상대 위치 범위에 있습니다. 일부 차량 (미니밴)은 전자식으로 문을 열 수 있습니다. 따라서 이 속성을 WRITE하세요. 이 속성은 VehiclePropertyAccess로 정의됩니다. READ_WRITE이지만 OEM은 VehiclePropertyAccess.READ로 구현할 수 있습니다. 전용입니다.

모드 변경: ON_CHANGE
액세스 모드: READ_WRITE/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: 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 true when any of the charge ports are connected.

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 and REAR_FOG_LIGHTS_STATE must not be implemented.
  • Front and rear fog lights can only be controlled independently. FOG_LIGHTS_STATE must not be implemented and FRONT_FOG_LIGHTS_STATE and REAR_FOG_LIGHTS_STATE must be implemented.
  • Car has only front fog lights. Only one of FOG_LIGHTS_STATE or FRONT_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 or REAR_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 and REAR_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 and REAR_FOG_LIGHTS_SWITCH must be implemented.
  • Car has only front fog lights. Only one of FOG_LIGHTS_SWITCH or FRONT_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 or REAR_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, GEAR_DRIVE, GEAR_1, GEAR_2,...} and for manual transmission the list must be {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

HOD (Hands On Detection) 운전자 상태입니다. 운전자의 손이 스티어링 휠에 있는지 여부를 반환합니다. 일반적으로 이 속성은 HandsOnDetectionDriverState 또는 ErrorState에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일부 일시적인 상태로 인해 기능을 사용할 수 없는 경우 ErrorState를 통해 이 정보를 전달해야 합니다. 운전자의 손이 핸들에서 너무 오랫동안 떨어져서 사용자에게 경고를 보내려면 차량이 사용자에게 경고를 보내려면 차량에서 HANDS_ON_DETECTION_WARNING를 통해 경고를 표시해야 합니다. 전역 영역 ID (0)의 경우 모두 지원되지 않는 경우 (기타)의 경우 모두 권장되지 않으며 OTHER는 모두 권장되지 않습니다.HandsOnDetectionDriverStateErrorStateVehicleAreaConfig#supportedEnumValues

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: HandsOnDetectionDriverState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14

직접_감지_사용 설정됨

직접식 감지(HOD)를 사용 설정하거나 사용 중지합니다. HOD를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. HOD가 사용 설정된 경우 차량 내 시스템은 운전자의 손이 핸들에 있는지 모니터링하고 운전자의 손이 더 이상 핸들에 있지 않다고 감지하면 경고를 전송해야 합니다. 일반적으로 HANDS_ON_DETECTION_ENABLED는 항상 true 또는 false를 반환해야 합니다.

임시 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 HANDS_ON_DETECTION_STATE 속성의 ErrorState 값을 통해 전달되어야 합니다. 이 속성은 minInt32Value VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

HANDS_ON_DETECTION_WARNING

직접식 감지(HOD) 경고 운전자가 운전대에서 너무 오랜 시간 손을 떼면 경고가 전송되는지 여부를 반환합니다. 일반적으로 이 속성은 HandsOnDetectionWarning 또는 ErrorState에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일부 임시 상태로 인해 기능을 사용할 수 없는 경우 해당 정보는 ErrorState를 통해 전달되어야 합니다. 전역 영역 ID (0)의 경우 HandsOnDetectionWarning (권장하지 않는 OTHER 포함) 및 ErrorState의 모든 상태가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues 배열을 정의해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: HandsOnDetectionWarning/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14

위험 상태

위험 표시등 상태입니다. 비상등의 현재 상태를 반환합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13

HAZARD_LIGHTS_SWITCH

비상 경고등 스위치입니다. 사용자가 원하는 설정입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13

헤드라이트 상태

헤드라이트 상태. 헤드라이트의 현재 상태를 반환합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13

HEADLIGHTS_SWITCH

헤드라이트 스위치. 사용자가 원하는 설정입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13

HIGH_BEAM_LIGHTS_STATE

높은 빛줄기 표시등 상태입니다. 높은 빛줄기의 현재 상태를 반환합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13

높은_빛_스위치

하이 빔 조명 스위치. 사용자가 원하는 설정입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_AC_ON

지정된 areaId의 에어컨을 켜거나 끕니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

실제 팬 속도입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_AUTO_ON

자동 실내 온도 조절기를 켜거나 끕니다. true인 경우 자동 실내 온도 조절기가 켜집니다. false인 경우 자동 온도 조절이 꺼져 있습니다. 차량에서 자동 온도 조절을 직접 사용 중지할 수 없는 경우 OEM은 VHAL 구현에 HVAC_AUTO_ON를 false로 설정하는 로직을 추가해야 합니다. 그러면 필요한 HVAC 설정이 변경되어 HVAC_AUTO_ON가 간접적으로 사용 중지됩니다. 이때 사용자에게 방해가 되지 않는 것이 이상적입니다. OEM은 자동 실내 온도 조절기를 사용 중지할 때 수정한 모든 설정을 이전 상태로 되돌려야 합니다. 이렇게 하면 HVAC_AUTO_ON가 꺼진 것뿐입니다. HVAC 설정을 이전 설정으로 복원할 수 없는 경우 OEM은 가장 방해가 되는 변경사항을 구현해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_AUTO_RECIRC_ON

자동 재순환을 켜거나 끕니다. 자동 재순환이 켜져 있는 경우 차량에서 공기질이 좋지 않음을 감지하면 HVAC 시스템이 자동으로 재순환 모드로 전환될 수 있습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_DEFROSTER

지정된 기간 동안 팬 기반 성에 제거 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC DUAL_ON

영역 간 온도 결합을 사용 설정합니다. HVAC_DUAL_ON 속성의 AreaIDs에는 함께 결합할 수 있는 HVAC_TEMPERATURE_SET AreaIDs 조합이 포함되어야 합니다. HVAC_TEMPERATURE_SETAreaIDs[a_1, a_2, ..., a_n]에 매핑되고 HVAC_DUAL_ON를 사용 설정하여 a_i와 a_j를 결합할 수 있는 경우 HVAC_DUAL_ON 속성을 [a_i | a_j]에 매핑해야 합니다. 또한, a_k와 a_l을 별도로 결합할 수 있는 경우 HVAC_DUAL_ON를 [a_i | a_j, a_k | a_l]에 매핑해야 합니다. 예를 들어 자동차에 앞좌석 2개 (ROW_1_LEFTROW_1_RIGHT)와 뒷좌석 3개 (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT)가 있습니다. 운전석 측과 조수석 측 온도 조절 장치 두 개가 있으며 선택적으로 동기화할 수 있습니다. 이는 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]

숙박 시설이 사용 설정되면 ECU는 영향을 받는 구역의 온도를 동기화해야 합니다. DUAL_ON 매개변수를 켜거나 끄는 부작용으로 수정된 매개변수는 VHAL에 관한 onPropertyEvent() 콜백을 생성해야 합니다. 또한 온도(예: 운전자 온도)를 설정할 때 다른 온도 (예: 앞좌석 온도)가 변경되면 적절한 onPropertyEvent() 콜백을 생성해야 합니다.

사용자가 결합을 깨는 온도를 변경하면 (예: 승객 온도를 독립적으로 설정) VHAL은 적절한 onPropertyEvent() 콜백(HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx 포함)을 전송해야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 이를 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_ELECTRIC_DEFROSTER_ON

전기 해동기의 상태입니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_FAN_DIRECTION

팬 방향 설정 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleHvacFanDirection
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_FAN_DIRECTION_AVAILABLE

팬 위치를 사용할 수 있습니다. 영역에서 사용할 수 있는 팬 위치의 비트 마스크입니다. 사용 가능한 각 팬 방향은 벡터에 별도의 항목으로 표시됩니다. 팬 방향에는 vehicle_hvac_fan_direction 세트의 비트가 여러 개 있을 수 있습니다. 예를 들어 일반적인 자동차의 팬 위치는 다음과 같습니다.

- 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)

변경 모드: 정적
액세스 모드: READ
Enum 유형: VehicleHvacFanDirection
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_FAN_SPEED

팬 속도 설정 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

  • 가장 낮은 팬 속도 minInt32Value
  • maxInt32Value 가장 높은 팬 속도

이 속성은 특정 단위가 아닌 지정된 상대 속도 범위로 표시됩니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현하도록 선택할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC MAX AC 켜짐

MAX AC가 켜지거나 꺼집니다. MAX AC가 켜져 있으면 ECU가 필요에 따라 환기구 위치, 팬 속도, 온도와 같은 항목을 조정하여 차량을 가능한 한 빨리 냉방할 수 있습니다. MAX AC 매개변수를 사용 설정하거나 사용 중지하는 부작용으로 수정된 매개변수는 VHAL에 대한 onPropertyEvent() 콜백을 생성합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 이를 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_MAX_DEFROST_ON

MAX DEFROST를 켜거나 끕니다. MAX DEFROST가 켜져 있으면 ECU는 창문을 최대한 빨리 제상할 수 있도록 필요에 따라 통풍구 위치, 팬 속도, 온도와 같은 항목을 조정할 수 있습니다. MAX DEFROST 매개변수를 사용 설정하거나 사용 중지하는 부작용으로 수정된 매개변수는 VHAL에 대한 onPropertyEvent() 콜백을 생성합니다. HVAC_MAX_DEFROST_ONAreaIDs는 영역에서 최대 DEFROST를 제어할 수 있음을 나타냅니다. 예를 들어 areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}HVAC_MAX_DEFROST_ON가 앞쪽 좌석에서만 제어할 수 있음을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC 전원 켜기

HVAC의 전역 전원 상태를 나타냅니다. 이 속성을 false로 설정하면 개별 HVAC 기능 및 하위 시스템을 제어하는 일부 속성을 UNAVAILABLE 상태로 표시할 수 있습니다(MAY). 이 속성을 true로 설정하면 개별 HVAC 기능과 하위 시스템을 제어하는 일부 속성이 AVAILABLE 상태로 표시될 수 있습니다(일부 또는 모든 속성이 자체적으로 UNAVAILABLE 상태인 경우 제외).

HvacPower_DependentProperties는 HVAC를 켜야 기능을 사용할 수 있는 속성입니다. 예를 들어 일부 자동차에서는 에어컨을 켜려면 먼저 HVAC의 전원을 켜야 합니다. HvacPower_DependentProperties 목록은 VehiclePropConfig.configArray에 설정되어야 하며 HvacPower_DependentProperties에는 VehicleArea:SEAT와 연결된 속성만 포함되어야 합니다.

HVAC_POWER_ON 속성의 AreaID 매핑에는 HvacPower_DependentProperties가 매핑된 모든 AreaIDs가 포함되어야 합니다. 예를 들어 자동차에 다음 두 개가 있다고 가정해 보겠습니다.

  1. 앞좌석 (ROW_1_LEFT, ROW_1_RIGHT) 및 뒷좌석 3개(ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) 차량 전체의 HVAC 기능(에어컨, 온도 등)이 단일 HVAC 전원 컨트롤러에 종속되는 경우 HVAC_POWER_ON는 [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
  2. 앞줄에 있는 좌석 (ROW_1_LEFT, ROW_1_RIGHT), 두 번째 열 (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT)과 세 번째 열(ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT)에 있는 3개의 좌석입니다. 자동차 앞줄에 온도 컨트롤러가 있고 이 온도 컨트롤러는 차량 뒷면의 온도 컨트롤러와 완전히 독립적으로 작동할 경우 HVAC_POWER_ON는 2개 요소 배열에 매핑되어야 합니다.
    - ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
    

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 이를 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC RECIRC 켜짐

재순환을 켜거나 끕니다. 차량 내부로의 외부 공기 공급을 제어합니다. 순환 켜짐은 차량 내부로 흐르는 대부분의 기류가 선실에서 시작됨을 의미합니다. 재순환 꺼짐은 차량 내부로 흐르는 대부분의 공기가 차량 외부에서 나옴을 의미합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC SEAT TEMPERATURE

좌석 난방 및 냉방입니다. VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다. maxInt32Value는 최대 좌석 온도 난방 설정을 나타냅니다. 차량이 좌석 냉방을 지원하지 않는 한 minInt32Value는 0이어야 합니다. 이 경우 minInt32Value는 최대 시트 온도 냉방 설정을 나타냅니다. 이 속성은 특정 단위가 아닌 지정된 상대 온도 설정 범위입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_SEAT_VENTILATION

좌석 환기 장치. VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다. minInt32Value는 0이어야 합니다. maxInt32Value는 좌석에서 사용할 수 있는 최대 환기 설정을 나타냅니다.

이 속성은 특정 단위는 아니지만 지정된 환기 설정 범위 내에 있습니다.

HVAC 앱 및 어시스턴트에서 좌석 환기 상태를 사용 설정, 변경 또는 읽는 데 사용됩니다. 좌석 냉방과는 다릅니다. 냉방과 동시에 켜져 있을 수도 있고 아닐 수도 있습니다.

이 속성은 >VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_측면_MIRROR_HEAT

사이드미러 난방 값이 증가할수록 사이드 미러의 난방 수준이 높아집니다. VehicleAreaConfig에서 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다. 구성 데이터에서:

  • maxInt32Value는 최대 난방 수준을 나타냅니다.
  • minInt32Value는 0이어야 하며 난방이 없음을 나타냅니다.

이 속성은 특정 단위가 아닌 지정된 범위의 상대 난방 설정으로 표시됩니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 이를 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_STEERING_WHEEL_HEAT

스티어링 휠의 난방 및 냉방 수준을 설정합니다. VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다. maxInt32Value는 최대 핸들 난방 설정을 나타냅니다. 차량에서 핸들 냉각을 지원하지 않는 한 minInt32Value는 0이어야 합니다. 이 경우 minInt32Value는 최대 핸들 냉방 설정을 나타냅니다. 이 속성은 특정 단위가 아닌 지정된 난방 설정 범위에 있습니다. 이 속성은 VehiclePropertyAccess.READ로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_TEMPERATURE_CURRENT

HVAC 현재 온도

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13

HVAC_TEMPERATURE_DISPLAY_UNITS

디스플레이용 온도 단위입니다. 온도가 섭씨로 표시되는지 또는 화씨로 표시되는지를 나타냅니다. VehiclePropConfig.configArray는 지원되는 온도 표시 단위를 나타냅니다. 예를 들면 configArray[0] = CELSIUS configArray[1] = FAHRENHEIT입니다. 이 매개변수는 시스템의 모든 HVAC 온도를 표시하는 데 사용할 수 있습니다(MAY). 값은 VehicleUnit.CELSIUS 또는 VehicleUnit.FAHRENHEIT 중 하나여야 합니다.

HVAC_TEMPERATURE_DISPLAY_UNITS 업데이트가 다른 *_DISPLAY_UNITS 속성의 값에 영향을 미치는 경우 그 값을 업데이트하여 AAOS 프레임워크에 전달해야 합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13

HVAC_TEMPERATURE_SET

HVAC 희망 온도가 섭씨로 설정되었습니다.

VehicleAreaConfigminFloatValuemaxFloatValue를 다음과 같이 정의해야 합니다.

  • minFloatValue의 최저 온도가 섭씨로 설정되었습니다.
  • maxFloatValue의 최고 온도가 섭씨로 설정되었습니다.

minFloatValuemaxFloatValue 사이의 모든 값이 지원되지 않는 경우 configArray를 사용하여 설정할 수 있는 유효한 온도 값을 나열합니다. 이는 차량의 온도를 섭씨에서 화씨로 (또는 그 반대로) 변환하는 참고표도 설명합니다. 차량에서 표준 단위 변환이 지원되지 않는 경우 configArray를 정의해야 합니다.

configArray는 다음과 같이 설정됩니다.

  • configArray[0][섭씨 지원 온도의 하한값] * 10
  • configArray[1][섭씨 지원 온도의 상한값] * 10
  • configArray[2] [섭씨 단위의 증분] * 10
  • configArray[3] [지원되는 온도 하한값(화씨)] * 10
  • configArray[4] [지원되는 온도의 상한값(화씨)] * 10
  • configArray[5] [화씨 증가] * 10

VehicleAreaConfigminFloatValuemaxFloatValue는 각각 configArray[0]configArray[1]와 같아야 합니다. 예를 들어 차량에서 온도 값을 화씨 [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]로 지원한다면 configArrayconfigArray = {160, 280, 5, 605, 845, 10}이어야 합니다.

화씨 증가에 대한 섭씨 증가 비율은 실제 섭씨 1도 대 1.8도의 비율에 가깝게 하는 것이 이상적입니다. 모든 섭씨 값은 configArray에서 정의한 화씨 값에 일대일로 매핑되어야 합니다. configArray는 클라이언트에서 이 속성의 온도를 섭씨에서 화씨로 변환하는 데 사용합니다. 또한 시스템에서 원하는 화씨 값을 달성하기 위해 속성을 설정해야 하는 섭씨 값을 클라이언트가 알 수 있습니다. ECU에 모든 섭씨 값과 화씨 값에 대한 일대일 매핑이 없는 경우 configArray는 일대일 매핑이 있는 섭씨 및 화씨 값의 목록만 정의해야 합니다.

예를 들어 ECU에서 16~28의 섭씨 값과 60~85의 화씨 값을 각각 1씩 증분하는 경우 가능한 configArray 중 하나는 code>{160, 280, 10, 600, 840, 20}입니다. 이 경우 85는 지원되는 온도가 아닙니다.

유효한 값 사이에 설정된 모든 값은 가장 가까운 유효한 값으로 반올림되어야 합니다. OEM도 HVAC_TEMPERATURE_VALUE_SUGGESTION 차량 속성을 구현하는 것이 좋습니다. 차량에 설정할 수 있는 온도 값을 결정하고 섭씨와 화씨 사이의 값을 변환하는 간단한 메서드를 애플리케이션에 제공하기 때문입니다.

이 속성은 VehiclePropertyAccess.READ로 정의되지만 OEM은 VehiclePropertyAccess.READ로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13

HVAC_TEMPERATURE_VALUE_SUGGESTION

HVAC 온도 설정에 권장되는 값입니다.

애플리케이션이 섭씨 또는 화씨로 지원되는 가장 가까운 온도 값을 이해할 수 있도록 속성을 구현합니다.

  • floatValues[0] 앱에서 온도를 설정하려는 요청된 값입니다.
  • floatValues[1] floatValues[0]의 단위이며 {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT} 중 하나여야 합니다.
  • floatValues[2] CELSIUS로 제안된 OEM 값 (이 값은 요청에 포함되지 않음)
  • floatValues[3] OEM이 제안한 FAHRENHEIT 값입니다(이 값은 요청에 포함되지 않음).

애플리케이션은 요청된 값과 값의 단위를 사용하여 set(VehiclePropValue propValue)를 호출합니다. OEM은 onPropertyEvent() 콜백으로 floatValues[2]floatValues[3]에 추천 값을 반환해야 합니다. 추천 값은 HVAC_TEMPERATURE_SET configArray에서 파생될 수 있는 값을 준수해야 합니다. 즉, 추천 값과 configArray의 값 표는 동일해야 합니다.

OEM은 HVAC ECU에 요청하지 않도록 VHAL 구현에 맞춤 로직을 추가하는 것이 좋습니다. 로직은 다음과 같을 수 있습니다. 온도를 섭씨에서 화씨로 변환하려면 다음 단계를 따르세요.

// 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;

예를 들어 운전자가 음성 어시스턴트를 사용하여 HVAC 온도를 화씨 66.2로 설정하는 경우입니다. 먼저 애플리케이션이 이 속성을 [66.2, (float)VehicleUnit.FAHRENHEIT,0,0] 값으로 설정합니다. OEM이 사용자의 요청에 따라 섭씨 19.0 또는 화씨 66.5를 설정하도록 제안하는 경우 VHAL은 속성 값 [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]로 콜백을 생성해야 합니다. 음성 어시스턴트가 콜백을 수신하면 사용자에게 알리고 HVAC 온도를 제안된 값으로 설정합니다.

또 다른 예로, 앱이 HVC_TEMPERATURE_SET를 쿼리하여 현재 온도 값으로 21℃를 수신하지만 앱은 자동차 UI에 화씨로 표시되는 값을 알아야 합니다. 이를 위해 앱은 속성을 [21, (float)VehicleUnit.CELSIUS, 0, 0]로 설정합니다. 섭씨 21도의 OEM 추천 값이 화씨 70도인 경우 VHAL은 속성 값 [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]로 콜백을 생성해야 합니다. 이 경우 앱은 차량 UI에서 값이 화씨 70.0도임을 알 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HW_CUSTOM_INPUT

맞춤 OEM 파트너 입력 이벤트를 정의합니다. 이 입력 이벤트는 Android에서 지원하지 않는 이벤트를 전파하려는 OEM 파트너가 사용해야 합니다. int32 값의 배열로만 구성됩니다. Android 속성은 다음과 같습니다.

  • int32Values[0] 이 이벤트를 나타내는 함수를 식별하는 입력 코드입니다. 유효한 이벤트 유형은 CustomInputType.CUSTOM_EVENT_F1~CustomInputType.CUSTOM_EVENT_F10로 정의됩니다. OEM 파트너가 정의할 맞춤 이벤트를 나타냅니다.
  • int32Values[1] VehicleDisplay에 정의된 타겟 디스플레이 유형 특정 디스플레이에 연결되지 않은 이벤트는 VehicleDisplay#MAIN로 전송해야 합니다.
  • int32Values[2] 반복 카운터, 0이면 이벤트가 반복되지 않습니다. 값이 1 이상이면 이 이벤트가 반복된 횟수를 나타냅니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: CustomInputType
단위 유형: 해당 사항 없음
출시: Android 13

HW_KEY_INPUT

하드웨어 입력 이벤트를 Android에 피드하는 속성입니다.

  • int32Values[0] VehicleHwKeyInputAction으로 정의된 작업
  • int32Values[1] 키 코드, 표준 Android 키 코드를 사용해야 함
  • int32Values[2] VehicleDisplay에 정의된 타겟 디스플레이입니다. 특정 디스플레이에 연결되지 않은 이벤트는 VehicleDisplay#MAIN로 전송해야 합니다.
  • int32Values[3](선택사항) 틱 수입니다. 값은 1 이상이어야 합니다. 생략할 경우 Android 기본값은 1입니다.

모드 변경: .ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

HW_KEY_INPUT_V2

Android에 하드웨어 입력 이벤트를 제공하는 속성입니다.

  • int32array[0] VehicleDisplay로 정의된 타겟 디스플레이. 예:
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
  • int32array[1] 키 코드: KEYCODE_HOMEKEYCODE_BACK와 같은 표준 Android 키 코드를 사용해야 합니다.
  • VehicleHwKeyInputAction에 정의된 int32array[2] 작업(예:
    VehicleHwKeyInputAction::ACTION_UP, VehicleHwKeyInputAction::ACTION_UP)
  • int32array[3] 이벤트 횟수를 반복합니다. 키 다운 이벤트의 경우 반복 횟수이며 처음 누를 때 0부터 시작하여 카운트됩니다. 키 업 이벤트의 경우 항상 0과 같습니다.
  • int64array[0] 마지막 부팅 이후 경과된 다운타임(나노초)입니다. 가장 최근 키 다운 이벤트의 시간을 나타냅니다. 다운 이벤트의 경우 다운 이벤트의 이벤트 시간입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

HW_MOTION_INPUT

Android에 하드웨어 입력 이벤트를 제공하는 속성입니다.

  • int32array[0] VehicleDisplay로 정의된 타겟 디스플레이(예:
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX)
  • int32array[1] VehicleHwMotionInputSource에 정의된 입력 유형입니다.
    VehicleHwMotionInputSource::SOURCE_KEYBOARD, VehicleHwMotionInputSource::SOURCE_DPAD
  • int32array[2] VehicleHwMotionInputAction에 정의된 작업 코드(예:
    VehicleHwMotionInputAction::ACTION_UP, VehicleHwMotionInputAction::ACTION_DOWN)
  • int32array[3] VehicleHwMotionButtonStateFlag에 정의된 버튼 상태 플래그(예:
    , VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY, VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY)
  • int32array[4] 포인터 이벤트 수, N. N은 양의 정수여야 합니다.
  • int32array[5:5+N-1] 포인터 ID, 길이 N
  • int32array[5+N:5+2*N-1] 도구 유형, 길이 N입니다. VehicleHwMotionToolType에 정의된 대로(예:
    VehicleHwMotionToolType::TOOL_TYPE_FINGER, VehicleHwMotionToolType::TOOL_TYPE_STYLUS)
  • floatArray[0:N-1] x 데이터, 길이 N
  • floatArray[N:2*N-1] y 데이터, 길이 N
  • floatArray[2*N:3*N-1] 압력 데이터, 길이 N
  • floatArray[3*N:4*N-1] 크기 데이터, 길이 N
  • int64array[0] 다운 시간, 부팅 후 경과된 나노초입니다. 사용자가 원래 키를 눌러서 위치 이벤트 스트림을 시작한 시간을 나타냅니다. 다운 이벤트의 경우 다운 이벤트의 이벤트 시간입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

HW_ROTARY_INPUT

Android에 하드웨어 로터리 이벤트를 제공하는 속성입니다.

  • int32Values[0] RotaryInputType: 회전되는 로터리 노브를 식별합니다.
  • int32Values[1] 디텐트 (클릭수), 시계 방향은 양수, 시계 반대 방향은 음수입니다.
  • int32Values[2] VehicleDisplay에 정의된 타겟 디스플레이가 특정 디스플레이에 연결되지 않은 이벤트를 VehicleDisplay#MAIN로 전송해야 합니다.
  • int32values[3 .. 3 + abs(number of detents) - 2] 디텐트 수가 1보다 크거나 -1보다 작을 때 연속 디텐트 쌍 사이의 나노초 델타
  • VehiclePropValue.timestamp 회전이 발생한 시점입니다. 디텐트 수가 1보다 크거나 -1보다 작은 경우 첫 번째 회전 디텐트가 발생한 시점입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: RotaryInputType
단위 유형: 해당 사항 없음
출시: Android 13

IGNITION_STATE

점화 상태를 나타냅니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleIgnitionState
단위 유형: 해당 사항 없음
출시: Android 13

INFO_DRIVER_SEAT

운전석 위치 VHAL 구현은 areaId를 무시해야 합니다. VehicleArea:GLOBAL 사용

변경 모드: STATIC
액세스 모드: READ
Enum 유형: VehicleAreaSeat
단위 유형: 해당 사항 없음
출시: Android 13

INFO_EV_BATTERY_CAPACITY

EV 또는 하이브리드 차량의 정격 배터리 용량입니다. 공칭 배터리 용량(EV 또는 하이브리드)을 반환합니다. 차량이 신차일 때의 총 사용 가능한 배터리 용량입니다. 이 값은 EV_CURRENT_BATTERY_CAPACITY와 다를 수 있습니다. EV_CURRENT_BATTERY_CAPACITY는 배터리 노화 및 온도 종속성 등의 요소를 고려하여 실시간으로 사용 가능한 배터리 용량을 반환하기 때문입니다.

변경 모드: 고정
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:WH
출시: Android 13

INFO_EV_CONNECTOR_TYPE

이 전기자동차에서 사용할 수 있는 커넥터 목록입니다. 차량에 충전 포트가 여러 개인 경우 이 속성은 차량의 충전 포트 중 하나 이상에서 사용할 수 있는 모든 커넥터 유형을 반환해야 합니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: EvConnectorType
단위 유형: 해당 사항 없음
출시: Android 13

INFO_EV_PORT_LOCATION

이 속성은 PortLocationType 열거형을 사용하여 EV의 충전 포트 위치를 전달해야 합니다. 차량에 포트가 여러 개인 경우 이 속성은 가장 빠른 충전을 허용하는 포트를 반환해야 합니다. 모든 포트 위치를 통신하려면 INFO_MULTI_EV_PORT_LOCATIONS를 사용합니다.

EV 포트 위치: 정적
액세스 모드: 읽기
Enum 유형: PortLocationType
단위 유형: 해당 사항 없음
출시: Android 13

INFO_EXTERIOR_DIMENSIONS

차량 외부 크기:

  • 높이: int32Values[0]
  • 길이: int32Values[1]
  • 너비: int32Values[2]
  • 미러를 포함한 너비: int32Values[3]
  • 미러를 포함한 휠베이스: int32Values[4]
  • 트랙 너비 앞면: int32Values[5]
  • 트랙 후면 너비: int32Values[6]
  • 연석 간 선회 직경: int32Values[7]

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLIMETER
출시: Android 13

INFO_FUEL_CAPACITY

차량의 연료 용량(밀리리터)입니다. 이 속성은 차량에 저장할 수 있는 최대 연료량(밀리리터)을 전달해야 합니다. 이 속성은 전기자동차 (EV)에는 적용되지 않습니다. 즉, INFO_FUEL_TYPEFuelType::FUEL_TYPE_ELECTRIC만 포함된 경우 INFO_FUEL_CAPACITY가 구현되면 안 됩니다. EV의 경우 INFO_EV_BATTERY_CAPACITY를 구현합니다.

변경 모드: 고정
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLILITER
출시: Android 13

INFO_FUEL_DOOR_LOCATION

연료 주입구 도어 위치입니다. 이 속성은 차량의 주유구 캡 위치를 전달해야 합니다. 이 속성은 EV에 적용되지 않습니다. 즉, INFO_FUEL_TYPEFuelType::FUEL_TYPE_ELECTRIC만 포함된 경우 이 속성을 구현해서는 안 됩니다. EV의 경우 INFO_EV_PORT_LOCATION 또는 INFO_MULTI_LOCATIONS를 구현하세요.

변경 모드: 정적
액세스 모드: READ
Enum 유형: PortLocationType
단위 유형: 해당 사항 없음
출시: Android 13

INFO_FUEL_TYPE

차량에서 사용할 수 있는 연료의 목록입니다. FuelType::FUEL_TYPE_ELECTRIC는 차량에 충전식 전기 자동차를 연결할 수 있는 경우에만 포함해야 합니다. 예를 들어 완전 하이브리드 전기자동차(FHEV)에는 FuelType::FUEL_TYPE_ELECTRIC을 포함하면 안 됩니다. INFO_FUEL_TYPE INFO_FUEL_TYPE의 INT32_VEC 값을 그대로 채울 수 있기 때문입니다.

int32Values = { FuelType::FUEL_TYPE_UNLEADED }
반면에 플러그인 하이브리드 전기자동차 (PHEV)는 플러그인 충전식이며 다음과 같이 INFO_FUEL_TYPE INFO_FUEL_TYPE의 INT32_VEC 값으로 FuelType::FUEL_TYPE_ELECTRIC를 포함해야 합니다. int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }

변경 모드: STATIC
액세스 모드: READ
Enum 유형: FuelType
단위 유형: 해당 사항 없음
출시: Android 13

정보_만들기

차량 제조업체입니다. 이 속성은 차량의 공개 브랜드 이름을 전달해야 합니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

INFO_MODEL

차량 모델입니다. 이 속성은 차량의 공개 모델 이름을 전달해야 합니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

INFO_MODEL_YEAR

그레고리력을 기반으로 하는 'YYYY' 형식의 차량 모델 연식입니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:YEAR
출시: Android 13

INFO_MULTI_EV_PORT_LOCATIONS

여러 EV 포트 위치 차량에 EV 포트가 여러 개 있는 경우 이 속성을 구현합니다. 포트 위치는 PortLocationType에 정의되어 있습니다. 예를 들어 자동차의 경우 왼쪽에 포트 하나가 있고 후면에 포트가 하나씩 있습니다.

int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT

차량에 포트가 하나만 있는 경우 이 속성의 값에는 요소가 하나만 나열되어야 합니다. 포트 위치 하나를 설명하려면 INFO-EV-PORT-LOCATION을 참고하세요.

.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: PortLocationType
단위 유형: 해당 사항 없음
출시: Android 13

정보_VIN

차량의 VIN

변경 모드: 정적
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

INITIAL_USER_INFO

초기화 중에 사용할 Android 사용자를 정의합니다. 이 속성은 초기화 시 Android 시스템에 의해 호출되며 HAL에서 시작해야 하는 Android 사용자를 정의할 수 있게 해줍니다. 이 요청은 VehiclePropValue(InitialUserInfoRequest로 정의됨)를 설정하여 이루어지며 HAL은 속성 변경 이벤트(InitialUserInfoResponse로 정의됨)로 응답해야 합니다. HAL이 Android 시스템에서 정의한 시간 후에 응답하지 않으면 Android 시스템은 HAL이 InitialUserInfoResponseAction:DEFAULT 작업의 응답을 반환한 것처럼 진행합니다. 예를 들어 최초 부팅 시 요청은 다음과 같을 수 있습니다.

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)
HAL이 소유자라는 관리자 사용자 생성으로 응답하면 응답은 다음과 같습니다.
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
문자열 값은 ||로 구분된 여러 값을 나타냅니다. 첫 번째 값은 생성할 사용자의 (선택사항) 시스템 언어이며 (이 경우 비어 있음, Android 기본값을 사용함), 두 번째 값은 생성할 사용자의 이름 (선택사항)입니다 (응답 유형이 InitialUserInfoResponseAction:CREATE인 경우). 예를 들어, en-US 및 pt-BR 로케일의 소유자 값을 생성하려면 pt-Owner의 문자열인 pt-Owner를 사용해야 합니다. 따라서 언어 및 이름 모두 값에 세로 막대 두 개(||)를 포함할 수 없지만 단일 세로 막대 (|)를 사용할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

J~R

LANE_CENTERING_ASSIST_COMMAND

Lane Centering Assist (LCA) commands. Commands to activate and suspend LCA. When the command ACTIVATE from LaneCenteringAssistCommand is sent, LANE_CENTERING_ASSIST_STATE must be set to LaneCenteringAssistState#ACTIVATION_REQUESTED When the ACTIVATE command succeeds, LANE_CENTERING_ASSIST_STATE must be set to LaneCenteringAssistState#ACTIVATED When the command DEACTIVATE from LaneCenteringAssistCommand succeeds, LANE_CENTERING_ASSIST_STATE must be set to LaneCenteringAssistState#ENABLED

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues must be defined unless all enum values of LaneCenteringAssistCommand are supported. When this property is not available because LCA is disabled (for example, LANE_CENTERING_ASSIST_ENABLED is false), this property must return StatusCode#NOT_AVAILABLE_DISABLED If LANE_CENTERING_ASSIST_STATE is implemented and the state is set to an ErrorState value, then this property must return a StatusCode that aligns with the ErrorState value. For example, if LANE_CENTERING_ASSIST_STATE is set to ErrorState#NOT_AVAILABLE_SPEED_LOW then this property must return StatusCode#NOT_AVAILABLE_SPEED_LOW

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: LaneCenteringAssistCommand
Unit type: N/A
Release: Android 14

LANE_CENTERING_ASSIST_ENABLED

Enable or disable Lane Centering Assist (LCA). Set true to enable LCA and false to disable LCA. When LCA is enabled, the ADAS system in the vehicle should be turned on and waiting for an activation signal from the driver. Once the feature is activated, the ADAS system should be steering the vehicle to keep it centered in its current lane.

This is different from Lane Keep Assist (LKA) which monitors if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane. In general, LANE_CENTERING_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 or too high, that information must be conveyed through the ErrorState values in the LANE_CENTERING_ASSIST_STATE property.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

LANE_CENTERING_ASSIST_STATE

Lane Centering Assist (LCA) state. Returns the current state of LCA. This property must always return a valid state defined in LaneCenteringAssistState or ErrorState It must not surface errors through StatusCode and must use the supported error states instead.

If LCA includes lane departure warnings, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both LaneCenteringAssistState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneCenteringAssistState/ErrorState
Unit type: N/A
Release: Android 14

LANE_DEPARTURE_WARNING_ENABLED

Enable or disable Lane Departure Warning (LDW). Set true to enable LDW and false to disable LDW. When LDW is enabled, the ADAS system in the vehicle should be turned on and monitoring if the vehicle is approaching or crossing lane lines, in which case a warning will be given.

In general, LANE_DEPARTURE_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 or too high, that information must be conveyed through the ErrorState values in the LANE_DEPARTURE_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

LANE_DEPARTURE_WARNING_STATE

Lane Departure Warning (LDW) state. Returns the current state of LDW. This property must always return a valid state defined in LaneDepartureWarningState 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 LaneDepartureWarningState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneDepartureWarningState/ErrorState
Unit type: N/A
Release: Android 14

LANE_KEEP_ASSIST_ENABLED

Enable or disable Lane Keep Assist (LKA). Set true to enable LKA and false to disable LKA. When LKA is enabled, the ADAS system in the vehicle should be turned on and monitoring if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane. This is different from Lane Centering Assist (LCA) which, when activated, applies continuous steering control to keep the vehicle centered in the current lane.

In general, 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 or too high, that information must be conveyed through the ErrorState values in the 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

LANE_KEEP_ASSIST_STATE

Lane Keep Assist (LKA) state. Returns the current state of LKA. This property must always return a valid state defined in LaneKeepAssistState or ErrorState It must not surface errors through StatusCode and must use the supported error states instead

If LKA includes lane departure warnings before applying steering corrections, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both LaneKeepAssistState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneKeepAssistState/ErrorState
Unit type: N/A
Release: Android 14

LOCATION_CHARACTERIZATION

Characterization of inputs used for computing location. This property must indicate what (if any) data and sensor inputs are considered by the system when computing the vehicle's location that is shared with Android through the GNSS HAL.

The value must return a collection of bit flags. The bit flags are defined in LocationCharacterization. The value must also include exactly one of DEAD_RECKONED or RAW_GNSS_ONLY among its collection of bit flags.

When this property is not supported, it is assumed that no additional sensor inputs are fused into the GNSS updates provided through the GNSS HAL. That is unless otherwise specified through the GNSS HAL interfaces.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14

MIRROR_AUTO_FOLD_ENABLED

Represents property for Mirror Auto Fold feature. This property is true when the feature for automatically folding the vehicle's side mirrors (for example, when the mirrors fold inward automatically when one exits and locks the vehicle) is enabled.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

MIRROR_AUTO_TILT_ENABLED

Represents property for Mirror Auto Tilt feature. This property is true when the feature for automatically tilting the vehicle's side mirrors (for example, when the mirrors tilt downward automatically when one reverses the vehicle) is enabled.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

MIRROR_FOLD

Mirror fold. True indicates mirrors are folded. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_LOCK

Mirror lock. True indicates mirror positions are locked and not changeable. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Y_MOVE

Mirror Y move. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The maxInt32Value represents the maximum movement speed of the mirror while tilting right. The minInt32Value represents the maximum movement speed of the mirror while tilting left.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the mirror reaches the positional limit, the value must reset to 0. If MIRROR_Y_MOVE's value is currently 0, then that means there is no movement currently occurring.

This property is not in any particular unit but in a specified range of relative movement speeds.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Y_POS

Mirror Y position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the mirror is tilted completely to the left.

This must be a non-positive value. The maxInt32Value indicates the mirror is tilted completely to the right. This must be a non-negative value. 0 indicates the mirror is not tilted in either direction.

Values in between minInt32Value and maxInt32Value indicate a transition state between the left extreme and right extreme positions.

This property is not in any particular unit but in a specified range of relative positions.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Z_MOVE

Mirror Z move. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The maxInt32Value represents the maximum movement speed of the mirror while tilting upwards. The minInt32Value represents the maximum movement speed of the mirror while tilting downwards. Larger absolute values, either positive or negative, indicate a faster movement speed. Once the mirror reaches the positional limit, the value must reset to 0. If MIRROR_Z_MOVE's value is currently 0, then that means there is no movement currently occurring.

This property is not in any particular unit but in a specified range of relative movement speeds.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Z_POS

Mirror Z position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the mirror is tilted completely downwards. This must be a non-positive value. The maxInt32Value indicates the mirror is tilted completely upwards. This must be a non-negative value. 0 indicates the mirror is not tilted in either direction.

Values in between minInt32Value and maxInt32Value indicate a transition state between the fully downward and fully upwards positions.

This property is not in any particular unit but in a specified range of relative positions.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

NIGHT_MODE

True indicates that the night mode sensor has detected the car cabin environment to have low light. The platform can use this to, for example, enable an appropriate UI for better viewing in dark or low light environments.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_FREEZE_FRAME

Reports a snapshot of the value of the OBD2 sensors available at the time that a fault occurred and was detected. A configArray must be provided with the same meaning as defined for OBD2_LIVE_FRAME

The values of this property are to be interpreted in a similar fashion as those for OBD2_LIVE_FRAME, with the exception that the stringValue field may contain a non-empty diagnostic troubleshooting code (DTC).

An IVehicle#get request of this property must provide a value for int64Values[0]. This is interpreted as the timestamp of the freeze frame to retrieve. A list of timestamps can be obtained by an IVehicle#get of OBD2_FREEZE_FRAME_INFO

Should no freeze frame be available at the given timestamp, a response of NOT_AVAILABLE must be returned by the implementation. Because vehicles may have limited storage for freeze frames, it is possible for a frame request to respond with NOT_AVAILABLE even if the associated timestamp has been recently obtained through OBD2_FREEZE_FRAME_INFO

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_FREEZE_FRAME_CLEAR

Freeze frame clear. Reports a snapshot of the value of the OBD2 sensors available at the time that a fault occurred and was detected. A configArray must be provided with the same meaning as defined for OBD2_LIVE_FRAME

The values of this property are to be interpreted in a similar fashion as those for OBD2_LIVE_FRAME, with the exception that the stringValue field may contain a non-empty diagnostic troubleshooting code (DTC).

A IVehicle#get request of this property must provide a value for int64Values[0]. This will be interpreted as the timestamp of the freeze frame to retrieve. A list of timestamps can be obtained by a IVehicle#get of OBD2_FREEZE_FRAME_INFO

Should no freeze frame be available at the given timestamp, a response of NOT_AVAILABLE must be returned by the implementation. Because vehicles may have limited storage for freeze frames, it is possible for a frame request to respond with NOT_AVAILABLE even if the associated timestamp has been recently obtained via OBD2_FREEZE_FRAME_INFO

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_FREEZE_FRAME_INFO

This property describes the current freeze frames stored in vehicle memory and available for retrieval through OBD2_FREEZE_FRAME The values are to be interpreted as follows. Each element of int64Values must be the timestamp at which a a fault code has been detected and the corresponding freeze frame stored, and each such element can be used as the key to OBD2_FREEZE_FRAME to retrieve the corresponding freeze frame.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_LIVE_FRAME

Reports a snapshot of the current (live) values of the OBD2 sensors available. The configArray is set as follows:

  • configArray[0] Number of vendor-specific integer-valued sensors
  • configArray[1] Number of vendor-specific float-valued sensors

The values of this property are to be interpreted as in the following example. Considering a configArray = {2,3} int32Values must be a vector containing Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX plus two elements (or, 33 elements). floatValues must be a vector containing Obd2FloatSensorIndex.LAST_SYSTEM_INDEX plus three elements (or, 73 elements).

It is possible for each frame to contain a different subset of sensor values, both system provided sensors, and vendor-specific ones. In order to support this, the bytes element of the property value is used as a bitmask. Bytes must have a sufficient number of bytes to represent the total number of possible sensors (in this case, 14 bytes to represent 106 possible values). It'is to be read as a contiguous bitmask such that each bit indicates the presence or absence of a sensor from the frame, starting with as many bits as the size of int32Values, immediately followed by as many bits as the size of floatValues.

For example, should bytes[0] = 0x4C (0b01001100) it means that:

  • int32Values[0 and 1] are not valid sensor values
  • int32Values[2 and 3] are valid sensor values
  • int32Values[4 and 5] are not valid sensor values
  • int32Values[6] is a valid sensor value
  • int32Values[7] is not a valid sensor value
  • int32Values[0 and 1] are not valid sensor values
  • int32Values[2 and 3] are valid sensor values
  • int32Values[4 and 5] are not valid sensor values
  • int32Values[6] is a valid sensor value
  • int32Values[7] is not a valid sensor value

If bytes[5] = 0x61 (0b01100001), then:

  • int32Values[32] is a valid sensor value
  • floatValues[0 thru 3] are invalid sensor values
  • floatValues[4 and 5] are valid sensor values
  • floatValues[6] is not a valid sensor value.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

ON_CHANGE

Change mode:
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type:N/A
Release: Android 13

PARKING_BRAKE_AUTO_APPLY

Auto-apply parking brake. When true, this property indicates that the car's automatic parking brake is enabled. False indicates that the car's automatic parking brake feature is disabled. This property is often confused with PARKING_BRAKE_ON The difference being that PARKING_BRAKE_ON indicates if the actual parking brake is on or off whereas PARKING_BRAKE_AUTO_APPLY indicates if the automatic parking brake feature is enabled or disabled and does not describe the current state of the actual parking brake.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

PARKING_BRAKE_ON

Parking brake state. When true, this property true indicates that the car's parking brake is engaged. False indicates the car's parking brake is disengaged.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

PER_DISPLAY_BRIGHTNESS

Property to represent brightness of the displays which are controlled separately. Some cars have one or more displays whose brightness is controlled separately and this property is to inform the brightness of each passenger display. In cars where all displays' brightness is controlled together, they must use DISPLAY_BRIGHTNESS

Only one of PER_DISPLAY_BRIGHTNESS andPER_DISPLAY_BRIGHTNESS should be implemented. If both are available, PER_DISPLAY_BRIGHTNESS is used by AAOS.

The display port uniquely identifies a physical connector on the device for display output, ranging from 0 to 255.

  • int32Values[0] Display port
  • int32Values[1] Brightness

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 14

PERF_ODOMETER

Current odometer value of the vehicle.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOMETER
Release: Android 13

PERF_REAR_STEERING_ANGLE

Rear bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the rear wheels with respect to the vehicle, not the angle of the steering wheel.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13

PERF_STEERING_ANGLE

Front bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the front wheels with respect to the vehicle, not the angle of the steering wheel.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13

PERF_VEHICLE_SPEED

Speed of the vehicle, The value must be positive when the vehicle is moving forward and negative when the vehicle is reversing. This value is independent of gear value (CURRENT_GEAR or GEAR_SELECTION). For example, if GEAR_SELECTION is GEAR_NEUTRAL, PERF_VEHICLE_SPEED is positive when the vehicle is moving forward, negative when reversing, and zero when not moving.

Change mode: CONTINUOUS
Access mode: READ
Unit type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13

PERF_VEHICLE_SPEED_DISPLAY

Speed of the vehicle for displays, Some cars display a slightly slower speed on the speedometer than actual speed.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13

POWER_POLICY_GROUP_REQ

Defines a request to set the power policy group used to decide a default power policy per power status transition.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

POWER_POLICY_REQ

Defines a request to apply power policy. VHAL sets this property to change car power policy. Car power policy service subscribes to this property and actually changes the power policy. The request is made by setting the VehiclePropValue with the ID of a power policy which is defined at /vendor/etc/automotive/power_policy.xml If the given ID is not defined, car power policy service ignores the request and the current power policy is maintained.

string: "sample_policy_id" // power policy ID

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

POWER_POLICY_GROUP_REQ

Defines a request to set the power policy group used to decide a default power policy per power status transition. VHAL sets this property with the ID of a power policy group to set the default power policy applied at power status transition. Power policy groups are defined at /vendor/etc/power_policy.xml. If the given ID is not defined, car power policy service ignores the request. Car power policy service subscribes to this property and sets the power policy group. The actual application of power policy takes place when the system power status changes and there is a valid mapped power policy for the new power status.

string: "sample_policy_group_id" // power policy group ID

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

RANGE_REMAINING

Range remaining. Meters remaining of fuel and charge. Range remaining shall account for all energy sources in a vehicle. For example, a hybrid car's range is the sum of the ranges based on fuel and battery. This property is defined as VehiclePropertyAccess.READ_WRITE because a navigation app could update the range if it has a more accurate estimate based on the upcoming route. This property can be implemented as VehiclePropertyAccess.READ only at the OEM's discretion.

Change mode: CONTINUOUS
Access mode: READ_WRITE
Enum type: N/A
Unit type: VehicleUnit:METER
Release: Android 13

READING_LIGHTS_STATE

Return the current status of reading lights.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

READING_LIGHTS_SWITCH

Switch t control the reading lights. This may differ from READING_LIGHTS_STATE if the lights are on because a door is open or due to a voice command. For example, while the switch is in the off or automatic position. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

REAR_FOG_LIGHTS_STATE

Return the current state of the rear fog lights. Only one of FOG_LIGHTS_STATE or REAR_FOG_LIGHTS_STATE can be implemented. See FOG_LIGHTS_STATE

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

REAR_FOG_LIGHTS_SWITCH

The setting that the user wants. Only one of FOG_LIGHTS_SWITCH or REAR_FOG_LIGHTS_SWITCH must be implemented. See FOG_LIGHTS_SWITCH to learn more. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13

REMOVE_USER

Called by the Android System after an Android user was removed. The HAL can use this property to remove the equivalent user. This is write-only cal. The Android System is not expecting a reply from the HAL. Hence, this request should not fail. If the equivalent HAL user cannot be removed, then HAL should mark it as inactive or recover in another way.

The request is made by setting the VehiclePropValue with the contents defined by RemoveUserRequest For example, if system had 3 users (0, 10, and 11) and user 11 was removed, the request would be:

  • int32[0] 42 // request id
  • int32[1] 11 // (Android user id of the removed user)
  • int32[2] 0 // (Android user flags of the removed user)
  • int32[3] 10 // current user
  • int32[4] 0 // current user flags (none)
  • int32[5] 2 // number of users
  • int32[6] 0 // first user (user 0)
  • int32[7] 0 // first user flags (none)
  • int32[8] 10 // second user (user 10)
  • int32[9] 0 // second user flags (none)

Change mode: STATIC
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

내림차순

SEAT_AIRBAG_ENABLED

트리거될 때(예: 충돌 시) 에어백을 배포하는 좌석의 기능을 사용 설정 및 중지하는 기능을 나타냅니다. true인 경우 좌석의 에어백이 사용 설정되어 있으며, 트리거되면 펼쳐집니다. true인 경우 좌석의 에어백이 사용 중지되며 어떠한 상황에서도 펼쳐지지 않습니다. 이 속성은 에어백이 배포되었는지 나타내지 않습니다.

이 속성은 규제 또는 안전 문제의 목적으로 읽기 전용 VehiclePropertyAccess.READ로 설정할 수 있습니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_BACKREST_ANGLE_1_MOVE

좌석 등받이 각도 1번 이동 각 VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다. maxInt32Value는 앞으로 앵글 때 좌석 등받이의 최대 이동 속도를 나타냅니다. minInt32Value는 등받이를 기울일 때 좌석 등받이의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 등받이가 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. SEAT_BACKREST_ANGLE_1_MOVE의 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_BACKREST_ANGLE_1_POS

좌석 등받이 각도 1번 위치 등받이 각도 1은 좌석의 바닥에 가장 가까운 액추에이터입니다. VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다. minInt32Value는 좌석 하단의 액추에이터와 관련하여 좌석 등받이의 전체 기울기 위치를 나타냅니다. maxInt32Value는 좌석 하단의 액추에이터와 관련하여 좌석 등받이의 가장 직립 또는 전진 위치를 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 완전히 젖힌 상태와 완전히 펴고 앞으로 기울인 상태 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_BACKREST_ANGLE_2_MOVE

좌석 등받이 각도 2 이동 각 VehicleAreaConfigmaxInt32ValueminInt32Value는 정의되어야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다.

maxInt32Value는 앞으로 기울이는 동안 좌석 등받이의 최대 이동 속도를 나타냅니다. minInt32Value는 리클라이닝하는 동안 좌석 등받이의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 등받이가 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. SEAT_BACKREST_ANGLE_2_MOVE 값이 현재 0이면 이동이 진행되지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음 단위 유형: 해당 사항 없음
출시: Android 13

SEAT_BACKREST_ANGLE_2_POS

좌석 등받이 각도 2번 위치 등받이 각도 2는 좌석 하단에서 위로 올라간 다음 액추에이터입니다.

VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수는 #0지원되어야 합니다.

minInt32Value는 좌석 하단의 액추에이터에서 등받이의 다음 액추에이터에 관한 좌석 등받이의 완전히 젖힌 위치를 나타냅니다 (자세한 내용은 SEAT_BACKREST_ANGLE_1_POS 참고). maxInt32Value는 좌석 하단의 액추에이터에서 등받이의 다음 액추에이터에 관해 좌석 등받이의 가장 직립하고 앞으로 나온 위치를 나타냅니다 (자세한 내용은 SEAT_BACKREST_ANGLE_1_POS 참고).

minInt32ValuemaxInt32Value 사이의 값은 완전히 젖힌 상태와 완전히 펴진 상태 사이의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_BELT_BUCKLED

안전벨트를 매었습니다. True는 벨트에 안전벨트가 매여 있음을 나타냅니다. 쓰기 액세스는 자동 좌석 벨트 고정 기능을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_BELT_HEIGHT_MOVE

안전벨트 높이 이동 각 VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

maxInt32Value는 위로 이동하는 동안 안전 벨트의 어깨 고정 장치의 최대 이동 속도를 나타냅니다. minInt32Value는 아래로 이동하는 동안 안전 벨트의 어깨 앵커의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 안전 벨트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_BELT_HEIGHT_MOVE 값이 0이면 이동이 진행되지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_BELT_HEIGHT_POS

안전벨트 높이 위치입니다. 어깨 벨트 앵커 지점을 조정합니다.

VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

minInt32Value는 안전 벨트의 어깨 앵커가 가장 낮은 위치에 있음을 나타냅니다. maxInt32Value는 안전 벨트의 어깨 앵커가 가장 높은 위치에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 최저 위치와 최고 위치 사이의 전환 상태를 나타냅니다.

이 속성은 상대 위치의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_CUSHION_SIDE_SUPPORT_MOVE

좌석 쿠션 측면 지지대의 움직임 방향 및 속도에 관한 속성을 나타냅니다.

각 VehicleAreaConfig의 maxInt32ValueminInt32Value는 정의되어야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

maxInt32Value는 좌석 쿠션 측면 지지대가 더 넓어질 때의 최대 이동 속도를 나타냅니다 (예: 지지대가 감소함). minInt32Value는 좁아질 때(예: 지지대가 증가함) 좌석 쿠션 측면 지지대의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 쿠션 측면 지지대가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. SEAT_CUSHION_SIDE_SUPPORT_MOVE 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_CUSHION_SIDE_SUPPORT_POS

좌석의 엉덩이 측면 (하단 쿠션 측면) 지지 위치의 속성을 나타냅니다.

각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

maxInt32Value는 좌석 쿠션 측면 지지대가 가장 넓은 위치에 있음을 나타냅니다 (예: 가장 약한 지지). minInt32Value는 좌석 쿠션 측면 지지대가 가장 얇은 위치 (예: 가장 많은 지지)에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 가장 얇은 위치와 가장 넓은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 <covehiclepropertyaccess.read< code=""> only.</covehiclepropertyaccess.read<>로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_DEPTH_MOVE

좌석 깊이 이동

각 VehicleAreaConfig의 maxInt32ValueminInt32Value는 정의되어야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

maxInt32Value는 깊어지는 동안 좌석의 최대 이동 속도를 나타내고 minInt32Value는 얕아지는 동안 좌석의 최대 이동 속도를 나타냅니다.

양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 좌석 등받이가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_DEPTH_MOVE의 값이 현재 0이면 진행 중인 이동이 없는 것입니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_DEPTH_POS

좌석 깊이 위치입니다. 등받이에서 좌석 앞쪽 가장자리까지의 거리인 좌석 깊이를 설정합니다.

VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

minInt32Value는 좌석이 가장 낮은 위치에 있음을 나타냅니다 (예: 좌석 쿠션의 앞쪽 가장자리와 좌석의 뒤쪽 끝 사이의 거리가 가장 짧은 위치).

maxInt32Value는 좌석이 가장 낮은 위치에 있음을 나타냅니다 (예: 좌석 쿠션의 앞쪽 가장자리와 좌석의 뒤쪽 끝 사이의 거리가 가장 긴 위치).

minInt32ValuemaxInt32Value 사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 <covehiclepropertyaccess.read< code=""> only..</covehiclepropertyaccess.read<>로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_EASY_ACCESS_ENABLED

좌석 접근성 기능의 속성을 나타냅니다. true인 경우 탑승자가 더 쉽게 차량에 승차하고 하차할 수 있도록 좌석이 자동으로 조정됩니다. 각 영역 ID는 사용자가 쉬운 액세스 기능을 사용하여 승하차하려는 좌석에 매핑되어야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 <covehiclepropertyaccess.read< code=""> 전용</covehiclepropertyaccess.read<>로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: 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=AUTOMATICSEAT_FOOTWELL_LIGHTS_SWITCH=ON).

이 속성은 SEAT_FOOTWELL_LIGHTS_STATE 의 값이 CABIN_LIGHTS_STATE의 값과 다를 수 있는 경우에만 구현해야 합니다.

VehicleLightState의 모든 enum 값이 지원되지 않는 한 지원되는 각 지역 ID에 대해 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 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=AUTOMATICSEAT_FOOTWELL_LIGHTS_SWITCH=ON).

이 속성은 SEAT_FOOTWELL_LIGHTS_SWITCH의 값이 CABIN_LIGHTS_SWITCH의 값과 다를 수 있는 경우에만 구현해야 합니다.

지원되는 각 지역 ID의 경우 VehicleLightSwitch의 모든 열거형 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_FORE_AFT_MOVE

좌석 앞뒤 이동 이 속성은 좌석이 향하는 방향으로 전체 좌석을 앞뒤로 이동합니다.

각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

maxInt32Value은 앞으로 이동하는 동안 좌석의 최대 이동 속도를 나타냅니다. minInt32Value은 뒤로 이동 시 좌석의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 자리가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. SEAT_FORE_AFT_MOVE 값이 0이면 움직임이 발생하지 않는 것입니다.

이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_FORE_AFT_POS

좌석 앞쪽과 후방 위치입니다. 좌석 위치를 앞뒤로 설정합니다.

VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

minInt32Value는 좌석이 가장 뒤쪽의 선형 위치에 있음을 나타냅니다. maxInt32Value는 좌석이 가장 앞쪽 선형 위치에 있음을 나타냅니다. minInt32ValuemaxInt32Value 사이의 값은 가장 가까운 위치와 가장 먼 위치 간의 전환 상태를 나타냅니다.

이 속성은 상대 위치의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_ANGLE_MOVE

헤드레스트 각도 이동 각 VehicleAreaConfigmaxInt32ValueminInt32Value는 정의되어야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

maxInt32Value는 직립 또는 앞으로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다. minInt32Value는 얕은 자세로 이동할 때 좌석 머리 받침대의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석의 헤드레스트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_HEADREST_ANGLE_MOVE 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 <covehiclepropertyaccess.read< code=""> only..</covehiclepropertyaccess.read<>로 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_ANGLE_POS

헤드레스트 각도 위치 VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다.

minInt32Value는 머리받침이 완전히 젖혀진 위치에 있음을 나타냅니다. maxInt32Value: 헤드레스트가 가장 수직이고 앞으로 향한 위치에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 완전히 젖힌 상태와 가장 직립하고 앞으로 기울어진 상태 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_FORE_AFT_MOVE

헤드레스트 앞뒤 이동 각 VehicleAreaConfigmaxInt32ValueminInt32Value는 정의되어야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

maxInt32Value는 전진하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다. minInt32Value는 뒤로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석의 헤드레스트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_HEADREST_FORE_AFT_MOVE 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_FORE_AFT_POS

헤드레스트 앞뒤 위치 VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다.

minInt32Value는 헤드레스트가 가장 뒤쪽 선형 위치에 있음을 나타냅니다. maxInt32Value는 헤드레스트가 가장 앞쪽 선형 위치에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 정방향 및 역방향 위치 사이의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_HEIGHT_MOVE(SEAT_HEADREST_HEIGHT_MOVE)

머리 받침대 높이 움직이기. 각 VehicleAreaConfigmaxInt32ValueminInt32Value는 정의되어야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다.

maxInt32Value는 위로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다. minInt32Value는 아래로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석의 헤드레스트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_HEADREST_HEIGHT_MOVE 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_HEIGHT_POS

(지원 중단됨) 헤드레스트 높이 위치입니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEADREST_HEIGHT_POS_V2

머리 받침대 높이 위치입니다. 지원되는 좌석의 헤드레스트 높이를 설정합니다. VehiclePropConfig.areaConfigs는 지원되는 좌석을 지정합니다.

VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

minInt32Value는 머리받침이 가장 낮은 위치에 있음을 나타냅니다. maxInt32Value는 헤드레스트가 가장 높은 위치에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_HEIGHT_MOVE(SEAT_HEIGHT_MOVE)

좌석 높이 이동입니다. 각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

maxInt32Value는 위로 이동할 때 좌석의 최대 이동 속도를 나타냅니다.

minInt32Value는 아래로 이동할 때 좌석의 최대 이동 속도를 나타냅니다.

양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 자리가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. SEAT_HEIGHT_MOVE 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_HEIGHT_POS

좌석 높이 위치입니다. VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

minInt32Value는 좌석이 가장 낮은 위치에 있음을 나타냅니다. maxInt32Value는 좌석이 가장 높은 위치에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_LUMBAR_FORE_AFT_MOVE

요추 앞뒤 움직임 각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

maxInt32Value는 앞으로 이동하면서 좌석의 허리 지지대에 좌우되는 최대 이동 속도를 나타냅니다. minInt32Value는 뒤로 이동하는 동안 좌석의 요추 지지대의 최대 이동 속도를 나타냅니다.

양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 좌석의 요추 지지대가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_LUMBAR_FORE_AFT_MOVE의 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_LUMBAR_FORE_AFT_POS

목재 앞뒤 위치 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다.

minInt32Value는 요추 지지대가 가장 뒤쪽에 있음을 나타냅니다(예: 지지력이 가장 약한 위치). maxInt32Value은 허리 지지대가 가장 앞쪽에 있음을 나타냅니다 (예: 가장 지지하는 위치).

minInt32ValuemaxInt32Value 사이의 값은 전방 및 후방 위치 간의 전환 상태를 나타냅니다.

이 속성은 상대 위치의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 유형: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

허리 측면 지지대 이동 각 VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value에서 maxInt32Value 사이의 모든 정수가 지원되어야 합니다.

maxInt32Value는 좌석의 요추 측면 지지대가 넓어지는 동안의 최대 이동 속도를 나타냅니다. minInt32Value은 얇아지면서 좌석의 허리 측면 지지대의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석의 허리 측면 지지대가 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. SEAT_LUMBAR_SIDE_SUPPORT_MOVE 값이 0이면 움직임이 발생하지 않습니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 유형: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_POS

허리 측부 지지 위치입니다. VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다. minInt32Value는 허리 측면 지지대가 가장 얇은 위치 (예: 대부분의 지지대)에 있음을 나타냅니다. maxInt32Value는 요추 측면 지지대가 가장 넓은 위치에 있음을 나타냅니다 (예: 가장 약한 지지).

minInt32ValuemaxInt32Value 사이의 값은 가장 좁은 위치와 가장 넓은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 유형: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_LUMBAR_VERTICAL_MOVE

좌석 요추 지지대의 수직 이동 방향 및 속도의 속성을 나타냅니다.

각 VehicleAreaConfig의 maxInt32ValueminInt32Value는 정의되어야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다. maxInt32Value은 허리 지지대가 가장 빠른 위 속도로 움직이고 있음을 나타냅니다. minInt32Value는 허리 지지대가 가장 빠른 속도로 움직이고 있음을 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 쿠션 측면 지지대가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. SEAT_LUMBAR_VERTical_MOVE의 값이 0이면 이동이 발생하지 않는 것입니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_LUMBAR_VERTICAL_POS

좌석의 허리 지지대 세로 위치의 속성을 나타냅니다. 각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 정수를 지원해야 합니다. maxInt32Value는 요추 지지대의 가장 높은 위치를 나타냅니다. minInt32Value은 허리 지지대의 가장 낮은 위치를 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_MEMORY_SELECT

이 매개변수는 좌석 위치를 선택하는 데 사용할 메모리 사전 설정을 선택합니다. VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수가 지원되어야 합니다. minInt32Value는 항상 0이고 maxInt32Value는 사용 가능한 좌석 사전 설정 메모리 슬롯 수를 결정합니다 (예: numSeatPresets - 1). 예를 들어 운전석에 메모리 사전 설정이 3개 있다면 maxInt32Value는 2입니다. 사용자가 사전 설정을 선택하면 원하는 사전 설정 번호 (0, 1, 2)가 설정됩니다.

변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_MEMORY_SET

이 설정을 사용하면 사용자가 현재 좌석 위치 설정을 선택한 사전 설정 슬롯에 저장할 수 있습니다. VehicleAreaConfigmaxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value는 0이어야 하며 각 좌석 위치의 maxInt32ValueSEAT_MEMORY_SELECTmaxInt32Value와 일치해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_OCCUPANCY

자동차가 판단할 수 있는 범위 내에서 특정 좌석이 탑승 중인지 여부를 나타냅니다. 유효한 값은 VehicleSeatOccupancyState enum에 속하는 값입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleSeatOccupancyState
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_TILT_MOVE

좌석 기울이기 동작 각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다. maxInt32Value는 위로 이동하는 동안 좌석 앞쪽 가장자리의 최대 이동 속도를 나타냅니다. minInt32Value는 아래로 이동하는 동안 좌석 앞쪽 가장자리의 최대 이동 속도를 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 하단이 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_TILT_MOVE의 값이 현재 0이면 움직임이 진행되지 않는 것입니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SEAT_TILT_POS

좌석 기울기 위치입니다. VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다. minInt32Value는 좌석 하단이 가장 낮은 각도 위치에 있음을 나타냅니다. 이는 좌석의 뒤쪽 끝을 기준으로 가능한 가장 낮은 위치의 좌석 앞쪽 가장자리에 해당합니다. maxInt32Value는 좌석 하단이 가장 높은 각도 위치에서 기울어져 있음을 나타냅니다. 이는 좌석의 뒷부분에 비해 가능한 한 높은 위치에 있는 좌석의 앞쪽 가장자리에 해당합니다.

minInt32ValuemaxInt32Value 사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SEAT_WALK_IN_POS

좌석의 현재 워크인 위치를 나타내는 속성을 나타냅니다. minInt32Value는 정상 좌석 위치를 나타냅니다. minInt32Value는 0이어야 합니다. maxInt32Value는 좌석이 완전히 들어간 상태임을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 일반 위치와 워크인 위치 간의 전환 상태를 나타냅니다.

이 속성은 상대 위치의 지정된 범위로 표현됩니다.

영역 ID는 승객이 앉을 의자가 아니라 워크인 기능이 활성화될 때 실제로 움직이는 좌석과 일치해야 합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은

VehiclePropertyAccess.READ로만 구현합니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SHUTDOWN_REQUEST

헤드 단위의 종료를 요청합니다.

헤드 단위의 전원이 꺼진 상태에서 작업을 실행하는 데 필요합니다 (원격 작업 기능). 태스크를 실행하기 위해 헤드 단위의 전원이 켜진 후 헤드 단위를 종료해야 합니다. 작업이 완료되면 헤드 단위에서 이 메시지를 보냅니다.

이 속성은 사용자가 헤드 단위를 종료하려고 할 때는 적용되지 않습니다.

여기에는 일반적으로 헤드 단위 외부의 별도 시스템 (예: 전원 컨트롤러)에 헤드 유닛 종료를 준비하도록 지시하는 것이 포함됩니다.

외부 시스템은 차량이 사용 중인지 확인하여 이 요청이 유효한지 확인해야 합니다. 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
Enum 유형: VehicleApPowerStateShutdownParam>
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_DEPTH_MOVE

스티어링 휠 깊이 움직임 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 값을 지원해야 합니다.

maxInt32Value는 핸들이 운전자로부터 멀어지는 것을 나타냅니다. minInt32Value는 핸들이 운전자를 향해 이동하는 것을 나타냅니다.

정수 또는 음수의 정수가 클수록 이동 속도가 더 빠릅니다. 스티어링 휠이 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. STEERING_WHEEL_DEPTH_MOVE의 값이 현재 0이면 이동이 진행되지 않는 것입니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_DEPTH_POS

스티어링 휠 깊이 위치입니다. 모든 스티어링 휠 속성의 고유 ID는 0x0BE0부터 시작합니다.

VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 값을 지원해야 합니다. maxInt32Value는 운전자와 가장 먼 핸들 위치를 나타냅니다. minInt32Value는 운전자와 가장 가까운 스티어링 휠 위치를 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은

이 속성은 지정된 상대적 위치 범위로 표시됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_EASY_ACCESS_ENABLED

스티어링 휠 간편 액세스 기능이 사용 설정되었습니다. 이 값이 true이면 운전자가 차량에 더 쉽게 탑승하고 내릴 수 있도록 운전자의 스티어링 휠이 자동으로 조정됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_HEIGHT_MOVE

스티어링 휠 높이 이동입니다. VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 값을 지원해야 합니다.

maxInt32Value은 스티어링 휠이 위로 이동함을 나타냅니다. minInt32Value는 스티어링 휠이 아래로 움직임을 나타냅니다.

양수 또는 음수 중 더 큰 정수는 더 빠른 이동 속도를 나타냅니다. 스티어링 휠이 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. STEERING_WHEEL_HEIGHT_MOVE의 값이 현재 0이면 현재 움직임이 없다는 의미입니다.

이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_HEIGHT_POS

스티어링 휠 높이 위치

VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32ValuemaxInt32Value 사이의 모든 값을 지원해야 합니다. maxInt32Value는 핸들이 가장 높은 위치에 있음을 나타냅니다. minInt32Value는 스티어링 휠이 가장 낮은 위치에 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 최저 위치와 최고 위치 사이의 전환 상태를 나타냅니다.

이 속성은 상대 위치의 지정된 범위로 표현됩니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM에서는 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_LIGHTS_STATE

핸들 조명 상태입니다. 스티어링 휠 조명의 현재 상태를 나타냅니다. 이는 조명을 제어하는 스위치의 위치를 나타내는 STEERING_WHEEL_LIGHTS_SWITCH와 다릅니다. 따라서 STEERING_WHEEL_LIGHTS_STATESTEERING_WHEEL_LIGHTS_SWITCH 값과 일치하지 않을 수 있습니다 (예: STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATICSTEERING_WHEEL_LIGHTS_STATE=ON).

이 속성은 STEERING_WHEEL_LIGHTS_STATE의 값이 CABIN_LIGHTS_STATE의 값과 다를 수 있는 경우에만 구현해야 합니다.

전역 영역 ID (0)의 경우 VehicleLightState의 모든 열거형 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_LIGHTS_SWITCH

핸들 조명 스위치입니다. 스티어링 휠 조명을 제어하는 스위치의 위치를 나타냅니다. 이는 스티어링 휠 조명의 현재 상태를 나타내는 와는 다릅니다. 따라서 STEERING_WHEEL_LIGHTS_SWITCHSTEERING_WHEEL_LIGHTS_STATE의 값과 일치하지 않을 수 있습니다. 예를 들면 STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATICSTEERING_WHEEL_LIGHTS_STATE=ON입니다.

이 속성은 STEERING_WHEEL_LIGHTS_SWITCH의 값이 CABIN_LIGHTS_SWITCH의 값과 다를 수 있는 경우에만 구현해야 합니다.

전역 지역 ID (0)의 경우 VehicleLightSwitch의 모든 enum 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_LOCKED

핸들이 잠겼습니다. true이면 스티어링 휠의 위치가 잠겨 변경할 수 없습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 <covehiclepropertyaccess.read< code="">로만 구현할 수 있습니다./p> </covehiclepropertyaccess.read<>

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

스티어링 휠 도난 방지 잠금 기능이 사용 설정되었습니다. true인 경우 특정 상황에서 도난을 방지하기 위해 핸들이 자동으로 잠깁니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

STORAGE_ENCRYPTION_BINDING_SEED

외부 암호화 결합 시드입니다. 이 값은 로컬 키 저장소 암호화 키와 혼합됩니다. 이 속성은 16바이트를 보유하며 IVI와는 별도의 ECU에 유지됩니다. 이 속성은 처음에 AAOS에 의해 설정되며 AAOS는 CSRNG를 사용하여 속성을 생성합니다. 그런 다음 AAOS는 후속 부팅 시 속성을 읽습니다. 바인딩 시드는 안정적으로 유지될 것으로 예상됩니다. 시드를 잃으면 IVI가 초기화됩니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

공급업체 속성의 권한 맞춤설정을 지원합니다.

VHAL에서 공급업체 권한 맞춤설정 기능을 지원하는 경우 이 속성을 구현합니다. VehiclePropConfig.configArray는 이 공급업체 속성에 대해 선택된 공급업체 속성과 권한을 나타내는 데 사용됩니다. 권한은 VehicleVendorPermission의 enum 중 하나여야 합니다. configArray는 공급업체 속성의 경우 configArray[n]: propId : property ID 다음과 같이 설정됩니다. 여기서 configArray[n+1] 은 VehicleVendorPermission의 enum이며 속성 값을 읽기 위한 권한을 나타냅니다.

configArray[n+2] 는 VehicleVendorPermission의 enum이며 속성 값을 쓰는 권한을 나타냅니다. 예를 들면 다음과 같습니다.

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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

SUPPORTED_PROPERTY_IDS

(지원 중단됨) 지원되는 모든 속성 ID의 목록입니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

SWITCH_USER

포그라운드 Android 사용자를 전환하는 요청을 정의합니다.

이 속성은 주로 Android 시스템에서 현재 포그라운드 Android 사용자가 전환되고 있음을 HAL에 알리는 데 사용되지만 HAL에서 Android 시스템에 사용자 전환을 요청하는 데도 사용할 수 있습니다. Android에서 요청하면 VehiclePropValue가 설정되고 HAL은 속성 변경 이벤트로 응답해야 합니다. HAL은 요청을 할 때 속성 변경 이벤트를 통해서도 실행해야 합니다. 주요 차이점은 요청 ID가 전자의 경우에는 양수이고 후자의 경우에는 음수라는 점입니다. SwitchUserMessageType도 다릅니다.

두 요청의 형식은 SwitchUserRequest에 의해 정의되고 응답 형식 (필요한 경우)은 SwitchUserResponse에 의해 정의됩니다. HAL (또는 Android 시스템)이 진행하는 방식은 아래에 정의된 대로 메시지 유형 (SwitchUserMessageType 매개변수로 정의됨)에 따라 다릅니다.
  • LEGACY_ANDROID_SWITCH 변경 요청이 HAL과 통합되지 않은 방식으로 이루어진 경우 (예: adb 셸 am switch-user를 통해) Android 사용자가 변경하려고 함을 나타내기 위해 Android 시스템에서 호출합니다. HAL은 이 요청을 수신한 후 내부 사용자를 전환할 수 있지만 Android 시스템에 다시 응답할 필요는 없습니다. 어떤 이유로든 내부 사용자를 변경할 수 없는 경우 SWITCH_USER(type=ANDROID_POST_SWITCH) 호출이 복구될 때까지 기다려야 합니다 (예: 이전 사용자로 다시 전환하기 위해 SWITCH_USER(type=VEHICLE_REQUEST)를 실행할 수 있음). 되돌아 전환하면 최종 사용자가 혼란스러워질 수 있으므로 실패하지 않는 것이 이상적입니다.
    예를 들어 시스템에 사용자 (0, 10, 11)가 있고 0에서 11로 전환하는 경우(사용자 중 특수 플래그가 없는 경우) 요청은 다음과 같습니다.
    • int32[0] 42 // 요청 ID
    • int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
    • int32[2] 11 // 대상 사용자 ID
    • int32[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 enum을 통해)를 사용하여 Android에 응답해야 합니다. 예를 들어 Android에 사용자 (0, 10, 11)가 있고 10에서 11로 전환하는 경우 (특수 플래그가 없는 경우) 요청은 다음과 같습니다.
    • int32[0] 42 // 요청 ID
    • int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
    • int32[2] 11 // 대상 사용자 ID
    • int32[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 // 세 번째 사용자 (사용자 11)
    • int32[12] 0 // 서드 파티 사용자 플래그 (없음)

    요청이 성공하면 HAL은 다음과 같이 속성을 업데이트해야 합니다.

    • int32[0] 42 // 요청 ID
    • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
    • int32[2] 1 // 상태: SwitchUserStatus::SUCCESS

    요청이 실패하면 응답은 다음과 같습니다.

    • int32[0] 42 // 요청 ID
    • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
    • int32[2] 2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"
    • OEM별 오류 메시지
  • VEHICLE_RESPONSE HAL에서 호출하여 ANDROID_SWITCH 유형의 요청을 계속할지 중단할지 나타냅니다. ANDROID_SWITCH도 참고하세요.
  • VEHICLE_REQUEST 현재 포그라운드 Android 사용자를 전환하도록 요청하기 위해 HAL에서 호출합니다. 이는 Android가 한 사용자로 시작했지만 차량에서 운전자를 다른 사용자로 식별한 경우에 유용합니다. 예를 들어 사용자 A가 사용자 B의 전자 키를 사용하여 자동차를 잠금 해제했습니다. INITIAL_USER_INFO 요청이 사용자 B를 반환했지만 얼굴 인식 하위 시스템에서 사용자를 A로 식별했습니다. HAL은 속성 변경 이벤트(음수 요청 ID 전달)를 통해 이 요청을 실행하고 Android 시스템은 동일한 요청 ID인 ANDROID_POST_SWITCH 호출을 실행하여 응답합니다. 예를 들어 현재 포그라운드 Android 사용자가 10이고 HAL에서 11로 전환하도록 요청한 경우 요청은 다음과 같습니다.
    • int32[0] -108 // 요청 ID
    • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
    • int32[2] 11 // Android 사용자 ID

    요청이 성공하고 Android에 사용자 (0, 10, 11)가 3명 있는 경우 응답은 다음과 같습니다.

    • int32[0] -108 // 요청 ID
    • int32[1] 5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCH
    • int32[2] 11 // 대상 사용자 ID
    • int32[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와 타겟 사용자 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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

TIRE_PRESSURE

타이어 공기압 각 타이어는 areaConfig.areaId 구성으로 식별됩니다. 각각의 minFloatValue 및 maxFloatValue는 OEM 권장 압력 범위를 저장하는 데 사용됩니다. VehicleAreaConfig의 minFloatValue 및 maxFloatValue 값을 정의해야 합니다.

areaConfig 데이터의 minFloatValue는 권장 타이어 공기압의 하한선을 나타냅니다. areaConfig 데이터의 maxFloatValue는 권장 타이어 공기압의 상한을 나타냅니다. 예를 들어 이 areaConfig는 left_front 타이어의 권장 타이어 공기압을 200.0kPa~240.0kPa로 나타냅니다.

.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }

변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 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
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13

TRACTION_CONTROL_ACTIVE

트랙션 컨트롤 (TC)이 활성화되면 true로 설정되고 TC가 꺼지면 false로 재설정됩니다. 이 속성은 TC 시스템의 실시간 상태에 따라 간헐적으로 설정 (펄스)될 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

TRAILER_PRESENT

자동차의 트레일러 상태를 반환합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: TrailerState
단위 유형: 해당 사항 없음
출시: Android 13

TURN_SIGNAL_STATE

차량의 방향 지시등입니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleTurnSignal
단위 유형: 해당 사항 없음
출시: Android 13

USER_IDENTIFICATION_ASSOCIATION

현재 사용자를 차량별 식별 메커니즘(예: 전자 키)과 연결하거나 연결을 쿼리하는 데 사용되는 속성입니다.

이 속성은 선택사항의 사용자 관리 속성입니다. OEM은 사용자 관리를 정의하지 않고도 계속 지원할 수 있습니다. 실제로 이 속성은 INITIAL_USER_INFO에서 설명하는 핵심 사용자 관련 기능을 지원하지 않고도 사용할 수 있습니다.

연결을 쿼리하기 위해 Android 시스템은 UserIdentificationGetRequest에 정의된 대로 쿼리되는 연결 유형이 포함된 VehiclePropValue를 전달하여 속성을 가져옵니다. HAL은 즉시 반환되어야 하며 UserIdentificationResponse와 함께 VehiclePropValue를 반환합니다.

시스템 부팅 중에 사용자 식별이 이루어졌습니다. VHAL 구현은 get 호출에서 새 연결을 시작하는 대신 이미 식별된 연결(예: 자동차 도어락을 여는 데 사용되는 키 FOB)만 반환해야 합니다.

유형을 연결하기 위해 Android 시스템은 UserIdentificationSetRequest에 정의된 대로 설정되는 연결의 유형과 값을 포함하는 VehiclePropValue를 전달하여 속성을 설정합니다.

그런 다음 HAL은 요청 후 유형의 현재 상태를 나타내는 속성 변경 이벤트 (VehiclePropValue가 UserIdentificationResponse에 의해 정의됨)를 사용합니다.

예를 들어 현재 사용자 (10)가 자동차를 잠금 해제한 FOB 및 OEM에서 제공한 맞춤 메커니즘과 연결되어 있는지 쿼리하려면 요청은 다음과 같습니다.

  • int32[0] 42 // 요청 ID
  • int32[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 // 요청 ID
  • int32[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)

그런 다음 사용자를 맞춤 메커니즘과 연결하기 위해 세트 요청이 실행됩니다.

  • int32[0] 43 // 요청 ID
  • int32[1] 10 (Android 사용자 ID)
  • int32[2] 0 (Android 사용자 플래그)
  • int32[3] 1 (설정 중인 연결 수)
  • int32[4] 101 (첫 번째 유형: UserIdentificationAssociationType::CUSTOM_1)

요청이 성공하면 다음과 같은 응답이 반환됩니다.

  • int32[0] 43 // 요청 ID
  • int32[1] 1 (응답의 연결 수)
  • int32[2] 101 (첫 번째 유형: UserIdentificationAssociationType::CUSTOM_1)
  • int32[3] 1 (첫 번째 값: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)

설정 요청은 연결을 추가하지만 기존 연결은 삭제하지 않습니다. 이전 예에서 최종 상태는 두 개의 연결 (FOB 및 CUSTOM_1)입니다. 사용자를 FOB가 아닌 CUSTOM_1하고만 연결하려면 요청은 다음과 같습니다.

  • int32[0] 43 // 요청 ID
  • int32[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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

VEHICLE_CURB_WEIGHT

차량의 공차중량(킬로그램)을 반환합니다. 공차중량은 승객이나 화물을 적재하지 않은 상태에서 표준 장비와 모터 오일, 변속기 오일, 브레이크액, 냉각수, 에어컨 냉매와 같은 모든 필수 운영 소모품, 공칭 탱크 용량의 연료 중량을 포함한 차량의 총중량입니다.

configArray[0] 은 차량의 총중량을 킬로그램으로 지정하는 데 사용됩니다. 차량의 총중량은 제조업체에서 지정한 차량의 최대 작동 중량으로, 차량의 섀시, 본체, 엔진, 엔진 유체, 연료, 액세서리, 운전자, 승객, 화물을 포함하며 트레일러의 무게는 제외됩니다.

변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14

VEHICLE_MAP_SERVICE

차량 지도 서비스 (VMS) 메시지 이 속성은 MIXED 데이터를 사용하여 VMS 메시지를 전달합니다. 콘텐츠는 다음과 같이 해석됩니다. VmsMessageIntegerValuesInde에 정의된 색인은 int32Values에서 읽는 데 사용됩니다. bytes는 VMS 프로토콜에 정의된 직렬화된 VMS 메시지로, 프레임워크에 불투명합니다. IVehicle#get은 항상 StatusCode::NOT_AVAILABLE를 반환해야 합니다.

변경 모드: ON_CHANGEREAD_WRITE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: 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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

VHAL_HEARTBEAT

VHAL이 자동차 워치독에 하트비트로 신호를 보내는 이벤트를 정의합니다. VHAL이 이 속성을 지원하는 경우 VHAL은 3초마다 이 속성에 시스템 가동 시간을 써야 합니다. 자동차 워치독은 이 속성을 구독하고 속성이 3초마다 업데이트되는지 확인합니다. 버퍼 시간 3초를 사용하면 자동차 워치독은 마지막 하트비트로부터 최대 6초 동안 하트비트 신호가 전송될 때까지 기다립니다. 그렇지 않으면 자동차 워치독은 VHAL을 비정상 상태로 간주하고 종료합니다. VHAL에서 이 속성을 지원하지 않으면 자동차 워치독이 VHAL 상태를 확인하지 않습니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

WATCHDOG_ALIVE

자동차 워치독이 활성 상태임을 나타내기 위해 업데이트하는 이벤트를 정의합니다. Car Watchdog은 3초마다 이 속성을 시스템 가동 시간(밀리초)으로 설정합니다. 부팅하는 동안 업데이트가 더 오래 걸릴 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: 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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

WHEEL_TICK

휠 틱을 보고합니다. 벡터의 첫 번째 요소는 재설정 횟수입니다. 재설정은 이전 틱 수가 현재 및 향후 틱 수와 비교할 수 없음을 나타냅니다. 틱 계산에 일종의 불연속성이 발생했습니다.

다음 네 요소는 다음 순서로 개별 휠의 틱을 나타냅니다.

  1. 왼쪽 앞
  2. 오른쪽 앞
  3. 오른쪽 뒤
  4. 왼쪽 뒤

모든 틱 수는 누적됩니다. 차량이 전진하면 틱 수가 증가하고 차량이 후진하면 틱 수가 감소합니다. 차량이 시작되면 틱이 0으로 재설정되어야 합니다.

  • int64Values[0] 횟수 재설정
  • int64Values[1] 왼쪽 전면 틱
  • int64Values[2] 오른쪽 전면 틱
  • int64Values[3] 오른쪽 뒤 틱
  • int64Values[4] 왼쪽 뒤 틱

configArray는 휠 틱당 마이크로미터 값과 지원되는 휠을 나타내는 데 사용되며 configArray는 다음과 같이 설정됩니다.

configArray[0], bits [0:3] Supported wheels

enum 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
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

WINDOW_LOCK

창문 아동 보호 잠금 장치 True는 창이 자녀 잠금 상태임을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

WINDOW_MOVE

창 이동 각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다. maxInt32Value는 창이 가장 빠른 속도로 평면에서 열리고 평면 외부 방향으로 닫히고 있음을 나타냅니다. minInt32Value는 창이 평면에서 닫히고/평면 외부 방향에서 가장 빠른 속도로 열리고 있음을 나타냅니다.

절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 창이 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. WINDOW_MOVE 값이 0이면 이동이 진행되지 않습니다. 이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.

평면 밖으로 열 수 있는 창 (선루프의 환기 모드)의 경우 이 매개변수는 다음과 같이 작동합니다. 다음과 같은 경우:

  • 선루프가 열려 있습니다.
    • Max 선루프를 더 열고 완전히 열리면 자동으로 중지합니다.
    • Min 선루프 닫기, 선루프가 닫히면 자동으로 중지
  • 통풍구가 열려 있음:
    • Max 환기구를 닫고 환기구가 닫히면 자동으로 멈춥니다.
    • Min 통풍구를 더 엽니다. 통풍구가 완전히 열리면 자동으로 중지됩니다.
  • 선루프가 닫혀 있습니다.
    • Max 선루프를 엽니다. 선루프가 완전히 열리면 자동으로 중지합니다.
    • Min 환기구를 열고 환기구가 완전히 열리면 자동으로 멈춥니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

WINDOW_POS

창 위치입니다. 각 VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. minInt32Value~maxInt32Value 사이의 모든 정수를 지원해야 합니다. minInt32Value는 창이 닫혀 있거나 평면 밖으로 완전히 열려 있음을 나타냅니다. 창을 평면 밖으로 열 수 없는 경우 minInt32Value는 완전히 닫혔을 때의 창 위치이며 0이어야 합니다. 창을 평면 외부로 열 수 있는 경우 minInt32Value는 창이 평면 외부 위치에서 완전히 열려 있음을 나타내며 음수 값입니다. 자세한 내용은 아래 예를 참고하세요. maxInt32Value는 창이 완전히 열려 있음을 나타냅니다.

minInt32ValuemaxInt32Value 사이의 값은 닫힌/완전히 열린 평면 외부와 완전히 열린 위치 사이의 전환 상태를 나타냅니다. 이 속성은 특정 단위가 아닌 지정된 상대 위치 범위에 있습니다. 예를 들어 평면 밖으로 이동할 수 있는 창의 경우 속성이 다음과 같이 작동합니다. 평면 밖으로 열 수 있는 창 (선루프의 통풍구 모드)의 경우 이 매개변수는 다음과 같이 음수 값으로 작동합니다.

  • Max 선루프 완전히 열림 (선루프 닫힘: 0).
  • Min 선루프 통풍구가 완전히 열려 있음 (선루프가 닫혀 있으면 0).
이 모드에서 0은 창이 닫혀 있음을 나타냅니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13

WINDSHIELD_WIPERS_PERIOD

앞유리 와이퍼 주기 (밀리초)입니다. 앞 유리 와이퍼의 한 전체 주기의 순간적인 시간을 밀리초 단위로 반환합니다. 전체 주기는 와이퍼가 움직였다가 다시 정지 위치로 돌아오는 것으로 정의됩니다. 간헐적 와이퍼 설정이 선택된 경우 간헐적 와이퍼의 일시중지 기간 동안 이 속성 값을 0으로 설정해야 합니다. VehicleAreaConfig의 maxInt32ValueminInt32Value를 정의해야 합니다. 각 영역 ID의 maxInt32Value는 가장 긴 와이퍼 기간을 지정해야 합니다. minInt32Value는 각 영역 ID에 대해 0으로 설정해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 14

WINDSHIELD_WIPERS_STATE

와이퍼 상태입니다. 와이퍼의 현재 상태를 반환합니다. WINDSHIELD_WIPERS_STATE의 값이 WINDSHIELD_WIPERS_SWITCH(예: WINDSHIELD_WIPERS_STATE: ONWINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO)의 값과 일치하지 않을 수도 있습니다. WINDSHIELD_WIPERS_STATE: ONWINDSHIELD_WIPERS_PERIOD가 구현되면 WINDSHIELD_WIPERS_PERIOD는 와이퍼의 한 전체 주기 기간을 반영해야 합니다.

WindshieldWipersState의 모든 상태가 지원되지 않는 한 (권장되지 않는 OTHER 포함) 지원되는 각 영역 ID의 경우 VehicleAreaConfig#supportedEnumValues 배열을 정의해야 합니다.

변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: WindshieldWipersState
단위 유형: 해당 사항 없음
출시: Android 14

WINDSHIELD_WIPERS_SWITCH

와이퍼 스위치입니다. 앞유리 와이퍼를 제어하는 스위치의 위치를 나타냅니다. WINDSHIELD_WIPERS_SWITCH의 값은 WINDSHIELD_WIPERS_STATE의 값과 일치하지 않을 수도 있습니다(예: WINDSHIELD_WIPERS_SWITCH: AUTOWINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON). 지원되는 각 영역 ID의 경우 WindshieldWipersSwitch의 모든 상태가 지원되지 않는 한(권장하지 않는 OTHER 포함) VehicleAreaConfig#supportedEnumValues 배열을 정의해야 합니다.

이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다. 이 속성이 VehiclePropertyAccess.READ_WRITE로 구현되고 OTHER 상태가 VehicleAreaConfig#supportedEnumValues 배열에 나열된 경우 OTHER는 쓰기에 지원되는 값이 아닙니다. 이는 읽기용으로만 지원되는 값입니다.

변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: WindshieldWipersSwitch
단위 유형: 해당 사항 없음
출시: Android 14