Thuộc tính đặc biệt

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Thuộc tính của nhà cung cấp

Để hỗ trợ các nhu cầu dành riêng cho đối tác, VHAL cho phép các thuộc tính của nhà cung cấp chỉ được truy cập thông qua API hệ thống. Hãy làm theo các nguyên tắc sau khi làm việc với thuộc tính của nhà cung cấp:

• Luôn cố gắng sử dụng các thuộc tính hệ thống trước tiên, các thuộc tính của nhà cung cấp nên được sử dụng như một phương án cuối cùng khi không có thuộc tính hệ thống nào đáp ứng yêu cầu của bạn.
• Để ngăn tình trạng phân mảnh hệ sinh thái, bạn không được sử dụng các thuộc tính của nhà cung cấp để sao chép các thuộc tính xe đã tồn tại trong VehiclePropertyIds của SDK. Để tìm hiểu thêm, hãy xem Phần 2.5, Yêu cầu về ô tô trong CDD.
• Sử dụng các trường sau để tạo Mã tài sản:
  • Nhóm VehiclePropertyGroup:VENDOR VENDOR chỉ được dùng cho các tài sản của nhà cung cấp.
  • VehicleArea Chọn một Loại khu vực phù hợp.
  • VehiclePropertyType Chọn loại dữ liệu phù hợp. Loại BYTES cho phép truyền dữ liệu thô, như vậy là đủ trong hầu hết trường hợp. Việc thường xuyên gửi dữ liệu lớn thông qua các tài sản của nhà cung cấp có thể làm chậm toàn bộ quyền truy cập mạng của xe. Hãy cẩn thận khi thêm một tải trọng lớn.
  • Property ID Chọn mã nhận dạng hai byte duy nhất cho tài sản của nhà cung cấp. Ví dụ: 0x1234.
• Điền nội dung mô tả ngắn về nhà cung cấp vào VehiclePropConfig.configString thuộc tính này. Điều này cho phép các công cụ kiểm tra tính hợp lệ gắn cờ trường hợp vô tình sao chép các thuộc tính xe hiện có. Ví dụ: "Tài sản tuỳ chỉnh của tôi cho XYZ".
• Truy cập thông qua CarPropertyManager (đối với các thành phần Java) hoặc thông qua libvhalclient (đối với các thành phần gốc). Đừng sửa đổi các API ô tô khác vì việc này có thể dẫn đến các vấn đề về khả năng tương thích trong tương lai.

Quyền đối với tài sản của nhà cung cấp

Quyền mặc định cho mọi thuộc tính nhà cung cấp được xác định là android.car.Car.PERMISSION_VENDOR_EXTENSION. Để kiểm soát quyền chi tiết hơn, hãy hỗ trợ thuộc tính SUPPORT_CUSTOMIZE_VENDOR_PERMISSION. Thuộc tính STATIC này chỉ có thể đọc, trong đó mảng cấu hình chỉ định các quyền cho thuộc tính của nhà cung cấp. configArray được thiết lập như sau (i là số nguyên bắt đầu từ 0):

• configArray[3 * i] propId, mã tài sản của tài sản của nhà cung cấp.
• configArray[3 * i + 1] Một enum trong VehicleVendorPermission.aidl đến cho biết quyền đọc giá trị thuộc tính.
• configArray[3 * i + 2] Một enum trong VehicleVendorPermission.aidl đến cho biết quyền ghi giá trị thuộc tính.

Ví dụ: mảng cấu hình sau đây định cấu hình 2 thuộc tính của nhà cung cấp, vendor_prop_1 và vendor_prop_2 để có các quyền:

• vendor_prop_1 yêu cầu android.car.hardware.property.VehicleVendorPermission.PERMISSION_GET_CAR_VENDOR_CATEGORY_SEAT để đọc và android.car.hardware.property.VehicleVendorPermission.PERMISSION_SET_CAR_VENDOR_CATEGORY_SEAT để ghi.
• vendor_prop-2 yêu cầu android.car.hardware.property.VehicleVendorPermission.PERMISSION_GET_CAR_VENDOR_CATEGORY_INFO để đọc và không thể ghi được cho các ứng dụng Android.

