이 페이지는 Cloud Translation API를 통해 번역되었습니다.

기록 추적기

요약

열거
`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 }`	열거 에 사용되는 메시지 우선 순위를 나타내는 상수 `otHistoryTrackerMessageInfo` 구조체.
`otHistoryTrackerAddressEvent { OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0, OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1 }`	열거 이 열거는 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 }`	열거 이 열거는 이웃 정보(즉,

형식 정의
`otHistoryTrackerIterator`	형식 정의 `struct otHistoryTrackerIterator` 이 유형은 기록 목록을 반복하는 반복자를 나타냅니다.
`otHistoryTrackerMessageInfo`	형식 정의 `struct otHistoryTrackerMessageInfo` 이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다.
`otHistoryTrackerMulticastAddressInfo`	형식 정의 `struct otHistoryTrackerMulticastAddressInfo` 이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다.
`otHistoryTrackerNeighborInfo`	형식 정의 `struct otHistoryTrackerNeighborInfo` 이 구조는 이웃 정보를 나타냅니다.
`otHistoryTrackerNetworkInfo`	형식 정의 `struct otHistoryTrackerNetworkInfo` 이 구조는 스레드 네트워크 정보를 나타냅니다.
`otHistoryTrackerUnicastAddressInfo`	형식 정의 `struct otHistoryTrackerUnicastAddressInfo` 이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다.

기능
`otHistoryTrackerEntryAgeToString (uint32_t aEntryAge, char *aBuffer, uint16_t aSize)`	`void` 이 함수는 주어진 진입 연령을 사람이 읽을 수 있는 문자열로 변환합니다.
`otHistoryTrackerInitIterator ( otHistoryTrackerIterator *aIterator)`	`void` 이 함수는 초기화 `otHistoryTrackerIterator` .
`otHistoryTrackerIterateMulticastAddressHistory ( otInstance aInstance, otHistoryTrackerIterator aIterator, uint32_t *aEntryAge)`	`const otHistoryTrackerMulticastAddressInfo *` 이 함수는 멀티캐스트 주소 기록 목록의 항목을 반복합니다.
`otHistoryTrackerIterateNeighborHistory ( otInstance aInstance, otHistoryTrackerIterator aIterator, uint32_t *aEntryAge)`	`const otHistoryTrackerNeighborInfo *` 이 함수는 인접 기록 목록의 항목을 반복합니다.
`otHistoryTrackerIterateNetInfoHistory ( otInstance aInstance, otHistoryTrackerIterator aIterator, uint32_t *aEntryAge)`	`const otHistoryTrackerNetworkInfo *` 이 함수는 네트워크 정보 기록 목록의 항목을 반복합니다.
`otHistoryTrackerIterateRxHistory ( otInstance aInstance, otHistoryTrackerIterator aIterator, uint32_t *aEntryAge)`	`const otHistoryTrackerMessageInfo *` 이 함수는 RX 메시지 기록 목록의 항목을 반복합니다.
`otHistoryTrackerIterateTxHistory ( otInstance aInstance, otHistoryTrackerIterator aIterator, uint32_t *aEntryAge)`	`const otHistoryTrackerMessageInfo *` 이 함수는 TX 메시지 기록 목록의 항목을 반복합니다.
`otHistoryTrackerIterateUnicastAddressHistory ( otInstance aInstance, otHistoryTrackerIterator aIterator, uint32_t *aEntryAge)`	`const otHistoryTrackerUnicastAddressInfo *` 이 함수는 유니캐스트 주소 기록 목록의 항목을 반복합니다.

구조체
otHistoryTracker반복자	이 유형은 기록 목록을 반복하는 반복자를 나타냅니다.
otHistoryTrackerMessageInfo	이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다.
otHistoryTracker멀티캐스트주소정보	이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다.
otHistoryTrackerNeighborInfo	이 구조는 이웃 정보를 나타냅니다.
otHistoryTrackerNetworkInfo	이 구조는 스레드 네트워크 정보를 나타냅니다.
otHistoryTrackerUnicastAddressInfo	이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다.

열거

익명의 열거형

 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`	일반 우선 순위 수준.

