QMDL: صيغة سجل التشخيص من Qualcomm شرح شامل — كيف تلتقط البيانات الميدانية وتحللها

لقد انتهيت للتوّ من جولة قياس ميداني استمرت 6 ساعات عبر ثلاثة مواقع. يُظهر سجل RRC فشل handover في الموقع الثاني بالضبط عند الساعة 14:37. فريق المعالجة اللاحقة في الرياض، وأنت في جدة، ويحتاجون إلى بيانات البروتوكول الخام — الآن. تُصدر ملف QMDL وترسله، وفي 10 دقائق يكونون قد فكّوا ترميز تسلسل الـ handover إطاراً بإطار. QMDL هو اللغة العالمية لبيانات Qualcomm الميدانية.

ما هو QMDL؟

QMDL اختصار لـ Qualcomm Modem Diagnostic Log. إنه التنسيق الثنائي الأصلي الذي يُنتجه بروتوكول Qualcomm DIAG — واجهة تشخيص مدمجة في كل مودم Qualcomm Snapdragon. التقاط ملف QMDL يعني تسجيل دفق ثنائي خام من منفذ التشخيص الخاص بـ Qualcomm، يحتوي على حزم سجلات مؤرّخة لكل طبقة بروتوكول نشطة: قياسات الطبقة الفيزيائية، وإشارات RRC، وإجراءات NAS، وإحصاءات PDCP، وما إلى ذلك.

يوجد نوعان في الميدان. التنسيق القياسي .qmdl هو الأكثر انتشاراً بفارق كبير — وهو ما ينتجه أي جهاز Android مجذّر مزوّد بشريحة Snapdragon عند فتح منفذ DIAG. أما التنسيق الموسّع .qmdl2 فيحمل بيانات وصفية إضافية تشمل طوابع زمنية UTC مطلقة، ويوجد على منصات Snapdragon 8 Gen 2 وما بعدها. للمعالجة اللاحقة والمشاركة مع فرق المشغّلين، يظل .qmdl التنسيق المهيمن بسبب نظامه الواسع من المحلّلات وتوافقه مع QCAT (أداة تفعيل كود Qualcomm).

على المستوى الثنائي، كل سجل في ملف QMDL هو إطار DM (Diagnostic Monitor). يحمل كل إطار DM رأساً ذا بنية ثابتة يتضمّن رمز حزمة السجل وطول الإطار وطابعاً زمنياً QTimerTick، يليه حمولة يُشكّل أوّل بايتين منها معرّف حزمة السجل. هذا المعرّف هو المفتاح لفهم ما تحتويه الإطار.

التنسيق ليس معياراً مفتوحاً. إنه مشتقّ من سلسلة أدوات التشخيص الداخلية لـ Qualcomm ويستلزم إما برنامج QCAT الرسمي أو محلّلاً تابعاً لجهة خارجية أجرى هندسة عكسية للتأطير وبنية الحزم.

معرّفات حزم QMDL الرئيسية

معرّف الحزمة (hex)	المحتوى	البروتوكول
0x1568	رسالة RRC OTA للـ LTE	RRC 36.331
0x5226	رسالة RRC OTA للـ NR	RRC 38.331
0x713A	رسالة NAS OTA للـ LTE	NAS 24.301
0x7030	رسالة NAS OTA للـ 5G	NAS 24.501
0x184B	قياسات الخلية الخادمة LTE ML1	PHY الطبقة 1
0x2584	معلومات الخلية الخادمة NR ML1	PHY الطبقة 1
0x1472	إحصاءات PDCP DL للـ LTE	PDCP الطبقة 2

QMDL مقابل QMDL2 مقابل HLOG

ليست جميع تنسيقات السجلات متكافئة. فهم الفروق بين التنسيقات الثلاثة الأكثر شيوعاً في العمل الميداني يُساعدك على اختيار استراتيجية الالتقاط الصحيحة.

الخاصية	QMDL	QMDL2	HLOG
التنسيق	إطارات DM ثنائية	DM ثنائي موسّع	مشفَّر خاص
الطابع الزمني	نسبي (QTimerTick)	UTC مطلق	UTC مطلق
التشفير	لا يوجد	لا يوجد	تشفير AEAD
GPS مضمَّن	لا	اختياري	نعم
الشرائح المدعومة	Qualcomm (جميعها)	Snapdragon 8 Gen 2+	أجهزة HiCellTek
توافق النظام البيئي	واسع (QCAT، محلّلات)	محدود	أداة HiCellTek
حجم الملف	كبير (خام)	كبير	مضغوط

يفوز تنسيق QMDL القياسي في مجال التوافقية. تستلزم طوابعه الزمنية النسبية QTimerTick خطوة تحويل (موصوفة أدناه في قسم التحليل)، لكن نظامه البيئي من المحلّلات واسع بما يكفي لأي فريق معالجة لاحقة لدى أي مورّد اتصالات كبير لفتح الملف وفكّ ترميزه دون أدوات خاصة. يوسّع QMDL2 ذلك بـ GPS اختياري ووقت UTC مطلق، لكن دعم المحلّلات خارج QCAT لا يزال محدوداً. HLOG هو التنسيق المشفَّر والمضغوط الذي تستخدمه أجهزة HiCellTek — مثالي للنقل الآمن من الميدان إلى المكتب، لكنه يتطلّب أداة HiCellTek للفكّ.

