TREL - 스레드 스택

이 모듈에서는 Thread Over Infrastructure용 스레드 무선 캡슐화 링크 (TREL) API를 정의합니다.

요약

이 모듈의 함수에는 OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE를 사용 설정해야 합니다.

Typedef
otTrelPeer typedef
struct otTrelPeer
TREL 피어를 나타냅니다.
otTrelPeerIterator typedef
uint16_t
TREL 피어 테이블 항목을 반복하기 위한 반복자를 나타냅니다.

함수
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
피어 테이블 항목을 반복하고 테이블에서 다음 항목을 가져옵니다.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
피어 테이블 반복자를 초기화합니다.
otTrelIsEnabled(otInstance *aInstance)
bool
TREL 작업이 사용 설정되어 있는지 여부를 나타냅니다.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
필터 모드가 사용 설정되었는지 여부를 나타냅니다.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
TREL 작업을 사용 설정하거나 중지합니다.
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
필터 모드를 설정합니다 (필터링 사용/사용 안함).

구조체
otTrelPeer

TREL 피어를 나타냅니다.

Typedef

otTrelPeer

struct otTrelPeer otTrelPeer

TREL 피어를 나타냅니다.

otTrelPeerIterator에서 상속되는 메소드

uint16_t otTrelPeerIterator

TREL 피어 테이블 항목을 반복하기 위한 반복자를 나타냅니다.

함수

otTrelGetNextPeer

const otTrelPeer * otTrelGetNextPeer(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

피어 테이블 항목을 반복하고 테이블에서 다음 항목을 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스
[in] aIterator
이터레이터입니다. 초기화되어야 합니다(MUST).
반환
다음 otTrelPeer 항목에 대한 포인터이며, 테이블에 더 이상 항목이 없다면 NULL입니다.

otTrelInitPeerIterator에서 상속되는 메소드

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

피어 테이블 반복자를 초기화합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스
[in] aIterator
초기화할 반복기입니다.

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

TREL 작업이 사용 설정되어 있는지 여부를 나타냅니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스
반환 값
TRUE
TREL 작업이 사용 설정된 경우
FALSE
TREL 작업이 사용 중지된 경우

otTrelIsFilterEnabled 함수

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

필터 모드가 사용 설정되었는지 여부를 나타냅니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스
반환 값
TRUE
TREL 필터 모드가 사용 설정된 경우.
FALSE
TREL 필터 모드가 사용 중지된 경우

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

TREL 작업을 사용 설정하거나 중지합니다.

aEnable이 true인 경우 이 함수는 로컬 탐색 도메인 내 "_trel._udp" 서비스 이름에 대해 진행 중인 DNS-SD 탐색을 시작하여 TREL을 지원하는 다른 기기를 검색합니다. 또한 기기는 DNS-SD를 사용하여 광고할 새 서비스를 등록합니다. 이때 서비스 이름은 '_trel._udp'이며 TREL 지원을 나타냅니다. 그러면 기기는 피어로부터 TREL 메시지를 수신할 수 있습니다.

aEnable이 false이면 이 함수는 서비스 이름 '_trel._udp'에서 DNS-SD 탐색을 중지하고 TREL DNS-SD 서비스 광고를 중지하며 TREL 피어 테이블을 지웁니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aEnable
TREL 작업을 사용 설정/사용 중지하는 부울입니다.

otTrelSetFilterEnabled 사용

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

필터 모드를 설정합니다 (필터링 사용/사용 안함).

필터 모드가 사용 설정되면 TREL 인터페이스를 통한 모든 rx 및 tx 트래픽이 자동으로 삭제됩니다. 주로 테스트 중에 사용됩니다.

TREL 작업을 완전히 시작/중지하는 otTrel{Enable/Disable}()와 달리 필터 모드가 사용 설정되면 TREL 인터페이스가 계속 사용 설정됩니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스
[in] aFiltered
필터 모드를 사용 설정하려면 TRUE, 필터 모드를 사용 중지하려면 FALSE로 설정합니다.

자료

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