기록 추적기
다양한 이벤트(예: RX 및 TX 메시지 또는 네트워크 정보 변경) 내역을 기록합니다.
요약
추적된 모든 항목에 타임스탬프가 지정됩니다.
이 모듈의 함수는 OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE
가 사용 설정된 경우 사용할 수 있습니다.
열거 |
|
---|---|
anonymous enum{
|
enumotHistoryTrackerMessageInfo 구조체에 사용되는 메시지 우선순위를 나타내는 상수입니다. |
otHistoryTrackerAddressEvent{
|
enum 이 열거는 IPv6 (유니캐스트 또는 멀티캐스트) 주소 정보 (주소 추가 또는 삭제 여부)에 대한 이벤트를 정의합니다. |
otHistoryTrackerNeighborEvent{
|
enum 이 열거는 주변 정보 (예: |
otHistoryTrackerNetDataEvent{
|
enum 이 열거는 네트워크 데이터 항목의 이벤트 (예: 항목 추가 또는 삭제)를 정의합니다. |
Typedef |
|
---|---|
otHistoryTrackerExternalRouteInfo
|
typedef 이 구조는 네트워크 데이터 외부 경로 정보를 나타냅니다. |
otHistoryTrackerIterator
|
typedefstruct otHistoryTrackerIterator
이 유형은 기록 목록을 반복할 반복기를 나타냅니다. |
otHistoryTrackerMessageInfo
|
typedefstruct otHistoryTrackerMessageInfo
이 구조는 RX/TX IPv6 메시지 정보를 나타냅니다. |
otHistoryTrackerMulticastAddressInfo
|
typedef 이 구조는 IPv6 멀티캐스트 주소 정보를 나타냅니다. |
otHistoryTrackerNeighborInfo
|
typedefstruct otHistoryTrackerNeighborInfo
이 구조는 인접 정보를 나타냅니다. |
otHistoryTrackerNetworkInfo
|
typedefstruct otHistoryTrackerNetworkInfo
이 구조는 스레드 네트워크 정보를 나타냅니다. |
otHistoryTrackerOnMeshPrefixInfo
|
typedef 이 구조는 메시 프리픽스 정보의 네트워크 데이터를 나타냅니다. |
otHistoryTrackerUnicastAddressInfo
|
typedef 이 구조는 유니캐스트 IPv6 주소 정보를 나타냅니다. |
구조체 |
|
---|---|
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 )
이 함수는 지정된 연령을 사람이 읽을 수 있는 문자열로 변환합니다.
항목 연령 문자열은 '
결과 문자열이 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 (목록에 더 이상 항목이 없는 경우) |
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_MAX_AGE세
OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)
이 상수는 최대 경과 기간을 49일 (밀리초)으로 지정합니다.
최대 연령보다 오래된 항목은 이 값을 연령으로 부여합니다.
리소스
OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 시작됩니다. 자세한 내용을 알아보거나 문서에 기여하려면 리소스를 참조하세요.