Giám sát kênh

Học phần này bao gồm các chức năng đối với tính năng giám sát kênh.

Tóm tắt

Các chức năng trong mô-đun này có khi bật tính năng giám sát kênh (OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE).

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

Khi chức năng giám sát kênh hoạt động, quét năng lượng có thời lượng bằng 0 sẽ thu thập một mẫu RSSI duy nhất trên mỗi kênh trong mỗi khoảng thời gian mẫu. Các mẫu RSSI này được so sánh với một ngưỡng RSSI đã chỉ định sẵn. Như 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ệ trung bình/phần trăm của các mẫu RSSI cao hơn ngưỡng trong (khoảng) cửa sổ mẫu được chỉ định (được gọi là tỷ lệ kín phòng của kênh).

Hàm
otChannelMonitorGetChannelOccupancy(otInstance *aInstance, uint8_t aChannel)	uint16_t Xem thông tin về tỷ lệ kín phòng hiện tại của một kênh cụ thể.
otChannelMonitorGetRssiThreshold(otInstance *aInstance)	int8_t Nhận ngưỡng theo dõi RSSI của kênh theo dBm.
otChannelMonitorGetSampleCount(otInstance *aInstance)	uint32_t Xem kênh giám sát tổng số mẫu RSSI (trên mỗi kênh).
otChannelMonitorGetSampleInterval(otInstance *aInstance)	uint32_t Nhận khoảng thời gian mẫu theo dõi kênh tính bằng mili giây.
otChannelMonitorGetSampleWindow(otInstance *aInstance)	uint32_t Nhận giám sát kênh trung bình độ dài cửa sổ mẫu (số lượng mẫu).
otChannelMonitorIsEnabled(otInstance *aInstance)	bool Cho biết thao tác Giám sát kênh đã được bật và đang chạy chưa.
otChannelMonitorSetEnabled(otInstance *aInstance, bool aEnabled)	otError Bật hoặc tắt thao tác Giám sát kênh.

Hàm

otChannelMonitorGetChannelOccupancy

uint16_t otChannelMonitorGetChannelOccupancy(
  otInstance *aInstance,
  uint8_t aChannel
)

Xem thông tin về tỷ lệ kín phòng hiện tại của một kênh cụ thể.

Giá trị tỷ lệ lấp đầy của kênh đại diện cho tỷ lệ/phần trăm trung bình của mẫu RSSI cao hơn ngưỡng RSSI ("mẫu RSSI kém").

Đối với các mẫu "cửa sổ mẫu" đầu tiên, chỉ số trung bình được duy trì dưới dạng tỷ lệ phần trăm thực tế (tức là tỷ lệ số lượng mẫu "xấu" trên tổng số mẫu). Sau mẫu "cửa sổ", người 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à giá trị trung bình đại diện cho tối đa 3 * window mẫu cuối cùng có trọng số cao nhất được cung cấp 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 (tức là 100% mẫu là "xấu").

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread. [in] aChannel Kênh mà người dùng được hưởng đường liên kết.
Trả về	Tỷ lệ kín phòng hiện tại của kênh đã cho.

otChannelMonitorGetRssiThreshold

int8_t otChannelMonitorGetRssiThreshold(
  otInstance *aInstance
)

Nhận ngưỡng theo dõi RSSI của kênh theo dBm.

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread.
Trả về	Ngưỡng RSSI tính bằng dBm.

otChannelMonitorGetSampleCount

uint32_t otChannelMonitorGetSampleCount(
  otInstance *aInstance
)

Xem kênh giám sát tổng số mẫu RSSI (trên mỗi kênh).

Số lượng này 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 (kể từ khi giao diện mạng Chuỗi được bật).

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread.
Trả về	Tổng số mẫu RSSI (trên 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 theo dõi kênh tính bằng mili giây.

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread.
Trả về	Khoảng thời gian mẫu giám sát kênh tính bằng mili giây.

otChannelMonitorGetSampleWindow

uint32_t otChannelMonitorGetSampleWindow(
  otInstance *aInstance
)

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

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread.
Trả về	Cửa sổ mẫu trung bình.

Đã bật otChannelMonitor

bool otChannelMonitorIsEnabled(
  otInstance *aInstance
)

Cho biết thao tác Giám sát kênh đã được bật và đang chạy chưa.

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread.
Trả về	TRUE nếu hoạt động Giám sát kênh được bật, nếu không thì là FALSE.

Đã bật otChannelMonitorSet

otError otChannelMonitorSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Bật hoặc tắt thao tác Giám sát kênh.

Khi bắt đầu hoạt động, 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 đã thu thập trước đó vẫn hợp lệ và có thể đọc được.

Lưu ý: Lõi OpenThread bật hoặc tắt nội bộ hoạt động Giám sát kênh khi giao diện IPv6 tăng hoặc giảm, chẳng hạn như trong lệnh gọi tới otIp6SetEnabled().

Thông tin chi tiết
Các tham số	[in] aInstance Con trỏ trỏ đến một thực thể OpenThread. [in] aEnabled TRUE để bật/bắt đầu hoạt động Giám sát kênh, FALSE để tắt/dừng tính năng này.
Giá trị trả về	OT_ERROR_NONE Đã thay đổi thành công trạng thái Giám sát kênh OT_ERROR_ALREADY Tính năng Giám sát kênh đã ở trạng thái cũ.

Tài nguyên

Các chủ đề Tham chiếu API OpenThread bắt nguồn từ mã nguồn, có sẵn 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 phần Tài nguyên.