configArray = {
  PERMISSION_SET_VENDOR_CATEGORY_SEAT
    vendor_prop_2, PERMISSION_GET_VENDOR_CATEGORY_INFO, PERMISSION_NOT_ACCESSIBLE
}

Các thuộc tính của nhà cung cấp không có trong mảng này sẽ sử dụng quyền mặc định của nhà cung cấp. Thời gian Bạn đã chọn PERMISSION_NOT_ACCESSIBLE, các ứng dụng Android không thể truy cập vào thuộc tính này. Trong ví dụ, các ứng dụng Android không thể ghi giá trị cho vendor_prop_2. Chỉ ứng dụng VHAL gốc mới có thể ghi vào thuộc tính này.

Hệ thống hỗ trợ người lái nâng cao (ADAS)

GHẾ NGỒI và THÔI ĐÔI

Xem phần Thuộc tính ghế và vô lăng.

HVAC (Hệ thống sưởi, thông gió và điều hoà)

Bạn có thể sử dụng VHAL để kiểm soát hệ thống điều hòa không khí bằng cách đặt các thuộc tính liên quan đến hệ thống điều hòa không khí. Hầu hết các khu vực cho hệ thống sưởi, thông gió và điều hoà được liên kết với các khu vực cụ thể trong xe, mặc dù một số khu vực là thuộc tính toàn cầu. Các thuộc tính mẫu được xác định bao gồm:

Đối với các thuộc tính HVAC phụ thuộc vào trạng thái nguồn của hệ thống sưởi, thông gió và điều hoà, chúng phải: được liệt kê trong mảng cấu hình HVAC_POWER_ON. Để xem danh sách đầy đủ các thuộc tính HVAC, hãy tìm HVAC_* trong VehicleProperty.aidl, xem Các thuộc tính hệ thống được hỗ trợ. thuộc tính.

Quy tắc để liên kết các thuộc tính HVAC (Hệ thống sưởi, thông gió và điều hoà) không thuộc loại KHÔI TOÀN TOÀN CẦU với AreaID: Mọi “khu vực” của một loại VehicleArea cụ thể chịu ảnh hưởng của cơ sở lưu trú đó đều phải có trong mã khu vực của cơ sở lưu trú đó. Bộ điều khiển nhiệt độ được chỉ định cho những chỗ ngồi mà chúng "có ảnh hưởng nhiều nhất", nhưng mỗi chỗ ngồi bị ảnh hưởng phải được đưa vào đúng một lần. Việc chỉ định ghế sau giữa cho AreaID bên trái hoặc bên phải có vẻ như tuỳ ý, nhưng việc đưa mọi ghế bị ảnh hưởng vào đúng một AreaID sẽ đảm bảo rằng tất cả các ghế trong ô tô đều được thể hiện và có một cách hợp lý để ảnh hưởng đến từng ghế.

Ví dụ 1

