Deteksi waktu GNSS

Mulai Android 12, Android secara opsional dapat menggunakan Global Navigation Satellite System (GNSS) untuk menyarankan waktu epoch Unix ke layanan time_detector. Fitur ini tidak diaktifkan secara default di AOSP.

Saat deteksi waktu GNSS diaktifkan, gnss_time_update_service secara pasif mendengarkan update lokasi dari sumber GNSS dan mengirimkan saran GNSS ke layanan time_detector. Layanan time_detector kemudian menentukan apakah akan memperbarui jam sistem agar cocok dengan saran.

Dampak pada penggunaan daya

gnss_time_update_service AOSP secara pasif memproses pembaruan lokasi. Artinya, perangkat tidak pernah secara aktif mengaktifkan GPS atau menggunakan daya tambahan. Hal ini juga berarti bahwa kecuali aplikasi atau layanan lain dalam sistem secara aktif meminta pembaruan lokasi, gnss_time_update_service tidak akan mendapatkan pembaruan lokasi dan menyarankan waktu GNSS.

Implementasi

Untuk mengaktifkan deteksi waktu GNSS, produsen perangkat harus secara eksplisit mengaktifkan gnss_time_update_service di server sistem.

Nilai config_enableGnssTimeUpdateService dan config_autoTimeSourcesPriority dalam file core/res/res/values/config.xml harus diperbarui untuk mengaktifkan fitur ini. Tetapkan nilai untuk config_enableGnssTimeUpdateService ke true dan tambahkan gnss ke daftar item untuk config_autoTimeSourcesPriority. Posisi gnss dalam daftar prioritas menentukan prioritas yang diberikan ke saran GNSS sehubungan dengan saran dari sumber lain.

Berikut adalah contoh file core/res/res/values/config.xml dengan deteksi waktu GNSS diaktifkan dan gnss berada di urutan ketiga dalam daftar prioritas setelah network dan telephony.

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

Proses debug dan pengujian

Untuk menguji deteksi waktu GNSS, Anda dapat menggunakan perintah adb shell cmd location. Gunakan perintah ini untuk menambahkan penyedia lokasi pengujian tempat Anda dapat menentukan lokasi dan waktu GNSS terkait. gnss_time_update_service memproses pembaruan lokasi ini, dan memberikan saran secara berkala.

Berikut ini contoh perintah adb shell cmd location:

# 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. Throws 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 lower than the limit set by the lower bound.)
adb shell cmd location providers set-test-provider-location gps --location LATITUDE,LONGITUDE --time TIME