링크 메트릭

이 모듈에는 Link Metrics 프로토콜을 제어하는 기능이 포함되어 있습니다.

요약

열거 형
`otLinkMetricsEnhAckFlags { OT_LINK_METRICS_ENH_ACK_CLEAR = 0, OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }`	열거 형 Enhanced-ACK 플래그.
`otLinkMetricsStatus`	열거 형 지표 상태 값을 연결합니다.

Typedef
`otLinkMetricsEnhAckFlags`	typedef `enum otLinkMetricsEnhAckFlags` Enhanced-ACK 플래그.
`otLinkMetricsEnhAckProbingIeReportCallback )(otShortAddress aShortAddress, const otExtAddress aExtAddress, const otLinkMetricsValues aMetricsValues, void *aContext)`	typedef `void(*` 이 함수 포인터는 Enh-ACK Probing IE가 수신 될 때 호출됩니다.
`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 링크 메트릭 관리 요청을 전송하여 Enhanced-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

Enhanced-ACK 플래그.

이는 Enhanced-ACK Based Probing에서 프로빙 등록 또는 삭제 여부를 나타내는 데 사용됩니다.

속성
`OT_LINK_METRICS_ENH_ACK_CLEAR`	맑은.
`OT_LINK_METRICS_ENH_ACK_REGISTER`	레지스터.

otLinkMetricsStatus

 otLinkMetricsStatus

지표 상태 값을 연결합니다.

Typedef

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Enhanced-ACK 플래그.

이는 Enhanced-ACK Based Probing에서 프로빙 등록 또는 삭제 여부를 나타내는 데 사용됩니다.

otLinkMetricsEnhAckProbingIeReportCallback

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

이 함수 포인터는 Enh-ACK Probing IE가 수신 될 때 호출됩니다.

세부

매개 변수

`[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 링크 메트릭 관리 요청을 전송하여 Enhanced-ACK 기반 프로빙을 구성 / 삭제합니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in] aDestination`	목적지 주소에 대한 포인터.
`[in] aEnhAckFlags`	Enh-ACK 플래그는 프로빙을 등록하거나 삭제할지 여부를 나타냅니다. `0` 은 지우고 `1` 은 등록합니다. 다른 값은 예약되어 있습니다.
`[in] aLinkMetricsFlags`	쿼리 할 메트릭을 지정하는 플래그에 대한 포인터입니다. `aEnhAckFlags` 가 `0` `NULL` 이어야 `NULL` .
`[in] aCallback`	Link Metrics가있는 Enhanced Ack를 수신 할 때 호출되는 함수에 대한 포인터.
`[in] aCallbackContext`	애플리케이션 특정 컨텍스트에 대한 포인터.

반환 값

`OT_ERROR_NONE`	링크 메트릭 관리 요청 메시지를 성공적으로 보냈습니다.
`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`	쿼리 할 메트릭을 지정하는 플래그에 대한 포인터입니다. `aSeriesFlags` 가 `0` `NULL` 이어야 `NULL` .
`[in] aCallback`	링크 메트릭 관리 응답이 수신 될 때 호출되는 함수에 대한 포인터입니다.
`[in] aCallbackContext`	애플리케이션 특정 컨텍스트에 대한 포인터.

반환 값

`OT_ERROR_NONE`	링크 메트릭 관리 요청 메시지를 성공적으로 보냈습니다.
`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`	Link Probe 메시지를 성공적으로 보냈습니다.
`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