Deteksi waktu otomatis

Deteksi waktu otomatis menerima saran waktu dari berbagai sumber, memilih opsi terbaik, lalu menyetel jam sistem di Android agar sesuai. Rilis Android sebelumnya menyediakan dua cara untuk menyetel tanggal dan waktu, baik yang disetel secara manual per pengguna atau dengan deteksi waktu otomatis, dan disetel oleh salah satu opsi berikut:

  • telephony menggunakan sinyal teleponi Network Identity and Time Zone (NITZ).
  • network menggunakan server waktu Network Time Protocol (NTP).

Setiap opsi memerlukan koneksi ke jaringan eksternal, yang tidak selalu tersedia di Android Automotive. Misalnya, di beberapa negara, beberapa mobil mungkin tidak memiliki teleponi bawaan. Oleh karena itu, waktu Global Satellite Navigation Systems (GNSS) disediakan sebagai sumber waktu sistem untuk Anda gunakan saat konektivitas jaringan tidak tersedia.

Rilis Android mendatang ini menyediakan dua opsi lagi untuk mendeteksi dan menyetel waktu secara otomatis:

  • gnss menggunakan Global Satellite Navigation Systems (GNSS).
  • external menggunakan properti VHAL atau System API.

Mengaktifkan deteksi waktu otomatis

Untuk mengaktifkan deteksi waktu otomatis, pastikan untuk memilih Setelan > Tanggal & Waktu > Tanggal & Waktu Otomatis:

Gambar 1. Pilih Tanggal &Waktu Otomatis

Mengonfigurasi sumber waktu

Untuk menentukan sumber waktu yang akan disertakan dalam deteksi waktu otomatis, dan prioritas sumber waktu ini harus dipertimbangkan, Anda harus mengubah file konfigurasi resource perangkat, core/res/res/values/config.xml:

<!-- 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>telephony</item>
    <item>network</item>
</string-array>

Dalam contoh ini, telephony dan network dipertimbangkan dalam deteksi waktu otomatis dan saran waktu telephony diprioritaskan sebelum saran waktu network.

Secara umum, saran dari sumber prioritas yang lebih tinggi akan diabaikan jika saran tersebut tidak valid atau jika saran tersebut terlalu lama. Selain itu, jika saran valid dengan prioritas tertinggi cocok dengan waktu jam sistem perangkat saat ini dalam beberapa detik (nilai defaultnya adalah dua (2) detik), waktu tidak akan diubah.

Batas waktu bawah

Android 12 menyediakan batas waktu bawah baru untuk digunakan saat memvalidasi saran waktu. Sebelum fitur ini, deteksi waktu otomatis tidak akan memvalidasi waktu UTC masuk yang disarankan. Dengan fitur ini, waktu yang berlalu sebelum batas bawah akan dihapus.

Nilai batas bawah ditentukan dari tanggal yang berasal dari stempel waktu build. Hal ini berfungsi berdasarkan prinsip bahwa waktu yang valid tidak dapat terjadi sebelum image sistem dibuat. Android tidak menerapkan batas atas.

Saran waktu GNSS

Sumber waktu gnss baru di Android 12 dan disediakan oleh sinyal GPS. Ini adalah sumber waktu yang andal saat telephony dan network tidak tersedia. Opsi ini ditambahkan ke GnssTimeUpdateService baru di SystemServer yang secara pasif memproses update lokasi. Saat lokasi yang valid diterima, GnssTimeUpdateService akan memberikan saran ke TimeDetectorService, yang kemudian menentukan apakah jam sistem harus diperbarui.

Secara default, sumber waktu gnss tidak diaktifkan di AOSP dan, oleh karena itu, harus diaktifkan oleh partner:

<!-- 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>telephony</item>
    <item>network</item>
    <item>gnss</item>
</string-array>

<!-- Enables the GnssTimeUpdate service. This is the global switch for enabling Gnss time based
    suggestions to TimeDetector service. See also config_autoTimeSourcesPriority. -->
<bool name="config_enableGnssTimeUpdateService">true</bool>

Untuk mengaktifkan fitur ini:

  1. Perbarui config_enableGnssTimeUpdateService. Nilai untuk config_enableGnssTimeUpdateService harus ditetapkan ke true.
  2. Perbarui config_autoTimeSourcesPriority. gnss harus ditambahkan ke daftar item untuk config_autoTimeSourcesPriority. Posisi gnss dalam daftar prioritas menentukan prioritas yang diberikan ke saran GNSS, sehubungan dengan nilai dari sumber lain.

