このページは Cloud Translation API によって翻訳されました。

リンクメトリック

このモジュールには、リンクメトリックプロトコルを制御する関数が含まれています。

概要

列挙
`otLinkMetricsEnhAckFlags { OT_LINK_METRICS_ENH_ACK_CLEAR = 0, OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }`	列挙型拡張ACKフラグ。
`otLinkMetricsStatus`	列挙型リンクメトリックステータス値。

Typedef
`otLinkMetricsEnhAckFlags`	typedef `enum otLinkMetricsEnhAckFlags` 拡張ACKフラグ。
`otLinkMetricsEnhAckProbingIeReportCallback )(otShortAddress aShortAddress, const otExtAddress aExtAddress, const otLinkMetricsValues aMetricsValues, void *aContext)`	typedef `void(*` この関数ポインタは、Enh-ACK ProbingIEを受信したときに呼び出されます。
`otLinkMetricsMgmtResponseCallback )(const otIp6Address aSource, uint8_t aStatus, void aContext)`	typedef `void(*` この関数ポインタは、リンクメトリクス管理応答を受信したときに呼び出されます。
`otLinkMetricsReportCallback )(const otIp6Address aSource, const otLinkMetricsValues aMetricsValues, uint8_t aStatus, void *aContext)`	typedef `void(*` この関数ポインタは、リンクメトリックレポートを受信したときに呼び出されます。
`otLinkMetricsSeriesFlags`	typedef `struct otLinkMetricsSeriesFlags` この構造は、フォワードトラッキングシリーズでどのフレームが考慮されるかを表します。
`otLinkMetricsStatus`	typedef `enum otLinkMetricsStatus` リンクメトリックステータス値。
`otLinkMetricsValues`	typedef `struct otLinkMetricsValues` この構造は、リンクメトリッククエリの結果（値）を表します。

関数
`otLinkMetricsConfigEnhAckProbing ( otInstance aInstance, const otIp6Address aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)`	`otError` この関数は、MLEリンクメトリック管理要求を送信して、拡張ACKベースのプロービングを構成/クリアします。
`otLinkMetricsConfigForwardTrackingSeries ( otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void aCallbackContext)`	`otError` この関数は、MLEリンクメトリック管理要求を送信して、フォワードトラッキングシリーズを構成/クリアします。
`otLinkMetricsQuery ( otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, const otLinkMetrics aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void aCallbackContext)`	`otError` この関数は、リンクメトリックを照会するためにMLEデータ要求を送信します。
`otLinkMetricsSendLinkProbe ( otInstance aInstance, const otIp6Address aDestination, uint8_t aSeriesId, uint8_t aLength)`	`otError` この関数は、MLEリンクプローブメッセージを送信します。

構造体
otLinkMetricsSeriesFlags	この構造は、フォワードトラッキングシリーズでどのフレームが考慮されるかを表します。
otLinkMetricsValues	この構造は、リンクメトリッククエリの結果（値）を表します。

列挙

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

拡張ACKフラグ。

これらは、拡張ACKベースのプロービングで使用され、プロービングを登録するかクリアするかを示します。

プロパティ
`OT_LINK_METRICS_ENH_ACK_CLEAR`	晴れ。
`OT_LINK_METRICS_ENH_ACK_REGISTER`	登録。

otLinkMetricsStatus

 otLinkMetricsStatus

リンクメトリックステータス値。

Typedef

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

拡張ACKフラグ。

これらは、拡張ACKベースのプロービングで使用され、プロービングを登録するかクリアするかを示します。

otLinkMetricsEnhAckProbingIeReportCallback

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

この関数ポインタは、Enh-ACK ProbingIEを受信したときに呼び出されます。

詳細

パラメーター

`[in] aShortAddress`	プロービングサブジェクトのMacショートアドレス。
`[in] aExtAddress`	プロービングサブジェクトのMac拡張アドレスへのポインタ。
`[in] aMetricsValues`	IEから取得したリンクメトリック値へのポインタ。
`[in] aContext`	アプリケーション固有のコンテキストへのポインタ。

otLinkMetricsMgmtResponseCallback

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

この関数ポインタは、リンクメトリクス管理応答を受信したときに呼び出されます。

詳細

パラメーター

`[in] aSource`	送信元アドレスへのポインタ。
`[in] aStatus`	応答のステータスコード。
`[in] aContext`	アプリケーション固有のコンテキストへのポインタ。

otLinkMetricsReportCallback

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

この関数ポインタは、リンクメトリックレポートを受信したときに呼び出されます。

詳細

パラメーター

`[in] aSource`	送信元アドレスへのポインタ。
`[in] aMetricsValues`	リンクメトリック値（クエリ結果）へのポインタ。
`[in] aStatus`	レポートのステータスコード（ときのみ有用`aMetricsValues` NULLです）。
`[in] aContext`	アプリケーション固有のコンテキストへのポインタ。

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

この構造は、フォワードトラッキングシリーズでどのフレームが考慮されるかを表します。

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

リンクメトリックステータス値。

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

この構造は、リンクメトリッククエリの結果（値）を表します。

関数

otLinkMetricsConfigEnhAckProbing

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

この関数は、MLEリンクメトリック管理要求を送信して、拡張ACKベースのプロービングを構成/クリアします。

この機能を使用するには、OT_LINK_METRICS_INITIATOR機能を有効にする必要があります。

詳細

パラメーター

