التسجيل - تكديس سلاسل المحادثات

تتضمن هذه الوحدة التعريفات ذات الصلة بتسجيل OpenThread.

ملخّص

الدوال
otDumpCritPlat(const char *aText, const void *aData, uint16_t aDataLength)	void void void void void void تنشئ عملية تفريغ الذاكرة على مستوى السجلّ الحرج.
otDumpDebgPlat(const char *aText, const void *aData, uint16_t aDataLength)	void تؤدي إلى إنشاء تفريغ الذاكرة على مستوى سجل تصحيح الأخطاء.
otDumpInfoPlat(const char *aText, const void *aData, uint16_t aDataLength)	void تؤدي إلى إنشاء تفريغ الذاكرة على مستوى سجلّ المعلومات.
otDumpNotePlat(const char *aText, const void *aData, uint16_t aDataLength)	void تؤدي إلى إنشاء عملية تفريغ الذاكرة على مستوى سجلّ الملاحظات.
otDumpWarnPlat(const char *aText, const void *aData, uint16_t aDataLength)	void تؤدي هذه السياسة إلى إنشاء تفريغ الذاكرة على مستوى سجلّ التحذير.
otLogCli(otLogLevel aLogLevel, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2	void يؤدي إلى إصدار رسالة سجل على مستوى سجل معين.
otLogCritPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void يصدر رسالة سجلّ على مستوى السجلّ المهم.
otLogDebgPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void void void void يؤدي إلى إصدار رسالة سجل على مستوى سجل تصحيح الأخطاء.
otLogGenerateNextHexDumpLine(otLogHexDumpInfo *aInfo)	otError لإنشاء سطر التفريغ السداسي العشري التالي.
otLogInfoPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void void void يصدر رسالة سجل على مستوى سجل المعلومات.
otLogNotePlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void void لإصدار رسالة سجل على مستوى سجل الملاحظات.
otLogPlat(otLogLevel aLogLevel, const char *aPlatModuleName, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3	void يؤدي إلى إصدار رسالة سجل على مستوى سجل معين باستخدام اسم وحدة النظام الأساسي.
otLogPlatArgs(otLogLevel aLogLevel, const char *aPlatModuleName, const char *aFormat, va_list aArgs)	void void يؤدي إلى إصدار رسالة سجل على مستوى سجل معين باستخدام اسم وحدة النظام الأساسي.
otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void يصدر رسالة السجل على مستوى سجل التحذير.
otLoggingGetLevel(void)	otLogLevel لعرض مستوى السجل الحالي.
otLoggingSetLevel(otLogLevel aLogLevel)	otError لضبط مستوى السجلّ.

الهياكل
otLogHexDumpInfo	يمثل هذا التمثيل المعلومات المستخدمة لإنشاء إخراج تفريغ سداسي.

الدوال

otDumpCritPlat

void void void void void void otDumpCritPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

تنشئ عملية تفريغ الذاكرة على مستوى السجلّ الحرج.

إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو OPENTHREAD_CONFIG_LOG_PKT_DUMP أو كان مستوى السجلّ الحالي أقل من درجة الأهمية، لن تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aText يشير ذلك المصطلح إلى سلسلة تتم طباعتها قبل وحدات البايت. [in] aData يشير هذا المصطلح إلى مؤشر المخزن المؤقت للبيانات. [in] aDataLength عدد وحدات البايت في aData.

otDumpDebgPlat

void otDumpDebgPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

تؤدي إلى إنشاء تفريغ الذاكرة على مستوى سجل تصحيح الأخطاء.

إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو OPENTHREAD_CONFIG_LOG_PKT_DUMP أو كان مستوى السجلّ الحالي أقل من تصحيح الأخطاء، لن تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aText يشير ذلك المصطلح إلى سلسلة تتم طباعتها قبل وحدات البايت. [in] aData يشير هذا المصطلح إلى مؤشر المخزن المؤقت للبيانات. [in] aDataLength عدد وحدات البايت في aData.

otDumpInfoPlat

void otDumpInfoPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

تؤدي إلى إنشاء تفريغ الذاكرة على مستوى سجلّ المعلومات.

إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو OPENTHREAD_CONFIG_LOG_PKT_DUMP أو كان مستوى السجلّ الحالي أقل من المعلومات، لن تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aText يشير ذلك المصطلح إلى سلسلة تتم طباعتها قبل وحدات البايت. [in] aData يشير هذا المصطلح إلى مؤشر المخزن المؤقت للبيانات. [in] aDataLength عدد وحدات البايت في aData.

otDumpNotePlat

void otDumpNotePlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

تؤدي إلى إنشاء عملية تفريغ الذاكرة على مستوى سجلّ الملاحظات.

إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو OPENTHREAD_CONFIG_LOG_PKT_DUMP أو كان مستوى السجلّ الحالي أقل من ذلك، لا تُصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aText يشير ذلك المصطلح إلى سلسلة تتم طباعتها قبل وحدات البايت. [in] aData يشير هذا المصطلح إلى مؤشر المخزن المؤقت للبيانات. [in] aDataLength عدد وحدات البايت في aData.

otDumpWarnPlat

void otDumpWarnPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

تؤدي هذه السياسة إلى إنشاء تفريغ الذاكرة على مستوى سجلّ التحذير.

إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو OPENTHREAD_CONFIG_LOG_PKT_DUMP أو كان مستوى السجلّ الحالي أقل من تحذير، لن تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aText يشير ذلك المصطلح إلى سلسلة تتم طباعتها قبل وحدات البايت. [in] aData يشير هذا المصطلح إلى مؤشر المخزن المؤقت للبيانات. [in] aDataLength عدد وحدات البايت في aData.

otLogCli

void otLogCli(
  otLogLevel aLogLevel,
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2

يؤدي إلى إصدار رسالة سجل على مستوى سجل معين.

مصمَّم للاستخدام من قِبل واجهة سطر الأوامر (CLI) فقط. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_CLI أو كان مستوى السجلّ الحالي أقل من مستوى السجلّ المُعيَّن، لا تُصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aLogLevel مستوى السجلّ. [in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLogCritPlat

void otLogCritPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

يصدر رسالة سجلّ على مستوى السجلّ المهم.

وهي مُعدّة للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجلّ الحالي أقل من "حرج"، لن تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLogDebgPlat

void void void void void otLogDebgPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

يؤدي إلى إصدار رسالة سجل على مستوى سجل تصحيح الأخطاء.

وهي مُعدّة للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجلّ الحالي أقل من تصحيح الأخطاء، لا تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLogGenerateNextHexDumpLine

otError otLogGenerateNextHexDumpLine(
  otLogHexDumpInfo *aInfo
)

لإنشاء سطر التفريغ السداسي العشري التالي.

يمكن استدعاء هذه الطريقة بشكل متتالي لإنشاء التفريغ السداسي العشري سطرًا تلو الآخر. في الاستدعاء الأول، يجب ضبط الحقل mIterator في aInfo على صفر.

في ما يلي مثال على إخراج التفريغ السداسي العشري الذي تم إنشاؤه:

"==========================[{mTitle} len=070]============================" "| 41 D8 87 34 12 FF FF 25 | 4C 57 DA F2 FB 2F 62 7F | A..4...%LW.../b. |" "| 3B 01 F0 4D 4C 4D 4C 54 | 4F 00 15 15 00 00 00 00 | ;..MLMLTO....... |" "| 00 00 00 01 80 DB 60 82 | 7E 33 72 3B CC B3 A1 84 | ......`.~3r;.... |" "| 3B E6 AD B2 0B 45 E7 45 | C5 B9 00 1A CB 2D 6D 1C | ;....E.E.....-m. |" "| 10 3E 3C F5 D3 70 | | .><..p |" "------------------------------------------------------------------------"

التفاصيل
المَعلمات	[in,out] aInfo مؤشر يشير إلى otLogHexDumpInfo لاستخدامه في إنشاء تفريغ سداسي عشري.
قيم الإرجاع	OT_ERROR_NONE تم إنشاء السطر التالي بنجاح، وتم تعديل الحقل "mLine" في aInfo. OT_ERROR_NOT_FOUND لقد وصلت إلى النهاية وليس هناك المزيد من الخطوط المطلوب إنشاؤها.

otLogInfoPlat

void void void void otLogInfoPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

يصدر رسالة سجل على مستوى سجل المعلومات.

وهي مُعدّة للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجلّ الحالي أقل من المعلومات، لا تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLogNotePlat

void void void otLogNotePlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

لإصدار رسالة سجل على مستوى سجل الملاحظات.

وهي مُعدّة للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجلّ الحالي أقل من الملاحظة، لا تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLogPlat

void otLogPlat(
  otLogLevel aLogLevel,
  const char *aPlatModuleName,
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3

يؤدي إلى إصدار رسالة سجل على مستوى سجل معين باستخدام اسم وحدة النظام الأساسي.

إنّ هذا النموذج مخصّص للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجل الحالي أقل من aLogLevel، لن تصدر هذه الدالة أي رسالة سجلّ.

يُستخدَم اسم aPlatModuleName لتحديد اسم وحدة السجلّ في رسالة السجلّ الصادرة، باتّباع التنسيق P-{PlatModuleName}---. وهذا يعني أنّه تتم إضافة سلسلة البادئة "P-" للإشارة إلى أنّ هذه وحدة فرعية للنظام الأساسي، تليها الأحرف الـ 12 التالية من سلسلة PlatModuleName، مع واصلات مبطّنة - في نهايتها للتأكّد من أنّ اسم المنطقة مكوّن من 14 حرفًا.

التفاصيل
المَعلمات	[in] aLogLevel مستوى السجلّ. [in] aPlatModuleName اسم الوحدة الفرعية للنظام الأساسي. [in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLogPlatArgs

void void otLogPlatArgs(
  otLogLevel aLogLevel,
  const char *aPlatModuleName,
  const char *aFormat,
  va_list aArgs
)

يؤدي إلى إصدار رسالة سجل على مستوى سجل معين باستخدام اسم وحدة النظام الأساسي.

إنّ هذا النموذج مخصّص للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجل الحالي أقل من aLogLevel، لن تصدر هذه الدالة أي رسالة سجلّ.

يُستخدَم اسم aPlatModuleName لتحديد اسم وحدة السجلّ في رسالة السجلّ الصادرة، باتّباع التنسيق P-{PlatModuleName}---. وهذا يعني أنّه تتم إضافة سلسلة البادئة "P-" للإشارة إلى أنّ هذه وحدة فرعية للنظام الأساسي، تليها الأحرف الـ 12 التالية من سلسلة PlatModuleName، مع واصلات مبطّنة - في نهايتها للتأكّد من أنّ اسم المنطقة مكوّن من 14 حرفًا.

التفاصيل
المَعلمات	[in] aLogLevel مستوى السجلّ. [in] aPlatModuleName اسم الوحدة الفرعية للنظام الأساسي. [in] aFormat سلسلة التنسيق. [in] aArgs الوسيطات الخاصة بمواصفات التنسيق

otLogWarnPlat

void void otLogWarnPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

يصدر رسالة السجل على مستوى سجل التحذير.

وهي مُعدّة للاستخدام من قِبل المنصة. إذا لم يتم ضبط OPENTHREAD_CONFIG_LOG_PLATFORM أو كان مستوى السجلّ الحالي أقل من تحذير، لا تصدر هذه الدالة أي رسالة سجلّ.

التفاصيل
المَعلمات	[in] aFormat سلسلة التنسيق. [in] ... الوسيطات الخاصة بمواصفات التنسيق

otLoggingGetLevel

otLogLevel otLoggingGetLevel(
  void
)

لعرض مستوى السجل الحالي.

إذا تم تفعيل ميزة مستوى السجل الديناميكي OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE، ستعرض هذه الدالة مستوى السجل الديناميكي المحدد حاليًا. بخلاف ذلك، تعرض هذه الدالة مستوى السجل الذي تم ضبطه في وقت الإنشاء.

التفاصيل
المرتجعات	مستوى السجلّ.

otLoggingSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

لضبط مستوى السجلّ.

ملاحظة: تتطلب هذه الدالة الدالة OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1.

التفاصيل
المَعلمات	[in] aLogLevel مستوى السجلّ.
قيم الإرجاع	OT_ERROR_NONE تم تعديل مستوى السجلّ بنجاح. OT_ERROR_INVALID_ARGS قيمة مستوى السجلّ غير صالحة.

وحدات ماكرو

OT_LOG_HEX_DUMP_LINE_SIZE

 OT_LOG_HEX_DUMP_LINE_SIZE 73

حجم سلسلة التفريغ الست عشرية

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.