Chính sách về nguồn

Để đảm bảo các thành phần phần cứng và phần mềm (chẳng hạn như màn hình, âm thanh và tương tác bằng giọng nói) được bật và tắt có chọn lọc khi cần, AAOS cung cấp một chính sách về nguồn điện, bao gồm một tập hợp các trạng thái bật và tắt nguồn dự kiến cho các thành phần phần cứng và phần mềm. VHAL hoặc các dịch vụ của nhà cung cấp có đặc quyền hệ thống có thể áp dụng một chính sách nguồn mới khi trạng thái nguồn của Android chuyển đổi hoặc khi các điều kiện mà chúng đang chờ đợi được đáp ứng.

Bạn được phép áp dụng chính sách về nguồn điện ở các trạng thái Chờ VHAL, Bật và Chuẩn bị trước khi tắt (đôi khi có một số hạn chế). Không giống như Wait for VHAL và On, bạn không thể định cấu hình chính sách nguồn mặc định cho Pre Shutdown Prepare trong một nhóm chính sách nguồn. Trong giai đoạn Chuẩn bị tắt cốt lõi, Chế độ nhà để xe đang chạy và không bị ảnh hưởng bởi sự thay đổi trạng thái nguồn. Mặc dù không thể áp dụng chính sách nguồn thông thường, nhưng một chính sách nguồn đặc biệt (chính sách nguồn hệ thống có tên là không có sự tương tác của người dùng) sẽ được áp dụng trong giai đoạn Chuẩn bị tắt cốt lõi.

Trạng thái nguồn của AAOS

Các thiết bị AAOS tuân theo sơ đồ trạng thái nguồn sau:

Hình 1. Sơ đồ trạng thái nguồn của AAOS.

Dưới đây là nội dung mô tả từng trạng thái nguồn:

Chính sách về nguồn điện được xác định như thế nào?

Người triển khai xác định các chính sách về nguồn điện trong /vendor/etc/automotive/power_policy.xml, trong đó:

• Xác định chính sách về nguồn điện.
• Xác định các nhóm chính sách nguồn, bao gồm chính sách nguồn mặc định và tự động áp dụng khi trạng thái nguồn chuyển đổi.
• Ghi đè chính sách nguồn của hệ thống.

Chính sách về nguồn điện

Chính sách về nguồn điện bao gồm một tập hợp các trạng thái nguồn điện dự kiến của các thành phần phần cứng và phần mềm. AAOS hỗ trợ các thành phần sau trong chính sách nguồn:

Nhà cung cấp cũng có thể xác định các thành phần nguồn tuỳ chỉnh của riêng họ để sử dụng với các chính sách về nguồn. Xác định các thành phần nguồn tuỳ chỉnh trong cùng một tệp XML với các chính sách về nguồn, như trong ví dụ này:

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

Nhóm chính sách về nguồn

Nhóm chính sách về nguồn điện chỉ định chính sách mặc định về nguồn điện để tự động áp dụng khi chuyển đổi trạng thái nguồn điện. Nhà cung cấp có thể xác định chính sách nguồn mặc định cho Wait for VHAL và On.

Chính sách về nguồn điện của hệ thống

AAOS hỗ trợ 2 chính sách nguồn hệ thống là không có hoạt động tương tác của người dùng và chuẩn bị tạm ngưng. Chính sách nguồn hệ thống được áp dụng khi thiết bị chuyển sang Chế độ im lặng, Chế độ nhà để xe, Tạm ngưng vào RAM hoặc Tạm ngưng vào ổ đĩa.

Các bảng sau đây liệt kê hành vi của từng thành phần trong chính sách nguồn của hệ thống. Người triển khai có thể ghi đè Bluetooth, NFC và tính năng phát hiện Thiết bị tin cậy trong chính sách nguồn hệ thống không có sự tương tác của người dùng. Các chế độ ghi đè được áp dụng trong /vendor/etc/automotive/power_policy.xml.

không có hoạt động tương tác của người dùng

Hành vi của chính sách nguồn hệ thống không có hoạt động tương tác của người dùng được xác định trong bảng này:

tạm ngưng prep

Hành vi của chính sách nguồn hệ thống chuẩn bị tạm ngưng được xác định trong bảng này:

Tương tác với VHAL

Trình nền chính sách nguồn điện của ô tô chạy trong lớp hệ thống đăng ký 2 thuộc tính để theo dõi các yêu cầu từ VHAL:

• POWER_POLICY_REQ VHAL ghi mã chính sách về nguồn vào thuộc tính này.
• POWER_POLICY_GROUP_REQ VHAL ghi mã nhóm chính sách về nguồn vào thuộc tính này.

Các mô-đun khác ngoài VHAL có thể thay đổi chính sách nguồn hiện tại trong hệ thống. Trong trường hợp đó, trình nền chính sách nguồn điện của ô tô sẽ cập nhật thuộc tính CURRENT_POWER_POLICY để thông báo về thay đổi cho VHAL.

