Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Quản lý kênh

Mô-đun này bao gồm các chức năng cho Trình quản lý kênh.

Tóm lược

Các chức năng trong mô-đun này khả dụng khi tính năng Trình quản lý kênh ( OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE ) được bật. Trình quản lý kênh chỉ khả dụng trên bản dựng FTD.

Chức năng

otChannelManagerGetAutoChannelSelectionEnabled ( otInstance *aInstance)
bool
Chức năng này cho biết chức năng chọn kênh tự động có được bật hay không.
otChannelManagerGetAutoChannelSelectionInterval ( otInstance *aInstance)
uint32_t
Hàm này nhận khoảng thời gian (tính bằng giây) được sử dụng bởi chức năng chọn kênh tự động.
otChannelManagerGetDelay ( otInstance *aInstance)
uint16_t
Chức năng này lấy độ trễ (tính bằng giây) được Trình quản lý kênh sử dụng để thay đổi kênh.
otChannelManagerGetFavoredChannels ( otInstance *aInstance)
uint32_t
Hàm này nhận được mặt nạ kênh ưa thích.
otChannelManagerGetRequestedChannel ( otInstance *aInstance)
uint8_t
Hàm này lấy kênh từ lần gọi thành công cuối cùng tới otChannelManagerRequestChannelChange()
otChannelManagerGetSupportedChannels ( otInstance *aInstance)
uint32_t
Chức năng này nhận mặt nạ kênh được hỗ trợ.
otChannelManagerRequestChannelChange ( otInstance *aInstance, uint8_t aChannel)
void
Chức năng này yêu cầu thay đổi kênh mạng Chủ đề.
otChannelManagerRequestChannelSelect ( otInstance *aInstance, bool aSkipQualityCheck)
Hàm này yêu cầu ChannelManager kiểm tra và chọn một kênh mới và bắt đầu thay đổi kênh.
otChannelManagerSetAutoChannelSelectionEnabled ( otInstance *aInstance, bool aEnabled)
void
Chức năng này bật / tắt chức năng tự động chọn kênh.
otChannelManagerSetAutoChannelSelectionInterval ( otInstance *aInstance, uint32_t aInterval)
Chức năng này đặt khoảng thời gian (tính bằng giây) được sử dụng bởi chức năng chọn kênh tự động.
otChannelManagerSetDelay ( otInstance *aInstance, uint16_t aDelay)
Chức năng này đặt độ trễ (tính bằng giây) được sử dụng để thay đổi kênh.
otChannelManagerSetFavoredChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
Chức năng này đặt mặt nạ kênh ưa thích.
otChannelManagerSetSupportedChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
Chức năng này đặt mặt nạ kênh được hỗ trợ.

Chức năng

otChannelManagerGetAutoChannelSelectionEnabled

bool otChannelManagerGetAutoChannelSelectionEnabled(
  otInstance *aInstance
)

Chức năng này cho biết chức năng chọn kênh tự động có được bật hay không.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
TRUE nếu được bật, FALSE nếu bị tắt.

otChannelManagerGetAutoChannelSelectionInterval

uint32_t otChannelManagerGetAutoChannelSelectionInterval(
  otInstance *aInstance
)

Hàm này nhận khoảng thời gian (tính bằng giây) được sử dụng bởi chức năng chọn kênh tự động.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
Khoảng thời gian tính bằng giây.

otChannelManagerGetDelay

uint16_t otChannelManagerGetDelay(
  otInstance *aInstance
)

Chức năng này lấy độ trễ (tính bằng giây) được Trình quản lý kênh sử dụng để thay đổi kênh.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
Độ trễ (tính bằng giây) để thay đổi kênh.

otChannelManagerGetFavoredChannels

uint32_t otChannelManagerGetFavoredChannels(
  otInstance *aInstance
)

Hàm này nhận được mặt nạ kênh ưa thích.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
Các kênh được ưa chuộng như một mặt nạ bit.

otChannelManagerGetRequestedChannel

uint8_t otChannelManagerGetRequestedChannel(
  otInstance *aInstance
)

Hàm này lấy kênh từ lần gọi thành công cuối cùng tới otChannelManagerRequestChannelChange()

Chi tiết
Lợi nhuận
Kênh được yêu cầu cuối cùng hoặc số không nếu chưa có yêu cầu thay đổi kênh.

otChannelManagerGetSupportedChannels

uint32_t otChannelManagerGetSupportedChannels(
  otInstance *aInstance
)

Chức năng này nhận mặt nạ kênh được hỗ trợ.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
Các kênh được hỗ trợ dưới dạng mặt nạ bit.

otChannelManagerRequestChannelChange

void otChannelManagerRequestChannelChange(
  otInstance *aInstance,
  uint8_t aChannel
)

