تمت ترجمة هذه الصفحة بواسطة 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` إنشاء رسالة سجلّ على مستوى سجلّ تصحيح الأخطاء
`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` إنشاء رسالة سجلّ على مستوى سجلّ الملاحظة
`otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void` إنشاء رسالة سجلّ على مستوى سجلّ التحذير
`otLoggingGetLevel(void)`	`otLogLevel` لعرض مستوى السجلّ الحالي.
`otLoggingSetLevel(otLogLevel aLogLevel)`	`otError` لضبط مستوى السجلّ

الدوال

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`.

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,
  ...
) 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] ...`	وسيطات مواصفات التنسيق.

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] ...`	وسيطات مواصفات التنسيق.

otLogWarningPlat

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

إنشاء رسالة سجلّ على مستوى سجلّ التحذير

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

التفاصيل

المَعلمات

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

otLoginGetLevel

otLogLevel otLoggingGetLevel(
  void
)

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

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

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

otLoginSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

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

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

التفاصيل

المَعلمات

[in] aLogLevel

مستوى السجلّ

قيم الإرجاع

`OT_ERROR_NONE`	تم تعديل مستوى السجلّ بنجاح.
`OT_ERROR_INVALID_ARGS`	قيمة مستوى السجلّ غير صالحة.

الموارد

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