Questa pagina è stata tradotta dall'API Cloud Translation.

Logging - Stack Thread

Questo modulo include definizioni correlate al logging OpenThread.

Riepilogo

Funzioni
`otDumpCritPlat(const char aText, const void aData, uint16_t aDataLength)`	`void void void void void void` Genera un dump della memoria a livello di log critico.
`otDumpDebgPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Genera un dump della memoria a livello di log di debug.
`otDumpInfoPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Genera un dump della memoria a livello di info log.
`otDumpNotePlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Genera un dump della memoria a livello di log delle note.
`otDumpWarnPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` Genera un dump della memoria a livello di log degli avvisi.
`otLogCli(otLogLevel aLogLevel, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2`	`void` Emette un messaggio di log a un determinato livello di log.
`otLogCritPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void` Emette un messaggio di log a livello di log critico.
`otLogDebgPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void void void` Emette un messaggio di log a livello di log di debug.
`otLogGenerateNextHexDumpLine(otLogHexDumpInfo *aInfo)`	`otError` Genera la linea di dump esadecimale successiva.
`otLogInfoPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void void` Emette un messaggio di log a livello di info log.
`otLogNotePlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void` Emette un messaggio di log a livello di log delle note.
`otLogPlat(otLogLevel aLogLevel, const char aPlatModuleName, const char aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3`	`void` Emette un messaggio di log a un determinato livello di log utilizzando un nome di modulo della piattaforma.
`otLogPlatArgs(otLogLevel aLogLevel, const char aPlatModuleName, const char aFormat, va_list aArgs)`	`void void` Emette un messaggio di log a un determinato livello di log utilizzando un nome di modulo della piattaforma.
`otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void` Emette un messaggio di log a livello di log degli avvisi.
`otLoggingGetLevel(void)`	`otLogLevel` Restituisce il livello di log corrente.
`otLoggingSetLevel(otLogLevel aLogLevel)`	`otError` Imposta il livello di log.

Strutture
otLogHexDumpInfo	Rappresenta le informazioni utilizzate per generare un output di dump esadecimale.

Funzioni

otDumpCritPlat

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

Genera un dump della memoria a livello di log critico.

Se OPENTHREAD_CONFIG_LOG_PLATFORM o OPENTHREAD_CONFIG_LOG_PKT_DUMP non sono impostati o se il livello di log attuale è inferiore al critico, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa stampata prima dei byte.
`[in] aData`	Un puntatore al buffer di dati.
`[in] aDataLength`	Numero di byte in `aData`.

otDumpDebgPlat

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

Genera un dump della memoria a livello di log di debug.

Se OPENTHREAD_CONFIG_LOG_PLATFORM o OPENTHREAD_CONFIG_LOG_PKT_DUMP non sono impostati o se il livello di log attuale è inferiore al debug, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa stampata prima dei byte.
`[in] aData`	Un puntatore al buffer di dati.
`[in] aDataLength`	Numero di byte in `aData`.

otDumpInfoPlat

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

Genera un dump della memoria a livello di info log.

Se OPENTHREAD_CONFIG_LOG_PLATFORM o OPENTHREAD_CONFIG_LOG_PKT_DUMP non è impostato o il livello di log corrente è inferiore a informazioni, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa stampata prima dei byte.
`[in] aData`	Un puntatore al buffer di dati.
`[in] aDataLength`	Numero di byte in `aData`.

otDumpNotePlat

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

Genera un dump della memoria a livello di log delle note.

Se OPENTHREAD_CONFIG_LOG_PLATFORM o OPENTHREAD_CONFIG_LOG_PKT_DUMP non è impostato o il livello di log attuale è inferiore, tieni presente che questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa stampata prima dei byte.
`[in] aData`	Un puntatore al buffer di dati.
`[in] aDataLength`	Numero di byte in `aData`.

otDumpWarnPlat

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

Genera un dump della memoria a livello di log degli avvisi.

Se OPENTHREAD_CONFIG_LOG_PLATFORM o OPENTHREAD_CONFIG_LOG_PKT_DUMP non sono impostati o se il livello di log attuale è inferiore a un avviso, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa stampata prima dei byte.
`[in] aData`	Un puntatore al buffer di dati.
`[in] aDataLength`	Numero di byte in `aData`.

otLogCli

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

Emette un messaggio di log a un determinato livello di log.

È destinato solo all'utilizzo tramite interfaccia a riga di comando. Se OPENTHREAD_CONFIG_LOG_CLI non è impostato o il livello di log corrente è inferiore al livello di log specificato, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aLogLevel`	Il livello log.
`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLogCritPlat

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

Emette un messaggio di log a livello di log critico.

È destinato all'uso da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log attuale è inferiore al critico, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLogDebgPlat

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

Emette un messaggio di log a livello di log di debug.

È destinato all'uso da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log attuale è inferiore al debug, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLogGenerateNextHexDumpLine

otError otLogGenerateNextHexDumpLine(
  otLogHexDumpInfo *aInfo
)

Genera la linea di dump esadecimale successiva.

Puoi chiamare questo metodo back-to-back per generare l'output del dump esadecimale riga per riga. Alla prima chiamata, il campo mIterator in aInfo DEVE essere impostato su zero.

Ecco un esempio dell'output di dump esadecimale generato:

"==========================[{mTitle} len=070]============================" "| 41 D8 87 34 12 FF FF 25 | 4C 57 DA F2 FB 2F 62 7F | A..4...%LW.../b. |" "| 3B 01 F0 4D 4C 4D 4C 54 | 4F 00 15 15 00 00 00 00 | ;..MLMLTO....... |" "| 00 00 00 01 80 DB 60 82 | 7E 33 72 3B CC B3 A1 84 | ......`.~3r;.... |" "| 3B E6 AD B2 0B 45 E7 45 | C5 B9 00 1A CB 2D 6D 1C | ;....E.E.....-m. |" "| 10 3E 3C F5 D3 70 | | .><..p |" "-----------------------------------------------------------"

Dettagli

Parametri

[in,out] aInfo

Un puntatore a otLogHexDumpInfo da utilizzare per generare il dump esadecimale.

Valori restituiti

`OT_ERROR_NONE`	La riga successiva è stata generata correttamente, il campo `mLine` in `aInfo` è stato aggiornato.
`OT_ERROR_NOT_FOUND`	Hai raggiunto la fine e non c'è più linea da generare.

otLogInfoPlat

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

Emette un messaggio di log a livello di info log.

È destinato all'uso da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log attuale è inferiore a quello specificato, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLogNotePlat

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

Emette un messaggio di log a livello di log delle note.

È destinato all'uso da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log attuale è inferiore a quello noto, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLogPlat

void otLogPlat(
  otLogLevel aLogLevel,
  const char *aPlatModuleName,
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3

Emette un messaggio di log a un determinato livello di log utilizzando un nome di modulo della piattaforma.

È destinato all'uso da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log corrente è inferiore a aLogLevel , questa funzione non emette messaggi di log.

Il nome aPlatModuleName viene utilizzato per determinare il nome del modulo di log nel messaggio di log emesso, nel formato P-{PlatModuleName}---. Ciò significa che viene aggiunta la stringa del prefisso "P-" per indicare che si tratta di un sottomodulo della piattaforma, seguito dai 12 caratteri successivi della stringa PlatModuleName, con trattini di riempimento - alla fine per garantire che il nome della regione sia lungo 14 caratteri.

Dettagli

Parametri

`[in] aLogLevel`	Il livello log.
`[in] aPlatModuleName`	Il nome del sottomodulo della piattaforma.
`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLogPlatArgs

void void otLogPlatArgs(
  otLogLevel aLogLevel,
  const char *aPlatModuleName,
  const char *aFormat,
  va_list aArgs
)

Emette un messaggio di log a un determinato livello di log utilizzando un nome di modulo della piattaforma.

Dettagli

Parametri

`[in] aLogLevel`	Il livello log.
`[in] aPlatModuleName`	Il nome del sottomodulo della piattaforma.
`[in] aFormat`	La stringa del formato.
`[in] aArgs`	Argomenti per la specifica del formato.

otLogWarnPlat

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

Emette un messaggio di log a livello di log degli avvisi.

È destinato all'uso da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log attuale è inferiore a un avviso, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aFormat`	La stringa del formato.
`[in] ...`	Argomenti per la specifica del formato.

otLoggingGetLevel

otLogLevel otLoggingGetLevel(
  void
)

Restituisce il livello di log corrente.

Se la funzionalità dinamica a livello di log OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE è abilitata, questa funzione restituisce il livello di log dinamico attualmente impostato. In caso contrario, questa funzione restituisce il livello di log configurato in fase di build.

Dettagli
Restituisce	Il livello log.

otLoggingSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

Imposta il livello di log.

Nota: questa funzione richiede OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1.

Dettagli

Parametri

[in] aLogLevel

Il livello log.

Valori restituiti

`OT_ERROR_NONE`	Livello di log aggiornato correttamente.
`OT_ERROR_INVALID_ARGS`	Il valore a livello di log non è valido.

Macro

OT_LOG_HEX_DUMP_LINE_SIZE

 OT_LOG_HEX_DUMP_LINE_SIZE 73

Dimensioni della stringa della riga di dump esadecimale.

Risorse

Gli argomenti di riferimento API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.

Logging - Stack Thread

Riepilogo

Funzioni

Strutture

Funzioni

otDumpCritPlat

otDumpDebgPlat

otDumpInfoPlat

otDumpNotePlat

otDumpWarnPlat

otLogCli

otLogCritPlat

otLogDebgPlat

otLogGenerateNextHexDumpLine

otLogInfoPlat

otLogNotePlat

otLogPlat

otLogPlatArgs

otLogWarnPlat

otLoggingGetLevel

otLoggingSetLevel

Macro

OT_LOG_HEX_DUMP_LINE_SIZE

Risorse