Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Manajer Saluran

Modul ini mencakup fungsi-fungsi untuk Manajer Saluran.

Ringkasan

Fungsi dalam modul ini tersedia jika fitur Pengelola Saluran ( OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE ) diaktifkan. Manajer Saluran hanya tersedia pada build FTD.

Fungsi

otChannelManagerGetAutoChannelSelectionEnabled ( otInstance *aInstance)
bool
Fungsi ini menunjukkan apakah fungsionalitas pemilihan saluran otomatis diaktifkan atau tidak.
otChannelManagerGetAutoChannelSelectionInterval ( otInstance *aInstance)
uint32_t
Fungsi ini mendapatkan interval periode (dalam detik) yang digunakan oleh fungsi pemilihan saluran otomatis.
otChannelManagerGetDelay ( otInstance *aInstance)
uint16_t
Fungsi ini mendapatkan penundaan (dalam detik) yang digunakan oleh Manajer Saluran untuk perubahan saluran.
otChannelManagerGetFavoredChannels ( otInstance *aInstance)
uint32_t
Fungsi ini mendapatkan mask saluran yang disukai.
otChannelManagerGetRequestedChannel ( otInstance *aInstance)
uint8_t
Fungsi ini mendapatkan saluran dari panggilan terakhir yang berhasil ke otChannelManagerRequestChannelChange()
otChannelManagerGetSupportedChannels ( otInstance *aInstance)
uint32_t
Fungsi ini mendapatkan masker saluran yang didukung.
otChannelManagerRequestChannelChange ( otInstance *aInstance, uint8_t aChannel)
void
Fungsi ini meminta perubahan saluran jaringan Thread.
otChannelManagerRequestChannelSelect ( otInstance *aInstance, bool aSkipQualityCheck)
Fungsi ini meminta ChannelManager memeriksa dan memilih saluran baru dan memulai perubahan saluran.
otChannelManagerSetAutoChannelSelectionEnabled ( otInstance *aInstance, bool aEnabled)
void
Fungsi ini mengaktifkan / menonaktifkan fungsionalitas pemilihan saluran otomatis.
otChannelManagerSetAutoChannelSelectionInterval ( otInstance *aInstance, uint32_t aInterval)
Fungsi ini menyetel interval periode (dalam detik) yang digunakan oleh fungsionalitas pemilihan saluran otomatis.
otChannelManagerSetDelay ( otInstance *aInstance, uint16_t aDelay)
Fungsi ini mengatur penundaan (dalam detik) yang digunakan untuk pergantian saluran.
otChannelManagerSetFavoredChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
Fungsi ini mengatur mask saluran yang disukai.
otChannelManagerSetSupportedChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
Fungsi ini mengatur mask saluran yang didukung.

Fungsi

otChannelManagerGetAutoChannelSelectionEnabled

bool otChannelManagerGetAutoChannelSelectionEnabled(
  otInstance *aInstance
)

Fungsi ini menunjukkan apakah fungsionalitas pemilihan saluran otomatis diaktifkan atau tidak.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
Kembali
TRUE jika diaktifkan, FALSE jika dinonaktifkan.

otChannelManagerGetAutoChannelSelectionInterval

uint32_t otChannelManagerGetAutoChannelSelectionInterval(
  otInstance *aInstance
)

Fungsi ini mendapatkan interval periode (dalam detik) yang digunakan oleh fungsi pemilihan saluran otomatis.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
Kembali
Interval dalam hitungan detik.

otChannelManagerGetDelay

uint16_t otChannelManagerGetDelay(
  otInstance *aInstance
)

Fungsi ini mendapatkan penundaan (dalam detik) yang digunakan oleh Manajer Saluran untuk perubahan saluran.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
Kembali
Penundaan (dalam detik) untuk perubahan saluran.

otChannelManagerGetFavoredChannels

uint32_t otChannelManagerGetFavoredChannels(
  otInstance *aInstance
)

Fungsi ini mendapatkan mask saluran yang disukai.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
Kembali
Saluran yang disukai sebagai bit-mask.

otChannelManagerGetRequestedChannel

uint8_t otChannelManagerGetRequestedChannel(
  otInstance *aInstance
)

Fungsi ini mendapatkan saluran dari panggilan terakhir yang berhasil ke otChannelManagerRequestChannelChange()

Detail
Kembali
Saluran yang diminta terakhir atau nol jika belum ada permintaan perubahan saluran.

otChannelManagerGetSupportedChannels

uint32_t otChannelManagerGetSupportedChannels(
  otInstance *aInstance
)

Fungsi ini mendapatkan masker saluran yang didukung.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
Kembali
Saluran yang didukung sebagai bit-mask.

