Trang này được dịch bởi Cloud Translation API.

Chỉ số liên kết

Học phần này bao gồm các hàm kiểm soát giao thức 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 Các giá trị Trạng thái của chỉ số liên kết.

Loại
`otLinkMetricsEnhAckFlags`	typedef `enum otLinkMetricsEnhAckFlags` Cờ ACK nâng cao.
`otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress aExtAddress, const otLinkMetricsValues aMetricsValues, void *aContext)`	typedef `void(*` Con trỏ hàm này được gọi khi bạn nhận được Enh-ACK Probing IE.
`otLinkMetricsMgmtResponseCallback)(const otIp6Address aSource, uint8_t aStatus, void aContext)`	typedef `void(*` Con trỏ hàm này được gọi khi nhận được Phản hồi quản lý chỉ số liên kết.
`otLinkMetricsReportCallback)(const otIp6Address aSource, const otLinkMetricsValues aMetricsValues, uint8_t aStatus, void *aContext)`	typedef `void(*` Con trỏ hàm này được gọi khi nhận được báo cáo Chỉ số liên kết.
`otLinkMetricsSeriesFlags`	typedef `struct otLinkMetricsSeriesFlags` Cấu trúc này thể hiện khung nào được tính trong Chuỗi theo dõi chuyển tiếp.
`otLinkMetricsStatus`	typedef `enum otLinkMetricsStatus` Các giá trị Trạng thái của chỉ số liên kết.
`otLinkMetricsValues`	typedef `struct otLinkMetricsValues` Cấu trúc này đại diện cho kết quả (giá trị) cho 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)`	`otError` Hàm này sẽ gửi một Yêu cầu quản lý các chỉ số liên kết MLE để định cấu hình/xóa một Ưu điểm tăng cường dựa trên ACK.
`otLinkMetricsConfigForwardTrackingSeries(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext)`	`otError` Hàm này gửi Yêu cầu quản lý các chỉ số liên kết MLE để định cấu hình/xóa Chuỗi theo dõi chuyển tiếp.
`otLinkMetricsQuery(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void aCallbackContext)`	`otError` Hàm này gửi một Yêu cầu dữ liệu MLE để truy vấn các Chỉ số liên kết.
`otLinkMetricsSendLinkProbe(otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, uint8_t aLength)`	`otError` Hàm này gửi thông báo Đề xuất liên kết MLE.

Cấu trúc
otLinkMetricsSeriesFlags	Cấu trúc này thể hiện khung nào được tính trong Chuỗi theo dõi chuyển tiếp.
otLinkMetricsValues	Cấu trúc này đại diện cho kết quả (giá trị) cho 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 biểu mẫu này được dùng trong tính năng Xác minh dựa trên AGA nâng cao để cho biết bạn nên đăng ký hay xóa nội dung thăm dò ý kiến.

Tài sản
`OT_LINK_METRICS_ENH_ACK_CLEAR`	Xóa.
`OT_LINK_METRICS_ENH_ACK_REGISTER`	Đăng ký.

otLinkMetricsStatus

 otLinkMetricsStatus

Các giá trị Trạng thái của chỉ số liên kết.

Loại

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Cờ ACK nâng cao.

Các biểu mẫu này được dùng trong tính năng Xác minh dựa trên AGA nâng cao để cho biết bạn nên đăng ký hay xóa nội dung thăm dò ý kiến.

otLinkMetricsEnhAckProbingIeReportCallback

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

Con trỏ hàm này được gọi khi bạn nhận được Enh-ACK Probing IE.

Thông tin chi tiết

Thông số

`[in] aShortAddress`	Địa chỉ rút gọn của Mac.
`[in] aExtAddress`	Con trỏ đến địa chỉ được mở rộng của máy Mac.
`[in] aMetricsValues`	Con trỏ tới giá trị Chỉ số liên kết thu được từ IE.
`[in] aContext`	Con trỏ tới ngữ cảnh theo từng ứng dụng.

otLinkMetricsMetricsResponseCallback

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

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

Thông tin chi tiết

Thông 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ỏ tới ngữ cảnh theo từng ứng dụng.

otLinkMetricsReportCallback

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

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

Thông tin chi tiết

Thông số

`[in] aSource`	Con trỏ đến địa chỉ nguồn.
`[in] aMetricsValues`	Con trỏ đến 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` là NULL).
`[in] aContext`	Con trỏ tới ngữ cảnh theo từng ứng dụng.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

Cấu trúc này thể hiện khung nào được tính trong Chuỗi theo dõi chuyển tiếp.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Các giá trị Trạng thái của chỉ số liên kết.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Cấu trúc này đại diện cho kết quả (giá trị) cho 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
)

