Questa pagina è stata tradotta dall'API Cloud Translation.

Logging - Stack thread

Questo modulo include le definizioni relative 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 di avviso.
`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 riga 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 log informazioni.
`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 il nome di un 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 il nome di un 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 di avviso.
`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 il livello di log corrente è inferiore a quello critico, questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa che viene stampata prima dei byte.
`[in] aData`	Un puntatore al buffer dei 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 è impostato o il livello di log attuale è inferiore al debug, questa funzione non emette alcun messaggio di log.

Dettagli

Parametri

`[in] aText`	Una stringa che viene stampata prima dei byte.
`[in] aData`	Un puntatore al buffer dei 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 sono impostati o il livello di log corrente è inferiore a info, questa funzione non emette alcun messaggio di log.

Dettagli

Parametri

`[in] aText`	Una stringa che viene stampata prima dei byte.
`[in] aData`	Un puntatore al buffer dei 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 sono impostati o il livello di log corrente è inferiore, tieni presente che questa funzione non emette messaggi di log.

Dettagli

Parametri

`[in] aText`	Una stringa che viene stampata prima dei byte.
`[in] aData`	Un puntatore al buffer dei 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 di avviso.

Se OPENTHREAD_CONFIG_LOG_PLATFORM o OPENTHREAD_CONFIG_LOG_PKT_DUMP non sono impostati o il livello di log corrente è inferiore a questo avviso, questa funzione non emette alcun messaggio di log.

Dettagli

Parametri

`[in] aText`	Una stringa che viene stampata prima dei byte.
`[in] aData`	Un puntatore al buffer dei 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 esclusivamente 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 di 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'utilizzo da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log corrente è inferiore a quello 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'utilizzo 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 riga di dump esadecimale successiva.

Puoi richiamare questo metodo in sequenza 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 del 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`	Raggiunta 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 log informazioni.

È destinato all'utilizzo da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log corrente è 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'utilizzo da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log corrente è inferiore alla nota, 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 il nome di un modulo della piattaforma.

È destinato all'utilizzo 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 prefisso "P-" per indicare che si tratta di un sottomodulo della piattaforma, seguito dai 12 caratteri successivi della stringa PlatModuleName, con trattini imbottiti - alla fine per garantire che il nome della regione abbia una lunghezza di 14 caratteri.

Dettagli

Parametri

`[in] aLogLevel`	Il livello di 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 il nome di un modulo della piattaforma.

Dettagli

Parametri

`[in] aLogLevel`	Il livello di 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 di avviso.

È destinato all'utilizzo da parte della piattaforma. Se OPENTHREAD_CONFIG_LOG_PLATFORM non è impostato o il livello di log corrente è inferiore all'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à a livello di log dinamico 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 di 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 di 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 dell'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