זיהוי זמן GNSS

ב-Android מגרסה 12 ואילך, מערכת Android יכולה להשתמש באופן אופציונלי במערכת גלובלית לניווט לווייני (GNSS) כדי להציע זמני תקופת Unix לשירות time_detector. האפשרות הזו לא מופעלת כברירת מחדל ב-AOSP.

כשההגדרה 'זיהוי זמן GNSS' מופעלת, gnss_time_update_service מאזין באופן פסיבי לעדכוני מיקום ממקורות GNSS ושולח הצעות GNSS לשירות time_detector. השירות time_detector קובע אם לעדכן את שעון המערכת כך שיתאים להצעה.

השפעה על צריכת החשמל

‫AOSP gnss_time_update_service מאזין באופן פסיבי לעדכוני מיקום. המשמעות היא שהיא אף פעם לא מפעילה את ה-GPS או צורכת אנרגיה נוספת. המשמעות היא שאם אפליקציה או שירות אחרים במערכת לא מבקשים באופן פעיל עדכוני מיקום, gnss_time_update_service לא יקבל עדכון מיקום ולא יציע זמן GNSS.

הטמעה

כדי להפעיל את זיהוי הזמן באמצעות GNSS, יצרני המכשירים צריכים להפעיל באופן מפורש את gnss_time_update_service בשרת המערכת.

כדי להפעיל את התכונה הזו, צריך לעדכן את הערכים של config_enableGnssTimeUpdateService ושל config_autoTimeSourcesPriority בקובץ core/res/res/values/config.xml. מגדירים את הערך של config_enableGnssTimeUpdateService ל-true ומוסיפים את gnss לרשימת הפריטים של config_autoTimeSourcesPriority. המיקום של gnss ברשימת העדיפויות קובע את העדיפות שניתנת להצעות של GNSS ביחס להצעות ממקורות אחרים.

הנה דוגמה לקובץ core/res/res/values/config.xml שבו מופעלת זיהוי הזמן של GNSS, ו-gnss הוא השלישי ברשימת העדיפויות אחרי network ו-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>

ניפוי באגים ובדיקות

כדי לבדוק את זיהוי הזמן ב-GNSS, אפשר להשתמש בפקודות adb shell cmd location. אפשר להשתמש בפקודות האלה כדי להוסיף ספקי מיקום לבדיקה, שבהם אפשר לציין מיקום ואת הזמן המשויך של GNSS. ה-gnss_time_update_service מאזין לעדכוני המיקום האלה ומציע הצעות מדי פעם.

בדוגמה הבאה מוצגות פקודות 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