OT CLI を使用したデータセットの表示と管理

<ph type="x-smartling-placeholder"></ph> GitHub のソースを表示

スレッドのネットワーク構成パラメータは、「アクティブ」と「保留中」を使用して管理されます Operational Dataset オブジェクトOT CLI には、アクティブ ビューを取得および設定するコマンドが 保留中のデータセットが表示されます。

警告 - 本番環境での使用に関する制限

アクティブおよび保留中のオペレーショナル データセットの書き込みまたは変更を行う CLI コマンドで、無効なパラメータの設定が許可されていることがある。 パラメータの組み合わせが無効です。次の CLI コマンドのみを使用できます。

  • 新しく作成された Thread ネットワークの最初のデバイスのネットワーク パラメータを設定する場合。
  • テスト用（製品版デバイスには適用されません）。

本番環境の Thread ネットワークでは、オペレーショナル データセットの書き込みや変更を行う正しい方法は、 コミッショナー コミッショニングを実行する Compute Engine API。 アクティブなコミッショナーではなく、 Thread ネットワークでは、運用データセットをいかなる方法でも変更してはなりません。

アクティブな運用データセット

アクティブな運用データセットには、現在使用されているパラメータが含まれている Thread ネットワーク全体で 自動的に行われます有効な運用データセットには、以下が含まれます。

  • アクティブなタイムスタンプ
  • チャンネル
  • チャンネル マスク
  • 拡張 PAN ID
  • メッシュローカル接頭辞
  • ネットワーク名
  • PAN ID
  • PSKc
  • セキュリティ ポリシー

デバイスを Thread ネットワークの完全なメンバーとして簡単に設定するには、 datasetactive -x コマンドを使用して 16 進エンコードされた TLV を取得し、 dataset set_active コマンドを 新しいデバイスにデータセットを設定します。

既存のデバイスで、16 進数でエンコードされた TLV を取得します。

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

新しいデバイスで、アクティブなデータセットを設定します。

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

保留中の運用データセット

保留中の運用データセットは、 運用データセットを事前に作成しておく必要があります。保留中の運用データセット には、Active Operational Dataset のすべてのパラメータと、 追加:

  • 遅延タイマー
  • 保留中のタイムスタンプ

始める

コマンドラインからデータセットを管理するには、 CLI コマンド リファレンスを確認する。

シミュレーションの Codelab に移動

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 を示します。

こちらは、Security Policy CLI の引数および 各引数に対応する otSecurityPolicy メンバー:

dataset securitypolicy の get コマンドと set コマンドでも、同じ引数が使用されます。 たとえば、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 を渡して 16 進数値を使用することもできます。 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