`[in] aInstance`	OpenThreadインスタンスへのポインタ。
`[in] aDestination`	宛先アドレスへのポインタ。
`[in] aEnhAckFlags`	Enh-ACKプロービングを登録するかクリアするかを示すフラグ。 `0`クリアとする`1`登録します。他の値は予約されています。
`[in] aLinkMetricsFlags`	クエリするメトリックを指定するフラグへのポインタ。あるべき`NULL`とき`aEnhAckFlags`ある`0` 。
`[in] aCallback`	リンクメトリックを使用した拡張Ackを受信したときに呼び出される関数へのポインタ。
`[in] aCallbackContext`	アプリケーション固有のコンテキストへのポインタ。

戻り値

`OT_ERROR_NONE`	Link Metrics ManagementRequestメッセージが正常に送信されました。
`OT_ERROR_NO_BUFS`	MLEリンクメトリック管理要求メッセージを生成するためのバッファが不十分です。
`OT_ERROR_INVALID_ARGS`	`aEnhAckFlags`有効な値ではありませんか`aLinkMetricsFlags`正しくありません。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination`リンクローカルではないか、隣人が見つかりません。
`OT_ERROR_NOT_CAPABLE`	ネイバーはスレッド1.2デバイスではなく、リンクメトリックをサポートしていません。

otLinkMetricsConfigForwardTrackingSeries

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

この関数は、MLEリンクメトリック管理要求を送信して、フォワードトラッキングシリーズを構成/クリアします。

詳細

パラメーター

`[in] aInstance`	OpenThreadインスタンスへのポインタ。
`[in] aDestination`	宛先アドレスへのポインタ。
`[in] aSeriesId`	操作するシリーズID。
`[in] aSeriesFlags`	考慮されるフレームを指定するシリーズフラグ。
`[in] aLinkMetricsFlags`	クエリするメトリックを指定するフラグへのポインタ。あるべき`NULL`とき`aSeriesFlags`ある`0` 。
`[in] aCallback`	リンクメトリック管理応答を受信したときに呼び出される関数へのポインタ。
`[in] aCallbackContext`	アプリケーション固有のコンテキストへのポインタ。

戻り値

`OT_ERROR_NONE`	Link Metrics ManagementRequestメッセージが正常に送信されました。
`OT_ERROR_NO_BUFS`	MLEリンクメトリック管理要求メッセージを生成するためのバッファが不十分です。
`OT_ERROR_INVALID_ARGS`	`aSeriesId`有効な範囲内にありません。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination`リンクローカルではないか、隣人が見つかりません。
`OT_ERROR_NOT_CAPABLE`	ネイバーはスレッド1.2デバイスではなく、リンクメトリックをサポートしていません。

otLinkMetricsQuery

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

この関数は、リンクメトリックを照会するためにMLEデータ要求を送信します。

シングルプローブまたはフォワードトラッキングシリーズのいずれかです。

詳細

パラメーター

`[in] aInstance`	OpenThreadインスタンスへのポインタ。
`[in] aDestination`	宛先アドレスへのポインタ。
`[in] aSeriesId`	照会するシリーズID、シングルプローブの場合は0。
`[in] aLinkMetricsFlags`	クエリするメトリックを指定するフラグへのポインタ。
`[in] aCallback`	リンクメトリックレポートを受信したときに呼び出される関数へのポインタ。
`[in] aCallbackContext`	アプリケーション固有のコンテキストへのポインタ。

戻り値

`OT_ERROR_NONE`	リンクメトリッククエリメッセージを正常に送信しました。
`OT_ERROR_NO_BUFS`	MLEデータ要求メッセージを生成するためのバッファーが不十分です。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination`リンクローカルではないか、隣人が見つかりません。
`OT_ERROR_NOT_CAPABLE`	ネイバーはスレッド1.2デバイスではなく、リンクメトリックをサポートしていません。

otLinkMetricsSendLinkProbe

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

この関数は、MLEリンクプローブメッセージを送信します。

詳細

パラメーター

`[in] aInstance`	OpenThreadインスタンスへのポインタ。
`[in] aDestination`	宛先アドレスへのポインタ。
`[in] aSeriesId`	プローブメッセージが狙うシリーズID [1、254]。
`[in] aLength`	リンクプローブTLV、データペイロードの長さが0、64 。

戻り値

`OT_ERROR_NONE`	リンクプローブメッセージを正常に送信しました。
`OT_ERROR_NO_BUFS`	MLEリンクプローブメッセージを生成するためのバッファが不十分です。
`OT_ERROR_INVALID_ARGS`	`aSeriesId`または`aLength`有効な範囲内にありません。
`OT_ERROR_UNKNOWN_NEIGHBOR`	`aDestination`リンクローカルではないか、隣人が見つかりません。
`OT_ERROR_NOT_CAPABLE`	ネイバーはスレッド1.2デバイスではなく、リンクメトリックをサポートしていません。

リンクメトリック

概要

列挙

Typedef

関数

構造体

列挙

otLinkMetricsEnhAckFlags

otLinkMetricsStatus

Typedef

otLinkMetricsEnhAckFlags

otLinkMetricsEnhAckProbingIeReportCallback

otLinkMetricsMgmtResponseCallback

otLinkMetricsReportCallback

otLinkMetricsSeriesFlags

otLinkMetricsStatus

otLinkMetricsValues

関数

otLinkMetricsConfigEnhAckProbing

otLinkMetricsConfigForwardTrackingSeries

otLinkMetricsQuery

otLinkMetricsSendLinkProbe