nl :: نسج:: مظهر:: إدارة البيانات_الحالية

تتضمن مساحة الاسم هذه جميع الواجهات داخل Weave لملف تعريف Weave Data Management (WDM) المدعومة حاليًا للاستخدام الإنتاجي.

ملخص

التعداد

@100 {
kTag_Region = 1,
kTag_Message = 2
}
تعداد
علامات لـ kNestDebug_StringLogEntryEvent.
@101 {
kTag_Token = 1,
kTag_Args = 2
}
تعداد
علامات لحدث kNestDebug_TokenizedLogEntryEvent.
@102 تعداد
علامات للأحداث المستمرة.
@104 تعداد
أنواع رسائل ملف تعريف WDM.
@105 تعداد
رموز الحالة الخاصة بـ WDM.
@147 تعداد
@95 {
kTag_CurrentImportance = 1,
kTag_ImportanceExpiration ,
kTag_MinimumLogUploadInterval ,
kTag_MaximumLogUploadInterval ,
kTag_LoggingDestination ,
kTag_TraitLoggingImportance
}
تعداد
تسجيل علامات الضبط.
@96 {
kTag_SupportedLogTransports = 1,
kTag_SupportsStreaming = 2,
kTag_SupportsNonVolatileStorage = 3,
kTag_SupportsPerTraitVerbosity = 4,
kTag_LoggingVolume = 5,
kTag_LogBufferingCapacity = 6
}
تعداد
علامات لإمكانيات التسجيل.
@97 {
kTag_EventSource = 1,
kTag_EventImportance = 2,
kTag_EventID = 3,
kTag_RelatedEventImportance = 10,
kTag_RelatedEventID = 11,
kTag_EventUTCTimestamp = 12,
kTag_EventSystemTimestamp = 13,
kTag_EventResourceID = 14,
kTag_EventTraitProfileID = 15,
kTag_EventTraitInstanceID = 16,
kTag_EventType = 17,
kTag_EventDeltaUTCTime = 30,
kTag_EventDeltaSystemTime = 31,
kTag_EventData = 50,
kTag_ExternalEventStructure = 99
}
تعداد
علامات للبيانات الوصفية للحدث.
@98 تعداد
تعريفات الملف الشخصي لسمة التصحيح.
@99 {
kNestDebug_StringLogEntryEvent = 1,
kNestDebug_TokenizedLogEntryEvent = 2,
kNestDebug_TokenizedHeaderEntryEvent = 3
}
تعداد
أنواع الأحداث لسمة Nest Debug.
CommandFlags {
kCommandFlag_MustBeVersionValid = 0x0001,
kCommandFlag_InitiationTimeValid = 0x0002,
kCommandFlag_ActionTimeValid = 0x0004,
kCommandFlag_ExpiryTimeValid = 0x0008,
kCommandFlag_IsOneWay = 0x0010
}
تعداد
ImportanceType {
ProductionCritical = 1,
Production ,
Info ,
Debug
}
تعداد
أهمية إدخال السجل.
LoggingManagementStates {
kLoggingManagementState_Idle = 1,
kLoggingManagementState_InProgress = 2,
kLoggingManagementState_Holdoff = 3,
kLoggingManagementState_Shutdown = 4
}
تعداد
TimestampType تعداد
صحة ونوع من الطابع الزمني المدرجة في EventOptions .

النوع