Chức năng này yêu cầu thay đổi kênh mạng Chủ đề.

Mạng chuyển sang kênh nhất định sau một khoảng thời gian trễ được chỉ định (xem otChannelManagerSetDelay () ). Việc thay đổi kênh được thực hiện bằng cách cập nhật Tập dữ liệu hoạt động đang chờ xử lý.

Một lệnh gọi tiếp theo đến chức năng này sẽ hủy bỏ một thay đổi kênh được yêu cầu trước đó đang diễn ra.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aChannel
Kênh mới cho mạng Chủ đề.

otChannelManagerRequestChannelSelect

otError otChannelManagerRequestChannelSelect(
  otInstance *aInstance,
  bool aSkipQualityCheck
)

Hàm này yêu cầu ChannelManager kiểm tra và chọn một kênh mới và bắt đầu thay đổi kênh.

Không giống như các otChannelManagerRequestChannelChange() nơi các kênh phải được trao như một tham số, chức năng này yêu cầu các ChannelManager để chọn một kênh bằng cách riêng của mình (dựa của kênh thông tin chất lượng thu thập).

Sau khi được gọi, Trình quản lý kênh sẽ thực hiện 3 bước sau:

1) ChannelManager quyết định nếu việc thay đổi kênh sẽ là hữu ích. Có thể bỏ qua kiểm tra này nếu aSkipQualityCheck được đặt thành true (buộc thực hiện lựa chọn kênh và bỏ qua kiểm tra chất lượng). Bước này sử dụng các chỉ số chất lượng liên kết được thu thập trên thiết bị (chẳng hạn như tỷ lệ lỗi CCA, tỷ lệ lỗi khung hình và tin nhắn trên mỗi hàng xóm, v.v.) để xác định xem chất lượng kênh hiện tại có ở mức phù hợp với việc thay đổi kênh hay không.

2) Nếu bước đầu tiên vượt qua, thì ChannelManager sẽ chọn một kênh tiềm năng tốt hơn. Nó sử dụng dữ liệu chất lượng kênh được thu thập bởi mô-đun ChannelMonitor . Các kênh được hỗ trợ và ưu tiên được sử dụng ở bước này. (xem otChannelManagerSetSupportedChannels ()otChannelManagerSetFavoredChannels () ).

3) Nếu kênh mới được chọn khác với kênh hiện tại, ChannelManager yêu cầu / bắt đầu quá trình thay đổi kênh (gọi nội bộ một RequestChannelChange() ).

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aSkipQualityCheck
Cho biết có nên bỏ qua kiểm tra chất lượng (bước 1) hay không.
Giá trị trả lại
OT_ERROR_NONE
Lựa chọn kênh đã hoàn tất thành công.
OT_ERROR_NOT_FOUND
Mặt nạ kênh được hỗ trợ trống, do đó không thể chọn kênh.

otChannelManagerSetAutoChannelSelectionEnabled

void otChannelManagerSetAutoChannelSelectionEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Chức năng này bật / tắt chức năng tự động chọn kênh.

Khi được bật, ChannelManager sẽ gọi định kỳ một RequestChannelSelect(false) . Khoảng thời gian có thể được đặt bởi SetAutoChannelSelectionInterval() .

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aEnabled
Cho biết có nên bật hay tắt chức năng này.

otChannelManagerSetAutoChannelSelectionInterval

otError otChannelManagerSetAutoChannelSelectionInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

Chức năng này đặt khoảng thời gian (tính bằng giây) được sử dụng bởi chức năng chọn kênh tự động.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aInterval
Khoảng thời gian tính bằng giây.
Giá trị trả lại
OT_ERROR_NONE
Khoảng thời gian đã được đặt thành công.
OT_ERROR_INVALID_ARGS
aInterval không hợp lệ (không).

otChannelManagerSetDelay

otError otChannelManagerSetDelay(
  otInstance *aInstance,
  uint16_t aDelay
)

Chức năng này đặt độ trễ (tính bằng giây) được sử dụng để thay đổi kênh.

Thời gian trễ tốt hơn nên dài hơn khoảng thời gian thăm dò dữ liệu tối đa được sử dụng bởi tất cả các thiết bị đầu cuối buồn ngủ trong mạng Thread.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aDelay
Độ trễ trong vài giây.
Giá trị trả lại
OT_ERROR_NONE
Độ trễ đã được cập nhật thành công.
OT_ERROR_INVALID_ARGS
Độ trễ đã cho aDelay quá ngắn.

otChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Chức năng này đặt mặt nạ kênh ưa thích.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aChannelMask
Mặt nạ kênh.

otChannelManagerSetSupportedChannels

void otChannelManagerSetSupportedChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Chức năng này đặt mặt nạ kênh được hỗ trợ.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aChannelMask
Mặt nạ kênh.