OpenThread CLI 개요

OpenThread CLI는 명령줄 인터페이스에서 구성 및 관리 API를 노출합니다. OT CLI를 사용하여 OpenThread 개발 환경을 만들거나 추가 애플리케이션 코드가 포함된 도구로 사용할 수 있습니다. 예를 들어 OpenThread 테스트 스크립트는 CLI를 사용하여 테스트 사례를 실행합니다.

시작하기

Docker로 시뮬레이션 Codelab을 완료하고 CLI 명령어 참조를 검토합니다.

시뮬레이션 Codelab으로 이동 CLI 명령어 참조로 이동

OT CLI 사용

OTBR (OpenThread Border Router) 및 스레드 기기와 함께 사용할 수 있습니다. CLI 명령어는 기기 유형 및 빌드 플래그에 따라 달라집니다.

OTBR

OTBR과 함께 OT CLI를 사용하려면 각 명령어 앞에 다음 프리픽스를 입력하세요.

sudo ot-ctl

스레드 기기

스레드 기기에서 CLI 명령어를 사용하려면 플랫폼 문서, Codelab 또는 가이드를 참조하세요. 예를 들어 프리픽스 없이 명령어를 입력할 수 있습니다.

state
router
Done

다음은 시작하는 데 도움이 되는 몇 가지 리소스입니다.

특수문자

공백 문자 (' ')는 탭 이름 ('\t') 및 새 줄 문자('\r', '\n')와 함께 명령어 이름과 다른 인수를 구분하는 데 사용됩니다.

일부 인수에는 스레드 네트워크 이름과 같은 공백이 포함될 수 있습니다. 공백이 포함된 인수를 전송하려면 백슬래시 문자('\')를 사용하여 구분자 또는 백슬래시 자체를 이스케이프합니다.

networkname Test\ Network
Done
networkname
Test Network
Done

인수 매핑

OT CLI는 API 구성 값에 해당하는 사전 정의된 인수를 사용합니다. 이러한 매핑은 CLI 명령어로 전달할 수 있으며, 다양한 네트워크 데이터 명령어(예: netdatashow)의 경우 CLI 콘솔로 돌아갈 수도 있습니다.

otBorderRouterConfig

일부 명령어(예: prefix add)에는 otBorderRouterConfig 값이 필요합니다. 명령줄에서 otBorderRouterConfig 구성원을 설정하기 위해 OT CLI는 각 구성원의 매핑된 문자 인수를 파싱합니다. 예를 들어 인수 조합 paros은 mPreferred, mSlaac, mDefaultRoute, mOnMesh 및 mStable 멤버를 연속으로 설정합니다.

문법

다음 예에서는 prefix가 필요하며 otBorderRouterConfig 인수는 선택사항이며 p, a, d, c, r, o, s, n, D로 매핑됩니다.

prefix add prefix [padcrosnD]

사용

인수 매핑을 사용하려면 문자 사이에 공백을 입력하지 마세요.

prefix add 2001:dead:beef:cafe::/64 paros

otRoutePreference

otRoutePreference를 설정하려면 OT CLI 명령어에서 high, med 또는 low를 사용합니다.

문법

prefix add prefix [padcrosnD] [high|med|low]

사용

다음은 매핑된 otBorderRouterConfig 및 otRoutePreference 매개변수를 사용하는 예입니다.

prefix add 2001:dead:beef:cafe::/64 paros med
Done

otExternalRouteConfig

otExternalRouteConfig 값의 경우 s는 mStable에, n은 mNat64에 매핑됩니다.

문법

publish route prefix [sn]

사용

route add 2001:dead:beef:cafe::/64 s
Done

반환 값

대부분의 명령어는 요청된 값을 반환한 다음 Done를 반환합니다.

br onlinkprefix
fd41:2650:a6f5:0::/64
Done

네트워크 데이터를 포함하는 다른 명령어는 프리픽스, 경로, 서비스 레코드의 인수 매핑을 반환할 수 있습니다. 자세한 내용은 OT CLI로 네트워크 데이터 표시 및 관리를 참고하세요.