CommandFlags typedef
DataVersion typedef
uint64_t
EventProcessor typedef
void *
EventWriterFunct )(nl::Weave::TLV::TLVWriter &ioWriter, uint8_t inDataTag, void *appData) typedef
دالة توفر عنصر eventData للنظام الفرعي لتسجيل الأحداث.
FetchExternalEventsFunct )(EventLoadOutContext *aContext) typedef
نموذج أولي لوظيفة عمليات رد نداءات النظام الأساسي التي تجلب بيانات الحدث.
GenericTraitSinkCatalog typedef
GenericTraitSourceCatalog typedef
ImportanceType typedef
أهمية إدخال السجل.
IteratorCallback )(void *aTraitInstance, TraitDataHandle aHandle, void *aContext) typedef
void(*
مكرر مقبض السمة.
LoggingBufferHandler )(void *inAppState, PacketBuffer *inBuffer) typedef
NotifyExternalEventsDeliveredFunct )(ExternalEvents *inEv, event_id_t inLastDeliveredEventID, uint64_t inRecipientNodeID) typedef
void(*
يتم استدعاء نموذج أولي لوظيفة رد اتصال عند تسليم أحداث خارجية إلى المشترك البعيد.
NotifyExternalEventsEvictedFunct )(ExternalEvents *inEv) typedef
void(*
تم استدعاء نموذج أولي لوظيفة رد اتصال عند طرد الأحداث الخارجية من المخازن المؤقتة.
PropertyDictionaryKey typedef
uint16_t
PropertyPathHandle typedef
uint32_t
PropertyPathHandle عبارة عن تجزئة رقمية فريدة 32 بت لمسار WDM بالنسبة إلى جذر مثيل سمة.
PropertySchemaHandle typedef
uint16_t
SchemaVersion typedef
uint16_t
SingleResourceSinkTraitCatalog typedef
SingleResourceSourceTraitCatalog typedef
TimestampType typedef
صحة ونوع من الطابع الزمني المدرجة في EventOptions .
TraitDataHandle typedef
uint16_t
duration_t nl :: Weave :: Profiles :: DataManagement_Current :: duration_t
uint32_t
النوع المستخدم لوصف المدة بالمللي ثانية.
event_id_t nl :: Weave :: Profiles :: DataManagement_Current :: event_id_t
uint32_t
نوع معرف الحدث.
timestamp_t nl :: Weave :: Profiles :: DataManagement_Current :: timestamp_t
uint32_t
النوع المستخدم لوصف الطابع الزمني بالمللي ثانية.
utc_timestamp_t nl :: Weave :: Profiles :: DataManagement_Current :: utc_timestamp_t
uint64_t
النوع المستخدم لوصف الطابع الزمني UTC بالمللي ثانية.

المتغيرات

sInstance
sLogFileName = "topazlog"[]
char

المهام

BdxErrorHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, WEAVE_ERROR aErrorCode)
void
BdxGetBlockHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, uint64_t *aLength, uint8_t **aDataBlock, bool *aIsLastBlock)
void
BdxRejectHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aReport)
void
BdxSendAcceptHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::BulkDataTransfer::SendAccept *aSendAcceptMsg)
BdxXferDoneHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer)
void
BdxXferErrorHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aXferError)
void
CreatePropertyPathHandle (PropertySchemaHandle aPropertyPathSchemaId, PropertyDictionaryKey aPropertyPathDictionaryKey)
EventWriterTLVCopy (TLVWriter & ioWriter, uint8_t inDataTag, void *appData)
وظيفة مساعد تترجم عنصر بيانات حدث متسلسل بالفعل إلى المخزن المؤقت للحدث.
GetPropertyDictionaryKey ( PropertyPathHandle aHandle)
PropertyDictionaryKey
GetPropertySchemaHandle ( PropertyPathHandle aHandle)
PropertySchemaHandle
IsNullPropertyPathHandle ( PropertyPathHandle aHandle)
bool
IsRootPropertyPathHandle ( PropertyPathHandle aHandle)
bool
IsVersionNewer (const DataVersion & aVersion, const DataVersion & aReference)
bool
هذا هو التنفيذ الأمثل للخوارزمية لمقارنة الإصدارات.
IsVersionNewerOrEqual (const DataVersion & aVersion, const DataVersion & aReference)
bool
Locate (TraitDataHandle aTraitDataHandle, const TraitCatalogBase < TraitDataSink > *aDataSinkCatalog)
وظيفة الأداة التي يجد TraitUpdatableDataSink في TraitDataSink التسويقي.
LogEvent (const EventSchema & inSchema,nl::Weave::TLV::TLVReader & inData)
سجل حدثًا من نموذج مُسلسل مسبقًا.
LogEvent (const EventSchema & inSchema,nl::Weave::TLV::TLVReader & inData, const EventOptions *inOptions)
سجل حدثًا من نموذج مُسلسل مسبقًا ، مع خيارات إضافية.
LogEvent (const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData)
سجل حدثا عبر رد الاتصال.
LogEvent (const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData, const EventOptions *inOptions)
سجل حدثًا عبر رد اتصال ، مع خيارات.
LogFreeform ( ImportanceType inImportance, const char *inFormat, ...)
LogFreeform يرسل سلسلة حرة إلى دفق الحدث الافتراضي.
LookForElementWithTag (constnl::Weave::TLV::TLVReader & aSrcReader, const uint64_t aTagInApiForm,nl::Weave::TLV::TLVReader *apDstReader)
PlainTextWriter (TLVWriter & ioWriter, uint8_t inDataTag, void *appData)
وظيفة مساعدة لإرسال نص حر كحدث تصحيح.
PlainTextWriter (::nl::Weave::TLV::TLVWriter & ioWriter, uint8_t inDataTag, void *appData)
وظيفة مساعدة لإرسال نص حر كحدث تصحيح.
operator!= (const ResourceIdentifier & lhs, const ResourceIdentifier & rhs)
bool
operator== (const ResourceIdentifier & lhs, const ResourceIdentifier & rhs)
bool

الطبقات

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current AlwaysAcceptDataElementAccessControlDelegate
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current BuilderBase

الفئة الأساسية لمشفرات رسائل WDM.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current CircularEventReader

A TLVReader مدعومة CircularEventBuffer .

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current القيادة
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current CommandSender
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current GenericTraitCatalogImpl

توفير نسج تنفيذ TraitCatalogBase واجهة لمجموعة من الحالات البيانات السمات الشخصية التي تشير جميعها إلى نفس الموارد.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current IDataElementAccessControlDelegate

الواجهة التي سيتم تنفيذها بواسطة معالج عناصر البيانات في NotifyRequest.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current IDirtyPathCut
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current IPathFilter
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current IWeavePublisherLock

واجهة يتم تنفيذها بواسطة التطبيق لتسلسل الوصول إلى هياكل بيانات WDM الرئيسية.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current IWeaveWDMMutex

واجهة كائن كائن المزامنة (mutex).

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ListBuilderBase

الفئة الأساسية لتشفير رسالة WDM، المتخصصة في TLV عناصر مجموعة مثل قوائم بيانات وقوائم الإصدار.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ListParserBase

الفئة الأساسية لموزعي رسالة WDM، المتخصصة في TLV عناصر مجموعة مثل قوائم بيانات وقوائم الإصدار.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current LogBDXUpload
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current LoggingConfiguration

LoggingConfiguration بتغليف عنصر شكلي من نسج الحدث تسجيل الفرعي.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current LoggingManagement

فئة لإدارة سجلات أحداث الذاكرة.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current NotificationEngine
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ParserBase

الفئة الأساسية لموزعي رسائل WDM.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ResourceIdentifier

هيكل يغلف معرّف المورد.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SingleResourceTraitCatalog
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscriptionClient
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscriptionEngine

هذا هو مفرد يستضيف جميع اشتراكات WDM Next ، سواء من جانب العميل أو الناشر.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscriptionHandler
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitCatalogBase
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitDataSink
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitDataSource
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitSchemaEngine

يأخذ محرك المخطط معلومات المخطط المرتبطة بسمة معينة ويوفر تسهيلات لتحليلها وترجمتها إلى نموذج يمكن استخدامه بواسطة آلية WDM.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitUpdatableDataSink
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current UpdateClient
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current UpdateDictionaryDirtyPathCut

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

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current UpdateDirtyPathFilter

فئة المنفعة لتصفية المسار عند التعامل مع الإخطار.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current UpdateEncoder

هذا الكائن تشفير WDM UpdateRequest وPartialUpdateRequest الحمولات.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ViewClient

الهياكل

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current CircularEventBuffer

عازلة حدث داخلي، تتمحور حول NL :: :: نسج TLV :: WeaveCircularTLVBuffer .

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ConstSchemaVersionRange
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current CopyAndAdjustDeltaTimeContext

