Посмотреть исходный код на GitHub
OpenThread CLI предоставляет API-интерфейсы настройки и управления из интерфейса командной строки. Используйте OT CLI для создания среды разработки OpenThread или используйте его как инструмент с дополнительным кодом приложения. Например, тестовые сценарии OpenThread используют CLI для выполнения тестовых случаев.
Начать
Завершите нашу лабораторную работу по моделированию кода с помощью Docker и просмотрите Справочник по командам CLI.
Перейти к кодовой лаборатории моделирования. Перейти к справочнику по командам CLI.
Используйте OT CLI
Вы можете использовать OT CLI с пограничным маршрутизатором OpenThread (OTBR) и устройствами Thread. Команды CLI будут различаться в зависимости от типа вашего устройства и флагов сборки.
ОТБР
Чтобы использовать OT CLI с OTBR , введите следующий префикс перед каждой командой:
sudo ot-ctl
Резьбовые устройства
Чтобы использовать команды CLI на устройстве Thread, обратитесь к документации платформы, кодовой лаборатории или руководству. Во многих примерах вы можете начать вводить команды без префикса:
state
router
Done
Вот несколько ресурсов, которые помогут вам начать:
- Обзор платформ OpenThread
- Скандинавская лаборатория аппаратного обеспечения
- Лаборатория аппаратного обеспечения Silicon Labs
- Примеры платформ на GitHub
Специальные символы
Символ пробела ( ' ' ) используется для разделения имени команды и различных аргументов, а также символов табуляции ( '\t' ) и символов новой строки ( '\r' , '\n' ).
Некоторые аргументы могут содержать пробелы, например имя сети потоков. Чтобы отправить аргументы, содержащие пробелы, используйте символ обратной косой черты ( '\' ), чтобы избежать разделителей или самой обратной косой черты:
networkname Test\ NetworkDonenetworknameTest Network Done
Сопоставления аргументов
OT CLI использует предопределенные аргументы, соответствующие значениям конфигурации API. Эти сопоставления могут передаваться с помощью команд CLI, а также могут возвращаться в консоль CLI для различных команд сетевых данных, например netdata show .
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 , используйте high , med или low в командах OT CLI.
Синтаксис
prefix add prefix [padcrosnD] [high|med|low]
Использование
Ниже приведен пример использования сопоставленных параметров otBorderRouterConfig и otRoutePreference :
prefix add 2001:dead:beef:cafe::/64 paros med
Done
отекстерналрутеконфиг
Для значений 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 .