Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

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

الطبقات

nl :: Weave :: Profiles :: DataManagement_Current :: AlwaysAcceptDataElementAccessControlDelegate
nl :: Weave :: Profiles :: DataManagement_Current :: BuilderBase

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

nl :: Weave :: Profiles :: DataManagement_Current :: CircularEventReader

قارئ TLV مدعوم من CircularEventBuffer .

nl :: Weave :: Profiles :: DataManagement_Current :: Command
nl :: Weave :: Profiles :: DataManagement_Current :: CommandSender
nl :: Weave :: Profiles :: DataManagement_Current :: GenericTraitCatalogImpl

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

nl :: Weave :: Profiles :: DataManagement_Current :: IDataElementAccessControlDelegate

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

nl :: Weave :: Profiles :: DataManagement_Current :: IDirtyPathCut
nl :: Weave :: Profiles :: DataManagement_Current :: IPathFilter
nl :: Weave :: Profiles :: DataManagement_Current :: IWeavePublisherLock

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

nl :: Weave :: Profiles :: DataManagement_Current :: IWeaveWDMMutex

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

nl :: Weave :: Profiles :: DataManagement_Current :: ListBuilderBase

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

nl :: Weave :: Profiles :: DataManagement_Current :: ListParserBase

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

nl :: Weave :: Profiles :: DataManagement_Current :: LogBDXUpload
nl :: Weave :: Profiles :: DataManagement_Current :: LoggingConfiguration

LoggingConfiguration يغلف المكون القابل للتكوين للنظام الفرعي Weave Event Logging .

nl :: Weave :: Profiles :: DataManagement_Current :: LoggingManagement

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

nl :: Weave :: Profiles :: DataManagement_Current :: NotificationEngine
nl :: Weave :: Profiles :: DataManagement_Current :: ParserBase

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

nl :: Weave :: Profiles :: DataManagement_Current :: ResourceIdentifier

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

nl :: Weave :: Profiles :: DataManagement_Current :: SingleResourceTraitCatalog
nl :: Weave :: Profiles :: DataManagement_Current :: SubscriptionClient
nl :: Weave :: Profiles :: DataManagement_Current :: SubscriptionEngine

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

nl :: Weave :: Profiles :: DataManagement_Current :: SubscriptionHandler
nl :: Weave :: Profiles :: DataManagement_Current :: TraitCatalogBase
nl :: Weave :: Profiles :: DataManagement_Current :: TraitDataSink
nl :: Weave :: Profiles :: DataManagement_Current :: TraitDataSource
nl :: Weave :: Profiles :: DataManagement_Current :: TraitSchemaEngine

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

nl :: Weave :: Profiles :: DataManagement_Current :: TraitUpdatableDataSink
nl :: Weave :: Profiles :: DataManagement_Current :: UpdateClient
nl :: Weave :: Profiles :: DataManagement_Current :: UpdateDictionaryDirtyPathCut

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

nl :: Weave :: Profiles :: DataManagement_Current :: UpdateDirtyPathFilter

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

nl :: Weave :: Profiles :: DataManagement_Current :: UpdateEncoder

يقوم هذا الكائن بترميز حمولات WDM UpdateRequest و PartialUpdateRequest.

nl :: Weave :: Profiles :: DataManagement_Current :: ViewClient

الهياكل

nl :: Weave :: Profiles :: DataManagement_Current :: CircularEventBuffer

المخزن المؤقت للحدث الداخلي ، المبني حول nl :: Weave :: TLV :: WeaveCircularTLVBuffer .

nl :: Weave :: Profiles :: DataManagement_Current :: ConstSchemaVersionRange
nl :: Weave :: Profiles :: DataManagement_Current :: CopyAndAdjustDeltaTimeContext

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

nl :: Weave :: Profiles :: DataManagement_Current :: DebugLogContext
nl :: Weave :: Profiles :: DataManagement_Current :: DetailedRootSection

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

nl :: Weave :: Profiles :: DataManagement_Current :: EventEnvelopeContext

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

nl :: Weave :: Profiles :: DataManagement_Current :: EventLoadOutContext

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

nl :: Weave :: Profiles :: DataManagement_Current :: EventOptions

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

nl :: Weave :: Profiles :: DataManagement_Current :: EventSchema

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

nl :: Weave :: Profiles :: DataManagement_Current :: ExternalEvents

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

nl :: Weave :: Profiles :: DataManagement_Current :: LogStorageResources

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

nl :: Weave :: Profiles :: DataManagement_Current :: ReclaimEventCtx
nl :: Weave :: Profiles :: DataManagement_Current :: SchemaVersionRange
nl :: Weave :: Profiles :: DataManagement_Current :: TraitPath
nl :: Weave :: Profiles :: DataManagement_Current :: TraitPathStore
nl :: Weave :: Profiles :: DataManagement_Current :: VersionedTraitPath

النقابات

