기록 추적기
RX 및 TX 메시지 또는 네트워크 정보 변경과 같은 다양한 이벤트의 기록을 기록합니다.
요약
추적된 모든 항목에는 타임스탬프가 표시됩니다.
이 모듈의 함수는 OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE
가 사용 설정된 경우에 사용할 수 있습니다.
Typedef |
|
---|---|
otHistoryTrackerExternalRouteInfo
|
typedef 이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다. |
otHistoryTrackerIterator
|
typedefstruct otHistoryTrackerIterator
이 유형은 기록 목록을 반복하는 반복자를 나타냅니다. |
otHistoryTrackerMessageInfo
|
typedefstruct otHistoryTrackerMessageInfo
이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다. |
otHistoryTrackerMulticastAddressInfo
|
typedef 이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다. |
otHistoryTrackerNeighborInfo
|
typedefstruct otHistoryTrackerNeighborInfo
이 구조는 이웃 정보를 나타냅니다. |
otHistoryTrackerNetworkInfo
|
typedefstruct otHistoryTrackerNetworkInfo
이 구조는 스레드 네트워크 정보를 나타냅니다. |
otHistoryTrackerOnMeshPrefixInfo
|
typedef 이 구조는 Network Data on Mesh 프리픽스 정보를 나타냅니다. |
otHistoryTrackerRouterInfo
|
typedefstruct otHistoryTrackerRouterInfo
이 구조는 라우터 테이블 항목 이벤트를 나타냅니다. |
otHistoryTrackerUnicastAddressInfo
|
typedef 이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다. |
구조체 |
|
---|---|
otHistoryTrackerExternalRouteInfo |
이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다. |
otHistoryTrackerIterator |
이 유형은 기록 목록을 반복하는 반복자를 나타냅니다. |
otHistoryTracker메시지 정보 |
이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다. |
otHistoryTracker멀티캐스트주소정보 |
이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다. |
otHistoryTrackerNeighborInfo |
이 구조는 이웃 정보를 나타냅니다. |
otHistoryTrackerNetworkInfo |
이 구조는 스레드 네트워크 정보를 나타냅니다. |
otHistoryTrackerOnMeshPrefixInfo |
이 구조는 Network Data on Mesh 프리픽스 정보를 나타냅니다. |
otHistoryTrackerRouterInfo |
이 구조는 라우터 테이블 항목 이벤트를 나타냅니다. |
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
|
보통 우선순위 수준입니다. |
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
|
이웃을 복원 중입니다 (자녀에게만 해당). |
otHistoryTrackerNetDataEvent
otHistoryTrackerNetDataEvent
이 열거형은 네트워크 데이터 항목의 이벤트 (예: 항목 추가 또는 삭제)를 정의합니다.
속성 | |
---|---|
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED
|
네트워크 데이터 항목이 추가됩니다. |
OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED
|
네트워크 데이터 항목이 삭제되었습니다. |
otHistoryTrackerRouterEvent
otHistoryTrackerRouterEvent
이 열거형은 라우터 정보 (예:
라우터 추가, 삭제 또는 변경 여부).
속성 | |
---|---|
OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED
|
라우터가 추가되었습니다 (라우터 ID 할당됨). |
OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED
|
라우터 입력 경로 비용이 변경되었습니다 (이전과 같은 다음 홉). |
OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED
|
라우터 항목의 다음 홉 및 비용이 변경되었습니다. |
OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED
|
라우터 항목이 삭제되었습니다 (라우터 ID 해제됨). |
Typedef
otHistoryTracker 외부 경로 정보
struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo
이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다.
otHistoryTrackerIterator
struct otHistoryTrackerIterator otHistoryTrackerIterator
이 유형은 기록 목록을 반복하는 반복자를 나타냅니다.
이 유형의 필드는 불투명 (OpenThread 코어에서 사용하도록 의도됨)이므로 호출자가 액세스하거나 이를 사용해서는 안 됩니다.
반복자를 사용하기 전에 otHistoryTrackerInitIterator()
를 사용하여 초기화해야 합니다(MUST).
otHistoryTrackerMessageInfo
struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo
이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다.
이 구조체의 일부 필드는 RX 메시지 또는 TX 메시지에만 적용할 수 있습니다(예: mAveRxRss
는 수신된 메시지를 구성하는 모든 프래그먼트 프레임의 평균 RSS이며 RX 메시지에만 적용할 수 있습니다.
otHistoryTracker 멀티캐스트 주소 정보
struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo
이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다.
otHistoryTrackerNeighborInfo
struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo
이 구조는 이웃 정보를 나타냅니다.
otHistoryTrackerNetworkInfo
struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo
이 구조는 스레드 네트워크 정보를 나타냅니다.
otHistoryTrackerOnMeshPrefixInfo
struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo
이 구조는 Network Data on Mesh 프리픽스 정보를 나타냅니다.
otHistoryTrackerRouterInfo
struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo
이 구조는 라우터 테이블 항목 이벤트를 나타냅니다.
otHistoryTrackerUnicastAddressInfo
struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo
이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다.
함수
otHistoryTrackerEntryAgeToString
void otHistoryTrackerEntryAgeToString( uint32_t aEntryAge, char *aBuffer, uint16_t aSize )
이 함수는 지정된 항목 연수를 사람이 읽을 수 있는 문자열로 변환합니다.
항목 연령 문자열은 시간, 분, 초 및 밀리초 (1일 미만인 경우) 또는 '의 경우 '
결과 문자열이 aBuffer
에 맞지 않는 경우 (aSize
문자 내에서) 문자열이 잘리지만 출력된 문자열은 항상 null로 끝납니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
otHistoryTrackerInitIterator
void otHistoryTrackerInitIterator( otHistoryTrackerIterator *aIterator )
이 함수는 otHistoryTrackerIterator
를 초기화합니다.
반복자는 사용되기 전에 초기화해야 합니다(MUST).
반복자를 목록의 시작 부분부터 다시 초기화할 수 있습니다.
목록의 항목을 반복할 때 항목 기간이 일관되도록 하기 위해, 이터레이터가 초기화된 시간을 기준으로 나이가 지정됩니다. 즉, 항목 기간은 이벤트 (항목이 기록된 경우)부터 반복기 초기화 시간까지의 기간 (밀리초)으로 제공됩니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
otHistoryTrackerIterateExternalRouteHistory
const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 네트워크 데이터 외부 경로 항목 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerExternalRouteInfo 항목 또는 목록에 더 이상 항목이 없으면 NULL . |
otHistoryTrackerIterate멀티캐스트주소기록
const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 멀티캐스트 주소 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerMulticastAddressInfo 항목 포인터 또는 목록에 항목이 더 이상 없으면 NULL |
otHistoryTrackerIterateNeighborHistory
const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 인접 항목 기록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerNeighborInfo 항목 또는 목록에 더 이상 항목이 없으면 NULL . |
otHistoryTrackerIterateNetInfoHistory
const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 네트워크 정보 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerNetworkInfo 항목 포인터 또는 목록에 항목이 더 이상 없으면 NULL |
otHistoryTrackerIterateOnMeshPrefixHistory
const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 메시 데이터의 네트워크 데이터 항목 입력 내역 목록에 있는 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerOnMeshPrefixInfo 항목 또는 목록에 더 이상 항목이 없으면 NULL . |
otHistoryTrackerIterateRouterHistory
const otHistoryTrackerRouterInfo * otHistoryTrackerIterateRouterHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 라우터 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerRouterInfo 항목 또는 목록에 더 이상 항목이 없으면 NULL . |
otHistoryTrackerIterateRxHistory
const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 RX 메시지 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerMessageInfo 항목 또는 목록에 더 이상 항목이 없으면 NULL . |
otHistoryTrackerIterateTxHistory
const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 TX 메시지 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerMessageInfo 항목 또는 목록에 더 이상 항목이 없으면 NULL . |
otHistoryTrackerIterateUnicastAddressHistory
const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
이 함수는 유니캐스트 주소 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerUnicastAddressInfo 항목 포인터 또는 목록에 항목이 더 이상 없으면 NULL |
매크로
OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE세
OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21
항목 연령의 문자열 표현에 권장되는 크기입니다.
OT_HISTORY_TRACKER_INFINITE_PATH_COST
OT_HISTORY_TRACKER_INFINITE_PATH_COST 0
무한 경로 비용 - otHistoryTrackerRouterInfo
에서 사용됩니다.
OT_HISTORY_TRACKER_MAX_AGE세
OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)
이 상수는 항목의 최대 기간을 49일 (밀리초 단위)로 지정합니다.
최대 연령보다 오래된 항목은 이 값이 연령으로 지정됩니다.
OT_HISTORY_TRACKER_NO_NEXT_HOP
OT_HISTORY_TRACKER_NO_NEXT_HOP 63
다음 홉 없음 - otHistoryTrackerRouterInfo
의 mNextHop
.
자료
OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 보거나 문서에 참여하려면 리소스를 참고하세요.