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

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

สรุป

enumerations
`otNetworkTimeStatus { OT_NETWORK_TIME_UNSYNCHRONIZED = -1, OT_NETWORK_TIME_RESYNC_NEEDED = 0, OT_NETWORK_TIME_SYNCHRONIZED = 1 }`	enum การแจงนับนี้แสดงสถานะการซิงโครไนส์เวลา OpenThread

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

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

enumerations

otNetworkTimeStatus

 otNetworkTimeStatus

การแจงนับนี้แสดงสถานะการซิงโครไนส์เวลา OpenThread

คุณสมบัติ
`OT_NETWORK_TIME_RESYNC_NEEDED`	อุปกรณ์ไม่ได้รับการซิงค์เวลาเป็นเวลามากกว่าสองช่วงเวลา
`OT_NETWORK_TIME_SYNCHRONIZED`	เวลาเครือข่ายของอุปกรณ์ถูกซิงโครไนซ์
`OT_NETWORK_TIME_UNSYNCHRONIZED`	อุปกรณ์ไม่ได้เชื่อมต่อกับเครือข่าย

typedefs

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

การแจงนับนี้แสดงสถานะการซิงโครไนส์เวลา OpenThread

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

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

ฟังก์ชั่น

otNetworkTimeGet

 otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

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

รายละเอียด

พารามิเตอร์

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

ผลตอบแทน

สถานะการซิงโครไนซ์เวลา

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

รับช่วงเวลาการซิงโครไนซ์

รายละเอียด

พารามิเตอร์

[in] aInstance

โครงสร้างอินสแตนซ์ OpenThread

ผลตอบแทน

ระยะเวลาการประสานเวลา

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

รับขีดจำกัดความแม่นยำของการซิงโครไนซ์เวลา XTAL สำหรับเราเตอร์

รายละเอียด

พารามิเตอร์

[in] aInstance

โครงสร้างอินสแตนซ์ OpenThread

ผลตอบแทน

เกณฑ์ความแม่นยำของ XTAL สำหรับเราเตอร์เป็น PPM

otNetworkTimeSetSyncPeriod

 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`	เปิดใช้งานโปรโตคอลเธรด

otNetworkTimeSyncSetCallback

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

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

การโทรกลับนี้จะถูกเรียกเฉพาะเมื่อเครือข่ายข้ามเวลาข้ามโดย OPENTHREAD_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

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