التسجيل - حزمة سلاسل المحادثات

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

الملخّص

الدوال

otDumpCritPlat(const char *aText, const void *aData, uint16_t aDataLength)
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, ...)
void
ترسل هذه الدالة رسالة سجلّ على مستوى سجلّ معيّن.
otLogCritPlat(const char *aFormat, ...)
void
ترسل هذه الدالة رسالة سجلّ على مستوى السجل المهم.
otLogDebgPlat(const char *aFormat, ...)
void
ترسل هذه الدالة رسالة سجلّ على مستوى سجل تصحيح الأخطاء.
otLogInfoPlat(const char *aFormat, ...)
void
ترسل هذه الدالة رسالة سجلّ على مستوى سجلّ المعلومات.
otLogNotePlat(const char *aFormat, ...)
void
ترسل هذه الدالة رسالة سجلّ على مستوى سجلّ الملاحظات.
otLogWarnPlat(const char *aFormat, ...)
void
ترسل هذه الدالة رسالة سجلّ على مستوى سجلّ التحذيرات.
otLoggingGetLevel(void)
تعرض هذه الدالة مستوى السجلّ الحالي.
otLoggingSetLevel(otLogLevel aLogLevel)
تحدّد هذه الدالة مستوى السجلّ.

الدوال

otDumpCritPlat

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.

otDumpWarningPlat

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,
  ...
)

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

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

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

otLogCritPlat

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

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

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

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

otLogDebgPlat

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

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

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

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

otLogInfoPlat

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

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

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

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

otLogNotePlat

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

ترسل هذه الدالة رسالة سجلّ على مستوى سجلّ الملاحظات.

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

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

otLogWarningPlat

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

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

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

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

otLoginGetLevel

otLogLevel otLoggingGetLevel(
  void
)

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

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

التفاصيل
طلبات الإرجاع
مستوى السجل.

otLoginSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

تحدّد هذه الدالة مستوى السجلّ.

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

المراجع

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