समय स्रोत की प्राथमिकता

Android फ़्रेमवर्क, टाइम सिंक करने के लिए अलग-अलग टाइम सोर्स का इस्तेमाल करता है. इस पेज पर, नेटवर्क टाइम प्रोटोकॉल (एनटीपी) और नेटवर्क आइडेंटिटी ऐंड टाइम ज़ोन (एनआईटीज़ेड) के ऑटोमैटिक टाइम सोर्स के बारे में जानकारी दी गई है. डिफ़ॉल्ट रूप से, Android 12 या उसके बाद वाले वर्शन में, फ़्रेमवर्क एनटीपी को एनआईटीज़ेड के मुकाबले समय सोर्स के तौर पर प्राथमिकता देता है. ऐसा इसलिए, क्योंकि एनटीपी, एनआईटीज़ेड के मुकाबले ज़्यादा सटीक और भरोसेमंद है. ऐसे मामलों में जहां एनटीपी उपलब्ध नहीं होता, फ़्रेमवर्क एनआईटीज़ेड पर वापस चला जाता है. यह प्लैटफ़ॉर्म के पुराने वर्शन की डिफ़ॉल्ट प्राथमिकता का एक उलटा है. डिफ़ॉल्ट रूप से, Android 11 और उससे पहले के वर्शन में फ़्रेमवर्क, NTP के बजाय NITZ को प्राथमिकता देता है.

इस बदलाव के बारे में ज़्यादा जानकारी के लिए, ये एओएसपी पैच देखें: 1563678, 1513323.

समय के सोर्स की प्राथमिकता कॉन्फ़िगर करें

यह कॉन्फ़िगर करने के लिए कि किसी खास Android वर्शन के लिए किस टाइम सोर्स को डिफ़ॉल्ट रूप से प्राथमिकता दी जाती है, बिल्ड के समय frameworks/base/core/res/res/values/config.xml में config_autoTimeSourcesPriority कुंजी कॉन्फ़िगर करें. सूची में सबसे ऊपर मौजूद टाइम सोर्स के समय के सुझावों को, सूची में नीचे मौजूद सोर्स की तुलना में प्राथमिकता दी जाती है.

Android टाइम के जिन सोर्स को कॉन्फ़िगर किया जा सकता है उन्हें TimeDetectorStrategy.java में देखा जा सकता है. यहां दिए गए सोर्स, डिफ़ॉल्ट रूप से इस्तेमाल के लिए कॉन्फ़िगर किए जाते हैं:

  • टेलीफ़ोनी (NITZ)
  • नेटवर्क (NTP)

टेस्ट करना

यह पुष्टि करने के लिए कि एनटीपी उपलब्ध न होने पर डिवाइस, एनआईटीज़ेड का इस्तेमाल करता है (मोबाइल डेटा और वाई-फ़ाई बंद होने पर), यह तरीका अपनाएं:

  1. पक्का करें कि DUT में काम करने वाला सिम मौजूद हो
  2. मोबाइल डेटा और वाई-फ़ाई बंद करें
  3. यह पक्का करने के लिए कि सेल रेडियो बंद है, डिवाइस को हवाई जहाज़ मोड में रखें
  4. समय का अपने-आप पता लगाने की सुविधा को बंद करना
  5. घड़ी को भविष्य के लिए गलत समय मान पर मैन्युअल रूप से सेट करें
  6. डिवाइस को फिर से चालू करें
  7. समय का अपने-आप पता लगाने की सुविधा चालू करें
  8. डिवाइस को हवाई जहाज़ मोड से बाहर निकालें

ये चरण, NITZ सिग्नल मिलते ही, सिस्टम की घड़ी में बदलाव ट्रिगर करते हैं. यह देखने के लिए कि डिवाइस का समय कैसे सेट किया गया है, नीचे दिया गया कमांड चलाएं:

adb shell dumpsys time_detector

यह पुष्टि करने के लिए कि सिस्टम की घड़ी, NITZ का इस्तेमाल करती है, कमांड आउटपुट में इसकी पुष्टि करें:

  • mEnvironment.isAutoTimeDetectionEnabled() true है.
  • mEnvironment.autoOriginPriorities() में टाइम सोर्स की सूची होती है. इस लिस्ट में, सूची में नीचे दिए गए सोर्स के मुकाबले ऊपर वाले सोर्स को प्राथमिकता दी जाती है.
  • Time change log सेक्शन में दिखता है कि सिस्टम की घड़ी को टेलीफ़ोनी के सुझाव का इस्तेमाल करके सेट किया गया है.
  • Telephony suggestion history सेक्शन में, समय के सुझाव होते हैं.
  • Network suggestion history सेक्शन खाली है.

Telephony suggestion history और Network suggestion history सेक्शन में दिए गए समय के सुझावों को समय के हिसाब से सटीक माना जाता है. अगर डिवाइस को इंटरनेट से कनेक्ट किया गया है और उसमें सिम कार्ड है, तो NTP (नेटवर्क) और NITZ (टेलीफ़ोनी) दोनों का इस्तेमाल करके सुझाव जनरेट किए जाते हैं. इस टेस्ट केस में, सिर्फ़ Telephony suggestion history सेक्शन में सुझाव शामिल होते हैं, क्योंकि एनटीपी बंद है.

Time change log सेक्शन, डिवाइस की सिस्टम क्लॉक में किए गए बदलावों और इस्तेमाल किए गए सुझाव को रिकॉर्ड करता है. सिस्टम की घड़ी, config_autoTimeSourcesPriority कुंजी की प्राथमिकता सूची में मौजूद समय के सोर्स के क्रम के हिसाब से सेट की जाती है. हालांकि, अगर सुझाव बहुत पुराना या अमान्य है, तो ज़्यादा प्राथमिकता वाले सोर्स के सुझावों को अनदेखा किया जा सकता है. साथ ही, अगर सबसे ज़्यादा प्राथमिकता वाला मान्य सुझाव, डिवाइस के मौजूदा सिस्टम की घड़ी के समय से कुछ सेकंड के अंदर मेल खाता है, तो समय में बदलाव नहीं होगा. इस टेस्ट केस में, जब तक सुझाव पुराने नहीं हो जाते, तब तक सिस्टम की घड़ी को Telephony suggestion history के किसी एक सुझाव का इस्तेमाल करके सेट किया जाता है.

नीचे एक ऐसे आउटपुट का उदाहरण दिया गया है जिसमें एनटीपी उपलब्ध न होने पर, डिवाइस फिर से एनआईटीज़ेड का इस्तेमाल करना शुरू कर देता है.

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}

टेस्टिंग की स्थिति में आउटपुट से तुलना के लिए, यह एक सामान्य आउटपुट का उदाहरण है. इसमें डिवाइस को एनटीपी और एनआईटीज़ेड, दोनों टाइम सोर्स से समय के सुझाव मिलते हैं.

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}