O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

Detecção Automática de Tempo

A detecção automática de tempo recebe sugestões de tempo de várias fontes, seleciona a melhor opção e, em seguida, define o relógio do sistema no Android para corresponder. As versões anteriores do Android ofereciam duas maneiras de definir a data e a hora — manualmente por usuário ou por detecção automática de hora, definida por uma destas duas opções:

a telefonia usa sinais de telefonia de identidade de rede e fuso horário (NITZ).
rede usa servidores de tempo Network Time Protocol (NTP).

Cada opção requer conexões com redes externas, que nem sempre estão disponíveis no Android Automotive. Por exemplo, em alguns países, alguns carros podem não ter telefonia embutida. Portanto, o horário dos sistemas globais de navegação por satélite (GNSS) agora também é fornecido como uma fonte de horário do sistema para você usar quando a conectividade de rede não estiver disponível.

Esta próxima versão do Android oferece mais duas opções para detectar e definir automaticamente o tempo:

O gnss usa Sistemas Globais de Navegação por Satélite (GNSS).
externo usa uma propriedade VHAL ou a API do sistema.

Ativar detecção automática de tempo

Para ativar a detecção automática de hora, certifique-se de selecionar Configurações > Data e hora > Data e hora automáticas :

Figura 1. Selecionar data e hora automáticas

Configurar fontes de tempo

Para especificar quais fontes de tempo incluir na detecção automática de tempo e a prioridade em que essas fontes de tempo devem ser consideradas, você deve modificar o arquivo de configuração de recursos do dispositivo, 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>

Neste exemplo, telephony e network são consideradas na detecção automática de horário e as sugestões de horário telephony são priorizadas antes das sugestões de horário network .

De um modo geral, as sugestões de uma fonte de prioridade mais alta são ignoradas se a sugestão for inválida ou se for muito antiga. Além disso, se a sugestão válida de prioridade mais alta corresponder ao horário atual do relógio do sistema do dispositivo em vários segundos (o valor padrão é dois (2) segundos), o horário não será alterado.

Limite de tempo inferior

O Android 12 fornece um novo limite de tempo inferior para usar ao validar sugestões de tempo. Antes desse recurso, a detecção automática de hora não validava a hora UTC de entrada sugerida. Com esse recurso, os tempos decorridos antes do limite inferior são descartados.

O valor do limite inferior é determinado a partir de uma data derivada do registro de data e hora da construção. Isso funciona com base no princípio de que um tempo válido não pode ocorrer antes da criação da imagem do sistema. O Android não impõe um limite superior.

Sugestões de horário GNSS

A fonte de tempo gnss é nova no Android 12 e é fornecida por sinais de GPS. Esta é considerada uma fonte confiável de tempo quando a telefonia e a rede não estão disponíveis. Esta opção é adicionada ao novo GnssTimeUpdateService no SystemServer que escuta passivamente as atualizações de localização. Quando um local válido é recebido, GnssTimeUpdateService faz uma sugestão para TimeDetectorService , que então determina se o relógio do sistema deve ser atualizado.

Por padrão, a fonte de tempo gnss não é habilitada no AOSP e, portanto, deve ser habilitada pelos parceiros:

<!-- 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>

Para habilitar esse recurso:

Atualize config_enableGnssTimeUpdateService. O valor para config_enableGnssTimeUpdateService deve ser configurado como true .
Atualize config_autoTimeSourcesPriority . gnss deve ser adicionado à lista de itens para config_autoTimeSourcesPriority . A posição do gnss na lista de prioridades determina a prioridade dada às sugestões GNSS, em relação aos valores de outras fontes.

Impacto no poder

GnssTimeUpdateService escuta passivamente as atualizações de localização, o que significa que nunca ativa o GPS para consumir energia adicional. Como resultado, a energia consumida quando a fonte GNSS está habilitada é insignificante. Isso também significa que, a menos que outro aplicativo ou serviço no sistema solicite ativamente atualizações de localização, GnssTimeUpdateService não obtém uma atualização de localização e sugere um horário GNSS.

teste

Conjunto de testes de compatibilidade (CTS)

Um teste CTS é fornecido para verificar se um horário fornecido por GNSS está disponível. Para obter detalhes, consulte LocationShellCommand.java . Use estes comandos para adicionar teste

testes de unidade

Veja os testes básicos de unidade no seguinte arquivo:

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

testes manuais

Para testar esse recurso, novos comandos foram incluídos em LocationShellCommand.java . Use esses comandos para adicionar provedores de teste com os quais você pode especificar um local e o tempo GNSS associado. GnssTimeUpdateService escuta essas atualizações de localização e periodicamente faz sugestões.

Observação: a interface para esses comandos pode mudar entre as versões.

# 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>

Sugestões externas de horário

Sugestões externas de horário são outra maneira de fornecer sugestões automáticas de horário para o Android. Esta nova opção permite fornecer sugestões de tempo totalmente personalizadas para o Android, que podem ser originadas de várias ECUs que, por sua vez, podem usar uma combinação de relógio em tempo real, GNSS, NITZ ou qualquer outra fonte de tempo.

As seguintes sugestões estão agora disponíveis no Android 12 para serem consideradas como sugestões de horário external :

Propriedades VHAL. Uma nova propriedade VHAL denominada EPOCH_TIME é fornecida. Esta propriedade denota o número de milissegundos decorridos desde 01/01/1970 UTC. Seu valor pode ser passado para o Android TimeManager para sugerir um novo horário do sistema. Uma implementação VHAL de amostra que atualiza essa propriedade é fornecida na implementação de referência abaixo.
APIs do sistema. Um novo método chamado suggestExternalTime() agora está disponível no TimeManager para fornecer ao sistema uma sugestão de horário externo. Se o sistema estiver configurado para levar em consideração sugestões de horário externo (usando config_autoTimeSourcesPriority no arquivo de configuração), o timestamp passado para este método é usado para definir o horário do sistema, caso não haja sugestões de horário de maior prioridade disponíveis.

Você pode implementar uma solução externa de tempo conforme descrito abaixo:

Atualize o arquivo de configuração do recurso ( core/res/res/values/config.xml ) e adicione o valor external a config_autoTimeSourcesPriority :
```
<string-array name="config_autoTimeSourcesPriority>
        <item>external</item>
        <item>gnss</item>
</string-array>
```
Fazer isso instrui o Android a dar a mais alta prioridade às sugestões de horário externo ao definir o relógio do sistema. O hardware no veículo grava uma sugestão de registro de data e hora na nova propriedade EPOCH_TIME VHAL .
Um aplicativo fornecido pelo fornecedor lê essa propriedade e chama TimeManager.suggestExternal() . O Android pode então usar o carimbo de data/hora fornecido como o novo valor do relógio do sistema.