Deteksi waktu otomatis

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

• telephony menggunakan sinyal telepon Identitas Jaringan dan Zona Waktu (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 telepon bawaan. Oleh karena itu, waktu Global Navigation Satellite System (GNSS) disediakan sebagai sumber waktu sistem yang dapat Anda gunakan saat konektivitas jaringan tidak tersedia.

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

• gnss menggunakan Sistem Navigasi Satelit Global (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 di depan saran waktu network.

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

Batas waktu yang lebih rendah

Android 12 menyediakan batas waktu yang lebih rendah 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 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 untuk Android 12 dan disediakan oleh sinyal GPS. Ini adalah sumber yang andal untuk waktu saat telephony dan network tidak tersedia. Opsi ini ditambahkan ke GnssTimeUpdateService baru di SystemServer yang secara pasif memproses pembaruan 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. Update config_enableGnssTimeUpdateService. Nilai untuk config_enableGnssTimeUpdateService harus ditetapkan ke true.
2. Update 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 terhadap daya

GnssTimeUpdateService memproses pembaruan lokasi secara pasif, yang berarti bahwa 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 pembaruan lokasi, GnssTimeUpdateService tidak akan mendapatkan pembaruan 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 pembaruan lokasi ini, dan secara berkala memberikan saran.

Catatan: Antarmuka untuk perintah ini dapat berubah di antara 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 saran waktu external:

• 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 TimeManager Android untuk menyarankan waktu sistem baru. Contoh implementasi VHAL yang memperbarui properti ini disediakan di implementasi referensi di bawah.
• API Sistem. Metode baru yang disebut suggestExternalTime() tersedia di TimeManager untuk memberikan saran waktu eksternal kepada sistem. Jika sistem dikonfigurasi untuk mempertimbangkan saran waktu eksternal (menggunakan config_autoTimeSourcesPrioritydalam file konfigurasi), stempel waktu yang diteruskan ke metode ini 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>

   Tindakan ini akan menginstruksikan Android untuk memberikan saran waktu eksternal dengan prioritas tertinggi saat menyetel jam sistem. Hardware di kendaraan menulis saran stempel waktu ke properti VHAL EPOCH_TIME 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.