Dampak pada daya

GnssTimeUpdateService secara pasif memproses update lokasi, yang berarti bahwa layanan ini tidak pernah secara aktif mengaktifkan GPS untuk menggunakan daya tambahan. Akibatnya, daya yang digunakan saat sumber GNSS diaktifkan dapat diabaikan. Hal ini juga berarti bahwa kecuali jika aplikasi atau layanan lain dalam sistem secara aktif meminta update lokasi, GnssTimeUpdateService tidak akan mendapatkan update lokasi dan menyarankan waktu GNSS.

Pengujian

Compatibility Test Suite (CTS)

Pengujian CTS disediakan untuk memverifikasi bahwa waktu yang disediakan GNSS tersedia. Untuk mengetahui detailnya, lihat LocationShellCommand.java.

Pengujian unit

Lihat pengujian unit dasar dalam file berikut:

atest frameworks/base/services/tests/servicestests/src/com/android/server/timedetector/GnssTimeUpdateServiceTest.java

Pengujian manual

Untuk menguji fitur ini, perintah baru telah ditambahkan ke LocationShellCommand.java. Gunakan perintah ini untuk menambahkan penyedia pengujian yang dapat Anda gunakan untuk menentukan lokasi dan waktu GNSS terkait. GnssTimeUpdateService memproses update lokasi ini, dan secara berkala memberikan saran.

Catatan: Antarmuka untuk perintah ini dapat berubah antar-rilis. 

# Enable Master Location Switch in the foreground user (usually user 10 on automotive).
# If you just flashed, this can be done through Setup Wizard.
adb shell cmd location set-location-enabled true --user 10

# Add GPS test provider (this usually fails the first time and will throw a SecurityException
# with "android from <some-uid> not allowed to perform MOCK_LOCATION".)
adb shell cmd location providers add-test-provider gps

# Enable mock location permissions for previous UID
adb shell appops set <uid printed in previous error> android:mock_location allow

# Add GPS test provider (Should work with no errors.)
adb shell cmd location providers add-test-provider gps

# Enable GPS test provider
adb shell cmd location providers set-test-provider-enabled gps true

# Set location with time (time can't be earlier than the limit set by the lower bound.)
adb shell cmd location providers set-test-provider-location gps --location <LATITUDE>,<LONGITUDE> --time <TIME>

Saran waktu eksternal

Saran waktu eksternal adalah cara lain untuk memberikan saran waktu otomatis ke Android. Opsi baru ini memungkinkan Anda memberikan saran waktu yang sepenuhnya disesuaikan ke Android, yang dapat berasal dari berbagai ECU yang, pada gilirannya, dapat menggunakan kombinasi jam real-time, GNSS, NITZ, atau sumber waktu lainnya.

Saran berikut tersedia di Android 12 untuk dipertimbangkan sebagai external saran waktu:

  • Properti VHAL. Properti VHAL baru bernama EPOCH_TIME disediakan. Properti ini menunjukkan jumlah milidetik yang telah berlalu sejak 1/1/1970 UTC. Nilainya dapat diteruskan ke Android TimeManager untuk menyarankan waktu sistem baru. Contoh implementasi VHAL yang memperbarui properti ini disediakan di halaman implementasi referensi.
  • System API. Metode baru bernama suggestExternalTime() tersedia di TimeManager untuk memberikan saran waktu eksternal ke sistem. Jika sistem dikonfigurasi untuk mempertimbangkan saran waktu eksternal (menggunakan config_autoTimeSourcesPriority dalam file konfigurasi), stempel waktu yang diteruskan ke metode ini akan digunakan untuk menyetel waktu sistem, jika tidak ada saran waktu prioritas yang lebih tinggi.

Anda dapat menerapkan solusi waktu eksternal seperti yang dijelaskan di bawah:

  1. Perbarui file konfigurasi resource (core/res/res/values/config.xml) lalu tambahkan nilai external ke config_autoTimeSourcesPriority: 
    <string-array name="config_autoTimeSourcesPriority>
        <item>external</item>
        <item>gnss</item>
</string-array>

    Dengan demikian, Android akan memberikan saran waktu eksternal prioritas tertinggi saat menyetel jam sistem. Hardware di kendaraan menulis saran stempel waktu ke properti EPOCH_TIME VHAL baru.

  2. Aplikasi yang disediakan vendor membaca properti ini dan memanggil TimeManager.suggestExternal(). Android kemudian dapat menggunakan stempel waktu yang diberikan sebagai nilai jam sistem baru.