Một chiếc ô tô có hai ghế trước (ROW_1_LEFT, ROW_1_RIGHT) và ba ghế sau (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Có hai thiết bị điều khiển nhiệt độ, mỗi thiết bị cho một thiết bị phía ghế lái và phía ghế phụ. Một tập hợp lập bản đồ AreaID hợp lệ cho HVAC_TEMPERATURE_SET sẽ là một mảng hai phần tử:

• ROW_1_LEFT | ROW_2_LEFT
• ROW_1_RIGHT | ROW_2_CENTER | Hàm ROW_2_RIGHT

Một mục ánh xạ thay thế cho cùng một cấu hình phần cứng sẽ là:

• ROW_1_LEFT | ROW_2_CENTER | ROW_2_LEFT
• ROW_1_RIGHT | ROW_2_RIGHT

Ví dụ 2

Một chiếc ô tô có 3 hàng ghế với 2 ghế ở hàng trước (ROW_1_LEFT, ROW_1_RIGHT) và 3 ghế ở hàng thứ hai (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) và hàng thứ ba (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT). Có ba thiết bị điều khiển nhiệt độ, mỗi thiết bị cho một thiết bị phía ghế lái, phía ghế phụ và phía sau. Cách lập bản đồ hợp lý HVAC_TEMPERATURE_SET so với AreaID là một mảng 3 phần tử:

• ROW_1_LEFT
• ROW_1_RIGHT
• ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | Hàm ROW_3_RIGHT

Ví dụ 3

Một chiếc ô tô có hai ghế trước (ROW_1_LEFT, ROW_1_RIGHT) và ba ghế sau (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Giả sử ô tô chỉ hỗ trợ HVAC_AUTO_ON cho hai ghế trước. Một tập hợp lập bản đồ AreaID hợp lệ cho HVAC_auto_ON sẽ là một mảng phần tử:

• ROW_1_LEFT | ROW_1_RIGHT

Nếu HVAC_AUTO_ON có hai đơn vị điều khiển riêng biệt cho phía người lái và phía người ngồi, thì ánh xạ thay thế sẽ là một mảng gồm hai phần tử:

• ROW_1_LEFT
• ROW_1_RIGHT

INFO_EXTERIOR_DIMENSIONS

Kích thước bên ngoài của xe được đo bằng milimét, như minh hoạ trong Hình 1.

Sử dụng các thuộc tính được mô tả trong bảng này để xác định kích thước bên ngoài của xe.

Tuân thủ quy định chung về an toàn của Liên minh Châu Âu

Xe có phải tuân thủ các yêu cầu của Quy định chung về an toàn (GSR) của Liên minh Châu Âu hay không thông qua Android, thuộc tính GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT phải được hỗ trợ. Một ví dụ về trường hợp sử dụng là GSR-ISA (Hỗ trợ tốc độ thông minh) theo định nghĩa tại Liên minh Châu Âu Quy định 2019/2144. Thuộc tính này được thêm vào AIDL VHAL từ Android 13, tuy nhiên, thuộc tính này được hỗ trợ trong Dịch vụ ô tô kể từ bản phát hành Android 12. Thuộc tính này được xác định là chỉ có quyền đọc thuộc tính số nguyên tĩnh toàn cục, với các giá trị có thể được xác định bởi Enum GsrComplianceRequirementType:

Để hỗ trợ thuộc tính này trong HIDL VHAL (trong Android 12), nhà cung cấp phải mã hoá cứng mã nhận dạng thuộc tính. Ví dụ: đoạn mã sau đây cho thấy cách hỗ trợ điều này trong tài liệu tham khảo HIDL VHAL DefaultConfig.h:

{
  .config =
      {
          // GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
          .prop = 0x11400F47,
          .access = VehiclePropertyAccess::READ,
          .changeMode = VehiclePropertyChangeMode::STATIC,
      },
  // GsrComplianceRequirementType::GSR_COMPLIANCE_REQUIRED_V1
  .initialValue = {.int32Values = {1}},
}

Để hỗ trợ thuộc tính này trong AIDL VHAL (từ Android 13), nhà cung cấp có thể sử dụng mã nhận dạng thuộc tính từ VehicleProperty.h và enum từ GsrComplianceRequirementType.h. Để ví dụ: như trong tài liệu tham khảo AIDL VHAL DefaultProperties.json:

{
  "property": "VehicleProperty::GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT",
  "defaultValue": {
    "int32Values": [
      "GsrComplianceRequirementType::GSR_COMPLIANCE_REQUIRED_V1"
    ]
  }
}

Để đọc thuộc tính này từ một ứng dụng Android, hãy sử dụng CarPropertyManager.getIntProperty.

• Trên Android 13 trở lên, hãy sử dụng VehiclePropertyIds.GENERAL_SAFETY_REGULATION_COMPLIANCE làm mã tài sản.
• Trong Android 12, hãy sử dụng giá trị được mã hoá cứng là 0x11400F47 làm mã nhận dạng thuộc tính. Thuộc tính này yêu cầu quyền Car#PERMISSION_CAR_INFO.