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

Giám sát kênh

Mô-đun này bao gồm các chức năng cho tính năng giám sát 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 giám sát kênh ( OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE ) được bật.

Giám sát kênh sẽ theo dõi định kỳ tất cả các kênh để giúp xác định kênh sạch hơn (kênh ít bị nhiễu hơn).

Khi giám sát kênh đang hoạt động, Quét năng lượng có thời lượng bằng 0 được thực hiện, thu thập một mẫu RSSI trên mỗi kênh trong mỗi khoảng thời gian lấy mẫu. Các mẫu RSSI được so sánh với ngưỡng RSSI được chỉ định trước. Là một chỉ báo về chất lượng kênh, mô-đun giám sát kênh duy trì và cung cấp tỷ lệ / phần trăm trung bình của các mẫu RSSI cao hơn ngưỡng trong (gần đúng) một cửa sổ mẫu được chỉ định (được gọi là tỷ lệ sử dụng kênh).

Chức năng

otChannelMonitorGetChannelOccupancy ( otInstance *aInstance, uint8_t aChannel)
uint16_t
Nhận kênh hiện tại cho một kênh nhất định.
otChannelMonitorGetRssiThreshold ( otInstance *aInstance)
int8_t
Nhận ngưỡng RSSI giám sát kênh tính bằng dBm.
otChannelMonitorGetSampleCount ( otInstance *aInstance)
uint32_t
Nhận tổng số mẫu RSSI theo dõi kênh (mỗi kênh).
otChannelMonitorGetSampleInterval ( otInstance *aInstance)
uint32_t
Nhận khoảng thời gian mẫu giám sát kênh tính bằng mili giây.
otChannelMonitorGetSampleWindow ( otInstance *aInstance)
uint32_t
Nhận giám sát kênh lấy trung bình chiều dài cửa sổ mẫu (số lượng mẫu).
otChannelMonitorIsEnabled ( otInstance *aInstance)
bool
Chức năng này cho biết hoạt động Giám sát kênh đã được bật và đang chạy hay chưa.
otChannelMonitorSetEnabled ( otInstance *aInstance, bool aEnabled)
Chức năng này bật / tắt hoạt động Giám sát kênh.

Chức năng

otChannelMonitorGetChannelOccupancy

uint16_t otChannelMonitorGetChannelOccupancy(
  otInstance *aInstance,
  uint8_t aChannel
)

Nhận quyền sử dụng kênh hiện tại cho một kênh nhất định.

Giá trị chiếm dụng kênh thể hiện tỷ lệ / phần trăm trung bình của các mẫu RSSI cao hơn ngưỡng RSSI (các mẫu RSSI "xấu").

Đối với các mẫu "cửa sổ mẫu" đầu tiên, giá trị trung bình được duy trì là tỷ lệ phần trăm thực tế (tức là tỷ lệ số mẫu "xấu" trên tổng số mẫu). Sau các mẫu "cửa sổ", máy tính trung bình sử dụng đường trung bình động có trọng số theo cấp số nhân. Trên thực tế, điều này có nghĩa là mức trung bình đại diện cho tối đa 3 * window mẫu cuối cùng có trọng lượng cao nhất cho các mẫu kSampleWindow mới nhất.

Giá trị tối đa của 0xffff cho biết tất cả các mẫu RSSI đều trên ngưỡng RSSI (nghĩa là 100% mẫu là "xấu").

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aChannel
Kênh để có được tỷ lệ sử dụng liên kết.
Lợi nhuận
Tỷ lệ sử dụng kênh hiện tại cho kênh nhất định.

otChannelMonitorGetRssiThreshold

int8_t otChannelMonitorGetRssiThreshold(
  otInstance *aInstance
)

Nhận ngưỡng RSSI giám sát kênh tính bằng dBm.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
Ngưỡng RSSI tính bằng dBm.

otChannelMonitorGetSampleCount

uint32_t otChannelMonitorGetSampleCount(
  otInstance *aInstance
)

Nhận tổng số mẫu RSSI theo dõi kênh (mỗi kênh).

Số đếm cho biết tổng số mẫu trên mỗi kênh theo mô-đun giám sát kênh kể từ khi bắt đầu (vì giao diện mạng Chủ đề được bật).

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
Lợi nhuận
Tổng số mẫu RSSI (mỗi kênh) được lấy cho đến nay.

otChannelMonitorGetSampleInterval

uint32_t otChannelMonitorGetSampleInterval(
  otInstance *aInstance
)

Nhận khoảng thời gian mẫu giám sát kênh tính bằng mili giây.

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 mẫu theo dõi kênh tính bằng mili giây.

otChannelMonitorGetSampleWindow

uint32_t otChannelMonitorGetSampleWindow(
  otInstance *aInstance
)

Nhận giám sát kênh lấy trung bình chiều dài cửa sổ mẫu (số lượng mẫu).

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ửa sổ lấy mẫu trung bình.

otChannelMonitorIsEnabled

bool otChannelMonitorIsEnabled(
  otInstance *aInstance
)

Chức năng này cho biết liệu hoạt động Giám sát kênh đã được bật và đang chạy hay chưa.

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 hoạt động Giám sát kênh được bật, FALSE nếu không.

otChannelMonitorSetEnabled

otError otChannelMonitorSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Chức năng này bật / tắt hoạt động Giám sát kênh.

Khi hoạt động bắt đầu, mọi dữ liệu đã thu thập trước đó sẽ bị xóa. Tuy nhiên, sau khi thao tác bị vô hiệu hóa, dữ liệu được thu thập trước đó vẫn có giá trị và có thể đọc được.

Chi tiết
Thông số
[in] aInstance
Một con trỏ đến một phiên bản OpenThread.
[in] aEnabled
ĐÚNG để bật / bắt đầu hoạt động Giám sát kênh, SAI để tắt / dừng nó.
Giá trị trả lại
OT_ERROR_NONE
Trạng thái Giám sát kênh đã thay đổi thành công
OT_ERROR_ALREADY
Giám sát kênh đã ở trạng thái tương tự.