로깅 - 스레드 스택

이 모듈에는 OpenThread 로깅 관련 정의가 포함되어 있습니다.

요약

함수
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
디버그 로그 수준에서 로그 메시지를 생성합니다.
otLogGenerateNextHexDumpLine(otLogHexDumpInfo *aInfo)
다음 16진수 덤프 라인을 생성합니다.
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
메모 로그 수준에서 로그 메시지를 생성합니다.
otLogPlat(otLogLevel aLogLevel, const char *aPlatModuleName, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3
void
플랫폼 모듈 이름을 사용하여 지정된 로그 수준에서 로그 메시지를 생성합니다.
otLogPlatArgs(otLogLevel aLogLevel, const char *aPlatModuleName, const char *aFormat, va_list aArgs)
void void
플랫폼 모듈 이름을 사용하여 지정된 로그 수준에서 로그 메시지를 생성합니다.
otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1
void void
경고 로그 수준에서 로그 메시지를 생성합니다.
otLoggingGetLevel(void)
현재 로그 수준을 반환합니다.
otLoggingSetLevel(otLogLevel aLogLevel)
로그 수준을 설정합니다.

구조체
otLogHexDumpInfo

16진수 덤프 출력을 생성하는 데 사용되는 정보를 나타냅니다.

함수

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가 설정되지 않았거나 현재 로그 수준이 info보다 낮은 경우 이 함수는 로그 메시지를 내보내지 않습니다.

세부정보
매개변수
[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] ...
형식 사양의 인수입니다.

otLogGenerateNextHexDumpLine

otError otLogGenerateNextHexDumpLine(
  otLogHexDumpInfo *aInfo
)

다음 16진수 덤프 라인을 생성합니다.

이 메서드를 연달아 호출하여 16진수 덤프 출력을 한 줄씩 생성할 수 있습니다. 첫 번째 호출에서 aInfo의 mIterator 필드는 0으로 설정되어야 합니다.

다음은 생성된 16진수 덤프 출력의 예입니다.

"==========================[{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 |" "---------------------------------------------------------------------------------------"

세부정보
매개변수
[in,out] aInfo
16진수 덤프를 생성하는 데 사용할 otLogHexDumpInfo의 포인터입니다.
반환 값
OT_ERROR_NONE
다음 줄이 성공적으로 생성되어 aInfo의 mLine 필드가 업데이트됩니다.
OT_ERROR_NOT_FOUND
끝에 도달했으며 더 이상 생성할 줄이 없습니다.

otLogInfoPlat

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

정보 로그 수준에서 로그 메시지를 생성합니다.

플랫폼에서 사용하기 위한 용도입니다. OPENTHREAD_CONFIG_LOG_PLATFORM가 설정되지 않았거나 현재 로그 수준이 info보다 낮은 경우 이 함수는 로그 메시지를 내보내지 않습니다.

세부정보
매개변수
[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] ...
형식 사양의 인수입니다.

otLogPlat

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

플랫폼 모듈 이름을 사용하여 지정된 로그 수준에서 로그 메시지를 생성합니다.

이는 플랫폼에서 사용하기 위한 것입니다. OPENTHREAD_CONFIG_LOG_PLATFORM가 설정되지 않았거나 현재 로그 수준이 aLogLevel 미만이면 이 함수는 로그 메시지를 내보내지 않습니다.

aPlatModuleName 이름은 내보낸 로그 메시지에서 P-{PlatModuleName}--- 형식에 따라 로그 모듈 이름을 결정하는 데 사용됩니다. 즉, 플랫폼 하위 모듈임을 나타내기 위해 접두사 문자열 'P-'가 추가되고 그 뒤에 PlatModuleName 문자열의 다음 12자가 붙으며, 지역 이름이 14자(영문 기준)가 되도록 끝에 패딩 처리된 하이픈 -이 추가됩니다.

세부정보
매개변수
[in] aLogLevel
로그 수준입니다.
[in] aPlatModuleName
플랫폼 하위 모듈 이름입니다.
[in] aFormat
형식 문자열입니다.
[in] ...
형식 사양의 인수입니다.

otLogPlatArgs

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

플랫폼 모듈 이름을 사용하여 지정된 로그 수준에서 로그 메시지를 생성합니다.

이는 플랫폼에서 사용하기 위한 것입니다. OPENTHREAD_CONFIG_LOG_PLATFORM가 설정되지 않았거나 현재 로그 수준이 aLogLevel 미만이면 이 함수는 로그 메시지를 내보내지 않습니다.

aPlatModuleName 이름은 내보낸 로그 메시지에서 P-{PlatModuleName}--- 형식에 따라 로그 모듈 이름을 결정하는 데 사용됩니다. 즉, 플랫폼 하위 모듈임을 나타내기 위해 접두사 문자열 'P-'가 추가되고 그 뒤에 PlatModuleName 문자열의 다음 12자가 붙으며, 지역 이름이 14자(영문 기준)가 되도록 끝에 패딩 처리된 하이픈 -이 추가됩니다.

세부정보
매개변수
[in] aLogLevel
로그 수준입니다.
[in] aPlatModuleName
플랫폼 하위 모듈 이름입니다.
[in] aFormat
형식 문자열입니다.
[in] aArgs
형식 사양의 인수입니다.

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
)

로그 수준을 설정합니다.

세부정보
매개변수
[in] aLogLevel
로그 수준입니다.
반환 값
OT_ERROR_NONE
로그 수준이 업데이트되었습니다.
OT_ERROR_INVALID_ARGS
로그 수준 값이 잘못되었습니다.

매크로

OT_LOG_HEX_DUMP_LINE_SIZE

 OT_LOG_HEX_DUMP_LINE_SIZE 73

16진수 덤프 행 문자열 크기입니다.

자료

OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.