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

記錄 - 執行緒堆疊

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

摘要

函式
`otDumpCritPlat(const char aText, const void aData, uint16_t aDataLength)`	`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, ...)`	`void` 此函式會在指定的記錄層級發出記錄訊息。
`otLogCritPlat(const char *aFormat, ...)`	`void` 這個函式會在關鍵記錄層級發出記錄訊息。
`otLogDebgPlat(const char *aFormat, ...)`	`void` 這個函式會在偵錯記錄層級發出記錄訊息。
`otLogInfoPlat(const char *aFormat, ...)`	`void` 這個函式會在資訊記錄層級發出記錄訊息。
`otLogNotePlat(const char *aFormat, ...)`	`void` 這個函式會在記事記錄層級發出記錄訊息。
`otLogWarnPlat(const char *aFormat, ...)`	`void` 這個函式會在警告記錄層級發出記錄訊息。
`otLoggingGetLevel(void)`	`otLogLevel` 此函式會傳回目前的記錄層級。
`otLoggingSetLevel(otLogLevel aLogLevel)`	`otError` 此函式會設定記錄層級。

函式

otDumpCritPlat

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`中的位元組數。

ThDumpNotePlat

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`中的位元組數。

OtumpWarnPlat 購物中心

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,
  ...
)

此函式會在指定的記錄層級發出記錄訊息。

這項功能僅限 CLI 使用。如果未設定 OPENTHREAD_CONFIG_LOG_CLI，或是目前的記錄層級低於指定紀錄層級，這個函式就不會發出任何紀錄訊息。

詳情

參數

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

TELogCritPlat

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

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

這項功能適用於平台。如果未設定 OPENTHREAD_CONFIG_LOG_PLATFORM，或是目前的記錄等級低於重要性，這個函式就不會發送任何記錄訊息。

詳情

參數

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

otLogDebgPlat

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

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

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

詳情

參數

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

otLogInfoPlat

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

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

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

詳情

參數

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

TELogNotePlat

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

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

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

詳情

參數

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

otLogWarnPlat

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

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

這項功能適用於平台。如果未設定 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 取得。如要瞭解詳情或參閱說明文件，請參閱資源。