لتقديم تذاكر الأعطال للمشغّلين والمعالجة اللاحقة متعددة الموردين، QMDL هو التنسيق الأفضل تنقّلاً.

كيفية التقاط QMDL في الميدان

التقاط QMDL يستلزم هاتف Android بشريحة Qualcomm Snapdragon، وصول root عبر Magisk، وتمكين واجهة DIAG على الجهاز. معظم الأجهزة الميدانية ذات الجودة المهنية تُعرض منفذ DIAG على /dev/diag.

قناع السجل هو أهم معامل تهيئة في أي التقاط QMDL. يُرسَل القناع إلى المودم عبر الأمر DM 0x7C ويُخبر الشريحة بالضبط بأي معرّفات الحزم يجب تضمينها في دفق الإخراج. القناع المُهيَّأ خطأً هو السبب الأكثر شيوعاً للوصول إلى المعالجة اللاحقة بملف QMDL لا يحتوي على رسائل RRC — خطأ يضيّع يوماً كاملاً من البيانات الميدانية. قبل أي drive طويل، تحقّق دائماً من أن القناع يُفعِّل صراحةً على الأقل المعرّفات 0x1568 (RRC LTE) و0x5226 (RRC NR) و0x713A (NAS LTE) و0x7030 (NAS 5G).

تُنتج جولة قياس نموذجية لمدة ساعة بقناع كامل ما بين 200 ميجابايت و800 ميجابايت من بيانات QMDL الخام، وذلك بحسب نشاط الشبكة وكثافة الخلايا وعدد معرّفات الحزم المُفعَّلة. لحملات التحسين، خطّط لـ 5 إلى 20 جيجابايت من QMDL لكل جهاز يومياً.

تحليل QMDL — من الثنائي إلى البروتوكول المفكوك

لا يمكن قراءة الثنائي الخام لـ QMDL مباشرةً. يتطلّب التحليل أربع خطوات متتالية تحوّل الدفق الثنائي إلى رسائل بروتوكول مقروءة.

الخطوة 1 — استخراج إطارات DM: يُؤطَّر الدفق الثنائي باستخدام ترميز شبيه بـ HDLC، حيث يكون 0x7E هو بايت التأطير الذي يُعلِّم بداية ونهاية كل إطار DM. يجب على المحلّل اجتياز الدفق وتحديد الحدود واستخراج الإطارات الفردية. يجب إلغاء تهريب البايتات المُهرَّبة (تسلسلات 0x7D) قبل المعالجة.

الخطوة 2 — البحث عن معرّف الحزمة: بمجرد استخراج الإطار، يُحدّد أوّل بايتين من الحمولة نوع حزمة السجل. يُحدّد البحث في جدول معرّفات الحزم المعروفة ما إذا كان الإطار يحتوي على رسالة RRC OTA أو PDU للـ NAS أو سجل قياس PHY أو نوع آخر من السجلات.

الخطوة 3 — فكّ ترميز ASN.1: لإطارات RRC وNAS (0x1568 و0x5226 و0x713A و0x7030)، تحتوي الحمولة بعد رأس الحزمة على رسالة 3GPP مُرمَّزة بـ ASN.1 PER. يستلزم فكّ ترميزها أداة فكّ ترميز ASN.1 مُصرَّفة وفق إصدار المواصفة 3GPP الصحيح (36.331 لـ RRC LTE، و38.331 لـ RRC NR، و24.301 لـ NAS LTE، و24.501 لـ NAS 5G). النتيجة المُفكَّكة مطابقة لما تُعرضه الأدوات الميدانية المهنية — لأن بيانات البروتوكول الأساسية ذاتها.

الخطوة 4 — تحويل الطوابع الزمنية: تحمل إطارات DM قيمة QTimerTick بحجم 32 بت. تحويل هذه القيمة إلى وقت فعلي يستلزم معرفة تردد المؤقّت في الشريحة، الذي يبلغ 19.2 ميغاهرتز في معظم منصات Snapdragon. الصيغة هي: الوقت_UTC = المرجع_UTC + (QTimerTick / 19200000). عادةً ما يُستخرَج مرجع UTC من حدث مزامنة GPS أو طابع زمني NTP مضمَّن في جلسة الالتقاط.

للفرق التي تحتاج إلى فكّ ترميز رسائل RRC أو NAS فردية مستخرَجة من QMDL دون تشغيل مجموعة تحليل كاملة، يدعم أداة فكّ ترميز بروتوكولات L3 عبر الإنترنت لرسائل RRC وNAS لصق الحمولات المُرمَّزة بـ hex مباشرةً وينتج مخرجات ASN.1 منظَّمة.