الهيكل الداخلي لاجتياز قائمة الأحداث.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current DebugLogContext
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current DetailedRootSection

الهيكل الذي يوفر دقة كاملة لمثيل السمة.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current EventEnvelopeContext

الهيكل الداخلي لاجتياز الأحداث.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current EventLoadOutContext

هيكل لنسخ قوائم الأحداث عند الإخراج.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current EventOptions

الهيكل الذي يوفر خيارات لحقول الأحداث المختلفة.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current EventSchema

البنية التي تحدد مخططًا للبيانات الوصفية للأحداث.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ExternalEvents

هيكل لتتبع الأحداث المخزنة على النظام الأساسي.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current LogStorageResources

فئة المساعد المستخدمة في تهيئة إدارة التسجيل.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ReclaimEventCtx
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SchemaVersionRange
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitPath
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current TraitPathStore
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current VersionedTraitPath

النقابات

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current الطابع الزمني

الاتحاد الذي يوفر نظام تعيين التطبيق أو الطابع الزمني UTC.

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

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current BaseMessageWithSubscribeId
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current CustomCommand

WDM مخصص القيادة التعريف.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current CustomCommandResponse

WDM مخصص القيادة تعريف الاستجابة.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current DataElement

تعريف عنصر بيانات WDM.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current Datalist على
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current الحدث
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current EventList
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current NotificationRequest
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current مسار

إدارة الطلب على المياه مسار التعريف.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current PathList

إدارة الطلب على المياه مسار تعريف قائمة.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current منصة
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current RejectionRecord
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current RejectionRecordList
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current StatusElement

تعريف عنصر حالة WDM.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current StatusList
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscribeCancelRequest
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscribeConfirmRequest
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscribeRequest
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current SubscribeResponse
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current UpdateRequest

تعريف طلب تحديث WDM.

نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current UpdateResponse
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current VersionList
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ViewRequest
نيكولا لانغ :: :: نسج الملامح :: :: DataManagement_Current ViewResponse

التعداد

@ 100

 @100

علامات لـ kNestDebug_StringLogEntryEvent.

الخصائص
kTag_Message

سلسلة تحتوي على رسالة التصحيح الفعلية.

kTag_Region

32 بت غير موقعة تشير إلى منطقة السجل ، أي الوحدة النمطية التي تنتمي إليها رسالة السجل.

@ 101

 @101

علامات لحدث kNestDebug_TokenizedLogEntryEvent.

الخصائص
kTag_Args

مصفوفة من الوسائط التي سيتم إرسالها مع رسالة الرمز المميز.

kTag_Token

قيمة بدون إشارة 32 بت تتوافق مع الرمز المميز.

@ 102

 @102

علامات للأحداث المستمرة.

@ 104

 @104

أنواع رسائل ملف تعريف WDM.

يتم استدعاء هذه القيم في مواصفات إدارة البيانات.

@ 105

 @105

رموز الحالة الخاصة بـ WDM.

@ 147

 @147

@ 95

 @95

تسجيل علامات الضبط.

الخصائص
kTag_CurrentImportance

أهمية التسجيل الحالية ، القيمة من النوع ImportanceType.

kTag_ImportanceExpiration

الوقت بالثواني بالتوقيت العالمي المنسق عندما تعود إعدادات التسجيل المرتفعة الحالية إلى القيم الافتراضية.

kTag_LoggingDestination

عنوان URL يشير إلى وجهة تحميل السجل.

kTag_MaximumLogUploadInterval

المدة القصوى ، بالثواني ، بين محاولات تحميل السجل التي يتم تشغيلها تلقائيًا.

kTag_MinimumLogUploadInterval

أقل مدة ، بالثواني ، بين محاولات تحميل السجل التي يتم تشغيلها تلقائيًا.

kTag_TraitLoggingImportance

مصفوفة اختيارية تعين بشكل انتقائي ملفات التعريف المختارة على مستويات التسجيل الأعلى.

يأخذ كل عنصر في المصفوفة شكلاً (ملف تعريف ، مسار ، أهمية التسجيل) لرفع التسجيل بشكل انتقائي من مجموعة فرعية من النظام. تكون أولوية تسجيل ملف التعريف المرتفعة ذات أهمية فقط عندما تتجاوز أولوية التسجيل الأولوية الحالية وتخضع لنفس وقت انتهاء الصلاحية الحالي للأهمية.

@ 96

 @96

علامات لإمكانيات التسجيل.

الخصائص
kTag_LogBufferingCapacity

عدد صحيح بدون إشارة يبلغ 32 بت يصف سعة التخزين المؤقت للسجل بالكيلو بايت.

kTag_LoggingVolume

عدد صحيح بدون إشارة يبلغ 32 بت يصف حجم التسجيل المتوقع بالكيلو بايت / يوم.

kTag_SupportedLogTransports

مجموعة من آليات نقل السجل المدعومة.

kTag_SupportsNonVolatileStorage

قيمة منطقية تشير إلى ما إذا كان الجهاز يدعم تخزين السجلات غير المتطايرة.

kTag_SupportsPerTraitVerbosity

قيمة منطقية تشير إلى ما إذا كان الجهاز يدعم إعدادات الإسهاب لكل سمة.

kTag_SupportsStreaming

قيمة منطقية تشير إلى ما إذا كان الجهاز يدعم تدفق السجلات.

@ 97

 @97

علامات للبيانات الوصفية للحدث.

للحصول على دلالات كاملة لقيم العلامة ، راجع مواصفات تصميم الحدث.

الخصائص
kTag_EventData

اختياري. بيانات الحدث نفسها. إذا كان فارغًا ، فسيتم تعيينه افتراضيًا على هيكل فارغ.

kTag_EventDeltaSystemTime

العلامة الداخلية لـ WDM ، فرق التوقيت عن الحدث السابق في الترميز.

kTag_EventDeltaUTCTime

العلامة الداخلية لـ WDM ، فرق التوقيت عن الحدث السابق في الترميز.

kTag_EventID

رقم تسلسلي للحدث ، معبرًا عنه بكمية غير موقعة 64 بت.

