การซิงค์เวลาของเครือข่าย

โมดูลนี้มีฟังก์ชันที่ควบคุมบริการซิงค์ข้อมูลเวลาของเครือข่าย

สรุป

การแจกแจง

otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
}
enum
การแจกแจงนี้แสดงถึงสถานะการซิงค์เวลาของ OpenThread

ประเภทคําจํากัดความ

otNetworkTimeStatus Typedef
การแจกแจงนี้แสดงถึงสถานะการซิงค์เวลาของ OpenThread
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) Typedef
void(*
ระบบจะเรียกใช้ตัวชี้ฟังก์ชันนี้เมื่อมีการซิงค์เวลาของเครือข่ายหรือการเปลี่ยนแปลงสถานะ

ฟังก์ชัน

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
ดูเวลาเครือข่ายชุดข้อความ
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
ดูระยะเวลาการซิงค์ข้อมูล
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
รับเกณฑ์ความถูกต้องของ XTAL การซิงค์เวลาสําหรับเราเตอร์
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
กําหนดระยะเวลาการซิงค์ข้อมูล
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
ตั้งค่าเกณฑ์ความถูกต้องของ XTAL ของการซิงค์เวลาสําหรับอุปกรณ์ที่รองรับเราเตอร์
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
ตั้งค่าการเรียกกลับเมื่อมีการซิงค์เวลาของเครือข่ายหรือการเปลี่ยนแปลงสถานะ

การแจกแจง

สถานะเครือข่ายเวลา

 otNetworkTimeStatus

การแจกแจงนี้แสดงถึงสถานะการซิงค์เวลาของ OpenThread

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

อุปกรณ์ไม่ได้รับการซิงค์เวลานานกว่า 2 ช่วงเวลา

OT_NETWORK_TIME_SYNCHRONIZED

เวลาของเครือข่ายอุปกรณ์จะซิงค์ข้อมูลกัน

OT_NETWORK_TIME_UNSYNCHRONIZED

อุปกรณ์ยังไม่ได้เชื่อมต่อกับเครือข่าย

ประเภทคําจํากัดความ

สถานะเครือข่ายเวลา

enum otNetworkTimeStatus otNetworkTimeStatus

การแจกแจงนี้แสดงถึงสถานะการซิงค์เวลาของ OpenThread

OTNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

ระบบจะเรียกใช้ตัวชี้ฟังก์ชันนี้เมื่อมีการซิงค์เวลาของเครือข่ายหรือการเปลี่ยนแปลงสถานะ

ฟังก์ชัน

เวลาเครือข่ายการรับ

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

ดูเวลาเครือข่ายชุดข้อความ

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
[in,out] aNetworkTime
เวลาเครือข่ายเทรดในหน่วยไมโครวินาที
การคืนสินค้า
สถานะการซิงค์เวลา

เวลาเครือข่ายการรับการซิงค์

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

ดูระยะเวลาการซิงค์ข้อมูล

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
การคืนสินค้า
ระยะเวลาการซิงค์เวลา

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

รับเกณฑ์ความถูกต้องของ XTAL การซิงค์เวลาสําหรับเราเตอร์

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
การคืนสินค้า
เกณฑ์ความถูกต้องของ XTAL สําหรับเราเตอร์ใน PPM

OTNetworkTimeSetPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

กําหนดระยะเวลาการซิงค์ข้อมูล

เรียกใช้ฟังก์ชันนี้ได้เฉพาะเมื่อปิดใช้โปรโตคอลชุดข้อความเท่านั้น

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
[in] aTimeSyncPeriod
ระยะเวลาซิงค์ข้อมูลเป็นหน่วยวินาที
แสดงผลค่า
OT_ERROR_NONE
กําหนดระยะเวลาการซิงค์เรียบร้อยแล้ว
OT_ERROR_INVALID_STATE
เปิดใช้โปรโตคอลชุดข้อความแล้ว

OTNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

ตั้งค่าเกณฑ์ความถูกต้องของ XTAL ของการซิงค์เวลาสําหรับอุปกรณ์ที่รองรับเราเตอร์

เรียกใช้ฟังก์ชันนี้ได้เฉพาะเมื่อปิดใช้โปรโตคอลชุดข้อความเท่านั้น

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
[in] aXTALThreshold
เกณฑ์ความถูกต้องของ XTAL สําหรับเราเตอร์ใน PPM
แสดงผลค่า
OT_ERROR_NONE
กําหนดระยะเวลาการซิงค์เรียบร้อยแล้ว
OT_ERROR_INVALID_STATE
เปิดใช้โปรโตคอลชุดข้อความแล้ว

OTNetworkTimeSyncSetSetbackback

void otNetworkTimeSyncSetCallback(
  otInstance *aInstance,
  otNetworkTimeSyncCallbackFn aCallbackFn,
  void *aCallbackContext
)

ตั้งค่าการเรียกกลับเมื่อมีการซิงค์เวลาของเครือข่ายหรือการเปลี่ยนแปลงสถานะ

ระบบจะเรียกใช้โค้ดเรียกกลับนี้เฉพาะเมื่อออฟเซ็ตเวลาของเครือข่ายข้ามโดย OPENNAMES_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US หรือเมื่อสถานะเปลี่ยนแปลง

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
[in] aCallbackFn
ฟังก์ชันเรียกกลับที่จะเรียกใช้
[in] aCallbackContext
บริบทที่จะส่งไปยังฟังก์ชันเรียกกลับเมื่อเรียกใช้

มาโคร

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

0 ถือเป็นลําดับการซิงค์เวลาที่ไม่ถูกต้อง

แหล่งข้อมูล

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