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

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

สรุป

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

ฟังก์ชันในโมดูลนี้จะพร้อมใช้งานเมื่อเปิดใช้ OPENTHREAD_CONFIG_HISTOR_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 (unicast หรือมัลติแคสต์) (เช่น มีการเพิ่มหรือนําที่อยู่ออก)
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
การแจงนับนี้จะระบุเหตุการณ์สําหรับข้อมูลเครือข่าย (เช่น มีการเพิ่มหรือนํารายการออก)

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

โครงสร้างนี้จะแสดงข้อมูลข้อความ IPv6 ใน RX/TX

otHistoryTrackerMulticastAddressInfo

โครงสร้างนี้แสดงถึงข้อมูลที่อยู่แบบมัลติแคสต์ IPv6

otHistoryTrackerNeighborInfo

โครงสร้างนี้จะแสดงข้อมูลในบริเวณใกล้เคียง

otHistoryTrackerNetworkInfo

โครงสร้างนี้แสดงถึงข้อมูลเครือข่ายชุดข้อความ

otHistoryTrackerOnMeshPrefixInfo

โครงสร้างนี้แสดงถึงข้อมูลเครือข่ายในข้อมูลคํานําหน้าของ Mesh

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

ระดับความสําคัญปกติ

ประวัติเหตุการณ์ otHistory

 otHistoryTrackerAddressEvent

การแจงค่านี้จะกําหนดเหตุการณ์สําหรับข้อมูลที่อยู่ IPv6 (unicast หรือมัลติแคสต์) (เช่น มีการเพิ่มหรือนําที่อยู่ออก)

พร็อพเพอร์ตี้
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

เพิ่มที่อยู่แล้ว

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

นําที่อยู่ออกแล้ว

เหตุการณ์ otHistoryTracker NeighborEvent

 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

กําลังคืนค่าใกล้เคียง (เกี่ยวข้องกับเด็กเท่านั้น)

เหตุการณ์ประวัติของ otHistoryNet

 otHistoryTrackerNetDataEvent

การแจงนับนี้จะระบุเหตุการณ์สําหรับข้อมูลเครือข่าย (เช่น มีการเพิ่มหรือนํารายการออก)

พร็อพเพอร์ตี้
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

เพิ่มข้อมูลเครือข่ายแล้ว

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

ลบข้อมูลเครือข่ายแล้ว

พิมพ์ดีด

ข้อมูลประวัติของ otHistoryTrackerExternal

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

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

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

ประเภทนี้ใช้ตัวจําลองทําซ้ําตามรายการประวัติ

ช่องในประเภทนี้จะทึบแสง (มีไว้เพื่อใช้แกน OpenOpen เท่านั้น) และผู้โทรจึงไม่ควรเข้าถึง/นําไปใช้

ก่อนใช้ตัวดําเนินการทําซ้ํา จะต้องเริ่มต้นโดยใช้ otHistoryTrackerInitIterator()

ข้อมูลประวัติของ otHistory

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

โครงสร้างนี้จะแสดงข้อมูลข้อความ IPv6 ใน RX/TX

บางช่องในโครงสร้างนี้ใช้ได้กับข้อความ RX หรือข้อความ TX เท่านั้น เช่น mAveRxRss คือ RSS เฉลี่ยของเฟรมส่วนย่อยทั้งหมดที่ประกอบกันเป็นข้อความที่ได้รับ และใช้ได้กับข้อความ RX เท่านั้น

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

โครงสร้างนี้แสดงถึงข้อมูลที่อยู่แบบมัลติแคสต์ IPv6

ข้อมูลประวัติของ otHistory

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

โครงสร้างนี้จะแสดงข้อมูลในบริเวณใกล้เคียง

ข้อมูลประวัติของ otHistory

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

โครงสร้างนี้แสดงถึงข้อมูลเครือข่ายชุดข้อความ

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

โครงสร้างนี้แสดงถึงข้อมูลเครือข่ายในข้อมูลคํานําหน้าของ Mesh

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