يجب أن تكون متتالية ، تشير القفزات في التسلسل إلى فجوات الأحداث.

kTag_EventImportance

أهمية الحدث.

kTag_EventResourceID

اختياري.

القيمة هي معرّف المورد الذي ينتمي إليه الحدث. عند حذفها ، تكون القيمة هي نفس قيمة kTag_EventSource

kTag_EventSource

NodeID للجهاز الذي أنشأ الحدث.

kTag_EventSystemTimestamp

اختياري. نظام الطابع الزمني للحدث في ميلي ثانية.

kTag_EventTraitInstanceID

اختياري ، مثال السمة التي ولدت الحدث.

kTag_EventTraitProfileID

إلزامي. عدد صحيح بدون إشارة 32 بت يساوي ProfileID للسمة.

kTag_EventType

إلزامي. عدد صحيح 16 بت بدون إشارة يساوي wdl.event.id لهذا النوع من الأحداث.

kTag_EventUTCTimestamp

اختياري. UTC الطابع الزمني للحدث في ميلي ثانية.

kTag_ExternalEventStructure

علامة داخلية للأحداث الخارجية. لا تنتقل أبدًا عبر السلك ، ولا ينبغي أبدًا استخدامها خارج مكتبة Weave.

kTag_RelatedEventID

اختياري.

معرّف الحدث المرتبط به هذا الحدث. إذا تم حذفها ، فإن القيمة تساوي قيمة kTag_EventID.

kTag_RelatedEventImportance

اختياري.

أهمية الحدث ذي الصلة. إذا تم حذفها ، فإن القيمة تساوي قيمة kTag_EventImportance.

@ 98

 @98

تعريفات الملف الشخصي لسمة التصحيح.

@ 99

 @99

أنواع الأحداث لسمة Nest Debug.

الخصائص
kNestDebug_StringLogEntryEvent

حدث لرسالة تصحيح أخطاء سلسلة الشكل الحر.

kNestDebug_TokenizedHeaderEntryEvent

حدث لنقل معلومات الرأس المميزة.

kNestDebug_TokenizedLogEntryEvent

حدث لرسالة تصحيح الأخطاء المميزة.

CommandFlags

 CommandFlags
الخصائص
kCommandFlag_ActionTimeValid

حدد عندما يكون وقت العمل صالحًا.

kCommandFlag_ExpiryTimeValid

حدد وقت انتهاء الصلاحية.

kCommandFlag_InitiationTimeValid

حدد عندما يكون وقت البادئ صالحًا.

kCommandFlag_IsOneWay

اضبط عندما يكون الأمر في اتجاه واحد.

kCommandFlag_MustBeVersionValid

حدد وقت صلاحية حقل الإصدار.

النوع

 ImportanceType

أهمية إدخال السجل.

تُستخدم الأهمية كطريقة لتصفية الأحداث قبل إرسالها فعليًا إلى السجل. بعد تسجيل الحدث في السجل ، لا نضع أي أحكام أخرى لشطبها من السجل. يعمل مستوى الأهمية على تحديد أولويات تخزين الحدث. إذا تمت إضافة حدث ذي أهمية عالية إلى مخزن مؤقت كامل ، فسيتم إسقاط الأحداث حسب الأهمية (والعمر) لاستيعابها. على هذا النحو ، مستويات الأهمية لها قيمة نسبية فقط. إذا كان النظام يستخدم مستوى أهمية واحدًا فقط ، فسيتم إسقاط الأحداث بترتيب العمر فقط ، مثل المخزن المؤقت الدائري.

الخصائص
Debug

تشير أهمية التصحيح إلى إدخالات السجل التي تهم مطوري النظام وتستخدم بشكل أساسي في مرحلة التطوير.

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

Info

تشير أهمية المعلومات إلى إدخالات السجل التي توفر إحصاءات وتشخيصات إضافية في النظام قيد التشغيل.

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

Production

تشير أهمية الإنتاج إلى إدخالات السجل المستخدمة في المراقبة المستمرة وصيانة نظام Nest البيئي.

على الأجهزة المقيدة ، يجب حساب الإدخالات التي تم تسجيلها بأهمية الإنتاج في ميزانية الطاقة والذاكرة ، حيث من المتوقع أن يتم تسجيلها وتفريغها دائمًا من الجهاز.

ProductionCritical

تشير الأهمية الحرجة للإنتاج إلى الأحداث التي قد تؤثر خسارتها بشكل مباشر على ميزات التعامل مع العملاء.

قد تستخدم التطبيقات فقدان الإنتاج الحرجة الأحداث للإشارة إلى فشل النظام. بالنسبة للأجهزة المقيدة ، يجب مراعاة الإدخالات التي تم تسجيلها بأهمية حرجة للإنتاج في ميزانية الطاقة والذاكرة ، حيث من المتوقع أن يتم تسجيلها وتفريغها دائمًا من الجهاز.

إدارة السجلات

 LoggingManagementStates
الخصائص
kLoggingManagementState_Holdoff

اكتمل إلغاء تحميل السجل ؛ لا نقوم بإعادة تشغيل السجل حتى تنتهي صلاحية التعليق.

kLoggingManagementState_Idle

لا يوجد إلغاء تحميل سجل قيد التقدم ، يمكن أن يبدأ إلغاء تحميل السجل دون أي قيود.

kLoggingManagementState_InProgress

تسجيل إلغاء التحميل قيد التقدم.

kLoggingManagementState_Shutdown

غير قادر على تنفيذ أي عملية تسجيل.

النوع الزمني

 TimestampType

صحة ونوع من الطابع الزمني المدرجة في EventOptions .

النوع

CommandFlags

enum nl::Weave::Profiles::DataManagement_Current::CommandFlags CommandFlags

داتافرسون

uint64_t DataVersion

معالج الحدث

void * EventProcessor

EventWriterFunct

WEAVE_ERROR(* EventWriterFunct)(nl::Weave::TLV::TLVWriter &ioWriter, uint8_t inDataTag, void *appData)

دالة توفر عنصر eventData للنظام الفرعي لتسجيل الأحداث.

