Esta página foi traduzida pela API Cloud Translation.

Logging – pilha de linhas de execução

Este módulo inclui definições relacionadas à geração de registros do OpenThread.

Resumo

Funções
`otDumpCritPlat(const char aText, const void aData, uint16_t aDataLength)`	`void void void void void void` Essa função gera um despejo de memória no nível de registro crítico.
`otDumpDebgPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Essa função gera um despejo de memória no nível do registro de depuração.
`otDumpInfoPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Essa função gera um despejo de memória no nível do registro de informações.
`otDumpNotePlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Essa função gera um despejo de memória no nível do registro de notas.
`otDumpWarnPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Essa função gera um despejo de memória no nível de registro de aviso.
`otLogCli(otLogLevel aLogLevel, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2`	`void` Essa função emite uma mensagem de registro em um determinado nível de registro.
`otLogCritPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void` Essa função emite uma mensagem de registro no nível de registro crítico.
`otLogDebgPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void void void` Essa função emite uma mensagem de registro no nível de registro de depuração.
`otLogInfoPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void void` Essa função emite uma mensagem de registro no nível de registro de informações.
`otLogNotePlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void` Essa função emite uma mensagem de registro no nível do registro de notas.
`otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void` Essa função emite uma mensagem de registro no nível de registro de aviso.
`otLoggingGetLevel(void)`	`otLogLevel` Essa função retorna o nível de registro atual.
`otLoggingSetLevel(otLogLevel aLogLevel)`	`otError` Essa função define o nível de registro.

Funções

OtDumpCritPlat

void void void void void void otDumpCritPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Essa função gera um despejo de memória no nível de registro crítico.

Se OPENTHREAD_CONFIG_LOG_PLATFORM ou OPENTHREAD_CONFIG_LOG_PKT_DUMP não estiverem definidos ou se o nível de registro atual estiver abaixo do crítico, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aText`	Uma string impressa antes dos bytes.
`[in] aData`	Um ponteiro para o buffer de dados.
`[in] aDataLength`	Número de bytes em `aData`.

OtDumpDebgPlat

void otDumpDebgPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Essa função gera um despejo de memória no nível do registro de depuração.

Se OPENTHREAD_CONFIG_LOG_PLATFORM ou OPENTHREAD_CONFIG_LOG_PKT_DUMP não estiverem definidos ou se o nível de registro atual estiver abaixo da depuração, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aText`	Uma string impressa antes dos bytes.
`[in] aData`	Um ponteiro para o buffer de dados.
`[in] aDataLength`	Número de bytes em `aData`.

OtDumpInfoPlat

void otDumpInfoPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Essa função gera um despejo de memória no nível do registro de informações.

Se OPENTHREAD_CONFIG_LOG_PLATFORM ou OPENTHREAD_CONFIG_LOG_PKT_DUMP não estiverem definidos ou se o nível de registro atual estiver abaixo das informações, esta função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aText`	Uma string impressa antes dos bytes.
`[in] aData`	Um ponteiro para o buffer de dados.
`[in] aDataLength`	Número de bytes em `aData`.

OtDumpNotePlat

void otDumpNotePlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Essa função gera um despejo de memória no nível do registro de notas.

Se OPENTHREAD_CONFIG_LOG_PLATFORM ou OPENTHREAD_CONFIG_LOG_PKT_DUMP não estiverem definidos ou se o nível de registro atual estiver abaixo da nota, esta função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aText`	Uma string impressa antes dos bytes.
`[in] aData`	Um ponteiro para o buffer de dados.
`[in] aDataLength`	Número de bytes em `aData`.

OtDumpWarnPlat

void otDumpWarnPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Essa função gera um despejo de memória no nível de registro de aviso.

Se OPENTHREAD_CONFIG_LOG_PLATFORM ou OPENTHREAD_CONFIG_LOG_PKT_DUMP não estiverem definidos ou se o nível de registro atual estiver abaixo do aviso, esta função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aText`	Uma string impressa antes dos bytes.
`[in] aData`	Um ponteiro para o buffer de dados.
`[in] aDataLength`	Número de bytes em `aData`.

OtLogCli

void otLogCli(
  otLogLevel aLogLevel,
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2

Essa função emite uma mensagem de registro em um determinado nível de registro.

Esta função é destinada apenas ao uso da CLI. Se OPENTHREAD_CONFIG_LOG_CLI não estiver definido ou o nível de registro atual estiver abaixo do nível fornecido, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aLogLevel`	O nível de registro.
`[in] aFormat`	String de formato.
`[in] ...`	Argumentos para a especificação do formato.

OtLogCritPlat

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

Essa função emite uma mensagem de registro no nível de registro crítico.

Esta função é destinada ao uso por plataforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM não estiver definido ou se o nível de registro atual estiver abaixo do crítico, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aFormat`	String de formato.
`[in] ...`	Argumentos para a especificação do formato.

OtLogDebgPlat

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

Essa função emite uma mensagem de registro no nível de registro de depuração.

Esta função é destinada ao uso por plataforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM não estiver definido ou se o nível de registro atual estiver abaixo da depuração, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aFormat`	String de formato.
`[in] ...`	Argumentos para a especificação do formato.

OtLogInfoPlat

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

Essa função emite uma mensagem de registro no nível de registro de informações.

Esta função é destinada ao uso por plataforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM não estiver definido ou se o nível de registro atual estiver abaixo das informações, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aFormat`	String de formato.
`[in] ...`	Argumentos para a especificação do formato.

OtLogNotePlat

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

Essa função emite uma mensagem de registro no nível do registro de notas.

Esta função é destinada ao uso por plataforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM não estiver definido ou se o nível de registro atual estiver abaixo da nota, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aFormat`	String de formato.
`[in] ...`	Argumentos para a especificação do formato.

OtLogWarnPlat

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

Essa função emite uma mensagem de registro no nível de registro de aviso.

Esta função é destinada ao uso por plataforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM não estiver definido ou se o nível de registro atual estiver abaixo do aviso, essa função não emitirá nenhuma mensagem de registro.

Detalhes

Parâmetros

`[in] aFormat`	String de formato.
`[in] ...`	Argumentos para a especificação do formato.

OtLoggingGetLevel

otLogLevel otLoggingGetLevel(
  void
)

Essa função retorna o nível de registro atual.

Se o recurso de nível de registro dinâmico OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE estiver ativado, esta função retornará o nível de registro dinâmico definido atualmente. Caso contrário, essa função retornará o nível de registro configurado no tempo de compilação.

Detalhes
Retorna	O nível de registro.

OtLoggingSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

Essa função define o nível de registro.

Observação: esta função requer OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1.

Detalhes

Parâmetros

[in] aLogLevel

O nível de registro.

Valores de retorno

`OT_ERROR_NONE`	O nível de registro foi atualizado.
`OT_ERROR_INVALID_ARGS`	O valor do nível de registro é inválido.

Recursos

Os tópicos de referência da API OpenThread são provenientes do código-fonte, disponível no GitHub. Para saber mais ou contribuir com nossa documentação, consulte Recursos.