หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

สรุป

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

Typedef
`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` ตั้งค่าการเรียกกลับที่จะเรียกใช้เมื่อมีการซิงค์เวลาของเครือข่ายหรือการเปลี่ยนแปลงสถานะ

การแจกแจง

otNetworkTimeStatus

 otNetworkTimeStatus

แสดงสถานะการซิงค์เวลา OpenThread

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

Typedef

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

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

แหล่งข้อมูล

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