من المتوقع أن توفر وظائف من هذا النوع عنصر eventData للنظام الفرعي لتسجيل الأحداث. يتم استدعاء الوظائف من هذا النوع بعد أن يقوم النظام الفرعي للحدث بإنشاء جميع بيانات تعريف الحدث المطلوبة. يتم استدعاء الدالة معنيكولا لانغ :: :: نسج TLV :: TLVWriter الكائن في التي سوف تنبعث من واحد TLV عنصر الموسومة kTag_EventData. يجب أن تكون قيمة هذا العنصر بنية تحتوي على بيانات الحدث. يجب تنظيم بيانات الحدث نفسها باستخدام علامات السياق.

تفاصيل
المعلمات
[in,out] ioWriter
إشارة إلىNL :: :: نسج TLV :: TLVWriter الكائن لاستخدامها في التسلسل بيانات الحدث.
[in] inDataTag
علامة السياق ل TLV نكتب بها.
[in] appData
مؤشر لسياق تطبيق معين.
إرجاع القيم
WEAVE_NO_ERROR
عن النجاح.
other
خطأ مناسب يشير إلى المتصل بعدم إمكانية إكمال تسلسل بيانات الحدث. يجب نشر الأخطاء من الاستدعاءات إلى ioWriter بدون إعادة تعيين. إذا قامت الدالة بإرجاع أي نوع من الأخطاء ، فسيتم إحباط إنشاء الحدث ، ولا تتم كتابة الحدث في السجل.
أنظر أيضا:
PlainTextWriter
EventWriterTLV نسخ

FetchExternalEventsFunct

WEAVE_ERROR(* FetchExternalEventsFunct)(EventLoadOutContext *aContext)

نموذج أولي لوظيفة عمليات رد نداءات النظام الأساسي التي تجلب بيانات الحدث.

على غرار FetchEventsSince، وهذا جلب عوائد وظيفة كل الأحداث من خلال EventLoadOutContext.mStartingEventID ExternalEvents.mLastEventID .

مؤشر السياق من النوع FetchExternalEventsContext. ويشمل هذا EventLoadOutContext ، مع بعض المتغيرات المساعد للتنسيق TLV . ويشمل أيضا مؤشر إلى ExternalEvents خلق بنية على تسجيل الاستدعاء. هذا يحدد نطاق معرف الحدث لرد الاتصال.

على عودته من وظيفة، ويجب أن تعكس EventLoadOutContext.mCurrentEventID أول معرف الحدث الذي لم يكتب بنجاح إلى TLV العازلة. منصة يجب أن يكتب على رأس الأحداث والبيانات إلى TLV الكاتب بالشكل الصحيح، التي يحددها البروتوكول EventLogging. يجب أن تحافظ المنصة أيضًا على تفرد الأحداث والطوابع الزمنية.

كل TLV يجب أن يتم نشر الأخطاء إلى مستويات أعلى. على سبيل المثال ، سيؤدي نفاد المساحة في المخزن المؤقت إلى تشغيل رسالة مرسلة ، متبوعة باستدعاء آخر لمعاودة الاتصال مع معرف الحدث المتبقي.

تفاصيل
إرجاع القيم
WEAVE_ERROR_NO_MEMORY
إذا لم يكن هناك مساحة لكتابة الأحداث.
WEAVE_ERROR_BUFFER_TOO_SMALL
إذا لم يكن هناك مساحة لكتابة الأحداث.
WEAVE_NO_ERROR
عن النجاح.
WEAVE_END_OF_TLV
عن النجاح.

GenericTraitSinkCatalog

GenericTraitCatalogImpl< TraitDataSink > GenericTraitSinkCatalog

GenericTraitSourceCatalog

GenericTraitCatalogImpl< TraitDataSource > GenericTraitSourceCatalog

النوع

enum nl::Weave::Profiles::DataManagement_Current::ImportanceType ImportanceType

أهمية إدخال السجل.

تُستخدم الأهمية كطريقة لتصفية الأحداث قبل إرسالها فعليًا إلى السجل. بعد تسجيل الحدث في السجل ، لا نضع أي أحكام أخرى لشطبها من السجل. يعمل مستوى الأهمية على تحديد أولويات تخزين الحدث. إذا تمت إضافة حدث ذي أهمية عالية إلى مخزن مؤقت كامل ، فسيتم إسقاط الأحداث حسب الأهمية (والعمر) لاستيعابها. على هذا النحو ، مستويات الأهمية لها قيمة نسبية فقط. إذا كان النظام يستخدم مستوى أهمية واحدًا فقط ، فسيتم إسقاط الأحداث بترتيب العمر فقط ، مثل المخزن المؤقت الدائري.

التكرار

void(* IteratorCallback)(void *aTraitInstance, TraitDataHandle aHandle, void *aContext)

مكرر مقبض السمة.

LoggingBufferHandler

WEAVE_ERROR(* LoggingBufferHandler)(void *inAppState, PacketBuffer *inBuffer)

NotifyExternalEventsDeliveredFunct

void(* NotifyExternalEventsDeliveredFunct)(ExternalEvents *inEv, event_id_t inLastDeliveredEventID, uint64_t inRecipientNodeID)

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

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

تفاصيل
المعلمات
[in] inEv
كائن الأحداث الخارجية المقابل للأحداث التي تم تسليمها
[in] inLastDeliveredEventID
معرّف الحدث الأخير الذي تم تسليمه إلى المشترك.
[in] inRecipientNodeID
نسج معرف العقدة للمستلم

NotifyExternalEventsEvictedFunct

void(* NotifyExternalEventsEvictedFunct)(ExternalEvents *inEv)

تم استدعاء نموذج أولي لوظيفة رد اتصال عند طرد الأحداث الخارجية من المخازن المؤقتة.

عند إخراج كائن الأحداث الخارجية من المخزن المؤقت للرسالة الصادرة ، سيقدم المحرك إشعارًا إلى موفر الحدث الخارجي. رد الاتصال يحتوي على الحدث الخارجي الذي سيتم إخلاؤه.

تفاصيل
المعلمات
[in] inEv
الأحداث الخارجية تعترض على الإخلاء

PropertyDictionaryKey

