nl::Weave::التسجيل

تتضمن مساحة الاسم هذه جميع الواجهات ضمن Weave للحصول على دعم التسجيل المشترك.

الملخّص

وتتضمن الواجهات وحدات ماكرو وثوابت ودوال لواجهة واجهة تسجيل مستقلة عن حزمة Weave SDK.

يمكن لبرامج Weave SDK الاختيار في وقت التجميع بين عمليات تنفيذ نمط التسجيل Android أو C Standard I/O أو الخارجية (المحدّدة من خلال النظام الأساسي والمتكامل) التي سيتم استدعاؤها عند تأكيد أي من الرموز التالية لمعالج البيانات:

تعداد

@406 تعداد
LogCategory تعداد
تحدّد فئة تنتمي إليها رسالة خطأ معيّنة.
LogModule تعداد
يحدّد قسمًا منطقيًا للرمز وهو مصدر لرسائل السجلّ.

رفوف النوع

LogMessageFunct)(uint8_t module, uint8_t category, const char *msg, va_list ap) typedef
void(*

المتغيّرات

ModuleNames[]
const char
gLogFilter = kLogCategory_Max
uint8_t
gLogFunct = DefaultLogMessage
LogMessageFunct

الدوال

GetCategoryName(char *buf, uint8_t bufSize, uint8_t category)
void
GetLogFilter()
NL_DLL_EXPORT uint8_t
GetMessageWithPrefix(char *buf, uint8_t bufSize, uint8_t module, const char *msg)
void
GetModuleName(char *buf, uint8_t module)
void
Log(uint8_t module, uint8_t category, const char *msg, ...)
NL_DLL_EXPORT __WEAVE_LOGGING_LINK_ATTRIBUTE void
السجلّ، من خلال الآلية التي تحدّدها المنصّة، رسالة السجلّ المحدّدة، message، للوحدة المحدّدة، module، في الفئة المحدّدة، category.
PrintMessagePrefix(uint8_t module)
void
SetLogFilter(uint8_t category)
NL_DLL_EXPORT void
SetLogFunct(LogMessageFunct logFunct)
NL_DLL_EXPORT void

تعداد

@406

 @406

فئة التسجيل

 LogCategory

تحدّد فئة تنتمي إليها رسالة خطأ معيّنة.

وحدة السجلّ

 LogModule

يحدّد قسمًا منطقيًا للرمز وهو مصدر لرسائل السجلّ.

رفوف النوع

LogMessageFunct

void(* LogMessageFunct)(uint8_t module, uint8_t category, const char *msg, va_list ap)

المتغيّرات

أسماء الوحدات

const char ModuleNames[]

فلترة gLog

uint8_t gLogFilter = kLogCategory_Max

سجلّ gLogFunct

LogMessageFunct gLogFunct = DefaultLogMessage

الدوال

اسم الفئة

void GetCategoryName(
  char *buf,
  uint8_t bufSize,
  uint8_t category
)

_GetGetFilter

NL_DLL_EXPORT uint8_t GetLogFilter()

GetMessageWithPrefix

void GetMessageWithPrefix(
  char *buf,
  uint8_t bufSize,
  uint8_t module,
  const char *msg
)

GetUnitName

void GetModuleName(
  char *buf,
  uint8_t module
)

سجل

NL_DLL_EXPORT __WEAVE_LOGGING_LINK_ATTRIBUTE void Log(
  uint8_t module,
  uint8_t category,
  const char *msg,
  ...
)

السجلّ، من خلال الآلية التي تحدّدها المنصّة، رسالة السجلّ المحدّدة، message، للوحدة المحدّدة، module، في الفئة المحدّدة، category.

التفاصيل
المعلَمات
[in] module
تعداد LogModule يشير إلى مصدر وحدة حزمة Weave التي أنشأت رسالة السجل. يجب ترجمة ذلك في الدالة إلى اسم وحدة لتضمينه في رسالة السجل.
[in] category
تعداد LogCategory يشير إلى فئة رسالة السجل. قد تتم تصفية الفئة أو خارجها إذا تم تأكيد WEAVE_LOG_FILTERING.
[in] msg
مؤشر إلى سلسلة C تم إنهاؤها بشكل خالٍ مع تحديدات التنسيق على شكل مكتبة C العادية التي تحتوي على رسالة السجل المطلوب تنسيقها وتسجيلها.
[in] ...
قائمة وسيطات متغيرة يجب أن تتوافق عناصرها مع محدّدات التنسيق في message.

بادئة الطباعة

void PrintMessagePrefix(
  uint8_t module
)

فلتر LogLog

NL_DLL_EXPORT void SetLogFilter(
  uint8_t category
)

ضبط السجلّ

NL_DLL_EXPORT void SetLogFunct(
  LogMessageFunct logFunct
)