Hàm này sẽ gửi một Yêu cầu quản lý các chỉ số liên kết MLE để định cấu hình/xóa một Ưu điểm tăng cường dựa trên ACK.

Tính năng này yêu cầu bật tính năng OT_LINK_METRICS_BLOCKED.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một bản sao OpenThread.
`[in] aDestination`	Con trỏ đến địa chỉ đích.
`[in] aEnhAckFlags`	Cờ Enh-ACK cho biết liệu có nên đăng ký hoặc xóa thăm dò hay không. `0` để xóa và `1` để đăng ký. Các giá trị khác được đặt trước.
`[in] aLinkMetricsFlags`	Con trỏ để gắn cờ chỉ định chỉ số nào cần truy vấn. Phải là `NULL` khi `aEnhAckFlags` là `0`.
`[in] aCallback`	Con trỏ đến hàm được gọi khi nhận được đảm bảo nâng cao với chỉ số liên kết.
`[in] aCallbackContext`	Con trỏ tới ngữ cảnh theo từng ứng dụng.

Giá trị trả về

`OT_ERROR_NONE`	Đã gửi thành công 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à một giá trị hợp lệ hoặc `aLinkMetricsFlags` không chính xác.
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination` không phải là đường liên kết địa phương hoặc không tìm thấy hàng xóm.
`OT_ERROR_NOT_CAPABLE`	Vùng lân cận không phải là thiết bị Chuỗi 1.2 và không hỗ trợ Chỉ số liên kết.

otLinkMetricsConfig ForwardTracking

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

Hàm này gửi Yêu cầu quản lý các chỉ số liên kết MLE để định cấu hình/xóa 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 bản sao OpenThread.
`[in] aDestination`	Con trỏ đến địa chỉ đích.
`[in] aSeriesId`	Mã bộ sách sẽ hoạt động.
`[in] aSeriesFlags`	Cờ loạt phim chỉ định khung nào cần tính toán.
`[in] aLinkMetricsFlags`	Con trỏ để gắn cờ chỉ định chỉ số nào 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ỏ tới ngữ cảnh theo từng ứng dụng.

Giá trị trả về

`OT_ERROR_NONE`	Đã gửi thành công 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à đường liên kết địa phương hoặc không tìm thấy hàng xóm.
`OT_ERROR_NOT_CAPABLE`	Vùng lân cận không phải là thiết bị Chuỗi 1.2 và không hỗ trợ Chỉ số liên kết.

otLinkMetricsQuery

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

Hàm này gửi một Yêu cầu dữ liệu MLE để truy vấn các Chỉ số liên kết.

Gói này có thể là một đầu dò riêng lẻ hoặc loạt thiết bị theo dõi chuyển tiếp.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một bản sao OpenThread.
`[in] aDestination`	Con trỏ đến địa chỉ đích.
`[in] aSeriesId`	ID chuỗi để truy vấn về, 0 dành cho Single Probe.
`[in] aLinkMetricsFlags`	Con trỏ để gắn cờ chỉ định chỉ số nào 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ỏ tới ngữ cảnh theo từng ứng dụng.

Giá trị trả về

`OT_ERROR_NONE`	Đã gửi thành công 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à đường liên kết địa phương hoặc không tìm thấy hàng xóm.
`OT_ERROR_NOT_CAPABLE`	Vùng lân cận không phải là thiết bị Chuỗi 1.2 và không hỗ trợ Chỉ số liên kết.

otLinkMetricsGửiLinkProbe

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

Hàm này gửi thông báo Đề xuất liên kết MLE.

Thông tin chi tiết

Thông số

`[in] aInstance`	Con trỏ đến một bản sao OpenThread.
`[in] aDestination`	Con trỏ đến địa chỉ đích.
`[in] aSeriesId`	Mã chuỗi [1, 254] mà thông báo Probe nhắm đến.
`[in] aLength`	Độ dài của tải dữ liệu trong Link Probe TLV, 0, 64.

Giá trị trả về

`OT_ERROR_NONE`	Đã gửi thành công thông báo Đề xuất liên kết.
`OT_ERROR_NO_BUFS`	Không đủ bộ đệm để tạo thông báo Probe Link MLE.
`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à đường liên kết địa phương hoặc không tìm thấy hàng xóm.
`OT_ERROR_NOT_CAPABLE`	Vùng lân cận không phải là thiết bị Chuỗi 1.2 và không hỗ trợ Chỉ số liên kết.

Nguồn lực

Các chủ đề trong API tham chiếu Openthread có nguồn gốc 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 phần Tài nguyên.