Mengonfigurasi sumber waktu AAOS

Fitur ini memungkinkan partner memilih cara menyinkronkan waktu, baik dari Android Automotive Operating System (AAOS) atau dari sistem kendaraan ke Android. Untuk memastikan implementasi yang berkualitas, Anda dapat mengonfigurasi AAOS untuk menggunakan salah satu dari dua properti VHAL baru yang dijelaskan di bawah untuk menyebarkan nilai secara efektif. Gunakan:

  • ANDROID_EPOCH_TIME untuk menggunakan Android sebagai sumber kebenaran untuk waktu. VHAL mendukung properti hanya tulis ini, yang mengomunikasikan perubahan waktu dari Android ke sistem kendaraan lainnya, seperti Electronic Control Unit (ECU) dan Body Control Module (BCM).
  • EXTERNAL_CAR_TIME untuk tidak menggunakan Android sebagai sumber kebenaran untuk waktu. Dalam hal ini, VHAL mendukung properti EXTERNAL_CAR_TIME hanya baca, yang menyampaikan perubahan waktu dari sistem kendaraan lainnya (seperti ECU dan BCM) ke Android.

AAOS juga menyediakan TimeDetectorStrategy yang dapat dikonfigurasi untuk membantu Anda memprioritaskan berbagai sumber waktu dalam Android.

Android adalah sumber tepercaya untuk waktu

Saat Android digunakan sebagai sumber waktu, OEM dapat menyinkronkan sistem mobil lainnya (termasuk ECU dan BCM) dengan waktu Android.

Untuk melakukannya, implementasi VHAL harus mendukung properti ANDROID_EPOCH_TIME properti hanya tulis. Android memublikasikan update ke properti dengan membaca waktu sistem, baik pada waktu booting maupun setiap kali sumber waktu di Android diubah.

Android bukan sumber tepercaya untuk waktu

Jika Android tidak digunakan sebagai sumber waktu, Anda dapat menyinkronkan waktu Android menjadi sumber tepercaya untuk waktu (misalnya, dengan ECU atau BCM). Dalam hal ini, implementasi VHAL harus mendukung properti hanya baca EXTERNAL_CAR_TIME dan memublikasikan update ke properti ini setiap kali sumber waktu berubah atau melakukan kalibrasi ulang jam.

OEM juga harus memastikan bahwa:

  • Nilai config_autoTimeSourcesPriority terdapat dalam core/res/res/values/config.xml.
  • Properti config_enableExternalCarTimeToExternalTimeSuggestion di konfigurasi overlay CarServices packages/services/Car/service/res/values/config.xml disetel ke true.
  • Waktu external memiliki prioritas yang sesuai dalam konfigurasi TimeDetectorStrategy. Untuk mempelajari lebih lanjut, lihat Deteksi Waktu GNSS. Contoh: 
    <!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list take precedence over lower ones.
See com.android.server.timedetector.TimeDetectorStrategy for available sources. -->
     <string-array name="config_autoTimeSourcesPriority">
        <item>external</item>
        <item>gnss</item>
        <item>network</item>
        <item>telephony</item>
    </string-array>

Detail implementasi internal Android

Alur berikut terjadi saat properti VHAL ANDROID_EPOCH_TIME didukung:

  1. TimeHalService (di CarServices) menerima siaran dari sistem Android untuk Intent.ACTION_TIME_CHANGED.
  2. TimeHalService memublikasikan update ke Properti VHAL ANDROID_EPOCH_TIME.
  3. VHAL dapat menyebarkan nilai waktu yang diterima ke berbagai ECU dan/atau unit BCM.

Alur berikut terjadi saat properti VHAL EXTERNAL_CAR_TIME didukung:

  1. VHAL memperbarui properti EXTERNAL_CAR_TIME.
  2. TimeHalService (di CarServices) membaca properti melalui langganan.
  3. TimeHalService membuat dan mengirim ExternalTimeSuggestion ke TimeManager.
  4. TimeManager meneruskan saran ke TimeDetectorService.
  5. TimeDetectorService menggunakan TimeDetectorStrategy untuk memilih waktu sistem baru.