링크 측정항목

이 모듈에는 링크 측정항목 프로토콜을 제어하는 함수가 포함되어 있습니다.

요약

열거
otLinkMetricsEnhAckFlags{   OT_LINK_METRICS_ENH_ACK_CLEAR = 0,   OT_LINK_METRICS_ENH_ACK_REGISTER = 1 }	enum 향상된 ACK 플래그.
otLinkMetricsStatus	enum 측정항목 상태 값을 연결합니다.

Typedef
otLinkMetricsEnhAckFlags	typedef enum otLinkMetricsEnhAckFlags 향상된 ACK 플래그.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)	typedef void(* Enh-ACK 프로브 IE가 수신되면 포인터가 호출됩니다.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext)	typedef void(* 링크 측정항목 관리 응답이 수신되면 포인터가 호출됩니다.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus 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 향상된 ACK 기반 프로브를 구성/지우기 위해 MLE 링크 측정항목 관리 요청을 전송합니다.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)	otError MLE 링크 측정항목 관리 요청을 전송하여 순방향 추적 시리즈를 구성하거나 삭제합니다.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)	otError 확장 주소를 기준으로 이웃의 링크 측정항목 데이터를 가져옵니다.
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)	void 링크 측정항목 관리자를 사용 또는 사용 중지합니다.
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 프로브 IE가 수신되면 포인터가 호출됩니다.

세부정보
매개변수	[in] aShortAddress 조사 대상의 Mac 짧은 주소입니다. [in] aExtAddress 조사 대상의 Mac 확장 주소에 대한 포인터입니다. [in] aMetricsValues IE에서 가져온 링크 측정항목 값에 대한 포인터입니다. [in] aContext 애플리케이션별 컨텍스트에 대한 포인터입니다.

otLinkMetricsMgmtResponseCallback

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

링크 측정항목 관리 응답이 수신되면 포인터가 호출됩니다.

세부정보
매개변수	[in] aSource 소스 주소를 가리키는 포인터입니다. [in] aStatus 응답의 상태 코드입니다. [in] aContext 애플리케이션별 컨텍스트에 대한 포인터입니다.

otLinkMetricsReportCallback

void(* otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus 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
)

향상된 ACK 기반 프로브를 구성/지우기 위해 MLE 링크 측정항목 관리 요청을 전송합니다.

이 기능을 사용하려면 OT_LINK_METRICS_INITIATOR 기능을 사용 설정해야 합니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스를 가리키는 포인터입니다. [in] aDestination 대상 주소를 가리키는 포인터입니다. [in] aEnhAckFlags 프로브를 등록할지 아니면 지울지 나타내는 Enh-ACK 플래그입니다. 0는 지우고 1는 등록합니다. 다른 값은 예약되어 있습니다. [in] aLinkMetricsFlags 쿼리할 측정항목을 지정하는 플래그에 대한 포인터입니다. aEnhAckFlags이 0이면 NULL이어야 합니다. [in] aCallback 링크 측정항목을 사용한 향상된 확인이 수신될 때 호출되는 함수에 대한 포인터입니다. [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 인접 항목은 Thread 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이어야 합니다. [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 인접 항목은 Thread 1.2 기기가 아니며 링크 측정항목을 지원하지 않습니다.

otLinkMetricsManagerGetMetricsValueByExtAddr

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

확장 주소를 기준으로 이웃의 링크 측정항목 데이터를 가져옵니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스를 가리키는 포인터입니다. [in] aExtAddress 조사 대상의 Mac 확장 주소에 대한 포인터입니다. [out] aLinkMetricsValues 주제의 링크 측정항목 값에 대한 포인터입니다.
반환 값	OT_ERROR_NONE 링크 측정항목 데이터를 가져왔습니다. OT_ERROR_INVALID_ARGS 인수가 잘못되었습니다. OT_ERROR_NOT_FOUND 지정된 확장 주소를 가진 이웃을 찾을 수 없습니다.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

링크 측정항목 관리자를 사용 또는 사용 중지합니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스를 가리키는 포인터입니다. [in] aEnable 사용 또는 사용 중지를 나타내는 부울입니다.

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 인접 항목은 Thread 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 인접 항목은 Thread 1.2 기기가 아니며 링크 측정항목을 지원하지 않습니다.

자료

OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.