للمهندسين الذين يُفضّلون فكّ الترميز الفوري الأصلي في الميدان دون QCAT، تلتقط أداة drive test لـ Android مع وصول DIAG أصلي وتفكّ ترميز دفقات QMDL على الجهاز مباشرةً خلال الجولة، مما يُلغي دورة المعالجة اللاحقة للتعرّف السريع على الأعطال.

أفضل الممارسات الميدانية لـ QMDL

معرفة التنسيق شيء، واستخدامه بكفاءة في حملة تحسين فعلية شيء آخر يتطلّب مجموعة من الممارسات التشغيلية التي يطوّرها المهندسون الميدانيون المتمرّسون على مدار سنوات من العمل الميداني.

تسمية الملفات: أدرج دائماً التاريخ ومعرّف الموقع وشريحة الجولة في اسم الملف — على سبيل المثال 2026-03-27_SITE-A_SEG1.qmdl. هذا يجعل الربط مع مسارات GPS وتصديرات KPI أمراً بسيطاً، ويتجنّب مشكلة التمييز بين الملفات التي تُعيق فرق المعالجة اللاحقة عند استقبال دفعات التقاط من عدة مهندسين.

دوران السجلات: للجولات التي تتجاوز 30 دقيقة، اضبط أداة الالتقاط لتدوير الملفات كل 30 دقيقة. الملفات التي تتجاوز 2 جيجابايت تتسبّب في فشل التحليل في عدة أدوات شائعة وتُبطئ خطوة المسح الأولي. الملفات الأصغر تُتيح أيضاً المعالجة المتوازية لشرائح الجولة المختلفة.

الربط بـ GPS: لا تحتوي ملفات QMDL على بيانات GPS افتراضياً. النهج القياسي هو التقاط مسار GPX بالتوازي وربطه بالطوابع الزمنية لـ QMDL بعد تطبيق تحويل QTimerTick إلى UTC. بعض أدوات drive test لـ Android تُعالج هذا الربط تلقائياً وتضمّ GPS في ملف مرافق. يدعم تنسيق QMDL2 تضمين GPS اختيارياً، مما يُبسّط هذه الخطوة على الشرائح المدعومة.

الأدلة لتذاكر الموردين: وفقاً لمعيار 3GPP TS 37.320 (وضع اختبار UE)، تُقبَل سجلات QMDL مع طوابع زمنية لرسائل RRC كأدلة أوّلية في تصعيد تذاكر الأعطال للموردين. عند إعداد تذكرة، استخرج الإطارات 0x1568 أو 0x5226 ذات الصلة حول حدث الفشل، وحوّلها إلى ASN.1 مقروء، وأرفق كلاً من شريحة QMDL الخام والمخرجات المفكوكة. هذا التوليف يُزيل أي غموض حول ما أرسله الـ UE واستقبله فعلياً.

الخصوصية والأمان: تحتوي ملفات QMDL على IMSI وIMEI الجهاز في حزم NAS Attach وRegistration Request. قبل مشاركة أي ملف QMDL خارج مؤسستك — مع الموردين أو المشغّلين أو الشركاء — احذف أو أخفِ هوية حمولات NAS التي تحتوي على هذه المعرّفات. عدم القيام بذلك يُشكّل تسريباً للبيانات الشخصية، إذ يُعدّ IMSI معرّفاً للمشترك يمكن ربطه مباشرةً بشخص بعينه.

تخطيط التخزين: تُنتج حملة تحسين LTE/NR نموذجية ما بين 5 و20 جيجابايت من QMDL لكل جهاز يومياً. لفريق مؤلّف من أربعة مهندسين في حملة مدّتها أسبوعان، يتراوح ذلك بين 280 و1120 جيجابايت من البيانات الخام. خطّط لبنية تحتية للتخزين الميداني والنقل والأرشفة قبل بدء الحملة — لا بعدها.

خلاصة

QMDL ليس مجرد تنسيق ملف — إنه السجل الأكثر اكتمالاً لما جرى بين جهاز وشبكة على كل طبقة بروتوكول. معرفة كيفية التقاطه بكفاءة وتحليله بشكل صحيح واستخراج معرّفات الحزم الصحيحة يُميّز المهندس الذي يقول “رأيت فشل handover” عن ذلك الذي يستطيع إثباته بتسلسل RRC دقيق على مستوى الميلي ثانية.

المعرّفات الأربعة للحزم التي تغطّي 90٪ من سيناريوهات استكشاف الأخطاء الميدانية هي 0x1568 و0x5226 و0x713A و0x7030. أتقن قناع السجل الذي يُفعّلها، وافهم التأطير الشبيه بـ HDLC الذي يُهيكل الدفق الثنائي، وطبّق تحويل QTimerTick للربط الزمني الدقيق — وسيُصبح QMDL أداةً تشخيصية بدقّة المواصفة الشبكية ذاتها.

سؤال للتعليقات: ما هي أعقد مشكلة حللتها بتحليل QMDL — وأي معرّف حزمة كان المفتاح؟