nl :: Tecer:: Perfis :: DataManagement_Current
Este namespace inclui todas as interfaces dentro do Weave para o perfil Weave Data Management (WDM) que são atualmente suportados para uso em produção.
Resumo
Typedefs | |
---|---|
CommandFlags | typedef |
DataVersion | typedefuint64_t |
EventProcessor | typedefvoid * |
EventWriterFunct )(nl::Weave::TLV::TLVWriter &ioWriter, uint8_t inDataTag, void *appData) | typedefWEAVE_ERROR (* Uma função que fornece o elemento eventData para o subsistema de log de eventos. |
FetchExternalEventsFunct )(EventLoadOutContext *aContext) | typedefWEAVE_ERROR (* Um protótipo de função para callbacks de plataforma que buscam dados de eventos. |
GenericTraitSinkCatalog | typedef |
GenericTraitSourceCatalog | typedef |
ImportanceType | typedef A importância da entrada do log. |
IteratorCallback )(void *aTraitInstance, TraitDataHandle aHandle, void *aContext) | typedefvoid(* Iterador de identificador de traço. |
LoggingBufferHandler )(void *inAppState, PacketBuffer *inBuffer) | typedefWEAVE_ERROR (* |
NotifyExternalEventsDeliveredFunct )(ExternalEvents *inEv, event_id_t inLastDeliveredEventID, uint64_t inRecipientNodeID) | typedefvoid(* Um protótipo de função para um retorno de chamada invocado quando eventos externos são entregues ao assinante remoto. |
NotifyExternalEventsEvictedFunct )(ExternalEvents *inEv) | typedefvoid(* Um protótipo de função para um retorno de chamada invocado quando eventos externos são removidos dos buffers. |
PropertyDictionaryKey | typedefuint16_t |
PropertyPathHandle | typedefuint32_t Um PropertyPathHandle é um hash numérico exclusivo de 32 bits de um caminho WDM relativo à raiz de uma instância de característica. |
PropertySchemaHandle | typedefuint16_t |
SchemaVersion | typedefuint16_t |
SingleResourceSinkTraitCatalog | typedef |
SingleResourceSourceTraitCatalog | typedef |
TimestampType | typedef A validade e o tipo de carimbo de data / hora incluído em EventOptions . |
TraitDataHandle | typedefuint16_t |
duration_t | nl :: Weave :: Profiles :: DataManagement_Current :: duration_tuint32_t Tipo usado para descrever a duração, em milissegundos. |
event_id_t | nl :: Weave :: Profiles :: DataManagement_Current :: event_id_tuint32_t O tipo de ID do evento. |
timestamp_t | nl :: Weave :: Profiles :: DataManagement_Current :: timestamp_tuint32_t Tipo usado para descrever o carimbo de data / hora em milissegundos. |
utc_timestamp_t | nl :: Weave :: Profiles :: DataManagement_Current :: utc_timestamp_tuint64_t Tipo usado para descrever o carimbo de data / hora UTC em milissegundos. |
Variáveis | |
---|---|
sInstance | |
sLogFileName = "topazlog"[] | char |
Funções | |
---|---|
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) | Uma função auxiliar que converte um elemento eventdata já serializado no buffer de eventos. |
GetPropertyDictionaryKey ( PropertyPathHandle aHandle) | PropertyDictionaryKey |
GetPropertySchemaHandle ( PropertyPathHandle aHandle) | PropertySchemaHandle |
IsNullPropertyPathHandle ( PropertyPathHandle aHandle) | bool |
IsRootPropertyPathHandle ( PropertyPathHandle aHandle) | bool |
IsVersionNewer (const DataVersion & aVersion, const DataVersion & aReference) | bool Esta é uma implementação otimizada do algoritmo para comparar versões. |
IsVersionNewerOrEqual (const DataVersion & aVersion, const DataVersion & aReference) | bool |
Locate (TraitDataHandle aTraitDataHandle, const TraitCatalogBase < TraitDataSink > *aDataSinkCatalog) | Função de utilidade que encontra um TraitUpdatableDataSink em um catálogo TraitDataSink . |
LogEvent (const EventSchema & inSchema,nl::Weave::TLV::TLVReader & inData) | Registre um evento de um formulário pré-serializado. |
LogEvent (const EventSchema & inSchema,nl::Weave::TLV::TLVReader & inData, const EventOptions *inOptions) | Registre um evento de um formulário pré-serializado, com opções adicionais. |
LogEvent (const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData) | Registre um evento por meio de um retorno de chamada. |
LogEvent (const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData, const EventOptions *inOptions) | Registre um evento por meio de um retorno de chamada, com opções. |
LogFreeform ( ImportanceType inImportance, const char *inFormat, ...) | LogFreeform emite uma string de forma livre para o fluxo de eventos padrão. |
LookForElementWithTag (constnl::Weave::TLV::TLVReader & aSrcReader, const uint64_t aTagInApiForm,nl::Weave::TLV::TLVReader *apDstReader) | |
PlainTextWriter (TLVWriter & ioWriter, uint8_t inDataTag, void *appData) | Uma função auxiliar para emitir um texto de forma livre como um evento de depuração. |
PlainTextWriter (::nl::Weave::TLV::TLVWriter & ioWriter, uint8_t inDataTag, void *appData) | Uma função auxiliar para emitir um texto de forma livre como um evento de depuração. |
operator!= (const ResourceIdentifier & lhs, const ResourceIdentifier & rhs) | bool |
operator== (const ResourceIdentifier & lhs, const ResourceIdentifier & rhs) | bool |
Sindicatos | |
---|---|
nl :: Weave :: Profiles :: DataManagement_Current :: Timestamp | A união que fornece um sistema de conjunto de aplicativos ou carimbo de data / hora UTC. |
Enumerações
@ 100
@100
@ 101
@101
@ 102
@102
Tags para eventos persistentes.
@ 104
@104
Os tipos de mensagem do perfil WDM.
Esses valores são chamados na especificação de gerenciamento de dados.
@ 105
@105
Códigos de status específicos do WDM.
@ 147
@147
@ 95
@95
Tags de configurações de registro .
@ 96
@96
Marcas para recursos de registro.
@ 97
@97
Tags para metadados de eventos.
Para uma semântica completa dos valores de tag, consulte a Especificação de Design de Evento.
Propriedades | |
---|---|
kTag_EventData | Opcional. Dados do próprio evento. Se estiver vazio, o padrão é uma estrutura vazia. |
kTag_EventDeltaSystemTime | Etiqueta interna do WDM, diferença de tempo em relação ao evento anterior na codificação. |
kTag_EventDeltaUTCTime | Etiqueta interna do WDM, diferença de tempo em relação ao evento anterior na codificação. |
kTag_EventID | Número de sequência do evento, expresso como uma quantidade não sinalizada de 64 bits. Deve ser sequencial, os saltos na sequência indicam lacunas de eventos. |
kTag_EventImportance | Importância do evento. |
kTag_EventResourceID | Opcional. O valor é o ID do recurso ao qual o evento pertence. Quando omitido, o valor é o mesmo que o valor de kTag_EventSource |
kTag_EventSource | NodeID do dispositivo que gerou o evento. |
kTag_EventSystemTimestamp | Opcional. Registro de data e hora do sistema do evento em milissegundos. |
kTag_EventTraitInstanceID | Opcional, a instância da característica que gerou o evento. |
kTag_EventTraitProfileID | Obrigatório. Inteiro não assinado de 32 bits que é igual ao ProfileID da característica. |
kTag_EventType | Obrigatório. Inteiro não assinado de 16 bits que é igual a wdl.event.id para este tipo de evento. |
kTag_EventUTCTimestamp | Opcional. Carimbo de data / hora UTC do evento em milissegundos. |
kTag_ExternalEventStructure | Tag interna para eventos externos. Nunca transmitido através do fio, nunca deve ser usado fora da biblioteca Weave. |
kTag_RelatedEventID | Opcional. ID de um evento ao qual este evento está relacionado. Se omitido, o valor é igual ao valor de kTag_EventID. |
kTag_RelatedEventImportance | Opcional. Importância do evento relacionado. Se omitido, o valor é igual ao valor de kTag_EventImportance. |
@ 98
@98
Definições de perfil para o traço de depuração.
@ 99
@99
Tipos de eventos para o traço Nest Debug.
CommandFlags
CommandFlags
ImportanceType
ImportanceType
A importância da entrada do log.
A importância é usada como uma forma de filtrar eventos antes que eles sejam realmente emitidos no log. Depois que o evento está no log, não fazemos nenhuma outra providência para eliminá-lo do log. O nível de importância serve para priorizar o armazenamento de eventos. Se um evento de alta importância for adicionado a um buffer cheio, os eventos serão descartados em ordem de importância (e idade) para acomodá-lo. Como tal, os níveis de importância têm apenas valor relativo. Se um sistema estiver usando apenas um nível de importância, os eventos serão descartados apenas em ordem de idade, como um buffer de anel.
LoggingManagementStates
LoggingManagementStates
TimestampType
TimestampType
A validade e o tipo de carimbo de data / hora incluído em EventOptions .
Typedefs
CommandFlags
enum nl::Weave::Profiles::DataManagement_Current::CommandFlags CommandFlags
DataVersion
uint64_t DataVersion
EventProcessor
void * EventProcessor
EventWriterFunct
WEAVE_ERROR(* EventWriterFunct)(nl::Weave::TLV::TLVWriter &ioWriter, uint8_t inDataTag, void *appData)
Uma função que fornece o elemento eventData para o subsistema de log de eventos.
Espera-se que as funções desse tipo forneçam o elemento eventData para o subsistema de registro de eventos. As funções desse tipo são chamadas após o subsistema de eventos gerar todos os metadados de eventos necessários. A função é chamada com um objetonl :: Weave :: TLV :: TLVWriter no qual ela emitirá um único elemento TLV marcado com kTag_EventData; o valor desse elemento DEVE ser uma estrutura contendo os dados do evento. Os próprios dados do evento devem ser estruturados usando tags de contexto.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Valores Retornados |
|
PlainTextWriter
EventWriterTLVCopy
FetchExternalEventsFunct
WEAVE_ERROR(* FetchExternalEventsFunct)(EventLoadOutContext *aContext)
Um protótipo de função para callbacks de plataforma que buscam dados de eventos.
Semelhante a FetchEventsSince, esta função de busca retorna todos os eventos de EventLoadOutContext.mStartingEventID por meio de ExternalEvents.mLastEventID .
O ponteiro de contexto é do tipo FetchExternalEventsContext. Isso inclui o EventLoadOutContext , com algumas variáveis auxiliares para o formato do TLV . Ele também inclui um ponteiro para a estrutura ExternalEvents criada no registro do retorno de chamada. Isso especifica o intervalo de ID do evento para o retorno de chamada.
Ao retornar da função, EventLoadOutContext.mCurrentEventID deve refletir a primeira ID de evento que não foi gravada com sucesso no buffer TLV . A plataforma deve gravar o cabeçalho dos eventos e os dados no gravador TLV no formato correto, especificado pelo protocolo EventLogging. A plataforma também deve manter exclusividade de eventos e carimbos de data / hora.
Todos os erros TLV devem ser propagados para níveis superiores. Por exemplo, ficar sem espaço no buffer irá acionar uma mensagem enviada, seguida por outra chamada para o retorno de chamada com qualquer ID de evento restante.
Detalhes | |||||||||
---|---|---|---|---|---|---|---|---|---|
Valores Retornados |
|
GenericTraitSinkCatalog
GenericTraitCatalogImpl< TraitDataSink > GenericTraitSinkCatalog
GenericTraitSourceCatalog
GenericTraitCatalogImpl< TraitDataSource > GenericTraitSourceCatalog
ImportanceType
enum nl::Weave::Profiles::DataManagement_Current::ImportanceType ImportanceType
A importância da entrada do log.
A importância é usada como uma forma de filtrar eventos antes que eles sejam realmente emitidos no log. Depois que o evento estiver no log, não faremos mais nenhuma providência para eliminá-lo do log. O nível de importância serve para priorizar o armazenamento de eventos. Se um evento de alta importância for adicionado a um buffer cheio, os eventos serão descartados em ordem de importância (e idade) para acomodá-lo. Como tal, os níveis de importância têm apenas valor relativo. Se um sistema estiver usando apenas um nível de importância, os eventos serão descartados apenas em ordem de idade, como um buffer de anel.
IteratorCallback
void(* IteratorCallback)(void *aTraitInstance, TraitDataHandle aHandle, void *aContext)
Iterador de identificador de traço.
LoggingBufferHandler
WEAVE_ERROR(* LoggingBufferHandler)(void *inAppState, PacketBuffer *inBuffer)
NotifyExternalEventsDeliveredFunct
void(* NotifyExternalEventsDeliveredFunct)(ExternalEvents *inEv, event_id_t inLastDeliveredEventID, uint64_t inRecipientNodeID)
Um protótipo de função para um retorno de chamada invocado quando eventos externos são entregues ao assinante remoto.
Quando os eventos externos são entregues a um assinante remoto, o mecanismo fornecerá uma notificação ao provedor de eventos externo. O retorno de chamada contém o evento da última ID entregue e a ID do assinante que recebeu o evento.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
|
NotifyExternalEventsEvictedFunct
void(* NotifyExternalEventsEvictedFunct)(ExternalEvents *inEv)
Um protótipo de função para um retorno de chamada invocado quando eventos externos são removidos dos buffers.
Quando o objeto de eventos externos é removido do buffer de mensagem de saída, o mecanismo fornecerá uma notificação ao provedor de eventos externo. O retorno de chamada contém o evento externo a ser despejado.
Detalhes | |||
---|---|---|---|
Parâmetros |
|
PropertyDictionaryKey
uint16_t PropertyDictionaryKey
PropertyPathHandle
uint32_t PropertyPathHandle
Um PropertyPathHandle é um hash numérico exclusivo de 32 bits de um caminho WDM relativo à raiz de uma instância de característica.
Tem duas partes:
- Um número inferior de 16 bits que mapeia para a parte estática do esquema.
- Onde os 16 bits inferiores se referem a um caminho dentro de um elemento de dicionário, um número superior de 16 bits está presente que representa a chave de dicionário associada a esse elemento. Se os 16 bits inferiores se referem a um elemento que não está no dicionário, os 16 bits superiores devem ser 0.
Algumas características:
- Cada característica tem seu próprio espaço de manipulação de caminho de propriedade.
- Cada caminho de subcaminho WDM exclusivo terá um PropertyPathHandle exclusivo semelhante.
- PropertyPathHandles são gerados automaticamente (feitos manualmente por enquanto) por um compilador de característica da IDL e é representado como uma lista de enumerantes no arquivo de cabeçalho da característica correspondente.
- Com essa construção, a lógica do aplicativo nunca precisa lidar com caminhos WDM diretamente. Em vez disso, suas interações com o WDM são conduzidas exclusivamente por meio dessas alças.
- Existem dois valores reservados para identificadores de caminho que têm um significado específico:
- 0 indica um identificador 'NULL'
- 1 indica um identificador que aponta para a raiz da instância do trait.
PropertySchemaHandle
uint16_t PropertySchemaHandle
SchemaVersion
uint16_t SchemaVersion
SingleResourceSinkTraitCatalog
SingleResourceTraitCatalog< TraitDataSink > SingleResourceSinkTraitCatalog
SingleResourceSourceTraitCatalog
SingleResourceTraitCatalog< TraitDataSource > SingleResourceSourceTraitCatalog
TimestampType
enum nl::Weave::Profiles::DataManagement_Current::TimestampType TimestampType
A validade e o tipo de carimbo de data / hora incluído em EventOptions .
TraitDataHandle
uint16_t TraitDataHandle
duration_t
uint32_t duration_t
Tipo usado para descrever a duração, em milissegundos.
event_id_t
uint32_t event_id_t
O tipo de ID do evento.
timestamp_t
uint32_t timestamp_t
Tipo usado para descrever o carimbo de data / hora em milissegundos.
utc_timestamp_t
uint64_t utc_timestamp_t
Tipo usado para descrever o carimbo de data / hora UTC em milissegundos.
Variáveis
sInstance
LoggingManagement sInstance
sLogFileName
char sLogFileName[] = "topazlog"
Funções
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 )
EventWriterTLVCopy
WEAVE_ERROR EventWriterTLVCopy( TLVWriter & ioWriter, uint8_t inDataTag, void *appData )
Uma função auxiliar que converte um elemento eventdata já serializado no buffer de eventos.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Valores Retornados |
|
GetPropertyDictionaryKey
PropertyDictionaryKey GetPropertyDictionaryKey( PropertyPathHandle aHandle )
GetPropertySchemaHandle
PropertySchemaHandle GetPropertySchemaHandle( PropertyPathHandle aHandle )
IsNullPropertyPathHandle
bool IsNullPropertyPathHandle( PropertyPathHandle aHandle )
IsRootPropertyPathHandle
bool IsRootPropertyPathHandle( PropertyPathHandle aHandle )
IsVersionNewer
bool IsVersionNewer( const DataVersion & aVersion, const DataVersion & aReference )
Esta é uma implementação otimizada do algoritmo para comparar versões.
Do lado do cliente, uma versão recebida do serviço é sempre a mais recente.
IsVersionNewerOrEqual
bool IsVersionNewerOrEqual( const DataVersion & aVersion, const DataVersion & aReference )
Localizar
TraitUpdatableDataSink * Locate( TraitDataHandle aTraitDataHandle, const TraitCatalogBase< TraitDataSink > *aDataSinkCatalog )
Função de utilidade que encontra um TraitUpdatableDataSink em um catálogo TraitDataSink .
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Devoluções | Um ponteiro para o TraitUpdatableDataSink ; NULL se o identificador não existir ou apontar para um TraitDataSink não atualizável. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, nl::Weave::TLV::TLVReader & inData )
Registre um evento de um formulário pré-serializado.
A função registra um evento representado como umnl :: Weave :: TLV :: TLVReader . Isso implica que a representação dos dados do evento já está serializada no armazenamento subjacente aonl :: Weave :: TLV :: TLVReader . Onl :: Weave :: TLV :: TLVReader deve conter pelo menos um único elemento de dados, esse elemento deve ser uma estrutura. O primeiro elemento lido pelo leitor é tratado como dados de evento e armazenado no log de eventos. Os dados do evento DEVEM conter tags de contexto a serem interpretados dentro do esquema identificado por inProfileID e inEventType. A tag do primeiro elemento será ignorada; o sistema de registro de eventos irá substituí-lo pela tag eventData.
O evento é registrado se sua importância exceder o limite de registro especificado em LoggingConfiguration . Se a importância do evento não atingir o limite atual, ele será descartado e a função retornará 0
como o ID do evento resultante.
Esta variante da invocação especifica implicitamente todas as opções de evento padrão:
- o evento é marcado com a hora atual no ponto da chamada,
- o evento é marcado como relacionado ao dispositivo que está fazendo a chamada,
- o evento é autônomo, não relacionado a nenhum outro evento,
- o evento é marcado como não urgente,
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Devoluções | event_id_t O ID do evento se o evento foi gravado no log, 0 caso contrário. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, nl::Weave::TLV::TLVReader & inData, const EventOptions *inOptions )
Registre um evento de um formulário pré-serializado, com opções adicionais.
A função registra um evento representado como umnl :: Weave :: TLV :: TLVReader . Isso implica que a representação dos dados do evento já está serializada no armazenamento subjacente aonl :: Weave :: TLV :: TLVReader . Espera-se que onl :: Weave :: TLV :: TLVReader contenha pelo menos um único elemento de dados, esse elemento deve ser uma estrutura. O primeiro elemento lido pelo leitor é tratado como dados de evento e armazenado no log de eventos. Os dados do evento DEVEM conter tags de contexto a serem interpretados dentro do esquema identificado por inProfileID e inEventType. A tag do primeiro elemento será ignorada; o sistema de registro de eventos irá substituí-lo pela tag eventData.
O evento é registrado se sua importância exceder o limite de registro especificado em LoggingConfiguration . Se a importância do evento não atingir o limite atual, ele será descartado e a função retornará 0
como o ID do evento resultante.
Esta variante da invocação permite que o chamador defina qualquer combinação de EventOptions
:
- timestamp, quando 0 padroniza para a hora atual no ponto da chamada,
- seção "raiz" da fonte do evento (fonte do evento e ID do trait); se NULL, o padrão é o dispositivo atual. o evento é marcado como relacionado ao dispositivo que está fazendo a chamada,
- um ID de evento relacionado para agrupar IDs de eventos; quando o ID do evento relacionado é 0, o evento é marcado como não relacionado a nenhum outro evento,
- urgência; por padrão, não urgente.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Devoluções | event_id_t O ID do evento se o evento foi gravado no log, 0 caso contrário. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData )
Registre um evento por meio de um retorno de chamada.
A função registra um evento representado como um EventWriterFunct e um contexto appData
específico do aplicativo. A função grava os metadados do evento e chama inEventWriter
com uma referêncianl :: Weave :: TLV :: TLVWriter e contexto inAppData
para que o código do usuário possa emitir os dados do evento diretamente no log de eventos. Essa forma de registro de eventos minimiza o consumo de memória, pois os dados do evento são serializados diretamente no buffer de destino. Os dados do evento DEVEM conter tags de contexto a serem interpretados dentro do esquema identificado por inProfileID
e inEventType
. A tag do primeiro elemento será ignorada; o sistema de registro de eventos irá substituí-lo pela tag eventData.
O evento é registrado se sua importância exceder o limite de registro especificado em LoggingConfiguration . Se a importância do evento não atingir o limite atual, ele será descartado e a função retornará 0
como o ID do evento resultante.
Esta variante da invocação especifica implicitamente todas as opções de evento padrão:
- o evento é marcado com a hora atual no ponto da chamada,
- o evento é marcado como relacionado ao dispositivo que está fazendo a chamada,
- o evento é autônomo, não relacionado a nenhum outro evento,
- o evento é marcado como não urgente,
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Devoluções | event_id_t O ID do evento se o evento foi gravado no log, 0 caso contrário. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData, const EventOptions *inOptions )
Registre um evento por meio de um retorno de chamada, com opções.
A função registra um evento representado como um EventWriterFunct e um contexto appData
específico do aplicativo. A função grava os metadados do evento e chama o inEventWriter
com uma referêncianl :: Weave :: TLV :: TLVWriter e contexto inAppData
para que o código do usuário possa emitir os dados do evento diretamente no log de eventos. Essa forma de registro de eventos minimiza o consumo de memória, pois os dados do evento são serializados diretamente no buffer de destino. Os dados do evento DEVEM conter tags de contexto a serem interpretados dentro do esquema identificado por inProfileID
e inEventType
. A tag do primeiro elemento será ignorada; o sistema de registro de eventos irá substituí-lo pela tag eventData.
O evento é registrado se sua importância exceder o limite de registro especificado em LoggingConfiguration . Se a importância do evento não atingir o limite atual, ele será descartado e a função retornará 0
como o ID do evento resultante.
Esta variante da invocação permite que o chamador defina qualquer combinação de EventOptions
:
- timestamp, quando 0 padroniza para a hora atual no ponto da chamada,
- seção "raiz" da fonte do evento (fonte do evento e ID do trait); se NULL, o padrão é o dispositivo atual. o evento é marcado como relacionado ao dispositivo que está fazendo a chamada,
- um ID de evento relacionado para agrupar IDs de eventos; quando o ID do evento relacionado é 0, o evento é marcado como não relacionado a nenhum outro evento,
- urgência; por padrão, não urgente.
Detalhes | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||||
Devoluções | event_id_t O ID do evento se o evento foi gravado no log, 0 caso contrário. |
LogFreeform
event_id_t LogFreeform( ImportanceType inImportance, const char *inFormat, ... )
LogFreeform emite uma string de forma livre para o fluxo de eventos padrão.
A string será encapsulada em uma estrutura de evento de depuração, estruturalmente idêntica a outras strings registradas. O ID do perfil do evento será o de um evento Nest Debug e o tipo de evento será kNestDebug_StringLogEntryEvent
.
Detalhes | |||||
---|---|---|---|---|---|
Parâmetros |
| ||||
Devoluções | event_id_t O ID do evento se o evento foi gravado no log, 0 caso contrário. |
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 )
Uma função auxiliar para emitir um texto de forma livre como um evento de depuração.
O evento de depuração é uma estrutura com uma região e um texto de forma livre.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Valores Retornados |
|
PlainTextWriter
WEAVE_ERROR PlainTextWriter( ::nl::Weave::TLV::TLVWriter & ioWriter, uint8_t inDataTag, void *appData )
Uma função auxiliar para emitir um texto de forma livre como um evento de depuração.
O evento de depuração é uma estrutura com uma região e um texto de forma livre.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Valores Retornados |
|
operador! =
bool operator!=( const ResourceIdentifier & lhs, const ResourceIdentifier & rhs )
operador ==
bool operator==( const ResourceIdentifier & lhs, const ResourceIdentifier & rhs )