otChannelManagerRequestChannelChange

void otChannelManagerRequestChannelChange(
  otInstance *aInstance,
  uint8_t aChannel
)

Fungsi ini meminta perubahan saluran jaringan Thread.

Jaringan beralih ke saluran tertentu setelah penundaan yang ditentukan (lihat otChannelManagerSetDelay () ). Perubahan saluran dilakukan dengan memperbarui Set Data Operasional Tertunda.

Panggilan berikutnya ke fungsi ini akan membatalkan perubahan saluran yang sebelumnya diminta.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aChannel
Saluran baru untuk jaringan Thread.

otChannelManagerRequestChannelSelect

otError otChannelManagerRequestChannelSelect(
  otInstance *aInstance,
  bool aSkipQualityCheck
)

Fungsi ini meminta ChannelManager memeriksa dan memilih saluran baru dan memulai perubahan saluran.

Tidak seperti otChannelManagerRequestChannelChange() mana saluran harus diberikan sebagai parameter, fungsi ini meminta ChannelManager untuk memilih saluran sendiri (berdasarkan informasi kualitas saluran yang dikumpulkan).

Setelah dipanggil, Channel Manager akan melakukan 3 langkah berikut:

1) ChannelManager memutuskan apakah perubahan saluran akan membantu. Pemeriksaan ini dapat dilewati jika aSkipQualityCheck disetel ke true (memaksa terjadi pemilihan saluran dan melewatkan pemeriksaan kualitas). Langkah ini menggunakan metrik kualitas tautan yang dikumpulkan pada perangkat (seperti tingkat kegagalan CCA, tingkat kesalahan bingkai dan pesan per tetangga, dll.) Untuk menentukan apakah kualitas saluran saat ini berada pada tingkat yang membenarkan perubahan saluran.

2) Jika langkah pertama terlewati, ChannelManager memilih saluran yang berpotensi lebih baik. Ini menggunakan data kualitas saluran yang dikumpulkan oleh modul ChannelMonitor . Saluran yang didukung dan disukai digunakan pada langkah ini. (lihat otChannelManagerSetSupportedChannels () dan otChannelManagerSetFavoredChannels () ).

3) Jika saluran yang baru dipilih berbeda dari saluran saat ini, ChannelManager meminta / memulai proses perubahan saluran (secara internal memanggil RequestChannelChange() ).

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aSkipQualityCheck
Menunjukkan apakah pemeriksaan kualitas (langkah 1) harus dilewati.
Kembalikan Nilai
OT_ERROR_NONE
Pemilihan saluran berhasil diselesaikan.
OT_ERROR_NOT_FOUND
Masker saluran yang didukung kosong, oleh karena itu tidak dapat memilih saluran.

otChannelManagerSetAutoChannelSelectionEnabled

void otChannelManagerSetAutoChannelSelectionEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Fungsi ini mengaktifkan / menonaktifkan fungsionalitas pemilihan saluran otomatis.

Saat diaktifkan, ChannelManager akan secara berkala memanggil RequestChannelSelect(false) . Interval periode bisa disetel oleh SetAutoChannelSelectionInterval() .

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aEnabled
Menunjukkan apakah akan mengaktifkan atau menonaktifkan fungsionalitas ini.

otChannelManagerSetAutoChannelSelectionInterval

otError otChannelManagerSetAutoChannelSelectionInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

Fungsi ini menetapkan interval periode (dalam detik) yang digunakan oleh fungsionalitas pemilihan saluran otomatis.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aInterval
Interval dalam hitungan detik.
Kembalikan Nilai
OT_ERROR_NONE
Interval berhasil disetel.
OT_ERROR_INVALID_ARGS
aInterval tidak valid (nol).

otChannelManagerSetDelay

otError otChannelManagerSetDelay(
  otInstance *aInstance,
  uint16_t aDelay
)

Fungsi ini mengatur penundaan (dalam detik) yang digunakan untuk pergantian saluran.

Penundaan sebaiknya lebih lama dari interval polling data maksimum yang digunakan oleh semua perangkat sleepy-end dalam jaringan Thread.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aDelay
Tunda dalam hitungan detik.
Kembalikan Nilai
OT_ERROR_NONE
Penundaan berhasil diperbarui.
OT_ERROR_INVALID_ARGS
Penundaan yang diberikan aDelay terlalu pendek.

otChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Fungsi ini mengatur mask saluran yang disukai.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aChannelMask
Masker saluran.

otChannelManagerSetSupportedChannels

void otChannelManagerSetSupportedChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Fungsi ini mengatur mask saluran yang didukung.

Detail
Parameter
[in] aInstance
Penunjuk ke instance OpenThread.
[in] aChannelMask
Masker saluran.