uint16_t PropertyDictionaryKey

PropertyPathHandle

uint32_t PropertyPathHandle

PropertyPathHandle عبارة عن تجزئة رقمية فريدة 32 بت لمسار WDM بالنسبة إلى جذر مثيل سمة.

لها جزأين:

  • رقم 16 بت أقل يعيّن الجزء الثابت من المخطط.
  • عندما تشير 16 بت السفلية إلى مسار داخل عنصر القاموس ، يوجد رقم 16 بت أعلى يمثل مفتاح القاموس المرتبط بهذا العنصر. إذا كانت 16 بت السفلية تشير إلى عنصر غير قاموس ، فيجب أن تكون 16 بت العلوية 0.

بعض الخصائص:

  • كل سمة لها مساحة مقبض مسار الملكية الخاصة بها.
  • سيكون لكل مسار مسار فرعي فريد لـ WDM خاصية فريدة مماثلة.
  • يتم إنشاء PropertyPathHandles تلقائيًا (يتم إجراؤه يدويًا في الوقت الحالي) بواسطة مترجم سمات من IDL ويتم تمثيله كقائمة تعداد في ملف رأس السمة المقابل.
  • باستخدام هذا البناء ، لا يتعين على منطق التطبيق أبدًا التعامل مع مسارات WDM مباشرة. بدلاً من ذلك ، يتم إجراء تفاعلاتهم مع إدارة الطلب على المياه بشكل حصري من خلال هذه المقابض.
  • هناك قيمتان محجوزتان لمقابض المسار التي لها معنى محدد:
    • 0 يشير إلى مقبض 'NULL'
    • 1 يشير إلى مقبض يشير إلى جذر مثيل السمة.

PropertySchemaHandle

uint16_t PropertySchemaHandle

الإصدار

uint16_t SchemaVersion

SingleResourceSinkTraitCatalog

SingleResourceTraitCatalog< TraitDataSink > SingleResourceSinkTraitCatalog

SingleResourceSourceTraitCatalog

SingleResourceTraitCatalog< TraitDataSource > SingleResourceSourceTraitCatalog

النوع الزمني

enum nl::Weave::Profiles::DataManagement_Current::TimestampType TimestampType

صحة ونوع من الطابع الزمني المدرجة في EventOptions .

TraitDataHandle

uint16_t TraitDataHandle

المدة __

uint32_t duration_t

النوع المستخدم لوصف المدة بالمللي ثانية.

event_id_t

uint32_t event_id_t

نوع معرف الحدث.

timestamp_t

uint32_t timestamp_t

النوع المستخدم لوصف الطابع الزمني بالمللي ثانية.

utc_timestamp_t

uint64_t utc_timestamp_t

النوع المستخدم لوصف الطابع الزمني UTC بالمللي ثانية.

المتغيرات

sInstance

LoggingManagement sInstance

sLogFileName

char sLogFileName[] = "topazlog"

المهام

BdxErrorHandler

void BdxErrorHandler(
  nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer,
  WEAVE_ERROR aErrorCode
)

BdxGetBlockHandler

void BdxGetBlockHandler(
  nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer,
  uint64_t *aLength,
  uint8_t **aDataBlock,
  bool *aIsLastBlock
)

BdxRejectHandler

void BdxRejectHandler(
  nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer,
  nl::Weave::Profiles::StatusReporting::StatusReport *aReport
)

BdxSendAcceptHandler

WEAVE_ERROR BdxSendAcceptHandler(
  nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer,
  nl::Weave::Profiles::BulkDataTransfer::SendAccept *aSendAcceptMsg
)

BdxXferDoneHandler

void BdxXferDoneHandler(
  nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer
)

BdxXferErrorHandler

void BdxXferErrorHandler(
  nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer,
  nl::Weave::Profiles::StatusReporting::StatusReport *aXferError
)

CreatePropertyPathHandle

PropertyPathHandle CreatePropertyPathHandle(
  PropertySchemaHandle aPropertyPathSchemaId,
  PropertyDictionaryKey aPropertyPathDictionaryKey
)

EventWriterTLV نسخ

WEAVE_ERROR EventWriterTLVCopy(
  TLVWriter & ioWriter,
  uint8_t inDataTag,
  void *appData
)

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

تفاصيل
المعلمات
[in,out] ioWriter
الكاتب لاستخدامه لكتابة الحدث
[in] inDataTag
علامة السياق ل TLV نحن نسخ بها. غير مستخدم هنا ، ولكنه مطلوب بواسطة محرف تعريف EventWriterFunct.
[in] appData
مؤشر إلى TLVReader الذي يحتفظ ببيانات الأحداث المتسلسلة.
إرجاع القيم
WEAVE_NO_ERROR
عن النجاح.
other
الأخطاء الأخرى التي قد يتم إرجاعها من ioWriter.

GetPropertyDictionaryKey

PropertyDictionaryKey GetPropertyDictionaryKey(
  PropertyPathHandle aHandle
)

GetPropertySchemaHandle

PropertySchemaHandle GetPropertySchemaHandle(
  PropertyPathHandle aHandle
)

IsNullPropertyPathHandle

bool IsNullPropertyPathHandle(
  PropertyPathHandle aHandle
)

IsRootPropertyPathHandle

bool IsRootPropertyPathHandle(
  PropertyPathHandle aHandle
)

IsVersion أحدث

bool IsVersionNewer(
  const DataVersion & aVersion,
  const DataVersion & aReference
)

هذا هو التنفيذ الأمثل للخوارزمية لمقارنة الإصدارات.

من جانب العميل ، تكون النسخة المستلمة من الخدمة هي الأحدث دائمًا.

IsVersionNewerOrEqual

bool IsVersionNewerOrEqual(
  const DataVersion & aVersion,
  const DataVersion & aReference
)

حدد

TraitUpdatableDataSink * Locate(
  TraitDataHandle aTraitDataHandle,
  const TraitCatalogBase< TraitDataSink > *aDataSinkCatalog
)

وظيفة الأداة التي يجد TraitUpdatableDataSink في TraitDataSink التسويقي.