otHistoryTrackerAddressEvent

 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`	이웃이 복원 중입니다(어린이만 해당).

형식 정의

otHistoryTracker반복자

struct otHistoryTrackerIterator otHistoryTrackerIterator

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

이 유형의 필드는 불투명하므로(OpenThread 코어에서 사용하도록 의도됨) 호출자가 액세스/사용해서는 안 됩니다.

반복자를 사용하기 전에, 그것을 사용하여 초기화되어야한다 otHistoryTrackerInitIterator() ,

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

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

이 구조체의 필드 중 일부는 예를 들면 RX 메시지 또는 단지 TX 메시지에 적용 할 수있는, mAveRxRss 수신 된 메시지를 형성하고, 수신 메시지에만 적용 할 수있는 모든 조각 프레임의 평균 RSS입니다.

otHistoryTracker멀티캐스트주소정보

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

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

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

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

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

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

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

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

기능

otHistoryTrackerEntryAgeToString

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

이 함수는 주어진 진입 연령을 사람이 읽을 수 있는 문자열로 변환합니다.

항목 연령 문자열은 " : : . " 시, 분, 초 및 밀리초(하루 미만인 경우) 또는 "

날 : : . "(하루 이상인 경우).

결과 문자열에 맞지 않는 경우 aBuffer (자사 내에서 aSize 문자) 문자열이 잘립니다하지만 출력 된 문자열은 항상 널 종료입니다됩니다.

세부

매개변수

`[in] aEntryAge`	진입 연령(밀리초 단위의 지속 시간)입니다.
`[out] aBuffer`	문자열을 출력할 char 배열에 대한 포인터입니다(NULL이 아니어야 함).
`[in] aSize`	의 크기 `aBuffer` . 사용하는 것이 좋습니다 `OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE` .

otHistoryTrackerIniterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

이 함수는 초기화 otHistoryTrackerIterator .

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

반복자는 목록의 처음부터 시작하도록 다시 초기화될 수 있습니다.

목록의 항목을 반복할 때 항목 연령이 일관되도록 하기 위해 반복자가 초기화된 시간을 기준으로 연령이 지정됩니다. 즉, 항목 연령은 이벤트(항목이 기록됨) 반복자 초기화 시간.

세부

매개변수

[in] aIterator

초기화할 반복기에 대한 포인터입니다(NULL이 아니어야 함).

otHistoryTracker반복MulticastAddressHistory

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

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

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in,out] aIterator`	반복자에 대한 포인터입니다. 초기화해야 하거나 동작이 정의되지 않습니다.
`[out] aEntryAge`	항목의 나이를 출력할 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 나이는 항목에 기록 된 때부터 (밀리 초) 기간으로 제공됩니다 `aIterator` 초기화 시간. 그것은으로 설정되어 `OT_HISTORY_TRACKER_MAX_AGE` 최대 나이보다 오래된 항목을.

보고

포인터 otHistoryTrackerMulticastAddressInfo 항목 또는 NULL 목록에 더 이상 항목이있는 경우.

otHistoryTrackerNeighborHistory 반복

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

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

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in,out] aIterator`	반복자에 대한 포인터입니다. 초기화해야 합니다. 그렇지 않으면 동작이 정의되지 않습니다.
`[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`	반복자에 대한 포인터입니다. 초기화해야 합니다. 그렇지 않으면 동작이 정의되지 않습니다.
`[out] aEntryAge`	항목의 나이를 출력할 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 나이는 항목에 기록 된 때부터 (밀리 초) 기간으로 제공됩니다 `aIterator` 초기화 시간. 그것은으로 설정되어 `OT_HISTORY_TRACKER_MAX_AGE` 최대 나이보다 오래된 항목을.

보고

포인터 otHistoryTrackerNetworkInfo 항목 또는 NULL 목록에 더 이상 항목이있는 경우.

otHistoryTracker반복RxHistory

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

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

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in,out] aIterator`	반복자에 대한 포인터입니다. 초기화해야 합니다. 그렇지 않으면 동작이 정의되지 않습니다.
`[out] aEntryAge`	항목의 나이를 출력할 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 나이는 항목에 기록 된 때부터 (밀리 초) 기간으로 제공됩니다 `aIterator` 초기화 시간. 그것은으로 설정되어 `OT_HISTORY_TRACKER_MAX_AGE` 최대 나이보다 오래된 항목을.

보고

otHistoryTrackerMessageInfo 항목 또는 NULL 목록에 더 이상 항목이있는 경우.

otHistoryTrackerTxHistory 반복

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

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

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in,out] aIterator`	반복자에 대한 포인터입니다. 초기화해야 하거나 동작이 정의되지 않습니다.
`[out] aEntryAge`	항목의 나이를 출력할 변수에 대한 포인터입니다. NULL이 아니어야 합니다. 나이는 항목에 기록 된 때부터 (밀리 초) 기간으로 제공됩니다 `aIterator` 초기화 시간. 그것은으로 설정되어 `OT_HISTORY_TRACKER_MAX_AGE` 최대 나이보다 오래된 항목을.

보고

otHistoryTrackerMessageInfo 항목 또는 NULL 목록에 더 이상 항목이있는 경우.

otHistoryTrackerUnicastAddressHistory 반복

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

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

세부

매개변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in,out] aIterator`	반복자에 대한 포인터입니다. 초기화해야 합니다. 그렇지 않으면 동작이 정의되지 않습니다.
`[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)

이 헤더는 History Tracker용 공개 API를 정의합니다.

히스토리 트래커 모듈은 스레드 네트워크가 작동할 때 다양한 이벤트(예: RX 및 TX 메시지 또는 네트워크 정보 변경 등)의 히스토리를 기록합니다. 추적된 모든 항목에는 타임스탬프가 찍혀 있습니다.

때이 모듈의 기능을 사용할 수 있습니다 OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE 활성화됩니다. 이 상수는 49일(밀리초)인 항목의 최대 기간을 지정합니다.

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