Sinkronisasi Waktu Jaringan

Modul ini mencakup fungsi yang mengontrol layanan sinkronisasi waktu jaringan.

Ringkasan

Enumerasi

otNetworkTimeStatus{
  OT_NETWORK_TIME_UNSYNCHRONIZED = -1,
  OT_NETWORK_TIME_RESYNC_NEEDED = 0,
  OT_NETWORK_TIME_SYNCHRONIZED = 1
}
enum
Mewakili status sinkronisasi waktu OpenThread.

Typedef

otNetworkTimeStatus typedef
Mewakili status sinkronisasi waktu OpenThread.
otNetworkTimeSyncCallbackFn)(void *aCallbackContext) typedef
void(*
Pointer dipanggil saat terjadi sinkronisasi waktu jaringan atau perubahan status.

Fungsi

otNetworkTimeGet(otInstance *aInstance, uint64_t *aNetworkTime)
Mendapatkan waktu jaringan Thread.
otNetworkTimeGetSyncPeriod(otInstance *aInstance)
uint16_t
Mendapatkan periode sinkronisasi waktu.
otNetworkTimeGetXtalThreshold(otInstance *aInstance)
uint16_t
Mendapatkan batas akurasi XTAL sinkronisasi waktu untuk Router.
otNetworkTimeSetSyncPeriod(otInstance *aInstance, uint16_t aTimeSyncPeriod)
Menyetel periode sinkronisasi waktu.
otNetworkTimeSetXtalThreshold(otInstance *aInstance, uint16_t aXTALThreshold)
Menyetel batas akurasi XTAL sinkronisasi waktu untuk perangkat yang Mendukung Router.
otNetworkTimeSyncSetCallback(otInstance *aInstance, otNetworkTimeSyncCallbackFn aCallbackFn, void *aCallbackContext)
void
Menyetel callback agar dipanggil saat sinkronisasi waktu jaringan atau perubahan status terjadi.

Enumerasi

otNetworkTimeStatus

 otNetworkTimeStatus

Mewakili status sinkronisasi waktu OpenThread.

Properti
OT_NETWORK_TIME_RESYNC_NEEDED

Perangkat belum menerima sinkronisasi waktu selama lebih dari dua periode waktu.

OT_NETWORK_TIME_SYNCHRONIZED

Waktu jaringan perangkat disinkronkan.

OT_NETWORK_TIME_UNSYNCHRONIZED

Perangkat belum terhubung ke jaringan.

Typedef

otNetworkTimeStatus

enum otNetworkTimeStatus otNetworkTimeStatus

Mewakili status sinkronisasi waktu OpenThread.

otNetworkTimeSyncCallbackFn

void(* otNetworkTimeSyncCallbackFn)(void *aCallbackContext)

Pointer dipanggil saat terjadi sinkronisasi waktu jaringan atau perubahan status.

Fungsi

otNetworkTimeGet

otNetworkTimeStatus otNetworkTimeGet(
  otInstance *aInstance,
  uint64_t *aNetworkTime
)

Mendapatkan waktu jaringan Thread.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in,out] aNetworkTime
Waktu jaringan Thread dalam mikrodetik.
Hasil
Status sinkronisasi waktu.

otNetworkTimeGetSyncPeriod

uint16_t otNetworkTimeGetSyncPeriod(
  otInstance *aInstance
)

Mendapatkan periode sinkronisasi waktu.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
Hasil
Periode sinkronisasi waktu.

otNetworkTimeGetXtalThreshold

uint16_t otNetworkTimeGetXtalThreshold(
  otInstance *aInstance
)

Mendapatkan batas akurasi XTAL sinkronisasi waktu untuk Router.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
Hasil
Ambang batas akurasi XTAL untuk Router, dalam PPM.

otNetworkTimeSetSyncPeriod

otError otNetworkTimeSetSyncPeriod(
  otInstance *aInstance,
  uint16_t aTimeSyncPeriod
)

Menyetel periode sinkronisasi waktu.

Hanya dapat dipanggil saat protokol Thread dinonaktifkan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aTimeSyncPeriod
Periode sinkronisasi waktu, dalam detik.
Nilai Pengembalian
OT_ERROR_NONE
Berhasil menyetel periode sinkronisasi waktu.
OT_ERROR_INVALID_STATE
Protokol thread diaktifkan.

otNetworkTimeSetXtalThreshold

otError otNetworkTimeSetXtalThreshold(
  otInstance *aInstance,
  uint16_t aXTALThreshold
)

Menyetel batas akurasi XTAL sinkronisasi waktu untuk perangkat yang Mendukung Router.

Hanya dapat dipanggil saat protokol Thread dinonaktifkan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aXTALThreshold
Ambang batas akurasi XTAL untuk Router, dalam PPM.
Nilai Pengembalian
OT_ERROR_NONE
Berhasil menyetel periode sinkronisasi waktu.
OT_ERROR_INVALID_STATE
Protokol thread diaktifkan.

otNetworkTimeSyncSetCallback

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

Menyetel callback agar dipanggil saat sinkronisasi waktu jaringan atau perubahan status terjadi.

Callback ini hanya akan dipanggil jika selisih waktu jaringan melompat sebesar OPENANCHOR_CONFIG_TIME_SYNC_JUMP_NOTIF_MIN_US atau saat status berubah.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aCallbackFn
Fungsi callback yang akan dipanggil
[in] aCallbackContext
Konteks yang akan diteruskan ke fungsi callback saat pemanggilan

Makro

OT_TIME_SYNC_INVALID_SEQ

 OT_TIME_SYNC_INVALID_SEQ 0

nol dianggap sebagai urutan sinkronisasi waktu yang tidak valid.

Referensi

Topik Referensi OpenThread API berasal dari kode sumber yang tersedia di GitHub. Untuk informasi selengkapnya, atau untuk berkontribusi pada dokumentasi kami, lihat Referensi.