nl :: Weave :: Profiles :: DataManagement_Current :: Timestamp

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

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

nl :: Weave :: Profiles :: DataManagement_Current :: BaseMessageWithSubscribeId
nl :: Weave :: Profiles :: DataManagement_Current :: CustomCommand

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

nl :: Weave :: Profiles :: DataManagement_Current :: CustomCommandResponse

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

nl :: Weave :: Profiles :: DataManagement_Current :: DataElement

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

nl :: Weave :: Profiles :: DataManagement_Current :: DataList
nl :: Weave :: Profiles :: DataManagement_Current :: Event
nl :: Weave :: Profiles :: DataManagement_Current :: EventList
nl :: Weave :: Profiles :: DataManagement_Current :: NotificationRequest
nl :: Weave :: Profiles :: DataManagement_Current :: Path

تعريف مسار WDM.

nl :: Weave :: Profiles :: DataManagement_Current :: PathList

تعريف قائمة مسار WDM.

nl :: Weave :: Profiles :: DataManagement_Current :: Platform
nl :: Weave :: Profiles :: DataManagement_Current :: RejectionRecord
nl :: Weave :: Profiles :: DataManagement_Current :: RejectionRecordList
nl :: Weave :: Profiles :: DataManagement_Current :: StatusElement

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

nl :: Weave :: Profiles :: DataManagement_Current :: StatusList
nl :: Weave :: Profiles :: DataManagement_Current :: SubscribeCancelRequest
nl :: Weave :: Profiles :: DataManagement_Current :: SubscribeConfirmRequest
nl :: Weave :: Profiles :: DataManagement_Current :: SubscribeRequest
nl :: Weave :: Profiles :: DataManagement_Current :: SubscribeResponse
nl :: Weave :: Profiles :: DataManagement_Current :: UpdateRequest

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

nl :: Weave :: Profiles :: DataManagement_Current :: UpdateResponse
nl :: Weave :: Profiles :: DataManagement_Current :: VersionList
nl :: Weave :: Profiles :: DataManagement_Current :: ViewRequest
nl :: Weave :: Profiles :: 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 بت يساوي معرف ملف التعريف للسمة.

kTag_EventType

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

kTag_EventUTCTimestamp

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

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 للنظام الفرعي لتسجيل الأحداث. يتم استدعاء الوظائف من هذا النوع بعد أن يقوم النظام الفرعي للحدث بإنشاء جميع بيانات تعريف الحدث المطلوبة. يتم استدعاءالوظيفة بكائنnl :: Weave :: TLV :: TLVWriter حيث ستبعث إليه عنصر TLV واحد بعلامة kTag_EventData ؛ يجب أن تكون قيمة هذا العنصر عبارة عن بنية تحتوي على بيانات الحدث. يجب تنظيم بيانات الحدث نفسها باستخدام علامات السياق.

تفاصيل
المعلمات
[in,out] ioWriter
مرجع إلى كائنnl :: Weave :: 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 :: Weave :: TLV :: TLVReader . هذا يعني أن تمثيل بيانات الحدث متسلسل بالفعل في التخزين الكامن وراءnl :: Weave :: TLV :: TLVReader . من المتوقع أن يحتويnl :: Weave :: TLV :: TLVReader على عنصر بيانات واحد على الأقل ، يجب أن يكون هذا العنصر بنية. يتم التعامل مع العنصر الأول الذي تمت قراءته من القارئ كبيانات حدث ويتم تخزينه في سجل الأحداث. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها داخل المخطط المعرف بواسطة inProfileID و inEventType. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.

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

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

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

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

LogEvent

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

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

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

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

يسمح هذا البديل من الاستدعاء للمتصل بتعيين أي مجموعة من EventOptions :

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

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

LogEvent

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

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

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

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

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

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

تفاصيل
المعلمات
[in] inSchema
مخطط يحدد الأهمية ومعرف الملف الشخصي ونوع هيكل هذا الحدث.
[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 . تكتب الدالة بيانات تعريف الحدث وتستدعي inEventWriternl :: Weave :: TLV :: TLVWriter inAppData بحيث يمكن لرمز المستخدم إرسال بيانات الحدث مباشرة إلى سجل الأحداث. هذا النوع من تسجيل الأحداث يقلل من استهلاك الذاكرة ، حيث يتم تسلسل بيانات الحدث مباشرة في المخزن المؤقت الهدف. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها ضمن المخطط المعرّف بواسطة inProfileID و inEventType . سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.

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

يسمح هذا البديل من الاستدعاء للمتصل بتعيين أي مجموعة من EventOptions :

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

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

سجل حر

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

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

سيتم تغليف السلسلة في بنية حدث التصحيح ، متطابقة هيكليًا مع السلاسل الأخرى المسجلة. سيكون معرف الملف الشخصي للحدث هو معرف حدث Nest Debug ، وسيكون نوع الحدث هو 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
)