Liên kết chỉ số

Mô-đun này bao gồm các hàm kiểm soát giao thức Link Metrics (Chỉ số liên kết).

Tóm tắt

Bảng liệt kê
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
Cờ ACK nâng cao.
otLinkMetricsStatus enum
Liên kết giá trị Trạng thái chỉ số.

Typedef
otLinkMetricsEnhAckFlags typedef
Cờ ACK nâng cao.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Con trỏ được gọi khi nhận được Enh-ACK Probing IE.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
Con trỏ được gọi khi nhận được Phản hồi về việc quản lý chỉ số liên kết.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
Con trỏ được gọi khi nhận được báo cáo Chỉ số liên kết.
otLinkMetricsSeriesFlags typedef
Thể hiện những khung được tính trong Chuỗi theo dõi chuyển tiếp.
otLinkMetricsStatus typedef
Liên kết giá trị Trạng thái chỉ số.
otLinkMetricsValues typedef
Biểu thị kết quả (giá trị) của một truy vấn Chỉ số liên kết.

Hàm
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Gửi một Yêu cầu quản lý chỉ số liên kết MLE để định cấu hình/xoá hoạt động thăm dò dựa trên ACK nâng cao.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
Gửi Yêu cầu quản lý chỉ số liên kết MLE để định cấu hình hoặc xoá Chuỗi theo dõi chuyển tiếp.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)
Nhận dữ liệu Liên kết chỉ số của một quốc gia láng giềng theo địa chỉ mở rộng của địa chỉ đó.
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)
void
Bật hoặc tắt Trình quản lý chỉ số liên kết.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Gửi Yêu cầu dữ liệu MLE để truy vấn Chỉ số đường liên kết.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
Gửi tin nhắn MLE Link Probe.

Cấu trúc
otLinkMetricsSeriesFlags

Thể hiện những khung được tính trong Chuỗi theo dõi chuyển tiếp.

otLinkMetricsValues

Biểu thị kết quả (giá trị) của một truy vấn Chỉ số liên kết.

Bảng liệt kê

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Cờ ACK nâng cao.

Các khoá này được dùng trong kỹ thuật Thăm dò dựa trên ACK nâng cao để cho biết cần đăng ký hay xoá hoạt động thăm dò.

Thuộc tính
OT_LINK_METRICS_ENH_ACK_CLEAR

Rõ ràng.

OT_LINK_METRICS_ENH_ACK_REGISTER

Đăng ký.

otLinkMetricsStatus

 otLinkMetricsStatus

Liên kết giá trị Trạng thái chỉ số.

Typedef

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Cờ ACK nâng cao.

Các khoá này được dùng trong kỹ thuật Thăm dò dựa trên ACK nâng cao để cho biết cần đăng ký hay xoá hoạt động thăm dò.

otLinkMetricsEnhAckProbingIeReportCallback

void(* otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)

Con trỏ được gọi khi nhận được Enh-ACK Probing IE.

Thông tin chi tiết
Thông số
[in] aShortAddress
Địa chỉ ngắn của Đối tượng thăm dò.
[in] aExtAddress
Con trỏ tới địa chỉ mở rộng của Đối tượng thăm dò.
[in] aMetricsValues
Con trỏ đến các giá trị Chỉ số liên kết thu được từ IE.
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otLinkMetricsMgmtResponseCallback

void(* otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext)

Con trỏ được gọi khi nhận được Phản hồi về việc quản lý chỉ số liên kết.

Thông tin chi tiết
Các tham số
[in] aSource
Con trỏ đến địa chỉ nguồn.
[in] aStatus
Mã trạng thái trong phản hồi.
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otLinkMetricsReportCallback

void(* otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext)

Con trỏ được gọi khi nhận được báo cáo Chỉ số liên kết.

Thông tin chi tiết
Các tham số
[in] aSource
Con trỏ đến địa chỉ nguồn.
[in] aMetricsValues
Con trỏ đến các giá trị Chỉ số liên kết (kết quả truy vấn).
[in] aStatus
Mã trạng thái trong báo cáo (chỉ hữu ích khi aMetricsValues có giá trị NULL).
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Thể hiện những khung được tính trong Chuỗi theo dõi chuyển tiếp.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Liên kết giá trị Trạng thái chỉ số.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Biểu thị kết quả (giá trị) của một truy vấn Chỉ số liên kết.

Hàm

otLinkMetricsConfigEnhAckProbing

otError otLinkMetricsConfigEnhAckProbing(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  otLinkMetricsEnhAckFlags aEnhAckFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext,
  otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback,
  void *aEnhAckCallbackContext
)

Gửi một Yêu cầu quản lý chỉ số liên kết MLE để định cấu hình/xoá hoạt động thăm dò dựa trên ACK nâng cao.

Chức năng này yêu cầu bật tính năng OT_LINK_METRICS_ {6}.

Thông tin chi tiết
Các tham số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aDestination
Con trỏ đến địa chỉ đích.
[in] aEnhAckFlags
Cờ Enh-ACK để cho biết liệu nên đăng ký hay xoá hoạt động thăm dò. 0 để xoá và 1 để đăng ký. Các giá trị khác đã được đặt trước.
[in] aLinkMetricsFlags
Con trỏ sẽ gắn cờ để xác định chỉ số cần truy vấn. Phải là NULL khi aEnhAckFlags là 0.
[in] aCallback
Con trỏ đến một hàm được gọi khi nhận được một Ack nâng cao có chỉ số liên kết.
[in] aCallbackContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.
Giá trị trả về
OT_ERROR_NONE
Đã gửi thành công một thông báo Yêu cầu quản lý chỉ số liên kết.
OT_ERROR_NO_BUFS
Không đủ vùng đệm để tạo thông báo Yêu cầu quản lý chỉ số liên kết MLE.
OT_ERROR_INVALID_ARGS
aEnhAckFlags không phải là giá trị hợp lệ hoặc aLinkMetricsFlags không chính xác.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination không phải là liên kết cục bộ hoặc không tìm thấy lân cận.
OT_ERROR_NOT_CAPABLE
Thiết bị lân cận không phải là thiết bị Thread 1.2 và không hỗ trợ Link Metrics.