تفاصيل
المعلمات
[in] aTraitDataHandle
مقبض المغسلة للبحث.
[in] aDataSinkCatalog
كتالوج للبحث.
عائدات
مؤشر إلى TraitUpdatableDataSink . NULL إذا المقبض غير موجود أو أنه يشير إلى غير قابلة للتحديث TraitDataSink .

LogEvent

event_id_t LogEvent(
  const EventSchema & inSchema,
  nl::Weave::TLV::TLVReader & inData
)

سجل حدثًا من نموذج مُسلسل مسبقًا.

وظيفة بتسجيل حدث ممثلة على النحوNL :: :: نسج TLV :: TLVReader . وهذا يعني أن تمثيل البيانات حال تسلسل بالفعل في تخزين الكامنة وراءNL :: :: نسج TLV :: TLVReader . ونيكولا لانغ :: :: نسج TLV :: TLVReader ومن المتوقع أن يحتوي على ما لا يقل عن عنصر بيانات واحدة، ويجب أن يكون هذا العنصر هيكل. يتم التعامل مع العنصر الأول الذي تمت قراءته من القارئ كبيانات حدث ويتم تخزينه في سجل الأحداث. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها داخل المخطط المعرّف بواسطة inProfileID و inEventType. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.

يتم تسجيل الحدث إذا تجاوز inImportance على عتبة تسجيل المحددة في LoggingConfiguration . إذا لا أهمية الحدث تلبية عتبة الحالية، يتم إسقاطه وظيفة بإرجاع 0 كما ينتج عن ذلك من معرف الحدث.

هذا المتغير من الاستدعاء يحدد ضمنيًا جميع خيارات الحدث الافتراضية:

  • الحدث مختومًا بختم زمني بالوقت الحالي عند نقطة المكالمة ،
  • تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
  • الحدث مستقل ، ولا يتعلق بأي أحداث أخرى ،
  • تم وضع علامة على الحدث على أنه غير عاجل ،

تفاصيل
المعلمات
[in] inSchema
مخطط تحديد أهمية، ID الشخصي، ونوع هيكل هذا الحدث.
[in] inData
و TLV القارئ الذي يحتوي على بيانات الحدث باعتبارها العنصر الأول.
عائدات
event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك.

LogEvent

event_id_t LogEvent(
  const EventSchema & inSchema,
  nl::Weave::TLV::TLVReader & inData,
  const EventOptions *inOptions
)

سجل حدثًا من نموذج مُسلسل مسبقًا ، مع خيارات إضافية.

وظيفة بتسجيل حدث ممثلة على النحوNL :: :: نسج TLV :: TLVReader . وهذا يعني أن تمثيل البيانات حال تسلسل بالفعل في تخزين الكامنة وراءNL :: :: نسج TLV :: TLVReader . ونيكولا لانغ :: :: نسج TLV :: TLVReader ومن المتوقع أن يحتوي على ما لا يقل عن عنصر بيانات واحدة، ويجب أن يكون هذا العنصر هيكل. يتم التعامل مع العنصر الأول الذي تمت قراءته من القارئ كبيانات حدث ويتم تخزينه في سجل الأحداث. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها داخل المخطط المعرّف بواسطة inProfileID و inEventType. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.

يتم تسجيل الحدث إذا تجاوز inImportance على عتبة تسجيل المحددة في LoggingConfiguration . إذا لا أهمية الحدث تلبية عتبة الحالية، يتم إسقاطه وظيفة بإرجاع 0 كما ينتج عن ذلك من معرف الحدث.

هذا البديل من الاحتجاج يسمح للطالب لتحديد أي مزيج من EventOptions :

  • الطابع الزمني ، عندما يكون 0 افتراضيًا على الوقت الحالي عند نقطة المكالمة ،
  • قسم "الجذر" لمصدر الحدث (مصدر الحدث ومعرف السمة) ؛ إذا كان NULL ، فسيتم تعيينه افتراضيًا على الجهاز الحالي. تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
  • معرف حدث ذي صلة لتجميع معرفات الحدث ؛ عندما يكون معرف الحدث ذي الصلة 0 ، يتم تمييز الحدث على أنه لا يتعلق بأي أحداث أخرى ،
  • الاستعجال؛ بشكل افتراضي غير عاجل.

تفاصيل
المعلمات
[in] inSchema
مخطط تحديد أهمية، ID الشخصي، ونوع هيكل هذا الحدث.
[in] inData
و TLV القارئ الذي يحتوي على بيانات الحدث باعتبارها العنصر الأول. يجب ألا تكون فارغة
[in] inOptions
خيارات البيانات الوصفية للحدث. قد يكون NULL.
عائدات
event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك.

LogEvent

event_id_t LogEvent(
  const EventSchema & inSchema,
  EventWriterFunct inEventWriter,
  void *inAppData
)

سجل حدثا عبر رد الاتصال.

وظيفة بتسجيل حدث يمثل باعتبارها EventWriterFunct والتطبيق محددة appData السياق. وظيفة يكتب البيانات الوصفية الحدث وتدعو inEventWriter معنيكولا لانغ :: :: نسج TLV :: TLVWriter المرجعية و inAppData السياق بحيث رمز المستخدم يمكن أن تنبعث من بيانات الحدث مباشرة في سجل الأحداث. هذا النوع من تسجيل الأحداث يقلل من استهلاك الذاكرة ، حيث يتم تسلسل بيانات الحدث مباشرة في المخزن المؤقت الهدف. بيانات الحدث يجب أن يحتوي على علامات السياق إلى أن تفسر ضمن مخطط حددها inProfileID و inEventType . سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.

يتم تسجيل الحدث إذا تجاوز inImportance على عتبة تسجيل المحددة في LoggingConfiguration . إذا لا أهمية الحدث تلبية عتبة الحالية، يتم إسقاطه وظيفة بإرجاع 0 كما ينتج عن ذلك من معرف الحدث.

هذا المتغير من الاستدعاء يحدد ضمنيًا جميع خيارات الحدث الافتراضية:

  • الحدث مختومًا بختم زمني بالوقت الحالي عند نقطة المكالمة ،
  • تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
  • الحدث مستقل ، ولا يتعلق بأي أحداث أخرى ،
  • تم وضع علامة على الحدث على أنه غير عاجل ،

