تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

تتضمن هذه الوحدة التعريفات ذات الصلة بتسجيل 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
)

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

التفاصيل

المَعلمات

`[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. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.

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

ملخّص

الدوال

الهياكل

الدوال

otDumpCritPlat

otDumpDebgPlat

otDumpInfoPlat

otDumpNotePlat

otDumpWarnPlat

otLogCli

otLogCritPlat

otLogDebgPlat

otLogGenerateNextHexDumpLine

otLogInfoPlat

otLogNotePlat

otLogPlat

otLogPlatArgs

otLogWarnPlat

otLoggingGetLevel

otLoggingSetLevel

وحدات ماكرو

OT_LOG_HEX_DUMP_LINE_SIZE

المراجِع