Посмотреть исходный код на GitHub
Параметры конфигурации сети потоков управляются с помощью объектов активного и ожидающего набора рабочих данных. OT CLI включает команды для получения и установки активных и ожидающих наборов данных.
ВНИМАНИЕ - Ограничения по производственному использованию!
Команды CLI для записи или изменения активных и ожидающих операционных наборов данных могут допускать установку недопустимых параметров или недопустимых комбинаций параметров в целях тестирования. Эти команды CLI можно использовать только:
- Чтобы настроить сетевые параметры для первого устройства во вновь созданной сети Thread.
- Для тестирования (не применимо к серийным устройствам).
В производственных сетях Thread правильный метод записи или изменения наборов рабочих данных — через уполномоченного , который выполняет ввод в эксплуатацию . Производственные устройства, которые не являются активными комиссарами и являются частью сети Thread, НЕ ДОЛЖНЫ каким-либо образом изменять наборы рабочих данных.
Активный набор эксплуатационных данных
Активный набор операционных данных включает параметры, которые в настоящее время используются во всей сети потоков. Активный набор эксплуатационных данных содержит:
- Активная временная метка
- Канал
- Маска канала
- Расширенный PAN-идентификатор
- Mesh-локальный префикс
- Имя сети
- PAN-идентификатор
- ПСКк
- Политика безопасности
Чтобы легко настроить устройство так, чтобы оно стало полноправным членом сети Thread, вы можете использовать команду dataset active -x для получения TLV в шестнадцатеричной кодировке, а также команду dataset set active для установки набора данных на новом устройстве.
На существующем устройстве получите TLV в шестнадцатеричной кодировке:
dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done
На новом устройстве установите активный набор данных:
dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done
Ожидаемый набор операционных данных
Ожидающий набор операционных данных используется для передачи изменений в активный набор операционных данных до того, как они вступят в силу. Ожидающий набор эксплуатационных данных содержит все параметры из активного набора эксплуатационных данных, а также:
- Таймер задержки
- Ожидается отметка времени
Начать
Чтобы управлять наборами данных из командной строки, выполните нашу лабораторную работу по моделированию кода с помощью Docker и просмотрите Справочник по командам CLI.
Перейти к лаборатории моделирования
Перейти к справочнику команд CLI.
Чтобы получить список команд dataset , введите help :
dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
Done
Сопоставления аргументов
Политика безопасности
Команды политики безопасности используют сопоставления аргументов для получения и установки членов otSecurityPolicy . Например, dataset active :
dataset active
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done
В этом примере Security Policy: 0 указывает mRotationTime .
Ниже приведен список всех аргументов CLI политики безопасности и соответствующий член otSecurityPolicy для каждого аргумента:
-
o: mObtainNetworkKeyEnabled -
n: mNativeCommissioningEnabled -
r: mRoutersEnabled -
c: mExternalCommissioningEnabled -
b: mBeaconsEnabled -
C: mCommercialCommissioningEnabled -
e: mAutonomousEnrollmentEnabled -
p: mNetworkKeyProvisioningEnabled -
R: mNonCcmRoutersEnabled
Команды get и set dataset securitypolicy также используют одни и те же сопоставления аргументов, например, установка securitypolicy и передача o , n , r и c :
dataset securitypolicy 672 onrc
Done
Компоненты набора данных и команды mgmt
Наряду с другими параметрами mgmtgetcommand и mgmtsetcommand для активных и ожидающих наборов данных позволяют получать и устанавливать любую комбинацию otOperationalDatasetComponents :
-
activetimestamp -
pendingtimestamp -
networkkey -
networkname -
extpanid -
localprefix -
delaytimer -
panid -
channel -
securitypolicy
Для mgmtgetcommand вы можете указать эти компоненты в любом порядке, чтобы получить соответствующие значения. При желании вы также можете передать -x , чтобы использовать шестнадцатеричную строку, которая рассматривается как представление последовательности байтов TLV. Это могут быть TLV, зависящие от поставщика, которые вы, возможно, захотите добавить в дополнение к другим параметрам.
mgmtgetcommand также позволяет при необходимости указать IPv6-адрес лидера. В противном случае используется лидер ALOC.
dataset mgmtgetcommand {active|pending} [address leader-address] [dataset-components] [-x tlv-list] Например, чтобы получить activetimestamp и securitypolicy , используйте следующие аргументы:
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
Чтобы установить компоненты, вы также можете указать компоненты набора данных в любом порядке, после чего следует значение компонента.
dataset mgmtgetcommand {active|pending} [dataset-components] [-x tlv-list] Чтобы установить activetimestamp и securitypolicy , используйте следующие аргументы:
dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done