Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

링크 측정항목

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

요약

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

Typedef
otLinkMetricsEnhAckFlags typedef
향상된 ACK 플래그
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
이 함수 포인터는 Enh-ACK 프로브 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
이 구조는 정방향 추적 시리즈에 포함된 프레임을 나타냅니다.
otLinkMetricsStatus typedef
연결 측정항목 상태 값
otLinkMetricsValues typedef
이 구조는 링크 측정항목 쿼리의 결과 (값)를 나타냅니다.

함수
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
이 함수는 MLE 링크 측정항목 관리 요청을 전송하여 향상된 ACK 기반 프로브를 구성/삭제합니다.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
이 함수는 정방향 추적 시리즈를 구성/삭제하기 위해 MLE 링크 측정항목 관리 요청을 보냅니다.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
이 함수는 MLE 데이터 요청을 전송하여 링크 측정항목을 쿼리합니다.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
이 함수는 MLE 링크 프로브 메시지를 보냅니다.

구조체
otLinkMetricsSeriesFlags

이 구조는 정방향 추적 시리즈에 포함된 프레임을 나타냅니다.

otLinkMetricsValues

이 구조는 링크 측정항목 쿼리의 결과 (값)를 나타냅니다.

열거

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

향상된 ACK 플래그

이러한 유형은 Pro-ACK 기반 프로브에서 프로빙을 등록 또는 삭제할지 여부를 나타내는 데 사용됩니다.

속성
OT_LINK_METRICS_ENH_ACK_CLEAR

명확성

OT_LINK_METRICS_ENH_ACK_REGISTER

등록

otLinkMetricsStatus

 otLinkMetricsStatus

연결 측정항목 상태 값

Typedef

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

향상된 ACK 플래그

이러한 유형은 Pro-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, 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
쿼리할 측정항목을 지정하는 플래그 포인터 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
인접 항목은 스레드 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
인접 항목은 스레드 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
Link Probe 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 기기가 아니며 링크 측정항목을 지원하지 않습니다.

리소스

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