เครื่องมือติดตามประวัติ

บันทึกประวัติของเหตุการณ์ต่างๆ เช่น ข้อความ RX และ TX หรือการเปลี่ยนแปลงข้อมูลเครือข่าย

สรุป

รายการที่ติดตามทั้งหมดจะมีการประทับเวลา

ฟังก์ชันในโมดูลนี้จะพร้อมใช้งานเมื่อเปิดใช้ OPENTHREAD_CONFIG_HISTORY_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
กำหนดเหตุการณ์สำหรับการป้อนข้อมูลเครือข่าย (เช่น มีการเพิ่มหรือนำรายการออก)
otHistoryTrackerRouterEvent{
  OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED = 2,
  OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED = 3
}
enum
กำหนดเหตุการณ์ในข้อมูลเราเตอร์ (เช่น

Typedef

otHistoryTrackerExternalRouteInfo typedef
แสดงข้อมูลเส้นทางภายนอกของข้อมูลเครือข่าย
otHistoryTrackerIterator typedef
แสดงถึงการทำซ้ำเพื่อทำซ้ำผ่านรายการประวัติ
otHistoryTrackerMessageInfo typedef
แสดงข้อมูลข้อความ RX/TX IPv6
otHistoryTrackerMulticastAddressInfo typedef
แสดงข้อมูลที่อยู่ IPv6 แบบมัลติแคสต์
otHistoryTrackerNeighborInfo typedef
แสดงข้อมูลเพื่อนบ้าน
otHistoryTrackerNetworkInfo typedef
แสดงข้อมูลเครือข่ายเทรด
otHistoryTrackerOnMeshPrefixInfo typedef
แสดงข้อมูลเครือข่ายในข้อมูลคำนำหน้าที่ทำงานร่วมกัน
otHistoryTrackerRouterInfo 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)
ทำซ้ำรายการในข้อมูลเครือข่ายในรายการประวัติรายการคำนำหน้า Mesh
otHistoryTrackerIterateRouterHistory(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)
ทำซ้ำรายการในประวัติที่อยู่ Unicast

โครงสร้าง

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

เพิ่มเราเตอร์แล้ว (จัดสรรรหัสเราเตอร์แล้ว)

OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED

เปลี่ยนค่าใช้จ่ายของเส้นทางเข้าถึงเราเตอร์แล้ว (ฮอพถัดไปเหมือนก่อนหน้านี้)

OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED

เปลี่ยนฮอพถัดไปและค่าใช้จ่ายของเราเตอร์แล้ว

OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED

รายการเราเตอร์ถูกนำออก (เผยแพร่รหัสเราเตอร์แล้ว)

Typedef

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

แสดงข้อมูลเส้นทางภายนอกของข้อมูลเครือข่าย

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

แสดงถึงการทำซ้ำเพื่อทำซ้ำผ่านรายการประวัติ

ช่องประเภทนี้จะทึบแสง (มีไว้สำหรับใช้โดย OpenThread Core) ผู้โทรจึงไม่ควรเข้าถึง/ใช้งานฟิลด์ดังกล่าว

ต้องเริ่มต้นโดยใช้ otHistoryTrackerInitIterator() ก่อนใช้ตัวซ้ำ

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

แสดงข้อมูลข้อความ RX/TX IPv6

ช่องบางช่องในโครงสร้างนี้จะใช้ได้กับข้อความ RX หรือข้อความ TX เท่านั้น เช่น mAveRxRss คือ RSS เฉลี่ยของเฟรม Fragment ทั้งหมดที่เป็นข้อความที่ได้รับ และใช้ได้กับข้อความ 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 วัน) หรือ "

วัน ::." (หากนานกว่า 1 วัน)

หากสตริงผลลัพธ์ไม่พอดีกับ aBuffer (ภายใน aSize อักขระ) ระบบจะตัดสตริงให้สั้นลง แต่สตริงที่ส่งออกจะเป็นค่าว่างเสมอ

รายละเอียด
พารามิเตอร์
[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
ตัวชี้ไปยังตัววนซ้ำ ต้องเริ่มต้น หรือไม่ได้ระบุลักษณะการทำงาน
[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
ตัวชี้ไปยังตัววนซ้ำ ต้องเริ่มต้น หรือไม่ได้ระบุลักษณะการทำงาน
[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
ตัวชี้ไปยังตัววนซ้ำ ต้องเริ่มต้น หรือไม่ได้ระบุลักษณะการทำงาน
[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 หากไม่มีรายการอื่นในรายการ

otHistoryTrackerIterateOnMeshPrefixHistory

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

ทำซ้ำรายการในข้อมูลเครือข่ายในรายการประวัติรายการคำนำหน้า Mesh

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in,out] aIterator
ตัวชี้ไปยังตัววนซ้ำ ต้องเริ่มต้น หรือไม่ได้ระบุลักษณะการทำงาน
[out] aEntryAge
ตัวชี้ไปยังตัวแปรเพื่อแสดงอายุของรายการ ต้องไม่ใช่ NULL อายุจะระบุเป็นระยะเวลา (เป็นมิลลิวินาที) นับตั้งแต่เวลาที่บันทึกรายการจนถึงเวลาเริ่มต้น aIterator โดยจะตั้งค่าเป็น OT_HISTORY_TRACKER_MAX_AGE สำหรับรายการที่เก่ากว่าอายุสูงสุด
การส่งคืน
รายการ otHistoryTrackerOnMeshPrefixInfo หรือ NULL หากไม่มีรายการใดในรายการอีก

otHistoryTrackerIterateRouterHistory

const otHistoryTrackerRouterInfo * otHistoryTrackerIterateRouterHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

ทำซ้ำข้อมูลในรายการประวัติเราเตอร์

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in,out] aIterator
ตัวชี้ไปยังตัววนซ้ำ ต้องเริ่มต้น หรือไม่ได้ระบุลักษณะการทำงาน
[out] aEntryAge
ตัวชี้ไปยังตัวแปรเพื่อแสดงอายุของรายการ ต้องไม่ใช่ NULL อายุจะระบุเป็นระยะเวลา (เป็นมิลลิวินาที) นับตั้งแต่เวลาที่บันทึกรายการจนถึงเวลาเริ่มต้น aIterator โดยจะตั้งค่าเป็น OT_HISTORY_TRACKER_MAX_AGE สำหรับรายการที่เก่ากว่าอายุสูงสุด
การส่งคืน
รายการ otHistoryTrackerRouterInfo หรือ NULL หากไม่มีรายการใดในรายการอีก

otHistoryTrackerIterateRxHistory

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 หากไม่มีรายการใดในรายการอีก

otHistoryTrackerIterateTxHistory

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 หากไม่มีรายการใดในรายการอีก

otHistoryTrackerIterateUnicastAddressHistory

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

ทำซ้ำรายการในประวัติที่อยู่ Unicast

รายละเอียด
พารามิเตอร์
[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_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

ไม่มีฮอพถัดไป - สำหรับ mNextHop ใน otHistoryTrackerRouterInfo

แหล่งข้อมูล

หัวข้ออ้างอิง API ของ OpenThread จะมาจากซอร์สโค้ดซึ่งพร้อมใช้งานใน GitHub ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล