本頁面由 Cloud Translation API 翻譯而成。

記錄 - 執行緒堆疊

這個模組包含 OpenThread 記錄相關定義。

摘要

Functions
`otDumpCritPlat(const char aText, const void aData, uint16_t aDataLength)`	`void void void void void void` 這個函式會在重大記錄檔層級產生記憶體傾印。
`otDumpDebgPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` 這個函式會在偵錯記錄檔層級產生記憶體傾印。
`otDumpInfoPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` 這個函式會在資訊記錄層級產生記憶體傾印。
`otDumpNotePlat(const char aText, const void aData, uint16_t aDataLength)`	`void` 這個函式會在附註記錄檔層級產生記憶體傾印。
`otDumpWarnPlat(const char aText, const void aData, uint16_t aDataLength)`	`void` 這個函式會在警告記錄層級產生記憶體傾印。
`otLogCli(otLogLevel aLogLevel, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2`	`void` 這個函式會在特定記錄層級發出記錄訊息。
`otLogCritPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void` 這個函式會在重要記錄層級發出記錄訊息。
`otLogDebgPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void void void` 這個函式會在偵錯記錄檔層級發出記錄訊息。
`otLogInfoPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void void` 這個函式會在資訊記錄層級發出記錄訊息。
`otLogNotePlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void void` 這個函式會在附註記錄層級發出記錄訊息。
`otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1`	`void void` 這個函式會在警告記錄層級發出記錄訊息。
`otLoggingGetLevel(void)`	`otLogLevel` 這個函式會傳回目前的記錄層級。
`otLoggingSetLevel(otLogLevel aLogLevel)`	`otError` 這個函式會設定記錄層級。

Functions

otDumpCritPlat

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

這個函式會在重大記錄檔層級產生記憶體傾印。

如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或 OPENTHREAD_CONFIG_LOG_PKT_DUMP，或目前的記錄層級低於重要程度，此函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aText`	顯示在位元組之前的字串。
`[in] aData`	資料緩衝區的指標。
`[in] aDataLength`	`aData` 中的位元組數。

otDumpDebgPlat

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

這個函式會在偵錯記錄檔層級產生記憶體傾印。

如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或 OPENTHREAD_CONFIG_LOG_PKT_DUMP，或目前的記錄層級低於偵錯設定，此函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aText`	顯示在位元組之前的字串。
`[in] aData`	資料緩衝區的指標。
`[in] aDataLength`	`aData` 中的位元組數。

otDumpInfoPlat

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

這個函式會在資訊記錄層級產生記憶體傾印。

如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或 OPENTHREAD_CONFIG_LOG_PKT_DUMP，或目前的記錄層級低於資訊，這個函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aText`	顯示在位元組之前的字串。
`[in] aData`	資料緩衝區的指標。
`[in] aDataLength`	`aData` 中的位元組數。

otDumpNotePlat

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

這個函式會在附註記錄檔層級產生記憶體傾印。

如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或 OPENTHREAD_CONFIG_LOG_PKT_DUMP 或目前的記錄層級低於此函式，此函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aText`	顯示在位元組之前的字串。
`[in] aData`	資料緩衝區的指標。
`[in] aDataLength`	`aData` 中的位元組數。

otDumpWarnPlat

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

這個函式會在警告記錄層級產生記憶體傾印。

如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或 OPENTHREAD_CONFIG_LOG_PKT_DUMP，或是目前的記錄層級低於警告，則這個函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aText`	顯示在位元組之前的字串。
`[in] aData`	資料緩衝區的指標。
`[in] aDataLength`	`aData` 中的位元組數。

OTLogCli

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

這個函式會在特定記錄層級發出記錄訊息。

這個函式僅供 CLI 使用。如果未設定 OPENTHREAD_CONFIG_LOG_CLI 或目前的記錄層級低於指定記錄層級，此函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aLogLevel`	記錄層級。
`[in] aFormat`	格式字串。
`[in] ...`	格式規格的引數。

OTLogCritPlat

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

這個函式會在重要記錄層級發出記錄訊息。

此函式適用於平台。如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或目前的記錄層級低於重大，這個函式就不會發出任何記錄訊息。

詳細說明

參數

`[in] aFormat`	格式字串。
`[in] ...`	格式規格的引數。

otLogDebgPlat

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

這個函式會在偵錯記錄檔層級發出記錄訊息。

此函式適用於平台。如未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或目前的記錄層級低於偵錯，這個函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aFormat`	格式字串。
`[in] ...`	格式規格的引數。

OTLogInfoPlat

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

這個函式會在資訊記錄層級發出記錄訊息。

此函式適用於平台。如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或目前的記錄層級低於資訊，這個函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aFormat`	格式字串。
`[in] ...`	格式規格的引數。

OTLogNotePlat

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

這個函式會在附註記錄層級發出記錄訊息。

此函式適用於平台。如未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或目前的記錄層級低於附註，這個函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aFormat`	格式字串。
`[in] ...`	格式規格的引數。

OTLogWarnPlat

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

這個函式會在警告記錄層級發出記錄訊息。

此函式適用於平台。如未設定 OPENTHREAD_CONFIG_LOG_PLATFORM 或目前的記錄層級低於警告，這個函式不會發出任何記錄訊息。

詳細說明

參數

`[in] aFormat`	格式字串。
`[in] ...`	格式規格的引數。

otLoggingGetLevel

otLogLevel otLoggingGetLevel(
  void
)

這個函式會傳回目前的記錄層級。

如果已啟用動態記錄層級功能 OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE，此函式會傳回目前設定的動態記錄層級。否則，此函式會傳回建構時間設定的記錄層級。

詳細說明
傳回	記錄層級。

otLoggingSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

這個函式會設定記錄層級。

注意：此函式需要 OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1。

詳細說明

參數

[in] aLogLevel

記錄層級。

傳回值

`OT_ERROR_NONE`	已成功更新記錄層級。
`OT_ERROR_INVALID_ARGS`	記錄層級值無效。

資源

OpenThread API 參考資料主題出自原始碼，可於 GitHub 取得。如需更多資訊，或想參閱我們的說明文件，請參閱資源。