تفاصيل
المعلمات
[in] inSchema
مخطط تحديد أهمية، ID الشخصي، ونوع هيكل هذا الحدث.
[in] inEventWriter
رد النداء لاستدعاء لإجراء تسلسل فعلي لبيانات الحدث
[in] inAppData
سياق التطبيق لرد الاتصال.
عائدات
event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك.

LogEvent

event_id_t LogEvent(
  const EventSchema & inSchema,
  EventWriterFunct inEventWriter,
  void *inAppData,
  const EventOptions *inOptions
)

سجل حدثًا عبر رد اتصال ، مع خيارات.

وظيفة بتسجيل حدث يمثل باعتبارها EventWriterFunct والتطبيق محددة appData السياق. وظيفة يكتب البيانات الوصفية الحدث وتدعو inEventWriter معنيكولا لانغ :: :: نسج TLV :: TLVWriter المرجعية و inAppData السياق بحيث رمز المستخدم يمكن أن تنبعث من بيانات الحدث مباشرة في سجل الأحداث. هذا النوع من تسجيل الأحداث يقلل من استهلاك الذاكرة ، حيث يتم تسلسل بيانات الحدث مباشرة في المخزن المؤقت الهدف. بيانات الحدث يجب أن يحتوي على علامات السياق إلى أن تفسر ضمن مخطط حددها inProfileID و inEventType . سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.

يتم تسجيل الحدث إذا تجاوز inImportance على عتبة تسجيل المحددة في LoggingConfiguration . إذا لا أهمية الحدث تلبية عتبة الحالية، يتم إسقاطه وظيفة بإرجاع 0 كما ينتج عن ذلك من معرف الحدث.

هذا البديل من الاحتجاج يسمح للطالب لتحديد أي مزيج من EventOptions :

  • الطابع الزمني ، عندما يكون 0 افتراضيًا على الوقت الحالي عند نقطة المكالمة ،
  • قسم "الجذر" لمصدر الحدث (مصدر الحدث ومعرف السمة) ؛ إذا كان NULL ، فسيتم تعيينه افتراضيًا على الجهاز الحالي. تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
  • معرف حدث ذي صلة لتجميع معرفات الحدث ؛ عندما يكون معرف الحدث ذي الصلة 0 ، يتم تمييز الحدث على أنه لا يتعلق بأي أحداث أخرى ،
  • الاستعجال؛ بشكل افتراضي غير عاجل.

تفاصيل
المعلمات
[in] inSchema
مخطط تحديد أهمية، ID الشخصي، ونوع هيكل هذا الحدث.
[in] inEventWriter
رد النداء لاستدعاء لإجراء تسلسل فعلي لبيانات الحدث
[in] inAppData
سياق التطبيق لرد الاتصال.
[in] inOptions
خيارات البيانات الوصفية للحدث. قد يكون NULL.
عائدات
event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك.

سجل حر

event_id_t LogFreeform(
  ImportanceType inImportance,
  const char *inFormat,
  ...
)

LogFreeform يرسل سلسلة حرة إلى دفق الحدث الافتراضي.

سيتم تغليف السلسلة في بنية حدث التصحيح ، متطابقة هيكليًا مع السلاسل الأخرى المسجلة. سوف ID الشخصي الحدث سيكون ذلك حدثا عش التصحيح، وسوف يكون نوع الحدث kNestDebug_StringLogEntryEvent .

تفاصيل
المعلمات
[in] inImportance
أهمية إدخال السجل ؛ إذا كانت الأهمية أقل من الأهمية الحالية ، فلن يتم تسجيل الحدث بالفعل
[in] inFormat
printf سلسلة تنسيق المتوافقة مع تليها الحجج ليتم تنسيق
عائدات
event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك.

LookForElementWithTag

WEAVE_ERROR LookForElementWithTag(
  const nl::Weave::TLV::TLVReader & aSrcReader,
  const uint64_t aTagInApiForm,
  nl::Weave::TLV::TLVReader *apDstReader
)

PlainTextWriter

WEAVE_ERROR PlainTextWriter(
  TLVWriter & ioWriter,
  uint8_t inDataTag,
  void *appData
)

وظيفة مساعدة لإرسال نص حر كحدث تصحيح.

حدث التصحيح عبارة عن بنية ذات سجل ونص حر.

تفاصيل
المعلمات
[in,out] ioWriter
الكاتب لاستخدامه لكتابة الحدث
[in] appData
مؤشر إلى DebugLogContext ، وهو الهيكل الذي يحمل شكل سلسلة، والحجج، ومنطقة السجل
[in] inDataTag
علامة السياق ل TLV نكتب بها. غير مستخدم هنا ، ولكنه مطلوب بواسطة محرف تعريف EventWriterFunct.
إرجاع القيم
WEAVE_NO_ERROR
عن النجاح.
other
الأخطاء الأخرى التي قد يتم إرجاعها من ioWriter.

PlainTextWriter

WEAVE_ERROR PlainTextWriter(
  ::nl::Weave::TLV::TLVWriter & ioWriter,
  uint8_t inDataTag,
  void *appData
)

وظيفة مساعدة لإرسال نص حر كحدث تصحيح.

حدث التصحيح عبارة عن بنية ذات سجل ونص حر.

تفاصيل
المعلمات
[in,out] ioWriter
الكاتب لاستخدامه لكتابة الحدث
[in] inDataTag
العلامة المراد إرسالها
[in] appData
مؤشر إلى DebugLogContext ، وهو الهيكل الذي يحمل شكل سلسلة، والحجج، ومنطقة السجل
إرجاع القيم
WEAVE_NO_ERROR
عن النجاح.
other
الأخطاء الأخرى التي قد يتم إرجاعها من ioWriter.

عامل! =

bool operator!=(
  const ResourceIdentifier & lhs,
  const ResourceIdentifier & rhs
)

عامل التشغيل ==

bool operator==(
  const ResourceIdentifier & lhs,
  const ResourceIdentifier & rhs
)