โครงสร้างนี้แสดงข้อมูลที่อยู่ IPv6 ที่ไม่ซ้ํากัน

ฟังก์ชัน

otHistoryTrackerEntry อายุถึงสตริง

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

ฟังก์ชันนี้จะแปลงอายุของรายการที่ระบุเป็นสตริงที่มนุษย์อ่านได้

สตริงอายุของรายการมีรูปแบบ "ดังนี้ดังนี้ของ Google Play" สําหรับชั่วโมง นาที วินาที และมิลลิวินาที (ถ้าน้อยกว่าหนึ่งวัน) หรือ "

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

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

รายละเอียด
พารามิเตอร์
[in] aEntryAge
อายุของรายการ (duration msec)
[out] aBuffer
ตัวชี้ไปยังอาร์เรย์อักขระเพื่อเอาต์พุตสตริง (ต้องไม่เป็น NULL)
[in] aSize
ขนาดของ aBuffer แนะนําให้ใช้ OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

ฟังก์ชันนี้จะเริ่มต้น otHistoryTrackerIterator

ต้องเริ่มต้นตัวทําซ้ําก่อนที่จะเริ่มใช้

ตัวทําซ้ําสามารถเริ่มต้นได้อีกครั้งตั้งแต่ต้น

เมื่อทําซ้ํารายการในรายการ เพื่อให้แน่ใจว่ารายการอายุเท่ากัน อายุจะสัมพันธ์กับเวลาที่ตัวดําเนินการเริ่มต้น นั่นคือ ระบุอายุรายการเป็นระยะเวลา (เป็นมิลลิวินาที) จากเหตุการณ์ (เมื่อรายการเป็น ) เป็นเวลาเริ่มต้นซ้ํา

รายละเอียด
พารามิเตอร์
[in] aIterator
ตัวชี้ไปยังตัวกําหนดเส้นทางเพื่อเริ่มต้น (ต้องไม่เป็นค่าว่าง)

otHistoryTrackerIterateExternalRouteHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

ฟังก์ชันนี้จะทําซ้ํารายการในรายการประวัติรายการเส้นทางของข้อมูลเครือข่ายภายนอก

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

otHistoryTrackerIterate ละแวกใกล้เคียง

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

ฟังก์ชันนี้จะทําซ้ํารายการในรายการประวัติการเข้าชมใกล้เคียง

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

otHistoryTrackerIterateRxHistory

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

ฟังก์ชันนี้จะทําซ้ําในรายการประวัติข้อความ RX

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in,out] aIterator
ตัวชี้ไปยังตัวทําซ้ํา ต้องเริ่มต้นหรือไม่มีการกําหนดลักษณะการทํางาน
[out] aEntryAge
ตัวชี้ไปยังตัวแปรเพื่อแสดงอายุของรายการ ต้องไม่เป็นค่าว่าง อายุจะแสดงเป็นระยะเวลา (เป็นมิลลิวินาที) นับตั้งแต่ตอนที่บันทึกรายการไปจนถึงเวลาเริ่มต้นของ 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
ตัวชี้ไปยังตัวแปรเพื่อแสดงอายุของรายการ ต้องไม่เป็นค่าว่าง อายุจะแสดงเป็นระยะเวลา (เป็นมิลลิวินาที) นับตั้งแต่ตอนที่บันทึกรายการไปจนถึงเวลาเริ่มต้นของ 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
ตัวชี้ไปยังตัวแปรเพื่อแสดงอายุของรายการ ต้องไม่เป็นค่าว่าง อายุจะแสดงเป็นระยะเวลา (เป็นมิลลิวินาที) นับตั้งแต่ตอนที่บันทึกรายการไปจนถึงเวลาเริ่มต้นของ 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)

ค่าคงที่นี้ระบุอายุสูงสุดสําหรับรายการต่างๆ ซึ่งก็คือ 49 วัน (หน่วยเป็นมิลลิวินาที)

อายุที่เก่ากว่าอายุสูงสุดจะให้ค่านี้เป็นอายุ

ทรัพยากร

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