Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

기록 추적기

다양한 이벤트(예: RX 및 TX 메시지 또는 네트워크 정보 변경) 내역을 기록합니다.

요약

추적된 모든 항목에 타임스탬프가 지정됩니다.

이 모듈의 함수는 OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE가 사용 설정된 경우 사용할 수 있습니다.

열거

anonymous enum{
  OT_HISTORY_TRACKER_MSG_PRIORITY_LOW = OT_MESSAGE_PRIORITY_LOW,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL = OT_MESSAGE_PRIORITY_NORMAL,
  OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH = OT_MESSAGE_PRIORITY_HIGH,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NET = OT_MESSAGE_PRIORITY_HIGH + 1
}
enum
otHistoryTrackerMessageInfo 구조체에 사용되는 메시지 우선순위를 나타내는 상수입니다.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enum
이 열거는 IPv6 (유니캐스트 또는 멀티캐스트) 주소 정보 (주소 추가 또는 삭제 여부)에 대한 이벤트를 정의합니다.
otHistoryTrackerNeighborEvent{
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED = 2,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING = 3
}
enum
이 열거는 주변 정보 (예:
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
}
enum
이 열거는 네트워크 데이터 항목의 이벤트 (예: 항목 추가 또는 삭제)를 정의합니다.

Typedef

otHistoryTrackerExternalRouteInfo typedef
이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다.
otHistoryTrackerIterator typedef
이 유형은 기록 목록을 반복할 반복기를 나타냅니다.
otHistoryTrackerMessageInfo typedef
이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다.
otHistoryTrackerMulticastAddressInfo typedef
이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다.
otHistoryTrackerNeighborInfo typedef
이 구조는 인접 정보를 나타냅니다.
otHistoryTrackerNetworkInfo typedef
이 구조는 스레드 네트워크 정보를 나타냅니다.
otHistoryTrackerOnMeshPrefixInfo typedef
이 구조는 메시 프리픽스 정보의 네트워크 데이터를 나타냅니다.
otHistoryTrackerUnicastAddressInfo typedef
이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다.

함수

otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
이 함수는 지정된 연령을 사람이 읽을 수 있는 문자열로 변환합니다.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
이 함수는 otHistoryTrackerIterator를 초기화합니다.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 네트워크 데이터 외부 경로 항목 기록 목록의 항목을 반복합니다.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 멀티캐스트 주소 기록 목록의 항목을 반복합니다.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 인접 내역 목록의 항목을 반복합니다.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 네트워크 정보 기록 목록의 항목을 반복합니다.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 메시 프리픽스 항목 기록 목록의 네트워크 데이터 항목을 반복합니다.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 RX 메시지 기록 목록의 항목을 반복합니다.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 TX 메시지 기록 목록의 항목을 반복합니다.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
이 함수는 유니캐스트 주소 기록 목록의 항목을 반복합니다.

구조체

otHistoryTrackerExternalRouteInfo를 참조하세요.

이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다.

otHistoryTrackerIterator 사용

이 유형은 기록 목록을 반복할 반복기를 나타냅니다.

otHistoryTrackerMessageInfo에서 추가합니다.

이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다.

otHistoryTrackerMulticastAddressInfo

이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다.

otHistoryTrackerNeighborInfo

이 구조는 인접 정보를 나타냅니다.

otHistoryTrackerNetworkInfo

이 구조는 스레드 네트워크 정보를 나타냅니다.

otHistoryTrackerOnMeshPrefixInfo를 사용합니다.

이 구조는 메시 프리픽스 정보의 네트워크 데이터를 나타냅니다.

otHistoryTrackerUnicastAddressInfo

이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다.

열거

익명 enum

 anonymous enum

otHistoryTrackerMessageInfo 구조체에 사용되는 메시지 우선순위를 나타내는 상수입니다.

속성
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

높은 우선순위 수준

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

낮은 우선순위 수준

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

네트워크 제어 우선순위 수준

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

보통 우선순위 수준입니다.

otHistoryTrackerAddressEventEvent

 otHistoryTrackerAddressEvent

이 열거는 IPv6 (유니캐스트 또는 멀티캐스트) 주소 정보 (주소 추가 또는 삭제 여부)에 대한 이벤트를 정의합니다.

속성
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

주소가 추가되었습니다.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

주소가 삭제됩니다.

otHistoryTrackerNeighborEvent의 예

 otHistoryTrackerNeighborEvent

이 열거는 주변 정보 (예:

인접 항목 추가, 삭제, 변경)를 선택할 수 있습니다.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING 이벤트는 하위 인접 항목에만 적용됩니다. 이 이벤트는 기기가 (다시) 시작된 후, 이전 하위 요소 목록이 비휘발성 설정에서 검색되고 기기에서 연결 복원을 시도할 때 트리거됩니다.

속성
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

인접 항목이 추가됩니다.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

인접 항목이 변경되었습니다 (예: 기기 모드 플래그 변경).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

인접 항목이 삭제되었습니다.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

주변 지역을 복원 중입니다 (자녀에게만 적용).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

이 열거는 네트워크 데이터 항목의 이벤트 (예: 항목 추가 또는 삭제)를 정의합니다.

속성
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

네트워크 데이터 항목이 추가되었습니다.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

네트워크 데이터 입력은 삭제됩니다.

Typedef

otHistoryTracker외부RouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다.

otHistoryTrackerIterator에서 열기