Tương tác với các quy trình gốc

CarPowerManagementService (CPMS) uỷ quyền quản lý chính sách nguồn cho trình nền chính sách nguồn của ô tô. Trình nền là nguồn đáng tin cậy duy nhất cho các chính sách về nguồn trong hệ thống. Trình nền chính sách nguồn điện của ô tô quản lý trạng thái chính sách nguồn điện và thông báo cho CPMS, VHAL và các ứng dụng gốc khác về những thay đổi.

Trình nền chính sách nguồn điện của ô tô xuất các giao diện AIDL để HAL và các quy trình gốc khác sử dụng. Họ có thể nhận được thông báo khi có chính sách nguồn mới được thay đổi. Nói cách khác, khi mỗi thiết bị phải thay đổi trạng thái nguồn.

ICarPowerPolicyServer.aidl

  package android.frameworks.automotive.powerpolicy;

  import android.frameworks.automotive.powerpolicy.CarPowerPolicy;
  import android.frameworks.automotive.powerpolicy.CarPowerPolicyFilter;
  import android.frameworks.automotive.powerpolicy.ICarPowerPolicyChangeCallback;
  import android.frameworks.automotive.powerpolicy.PowerComponent;

  /**
   * ICarPowerPolicyServer is an interface implemented by the power policy daemon.
   * VHAL changes the power policy and the power policy daemon notifies the change to
   * registered subscribers. When subscribing to policy changes, a filter can be specified so
   * that the registered callbacks can listen only to a specific power component's change.
   */

  @VintfStability
  interface ICarPowerPolicyServer {
    /**
     * Gets the current power policy.
     * @throws IllegalStateException if the current policy is not set.
     */
    CarPowerPolicy getCurrentPowerPolicy();

    /**
     * Gets whether the power component is turned on or off.
     *
     * @param componentId Power component ID defined in PowerComponent.aidl to check power
     * state.
     * @return True if the component's power state is on.
     * @throws IllegalArgumentException if the componentId is invalid.
     */
    boolean getPowerComponentState(in PowerComponent componentId);

    /**
     * Subscribes to power policy change.
     * Notification is sent to the registered callback when the power policy changes and the
     * power state of the components which the callback is interested in changes.
     *
     * @param callback Callback that is invoked when the power policy changes.
     * @param filter The list of components which the callback is interested in.
     * @throws IllegalArgumentException if the callback is already registered.
     * @throws IllegalStateException if the callback is dead.
     */
    void registerPowerPolicyChangeCallback(in ICarPowerPolicyChangeCallback callback,
        in CarPowerPolicyFilter filter);

    /**
     * Unsubscribes from power policy change.
     *
     * @param callback Callback that doesn't want to receive power policy change.
     * @throws IllegalArgumentException if the callback is not registered.
     */
    void unregisterPowerPolicyChangeCallback(in ICarPowerPolicyChangeCallback callback);

    /**
     * Applies the power policy.
     *
     * 
{@code policyId} should be one of power policy IDs defined in
     * {@code /vendor/etc/automotive/power_policy.xml} or predefined system power policies.
     *
     * @param policyId ID of power policy.
     * @throws IllegalArgumentException if {@code policyId} is invalid.
     */
    void applyPowerPolicy(in @utf8InCpp String policyId);

    /**
     * Sets the current power policy group.
     *
     * 
{@code policyGroupId} should be one of power policy group IDs defined in
     * {@code /vendor/etc/automotive/power_policy.xml}.
     *
     * @param policyGroupId ID of power policy group.
     * @throws IllegalArgumentException if {@code policyGroupId} is invalid.
     */
    void setPowerPolicyGroup(in @utf8InCpp String policyGroupId);
  }

ICarPowerPolicyChangeCallback.aidl

  package android.frameworks.automotive.powerpolicy;

  import android.frameworks.automotive.powerpolicy.CarPowerPolicy;

  /**
   * ICarPowerPolicyChangeCallback is notified when a power policy changes.
   */

  @VintfStability
  oneway interface ICarPowerPolicyChangeCallback {
    /**
     * Called when a power policy is fully changed.
     *
     * @param policy The current policy.
     */
    void onPolicyChanged(in CarPowerPolicy policy);
  }

Tương tác với các mô-đun Java

CarPowerManager cung cấp các phương thức để bật tính năng quản lý chính sách nguồn:

• Lấy chính sách nguồn hiện tại
• Áp dụng chính sách nguồn mới
• Thiết lập nhóm chính sách nguồn mới

Chỉ các mô-đun có đặc quyền hệ thống mới có thể sử dụng các phương thức này. Những mô-đun muốn được thông báo khi một chính sách về nguồn điện được áp dụng có thể đăng ký trình nghe thay đổi chính sách về nguồn điện thành CarPowerManager