أولوية مصدر الوقت

يستخدم إطار عمل Android مصادر زمنية مختلفة لمزامنة الوقت. تركز هذه الصفحة على مصادر الوقت التلقائية لبروتوكول وقت الشبكة (NTP) وهوية الشبكة والمنطقة الزمنية (NITZ). بشكل افتراضي في Android 12 أو أعلى ، يعطي إطار العمل الأولوية لـ NTP كمصدر زمني على NITZ لأن NTP أكثر دقة وموثوقية من NITZ. في الحالات التي لا يتوفر فيها NTP ، يعود إطار العمل إلى NITZ. يعد هذا انعكاسًا للأولوية الافتراضية من الإصدارات السابقة للنظام الأساسي. بشكل افتراضي في Android 11 والإصدارات الأقدم ، يعطي إطار العمل الأولوية لـ NITZ على NTP.

لمزيد من التفاصيل حول هذا التغيير ، راجع تصحيحات AOSP التالية: 1563678 ، 1513323 .

تكوين أولوية مصدر الوقت

لتكوين مصدر الوقت الذي يحظى بالأولوية افتراضيًا لإصدار Android معين ، قم بتكوين مفتاح config_autoTimeSourcesPriority في frameworks/base/core/res/res/values/config.xml في وقت الإنشاء. اقتراحات الوقت من مصدر الوقت الأعلى في القائمة لها الأسبقية على المصادر الأقل في القائمة.

توجد مصادر وقت Android التي يمكن تكوينها في TimeDetectorStrategy.java . تم تكوين المصادر التالية للاستخدام افتراضيًا:

  • Telephony (NITZ)
  • الشبكة (NTP)

اختبارات

للتحقق من أن الجهاز يستخدم NITZ عندما لا يكون NTP متاحًا (عند تعطيل بيانات الجوال و Wi-Fi) ، قم بما يلي:

  1. تأكد من وجود بطاقة SIM عاملة في 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 مصدر الحقيقة للوقت. إذا كان الجهاز متصلاً بالإنترنت ويحتوي على بطاقة SIM ، يتم إنشاء اقتراحات باستخدام كل من NTP (شبكة) و NITZ (الاتصالات الهاتفية). في حالة الاختبار هذه ، يحتوي قسم Telephony suggestion history فقط على اقتراحات نظرًا لتعطيل NTP.

يسجل قسم Time change log التغييرات التي تم إجراؤها على ساعة نظام الجهاز والاقتراح المستخدم. يتم ضبط ساعة النظام بناءً على ترتيب مصادر الوقت في قائمة الأولويات في مفتاح config_autoTimeSourcesPriority . ومع ذلك ، قد يتم تجاهل الاقتراحات الواردة من مصدر ذي أولوية أعلى إذا كان الاقتراح قديمًا جدًا أو غير صالح. أيضًا ، إذا تطابق الاقتراح الصالح ذو الأولوية القصوى مع وقت ساعة النظام الحالي للجهاز في غضون بضع ثوانٍ ، فلن يتغير الوقت. في حالة الاختبار هذه ، طالما أن الاقتراحات ليست قديمة ، يتم ضبط ساعة النظام باستخدام أحد الاقتراحات من Telephony suggestion history .

ما يلي هو مثال على الإخراج حيث يعود الجهاز إلى استخدام NITZ عندما يكون NTP غير متاح.

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}

كمرجع للمقارنة بالمخرجات في سيناريو الاختبار ، فيما يلي مثال على الإخراج النموذجي حيث يتلقى الجهاز اقتراحات الوقت من كل من مصادر الوقت NTP و 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}