struct otHistoryTrackerIterator otHistoryTrackerIterator

이 유형은 기록 목록을 반복할 반복기를 나타냅니다.

이 유형의 필드는 불투명하며 (OpenThread Core에서 사용 가능) 호출자에 의해 액세스되거나 사용되어서는 안 됩니다.

반복기를 사용하려면 먼저 otHistoryTrackerInitIterator()를 사용하여 초기화해야 합니다.

otHistoryTrackerMessageInfo:

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다.

이 구조체의 일부 필드는 RX 메시지 또는 TX 메시지에만 적용됩니다. 예: mAveRxRss는 수신된 메시지를 구성하는 모든 프래그먼트 프레임의 평균 RSS이며 RX 메시지에만 적용됩니다.

otHistoryTrackerMulticastAddressInfo:

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다.

otHistoryTrackerNeighborInfo입니다.

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

이 구조는 인접 정보를 나타냅니다.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

이 구조는 스레드 네트워크 정보를 나타냅니다.

otHistoryTrackerOnMeshPrefixInfoInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

이 구조는 메시 프리픽스 정보의 네트워크 데이터를 나타냅니다.

otHistoryTrackerUnicastAddressInfo입니다.

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다.

함수

otHistoryTrackerEntryAgeToString : otHistoryTrackerEntryAgeToString

void otHistoryTrackerEntryAgeToString(
  uint32_t aEntryAge,
  char *aBuffer,
  uint16_t aSize
)

이 함수는 지정된 연령을 사람이 읽을 수 있는 문자열로 변환합니다.

항목 연령 문자열은 '::에서 확인할 수 있습니다.시간, 분, 초, 밀리초 (1일 미만) 또는 "

::." (1일보다 긴 경우)

결과 문자열이 aSize 문자 내의 aBuffer에 맞지 않으면 문자열이 잘리지만 출력 문자열은 항상 null로 끝납니다.

세부정보
매개변수
[in] aEntryAge
항목 경과 기간 (밀리초 단위 기간)
[out] aBuffer
문자열을 출력하기 위한 문자 배열에 대한 포인터입니다 (NULL이면 안 됨).
[in] aSize
aBuffer의 크기입니다. OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 사용 권장.

otHistoryTrackerInitIterator에서 다운로드

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

이 함수는 otHistoryTrackerIterator를 초기화합니다.

반복기는 사용하기 전에 초기화되어야 합니다.

반복기를 다시 초기화하여 목록의 시작 부분부터 시작할 수 있습니다.

목록에 있는 항목을 반복할 때 항목 연령이 일관되도록 보장하기 위해 반복기가 초기화된 시간을 기준으로 연령이 제공됩니다.즉, 항목이 경과되었을 때 이벤트 기간(밀리초)이 제공됩니다. 이터레이터 초기화 시간으로 변환합니다.

세부정보
매개변수
[in] aIterator
초기화할 반복자에 대한 포인터입니다 (NULL이 아니어야 함).

otHistoryTrackerIterateExternalRouteHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 네트워크 데이터 외부 경로 항목 기록 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerExternalRouteInfo 항목 또는 NULL(목록에 더 이상 항목이 없는 경우)

otHistoryTrackerIterateMulticastAddressHistory

const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 멀티캐스트 주소 기록 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerMulticastAddressInfo 항목 포인터 또는 목록에 항목이 더 이상 없는 경우 NULL

otHistoryTrackerIterateNeighborHistory

const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 인접 내역 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerNeighborInfo 항목 또는 NULL(목록에 더 이상 항목이 없는 경우)

otHistoryTrackerIterateNetInfoHistory

const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 네트워크 정보 기록 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerNetworkInfo 항목 포인터 또는 목록에 항목이 더 이상 없는 경우 NULL

otHistoryTrackerIterateOnMeshPrefixHistory

const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 메시 프리픽스 항목 기록 목록의 네트워크 데이터 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerOnMeshPrefixInfo 항목 또는 NULL(목록에 더 이상 항목이 없는 경우)

otHistoryTrackerIterateRxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 RX 메시지 기록 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerMessageInfo 항목 또는 NULL(목록에 더 이상 항목이 없는 경우)

otHistoryTrackerIterateTxHistory에 연결됨

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 TX 메시지 기록 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerMessageInfo 항목 또는 NULL(목록에 더 이상 항목이 없는 경우)

otHistoryTrackerIterateUnicastAddressHistory

const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

이 함수는 유니캐스트 주소 기록 목록의 항목을 반복합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스 포인터.
[in,out] aIterator
반복기에 대한 포인터입니다. 초기화되지 않거나 동작이 정의되지 않아야 합니다(MUST).
[out] aEntryAge
항목의 연령을 출력하기 위한 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 경과 시간은 항목이 기록된 시점부터 aIterator 초기화 시간까지 경과된 시간 (밀리초)입니다. 최대 연령보다 오래된 항목은 OT_HISTORY_TRACKER_MAX_AGE로 설정됩니다.
반환
otHistoryTrackerUnicastAddressInfo 항목 포인터 또는 목록에 항목이 더 이상 없는 경우 NULL

매크로

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

항목 연령의 문자열 표현에 권장되는 크기입니다.

OT_HISTORY_TRACKER_MAX_AGE세

 OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)

이 상수는 최대 경과 기간을 49일 (밀리초)으로 지정합니다.

최대 연령보다 오래된 항목은 이 값을 연령으로 부여합니다.

리소스

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