otLinkMetricsConfigForwardTrackingSeries

otError otLinkMetricsConfigForwardTrackingSeries(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  otLinkMetricsSeriesFlags aSeriesFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext
)

Gửi Yêu cầu quản lý chỉ số liên kết MLE để định cấu hình hoặc xoá Chuỗi theo dõi chuyển tiếp.

Thông tin chi tiết
Các tham số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aDestination
Con trỏ đến địa chỉ đích.
[in] aSeriesId
Mã nhận dạng loạt chương trình để thao tác.
[in] aSeriesFlags
Cờ loạt chỉ định những khung hình được tính.
[in] aLinkMetricsFlags
Con trỏ sẽ gắn cờ để xác định chỉ số cần truy vấn. Phải là NULL khi aSeriesFlags là 0.
[in] aCallback
Con trỏ đến một hàm được gọi khi nhận được Phản hồi quản lý chỉ số liên kết.
[in] aCallbackContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.
Giá trị trả về
OT_ERROR_NONE
Đã gửi thành công một thông báo Yêu cầu quản lý chỉ số liên kết.
OT_ERROR_NO_BUFS
Không đủ vùng đệm để tạo thông báo Yêu cầu quản lý chỉ số liên kết MLE.
OT_ERROR_INVALID_ARGS
aSeriesId không nằm trong phạm vi hợp lệ.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination không phải là liên kết cục bộ hoặc không tìm thấy lân cận.
OT_ERROR_NOT_CAPABLE
Thiết bị lân cận không phải là thiết bị Thread 1.2 và không hỗ trợ Link Metrics.

otLinkMetricsManagerGetMetricsValueByExtAddr

otError otLinkMetricsManagerGetMetricsValueByExtAddr(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  otLinkMetricsValues *aLinkMetricsValues
)

Nhận dữ liệu Liên kết chỉ số của một quốc gia láng giềng theo địa chỉ mở rộng của địa chỉ đó.

Thông tin chi tiết
Các tham số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aExtAddress
Con trỏ tới địa chỉ mở rộng của Đối tượng thăm dò.
[out] aLinkMetricsValues
Con trỏ đến các giá trị Chỉ số liên kết của chủ đề.
Giá trị trả về
OT_ERROR_NONE
Đã nhận thành công dữ liệu Chỉ số liên kết.
OT_ERROR_INVALID_ARGS
Các đối số không hợp lệ.
OT_ERROR_NOT_FOUND
Không tìm thấy người lân cận nào có địa chỉ mở rộng đã cho.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Bật hoặc tắt Trình quản lý chỉ số liên kết.

Thông tin chi tiết
Các tham số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aEnable
Một giá trị boolean cho biết cần bật hoặc tắt.

otLinkMetricsQuery

otError otLinkMetricsQuery(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsReportCallback aCallback,
  void *aCallbackContext
)

Gửi Yêu cầu dữ liệu MLE để truy vấn Chỉ số đường liên kết.

Đó có thể là Đầu dò đơn hoặc Chuỗi theo dõi chuyển tiếp.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aDestination
Con trỏ đến địa chỉ đích.
[in] aSeriesId
Mã sê-ri để truy vấn, 0 đối với đầu dò đơn.
[in] aLinkMetricsFlags
Con trỏ sẽ gắn cờ để xác định chỉ số cần truy vấn.
[in] aCallback
Con trỏ đến một hàm được gọi khi nhận được báo cáo Chỉ số liên kết.
[in] aCallbackContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.
Giá trị trả về
OT_ERROR_NONE
Đã gửi thành công một thông báo truy vấn Chỉ số liên kết.
OT_ERROR_NO_BUFS
Không đủ vùng đệm để tạo thông báo Yêu cầu dữ liệu MLE.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination không phải là liên kết cục bộ hoặc không tìm thấy lân cận.
OT_ERROR_NOT_CAPABLE
Thiết bị lân cận không phải là thiết bị Thread 1.2 và không hỗ trợ Link Metrics.

otLinkMetricsSendLinkProbe

otError otLinkMetricsSendLinkProbe(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  uint8_t aLength
)

Gửi tin nhắn MLE Link Probe.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aDestination
Con trỏ đến địa chỉ đích.
[in] aSeriesId
Mã sê-ri [1, 254] mà thông báo của Thăm dò nhắm đến.
[in] aLength
Độ dài của tải trọng dữ liệu trong Link Probe TLV, 0, 64.
Giá trị trả về
OT_ERROR_NONE
Đã gửi thành công tin nhắn của Đầu dò đường liên kết.
OT_ERROR_NO_BUFS
Không đủ vùng đệm để tạo thông báo MLE Link Probe.
OT_ERROR_INVALID_ARGS
aSeriesId hoặc aLength không nằm trong phạm vi hợp lệ.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination không phải là liên kết cục bộ hoặc không tìm thấy lân cận.
OT_ERROR_NOT_CAPABLE
Thiết bị lân cận không phải là thiết bị Thread 1.2 và không hỗ trợ Link Metrics.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có 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 Tài nguyên.