Framework Android menggunakan berbagai sumber waktu untuk sinkronisasi waktu. Halaman ini berfokus pada {i> Network Time Protocol<i} (NTP) dan Sumber waktu otomatis Identitas Jaringan dan Zona Waktu (NITZ). Secara default di Android 12 atau yang lebih tinggi, framework memprioritaskan NTP sebagai sumber waktu daripada NITZ karena NTP adalah lebih akurat dan andal dibandingkan NITZ. Jika NTP tidak tersedia, framework akan kembali ke NITZ. Ini adalah kebalikan dari prioritas default dari versi sebelumnya terkelola sepenuhnya. Secara default di Android 11 dan yang lebih rendah, framework ini akan memprioritaskan NITZ melalui NTP.
Untuk detail selengkapnya tentang perubahan ini, lihat patch AOSP berikut: 1563678, 1513323.
Mengonfigurasi prioritas sumber waktu
Untuk mengonfigurasi sumber waktu yang diprioritaskan secara default untuk Android tertentu
terakhir, konfigurasikan
config_autoTimeSourcesPriority
kunci di frameworks/base/core/res/res/values/config.xml
pada waktu build. Waktu
saran dari sumber waktu yang lebih tinggi dalam daftar lebih diutamakan
di atas sumber yang lebih rendah dalam daftar.
Sumber waktu Android yang dapat dikonfigurasi ditemukan di
TimeDetectorStrategy.java
Sumber berikut dikonfigurasi untuk digunakan secara default:
- Telepon (NITZ)
- Jaringan (NTP)
Pengujian
Untuk memverifikasi bahwa perangkat menggunakan NITZ saat NTP tidak tersedia (jika data seluler dan Wi-Fi dinonaktifkan), lakukan hal berikut:
- Memastikan ada SIM yang berfungsi di DUT
- Menonaktifkan data seluler dan Wi-Fi
- Setel perangkat ke mode pesawat untuk memastikan radio seluler dinonaktifkan
- Nonaktifkan deteksi waktu otomatis
- Setel jam secara manual ke nilai waktu yang akan datang salah
- Memulai ulang perangkat
- Aktifkan deteksi waktu otomatis
- Keluarkan perangkat dari mode pesawat
Langkah-langkah ini memicu perubahan pada jam sistem segera setelah NITZ sinyal diterima. Untuk memeriksa pengaturan waktu perangkat, jalankan perintah berikut berikut:
adb shell dumpsys time_detector
Untuk memverifikasi bahwa jam sistem menggunakan NITZ, konfirmasi hal berikut dalam perintah {i>output<i}:
mEnvironment.isAutoTimeDetectionEnabled()
true
.mEnvironment.autoOriginPriorities()
berisi daftar sumber waktu dengan sumber yang posisinya lebih tinggi dalam daftar akan didahulukan daripada sumber yang lebih rendah daftar.- Bagian
Time change log
menunjukkan bahwa jam sistem disetel menggunakan saran telepon. - Bagian
Telephony suggestion history
berisi saran waktu. - Bagian
Network suggestion history
kosong.
Saran waktu di Telephony suggestion history
dan
Bagian Network suggestion history
dianggap sebagai sumber kebenaran untuk
baik. Jika perangkat terhubung ke internet dan memiliki kartu SIM, saran
dihasilkan menggunakan NTP (jaringan) dan NITZ (telepon). Dalam kasus pengujian ini,
hanya bagian Telephony suggestion history
yang berisi saran karena
NTP dinonaktifkan.
Bagian Time change log
mencatat perubahan yang dibuat pada
jam sistem dan saran yang digunakan. Jam sistem diatur berdasarkan
urutan sumber waktu dalam daftar prioritas di
tombol config_autoTimeSourcesPriority
. Namun, saran dari
sumber dengan prioritas yang lebih tinggi mungkin diabaikan jika saran sudah terlalu lama atau tidak valid.
Selain itu, jika saran valid prioritas tertinggi cocok dengan
waktu jam sistem menjadi beberapa detik
waktunya tidak akan diubah.
Dalam kasus pengujian ini, selama saran belum usang, jam sistem akan
ditetapkan menggunakan salah satu saran dari Telephony suggestion history
.
Berikut ini contoh {i>output<i} di mana perangkat kembali menggunakan NITZ saat NTP tidak tersedia.
TimeDetectorStrategy:
mLastAutoSystemClockTimeSet=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}
mEnvironment.isAutoTimeDetectionEnabled()=true
mEnvironment.elapsedRealtimeMillis()=73059
mEnvironment.systemClockMillis()=1614186767818
mEnvironment.systemClockUpdateThresholdMillis()=2000
mEnvironment.autoTimeLowerBound()=2021-02-24T15:44:15Z(1614181455000)
mEnvironment.autoOriginPriorities()=[network,telephony]
Time change log:
66261 / 2021-02-24T17:12:41.020Z - Set system clock using time=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000} cause=Found good telephony suggestion., bestTelephonySuggestion=TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]}, detectionReason=New telephony time suggested. timeSuggestion=TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]} elapsedRealtimeMillis=66259 newSystemClockMillis=1614186761019
Telephony suggestion history:
key idx: 0=0
val idx: 0=TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]}
Historic values=[
0@PT1M6.258S: TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]}
]
Network suggestion history:
{Empty}
Gnss suggestion history:
{Empty}
External suggestion history:
{Empty}
Sebagai referensi sebagai perbandingan dengan {i>output<i} dalam skenario pengujian, berikut adalah contoh {i>output<i} pada umumnya di mana perangkat menerima saran waktu dari sumber waktu NTP dan NITZ.
TimeDetectorStrategy:
mLastAutoSystemClockTimeSet=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}
mEnvironment.isAutoTimeDetectionEnabled()=true
mEnvironment.elapsedRealtimeMillis()=302926
mEnvironment.systemClockMillis()=1614186997685
mEnvironment.systemClockUpdateThresholdMillis()=2000
mEnvironment.autoTimeLowerBound()=2021-02-24T15:44:15Z(1614181455000)
mEnvironment.autoOriginPriorities()=[network,telephony]
Time change log:
66261 / 2021-02-24T17:12:41.020Z - Set system clock using time=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000} cause=Found good telephony suggestion., bestTelephonySuggestion=TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]}, detectionReason=New telephony time suggested. timeSuggestion=TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]} elapsedRealtimeMillis=66259 newSystemClockMillis=1614186761019
Telephony suggestion history:
key idx: 0=0
val idx: 0=TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]}
Historic values=[
0@PT1M6.258S: TelephonyTimeSuggestion{mSlotIndex='0', mUtcTime=TimestampedValue{mReferenceTimeMillis=66240, mValue=1614186761000}, mDebugInfo=[Sending new time suggestion nitzSignal=TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}}, reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=66240, mValue=NitzData{mOriginalString=21/02/24,17:12:41+00,00, mZoneOffset=0, mDstOffset=0, mCurrentTimeMillis=1614186761000, mEmulatorHostTimeZone=null}})]}
]
Network suggestion history:
0@PT4M4.04S: NetworkTimeSuggestion{mUtcTime=TimestampedValue{mReferenceTimeMillis=244038, mValue=1614186939242}, mDebugInfo=[Origin: NetworkTimeUpdateService. event=3]}
Gnss suggestion history:
{Empty}
External suggestion history:
{Empty}