기록 트래커
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 메시 프리픽스 정보의 네트워크 데이터를 나타냅니다. |
otHistoryTrackerRouterInfo
|
typedefstruct otHistoryTrackerRouterInfo
라우터 테이블 항목 이벤트를 나타냅니다. |
otHistoryTrackerUnicastAddressInfo
|
typedef 유니캐스트 IPv6 주소 정보를 나타냅니다. |
구조체 |
|
---|---|
otHistoryTrackerExternalRouteInfo |
네트워크 데이터 외부 경로 정보를 나타냅니다. |
otHistoryTrackerIterator |
기록 목록을 반복할 반복기를 나타냅니다. |
otHistoryTrackerMessageInfo |
RX/TX IPv6 메시지 정보를 나타냅니다. |
otHistoryTrackerMulticastAddressInfo |
IPv6 멀티캐스트 주소 정보를 나타냅니다. |
otHistoryTrackerNeighborInfo |
인접 정보를 나타냅니다. |
otHistoryTrackerNetworkInfo |
스레드 네트워크 정보를 나타냅니다. |
otHistoryTrackerOnMeshPrefixInfo |
메시 프리픽스 정보의 네트워크 데이터를 나타냅니다. |
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
otHistoryTrackerExternalRouteInfo
struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo
네트워크 데이터 외부 경로 정보를 나타냅니다.
otHistoryTrackerIterator
struct otHistoryTrackerIterator otHistoryTrackerIterator
기록 목록을 반복할 반복기를 나타냅니다.
이 유형의 필드는 불투명이므로 (OpenThread 코어에서 사용하도록 되어 있음) 호출자가 액세스하거나 사용하면 안 됩니다.
반복자를 사용하려면 먼저 otHistoryTrackerInitIterator()
를 사용하여 초기화해야 합니다(MUST).
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
스레드 네트워크 정보를 나타냅니다.
otHistoryTrackerOnMeshPrefixInfo
struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo
메시 프리픽스 정보의 네트워크 데이터를 나타냅니다.
otHistoryTrackerRouterInfo
struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo
라우터 테이블 항목 이벤트를 나타냅니다.
otHistoryTrackerUnicastAddressInfo
struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo
유니캐스트 IPv6 주소 정보를 나타냅니다.
함수
otHistoryTrackerEntryAgeToString
void otHistoryTrackerEntryAgeToString( uint32_t aEntryAge, char *aBuffer, uint16_t aSize )
지정된 항목 연령을 사람이 읽을 수 있는 문자열로 변환합니다.
입력 기간 문자열은 시간, 분, 초, 밀리초 (1일 미만인 경우)의 경우 '
결과 문자열이 aSize
문자 내의 aBuffer
에 맞지 않는 경우 문자열이 잘리지만 출력된 문자열은 항상 null로 끝납니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
otHistoryTrackerInitIterator
void otHistoryTrackerInitIterator( otHistoryTrackerIterator *aIterator )
otHistoryTrackerIterator
를 초기화합니다.
반복자는 사용 전에 초기화되어야 합니다.
반복자를 다시 초기화하여 목록의 시작부터 시작할 수 있습니다.
목록의 항목을 반복할 때 항목 유지 기간이 일관되도록 반복자가 초기화된 시간을 기준으로 기간이 제공됩니다. 즉, 항목 기간이 이벤트 (항목이 기록된 경우)부터 반복기 초기화 시간까지의 기간 (밀리초)으로 제공됩니다.
세부정보 | |||
---|---|---|---|
매개변수 |
|
otHistoryTrackerIterateExternalRouteHistory
const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory( otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge )
네트워크 데이터 외부 경로 항목 기록 목록의 항목을 반복합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
||||||
반환 |
otHistoryTrackerExternalRouteInfo 항목 또는 목록에 더 이상 항목이 없는 경우 NULL 입니다. |
otHistoryTrackerIterateMulticastAddressHistory
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에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.