Đồng bộ hoá thời gian mạng

Mô-đun này bao gồm các hàm kiểm soát dịch vụ đồng bộ hoá thời gian mạng.

Tóm tắt

Bảng liệt kê

otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
}
enum
Biểu thị trạng thái đồng bộ hoá thời gian OpenThread.

Typedef

otNetworkTimeStatus typedef
Biểu thị trạng thái đồng bộ hoá thời gian OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) typedef
void(*
Con trỏ được gọi khi xảy ra đồng bộ hoá thời gian mạng hoặc thay đổi trạng thái.

Hàm

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
Lấy thời gian của mạng Thread.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
Lấy khoảng thời gian đồng bộ hoá thời gian.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
Nhận ngưỡng chính xác XTAL đồng bộ hoá thời gian cho Bộ định tuyến.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
Đặt khoảng thời gian đồng bộ hoá thời gian.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
Đặt ngưỡng chính xác XTAL đồng bộ hoá thời gian cho thiết bị Bộ định tuyến có thể kết nối.
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
Thiết lập lệnh gọi lại khi đồng bộ hoá thời gian mạng hoặc thay đổi trạng thái.

Bảng liệt kê

otNetworkTimeStatus

 otNetworkTimeStatus

Biểu thị trạng thái đồng bộ hoá thời gian OpenThread.

Thuộc tính
OT_NETWORK_TIME_RESYNC_NEEDED

Thiết bị chưa nhận được đồng bộ hoá thời gian sau hơn 2 khoảng thời gian.

OT_NETWORK_TIME_SYNCHRONIZED

Thời gian mạng của thiết bị được đồng bộ hoá.

OT_NETWORK_TIME_UNSYNCHRONIZED

Thiết bị chưa kết nối với mạng nào.

Typedef

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Biểu thị trạng thái đồng bộ hoá thời gian OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Con trỏ được gọi khi xảy ra đồng bộ hoá thời gian mạng hoặc thay đổi trạng thái.

Hàm

otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Lấy thời gian của mạng Thread.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in,out] aNetworkTime
Thời gian mạng Thread tính bằng micrô giây.
Trả về
Trạng thái đồng bộ hoá thời gian.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Lấy khoảng thời gian đồng bộ hoá thời gian.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
Trả về
Khoảng thời gian đồng bộ hoá thời gian.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Nhận ngưỡng chính xác XTAL đồng bộ hoá thời gian cho Bộ định tuyến.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
Trả về
Ngưỡng chính xác XTAL cho Bộ định tuyến, tính theo PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Đặt khoảng thời gian đồng bộ hoá thời gian.

Chỉ có thể gọi khi giao thức Thread đang tắt.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aTimeSyncPeriod
Khoảng thời gian đồng bộ hoá thời gian, tính bằng giây.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công khoảng thời gian đồng bộ hoá thời gian.
OT_ERROR_INVALID_STATE
Các giao thức luồng đang bật.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Đặt ngưỡng chính xác XTAL đồng bộ hoá thời gian cho thiết bị Bộ định tuyến có thể kết nối.

Chỉ có thể gọi khi giao thức Thread đang tắt.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aXTALThreshold
Ngưỡng chính xác XTAL cho Bộ định tuyến, tính theo PPM.
Giá trị trả về
OT_ERROR_NONE
Đã đặt thành công khoảng thời gian đồng bộ hoá thời gian.
OT_ERROR_INVALID_STATE
Các giao thức luồng đang bật.

otNetworkTimeSyncSetCallback

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

Thiết lập lệnh gọi lại khi đồng bộ hoá thời gian mạng hoặc thay đổi trạng thái.

Lệnh gọi lại này sẽ chỉ được gọi khi số giờ chênh lệch thời gian mạng tăng lên mend_ô_ô_ Nếu ___.

Thông tin chi tiết
Các tham số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aCallbackFn
Hàm callback cần được gọi
[in] aCallbackContext
Ngữ cảnh sẽ được truyền đến hàm callback khi gọi

Macro

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

0 được coi là trình tự đồng bộ hoá thời gian không hợp lệ.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.