Detecção de horário do GNSS

No Android 12 e versões mais recentes, também é possível usar um Sistema Global de Navegação por Satélite (GNSS, na sigla em inglês) para sugerir horários de época Unix ao serviço time_detector. Essa opção não é ativada por padrão no AOSP.

Quando a detecção de horário do GNSS está ativada, o gnss_time_update_service ouve passivamente as atualizações de local de fontes do GNSS e envia sugestões do GNSS para o serviço time_detector. Em seguida, o serviço time_detector determina se o relógio do sistema será atualizado para corresponder à sugestão.

Impacto no uso de energia

O gnss_time_update_service do AOSP detecta passivamente as atualizações de localização. Isso significa que ele nunca ativa o GPS ativamente nem consome energia extra. Isso também significa que, a menos que outro app ou serviço no sistema esteja ativamente solicitando atualizações de localização, o gnss_time_update_service não vai receber uma atualização de localização nem sugerir um horário do GNSS.

Implementação

Para ativar a detecção de horário do GNSS, os fabricantes de dispositivos precisam ativar explicitamente o gnss_time_update_service no servidor do sistema.

Os valores config_enableGnssTimeUpdateService e config_autoTimeSourcesPriority no arquivo core/res/res/values/config.xml precisam ser atualizados para ativar esse recurso. Defina o valor de config_enableGnssTimeUpdateService como true e adicione gnss à lista de itens de config_autoTimeSourcesPriority. A posição de gnss na lista de prioridade determina a prioridade dada às sugestões de GNSS em relação às de outras fontes.

Veja a seguir um exemplo de arquivo core/res/res/values/config.xml em que a detecção de tempo GNSS está ativada e gnss está em terceiro na lista de prioridades, depois de network e 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>

Depuração e testes

Para testar a detecção de tempo do GNSS, use os comandos adb shell cmd location. Use estes comandos para adicionar provedores de localização de teste em que é possível especificar um local e o horário de GNSS associado. O gnss_time_update_service detecta essas atualizações de localização e faz sugestões periodicamente.

Confira a seguir exemplos de comandos 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