ba エフェメラルキー
エフェメラル鍵が現在アクティブかどうかを示します。
OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
が必要です。
パラメータ
パラメータなし。
例
ba ephemeralkey
active
Done
CLI と API リファレンス
ba ephemeralkey コールバック(enable、disable)
エフェメラル鍵の使用に関連する変更を通知するために Border Agent が使用するコールバック関数を設定します。
OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
が必要です。
この関数の後続の呼び出しでは、以前に設定されたコールバックが置き換えられます。
パラメータ
パラメータなし。
例
ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive
CLI と API リファレンス
ba エフェメラルキーを消去
使用中のエフェメラル鍵をキャンセルします。
OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
が必要です。
以前に設定したエフェメラル鍵をタイムアウト前にキャンセルするために使用できます。Border エージェントが実行されていない場合、または使用されているエフェメラル キーがない場合は、この関数を呼び出しても効果はありません。
コミッショナーがエフェメラル キーを使用して接続され、現在アクティブな場合、この関数を呼び出しても状態は変更されません。この場合、コミッショナーが切断されるまで、
otBorderAgentIsEphemeralKeyActive()
は TRUE
を返し続けます。
パラメータ
パラメータなし。
例
ba ephemeralkey clear
Done
CLI と API リファレンス
ba ephemeralkey set [timeout-in-msec] [ポート]
指定されたタイムアウト期間でエフェメラル鍵を設定します。
OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
が必要です。
エフェメラル鍵は、Border Agent がすでに実行されていて、現在外部のコミッショナーに接続されていない場合(つまり、OT_BORDER_AGENT_STATE_STARTED
状態)に設定できます。それ以外の場合は、OT_ERROR_INVALID_STATE
が返されます。
指定された aKeyString
はエフェメラル PSK として直接使用されます(末尾の null の \0
文字を除く)。aKeyString
の長さは OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH
~OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH
でなければなりません。
以前に設定した鍵がタイムアウトする前にエフェメラル鍵を再度設定すると、以前に設定した鍵が置き換えられ、タイムアウトがリセットされます。
タイムアウト間隔が有効になっている間は、外部のコミッショナーがエフェメラル鍵を接続のために 1 回だけ使用できます。コミッショナーが切断されると、エフェメラル鍵は消去され、Border Agent は PSKc を使用するように戻ります。
パラメータ
パラメータなし。
例
ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done
CLI と API リファレンス
ba id (get、set)
複数の BR の中でデバイスを一意に識別できる 16 バイトのボーダー ルーター ID を取得または設定します。
パラメータ
ba id [border-agent-id]
オプションの border-agent-id
引数を使用して、ボーダー エージェント ID を設定します。
例
ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done
CLI と API リファレンス
Ba ポート
Thread Border Agent サービスの UDP ポートを取得します。
パラメータ
パラメータなし。
例
ba port
49153
Done
CLI と API リファレンス
Ba 状態
Thread Border Agent ロールの otBorderAgentState を取得します。
パラメータ
パラメータなし。
例
ba state
Started
Done
CLI と API リファレンス
BBR
Thread デバイスの現在のプライマリ バックボーン ルーター情報を返します。
パラメータ
パラメータなし。
例
bbr
BBR Primary:
server16: 0xE400
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
bbr
BBR Primary: None
Done
CLI と API リファレンス
- 関連付けられている API はありません
bbr 構成(設定)
ローカル バックボーン ルーターの構成 otBackboneRouterConfig を設定します。
プライマリ バックボーン ルーターの BBR データセットが変更されると、サーバー データ リクエスト メッセージ SRV_DATA.ntf
が自動的に開始されます。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
バックボーン ルーター サービスをセカンダリ バックボーン ルーターのリーダーに登録するには、bbr register
を明示的に発行する必要があります。
パラメータ
bbr config [seqno seqno] [delay delay] [timeout timeout]
例
bbr config seqno 20 delay 30
Done
CLI と API リファレンス
BBR の設定
ローカル バックボーン ルーターの構成を取得します。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr config
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
CLI と API リファレンス
BBR の無効化
バックボーン機能を有効または無効にします。
有効にすると、Thread ネットワーク データにバックボーン ルーター サービスがない場合、接続されたデバイスに対してサーバー データ リクエスト メッセージ SRV_DATA.ntf
がトリガーされます。
無効の場合、バックボーン ルーターがプライマリ状態になると SRV_DATA.ntf
がトリガーされます。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr disable
Done
CLI と API リファレンス
BBR の有効化
バックボーン機能を有効または無効にします。
有効にすると、Thread ネットワーク データにバックボーン ルーター サービスがない場合、接続されたデバイスに対してサーバー データ リクエスト メッセージ SRV_DATA.ntf
がトリガーされます。
無効の場合、バックボーン ルーターがプライマリ状態になると SRV_DATA.ntf
がトリガーされます。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr enable
Done
CLI と API リファレンス
BBR ジッター(get、set)
バックボーン ルーター登録のジッター(秒単位)を取得または設定します。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
パラメータ
bbr jitter [jitter]
例
bbr jitter
20
Done
bbr jitter 10
Done
CLI と API リファレンス
BBR MGMT DUA
このコマンドは、meshLocalIid
を含めて、次回の DUA 登録のレスポンス ステータスを設定します。meshLocalIid
を使用しない場合、指定された status
または coap-code
で次の DUA.req に応答します。
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合に使用できます。
パラメータ
bbr mgmt dua status|coap-code [meshLocalIid]
status
または coap-code
には、次のコマンドを使用します。
- 0: ST_DUA_SUCCESS
- 1: ST_DUA_REGISTER
- 2: ST_DUA_INVALID
- 3: ST_DUA_DUPLICATE
- 4: ST_DUA_NO_RESOURCES
- 5: ST_DUA_BBR_NOT_PRIMARY
- 6: ST_DUA_GENERAL_FAILURE
- 160: COAP コード 5.00
例
bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done
CLI と API リファレンス
BBR 管理 MLR リスナーの追加
秒単位のタイムアウト値を持つマルチキャスト リスナーを追加します。
デフォルトの MLR タイムアウトを使用するには、0
を渡します。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合に使用できます。
パラメータ
bbr mgmt mlr listener add ipaddress [timeout-seconds]
例
bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done
CLI と API リファレンス
Bbr mgmt MLR リスナー
otBackboneRouterMulticastListenerInfomTimeout
を持つマルチキャスト リスナーを秒単位で返します。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
と OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done
CLI と API リファレンス
BBR 管理 MLR リスナー クリア
マルチキャスト リスナーをクリアします。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr mgmt mlr listener clear
Done
CLI と API リファレンス
BBR 管理 MLR の応答
次のマルチキャスト リスナー登録に対するレスポンス ステータスを設定します。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
、OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合に使用できます。
パラメータ
bbr mgmt mlr response status-code
status-code
には、次を使用します。
- 0: ST_MLR_SUCCESS
- 2: ST_MLR_INVALID(ST_MLR_INVALID)
- 3: ST_MLR_NO_PERSISTENT
- 4: ST_MLR_NO_RESOURCES
- 5: ST_MLR_BBR_NOT_PRIMARY
- 6: ST_MLR_GENERAL_FAILURE
例
bbr mgmt mlr response 2
Done
CLI と API リファレンス
BBR レジスタ
ローカル バックボーン ルーターの構成を明示的に登録します。
接続されたデバイスに対して、サーバーデータ リクエスト メッセージ SRV_DATA.ntf
がトリガーされます。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr register
Done
CLI と API リファレンス
BBR 州
バックボーン ルーター otBackboneRouterState を取得します。
OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done
CLI と API リファレンス
br 無効
Border Routing Manager を無効にします。
パラメータ
パラメータなし。
例
br disable
Done
CLI と API リファレンス
br 有効にする
Border Routing Manager を有効にします。
パラメータ
パラメータなし。
例
br enable
Done
CLI と API リファレンス
br init
Border Routing Manager を初期化します。
パラメータ
br init infrastructure-network-index is-running
例
br init 2 1
Done
CLI と API リファレンス
br nat64prefix
ローカル NAT64 プレフィックスと優先 NAT64 プレフィックスの両方を出力します。
パラメータ
パラメータなし。
例
br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
CLI と API リファレンス
br nat64prefix あり
現在優先されている NAT64 プレフィックスを取得します。
優先 NAT64 プレフィックスは、インフラストラクチャ リンクから検出することも、このデバイスのローカル NAT64 プレフィックスを指定することもできます。
パラメータ
パラメータなし。
例
br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
CLI と API リファレンス
br nat64prefix ローカル
ボーダー ルーターのローカル NAT64 プレフィックスを取得します。
Thread ネットワークで NAT64 接頭辞がアドバタイズされない可能性があります。
OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
を有効にする必要があります。
パラメータ
パラメータなし。
例
br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done
CLI と API リファレンス
br omrprefix
ローカルと優先 OMR プレフィックスの両方を出力します。
パラメータ
パラメータなし。
例
br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done
CLI と API リファレンス
bromrprefix
現在優先されているメッシュ外ルーティング可能(OMR)接頭辞を取得します。
優先する OMR 接頭辞は、ネットワーク データから検出することも、このデバイスのローカル OMR 接頭辞から検出することもできます。
パラメータ
パラメータなし。
例
br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done
CLI と API リファレンス
bromrprefix ローカル
ローカルのメッシュ外ルーティング可能(OMR)プレフィックスを取得します(例: fdfc:1ff5:1512:5622::/64
)。
OMR 接頭辞は、ランダムに生成される 64 ビットの接頭辞で、まだ OMR 接頭辞がない場合にスレッド ネットワークで公開されます。このプレフィックスは、ローカルの Wi-Fi またはイーサネット ネットワークから到達できます。
パラメータ
パラメータなし。
例
br omrprefix local
fdfc:1ff5:1512:5622::/64
Done
CLI と API リファレンス
br onlinkprefix
ローカル プレフィックスと優先オンリンク プレフィックスの両方を出力します。
パラメータ
パラメータなし。
例
br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done
CLI と API リファレンス
br onlinkprefix あり
現在優先されているオンリンク接頭辞を取得します。
優先されるプレフィックスは、インフラストラクチャ リンクで検出されたリンク上のプレフィックスか、ローカルのオンリンク プレフィックスのいずれかです。
パラメータ
パラメータなし。
例
br onlinkprefix favored
2600::0:1234:da12::/64
Done
CLI と API リファレンス
br onlinkprefix ローカル
隣接インフラストラクチャ リンクのローカル オンリンク プレフィックスを取得します。
ローカルのオンリンク プレフィックスは、リンク上でアドバタイズされている使用可能なオンリンク プレフィックスがまだない場合に、インフラストラクチャ リンクでアドバタイズされる 64 ビットのプレフィックスです。
パラメータ
パラメータなし。
例
br onlinkprefix local
fd41:2650:a6f5:0::/64
Done
CLI と API リファレンス
br 接頭辞付きテーブル
インフラストラクチャ リンクで Border Routing Manager を使用して検出されたプレフィックスを取得します。プレフィックス エントリごとの情報:
- 接頭辞
- プレフィックスがリンク上かルートか
- この接頭辞を含むルーター アドバタイズが最後に受信されてからの経過時間(ミリ秒単位)
- プレフィックスの有効期間(秒)
- プレフィックスがオンリンクの場合のみ優先される存続期間(秒)
- プレフィックスが「route」(リンク上ではない)の場合のみルート設定(低、中、高)
- このプレフィックスをアドバタイジングするルーターの IPv6 アドレス
- 受信したルーター アドバタイズ ヘッダーのフラグ:
- M: マネージド アドレス構成フラグ
- O: その他の構成フラグ
- スタブ: スタブルーター フラグ(ルーターがスタブルーターかどうかを示します)
パラメータ
パラメータなし。
例
br prefixtable
prefix:fd00:1234:5678:0::/64, on-link:no, ms-since-rx:29526, lifetime:1800, route-prf:med,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
prefix:1200:abba:baba:0::/64, on-link:yes, ms-since-rx:29527, lifetime:1800, preferred:1800,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done
CLI と API リファレンス
br raoptions (set,clear)
出力されたルーター アドバタイズ(RA)メッセージの最後に追加するオプションを設定します。
aOptions
の内容は内部でコピーされるため、一時バッファ(スタック割り当て配列など)にできます。
その後この関数を呼び出すと、以前に設定した値が上書きされます。
パラメータ
br raoptions options|clear
br raoptions clear
が nullptr
を otBorderRoutingSetExtraRouterAdvertOptions に渡します。それ以外の場合は、options
バイトを 16 進数データとして渡すことができます。
例
br raoptions 0400ff00020001
Done
br raoptions clear
Done
CLI と API リファレンス
br rioprf(高、中、低)
インフラストラクチャ リンクを介して送信されるルーター アドバタイズ メッセージでルート情報オプション(RIO)をアドバタイズするときに使用する設定を明示的に設定します。
この関数の呼び出し後、BR はアドバタイズされたすべての RIO に指定された設定を使用します。この設定は、
otBorderRoutingClearRouteInfoOptionPreference()
を呼び出してクリアできます。
パラメータ
br rioprf [high|med|low]
例
br rioprf low
Done
CLI と API リファレンス
Br Rioprf
インフラストラクチャ リンクを介して送信されたルーター アドバタイズ メッセージでルート情報オプション(RIO)をアドバタイズするときに使用される現在の設定を取得します。
RIO の優先度は次のように決定されます。
- ユーザーが
otBorderRoutingSetRouteInfoOptionPreference()
を呼び出して明示的に設定した場合は、指定された設定が使用されます。 - それ以外の場合は、デバイスの現在の役割に基づいて判断されます。ルーター/リーダーの役割では「中」、子どもの役割では「低」です。
パラメータ
パラメータなし。
例
br rioprf
med
Done
CLI と API リファレンス
br Rioprf クリア
アドバタイズされたルート情報オプションに対して以前に設定された設定値をクリアします。
この関数が呼び出されると、BR はデバイスの役割を使用して RIO 設定(ルーター/リーダーの役割では中程度の優先、子の役割では低を優先)を決定します。
パラメータ
パラメータなし。
例
br rioprf clear
Done
CLI と API リファレンス
br routeprf(高、中、低)
ネットワーク データの公開ルートの優先度を明示的に設定します。
この関数の呼び出し後、BR は指定された設定を使用します。この設定は、
otBorderRoutingClearRoutePreference()
を呼び出してクリアできます。
パラメータ
br routeprf [high|med|low]
例
br routeprf low
Done
CLI と API リファレンス
br routeprf
ネットワーク データの公開ルートに使用されている現在の設定を取得します。
優先ルールは次のように決定されます。
- ユーザーが
otBorderRoutingSetRoutePreference()
を呼び出して明示的に設定した場合は、指定された設定が使用されます。 - それ以外の場合は、デバイスの役割とリンクの品質に基づいて
RoutingManager
によって自動的に決定されます。
パラメータ
パラメータなし。
例
br routeprf
med
Done
CLI と API リファレンス
br ルートプロフ クリア
ネットワーク データの公開ルートの設定値をクリアします。
この関数が呼び出されると、BR はデバイスの役割とリンクの品質に基づいて(エンドデバイスとして機能するときに親にとって)設定を自動的に決定します。
パラメータ
パラメータなし。
例
br routeprf clear
Done
CLI と API リファレンス
br ルーター
インフラストラクチャ リンクで Border Routing Manager によって検出されたルーターのリストを取得します。ルーターごとの情報:
- ルーターの IPv6 アドレス
- 受信したルーター アドバタイズ ヘッダーのフラグ:
- M: マネージド アドレス構成フラグ
- O: その他の構成フラグ
- スタブ: スタブルーター フラグ(ルーターがスタブルーターかどうかを示します)
パラメータ
パラメータなし。
例
br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done
CLI と API リファレンス
br 状態
Border Routing Manager の現在の状態を取得します。
パラメータ
パラメータなし。
例
br state
running
CLI と API リファレンス
バッファ情報
現在のメッセージ バッファ情報を取得します。
total
は、プール内のメッセージ バッファの合計数を表示します。free
は、空きメッセージ バッファの数を表示します。max-used
は、OT スタックの初期化または最後のbufferinfo reset
から同時に使用されているバッファの最大数を表示します。
次に、CLI は OpenThread スタックで使用されているさまざまなキューに関する情報を表示します(例: 6lo send
)。キューの後の各行は、キューに関する情報を表します。
- 最初の数字は、キューにあるメッセージの数を示します。
- 2 つ目の数字は、キュー内のすべてのメッセージで使用されているバッファの数を示します。
- 3 つ目の数字は、キュー内のすべてのメッセージの合計バイト数を示します。
パラメータ
パラメータなし。
例
bufferinfo
total: 40
free: 40
max-used: 5
6lo send: 0 0 0
6lo reas: 0 0 0
ip6: 0 0 0
mpl: 0 0 0
mle: 0 0 0
coap: 0 0 0
coap secure: 0 0 0
application coap: 0 0 0
Done
CLI と API リファレンス
バッファ情報リセット
同時に使用されている最大バッファ数を追跡するメッセージ バッファ情報カウンタをリセットします。
これにより、
otBufferInfo
の mMaxUsedBuffers
がリセットされます。
パラメータ
パラメータなし。
例
bufferinfo reset
Done
CLI と API リファレンス
ccathreshold(get、set)
IEEE 802.15.4 ~ 2015 のセクション 10.1.4 に従って、アンテナ コネクタで測定された CCA しきい値を dBm 単位で取得または設定します。
パラメータ
ccathreshold [CCA-threshold-dBm]
オプションの CCA-threshold-dBm
引数を使用して、CCA しきい値を設定します。
例
ccathreshold
-75 dBm
Done
ccathreshold -62
Done
CLI と API リファレンス
channel(get、set)
IEEE 802.15.4 チャネルの値を取得または設定します。
パラメータ
channel [channel-num]
channel-num
を使用してチャンネルを設定します。
例
channel
11
Done
channel 11
Done
CLI と API リファレンス
- 関連付けられている API はありません
チャネル マネージャー(自動)
ネットワーク チャンネルの自動チャンネル選択機能を有効または無効にします。
有効にすると、ChannelManager
は定期的に RequestChannelSelect(false)
を呼び出します。期間の間隔は
otChannelManagerSetAutoChannelSelectionInterval()
で設定できます。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
、OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager auto enable
1
は enable
に対するブール値です。
例
channel manager auto 1
channel manager auto 1
Done
CLI と API リファレンス
チャネル管理者の変更
Thread ネットワーク チャネルの変更をリクエストします。
ネットワークは、指定された遅延の後、指定されたチャンネルに切り替わります(otChannelManagerSetDelay() を参照)。チャンネルの変更は、保留中の運用データセットを更新することによって行われます。
それ以降の通話で、以前にリクエストしたチャンネル変更はキャンセルされます。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
は必須です。
パラメータ
channel manager change channel-num
例
channel manager change 11
channel manager change 11
Done
CLI と API リファレンス
チャンネル管理者
チャネル管理者の状態を取得します。OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
は必須です。
パラメータ
パラメータなし。
例
channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
CLI と API リファレンス
チャンネル管理者による遅延
ネットワーク チャンネルの変更に使用される遅延を秒単位で設定します。
FTD でのみ利用可能です。この遅延は、Thread ネットワーク内のすべての Sleepy エンドデバイスで使用される最大データ ポーリング間隔よりも長くすることが望ましい。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
と OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager delay delay-seconds
例
channel manager delay 120
channel manager delay 120
Done
CLI と API リファレンス
チャネル管理者がお気に入り
お気に入りのチャンネル マスクを設定します。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
、OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager favored mask
例
channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done
CLI と API リファレンス
チャネル マネージャーのインターバル
自動チャンネル選択機能で使用される期間間隔(秒単位)を設定します。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
、OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager interval interval-seconds
例
channel manager interval 10800
channel manager interval 10800
Done
CLI と API リファレンス
チャネル マネージャーの選択
ChannelManager
が新しいチャンネルを確認して選択し、チャンネルの変更を開始するようリクエストします。
チャンネルをパラメータとして指定する必要がある
otChannelManagerRequestChannelChange()
とは異なり、この関数は ChannelManager
に(収集されたチャンネル品質情報に基づいて)チャンネルを選択するよう求めます。
呼び出されると、チャネル管理者は次の 3 つのステップを実行します。
1)ChannelManager
は、チャンネルの変更が役立つかどうかを判断します。aSkipQualityCheck
が true に設定されている場合、このチェックはスキップできます(強制的にチャンネル選択が行われ、品質チェックはスキップされます)。このステップでは、デバイスで収集されたリンク品質指標(CCA 障害率、ネイバーあたりのフレームおよびメッセージ エラー率など)を使用して、現在のチャンネル品質がチャンネルの変更に妥当なレベルかどうかを判断します。
2)最初のステップが合格すると、ChannelManager
はより優れた可能性のあるチャネルを選択します。ChannelMonitor
モジュールで収集されたチャンネル品質データを使用します。このステップでは、サポートされているチャンネルとお気に入りのチャンネルを使用します。(
otChannelManagerSetSupportedChannels()
と
otChannelManagerSetFavoredChannels()
を参照)。
3)新しく選択されたチャンネルが現在のチャンネルと異なる場合、ChannelManager
はチャンネル変更プロセスをリクエストまたは開始します(内部で RequestChannelChange()
を呼び出します)。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
、OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager select skip-quality-check
ブール値 skip-quality-check
には 1
または 0
を使用します。
例
channel manager select 1
channel manager select 1
Done
CLI と API リファレンス
チャネル マネージャーが対応
サポートされているチャンネル マスクを設定します。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
、OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager supported mask
例
channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done
CLI と API リファレンス
チャネル マネージャーのしきい値
CCA 障害率のしきい値を設定します。
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
または OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
、OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
channel manager threshold threshold-percent
threshold-percent
には 16 進数値を使用します。0
は 0% にマッピングされ、0xffff
は 100% にマッピングされます。
例
channel manager threshold 0xffff
channel manager threshold 0xffff
Done
CLI と API リファレンス
チャンネル モニター
現在のチャンネル モニターの状態とチャンネルの占有率を取得します。OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
パラメータなし。
例
channel monitor
enabled: 1
interval: 41000
threshold: -75
window: 960
count: 10552
occupancies:
ch 11 (0x0cb7) 4.96% busy
ch 12 (0x2e2b) 18.03% busy
ch 13 (0x2f54) 18.48% busy
ch 14 (0x0fef) 6.22% busy
ch 15 (0x1536) 8.28% busy
ch 16 (0x1746) 9.09% busy
ch 17 (0x0b8b) 4.50% busy
ch 18 (0x60a7) 37.75% busy
ch 19 (0x0810) 3.14% busy
ch 20 (0x0c2a) 4.75% busy
ch 21 (0x08dc) 3.46% busy
ch 22 (0x101d) 6.29% busy
ch 23 (0x0092) 0.22% busy
ch 24 (0x0028) 0.06% busy
ch 25 (0x0063) 0.15% busy
ch 26 (0x058c) 2.16% busy
Done
CLI と API リファレンス
- 関連付けられている API はありません
チャンネル モニターの開始
チャンネル モニターを開始します。OT CLI はブール値 true
を otChannelMonitorSetEnabled に送信します。OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
パラメータなし。
例
channel monitor start
channel monitor start
Done
CLI と API リファレンス
チャンネル モニター停止
チャンネル モニターを停止します。OT CLI はブール値 false
を otChannelMonitorSetEnabled に送信します。OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
は必須です。
パラメータ
パラメータなし。
例
channel monitor stop
channel monitor stop
Done
CLI と API リファレンス
優先チャンネル
デバイスで優先される無線優先チャンネル マスクを取得します。
パラメータ
パラメータなし。
例
channel preferred
0x7fff800
Done
CLI と API リファレンス
チャネル対応
デバイスでの使用が許可されているラジオ対応のチャンネル マスクを取得します。
パラメータ
パラメータなし。
例
channel supported
0x7fff800
Done
CLI と API リファレンス
子供(id)
子 ID または RLOC16 により、接続されている子の診断情報を取得します。
パラメータ
child child-id
例
child 1
Child ID: 1
Rloc: 9c01
Ext Addr: e2b3540590b0fd87
Mode: rn
CSL Synchronized: 1
Net Data: 184
Timeout: 100
Age: 0
Link Quality In: 3
RSSI: -20
Done
CLI と API リファレンス
子リスト
関連付けられた子 ID のリストを返します。
パラメータ
パラメータなし。
例
child list
1 2 3 6 7 8
Done
CLI と API リファレンス
子テーブル
関連付けられた子の表を出力します。
パラメータ
パラメータなし。
例
child table
| ID | RLOC16 | Timeout | Age | LQ In | C_VN |R|D|N|Ver|CSL|QMsgCnt| Extended MAC |
+-----+--------+------------+------------+-------+------+-+-+-+---+---+-------+------------------+
| 1 | 0xc801 | 240 | 24 | 3 | 131 |1|0|0| 3| 0 | 0 | 4ecede68435358ac |
| 2 | 0xc802 | 240 | 2 | 3 | 131 |0|0|0| 3| 1 | 0 | a672a601d2ce37d8 |
Done
CLI と API リファレンス
Childip
MTD の子用に保存されている IP アドレスのリストを取得します。
パラメータ
パラメータなし。
例
childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done
CLI と API リファレンス
childip max(セット)
各 MTD の子がこのデバイスに親として登録できる IP アドレスの最大数を設定または復元します。
設定を消去してデフォルトに戻すには、0
を渡します。
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合に使用できます。
パラメータ
childip max count
例
childip max 2
Done
CLI と API リファレンス
childip max
各 MTD の子がこのデバイスに親として登録できる IP アドレスの最大数を取得します。
パラメータ
パラメータなし。
例
childip max
4
Done
CLI と API リファレンス
childmax(set)
現在許可されている子の最大数を設定します。
このパラメータは、スレッド プロトコル オペレーションが停止している場合にのみ設定できます。
パラメータ
childmax count
例
childmax 2
Done
CLI と API リファレンス
ChildMax
現在許可されている子の最大数を取得します。
パラメータ
パラメータなし。
例
childmax
5
Done
CLI と API リファレンス
childrouterlinks(get、set)
MLE_CHILD_ROUTER_LINKS 値を取得または設定します。
パラメータ
childrouterlinks [links]
例
childrouterlinks
16
Done
childrouterlinks 16
Done
CLI と API リファレンス
児童監督によるチェックアウト(設定)
子に対して、管理チェックのタイムアウト間隔(秒)を設定します。
パラメータ
childsupervision checktimeout timeout-seconds
例
childsupervision checktimeout 30
Done
CLI と API リファレンス
児童向け管理機能のチェックアウト
子に対する監視チェックのタイムアウト間隔(秒単位)を取得します。
デバイスがスリープ状態の子で、指定されたチェック タイムアウト内に親からの応答がない場合、再アタッチ プロセス(親との MLE の子更新リクエスト/レスポンスの交換)を開始します。
パラメータ
パラメータなし。
例
childsupervision checktimeout
30
Done
CLI と API リファレンス
子の管理間隔(設定)
お子様に対するお子様の管理間隔(秒)を設定します。
パラメータ
childsupervision interval interval-seconds
例
childsupervision interval 30
Done
CLI と API リファレンス
子の管理間隔
子に対する子管理の間隔(秒)を取得します。
お子様向けの管理機能は、管理間隔内に眠っているお子様全員にメッセージが送信されるようにするための仕組みです。管理間隔内に子へ送信がない場合、OpenThread は子管理メッセージをキューに入れて送信します。
パラメータ
パラメータなし。
例
childsupervision interval
30
Done
CLI と API リファレンス
childtimeout(セット)
子ロールで操作する場合に使用するスレッドの子タイムアウトを秒単位で設定します。
パラメータ
childtimeout timeout-seconds
例
childtimeout 300
Done
CLI と API リファレンス
子供のタイムアウト
子ロールで操作する場合に使用されるスレッドの子タイムアウト(秒単位)を取得します。
パラメータ
パラメータなし。
例
childtimeout
300
Done
CLI と API リファレンス
Coap キャンセル
CoAP サーバー上のリモート リソースに対する既存のモニタリング サブスクリプションをキャンセルします。
パラメータ
パラメータなし。
例
coap cancel
Done
CLI と API リファレンス
coap 削除
指定された CoAP リソースを削除します。
パラメータ
coap delete address uri-path [type] [payload]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)
payload
: CoAP ペイロード文字列。たとえば、hellothere
のようにします。
例
coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coap Get
CoAP サーバー上の指定された CoAP リソースに関する情報を取得します。
パラメータ
coap get address uri-path [type]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)block-
: レスポンスをブロック単位で転送する必要がある場合は、このオプションの後にブロック単位の値を続けます。有効な値はblock-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
例
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coap Observation
サブスクリプション・リクエストをトリガーします。CoAP クライアントは、CoAP サーバー上の指定されたリソースを監視して、その状態の変化の可能性を確認します。
パラメータ
coap observe address uri-path [type]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)。
例
coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
CLI と API リファレンス
- 関連付けられている API はありません
coap parameters(get,set)
コマンドがオプションのパラメータなしで実行された場合、現在の CoAP パラメータ値を取得します。
選択した構文に応じて、CoAP パラメータをデフォルト値または指定した値に設定します。
パラメータ
coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
type
: CoAP リクエストの場合はrequest
、CoAP レスポンスの場合はresponse
。パラメータがそれ以上指定されていない場合は、現在の構成が出力されます。default
: 伝送パラメータを次のデフォルト値に設定します。ack_timeout
: 2,000 ミリ秒ack_random_factor_numerator
: 3 個ack_random_factor_denominator
: 2max_retransmit
: 4
ack_timeout
: ミリ秒単位のACK_TIMEOUT
(0-UINT32_MAX)。RFC7252 をご覧ください。ack_random_factor_numerator
:ACK_RANDOM_FACTOR
分子。有効な値は 0 ~ 255 です。RFC7252 をご覧ください。ack_random_factor_denominator
:ACK_RANDOM_FACTOR
分母。有効な値は 0 ~ 255 です。RFC7252 をご覧ください。max_retransmit
:MAX_RETRANSMIT
(0 ~ 255)。RFC7252 をご覧ください。
例
coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coap Post
指定された CoAP リソースを作成します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル(CoAP)リソースへの接続のテストをご覧ください。
パラメータ
coap post address uri-path [type] [payload]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)block-
: このオプションを使用してブロックごとの値を指定すると、ペイロード用にランダムに生成されたバイト数のブロックが送信されます。有効な値はblock-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
payload
: CoAP ペイロード リクエスト。使用される場合は、type
に応じて文字列または整数になります。type
がcon
またはnon-con
の場合、payload
パラメータは省略可能です。payload
パラメータを省略すると、空のペイロードが送信されます。ただし、payload
パラメータを使用する場合、その値はhellothere
などの文字列にする必要があります。type
がblock-
の場合、payload
パラメータの値は、送信するブロック数を指定する整数にする必要があります。block-
タイプにはOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
を設定する必要があります。
例
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coap put
指定された CoAP リソースを変更します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル(CoAP)リソースへの接続のテストをご覧ください。
パラメータ
coap put address uri-path [type] [payload]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)block-
: このオプションを使用してブロックごとの値を指定すると、ペイロード用にランダムに生成されたバイト数のブロックが送信されます。有効な値はblock-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
payload
: CoAP ペイロード リクエスト。使用される場合は、type
に応じて文字列または整数になります。type
がcon
またはnon-con
の場合、payload
パラメータは省略可能です。payload
パラメータを省略すると、空のペイロードが送信されます。ただし、payload
パラメータを使用する場合、その値はhellothere
などの文字列にする必要があります。type
がblock-
の場合、payload
パラメータの値は、送信するブロック数を指定する整数にする必要があります。block-
タイプにはOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
を設定する必要があります。
例
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coap リソース(get、set)
CoAP サーバー リソースの URI パスを取得または設定します。
パラメータ
coap resource [uri-path]
例
coap resource test-resource
Done
coap resource
test-resource
Done
CLI と API リファレンス
Coap Set
CoAP サーバー上のリソースによって送信されるコンテンツを設定します。CoAP クライアントがリソースを監視している場合、そのクライアントに通知が送信されます。
パラメータ
coap set new-content
例
coap set Testing123
Done
CLI と API リファレンス
Coap スタート
CoAP サーバーを起動します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル(CoAP)リソースへの接続のテストをご覧ください。
パラメータ
パラメータなし。
例
coap start
Done
CLI と API リファレンス
Coap Stop
CoAP サーバーを停止します。
パラメータ
パラメータなし。
例
coap stop
Done
CLI と API リファレンス
Coaps 接続
ピアとの Datagram Transport Layer Security(DTLS)セッションを初期化します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
coaps connect address
address
パラメータは、ピアの IPv6 アドレスです。
例
coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected
CLI と API リファレンス
Coaps の削除
削除する CoAPS ペイロード文字列。
パラメータ
coaps delete uri-path [type] [payload]
uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)
payload
: CoAPS ペイロード リクエスト。
例
coaps delete test-resource con hellothere
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coaps 切断
DTLS セッションを停止します。
パラメータ
パラメータなし。
例
coaps disconnect
coaps disconnected
Done
CLI と API リファレンス
Coap は 得る
CoAPS サーバー上の指定された CoAPS リソースに関する情報を取得します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
coaps get uri-path [type]
uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)block-
: レスポンスをブロック単位で転送する必要がある場合は、このオプションの後にブロック単位の値を続けます。有効な値はblock-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
例
coaps get test-resource
Done
coaps get test-resource block-1024
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coaps 閉鎖済み
CoAP Secure サービスが閉じているかどうかを示します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
パラメータなし。
例
coaps isclosed
no
Done
CLI と API リファレンス
Coaps は停止
CoAP Secure サービス接続がアクティブ(すでに接続中または接続の確立中か)を示します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
パラメータなし。
例
coaps isconnactive
yes
Done
CLI と API リファレンス
Coaps は接続されています
CoAP Secure サービスが接続されているかどうかを示します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
パラメータなし。
例
coaps isconnected
yes
Done
CLI と API リファレンス
Coaps 投稿
指定された CoAPS リソースを作成します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
uri-path [type] [payload]
uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)block-
: このオプションを使用してブロックごとの値を指定すると、ペイロード用にランダムに生成されたバイト数のブロックが送信されます。有効な値はblock-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
payload
: CoAPS ペイロード リクエスト。使用される場合は、type
に応じて文字列または整数になります。type
がcon
またはnon-con
の場合、ペイロード パラメータは省略可能です。ペイロード パラメータを指定しない場合、空のペイロードが送信されます。ただし、ペイロード パラメータを使用する場合は、その値はhellothere
などの文字列にする必要があります。type
がblock-
の場合、ペイロード パラメータの値は、送信するブロック数を指定する整数にする必要があります。block-
タイプにはOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
を設定する必要があります。
例
coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coaps PSK
事前共有キー(PSK)と暗号スイート DTLS_PSK_WITH_AES_128_CCM_8 を設定します。
パラメータ
coaps psk psk-value psk-id
psk-value
: 事前共有キーpsk-id
: 事前共有キーの識別子。
例
coaps psk 1234 key1
Done
CLI と API リファレンス
CANNOT TRANSLATE
指定された CoAPS リソースを変更します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
uri-path [type] [payload]
uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可(デフォルト)block-
: このオプションを使用してブロックごとの値を指定すると、ペイロード用にランダムに生成されたバイト数のブロックが送信されます。有効な値はblock-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
payload
: CoAPS ペイロード リクエスト。使用される場合は、type
に応じて文字列または整数になります。type
がcon
またはnon-con
の場合、ペイロード パラメータは省略可能です。ペイロード パラメータを指定しない場合、空のペイロードが送信されます。ただし、ペイロード パラメータを使用する場合は、その値はhellothere
などの文字列にする必要があります。type
がblock-
の場合、ペイロード パラメータの値は、送信するブロック数を指定する整数にする必要があります。block-
タイプにはOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
を設定する必要があります。
例
coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coaps リソース(get、set)
CoAPS サーバー リソースの URI パスを取得または設定します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
coaps resource [uri-path]
例
coaps resource test-resource
Done
coaps resource
test-resource
Done
CLI と API リファレンス
Coaps セット
CoAPS サーバー上のリソースによって送信されるコンテンツを設定します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
coaps set new-content
例
coaps set Testing123
Done
CLI と API リファレンス
- 関連付けられている API はありません
Coaps 開始
CoAP Secure サービスを開始します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
coaps start [check-peer-cert | max-conn-attempts]
check-peer-cert
パラメータは、ピア証明書チェックを有効にする(デフォルト)か無効にするかを決定します。max-conn-attempts
パラメータは、CoAP Secure Server への接続の最大試行回数(成功または失敗)を設定します。このパラメータのデフォルト値は 0
です。つまり、試行回数に制限はありません。check-peer-cert
パラメータと max-conn-attempts
パラメータは次の組み合わせで連携します。ただし、指定できる引数は 1 つのみです。
- 引数なし: デフォルトが使用されます。
check-peer-cert
をtrue
に設定すると、引数を省略した場合と同じ効果があります。つまり、check-peer-cert
の値はtrue
、max-conn-attempts
の値は 0 です。check-peer-cert
をfalse
に設定:check-peer-cert
の値はfalse
、max-conn-attempts
の値は 0 です。- 数値の指定:
check-peer-cert
はtrue
、max-conn-attempts
値は引数で指定された数値です。
例
coaps start
Done
coaps start false
Done
coaps start 8
Done
CLI と API リファレンス
Coaps Stop
CoAP Secure サービスを停止します。詳細については、OT CLI を使用した制約されたアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストを参照してください。
パラメータ
パラメータなし。
例
coaps stop
Done
CLI と API リファレンス
Coaps x509
DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8
との DTLS セッションに対応する秘密鍵を使用して、ローカル デバイスの X509 証明書を設定します。
パラメータ
パラメータなし。
例
coaps x509
Done
CLI と API リファレンス
コミッショナーの発表
アナウンス開始メッセージを送信します。
パラメータ
commissioner announce mask count period destination
mask
: MLEAnnounce
メッセージを送信するためのチャンネルを識別するビットマスク。count
: チャネルあたりの MLEAnnounce
送信の数。period
: 連続する MLEAnnounce
送信間のミリ秒数。destination
: メッセージの宛先 IPv6 アドレス。メッセージはマルチキャストである可能性があります。
例
commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done
CLI と API リファレンス
Commissioner Energy
Energy Scan Query メッセージを送信します。コマンド出力は受信時に出力されます。
パラメータ
commissioner energy mask count period scanDuration destination
mask
: IEEE 802.15.4 エネルギー スキャンを実行するチャネルを識別するビットマスク。count
: チャネルあたりの IEEE 802.15.4 エネルギー スキャンの数。period
: 連続する IEEE 802.15.4 エネルギー スキャンの間隔(ミリ秒)。scanDuration
: IEEE 802.15.4 エネルギー スキャンを実行するときに使用するスキャン期間(ミリ秒単位)。destination
: メッセージの宛先 IPv6 アドレス。メッセージはマルチキャストである可能性があります。
例
commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0
CLI と API リファレンス
コミッショナー ID(get、set)
OpenThread コミッショナー ID 名を取得または設定します。
パラメータ
commissioner id name
例
commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done
CLI と API リファレンス
コミッショナー - 結合者の追加
結合エントリを追加します。
パラメータ
commissioner joiner add eui64|discerner pksd [timeout]
eui64
: Joiner の IEEE EUI-64。いずれかの結合者に一致させるには、*
を使用します。discerner
: 結合識別器(number/length
形式)。pksd
: Joiner の事前共有キー。timeout
: Joiner のタイムアウト(秒単位)。
例
commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done
CLI と API リファレンス
コミッショナー加入者の削除
Joiner エントリを削除します。
パラメータ
commissioner joiner remove eui64|discerner
eui64
: Joiner の IEEE EUI-64。いずれかの結合者に一致させるには、*
を使用します。discerner
: 結合識別器(number/length
形式)。
例
commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done
CLI と API リファレンス
Commissioner Joiner テーブル
すべての Joiner エントリをテーブル形式でリストします。
パラメータ
パラメータなし。
例
commissioner joiner table
| ID | PSKd | Expiration |
+-----------------------+----------------------------------+------------+
| * | J01NME | 81015 |
| d45e64fa83f81cf7 | J01NME | 101204 |
| 0x0000000000000abc/12 | J01NME | 114360 |
Done
CLI と API リファレンス
- 関連付けられている API はありません
コミッショナー管理
MGMT_GET
(Management Get)メッセージをリーダーに送信します。commissioner mgmtset
コマンドを使用して設定された変数値が返されます。
パラメータ
commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
locator
: ボーダー ルーター RLOC16。sessionid
: コミッショナーのセッション ID。steeringdata
: データステアリング。joinerudpport
: Joiner UDP ポート。TLVs
: 取得する TLV のセット。
例
commissioner mgmtget locator sessionid
Done
CLI と API リファレンス
コミッショナー管理セット
MGMT_SET
(管理セット)メッセージをリーダーに送信し、変数を指定した値に設定します。
パラメータ
commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
locator
: ボーダー ルーター RLOC16。sessionid
: コミッショナーのセッション ID。steeringdata
: データステアリング。joinerudpport
: Joiner UDP ポート。TLVs
: 取得する TLV のセット。
例
commissioner mgmtset joinerudpport 9988
Done
CLI と API リファレンス
コミッショナー パニド
PAN ID クエリを送信します。コマンド出力は受信時に返されます。
パラメータ
commissioner panid panid mask destination
paind
: 競合の確認に使用する PAN ID。mask
: IEEE 802.15.4 アクティブ スキャンを実行するチャネルを識別するビットマスク。destination
: メッセージの IPv6 宛先アドレス。メッセージはマルチキャストである可能性があります。
例
commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800
CLI と API リファレンス
コミッショナー プロビジョニング URL
コミッショナーのプロビジョニング URL を設定します。
パラメータ
commissioner provisioningurl provisioningurl
例
commissioner provisioningurl http://github.com/openthread/openthread
Done
CLI と API リファレンス
コミッショナー sessionid
現在のコミッショナー セッション ID を取得します。
パラメータ
パラメータなし。
例
commissioner sessionid
0
Done
CLI と API リファレンス
コミッショナー開始
Thread コミッショナー ロールを開始します。
パラメータ
パラメータなし。
例
commissioner start
Commissioner: petitioning
Done
Commissioner: active
CLI と API リファレンス
コミッショナー状態
コミッショナーの現在の状態を返します。有効な値は active
、disabled
、petition
(コミッショナーになることの申請)です。
パラメータ
パラメータなし。
例
commissioner state
active
Done
CLI と API リファレンス
コミッショナー ストップ
Thread コミッショナー ロールを停止します。
パラメータ
パラメータなし。
例
commissioner stop
Done
CLI と API リファレンス
contextreusedelay(get、set)
CONTEXT_ID_REUSE_DELAY
値を取得または設定します。
パラメータ
contextreusedelay delay
オプションの delay
引数を使用して CONTEXT_ID_REUSE_DELAY
を設定します。
例
contextreusedelay
11
Done
contextreusedelay 11
Done
CLI と API リファレンス
カウンタ(Mac)
MAC レイヤのカウンタを取得します。
パラメータ
counters mac
例
counters mac
TxTotal: 10
TxUnicast: 3
TxBroadcast: 7
TxAckRequested: 3
TxAcked: 3
TxNoAckRequested: 7
TxData: 10
TxDataPoll: 0
TxBeacon: 0
TxBeaconRequest: 0
TxOther: 0
TxRetry: 0
TxErrCca: 0
TxErrBusyChannel: 0
RxTotal: 2
RxUnicast: 1
RxBroadcast: 1
RxData: 2
RxDataPoll: 0
RxBeacon: 0
RxBeaconRequest: 0
RxOther: 0
RxAddressFiltered: 0
RxDestAddrFiltered: 0
RxDuplicated: 0
RxErrNoFrame: 0
RxErrNoUnknownNeighbor: 0
RxErrInvalidSrcAddr: 0
RxErrSec: 0
RxErrFcs: 0
RxErrOther: 0
Done
CLI と API リファレンス
カウンタ(mle)
Thread MLE カウンタを取得します。
パラメータ
counters mle
例
counters mle
Role Disabled: 0
Role Detached: 1
Role Child: 0
Role Router: 0
Role Leader: 1
Attach Attempts: 1
Partition Id Changes: 1
Better Partition Attach Attempts: 0
Parent Changes: 0
Done
CLI と API リファレンス
カウンタ
サポートされているカウンタ名を取得します。
パラメータ
パラメータなし。
例
counters
ip
mac
mle
Done
CLI と API リファレンス
- 関連付けられている API はありません
カウンタ IP
IPv6 カウンタを取得します。
パラメータ
counters ip
例
counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done
CLI と API リファレンス
カウンタ IP リセット
IPv6 カウンタをリセットします。
パラメータ
counters ip reset
例
counters ip reset
Done
CLI と API リファレンス
カウンタ MAC リセット
MAC レイヤのカウンタをリセットします。
パラメータ
counters mac reset
例
counters mac reset
Done
CLI と API リファレンス
カウンタ mle リセット
スレッド MLE カウンタをリセットします。
パラメータ
counters mle reset
例
counters mle reset
Done
CLI と API リファレンス
CSS チャネル
CSL チャネルを設定します。
パラメータ
csl channel channel
例
csl channel 20
Done
CLI と API リファレンス
CSSL
CSL 構成を取得します。
パラメータ
パラメータなし。
例
csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done
CLI と API リファレンス
CSS 期間
CSL 期間をマイクロ秒単位で設定します。
このパラメータを 0
に設定して、CSL を無効にします。
CSL 期間は OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC
の倍数でなければなりません。そうでない場合は OT_ERROR_INVALID_ARGS
が返されます。
パラメータ
csl period period
例
csl period 3000000
Done
CLI と API リファレンス
CSS タイムアウト
CSL タイムアウトを秒単位で設定します。
パラメータ
csl timeout timeout
例
cls timeout 10
Done
CLI と API リファレンス
データセットが有効です
アクティブ オペレーショナル データセットを取得します。
OT CLI は otOperationalDataset メンバーを使用してコンソールにデータセット値を返します。
パラメータ
dataset active [-x]
オプションの -x
引数は、アクティブ オペレーショナル データセットの値を 16 進数でエンコードされた TLV として出力します。
例
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
dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
CLI と API リファレンス
データセットのアクティブ タイムスタンプ(get、set)
otOperationalDataset::mActiveTimestamp を取得または設定します。
パラメータ
dataset activetimestamp [timestamp]
オプションの timestamp
引数を渡して、有効なタイムスタンプを設定します。
例
dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセット チャネル(get、set)
otOperationalDataset::mChannel を取得または設定します。
パラメータ
dataset channel [channel-num]
オプションの channel-num
引数を使用してチャネルを設定します。
例
dataset channel
12
Done
dataset channel 12
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットのチャネルマスク(get、set)
otOperationalDataset::mChannelMask を取得または設定します。
パラメータ
dataset channelmask [channel-mask]
オプションの channel-mask
引数を使用して、チャンネル マスクを設定します。
例
dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットを消去
オペレーショナル データセットのバッファをリセットします。
パラメータ
パラメータなし。
例
dataset clear
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットの commit がアクティブです
オペレーショナル データセットのバッファをアクティブなオペレーショナル データセットに commit します。
パラメータ
パラメータなし。
例
dataset commit active
Done
CLI と API リファレンス
データセットの commit 保留中
オペレーショナル データセットのバッファを保留中のオペレーショナル データセットに commit します。
パラメータ
パラメータなし。
例
dataset commit pending
Done
CLI と API リファレンス
データセットの遅延(get、set)
otOperationalDataset::mDelay を取得または設定します。
パラメータ
dataset delay [delay]
遅延タイマーの値を設定するには、オプションの delay
引数を使用します。
例
dataset delay
1000
Done
dataset delay 1000
Done
CLI と API リファレンス
データセット extpanid(get、set)
otOperationalDataset::mExtendedPanId を取得または設定します。
パラメータ
dataset extpanid [extpanid]
オプションの extpanid
引数を使用して、拡張パーソナル エリア ネットワーク ID を設定します。
例
dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done
CLI と API リファレンス
データセットのヘルプ
dataset
CLI コマンドのリストを取得します。詳細については、OT CLI を使用したデータセットの表示と管理をご覧ください。
パラメータ
パラメータなし。
例
dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
set
tlvs
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセット init(アクティブ、新規、保留中、tlvs)
OT CLI は、active
、pending
、またはtlvs
をチェックし、対応する値を返します。それ以外の場合、OT CLI は新しいランダムなネットワークを作成し、新しいデータセットを返します。
パラメータ
dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]
new
を使用して新しいデータセットを初期化し、コマンド dataset commit active
を入力します。16 進数でエンコードされた TLV には tlvs
を使用します。
例
dataset init new
Done
CLI と API リファレンス
データセットの meshlocalprefix(get、set)
otOperationalDataset::mMeshLocalPrefix を取得または設定します。
パラメータ
dataset meshlocalprefix [meshlocalprefix]
オプションの meshlocalprefix
引数を使用して、メッシュローカル プレフィックスを設定します。
例
dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットの mgmtgetcommand が有効です
MGMT_ACTIVE_GET を送信します。
OT CLI は、関連する引数を含む MGMT_ACTIVE_GET を送信します。これらのパラメータと引数マッピングの詳細については、OT CLI を使用したデータセットの表示と管理をご覧ください。
パラメータ
dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
address
を使用して IPv6 の宛先を指定します。指定しない場合は、リーダー ALOC がデフォルトで使用されます。dataset-components
には、otOperationalDatasetComponents の任意の組み合わせ(activetimestamp
、pendingtimestamp
、networkkey
など)を渡すことができます。- オプションの
-x
引数には、リクエストする未加工の TLV を指定します。
例
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done
CLI と API リファレンス
- otDatasetSendMgmtActiveGet
- dataset mgmtgetcommand pending
- データセット mgmtsetcommand アクティブ
- dataset mgmtsetcommand pending
データセットの mgmtgetcommand は保留中です
MGMT_PENDING_GET を送信します。
パラメータ
dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]
これらのパラメータと引数マッピングの詳細については、OT CLI を使用したデータセットの表示と管理をご覧ください。
例
dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done
CLI と API リファレンス
- otDatasetSendMgmtPendingGet
- データセット mgmtgetcommand 有効
- データセット mgmtsetcommand アクティブ
- dataset mgmtsetcommand pending
データセットの mgmtsetcommand が有効です
MGMT_ACTIVE_SET を送信します。
パラメータ
dataset mgmtsetcommand active [dataset-components] [-x tlv-list]
これらのパラメータと引数マッピングの詳細については、OT CLI を使用したデータセットの表示と管理をご覧ください。
例
dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done
CLI と API リファレンス
- otDatasetSendMgmtActiveSet
- データセット mgmtgetcommand 有効
- dataset mgmtgetcommand pending
- dataset mgmtsetcommand pending
データセット mgmtsetcommand 保留中
MGMT_PENDING_SET を送信します。
パラメータ
dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]
これらのパラメータと引数マッピングの詳細については、OT CLI を使用したデータセットの表示と管理をご覧ください。
例
dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done
CLI と API リファレンス
- otDatasetSendMgmtPendingSet
- データセット mgmtgetcommand 有効
- dataset mgmtgetcommand pending
- データセット mgmtsetcommand アクティブ
データセットの networkkey (get,set)
otOperationalDataset::mNetworkKey を取得または設定します。
パラメータ
dataset networkkey [key]
オプションの key
引数を使用して、ネットワーク キーを設定します。
例
dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットの networkname(get,set)
otOperationalDataset::mNetworkName を取得または設定します。
パラメータ
dataset networkname [name]
オプションの name
引数を使用して、ネットワーク名を設定します。
例
dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done
CLI と API リファレンス
データセットのパン ID(get、set)
otOperationalDataset::mPanId を取得または設定します。
パラメータ
dataset panid [panid]
オプションの panid
引数を使用して PAN ID を設定します。
例
dataset panid
0x1234
Done
dataset panid 0x1234
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットの pendingtimestamp(get、set)
otOperationalDataset::mPendingTimestamp を取得または設定します。
パラメータ
dataset pendingtimestamp [timestamp]
オプションの timestamp
引数を使用して、保留中のタイムスタンプの秒を設定します。
例
dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセット pskc (get,set)
otOperationalDataset::mPskc を取得または設定します。
パラメータ
dataset pskc [-p passphrase] | [key]
FTD の場合のみ、passphrase
引数を指定して -p
を使用します。-p
は、指定した UTF-8 でエンコードされた passphrase
から、ネットワーク名および拡張 PAN ID とともに pskc を生成します。設定されている場合、-p
はデータセット バッファを使用します。それ以外の場合は、現在のスタックを使用します。pskc を key
(16 進数形式)に設定することもできます。
例
dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセットの securitypolicy(get、set)
データセット セキュリティ ポリシーを取得または設定します。
パラメータ
dataset securitypolicy [rotationtime [onrcCepR]]
thrKeyRotation
にはrotationtime
を時間単位で使用します。- セキュリティ ポリシー コマンドは、
onrcCepR
引数マッピングを使用して otSecurityPolicy メンバーを取得して設定します。たとえば、o
は otSecurityPolicy::mGettingNetworkKeyEnabled を表します。詳細については、OT CLI を使用したデータセットの表示と管理をご覧ください。
例
dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done
CLI と API リファレンス
- 関連付けられている API はありません
データセット セット(有効、保留中)
アクティブな運用データセットを設定します。
データセットにアクティブなタイムスタンプが含まれていない場合、データセットは部分的にしか完成していません。
部分的に完全なアクティブ データセットがあるデバイスで Thread が有効になっている場合、デバイスはデータセット内の既存の情報を使用して既存の Thread ネットワークへの接続を試みます。ネットワークに接続するために必要なのは、Thread ネットワーク キーのみです。
チャネルがデータセットに含まれていない場合、デバイスは異なるチャネル間で MLE Announce メッセージを送信して、他のチャネル上の近傍を検出します。
デバイスが Thread ネットワークに正常に接続されると、デバイスは親からアクティブなデータセット全体を取得します。ルーター対応デバイスは、アクティブなデータセットが完成するまで、ルーターまたはリーダーのロールに移行しません。
CLI の dataset set
コマンドで、16 進数でエンコードされた TLV を使用してアクティブ オペレーショナル データセットを設定します。
パラメータ
dataset set {active|pending} tlvs
例
dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
CLI と API リファレンス
データセット tlvs
指定されたオペレーショナル データセットを
otOperationalDatasetTlvs
に変換します。
パラメータ
パラメータなし。
例
dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done
CLI と API リファレンス
データセット アップデータ キャンセル
進行中のオペレーショナル データセット更新リクエスト(ある場合)をキャンセルします。
OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
@dataset updater cancel
Done
CLI と API リファレンス
データセット アップデータ
進行中のオペレーション データセット更新リクエストがあるかどうかを示します。
OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
dataset updater
Enabled
Done
CLI と API リファレンス
データセット アップデータ スタート
オペレーショナル データセットの更新をリクエストします。
OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
が有効な場合に使用できます。
aDataset
には、更新するフィールドと新しい値を含める必要があります。有効または保留中のタイムスタンプのフィールドを含めることはできません。[Delay] フィールドは省略可能です。指定しない場合は、デフォルト値(1, 000 ms)が使用されます。
パラメータ
パラメータなし。
例
channel
19
Done
dataset clear
Done
dataset channel 15
Done
dataset
Channel: 15
Done
dataset updater start
Done
dataset updater
Enabled
Done
Dataset update complete: OK
channel
15
Done
CLI と API リファレンス
debug
一連の CLI コマンドを実行して、デバイスとスレッド ネットワークに関する情報を収集します。これはデバッグのためのものです。出力には、実行された各 CLI コマンドと $
の後に、対応するコマンドで生成された出力が表示されます。生成される出力には、次の情報が含まれます。
- バージョン
- 現在の状態
- RLOC16、拡張 MAC アドレス
- ユニキャストとマルチキャストの IPv6 アドレスリスト
- チャンネル
- PAN ID と拡張 PAN ID
- ネットワーク データ
- パーティション ID
- リーダーのデータ
デバイスが FTD として動作している場合:
- 子とネイバーのテーブル
- ルーター テーブルとネクストホップの情報
- アドレス キャッシュ テーブル
- 登録された MTD の子 IPv6 アドレス
- デバイスのプロパティ
デバイスが SRP クライアントをサポートし、動作している場合:
- SRP クライアントの状態
- SRP クライアント サービスとホスト情報
デバイスが SRP サーバーをサポートし、動作している場合:
- SRP サーバーの状態とアドレスモード
- SRP サーバーに登録されているホストとサービス
デバイスが TREL に対応している場合:
- TREL ステータスと類似アプリのテーブル
デバイスがボーダー ルーターをサポートしていて、ボーダー ルーターとして機能している場合:
- BR の状態
- BR プレフィックス(OMR、on-link、NAT64)
- 検出されたプレフィックスの表
パラメータ
パラメータなし。
例
CLI と API リファレンス
- 関連付けられている API はありません
delaytimermin(set)
最小遅延タイマーを秒単位で設定します。
パラメータ
delaytimermin delaytimermin
例
delaytimermin 60
Done
CLI と API リファレンス
遅延タイマーの分
最小遅延タイマー(秒単位)を取得します。
パラメータ
パラメータなし。
例
delaytimermin
30
Done
CLI と API リファレンス
detach async
detach
コマンドと同様の正常な切断プロセスを開始します。処理をブロックして、切断が完了したことを示すコールバックを待つ必要はありません。
パラメータ
パラメータなし。
例
detach async
Done
CLI と API リファレンス
detach
正常な切断プロセスを開始するには、まず他のノードに通知し(ルーターとして動作している場合は Address Release を送信し、子として動作している場合は親の子タイムアウトの値を 0 に設定します)、スレッド プロトコル オペレーションを停止します。
パラメータ
パラメータなし。
例
detach
Finished detaching
Done
CLI と API リファレンス
deviceprops(set)
デバイスのプロパティを設定します。
パラメータ
deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment
powerSupply
: 「battery」、「external」、「external-stable」、「external-unstable」にする必要があります。
例
deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply : battery
IsBorderRouter : no
SupportsCcm : no
IsUnstable : no
WeightAdjustment : -5
Done
CLI と API リファレンス
deviceprop
現在のデバイスのプロパティを取得します。
OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE
が必要です。
パラメータ
パラメータなし。
例
deviceprops
PowerSupply : external
IsBorderRouter : yes
SupportsCcm : no
IsUnstable : no
WeightAdjustment : 0
Done
CLI と API リファレンス
おすすめ
MLE 検出オペレーションを実行します。
パラメータ
discover [channel]
channel
: 検出するチャンネル。チャンネルが指定されていない場合、すべての有効なチャンネルが検索の対象となります。
例
discover
| J | Network Name | Extended PAN | PAN | MAC Address | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
CLI と API リファレンス
検出 reqcallback (有効、無効)
MLE 検出リクエスト データを受信するコールバックを設定します。
パラメータ
discover reqcallback enable|disable
例
discover reqcallback enable
Done
CLI と API リファレンス
DNS 参照
ブラウズ(サービス インスタンスの列挙)DNS クエリを送信して、指定したサービス名のサービスのリストを取得します。
service-name
の後のパラメータは省略可能です。これらのオプション パラメータに指定されていない値(またはゼロ)は、現在のデフォルト構成の値(dns config
)に置き換えられます。
パラメータ
dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
例
dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
Port:1234, Priority:1, Weight:2, TTL:7200
Host:host.example.com.
HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
TXT:[a=6531, b=6c12] TTL:7300
instance2
Port:1234, Priority:1, Weight:2, TTL:7200
Host:host.example.com.
HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
TXT:[a=1234] TTL:7300
Done
dns browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
Port:7000, Priority:0, Weight:0, TTL:10
Host:Mac-mini.default.service.arpa.
HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done
CLI と API リファレンス
DNS 圧縮(有効、無効)
「DNS 名圧縮」モードを設定します。
デフォルトでは、DNS 名の圧縮は有効になっています。無効にすると、DNS 名は完全な名前として追加され、圧縮されません。これは、OpenThread の DNS および SRP クライアント/サーバー・モジュールに適用されます。」OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
は必須です。
パラメータ
dns compression [enable|disable]
例
dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done
CLI と API リファレンス
DNS 圧縮
「DNS 名圧縮」モードが有効かどうかを示します。
これはテスト専用で、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
構成が有効な場合に使用できます。
デフォルトでは、DNS 名の圧縮は有効になっています。無効にすると、DNS 名は完全な名前として追加され、圧縮されません。これは、OpenThread の DNS および SRP クライアント/サーバー・モジュールに適用されます。」OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
は必須です。
パラメータ
dns compression [enable|disable]
例
dns compression
Enabled
CLI と API リファレンス
DNS 構成(設定)
DNS クライアントでデフォルトのクエリ構成を設定します。
NULL 以外の aConfig
の場合、呼び出し元は、
otDnsQueryConfig
インスタンスの一部のフィールドを未指定(値 0)のままにすることもできます。未指定のフィールドは、対応する OT 構成オプション定義 OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}
に置き換えられ、デフォルトのクエリ構成を形成します。
OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE
を有効にすると、デフォルト構成のサーバーの IPv6 アドレスが DNS クライアントによって自動的に設定、更新されます。これは、ユーザーが明示的に設定または指定していない場合にのみ行われます。この動作を行うには、SRP クライアントとその自動起動機能を有効にする必要があります。SRP クライアントは、Thread ネットワーク データで DNS/SRP サービス エントリをモニタリングし、SRP サーバーを選択します。選択した SRP サーバー アドレスは、デフォルトの構成で DNS サーバー アドレスとしても設定されます。
一部のフィールドは指定しない(または、値を 0 にする)ことができます。未指定のフィールドは、対応する OT 構成オプション定義 OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT
に置き換えられ、デフォルトのクエリ構成を形成します。OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
は必須です。
パラメータ
dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode]
例
dns config fd00::1 1234 5000 2 0
Done
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 3000 ms
MaxTxAttempts: 3
RecursionDesired: yes
Done
CLI と API リファレンス
DNS 構成
DNS クライアントで使用されている現在のデフォルトのクエリ構成を取得します。
OpenThread スタックが起動すると、デフォルトの DNS クエリ構成は、OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS
、_DEFAULT_SERVER_PORT
、_DEFAULT_RESPONSE_TIMEOUT
などの OT 構成オプションのセットから決定されます(関連するすべての構成オプションについては、config/dns_client.h
をご覧ください)。
この構成には、サーバーの IPv6 アドレスとポート、レスポンスのタイムアウト(ミリ秒単位)、エラーを報告するまでの最大送信試行回数、サーバーがクエリを再帰的に解決できるかどうかを示すブール値のフラグが含まれます。OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
は必須です。
パラメータ
パラメータなし。
例
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done
CLI と API リファレンス
DNS 解決
指定されたホスト名の AAAA(IPv6)レコードについて、アドレス解決 DNS クエリを送信します。
aConfig
は NULL にすることもできます。この場合、デフォルトの設定(
otDnsClientGetDefaultConfig()
から)がこのクエリの設定として使用されます。NULL 以外の aConfig
では、一部のフィールドを未指定のままにできます(値 0)。指定されていないフィールドは、デフォルト構成の値に置き換えられます。
DNS クエリを送信して、指定したホスト名の IPv6 アドレスを取得します。
ホスト名の後のパラメータは省略可能です。これらのオプション パラメータで指定されていない値(またはゼロ)は、現在のデフォルト構成(dns config)の値に置き換えられます。
DNS サーバーの IP は IPv4 アドレスで、ネットワーク データから優先 NAT64 プレフィックスを使用して IPv6 アドレスに合成されます。
パラメータ
dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
例
dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300
dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done
CLI と API リファレンス
DNS サービス
指定されたサービス インスタンスに対して DNS サービス インスタンスの解決を開始します。
OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
が有効な場合に使用できます。
aConfig
は NULL にすることもできます。この場合、デフォルトの設定(
otDnsClientGetDefaultConfig()
から)がこのクエリの設定として使用されます。NULL 以外の aConfig
では、一部のフィールドを未指定のままにできます(値 0)。指定されていないフィールドは、デフォルト構成の値に置き換えられます。
この関数は、指定されたサービス インスタンスの SRV レコードや TXT レコードのクエリを送信します。
otDnsQueryConfig
の mServiceMode
フィールドによって、クエリ対象のレコード(SRV のみ、TXT のみ、または SRV と TXT の両方)とクエリの実行方法(同じメッセージで一緒に、並列で、または最適化モードでクライアントを最初に同じメッセージを試行し、応答が得られなかった場合に個別に試行する)を指定します。
SRV レコードは、サービス ポート、優先度、重みに関する情報と、サービス インスタンスに関連付けられたホスト名を提供します。この関数は、SRV レコードから検出されたホスト名のアドレス解決を実行しません。サーバーまたはリゾルバは、SRV / TXT クエリへの応答の [Additional Data] セクションでホスト名の AAAA/A レコードを提供できます。この情報は、otDnsServiceCallback
の
otDnsServiceResponseGetServiceInfo()
を使用して取得できます。この API のユーザーは、ホストアドレスが常に
otDnsServiceResponseGetServiceInfo()
から利用できると想定してはなりません。
指定されたサービス インスタンスに対するサービス インスタンス解決 DNS クエリを送信します。最初にサービス インスタンス ラベルを指定し、次にサービス名を続けます(サービス インスタンス ラベルにはドット「.」を含めることができます)。
service-name
の後のパラメータは省略可能です。これらのオプション パラメータに指定されていない値(またはゼロ)は、現在のデフォルト構成の値(dns config
)に置き換えられます。
パラメータ
dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
例
CLI と API リファレンス
DNS サービスホスト
指定されたサービス インスタンスの DNS サービス インスタンスの解決を開始します。その際、サービス インスタンスで検出されたホスト名のフォローアップ アドレス解決の可能性も行います。
OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
が有効な場合に使用できます。
aConfig
は NULL にすることもできます。この場合、デフォルトの設定(
otDnsClientGetDefaultConfig()
から)がこのクエリの設定として使用されます。NULL 以外の aConfig
では、一部のフィールドを未指定のままにできます(値 0)。指定されていないフィールドは、デフォルト構成の値に置き換えられます。この関数は、DNS 構成の mServiceMode
が OT_DNS_SERVICE_MODE_TXT
に設定されている(つまり、TXT レコードのみをクエリする)ため使用することはできません。OT_ERROR_INVALID_ARGS
を返します。
SRV レコードと TXT レコードのクエリ送信の
otDnsClientResolveService()
と同様に動作します。ただし、サーバーまたはリゾルバが SRV クエリへの応答(追加データ セクション内)でホスト名の AAAA/A レコードを指定しなかった場合、SRV レコードから検出されたホスト名に対してホスト名の解決(AAAA クエリの送信)が実行されます。コールバック aCallback
は、すべてのクエリに対するレスポンスを受信したとき(つまり、サービスとホストのアドレスの解決が終了したとき)に呼び出されます。
特定のサービス インスタンスに対するサービス インスタンス解決 DNS クエリを、潜在的なホスト名解決とともに送信します。最初にサービス インスタンス ラベルを指定し、次にサービス名を続けます(サービス インスタンス ラベルにはドット「.」を含めることができます)。
service-name
の後のパラメータは省略可能です。これらのオプション パラメータに指定されていない値(またはゼロ)は、現在のデフォルト構成の値(dns config
)に置き換えられます。
パラメータ
dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
例
CLI と API リファレンス
domainname(set)
スレッドのドメイン名を設定します。
Thread プロトコルが無効になっている場合にのみ成功します。
パラメータ
domainname name
スペースをエスケープするには、backslash
を使用します。
例
domainname Test\ Thread
Done
CLI と API リファレンス
ドメイン名
Thread ドメイン名を取得します。
パラメータ
パラメータなし。
例
domainname
Thread
Done
CLI と API リファレンス
dua iid(set,clear)
スレッド ドメインのユニキャスト アドレスに手動で指定されたインターフェース識別子を設定またはクリアします。
OPENTHREAD_CONFIG_DUA_ENABLE
が有効な場合に使用できます。
パラメータ
dua iid iid|clear
dua iid clear
は nullptr
を otThreadSetFixedDuaInterfaceIdentifier に渡します。それ以外の場合は、iid
を渡すことができます。
例
dua iid 0004000300020001
Done
dua iid clear
Done
CLI と API リファレンス
Dua iid
スレッド ドメインのユニキャスト アドレスに手動で指定されたインターフェース識別子を取得します。
OPENTHREAD_CONFIG_DUA_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
dua iid
0004000300020001
Done
CLI と API リファレンス
eidcache
EID から RLOC へのキャッシュ エントリを返します。
パラメータ
パラメータなし。
例
eidcache
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d 2000 cache canEvict=1 transTime=0 eid=fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7f fffe retry canEvict=1 timeout=10 retryDelay=30
Done
CLI と API リファレンス
eui64
このインターフェースに対して出荷時に割り当てられた IEEE EUI-64 を取得します。
パラメータ
パラメータなし。
例
eui64
0615aae900124b00
Done
CLI と API リファレンス
extaddr(set)
IEEE 802.15.4 Extended Address を設定します。
パラメータ
extaddr extaddr
例
extaddr dead00beef00cafe
dead00beef00cafe
Done
CLI と API リファレンス
extaddr
IEEE 802.15.4 拡張アドレスを取得します。
パラメータ
パラメータなし。
例
extaddr
dead00beef00cafe
Done
CLI と API リファレンス
extpanid(set)
IEEE 802.15.4 拡張 PAN ID を設定します。
パラメータ
extpanid extpanid
例
extpanid dead00beef00cafe
Done
CLI と API リファレンス
extpanid
IEEE 802.15.4 拡張 PAN ID を取得します。
パラメータ
パラメータなし。
例
extpanid
dead00beef00cafe
Done
CLI と API リファレンス
初期状態にリセット
不揮発性メモリに保存されている設定をすべて削除してから、プラットフォームのリセットをトリガーします。
パラメータ
パラメータなし。
例
factoryreset
CLI と API リファレンス
偽物 (a,an)
疑似 Thread メッセージを送信する。
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合に使用できます。
パラメータ
fake /a/an dst-ipaddr target meshLocalIid
例
fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done
CLI と API リファレンス
fem
外部 FEM パラメータを取得します。
パラメータ
パラメータなし。
例
fem
LNA gain 11 dBm
Done
CLI と API リファレンス
fem lnagain(入手)
外部 FEM の Rx LNA ゲインを dBm 単位で取得します。
パラメータ
パラメータなし。
例
fem lnagain
11
Done
CLI と API リファレンス
fem lnagain(セット)
外部 FEM の Rx LNA ゲインを dBm 単位で設定します。
パラメータ
パラメータなし。
例
fem lnagain 8
Done
CLI と API リファレンス
履歴 ipaddr
ユニキャスト IPv6 アドレスの履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
またはRemoved
です。 - アドレス/プレフィックス長: プレフィックス長(ビット単位)のユニキャスト アドレス。
- 生成元: 値は
thread
、slaac
、dhcp6
、manual
のいずれかです。 - スコープ: IPv6 アドレス スコープ。
- P: 優先フラグ。
- V: 有効なフラグ。
- RLOC(R): このフラグは、IPv6 アドレスがルーティング ロケーターであるかどうかを示します。
パラメータ
history ipaddr [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history ipaddr
| Age | Event | Address / Prefix Length | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
| 00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:00:44.647 | Added | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:01:07.199 | Added | fd00:0:0:0:0:0:0:1/64 | manual | 14 | Y | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:fc00/64 | thread | 3 | N | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64 | thread | 3 | N | Y | N |
| 00:02:23.904 | Added | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64 | thread | 2 | Y | Y | N |
Done
history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done
CLI と API リファレンス
履歴 ippmaddr
マルチキャスト IPv6 アドレス履歴を表形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Subscribed
またはUnsubscribed
です。 - マルチキャスト アドレス
- オリジン: 値は
Thread
またはManual
です。
パラメータ
history ipmaddr [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history ipmaddr
| Age | Event | Multicast Address | Origin |
+----------------------+--------------+-----------------------------------------+--------+
| 00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:25.353 | Subscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:54.953 | Subscribed | ff03:0:0:0:0:0:0:2 | Thread |
| 00:01:54.953 | Subscribed | ff02:0:0:0:0:0:0:2 | Thread |
| 00:01:59.329 | Subscribed | ff33:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:01:59.329 | Subscribed | ff32:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:fc | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff02:0:0:0:0:0:0:1 | Thread |
Done
history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done
CLI と API リファレンス
歴史の隣人
ネイバー履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - タイプ:
Child
またはRouter
。 - イベント: 有効な値は
Added
、Removed
、Changed
です。 - 拡張アドレス
- RLOC16
- モード: MLE リンクモード。有効な値は次のとおりです。
-
: フラグが設定されていない(rx-off-when-idle、最小の Thread デバイス、安定したネットワーク データ)。r
: rx-on-when-idled
: フルスレッド デバイス。n
: 完全なネットワーク データ
- Ave RSS: エントリが記録された時点でネイバーから受信したフレームの平均数(dBm 単位)。
パラメータ
history neighbor [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history neighbor
| Age | Type | Event | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
| 00:00:29.233 | Child | Added | ae5105292f0b9169 | 0x8404 | - | -20 |
| 00:01:38.368 | Child | Removed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:27.181 | Child | Changed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:51.236 | Router | Added | 865c7ca38a5fa960 | 0x9400 | rdn | -20 |
| 00:04:51.587 | Child | Removed | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:05:22.764 | Child | Changed | ae5105292f0b9169 | 0x8401 | rn | -20 |
| 00:06:40.764 | Child | Added | 4ec99efc874a1841 | 0x8403 | r | -20 |
| 00:06:44.060 | Child | Added | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:06:49.515 | Child | Added | ae5105292f0b9169 | 0x8401 | - | -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done
CLI と API リファレンス
履歴 netinfo
ネットワーク情報の履歴を表形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - ロール: デバイスロール。有効な値は
router
、child
、detached
、disabled
です。 - モード: MLE リンクモード。有効な値は次のとおりです。
-
: フラグが設定されていない(rx-off-when-idle、最小の Thread デバイス、安定したネットワーク データ)。r
: rx-on-when-idled
: フルスレッド デバイス。n
: 完全なネットワーク データ
- RLOC16
- パーティション ID。
パラメータ
history netinfo [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history netinfo
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:00:10.069 | router | rdn | 0x6000 | 151029327 |
| 00:02:09.337 | child | rdn | 0x2001 | 151029327 |
| 00:02:09.338 | child | rdn | 0x2001 | 151029327 |
| 00:07:40.806 | child | - | 0x2001 | 151029327 |
| 00:07:42.297 | detached | - | 0x6000 | 0 |
| 00:07:42.968 | disabled | - | 0x6000 | 0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:02:05.451 | router | rdn | 0x6000 | 151029327 |
| 00:04:04.719 | child | rdn | 0x2001 | 151029327 |
Done
CLI と API リファレンス
履歴の接頭辞
メッシュ プレフィックス履歴のネットワーク データをテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
またはRemoved
です。 - 接頭辞
- フラグ/意味:
p
: 優先フラグa
: ステートレス IPv6 アドレスの自動構成フラグ。d
: DHCPv6 IPv6 アドレス構成フラグ。c
: DHCPv6 のその他の構成フラグ。r
: デフォルト ルートフラグ。o
: メッシュフラグ上。s
: 固定フラグ。n
: Nd Dns フラグ。D
: ドメイン プレフィックス フラグ。
- 優先順位: 好み値は、
high
、med
、low
のいずれかです。 - RLOC16
パラメータ
history prefix [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history prefix
| Age | Event | Prefix | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:10.663 | Added | fd00:1111:2222:3333::/64 | paro | med | 0x5400 |
| 00:01:02.054 | Removed | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:21.136 | Added | fd00:abba:cddd:0::/64 | paos | med | 0x5400 |
| 00:01:45.144 | Added | fd00:dead:beef:1::/64 | paros | high | 0x3c00 |
| 00:01:50.944 | Added | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:59.887 | Added | fd00:dead:beef:1::/64 | paros | med | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done
CLI と API リファレンス
履歴ルート
ネットワーク データの外部ルートの履歴を表形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
またはRemoved
です。 - ルート
- フラグ/意味:
s
: 固定フラグ。n
: NAT64 フラグ。
- 優先順位: 好み値は、
high
、med
、low
のいずれかです。 - RLOC16
パラメータ
history route [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history route
| Age | Event | Route | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:05.456 | Removed | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:29.310 | Added | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:42.822 | Added | fd00:1111:0::/48 | s | med | 0x5400 |
| 00:01:27.688 | Added | fd00:aaaa:bbbb:cccc::/64 | s | med | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done
CLI と API リファレンス
履歴ルーター
ルートテーブルの履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
、Removed
、NextHopChanged
、またはCostChanged
です。 - ID(RLOC16): ルーター ID とルーターの RLOC16。
- ネクストホップ: ネクストホップのルーター ID と RLOC16。ネクストホップがない場合は、
none
が表示されます。 - パスの費用: 以前の費用
->
の新しい費用。値inf
は、パスコストが無限であることを示します。
パラメータ
history router [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history router
| Age | Event | ID (RLOC16) | Next Hop | Path Cost |
+----------------------+----------------+-------------+-------------+------------+
| 00:00:05.258 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:00:08.604 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:00:11.931 | Added | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 59 (0xec00) | none | inf -> inf |
| 00:00:14.948 | Removed | 54 (0xd800) | none | inf -> inf |
| 00:00:14.948 | Removed | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 7 (0x1c00) | none | inf -> inf |
| 00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) | 1 -> 5 |
| 00:02:33.735 | NextHopChanged | 54 (0xd800) | none | 15 -> inf |
| 00:03:10.915 | CostChanged | 54 (0xd800) | 34 (0x8800) | 13 -> 15 |
| 00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) | 15 -> 13 |
| 00:03:46.188 | CostChanged | 54 (0xd800) | 59 (0xec00) | 13 -> 15 |
| 00:04:19.124 | CostChanged | 54 (0xd800) | 59 (0xec00) | 11 -> 13 |
| 00:04:52.008 | CostChanged | 54 (0xd800) | 59 (0xec00) | 9 -> 11 |
| 00:05:23.176 | CostChanged | 54 (0xd800) | 59 (0xec00) | 7 -> 9 |
| 00:05:51.081 | CostChanged | 54 (0xd800) | 59 (0xec00) | 5 -> 7 |
| 00:06:48.721 | CostChanged | 54 (0xd800) | 59 (0xec00) | 3 -> 5 |
| 00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) | 1 -> 3 |
| 00:09:28.681 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:09:31.882 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf -> 1 |
| 00:09:54.204 | Added | 54 (0xd800) | none | inf -> inf |
| 00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
| 00:10:24.242 | Added | 34 (0x8800) | none | inf -> inf |
| 00:10:41.900 | NextHopChanged | 59 (0xec00) | none | 1 -> inf |
| 00:10:42.480 | Added | 3 (0x0c00) | 3 (0x0c00) | inf -> inf |
| 00:10:43.614 | Added | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done
CLI と API リファレンス
履歴 RX
IPv6 メッセージ受信履歴を表形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - 次のように入力します。
- IPv6 メッセージ タイプ(
UDP
、TCP
、HopOpts
、ICMP6
(およびそのサブタイプ)など)。 src
: 送信元 IPv6 アドレスとポート番号。dst
: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP には有効で、それ以外の場合は 0)。
- IPv6 メッセージ タイプ(
- Len: IPv6 ペイロードの長さ(IPv6 ヘッダーを除く)。
- Chksum: メッセージ チェックサム(UDP、TCP、ICMP6 のメッセージに有効)。
- Sec: リンクレイヤ セキュリティが使用されたかどうかを示します。
- 優先度: メッセージの優先度。有効な値は、
low
、norm
、high
、またはnet
(スレッド制御メッセージの場合)です。 - RSS: メッセージを形成したすべての受信フラグメント フレームの平均受信信号強度(dBm)。TX 履歴の場合は、
NA
(適用外)が表示されます。 - Dir: メッセージが送信(
TX
)または受信(RX
)されたかどうかを示します。送信の失敗は、表形式のTX-F
またはリスト形式のtx-success:no
で示されます。送信の失敗の例としては、tx
が中断される場合や、いずれかのメッセージ フラグメントについてピアからack
が送信されない場合などがあります。 - Neighb(ネイブ): メッセージが送受信されたネイバーの短いアドレス(RLOC16)。フレームがブロードキャストされた場合は、表形式では
bcast
、リスト形式では0xffff
として表示されます。ネイバーの短いアドレスが使用できない場合は、テーブル形式ではunknwn
、リスト形式では0xfffe
として表示されます。 - Radio: メッセージが送受信されたラジオリンク(
OPENTHREAD_CONFIG_MULTI_RADIO
が有効な場合に有用)。15.4
、trel
、またはall
(すべてのラジオリンクで送信される場合)になります。
パラメータ
history rx [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history rx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xbd26 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x3f7d | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0x942c | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
| | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x2e37 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xe177 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0x82ee | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0x52df | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x5ccf | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
Done
history rx list 4
00:00:13.368
type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done
CLI と API リファレンス
履歴: x
IPv6 メッセージの RX および TX 履歴を結合したものを、表形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - 次のように入力します。
- IPv6 メッセージ タイプ(
UDP
、TCP
、HopOpts
、ICMP6
(およびそのサブタイプ)など)。 src
: 送信元 IPv6 アドレスとポート番号。dst
: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP には有効で、それ以外の場合は 0)。
- IPv6 メッセージ タイプ(
- Len: IPv6 ペイロードの長さ(IPv6 ヘッダーを除く)。
- Chksum: メッセージ チェックサム(UDP、TCP、ICMP6 のメッセージに有効)。
- Sec: リンクレイヤ セキュリティが使用されたかどうかを示します。
- 優先度: メッセージの優先度。有効な値は、
low
、norm
、high
、またはnet
(スレッド制御メッセージの場合)です。 - RSS: メッセージを形成したすべての受信フラグメント フレームの平均受信信号強度(dBm)。TX 履歴の場合は、
NA
(適用外)が表示されます。 - Dir: メッセージが送信(
TX
)または受信(RX
)されたかどうかを示します。送信の失敗は、表形式のTX-F
またはリスト形式のtx-success:no
で示されます。送信の失敗の例としては、tx
が中断される場合や、いずれかのメッセージ フラグメントについてピアからack
が送信されない場合などがあります。 - Neighb(ネイブ): メッセージが送受信されたネイバーの短いアドレス(RLOC16)。フレームがブロードキャストされた場合は、表形式では
bcast
、リスト形式では0xffff
として表示されます。ネイバーの短いアドレスが使用できない場合は、テーブル形式ではunknwn
、リスト形式では0xfffe
として表示されます。 - Radio: メッセージが送受信されたラジオリンク(
OPENTHREAD_CONFIG_MULTI_RADIO
が有効な場合に有用)。15.4
、trel
、またはall
(すべてのラジオリンクで送信される場合)になります。
パラメータ
history rxtx [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history rxtx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x6c6b | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0xc6a2 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
| | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0xc5a2 | yes | norm | NA | TX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
| | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xaa0d | yes | net | NA | TX | 0x0800 | 15.4 |
| 00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xc1d8 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x3cb1 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xeda0 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0xbdfa | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0x1c11 | no | net | NA | TX | 0x0800 | 15.4 |
| 00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0xedff | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0xd383 | no | net | NA | TX | bcast | 15.4 |
| 00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history rxtx list 5
00:00:02.100
type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done
CLI と API リファレンス
履歴 tx
IPv6 メッセージの送信履歴を表形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - 次のように入力します。
- IPv6 メッセージ タイプ(
UDP
、TCP
、HopOpts
、ICMP6
(およびそのサブタイプ)など)。 src
: 送信元 IPv6 アドレスとポート番号。dst
: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP には有効で、それ以外の場合は 0)。
- IPv6 メッセージ タイプ(
- Len: IPv6 ペイロードの長さ(IPv6 ヘッダーを除く)。
- Chksum: メッセージ チェックサム(UDP、TCP、ICMP6 のメッセージに有効)。
- Sec: リンクレイヤ セキュリティが使用されたかどうかを示します。
- 優先度: メッセージの優先度。有効な値は、
low
、norm
、high
、またはnet
(スレッド制御メッセージの場合)です。 - RSS: メッセージを形成したすべての受信フラグメント フレームの平均受信信号強度(dBm)。TX 履歴の場合は、
NA
(適用外)が表示されます。 - Dir: メッセージが送信(
TX
)または受信(RX
)されたかどうかを示します。送信の失敗は、表形式のTX-F
またはリスト形式のtx-success:no
で示されます。送信の失敗の例としては、tx
が中断される場合や、いずれかのメッセージ フラグメントについてピアからack
が送信されない場合などがあります。 - Neighb(ネイブ): メッセージが送受信されたネイバーの短いアドレス(RLOC16)。フレームがブロードキャストされた場合は、表形式では
bcast
、リスト形式では0xffff
として表示されます。ネイバーの短いアドレスが使用できない場合は、テーブル形式ではunknwn
、リスト形式では0xfffe
として表示されます。 - Radio: メッセージが送受信されたラジオリンク(
OPENTHREAD_CONFIG_MULTI_RADIO
が有効な場合に有用)。15.4
、trel
、またはall
(すべてのラジオリンクで送信される場合)になります。
パラメータ
history tx [list] [num-entries]
list
オプションを使用すると、出力をリスト形式で表示できます。それ以外の場合、出力は表形式で表示されます。num-entries
オプションを使用すると、出力を、指定した最新のエントリに限定できます。このオプションを使用しない場合は、保存されているすべてのエントリが出力に表示されます。
例
history tx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0x932c | yes | norm | NA | TX | 0x4800 | 15.4 |
| 00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
| | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xce87 | yes | net | NA | TX | 0x4800 | 15.4 |
| 00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0xf7ba | no | net | NA | TX | 0x4800 | 15.4 |
| 00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0x26d4 | no | net | NA | TX | bcast | 15.4 |
| 00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history tx list
00:00:23.957
type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[ff02:0:0:0:0:0:0:2]:19788
Done
CLI と API リファレンス
ifconfig(up、down)
IPv6 インターフェースをアップまたはダウンします。
IPv6 通信を有効または無効にする場合にこれを呼び出します。
パラメータ
ifconfig up|down
例
ifconfig up
Done
ifconfig down
Done
CLI と API リファレンス
ifconfig
IPv6 インターフェースが稼働中かどうかを示します。
パラメータ
パラメータなし。
例
ifconfig
down
Done
ifconfig
up
Done
CLI と API リファレンス
インスタンス ID
インスタンス ID を取得します。
インスタンス ID は、インスタンスの作成時にランダムな値に設定されます。初期化後もその値は変更されません。
パラメータ
パラメータなし。
例
instanceid
468697314
Done
CLI と API リファレンス
IPaddr の追加
Thread インターフェースにネットワーク インターフェース アドレスを追加します。
渡されたインスタンス aAddress
は、Thread インターフェースによってコピーされます。Thread インターフェースは、外部に追加された一定数のユニキャスト アドレスのみをサポートします。OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS
をご確認ください。
パラメータ
ipaddr add aAddress
例
ipaddr add 2001::dead:beef:cafe
Done
CLI と API リファレンス
IPaddr デル
Thread インターフェースからネットワーク インターフェース アドレスを削除します。
パラメータ
ipaddr del aAddress
例
ipaddr del 2001::dead:beef:cafe
Done
CLI と API リファレンス
IPaddr
Thread インターフェースに割り当てられた IPv6 アドレスのリストを取得します。
パラメータ
ipaddr [-v]
-v
を使用すると、住所に関する詳細情報を取得できます。
origin
:thread
、slaac
、dhcp6
、manual
のいずれか。住所の起点を示します。plen
: プレフィックスの長さpreferred
: 優先フラグ(ブール値)valid
: 有効なフラグ(ブール値)
例
ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done
CLI と API リファレンス
IPaddr リンクローカル
Thread のリンクローカル IPv6 アドレスを取得します。
スレッドリンクのローカルアドレスは、IEEE802.15.4 拡張アドレスをインタフェース識別子として使用して導出されます。
パラメータ
パラメータなし。
例
ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
CLI と API リファレンス
IPaddr Mleid
メッシュ ローカル EID アドレスを取得します。
パラメータ
パラメータなし。
例
ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done
CLI と API リファレンス
ipaddr rloc
スレッド ルーティング ロケーター(RLOC)アドレスを取得します。
パラメータ
パラメータなし。
例
ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done
CLI と API リファレンス
ipmaddr の追加
Thread インターフェースをネットワーク インターフェース マルチキャスト アドレスに登録します。
渡されたインスタンス aAddress
は、Thread インターフェースによってコピーされます。Thread インターフェースは、外部に追加された一定数のマルチキャスト アドレスのみをサポートします。OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS
をご確認ください。
パラメータ
ipmaddr add aAddress
例
ipmaddr add ff05::1
Done
CLI と API リファレンス
ipmaddr デル
Thread インターフェースをネットワーク インターフェース マルチキャスト アドレスにサブスクライブ解除します。
パラメータ
ipmaddr del aAddress
例
ipmaddr del ff05::1
Done
CLI と API リファレンス
ipmaddr
Thread インターフェースに登録されている IPv6 マルチキャスト アドレスのリストを取得します。
パラメータ
パラメータなし。
例
ipmaddr
ff05:0:0:0:0:0:0:1
ff33:40:fdde:ad00:beef:0:0:1
ff32:40:fdde:ad00:beef:0:0:1
Done
CLI と API リファレンス
ipmaddr llatn
スレッドリンクローカルのすべてのスレッドノードのマルチキャスト アドレスを取得します。
アドレスは、リンクローカルのユニキャスト プレフィックスベースのマルチキャスト アドレス [RFC 3306] で、次のものを含みます。
- flgs を 3 に設定(P = 1 かつ T = 1)
- scop を 2 に設定
- プレンを 64 に設定
- メッシュ ローカル プレフィックスに設定されたネットワーク プレフィックス
- グループ ID を 1 に設定
パラメータ
パラメータなし。
例
ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done
CLI と API リファレンス
ipmaddr 無差別(有効、無効)
Thread インターフェースのマルチキャスト無差別モードを有効または無効にします。
パラメータ
ipmaddr promiscuous enable|disable
例
ipmaddr promiscuous enable
Done
ipmaddr promiscuous disable
Done
CLI と API リファレンス
ipmaddr プロミスキャス
Thread インターフェースでマルチキャスト無差別モードが有効になっているかどうかを確認します。
パラメータ
パラメータなし。
例
ipmaddr promiscuous
Disabled
Done
CLI と API リファレンス
ipmaddr rlatn
スレッド レルムローカルのすべてのスレッドノードのマルチキャスト アドレスを取得します。
アドレスは、レルムローカルのユニキャスト プレフィックスベースのマルチキャスト アドレス [RFC 3306] で、次のものを含みます。
- flgs を 3 に設定(P = 1 かつ T = 1)
- スコップを 3 に設定
- プレンを 64 に設定
- メッシュ ローカル プレフィックスに設定されたネットワーク プレフィックス
- グループ ID を 1 に設定
パラメータ
パラメータなし。
例
ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done
CLI と API リファレンス
Joiner Discerner(set)
Joiner Discerner を設定します。
パラメータ
joiner discerner discerner
{number}/{length}
を使用してdiscerner
を設定します。joiner discerner clear
がaDiscerner
をnullptr
に設定します。
例
joiner discerner 0xabc/12
Done
CLI と API リファレンス
結合 識別 クリア
Joiner 識別機能をクリアします。
パラメータ
パラメータなし。
例
joiner discerner clear
Done
CLI と API リファレンス
- 関連付けられている API はありません
Joiner Discerner
Joiner Discerner を取得します。
詳細については、otJoinerSetDiscerner をご覧ください。
パラメータ
パラメータなし。
例
joiner discerner
0xabc/12
Done
CLI と API リファレンス
Joiner ヘルプ
joiner
ヘルプメニューを出力します。
パラメータ
パラメータなし。
例
joiner help
help
id
start
state
stop
Done
CLI と API リファレンス
- 関連付けられている API はありません
結合 ID
Joiner ID を取得します。
Joiner Discerner が設定されていない場合、Joiner ID は、工場で割り当てられた IEEE EUI-64 で SHA-256 を計算した結果の最初の 64 ビットです。それ以外の場合、Joiner ID は Joiner Discerner 値から計算されます。
Joiner ID は、コミッショニング プロセス中にデバイスの IEEE 802.15.4 拡張アドレスとしても使用されます。
パラメータ
パラメータなし。
例
joiner id
d65e64fa83f81cf7
Done
CLI と API リファレンス
Joiner 開始
Thread Joiner ロールを有効にします。
パラメータ
joiner start joining-device-credential [provisioning-url]
joining-device-credential
: 結合パスフレーズ。すべて大文字の英数字(0 ~ 9 と A ~ Y、読みやすくするために I、O、Q、Z を除く)を使用した 6 ~ 32 文字の文字列にする必要があります。provisioning-url
: Joiner のプロビジョニング URL(省略可)。
例
joiner start J01NM3
Done
CLI と API リファレンス
Joiner の状態
Joiner の状態を取得します。
次のいずれかの状態を返します。
-
Idle
-
Discover
-
Connecting
-
Connected
-
Entrust
-
Joined
パラメータ
パラメータなし。
例
joiner state
Idle
Done
CLI と API リファレンス
ジョイナー ストップ
スレッド結合のロールを無効にします。
パラメータ
パラメータなし。
例
joiner stop
Done
CLI と API リファレンス
Joinerport(set)
Joiner UDP ポートを設定します。
パラメータ
joinerport udp-port
例
joinerport 1000
Done
CLI と API リファレンス
ジョイナーポート
Joiner UDP ポートを取得します。
パラメータ
パラメータなし。
例
joinerport
1000
Done
CLI と API リファレンス
キーシーケンス カウンタ(セット)
thrKeySequenceCounter を設定します。
パラメータ
keysequence counter counter
例
keysequence counter 10
Done
CLI と API リファレンス
キーシーケンス カウンタ
thrKeySequenceCounter を取得します。
パラメータ
パラメータなし。
例
keysequence counter
10
Done
CLI と API リファレンス
キーシーケンスのガードタイム(設定)
thrKeySwitchGuardTime(時間単位)を設定します。
パラメータ
keysequence guardtime guardtime-hours
キー インデックスが一致する場合は、すぐに 0
から Thread Key Switch
を使用します。
例
keysequence guardtime 0
Done
CLI と API リファレンス
キーシーケンスのガードタイム
thrKeySwitchGuardTime(時間単位)を取得します。
パラメータ
パラメータなし。
例
keysequence guardtime
0
Done
CLI と API リファレンス
リーダーデータ
スレッド リーダー データを取得します。
パラメータ
パラメータなし。
例
leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done
CLI と API リファレンス
リーダー級(セット)
リーダーの役割で操作するときに使用するスレッド リーダーの重みを設定します。
リーダー ウェイトを新しい値に直接設定し、以前の値(現在の
otDeviceProperties
から決定されている場合があります)と置き換えます。
パラメータ
leaderweight weight
例
leaderweight 128
Done
CLI と API リファレンス
リーダー級
リーダー ロールで操作するときに使用されるスレッド リーダーの重みを取得します。
パラメータ
パラメータなし。
例
leaderweight
128
Done
CLI と API リファレンス
linkmetrics 管理の強化 - 確認応答
リンク指標管理リクエストを送信して、Enhanced-ACK ベースのプローブを消去します。
パラメータ
linkmetrics mgmt peer-ipaddr enhanced-ack clear
peer-ipaddr
は、隣接デバイスのリンクローカル アドレスにする必要があります。
例
linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
CLI と API リファレンス
linkmetrics 管理強化確認応答レジスタ
拡張 ACK ベースのプローブを登録するためのリンク指標管理リクエストを送信します。
パラメータ
linkmetrics mgmt peer-ipaddr enhanced-ack register [qmr][r]
[q
、m
、r
] は otLinkMetricsValues にマッピングされます。仕様 4.11.3.4.4.6 に従い、一度に使用できるオプションは 2 つまでとなっています(例: q
、qm
)。
q
: レイヤ 2 LQI。m
: リンク マージン。r
: RSSI。
r
はオプションであり、参照デバイスでのみ使用されます。このオプションを指定すると、各タイプ ID フラグのタイプ/平均列挙型は予約済みに設定されます。これは、プローブサブジェクトが無効なタイプ ID フラグを正しく処理していることを確認するために使用され、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効な場合にのみ使用されます。
例
linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
CLI と API リファレンス
linkmetrics 管理転送
MLE リンク指標管理リクエストを送信して、フォワード トラッキング シリーズを設定またはクリアします。
パラメータ
linkmetrics mgmt peer-ipaddr forward series-id [ldraX][pqmr]
peer-ipaddr
: ピアアドレス。series-id
: シリーズ ID。- [
l
、d
、r
、a
] は otLinkMetricsSeriesFlags にマッピングされます。X
は、どのotLinkMetricsSeriesFlags
も表せず、アカウンティングを停止して系列を削除します。l
: MLE リンクプローブ。d
: MAC データ。r
: MAC データ リクエスト。a
: MAC 確認応答。X
: 他のフラグがない場合のみ使用できます。
- [
p
、q
、m
、r
] は otLinkMetricsValues にマッピングされます。p
: 受信したレイヤ 2 PDU の数。q
: レイヤ 2 LQI。m
: リンク マージン。r
: RSSI。
例
linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
CLI と API リファレンス
linkmetrics プローブ
MLE リンクプローブ メッセージを送信します。
パラメータ
linkmetrics probe peer-ipaddr series-id length
peer-ipaddr
: ピアアドレス。series-id
: このプローブ メッセージの対象とするシリーズ ID。length
: プローブ メッセージの長さ。有効な範囲は [0, 64] です。
例
linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done
CLI と API リファレンス
linkmetrics クエリ転送
リンク指標のクエリを実行する(フォワード トラッキング シリーズ)。
パラメータ
linkmetrics query peer-ipaddr forward series-id
peer-ipaddr
: ピアアドレス。series-id
: シリーズ ID。
例
linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
CLI と API リファレンス
linkmetrics クエリ シングル
リンク指標のクエリを実行する(単一プローブ)。
パラメータ
linkmetrics query peer-ipaddr single [pqmr]
peer-ipaddr
: ピアアドレス。- [
p
、q
、m
、r
] は otLinkMetrics にマッピングされます。p
: 受信したレイヤ 2 PDU の数。q
: レイヤ 2 LQI。m
: リンク マージン。r
: RSSI。
例
linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
CLI と API リファレンス
linkmetricsmgr(有効、無効)
Link Metrics Manager を有効または無効にします。
パラメータ
linkmetricsmgr enable|disable
例
linkmetricmgr enable
Done
linkmetricmgr disable
Done
CLI と API リファレンス
linkmetricsmgr 表示
拡張アドレスによってネイバーのリンク指標データを取得します。
パラメータ
パラメータなし。
例
linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done
CLI と API リファレンス
位置特定(設定)
エニーキャスト アドレスに最も近い宛先を見つけます(つまり、宛先のメッシュ ローカル EID と RLOC16 を見つけます)。
最も近い宛先は、現在のルーティング テーブルと Thread メッシュ内のパスコストに基づいて決定されます。
OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
が有効な場合に使用できます。
パラメータ
locate anycastaddr
例
locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done
CLI と API リファレンス
探す
エニーキャスト ロケータの現在の状態(In Progress
または Idle
)を取得します。
OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done
CLI と API リファレンス
ログファイル名
otPlatLog()
メッセージをキャプチャするファイル名を指定します。ロギングによって自動テスト スクリプトが中断された場合に、Linux で自動テスト スクリプトをデバッグする場合に便利です。
OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART
と OPENTHREAD_POSIX
が必要です。
パラメータ
log filename filename
例
CLI と API リファレンス
ログレベル(設定)
ログレベルを設定します。
パラメータ
log level level
例
log level 4
Done
CLI と API リファレンス
ログレベル
ログレベルを取得します。
パラメータ
パラメータなし。
例
log level
1
Done
CLI と API リファレンス
Mac が直接再試行(get、set)を行う
MAC レイヤでの直接 TX の再試行回数を取得または設定します。
パラメータ
mac retries direct [number]
オプションの number
引数を使用して、直接送信の再試行回数を設定します。
例
mac retries direct
3
Done
mac retries direct 5
Done
CLI と API リファレンス
Mac が間接的に再試行(get、set)を行う
MAC レイヤでの間接 TX の再試行回数を取得または設定します。
パラメータ
mac retries indirect [number]
オプションの number
引数を使用して、間接送信の再試行回数を設定します。
例
mac retries indirect
3
Done
max retries indirect 5
Done
CLI と API リファレンス
Mac 送信
MAC フレームを親に送信するように Rx-Off-When-Idle
デバイスに指示します。このコマンドは認証用で、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が有効になっている場合にのみ使用できます。
パラメータ
mac send datarequest | emptydata
次の 2 つの引数のいずれかを選択する必要があります。
datarequest
: 送信のために IEEE 802.15.4 データ リクエスト メッセージをキューに追加します。emptydata
: 空の IEEE 802.15.4 データフレームを送信するようデバイスに指示します。
例
mac send datarequest
Done
mac send emptydata
Done
CLI と API リファレンス
macfilter Addr - 追加
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合にのみ使用できます。
MAC フィルタ リストに IEEE 802.15.4 拡張アドレスを追加します。オプションの rss
引数を指定すると、指定したアドレスからのメールの受信電波強度が修正されます。rss
オプションを使用しない場合は、設定したデフォルト値がアドレスに使用されます。デフォルト値を設定しない場合、電波強度は無線信号となります。
パラメータ
macfilter addr add extaddr [rss]
例
macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done
CLI と API リファレンス
macfilter addr 許可リスト
allowlist
MAC フィルタモードを有効にします。つまり、MAC フィルタリスト内の MAC アドレスのみがアクセスを許可されます。
パラメータ
パラメータなし。
例
macfilter addr allowlist
Done
CLI と API リファレンス
macfilter Addr Clear
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合に使用できます。
このコマンドは、MAC フィルタリストからすべての拡張アドレスを消去します。
パラメータ
パラメータなし。
例
macfilter addr clear
Done
CLI と API リファレンス
macfilter addr 拒否リスト
denylist
MAC フィルタモードを有効にします。つまり、MAC フィルタリスト内のすべての MAC アドレスでアクセスが拒否されます。
パラメータ
パラメータなし。
例
macfilter addr denylist
Done
CLI と API リファレンス
macfilter addr 無効
MAC フィルタモードを無効にします。
パラメータ
パラメータなし。
例
macfilter addr disable
Done
CLI と API リファレンス
- 関連付けられている API はありません
macfilter Addr
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合に使用できます。
次の情報を提供します。
- MAC フィルタリストの現在のモード:
AllowList
、DenyList,
、Disabled
のいずれか - フィルタ内のすべての拡張アドレスのリスト。受信信号強度(rss)とリンク品質インジケータ(lqi)がデフォルト値と異なるように設定されている場合、アドレスの横に表示されます。
パラメータ
パラメータなし。
例
macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done
CLI と API リファレンス
macfilter の追加 - 削除
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合に使用できます。
このコマンドは、MAC フィルタリストから指定された拡張アドレスを削除します。
パラメータ
macfilter addr remove extaddr
例
macfilter addr remove 0f6127e33af6b402
Done
CLI と API リファレンス
MACfilter
次の情報を提供します。
Address Mode
: MAC フィルタの現在のモード(AllowList
、DenyList,
、Disabled
のいずれか)。- MAC フィルタリスト内のすべての拡張アドレスのリスト。受信信号強度(rss)とリンク品質インジケータ(lqi)がデフォルト値と異なるように設定されている場合、アドレスの横に表示されます。
- 個別のリスト(
RssIn List
)には、rss
がデフォルト値とは異なるように設定されている拡張アドレスがすべて表示されます。 Default rss
:rss
設定とlqi
設定のデフォルト値を表示します(該当する場合)。
パラメータ
パラメータなし。
例
macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
CLI と API リファレンス
macfilter rss 追加
指定された拡張アドレスを RssIn
リストに追加(または RssIn
リスト内の既存のアドレスを変更)し、そのアドレスからのメッセージに対して受信電波強度(dBm 単位)のエントリを設定します。
パラメータ
macfilter rss add extaddr rss
すべての受信メッセージの受信電波強度のデフォルト値を設定するには、extaddr
引数に *
を使用します。
例
macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done
CLI と API リファレンス
macfilter rss add-lqi
指定された拡張アドレスを RssIn
リストに追加し(または、RssIn
リストの既存のアドレスを変更し)、そのアドレスからのメッセージに固定のリンク品質インジケーターを設定します。lqi
を設定するために、拡張アドレスは必ずしも address allowlist/denylist
フィルタに含まれている必要はありません。
これは、OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合に使用できます。
パラメータ
macfilter rss add-lqi extaddr lqi
受信したすべてのメッセージのリンク品質インジケーターのデフォルト値を設定するには、extaddr
引数に *
を使用します。指定できる範囲は 0 ~ 3 です。
例
macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done
CLI と API リファレンス
MACfilter rss クリア
RssIn
リストから受信電波強度(rss
)とリンク品質インジケーター(lqi
)のエントリ(デフォルトを含む)をすべて消去します。
この操作を行うと、すべての拡張アドレスで電波が使用されます。
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合に使用できます。
パラメータ
パラメータなし。
例
macfilter rss clear
Done
CLI と API リファレンス
Macfilter rss
次の情報を提供します。
- 受信電波強度(
rss
)がデフォルト値とは異なるように設定されているすべての拡張アドレスのリスト。リンク品質インジケーター(lqi
)も表示されます。rss
設定とlqi
設定は相互にマッピングされています。どちらかを設定すると、もう一方の値が自動的に設定されます。このアドレスのリストはRssIn List
と呼ばれます。rsi
またはlqi
を設定すると、対応する拡張アドレスがRssIn
リストに追加されます。 Default rss
:rss
設定とlqi
設定のデフォルト値を表示します(該当する場合)。
パラメータ
パラメータなし。
例
macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
CLI と API リファレンス
macfilter rss 削除
指定された拡張アドレスを RssIn
リストから削除します。
RssIn
リストからこの MAC アドレスが削除されると、デフォルトが設定されている場合、rss
と lqi
のデフォルトの設定が使用されます。(デフォルトが設定されていない場合は、無線信号が使用されます)。
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
構成が有効な場合に使用できます。
指定された拡張アドレスに一致する既存のエントリが RssIn
リストにない場合、アクションは実行されません。
パラメータ
macfilter rss remove extaddr
デフォルトの受信電波強度とリンク品質インジケーターの設定を削除するには、*
を extaddr
として使用します。これによってデフォルトの設定が解除されますが、RssIn
リストからのエントリは削除されません。
例
macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done
CLI と API リファレンス
Meshdiag チャイルディ IP6
親にクエリを送信して、MTD のすべての子の IPv6 アドレスを取得します。
パラメータ
meshdiag childip6 parent-rloc16
例
meshdiag childip6 0xdc00
child-rloc16: 0xdc02
fdde:ad00:beef:0:ded8:cd58:b73:2c21
fd00:2:0:0:c24a:456:3b6b:c597
fd00:1:0:0:120b:95fe:3ecc:d238
child-rloc16: 0xdc03
fdde:ad00:beef:0:3aa6:b8bf:e7d6:eefe
fd00:2:0:0:8ff8:a188:7436:6720
fd00:1:0:0:1fcf:5495:790a:370f
Done
CLI と API リファレンス
meshdiag 子テーブル
指定された RLOC16 を持つルーターの子テーブルのクエリを開始します。出力には、すべての子エントリが一覧表示されます。お子様ごとの情報:
- RLOC16
- 拡張 MAC アドレス
- スレッドのバージョン
- タイムアウト(秒)
- 経過時間(最後に聞いてからの秒数)
- 監視間隔(秒)
- キューに格納されたメッセージの数(子が眠い場合)
- デバイスモード
- RSS(平均と最後)
- エラー率: フレーム tx(MAC レイヤ)、IPv6 メッセージ tx(MAC より上)
- 接続時間(リンク確立後の秒数(
{dd}d.{hh}:{mm}:{ss}
形式)) - CSL に関する情報:
- 同期している場合
- 期間(10 シンボルの時間単位)
- タイムアウト(秒)
パラメータ
パラメータなし。
例
meshdiag childtable 0x6400
rloc16:0x6402 ext-addr:8e6f4d323bbed1fe ver:4
timeout:120 age:36 supvn:129 q-msg:0
rx-on:yes type:ftd full-net:yes
rss - ave:-20 last:-20 margin:80
err-rate - frame:11.51% msg:0.76%
conn-time:00:11:07
csl - sync:no period:0 timeout:0 channel:0
rloc16:0x6403 ext-addr:ee24e64ecf8c079a ver:4
timeout:120 age:19 supvn:129 q-msg:0
rx-on:no type:mtd full-net:no
rss - ave:-20 last:-20 margin:80
err-rate - frame:0.73% msg:0.00%
conn-time:01:08:53
csl - sync:no period:0 timeout:0 channel:0
Done
CLI と API リファレンス
- 関連付けられている API はありません
Meshdiag routerneighbortable
指定された RLOC16 を持つルーターのルーター ネイバー テーブルのクエリを開始します。出力には、ルーター ネイバーのすべてのエントリが一覧表示されます。エントリごとの情報:
- RLOC16
- 拡張 MAC アドレス
- スレッドのバージョン
- RSS(平均値と最終値)とリンクのマージン
- エラー率、フレーム tx(MAC レイヤ)、IPv6 メッセージ tx(MAC より上)
- 接続時間(リンク確立後の秒数(
{dd}d.{hh}:{mm}:{ss}
形式))
パラメータ
meshdiag routerneighbortable router-rloc16
例
meshdiag routerneighbortable 0x7400
rloc16:0x9c00 ext-addr:764788cf6e57a4d2 ver:4
rss - ave:-20 last:-20 margin:80
err-rate - frame:1.38% msg:0.00%
conn-time:01:54:02
rloc16:0x7c00 ext-addr:4ed24fceec9bf6d3 ver:4
rss - ave:-20 last:-20 margin:80
err-rate - frame:0.72% msg:0.00%
conn-time:00:11:27
Done
CLI と API リファレンス
Meshdiag トポロジ
ネットワーク トポロジ(ルーターとその接続のリスト)を確認します。パラメータはオプションで、検出する追加アイテムを示します。任意の順序で追加できます。
ip6-addrs
: すべてのルーターの IPv6 アドレスのリストを検出します。children
: すべてのルーターの子テーブルを検出します。
ルーターごとの情報:
- ルーター ID
- RLOC16
- 拡張 MAC アドレス
- スレッドのバージョン(わかっている場合)
- ルーターがこのデバイス自体かどうか(
me
) - デバイスが子どもの場合、ルーターがデバイスの親になるかどうか(
parent
) - ルーターが
leader
かどうか - ルーターが外部接続を提供するボーダー ルーターとして機能するかどうか(
br
) - このルーターのリンクが設定されているルーターのリスト:
3-links
: このルーターのリンク品質が 3 の受信リンクがあるルーター ID2-links
: このルーターのリンク品質が 2 の受信リンクがあるルーター ID1-links
: このルーターのリンク品質が 1 の受信リンクがあるルーター ID- リストが空の場合は、出力では省略されます。
ip6-addrs
の場合、ルーターの IPv6 アドレスのリスト。children
の場合、ルーターのすべての子のリスト。お子様ごとの情報:- RLOC16
- 親から子へのリンクの品質(0 は不明を示す)
- 子デバイスのモード(
r
rx-on-when-idle、d
フルスレッド デバイス、n
フル ネットワーク データ、-
フラグ未設定) - お子様がこのデバイスそのものかどうか(
me
) - 子が外部接続を提供するボーダー ルーターとして機能するかどうか(
br
)
パラメータ
meshdiag topology [ip6-addrs] [children]
例
meshdiag topology
id:02 rloc16:0x0800 ext-addr:8aa57d2c603fe16c ver:4 - me - leader
3-links:{ 46 }
id:46 rloc16:0xb800 ext-addr:fe109d277e0175cc ver:4
3-links:{ 02 51 57 }
id:33 rloc16:0x8400 ext-addr:d2e511a146b9e54d ver:4
3-links:{ 51 57 }
id:51 rloc16:0xcc00 ext-addr:9aab43ababf05352 ver:4
3-links:{ 33 57 }
2-links:{ 46 }
id:57 rloc16:0xe400 ext-addr:dae9c4c0e9da55ff ver:4
3-links:{ 46 51 }
1-links:{ 33 }
Done
CLI と API リファレンス
Mleadvimax
アドバタイズメント トリクル タイマーで使用される現在の間隔最大値を取得します。
この API は OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
を必要とし、テスト専用です。
パラメータ
パラメータなし。
例
mleadvimax
12000
Done
CLI と API リファレンス
mliid
メッシュ ローカル IID を設定します(テスト用)。
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
が必要です。
Thread スタックを有効にする前に使用する必要があります。
テスト/参照デバイスのみ。
パラメータ
mliid iid
例
mliid 1122334455667788
Done
CLI と API リファレンス
MLR REG
マルチキャスト リスナーをプライマリ バックボーン ルーターに登録します。
OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE
と OPENTHREAD_CONFIG_COMMISSIONER_ENABLE
を有効にする必要があります。
プライマリ バックボーン ルーターでデフォルトの MLR タイムアウトを使用する場合は、タイムアウトを省略します。
マルチキャスト リスナーの登録を解除するには、timeout = 0 を使用します。
パラメータ
mlr reg ipaddr [timeout]
例
mlr reg ff04::1
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Done
mlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 0
status 0, 0 failed
Done
CLI と API リファレンス
モード(get、set)
MLE リンクモードの構成を設定します。
パラメータ
mode [rdn]
-
: フラグが設定されていない(rx-off-when-idle、最小の Thread デバイス、安定したネットワーク データ)r
: rx-on-when-idled
: フル Thread デバイスn
: 完全なネットワーク データ
例
mode rdn
Done
mode -
Done
CLI と API リファレンス
Multiradio
デバイスでサポートされている無線リンクのリストを取得します。
このコマンドは、デバイスでサポートされている無線通信が 1 つのみの場合でも常に使用できます。
パラメータ
パラメータなし。
例
multiradio
[15.4, TREL]
Done
CLI と API リファレンス
- 関連付けられている API はありません
multiradio neighbor リスト
指定された拡張アドレスを持つネイバーに関連付けられているマルチ無線リンク情報を取得します。
OPENTHREAD_CONFIG_MULTI_RADIO
を有効にする必要があります。
パラメータ
パラメータなし。
例
multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done
CLI と API リファレンス
マルチラジオ ネイバー
指定された拡張アドレスを持つネイバーに関連付けられているマルチ無線リンク情報を取得します。
OPENTHREAD_CONFIG_MULTI_RADIO
を有効にする必要があります。
パラメータ
multiradio neighbor ext-address
例
multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done
CLI と API リファレンス
nat64(有効、無効)
NAT64 機能を有効または無効にします。
OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
が有効な場合に、disabled を true に設定すると、トランスレータのマッピング テーブルがリセットされます。
OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
または OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
が有効な場合に使用できます。
パラメータ
nat64 enable|disable
例
nat64 enable
Done
nat64 disable
Done
CLI と API リファレンス
nat64 cidr
パラメータ
パラメータなし。
例
nat64 cidr 192.168.255.0/24
Done
CLI と API リファレンス
NAT64 CIDR
NAT64 トランスレータで構成されている IPv4 CIDR を取得します。
OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
nat64 cidr
192.168.255.0/24
Done
CLI と API リファレンス
nat64 カウンタ
NAT64 トランスレータ パケットとエラーカウンタを取得します。
OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
nat64 counters
| | 4 to 6 | 6 to 4 |
+---------------+-------------------------+-------------------------+
| Protocol | Pkts | Bytes | Pkts | Bytes |
+---------------+----------+--------------+----------+--------------+
| Total | 11 | 704 | 11 | 704 |
| TCP | 0 | 0 | 0 | 0 |
| UDP | 0 | 0 | 0 | 0 |
| ICMP | 11 | 704 | 11 | 704 |
| Errors | Pkts | Pkts |
+---------------+-------------------------+-------------------------+
| Total | 8 | 4 |
| Illegal Pkt | 0 | 0 |
| Unsup Proto | 0 | 0 |
| No Mapping | 2 | 0 |
Done
CLI と API リファレンス
nat64 マッピング
次の AddressMapping 情報を取得します(イテレータを使用して)。
OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
が有効な場合に使用できます。
パラメータ
パラメータなし。
例
nat64 mappings
| | Address | | 4 to 6 | 6 to 4 |
+----------+---------------------------+--------+--------------+--------------+
| ID | IPv6 | IPv4 | Expiry | Pkts | Bytes | Pkts | Bytes |
+----------+------------+--------------+--------+------+-------+------+-------+
| 00021cb9 | fdc7::df79 | 192.168.64.2 | 7196s | 6 | 456 | 11 | 1928 |
| | TCP | 0 | 0 | 0 | 0 |
| | UDP | 1 | 136 | 16 | 1608 |
| | ICMP | 5 | 320 | 5 | 320 |
CLI と API リファレンス
NAT64 状態
NAT64 関数の状態を取得します。
PrefixManager
状態は、OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
が有効な場合に使用できます。Translator
状態は、OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
が有効な場合に使用できます。
OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
が有効になると、PrefixManager
は次のいずれかの状態を返します。
Disabled
: NAT64 プレフィックス マネージャーは無効になっています。NotRunning
: NAT64 プレフィックス マネージャーは有効になっていますが、実行されていません。ルーティング マネージャーが無効になっている可能性があります。Idle
: NAT64 プレフィックス マネージャーが有効で実行中ですが、NAT64 プレフィックスを公開していません。これは、優先度の高い NAT64 プレフィックスをパブリッシュしている別のボーダー ルーターが存在する場合に発生します。Active
: NAT64 プレフィックス マネージャーが有効で、実行中で、NAT64 プレフィックスを公開しています。
OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
が有効になると、Translator
は次のいずれかの状態を返します。
Disabled
: NAT64 トランスレータが無効になります。NotRunning
: NAT64 トランスレータは有効になっていますが、パケットを変換していません。これは、トランスレータが NAT64 プレフィックスまたは NAT64 の CIDR で構成されていないことを意味している可能性があります。Active
: NAT64 トランスレータが有効で、パケットを変換しています。
パラメータ
パラメータなし。
例
nat64 state
PrefixManager: Active
Translator: Active
Done
CLI と API リファレンス
ネイバー conntime リスト
ネイバーの接続時間と経過時間を出力します。このコマンドは neighbor conntime
に似ていますが、情報をリスト形式で表示します。経過時間と接続時間の両方が秒単位で表示されます。
パラメータ
パラメータなし。
例
neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done
CLI と API リファレンス
ネイバー conntime
ネイバーの接続時間と経過時間を出力します。ネイバーあたりの情報:
- RLOC16
- 拡張 MAC
- 最後に聞いた時間(年齢): 隣の人から最後に聞こえてからの秒数。
- Connection Time(接続時間): ネイバーとのリンク確立後の秒数。期間が 1 日未満の場合、期間の間隔は、時間、分、秒の
{hh}:{mm}:{ss}
の形式になります。期間が 1 日を超える場合、形式は{dd}d.{hh}:{mm}:{ss}
です。
パラメータ
パラメータなし。
例
neighbor conntime
| RLOC16 | Extended MAC | Last Heard (Age) | Connection Time |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 | 00:00:13 | 00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 | 00:00:03 | 00:11:27 |
| 0xe800 | ce53628a1e3f5b3c | 00:00:02 | 00:00:15 |
Done
CLI と API リファレンス
隣接リンク品質
すべての近傍に関するリンク品質情報を出力します。
パラメータ
パラメータなし。
例
neighbor linkquality
| RLOC16 | Extended MAC | Frame Error | Msg Error | Avg RSS | Last RSS | Age |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db | 0.00 % | 0.00 % | -46 | -48 | 1 |
| 0xc001 | 0ad7ed6beaa6016d | 4.67 % | 0.08 % | -68 | -72 | 10 |
Done
CLI と API リファレンス
- 関連付けられている API はありません
ネイバーリスト
各ネイバーの RLOC16 を一覧表示します。
パラメータ
パラメータなし。
例
neighbor list
0xcc01 0xc800 0xf000
Done
CLI と API リファレンス
- 関連付けられている API はありません
隣接テーブル
すべての近傍に関する情報を表形式で出力します。
Role
の場合、このテーブルで使用できる値は C
(子)または R
(ルーター)のみです。
以下の列には、ネイバーのデバイスモードに関する情報が表示されます。各列の値は 0
(オフ)または 1
(オン)です。
R
: アイドル状態のときに RX をオンD
: 完全な Thread デバイスN
: 完全なネットワーク データ
パラメータ
パラメータなし。
例
neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC |
+------+--------+-----+----------+-----------+-+-+-+------------------+
| C | 0xcc01 | 96 | -46 | -46 |1|1|1| 1eb9ba8a6522636b |
| R | 0xc800 | 2 | -29 | -29 |1|1|1| 9a91556102c39ddb |
| R | 0xf000 | 3 | -28 | -28 |1|1|1| 0ad7ed6beaa6016d |
Done
CLI と API リファレンス
netdata がいっぱいです
スレッド オペレーションの開始以降、または最後に netdata full reset
を使用してフラグをリセットしてから、「net data full」コールバックが呼び出されたかどうかを示す「yes」または「no」を出力します。このコマンドには OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL
が必要です。「net data full」コールバックは、次の場合に呼び出されます。
- デバイスがリーダーとして動作し、ボーダー ルーター(BR)からネットワーク データ登録を受信します。この登録はネットワーク データに追加できません(容量不足です)。
- デバイスは BR として機能しているため、ローカル ネットワーク データに新しいエントリを追加できません。
- デバイスは BR として動作しており、ローカル ネットワーク データ エントリをリーダーに登録しようとしていますが、ローカル エントリは収まらないと判断しました。
パラメータ
パラメータなし。
例
netdata full
no
Done
CLI と API リファレンス
netdata フルリセット
「net data full」コールバックが呼び出されたかどうかを追跡するフラグをリセットしました。
パラメータ
パラメータなし。
例
netdata full reset
Done
CLI と API リファレンス
- 関連付けられている API はありません
ネットデータ長
パーティションのスレッド ネットワーク データの現在の長さ(バイト数)を取得します。
パラメータ
パラメータなし。
例
netdata length
23
Done
CLI と API リファレンス
netdata の最大長
OT スタックの初期化以降、または前回の
otNetDataResetMaxLength()
呼び出し以降のスレッド ネットワーク データの観測最大長を取得します。
パラメータ
パラメータなし。
例
netdata maxlength
40
Done
CLI と API リファレンス
netdata maxlength のリセット
トラッキングされた Thread ネットワーク データの最大長をリセットします。
パラメータ
パラメータなし。
例
netdata maxlength reset
Done
CLI と API リファレンス
netdata publish dnssrp Anycast
シーケンス番号を使用して DNS/SRP サービス エニーキャスト アドレスをパブリッシュします。以前の publish dnssrp{anycast|unicast}
コマンドで公開された現在の DNS/SRP サービス エントリはすべて削除され、新しい引数に置き換えられます。
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
を有効にする必要があります。
パラメータ
netdata publish dnssrp anycast seq-num
例
netdata publish dnssrp anycast 1
Done
CLI と API リファレンス
- netdata publish dnssrp unicast(addr,port)
- netdata publish dnssrp unicast(mle)
- otNetDataPublishDnsSrpServiceAnycast
netdata publish dnssrp ユニキャスト(アドレス、ポート)
アドレスとポート番号を含む DNS/SRP サービスのユニキャスト アドレスをパブリッシュします。アドレスとポートの情報は、サービス TLV データに含まれます。以前の publish dnssrp{anycast|unicast}
コマンドで公開された現在の DNS/SRP サービス エントリはすべて削除され、新しい引数に置き換えられます。
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
を有効にする必要があります。
パラメータ
netdata publish dnssrp unicast address port
例
netdata publish dnssrp unicast fd00::1234 51525
Done
CLI と API リファレンス
- netdata publish dnssrp unicast(mle)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicast
netdata publish dnssrp unicast(mle)
デバイスのメッシュローカル EID をポート番号とともにパブリッシュします。MLE とポートの情報はサーバー TLV データに含まれます。別のユニキャスト アドレスを使用するには、netdata publish dnssrp unicast (addr,port)
コマンドを使用します。
以前の publish dnssrp{anycast|unicast}
コマンドで公開された現在の DNS/SRP サービス エントリはすべて削除され、新しい引数に置き換えられます。
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
を有効にする必要があります。
パラメータ
netdata publish dnssrp unicast port
例
netdata publish dnssrp unicast 50152
Done
CLI と API リファレンス
- netdata publish dnssrp unicast(addr,port)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
netdata パブリッシュ接頭辞
メッシュ上の接頭辞エントリを公開します。詳細については、OT CLI を使用したネットワーク データの表示および管理をご覧ください。
パラメータ
netdata publish prefix prefix [padcrosnD] [high|med|low]
OT CLI はマッピングされた引数を使用して otBorderRouterConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
netdata publish prefix fd00:1234:5678::/64 paos med
Done
CLI と API リファレンス
netdata 公開 置換
以前に公開した外部ルートエントリを置き換えます。詳細については、OT CLI を使用したネットワーク データの表示および管理をご覧ください。
パラメータ
netdata publish replace oldprefix prefix [sn] [high|med|low]
OT CLI は、マッピングされた引数を使用して otExternalRouteConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
CLI と API リファレンス
netdata の公開ルート
外部ルートエントリを公開します。詳細については、OT CLI を使用したネットワーク データの表示および管理をご覧ください。
パラメータ
publish route prefix [sn] [high|med|low]
OT CLI は、マッピングされた引数を使用して otExternalRouteConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
netdata publish route fd00:1234:5678::/64 s high
Done
CLI と API リファレンス
netdata レジスタ
構成済みのプレフィックス、ルート、サービスをリーダーに登録します。
OT CLI がOPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
を確認します。OTBR が有効な場合は、ローカル ネットワーク データをリーダーに登録します。それ以外の場合は、CLI 関数 otServerRegister
を呼び出します。詳細については、OT CLI を使用したネットワーク データの表示および管理をご覧ください。
パラメータ
パラメータなし。
例
netdata register
Done
CLI と API リファレンス
netdata steeringdata check(discerner)
ステアリング データに、特定の識別値を持つ Joiner が含まれているかどうかを確認します。
パラメータ
netdata steeringdata check discerner
discerner
: 結合識別器({number}/{length}
形式)。
例
netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound
CLI と API リファレンス
netdata steeringdata チェック(eui64)
ステアリング データに Joiner が含まれているかどうかを確認します。
パラメータ
netdata steeringdata check eui64
eui64
: Joiner の IEEE EUI-64。
例
netdata steeringdata check d45e64fa83f81cf7
Done
CLI と API リファレンス
netdata unpublish(接頭辞)
以前に公開されたメッシュ上または外部ルートの接頭辞の公開を停止します。
OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
を有効にする必要があります。
詳細については、OT CLI を使用したネットワーク データの表示および管理をご覧ください。
パラメータ
netdata unpublish prefix
例
netdata unpublish fd00:1234:5678::/64
Done
CLI と API リファレンス
netdata の dnssrp の公開停止
以前に追加した DNS/SRP(エニーキャストまたはユニキャスト)サービス エントリを Thread ネットワーク データから公開停止します。
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
を有効にする必要があります。
パラメータ
パラメータなし。
例
netdata unpublish dnssrp
Done
CLI と API リファレンス
netstat
UDP ソケットのリンクされたリストの先頭を取得します。
パラメータ
パラメータなし。
例
netstat
| Local Address | Peer Address |
+-------------------------------------------------+-------------------------------------------------+
| [0:0:0:0:0:0:0:0]:49153 | [0:0:0:0:0:0:0:0]:0 |
| [0:0:0:0:0:0:0:0]:49152 | [0:0:0:0:0:0:0:0]:0 |
| [0:0:0:0:0:0:0:0]:61631 | [0:0:0:0:0:0:0:0]:0 |
| [0:0:0:0:0:0:0:0]:19788 | [0:0:0:0:0:0:0:0]:0 |
Done
CLI と API リファレンス
networkdiagnostic get
指定されたアドレスに対して指定されたタイプ長値(TLV)を取得するネットワーク診断リクエストを送信します。
パラメータ
networkdiagnostic get addr type(s)
addr
の場合、ユニキャスト アドレスが Diagnostic Get
をトリガーします。マルチキャスト アドレスが Diagnostic Query
をトリガーします。指定できる TLV 値(TLV を複数指定する場合はスペースで区切ります):
0
: MAC 拡張アドレス TLV1
: 住所 16 の TLV2
: モード TLV3
: タイムアウト TLV(SED の最大ポーリング時間)4
: 接続の TLV5
: Route64 TLV6
: リーダーデータの TLV7
: ネットワーク データ TLV8
: IPv6 アドレスリスト TLV9
: MAC カウンタ TLV14
: バッテリー残量 TLV15
: 電源電圧 TLV16
: 子テーブルの TLV17
: チャンネル ページの TLV19
: 子の最大タイムアウト TLV23
: EUI64 TLV24
: バージョン TLV(プロトコルと機能のバージョン番号)25
: ベンダー名の TLV26
: ベンダーモデルの TLV27
: ベンダー SW バージョンの TLV28
: スレッド スタック バージョン TLV(スレッド スタック コードベース/commit/バージョン用の UTF-8 文字列としてのバージョン識別子)29
: 子 TLV34
: MLE カウンタの TLV35
: ベンダーアプリ URL の TLV
例
networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
PartitionId: 0x640b0f67
Weighting: 64
DataVersion: 116
StableDataVersion: 197
LeaderRouterId: 0x03
EUI64: 18b4300000000004
Done
networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done
CLI と API リファレンス
ネットワーク診断のリセット
指定されたアドレスで指定されたタイプ長値(TLV)をリセットするネットワーク診断リクエストを送信します。このコマンドは、9
(MAC カウンタ TLV)または 34
(MLE カウンタ TLV)の TLV 値のみをサポートします。
パラメータ
networkdiagnostic reset addr type(s)
例
networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done
CLI と API リファレンス
networkidtimeout(get、set)
NETWORK_ID_TIMEOUT
パラメータを取得または設定します。
パラメータ
networkidtimeout [timeout]
オプションの timeout
引数を使用して、NETWORK_ID_TIMEOUT
パラメータの値を設定します。
例
networkidtimeout 120
Done
networkidtimeout
120
Done
CLI と API リファレンス
networkkey(鍵)
Thread ネットワーク キーを設定します。
Thread プロトコルが無効になっている場合にのみ成功します。この関数の呼び出しが成功すると、不揮発性メモリ内のアクティブな運用データセットと保留中の運用データセットが無効になります。
パラメータ
networkkey key
例
networkkey 00112233445566778899aabbccddeeff
Done
CLI と API リファレンス
ネットワークキー
Thread ネットワーク キーを取得します。
パラメータ
パラメータなし。
例
networkkey
00112233445566778899aabbccddeeff
Done
CLI と API リファレンス
networkname(名前)
Thread ネットワーク名を設定します。
Thread プロトコルが無効になっている場合にのみ成功します。この関数の呼び出しが成功すると、不揮発性メモリ内のアクティブな運用データセットと保留中の運用データセットが無効になります。
パラメータ
networkname name
例
networkname OpenThread
Done
CLI と API リファレンス
ネットワーク名
Thread ネットワーク名を取得します。
パラメータ
パラメータなし。
例
networkname
OpenThread
Done
CLI と API リファレンス
networktime(設定)
時刻同期パラメータを設定します。
timesyncperiod
: 時刻同期期間(秒単位)。xtalthreshold
: デバイスがルーター対応デバイスになるための XTAL 精度のしきい値(PPM 単位)。
パラメータ
networktime timesyncperiod xtalthreshold
例
networktime 100 300
Done
CLI と API リファレンス
networktime
Thread のネットワーク時刻と時刻同期パラメータを取得します。
パラメータ
パラメータなし。
例
networktime
Network Time: 21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold: 300ppm
Done
CLI と API リファレンス
ネクストホップ(get)
指定された RLOC16 の宛先へのネクストホップとパスのコストを取得します。
aNextHopRloc16
または aPathCost
が NULL の場合に使用でき、呼び出し元は値の取得を望んでいません。
パラメータ
nexthop rloc16
例
nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done
CLI と API リファレンス
ネクストホップ
割り当てられたルーター ID と、各ルーターの現在のネクストホップとパスコストの出力テーブル。
パラメータ
パラメータなし。
例
nexthop
| ID |NxtHop| Cost |
+------+------+------+
| 9 | 9 | 1 |
| 25 | 25 | 0 |
| 30 | 30 | 1 |
| 46 | - | - |
| 50 | 30 | 3 |
| 60 | 30 | 2 |
Done
CLI と API リファレンス
panid(panid)
IEEE 802.15.4 PAN ID を設定します。
Thread プロトコルが無効になっている場合にのみ成功します。この関数の呼び出しが成功すると、不揮発性メモリ内のアクティブな運用データセットと保留中の運用データセットも無効になります。
パラメータ
panid panid
例
panid 0xdead
Done
CLI と API リファレンス
パニド
IEEE 802.15.4 PAN ID を取得します。
パラメータ
パラメータなし。
例
panid
0xdead
Done
CLI と API リファレンス
parent
親としての Thread Router の診断情報を取得します。
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE が有効になっているときに Thread Router として動作している場合、このコマンドは以前にデバイスが Thread 子としてアタッチされていたときのキャッシュされた情報を返します。スレッド テストハーネス - テストシナリオ 8.2.x をサポートするには、キャッシュされた情報を返す必要があります。デバイスがすでにルーターに昇格している場合でも、以前の親(ジョイナー ルーター)の MAC アドレスをリクエストします。
パラメータ
パラメータなし。
例
parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done
CLI と API リファレンス
保護者による検索
現在の親とのつながりを維持しながら、子が適切な親を検索するプロセスを開始します。
デバイスが子供として接続されている場合に使用する必要があります。
パラメータ
パラメータなし。
例
parent search
Done
CLI と API リファレンス
parentpriority(get,set)
割り当てられた親の優先度の値(1、0、-1、-2)を取得または設定します。-2 は割り当てられていないことを意味します。
パラメータ
parentpriority [parentpriority]
例
parentpriority
1
Done
parentpriority 1
Done
CLI と API リファレンス
パーティション ID
Thread ネットワーク パーティション ID を取得します。
パラメータ
パラメータなし。
例
partitionid
4294967295
Done
CLI と API リファレンス
パーティション ID 推奨(get、set)
OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
は必須です。
パラメータ
partitionid preferred partitionid
例
partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done
CLI と API リファレンス
platform
現在のプラットフォームを出力する
パラメータ
パラメータなし。
例
platform
NRF52840
Done
CLI と API リファレンス
- 関連付けられている API はありません
pollperiod(取得、設定)
スリーピー エンド デバイスのカスタマイズされたデータ ポーリング期間(ミリ秒)を取得または設定します。認定テストのみ。
パラメータ
パラメータなし。
例
pollperiod
0
Done
pollperiod 10
Done
CLI と API リファレンス
Preferredrouterid
リーダーが要求時に指定する優先ルーター ID を指定します。
パラメータ
preferrouterid routerid
例
preferrouterid 16
Done
CLI と API リファレンス
接頭辞の追加
ネットワーク データに有効なプレフィックスを追加します。
パラメータ
prefix add prefix [padcrosnD] [high|med|low]
OT CLI はマッピングされた引数を使用して otBorderRouterConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done
CLI と API リファレンス
プレフィックス meshlocal
メッシュのローカル接頭辞を取得します。
パラメータ
パラメータなし。
例
prefix meshlocal
fdde:ad00:beef:0::/64
Done
CLI と API リファレンス
- 関連付けられている API はありません
接頭辞
ローカル ネットワーク データのプレフィックス リストを取得します。
otBorderRouterConfig フラグの詳細については、OpenThread CLI の概要をご覧ください。
パラメータ
パラメータなし。
例
prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done
CLI と API リファレンス
接頭辞の削除
ローカル ネットワーク データからボーダー ルーターの設定を削除します。
パラメータ
パラメータなし。
例
prefix remove 2001:dead:beef:cafe::/64
Done
CLI と API リファレンス
プロミスキャス(有効、無効)
リンクレイヤのプロミスキャス モードを有効または無効にします。
パラメータ
promiscuous enable|disable
例
promiscuous enable
Done
promiscuous disable
Done
CLI と API リファレンス
プロミス
リンクレイヤでプロミスキャス モードが有効になっているかどうかを示します。
パラメータ
パラメータなし。
例
promiscuous
Disabled
Done
CLI と API リファレンス
pskc(set)
pskc を 16 進数形式で設定します。
パラメータ
pskc key
例
pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
CLI と API リファレンス
- 関連付けられている API はありません
pskc -p
パスフレーズ(UTF-8 でエンコード)から、現在のネットワーク名と拡張 PAN ID と一緒に pskc を生成します。
パラメータ
pskc -p passphrase
例
pskc -p 123456
Done
CLI と API リファレンス
- 関連付けられている API はありません
PSKC
スレッド PSKc を取得します。
パラメータ
パラメータなし。
例
pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
CLI と API リファレンス
pskcref(set)
キー参照をスレッド PSKc に設定します。
ビルド時の機能 OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
を有効にする必要があります。
Thread プロトコルが無効になっている場合にのみ成功します。成功すると、不揮発性メモリ内のアクティブな運用データセットと保留中の運用データセットも無効になります。
パラメータ
pskc keyref
例
pskc 0x20017
Done
CLI と API リファレンス
pskcref
保存されたスレッド PSKc へのキー参照を取得します。
ビルド時の機能 OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
を有効にする必要があります。
パラメータ
パラメータなし。
例
pskcref
0x80000000
Done
CLI と API リファレンス
ラジオ(有効、無効)
無線通信を有効または無効にします。
パラメータ
radio enable|disable
例
radio enable
Done
radio disable
Done
CLI と API リファレンス
ラジオの統計情報をクリアしました
無線通信の統計情報をリセットします。
時間はすべて 0 にリセットされます。
パラメータ
パラメータなし。
例
radio stats clear
Done
CLI と API リファレンス
ラジオの統計情報
ラジオの統計情報を取得します。
無線統計情報には、無線通信が TX/RX/スリープ状態の時間が含まれます。時間はマイクロ秒単位です。時間はすべて、無線統計情報の最後のリセットから計算されます。
パラメータ
パラメータなし。
例
radio stats
Radio Statistics:
Total Time: 67.756s
Tx Time: 0.022944s (0.03%)
Rx Time: 1.482353s (2.18%)
Sleep Time: 66.251128s (97.77%)
Disabled Time: 0.000080s (0.00%)
Done
CLI と API リファレンス
RCP バージョン
ラジオのバージョン文字列を取得します。
パラメータ
パラメータなし。
例
rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun 4 2020 17:53:16
Done
CLI と API リファレンス
region(セット)
地域コードを設定します。
ラジオ リージョンの形式は、ISO 3166 alpha-2 コードの 2 バイトの ASCII 表現です。
これを変更すると、送信電力制限に影響することがあります。
パラメータ
パラメータなし。
例
region US
Done
CLI と API リファレンス
地域
地域コードを取得します。
ラジオ リージョンの形式は、ISO 3166 alpha-2 コードの 2 バイトの ASCII 表現です。
パラメータ
パラメータなし。
例
region
US
Done
CLI と API リファレンス
releaserouterid(routerid)
リーダーロールのデバイスによって割り当てられたルーター ID を解放します。
パラメータ
releaserouterid [routerid]
例
releaserouterid 16
Done
CLI と API リファレンス
rloc16
RLOC16 を入手します。
パラメータ
パラメータなし。
例
rloc16
0xdead
Done
CLI と API リファレンス
ルートの追加
パラメータには以下を使用します。
- s: 安定フラグ
- n: NAT64 フラグ
- prf: デフォルトのルーターの設定([高、中、低])。
ネットワーク データに有効な外部ルートを追加します。
パラメータ
route add prefix [sn] [high|med|low]
例
route add 2001:dead:beef:cafe::/64 s med
Done
CLI と API リファレンス
ルートの削除
ローカル ネットワーク データから外部ルート構成を削除します。
パラメータ
route remove [prefix]
例
route remove 2001:dead:beef:cafe::/64
Done
CLI と API リファレンス
経路
ローカル ネットワーク データの外部ルートリストを取得します。
パラメータ
パラメータなし。
例
route
2001:dead:beef:cafe::/64 s med
Done
CLI と API リファレンス
ルーター(ID)
この関数は、特定の Thread Router の診断情報を保持します。
Thread Router の診断情報を出力します。ID はルーター ID または RLOC16 です。
パラメータ
router [id]
例
router 50
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 3
Done
router 0xc800
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 7
Done
CLI と API リファレンス
ルーターリスト
割り振られたルーター ID を一覧表示します。
パラメータ
パラメータなし。
例
router list
8 24 50
Done
CLI と API リファレンス
ルーター テーブル
ルーターのリストを表形式で出力します。
パラメータ
パラメータなし。
例
router table
| ID | RLOC16 | Next Hop | Path Cost | LQ In | LQ Out | Age | Extended MAC | Link |
+----+--------+----------+-----------+-------+--------+-----+------------------+------+
| 22 | 0x5800 | 63 | 0 | 0 | 0 | 0 | 0aeb8196c9f61658 | 0 |
| 49 | 0xc400 | 63 | 0 | 3 | 3 | 0 | faa1c03908e2dbf2 | 1 |
Done
CLI と API リファレンス
routerdowngradethreshold(get、set)
ROUTER_DOWNGRADE_THRESHOLD 値を取得または設定します。
パラメータ
routerdowngradethreshold [threshold]
例
routerdowngradethreshold
23
Done
routerdowngradethreshold 23
Done
CLI と API リファレンス
ルーター対応(enable、disable)
ルーターのロールを有効または無効にします。
パラメータ
routereligible [enable|disable]
例
routereligible enable
Done
routereligible disable
Done
CLI と API リファレンス
ルーター対応
ルーターのロールが有効か無効かを示します。
パラメータ
パラメータなし。
例
routereligible
Enabled
Done
CLI と API リファレンス
ルーター選択ジッター
ROUTER_SELECTION_JITTER 値を取得または設定します。
パラメータ
routerselectionjitter [jitter]
例
routerselectionjitter
120
Done
routerselectionjitter 120
Done
CLI と API リファレンス
routerupgradethreshold(get、set)
ROUTER_UPGRADE_THRESHOLD 値を取得または設定します。
パラメータ
routerupgradethreshold [threshold]
例
routerupgradethreshold
16
Done
routerupgradethreshold 16
Done
CLI と API リファレンス
スキャン エネルギー
IEEE 802.15.4 エネルギー スキャンを実行し、各チャンネルのスキャンに使う時間をミリ秒単位で表示します。チャネル オプションを使用して特定のチャネルを指定しない限り、すべてのチャネルが表示されます。
パラメータ
scan energy [duration] [channel]
例
scan energy 10
| Ch | RSSI |
+----+------+
| 11 | -59 |
| 12 | -62 |
| 13 | -67 |
| 14 | -61 |
| 15 | -87 |
| 16 | -86 |
| 17 | -86 |
| 18 | -52 |
| 19 | -58 |
| 20 | -82 |
| 21 | -76 |
| 22 | -82 |
| 23 | -74 |
| 24 | -81 |
| 25 | -88 |
| 26 | -71 |
Done
scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 | -82 |
Done
CLI と API リファレンス
スキャン
アクティブな IEEE 802.15.4 スキャンを実行します。チャネルが指定されていない場合、スキャンはすべてのチャネルをカバーします。それ以外の場合、スパンは指定されたチャネルのみをカバーします。
パラメータ
scan [channel]
例
scan
| PAN | MAC Address | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
CLI と API リファレンス
サービスの追加
ネットワーク データにサービスを追加します。
- enterpriseNumber: IANA エンタープライズ番号
- serviceData: 16 進数でエンコードされたバイナリ サービスデータ
- serverData: 16 進数でエンコードされたバイナリ サーバーデータ
パラメータ
service add enterpriseNumber serviceData serverData
例
service add 44970 112233 aabbcc
Done
netdata register
Done
CLI と API リファレンス
サービスの削除
ネットワーク データからサービスを削除します。
- enterpriseNumber: IANA エンタープライズ番号
- serviceData: 16 進数でエンコードされたバイナリ サービスデータ
パラメータ
service remove enterpriseNumber serviceData
例
service remove 44970 112233
Done
netdata register
Done
CLI と API リファレンス
シングルトン
ノードがネットワーク上の唯一のルーターかどうかを示します。true
または false
を返します。
パラメータ
パラメータなし。
例
singleton
true
Done
CLI と API リファレンス
sntp クエリ
現在の unix エポック時刻(1970 年 1 月 1 日から)を取得するために、SNTP クエリを送信します。
- SNTP サーバーのデフォルトの IP アドレス:
2001:4860:4806:8::
(Google IPv6 NTP サーバー) - SNTP サーバーのデフォルト ポート:
123
パラメータ
sntp query [SNTP server IP] [SNTP server port]
例
sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done
CLI と API リファレンス
SRP クライアントの自動起動(get)
自動起動モードの現在の状態(有効または無効)を示します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp client autostart
Disabled
Done
CLI と API リファレンス
SRP クライアント自動起動の無効化
自動起動モードを無効にします。
自動起動モードを無効にしても、実行中のクライアントは停止しません。ただし、SRP クライアントは Thread ネットワーク データのモニタリングを停止します。
パラメータ
パラメータなし。
例
srp client autostart disable
Done
CLI と API リファレンス
SRP クライアント自動起動の有効化
自動起動モードを有効にします。
自動起動が有効になっている場合、SRP クライアントは Thread ネットワーク データを監視して SRP サーバーを検出し、優先サーバーを選択し、SRP サーバーが検出されたときにクライアントを自動的に起動および停止します。
ネットワーク データ エントリの 3 つのカテゴリは、SRP サーバーが存在することを示し、次の順序で優先されます。
- サーバー アドレスがサービスデータに含まれるユニキャスト エントリ。複数のオプションがある場合は、数値が小さい IPv6 アドレスが優先されます。
- それぞれにシーケンス番号を持つエニーキャスト エントリ。RFC-1982 の Serial Number Arithmetic Logic(シリアル番号演算ロジック)で指定されている最大のシーケンス番号が推奨されます。
- サーバー アドレス情報がサーバーデータに含まれるユニキャスト エントリ。複数のオプションがある場合は、数値が小さい IPv6 アドレスが優先されます。
パラメータ
パラメータなし。
例
srp client autostart enable
Done
CLI と API リファレンス
SRP クライアントのコールバック(get、enable、disable)
SRP クライアントからの印刷コールバック イベントを取得または有効/無効にします。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp client callback [enable|disable]
例
srp client callback enable
Done
srp client callback
Enabled
Done
CLI と API リファレンス
SRP クライアントのホストアドレス(get)
自動アドレス モードが有効かどうかを示します。自動アドレスモードが有効になっていない場合は、SRP クライアント ホストアドレスのリストが返されます。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp client host address
auto
Done
srp client host address
fd00:0:0:0:0:0:0:1234
fd00:0:0:0:0:0:0:beef
Done
CLI と API リファレンス
SRP クライアントのホストアドレス(設定)
自動ホストアドレス モードを有効にするか、ホストアドレスのリストを明示的に設定します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp client host address [auto|address...]
- 自動ホストアドレス モードを有効にするには、
auto
パラメータを使用します。有効にすると、クライアントはリンクローカル アドレスとメッシュローカル アドレスを除くすべての優先 Threadnetif
ユニキャスト アドレスを自動的に使用します。有効なアドレスがない場合は、メッシュのローカル EID アドレスが追加されます。スレッドnetif
でアドレスが追加または削除されたり、非優先としてマークされたりすると、SRP クライアントは自動的に再登録されます。 - ホストアドレスのリストを明示的に指定し、各アドレスはスペースで区切ります。このリストは、クライアントの実行中に設定できます。これにより、自動ホストアドレス モードも無効になります。
例
srp client host address auto
Done
srp client host address fd00::cafe
Done
CLI と API リファレンス
SRP クライアント ホストの消去
すべてのホスト情報とすべてのサービスを消去します。
パラメータ
パラメータなし。
例
srp client host clear
Done
CLI と API リファレンス
SRP クライアントのホスト名(get、set)
SRP クライアントのホスト名を取得または設定します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp client host name [name]
ホストが削除された場合、またはサーバーにまだ登録されていない場合に、クライアント ホスト名を設定するには、name
パラメータを使用します。
例
srp client host name dev4312
Done
srp client host name
dev4312
Done
CLI と API リファレンス
SRP クライアントのホストの削除
SRP クライアント ホスト情報とすべてのサービスを SRP サーバーから削除します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp client host remove [removekeylease] [sendunregtoserver]
- パラメータ
removekeylease
は、ホストキーリースも削除する必要があるかどうかを示すブール値(省略可)です(デフォルトはfalse
)。 - パラメータ
sendunregtoserver
は、クライアント ホスト情報がサーバーに登録されていない場合でも、クライアント ホストがサーバーに「更新」メッセージを送信する必要があるかどうかを示すブール値(省略可)です(デフォルトはfalse
)。このパラメータは、コマンドでremovekeylease
パラメータが最初に指定されている場合にのみ指定できます。
例
srp client host remove 1
Done
CLI と API リファレンス
SRP クライアント ホスト
ホスト情報を取得します。
パラメータ
パラメータなし。
例
srp client host
name:"dev4312", state:Registered, addrs:[fd00:0:0:0:0:0:0:1234, fd00:0:0:0:0:0:0:beef]
Done
CLI と API リファレンス
SRP クライアントのホスト状態
SRP クライアント ホストの状態を返します。ステータス:
ToAdd
: 追加または登録する項目。Adding
: アイテムは追加または登録中です。ToRefresh
: リース更新時に更新する項目。Refreshing
: アイテムはベージュ色に更新されます。ToRemove
: 削除するアイテム。Removing
: アイテムを削除しています。Registered
: アイテムはサーバーに登録されています。Removed
: アイテムは削除されました。
パラメータ
パラメータなし。
例
srp client host state
Registered
Done
CLI と API リファレンス
- 関連付けられている API はありません
SRP クライアント keyleaseinterval(get、set)
キーリース間隔を秒単位で取得または設定します。
パラメータ
srp client keyleaseinterval [interval]
例
srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done
CLI と API リファレンス
SRP クライアント leaseinterval(get、set)
リース間隔を秒単位で取得または設定します。
パラメータ
srp client leaseinterval [interval]
例
srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done
CLI と API リファレンス
SRP クライアント サーバー アドレス
サーバーの IPv6 アドレスを返します。
パラメータ
パラメータなし。
例
srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done
CLI と API リファレンス
- 関連付けられている API はありません
SRP クライアント サーバー ポート
サーバーのポート番号を返します。
パラメータ
パラメータなし。
例
srp client server port
4724
Done
CLI と API リファレンス
- 関連付けられている API はありません
SRP クライアント サーバー
SRP クライアントで使用されている SRP サーバーのソケット アドレス(IPv6 アドレスとポート番号)を取得します。クライアントが実行されていない場合、アドレスは未指定(すべてゼロ)で、ポート番号は 0 です。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done
CLI と API リファレンス
SRP クライアント サービスの追加
指定されたインスタンス名、サービス名、ポート番号を持つサービスを追加します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp client service add instancename servicename port [priority] [weight] [txt]
servicename
パラメータには、必要に応じて、サービスのサブタイプ ラベルをカンマで区切ったリストを含めることができます。この例では一般的な名前を使用しています。priority
パラメータと weight
パラメータ(どちらも uint16_t
値)は省略可能で、指定しない場合は 0 が使用されます。オプションの txt
パラメータは、サービスに関連付けられた TXT データを設定します。txt
値は 16 進文字列形式である必要があり、エンコード済みの TXT データバイト シーケンスとして扱われます。
例
srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done
CLI と API リファレンス
SRP クライアント サービスキー(get、set)
SRP クライアントのサービスキー レコード インクルード モードを取得または設定します。このコマンドはテスト専用で、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
を有効にする必要があります。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp client service key enable
Done
srp client service key
Enabled
Done
CLI と API リファレンス
SRP クライアント サービス名の消去
SRP サーバーとのやり取りなしで、サービスを消去し、クライアント サービス リストから直ちに削除します。
パラメータ
srp client service clear instancename servicename
例
srp client service clear ins2 _test2._udp
Done
CLI と API リファレンス
SRP クライアント サービスの削除
SRP サーバーのサービスの登録解除をリクエストします。
パラメータ
srp client service remove instancename servicename
例
srp client service remove ins2 _test2._udp
Done
CLI と API リファレンス
SRP クライアント サービス
クライアントによって管理されているサービスのリストを取得します。
パラメータ
パラメータなし。
例
srp client service
instance:"ins2", name:"_test2._udp,_sub1,_sub2", state:Registered, port:111, priority:1, weight:1
instance:"ins1", name:"_test1._udp", state:Registered, port:777, priority:0, weight:0
Done
CLI と API リファレンス
SRP クライアントの開始
SRP クライアント オペレーションを開始します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp client start serveraddr serverport
例
srp client start fd00::d88a:618b:384d:e760 4724
Done
CLI と API リファレンス
SRP クライアントの状態
SRP クライアントが実行中かどうかを示します。
パラメータ
パラメータなし。
例
srp client state
Enabled
Done
CLI と API リファレンス
SRP クライアント停止
SRP クライアント オペレーションを停止します。
SRP サーバーとのやり取りをすべて停止します。ホスト情報やサービスのリストは削除されません。クライアントが再開(再起動)されると、すべてのサービスが再び追加/削除されるようマークされます。
パラメータ
パラメータなし。
例
srp client stop
Done
CLI と API リファレンス
SRP クライアント ttl(get、set)
ttl
(有効期間)の値を秒単位で取得または設定します。
パラメータ
srp client ttl [value]
例
srp client ttl 3600
Done
srp client ttl
3600
Done
CLI と API リファレンス
SRP サーバー(有効、無効)
SRP サーバーを有効または無効にします。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp server [enable|disable]
例
srp server disable
Done
CLI と API リファレンス
SRP サーバーの addrmode(get、set)
SRP サーバーで使用されるアドレス モードを取得または設定します。
アドレスモードは、アドレスとポート番号を決定する方法を SRP サーバーに指示し、Thread ネットワーク データにパブリッシュされます。
パラメータ
srp server addrmode [anycast|unicast]
例
srp server addrmode anycast
Done
srp server addrmode
anycast
Done
CLI と API リファレンス
SRP サーバー自動(有効、無効)
SRP サーバーの自動有効化モードを有効または無効にします。
このモードを有効にすると、Border Routing Manager により、SRP サーバーを有効または無効にするかどうか、またそのタイミングが決まります。
このコマンドを使用するには、OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE
を有効にする必要があります。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
srp server auto [enable|disable]
例
srp server auto enable
Done
srp server auto
Enabled
Done
CLI と API リファレンス
SRP サーバー ドメイン(get、set)
SRP サーバーのドメイン名を取得または設定します。
パラメータ
srp server domain [domain-name]
例
srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done
CLI と API リファレンス
SRP サーバーホスト
登録済みのすべてのホストに関する情報を返します。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp server host
srp-api-test-1.default.service.arpa.
deleted: false
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0.default.service.arpa.
deleted: false
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done
CLI と API リファレンス
SRP サーバー リース(get、set)
SRP サーバーのリース値を秒単位で取得または設定します。
パラメータ
srp server lease [min-lease max-lease min-key-lease max-key-lease]
例
srp server lease 1800 7200 86400 1209600
Done
srp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Done
CLI と API リファレンス
SRP Server seqnum(get、set)
エニーキャスト アドレス モードで使用されるシーケンス番号を取得または設定します。シーケンス番号は、ネットワーク データで公開される [DNS/SRP サービス エニーキャスト アドレス] エントリに含まれています。
パラメータ
srp server seqnum [seqnum]
例
srp server seqnum 20
Done
srp server seqnum
20
Done
CLI と API リファレンス
SRP サーバー サービス
登録されたサービスに関する情報を返します。
TXT
レコードは、エントリの配列として表示されます。エントリにキーが含まれる場合、キーは ASCII 形式で出力されます。値の部分は 16 進数のバイト単位で出力されます。詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp server service
srp-api-test-1._ipps._tcp.default.service.arpa.
deleted: false
subtypes: (null)
port: 49152
priority: 0
weight: 0
ttl: 7200
lease: 7200
key-lease: 1209600
TXT: [616263, xyz=585960]
host: srp-api-test-1.default.service.arpa.
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0._ipps._tcp.default.service.arpa.
deleted: false
subtypes: _sub1,_sub2
port: 49152
priority: 0
weight: 0
ttl: 3600
lease: 3600
key-lease: 1209600
TXT: [616263, xyz=585960]
host: srp-api-test-0.default.service.arpa.
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done
CLI と API リファレンス
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
SRP サーバーの状態
SRP サーバーの次のいずれかの状態を返します。
disabled
: SRP サーバーが有効になっていません。stopped
: SRP サーバーは有効になっていますが、既存の SRP サーバーが Thread ネットワークですでにアクティブになっているため、アクティブではありません。Thread ネットワーク内で既存の SRP サーバーがアクティブでなくなると、SRP サーバーがアクティブになることがあります。running
: SRP サーバーがアクティブで、サービス登録を処理できます。
詳細については、OT CLI を使用したサービス登録プロトコル(SRP)のサーバー クライアント接続を設定するをご覧ください。
パラメータ
パラメータなし。
例
srp server state
running
Done
CLI と API リファレンス
state
Thread デバイスの現在のロールを返すか、いずれかのオプションで指定されたロールを変更します。デバイスの役割を問い合わせた際に返される可能性のある値:
child
: デバイスは現在、Thread の子として動作しています。router
: デバイスは現在、Thread ルーターとして動作しています。leader
: デバイスは現在、Thread リーダーとして動作しています。detached
: デバイスは現在 Thread ネットワーク/パーティションに参加していません。disabled
: スレッド スタックは現在無効になっています。
いずれかのオプションを使用すると、デバイスの現在のロールを変更できます。ただし、disabled
状態から、または disabled
状態からの変化は除きます。
パラメータ
state [child|router|leader|detached]
例
state
child
Done
state leader
Done
CLI と API リファレンス
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
tcp 中止
サンプルの TCP エンドポイントに関連付けられている TCP 接続を予期せず終了し、TCP エンドポイントを閉じた状態に移行します。
パラメータ
パラメータなし。
例
tcp abort
TCP: Connection reset
Done
CLI と API リファレンス
tcp ベンチマークの結果
TCP ベンチマーク テストの最新の結果が表示されます。ステータス値の例は次のとおりです。
- 継続中
- 完了
- テストなし
このコマンドは、TCP ベンチマーク テストを自動化するスクリプトを作成することを主な目的としています。
パラメータ
パラメータなし。
例
tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s
CLI と API リファレンス
- 関連付けられている API はありません
tcp ベンチマーク実行
tcp
CLI で指定されたサンプル TCP エンドポイントに現在関連付けられている TCP 接続を使用して、指定されたバイト数を転送します。
パラメータ
tcp benchmark run [size]
size
パラメータを使用して、ベンチマークに送信するバイト数を指定します。size
パラメータを使用しない場合は、デフォルト値(OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE
)が使用されます。
例
tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s
CLI と API リファレンス
- 関連付けられている API はありません
tcp バインド
IPv6 アドレスとポートを、tcp
CLI で指定されたサンプル TCP エンドポイントに関連付けます。TCP エンドポイントを IPv6 アドレスとポートに関連付けることは、「TCP エンドポイントの命名」と呼ばれます。これにより、通信用のエンドポイントがバインドされます。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp bind ip port
ip
: バインド先の IPv6 アドレス。TCP/IPv6 スタックにバインディング IPv6 アドレスを割り当てる場合は、未指定 IPv6 アドレス::
を使用します。port
: バインドする TCP ポート番号。
例
tcp bind :: 30000
Done
CLI と API リファレンス
TCP 接続
指定したピアとの接続を確立します。
接続の確立が成功すると、結果の TCP 接続はサンプルの TCP エンドポイントに関連付けられます。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp connect ip port [fastopen]
ip
: ピアの IP アドレス。アドレスは IPv4 アドレスで、ネットワーク データから優先 NAT64 プレフィックスを使用して IPv6 アドレスに合成されます。優先 NAT64 プレフィックスが使用できない場合、このコマンドはInvalidState
を返します。port
: ピアの TCP ポート番号。fastopen
: このパラメータは省略可能です。fast
に設定すると、この接続で TCP Fast Open が有効になります。このパラメータをslow
に設定するか使用しない場合、TCP Fast Open は無効になります。
例
tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established
tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
CLI と API リファレンス
tcp 確定
この TCP エンドポイントの初期化を解除します。
つまり、OpenThread は、この TCP エンドポイントを追跡しなくなり、この TCP エンドポイント用に内部的に割り当てられたすべてのリソースの割り当てを解除します。アプリケーションは、TCP エンドポイントをサポートするメモリを適宜再利用できます。
ライブ TCP 接続に対応する場合、接続は(otTcpAbort() のように)意図せず終了されます。アプリケーションがこの TCP エンドポイントに提供しているすべてのリソース(送信バッファのリンクされたバッファ、受信バッファのメモリ、aEndpoint
構造体自体など)は、すぐにアプリケーションに返されます。
パラメータ
パラメータなし。
例
tcp deinit
Done
CLI と API リファレンス
TCP init
tcp
CLI によって提供されるサンプル TCP リスナーとサンプル TCP エンドポイントを初期化します。
パラメータ
tcp init [mode] [size]
mode
には次の 3 つの値を使用できます。tls
: 2 つのノード間の TCP 接続でも、TCP に加えて TLS プロトコルを使用するように指定します。2 つのノードが TCP で通信する場合は、両方のノードで TLS を使用するか、どちらのノードも TLS を使用しないようにします(非 TLS エンドポイントは TLS エンドポイントと通信できないため)。linked
またはcircular
: これらのオプションのいずれかは、TLS を使用せず、指定されたバッファリング タイプを TCP バッファリングに使用する必要があることを意味します。linked
とcircular
の動作は同じです。コードを調べて、この 2 つのバッファタイプの違いを確認します。TCP 接続の 2 つのエンドポイントが同じバッファリング タイプを使用する必要はありません。
size
パラメータは、サンプルの TCP エンドポイントに関連付ける受信バッファのサイズを設定します。指定しない場合は、最大サイズが使用されます。最大サイズはOPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE
で設定されます。
例
tcp init tls
Done
CLI と API リファレンス
tcp リッスン
サンプルの TCP リスナーを使用して、指定された IPv6 アドレスとポートで受信接続をリッスンします。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp listen ip port
次のパラメータを指定します。
ip
:tcp
CLI によって提供されるサンプル TCP リスナーの IPv6 アドレスまたは未指定 IPv6 アドレス(::
)。port
: サンプルの TCP リスナーの TCP ポート。サンプルの TCP エンドポイントに TCP 接続が関連付けられていない場合、指定された IPv6 アドレスとポートに一致する受信接続はすべて受け入れられ、サンプルの TCP エンドポイントに関連付けられます。
例
tcp listen :: 30000
Done
CLI と API リファレンス
TCP 送信
tcp
CLI に用意されているサンプル TCP エンドポイントに関連付けられた TCP 接続を介してデータを送信します。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp send message
message
パラメータには、リモート TCP エンドポイントに送信するメッセージが含まれています。
例
tcp send hello
Done
CLI と API リファレンス
- 関連付けられている API はありません
tcp sendend
tcp
CLI で指定されたサンプル TCP エンドポイントに関連付けられた TCP 接続を介して「ストリーム終了」シグナルを送信します。これにより、この TCP 接続でこれ以上データを受信しないことがピアに通知されます。
パラメータ
パラメータなし。
例
tcp sendend
Done
CLI と API リファレンス
TCP ストップリスニング
受信 TCP 接続のリッスンを停止するようにサンプル TCP リスナーに指示します。
パラメータ
パラメータなし。
例
tcp stoplistening
Done
CLI と API リファレンス
tmforiginfilter をテストする
信頼できない送信元からの TMF UDP メッセージをドロップするフィルタを有効または無効にします。
デフォルトでは、信頼できない送信元からの TMF UDP メッセージをドロップするフィルタが有効になっています。無効にすると、信頼できない送信元(ホスト、CLI、外部 IPv6 ノードなど)から TMF ポートに送信された UDP メッセージが許可されます。
パラメータ
test tmforiginfilter [enable|disable]
例
test tmforiginfilter
Enabled
test tmforiginfilter enable
Done
test tmforiginfilter disable
Done
CLI と API リファレンス
- 関連付けられている API はありません
スレッドの開始
Thread プロトコル オペレーションを開始します。
パラメータ
パラメータなし。
例
thread start
Done
CLI と API リファレンス
スレッド停止
Thread プロトコル オペレーションを停止します。
パラメータ
パラメータなし。
例
thread stop
Done
CLI と API リファレンス
- 関連付けられている API はありません
スレッドのバージョン
Thread プロトコルのバージョンを取得します。
パラメータ
パラメータなし。
例
thread version
2
Done
CLI と API リファレンス
timeinqueue の最大値
TX キュー内のメッセージのキュー内最長時間を取得します。
OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
が必要です。
キュー内の時間は直接送信についてのみ追跡され、メッセージが送信キューに追加されてから、送信のために MAC レイヤに渡されるか、またはドロップされるまでの時間として測定されます。
収集された統計情報は、
otThreadResetTimeInQueueStat()
を呼び出すことでリセットできます。
パラメータ
パラメータなし。
例
timeinqueue max
281
Done
CLI と API リファレンス
timeinqueue のリセット
TX キュー内のキュー内の時間の統計情報をリセットします。
OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
が必要です。
パラメータ
パラメータなし。
例
timeinqueue reset
Done
CLI と API リファレンス
timeinqueue
TX キュー内のメッセージのキュー内時間ヒストグラムを取得します。
OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
が必要です。
送信キュー内のメッセージのキュー内時間のヒストグラムが収集されます。キュー内の時間は直接送信についてのみ追跡され、メッセージが送信キューに追加されてから、送信のために MAC レイヤに渡されるか、またはドロップされるまでの時間として測定されます。
ヒストグラムは、aNumBins
エントリを持つ uint32_t
値の配列として返されます。配列の最初のエントリ(インデックス 0)は、キュー内の待機時間が aBinInterval
未満のメッセージの数を表します。2 番目のエントリは、キュー内の待機時間が aBinInterval
以上、2 * aBinInterval
未満であるメッセージの数を表します。といった情報です。最後のエントリは、キュー内の時間が (aNumBins - 1) * aBinInterval
以上のメッセージの数を表します。
収集された統計情報は、
otThreadResetTimeInQueueStat()
を呼び出すことでリセットできます。ヒストグラム情報は、OpenThread インスタンスの初期化以降、または最後に
otThreadResetTimeInQueueStat()
を呼び出して統計情報の収集をリセットした後に収集されます。
ポインタ aNumBins
と aBinInterval
が NULL であってはなりません。
パラメータ
パラメータなし。
例
timeinqueue
| Min | Max |Msg Count|
+------+------+---------+
| 0 | 9 | 1537 |
| 10 | 19 | 156 |
| 20 | 29 | 57 |
| 30 | 39 | 108 |
| 40 | 49 | 60 |
| 50 | 59 | 76 |
| 60 | 69 | 88 |
| 70 | 79 | 51 |
| 80 | 89 | 86 |
| 90 | 99 | 45 |
| 100 | 109 | 43 |
| 110 | 119 | 44 |
| 120 | 129 | 38 |
| 130 | 139 | 44 |
| 140 | 149 | 35 |
| 150 | 159 | 41 |
| 160 | 169 | 34 |
| 170 | 179 | 13 |
| 180 | 189 | 24 |
| 190 | 199 | 3 |
| 200 | 209 | 0 |
| 210 | 219 | 0 |
| 220 | 229 | 2 |
| 230 | 239 | 0 |
| 240 | 249 | 0 |
| 250 | 259 | 0 |
| 260 | 269 | 0 |
| 270 | 279 | 0 |
| 280 | 289 | 0 |
| 290 | 299 | 1 |
| 300 | 309 | 0 |
| 310 | 319 | 0 |
| 320 | 329 | 0 |
| 330 | 339 | 0 |
| 340 | 349 | 0 |
| 350 | 359 | 0 |
| 360 | 369 | 0 |
| 370 | 379 | 0 |
| 380 | 389 | 0 |
| 390 | 399 | 0 |
| 400 | 409 | 0 |
| 410 | 419 | 0 |
| 420 | 429 | 0 |
| 430 | 439 | 0 |
| 440 | 449 | 0 |
| 450 | 459 | 0 |
| 460 | 469 | 0 |
| 470 | 479 | 0 |
| 480 | 489 | 0 |
| 490 | inf | 0 |
Done
CLI と API リファレンス
trel(enable、disable)
TREL 無線通信の動作を有効または無効にします。
パラメータ
trel enable|disable
例
trel enable
Done
trel disable
Done
CLI と API リファレンス
トレル カウンタのリセット
TREL カウンタをリセットします。
パラメータ
パラメータなし。
例
trel counters reset
Done
CLI と API リファレンス
トレル カウンタ
TREL カウンタを取得します。
パラメータ
パラメータなし。
例
trel counters
Inbound: Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done
CLI と API リファレンス
trel フィルタ(有効、無効)
TREL フィルタモードを有効または無効にします。
パラメータ
trel filter enable|disable
例
trel filter enable
Done
trel filter disable
Done
CLI と API リファレンス
トレル フィルタ
TREL フィルタモードが有効かどうかを示します。
フィルタモードを有効にすると、TREL インターフェースを介して送信されるすべての Rx トラフィックと Tx トラフィックが通知なくドロップされます。
パラメータ
パラメータなし。
例
trel filter
Disabled
Done
CLI と API リファレンス
trel ピア
TREL ピアテーブルをテーブル形式またはリスト形式で取得します。
パラメータ
trel peers [list]
例
trel peers
| No | Ext MAC Address | Ext PAN Id | IPv6 Socket Address |
+-----+------------------+------------------+--------------------------------------------------+
| 1 | 5e5785ba3a63adb9 | f0d9c001f00d2e43 | [fe80:0:0:0:cc79:2a29:d311:1aea]:9202 |
| 2 | ce792a29d3111aea | dead00beef00cafe | [fe80:0:0:0:5c57:85ba:3a63:adb9]:9203 |
Done
trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done
CLI と API リファレンス
Trel
TREL オペレーションが有効かどうかを示します。
パラメータ
パラメータなし。
例
trel
Enabled
Done
CLI と API リファレンス
tvcheck(enable、disable)
ルーターまたはリーダーにアップグレードする際に、Thread のバージョン チェックを有効または無効にします。このチェックはデフォルトで有効になっています。
パラメータ
パラメータなし。
例
tvcheck enable
Done
tvcheck disable
Done
CLI と API リファレンス
txpower(get、set)
送信電力を dBm 単位で取得(または、オプションの txpower
引数を使用して設定)します。
パラメータ
txpower [txpower]
例
txpower -10
Done
txpower
-10 dBm
Done
CLI と API リファレンス
UDP バインド
オープンなソケットに IPv6 アドレスとポートを割り当て、通信のためにソケットをバインドします。IPv6 アドレスとポートを割り当てることは、ソケットの命名と呼ばれます。詳細については、OT CLI を使用した UDP 機能のテストをご覧ください。
パラメータ
udp bind [netif] ip port
netif
: バインディング ネットワーク インターフェース。次のように決定されます。- 値なし(このパラメータをコマンドから除外): Thread ネットワーク インターフェースが使用されます。
-u
: 未指定のネットワーク インターフェース。ソケットをバインドするネットワーク インターフェースは UDP/IPv6 スタックが決定します。-b
: バックボーン ネットワーク インターフェースを使用します。
ip
: バインド先の IPv6 アドレス。UDP/IPv6 スタックにバインディング IPv6 アドレスを割り当てる場合は、値::
を使用して未指定 IPv6 アドレスを使用できます。各例では、未指定の IPv6 アドレスを使用しています。port
: バインドする UDP ポート番号。それぞれの例ではポート番号 1234 を使用しています。
例
udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done
CLI と API リファレンス
UDP を閉じる
UDP/IPv6 ソケットを閉じます。
パラメータ
パラメータなし。
例
udp close
Done
CLI と API リファレンス
UDP 接続
UDP/IPv6 ソケットを接続します。
パラメータ
udp connect ip port
次のパラメータを指定します。
ip
: ピアの IP アドレス。port
: ピアの UDP ポート番号。アドレスは IPv4 アドレスでも、ネットワーク データから優先 NAT64 プレフィックスを使用して IPv6 アドレスに合成されます。優先 NAT64 プレフィックスが使用できない場合、このコマンドはInvalidState
を返します。
例
udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done
udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
CLI と API リファレンス
UDP リンクセキュリティ(有効、無効)
リンクのセキュリティを有効または無効にします。
パラメータ
パラメータなし。
例
udp linksecurity enable
Done
udp linksecurity disable
Done
CLI と API リファレンス
- 関連付けられている API はありません
UDP リンクセキュリティ
リンク セキュリティが有効か無効かを示します。
パラメータ
パラメータなし。
例
udp linksecurity
Enabled
Done
CLI と API リファレンス
- 関連付けられている API はありません
UDP 起動
UDP/IPv6 ソケットを開きます。
パラメータ
パラメータなし。
例
udp open
Done
CLI と API リファレンス
UDP 送信
ソケットを使用して UDP メッセージを送信します。詳細については、OT CLI を使用した UDP 機能のテストをご覧ください。
パラメータ
udp send [ip port] [type] value
ip
と port
はペアとしては省略可能ですが、いずれかを指定する場合は、もう一方を指定する必要があります。ip
と port
が指定されていない場合、ソケットピア アドレスは udp connect
から使用されます。
ip
: 宛先アドレス。このアドレスは、IPv4 または IPv6 アドレスのいずれかです。IPv4 アドレスは、ネットワーク データから優先 NAT64 プレフィックスを持つ IPv6 アドレスに合成されます。(優先 NAT64 プレフィックスが使用できない場合、InvalidState
が返されます)。port
: UDP 宛先ポート。type
/value
の組み合わせ:-t
:value
パラメータのペイロードはテキストとして扱われます。type
値が入力されていない場合、value
パラメータのペイロードもテキストとして扱われます。-s
:value
パラメータで指定された長さで自動生成されたペイロード。-x
:value
パラメータで指定された 16 進数表現のバイナリデータ。
例
udp send hello
Done
udp send -t hello
Done
udp send -x 68656c6c6f
Done
udp send -s 800
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done
CLI と API リファレンス
保護されていない取得
保護されていない許可ポートのリストにあるすべてのポートを一覧表示します。
パラメータ
パラメータなし。
例
unsecure get
1234
Done
CLI と API リファレンス
unsecureport 追加
保護されていない許可ポートのリストにポートを追加します。
パラメータ
unsecureport add port
例
unsecureport add 1234
Done
CLI と API リファレンス
unsecureport の削除
保護されていないポートの許可リストから、指定したポートまたはすべてのポートを削除します。
パラメータ
unsecureport remove port|all
例
unsecureport remove 1234
Done
unsecureport remove all
Done
CLI と API リファレンス
稼働時間(ミリ秒)
現在のインスタンスの稼働時間(ミリ秒単位)を返します。
OPENTHREAD_CONFIG_UPTIME_ENABLE
を有効にする必要があります。
稼働時間は、OpenThread インスタンスが初期化されてからのミリ秒数で示されます。
パラメータ
パラメータなし。
例
uptime ms
426238
Done
CLI と API リファレンス
稼働時間
現在のインスタンスの稼働時間を人が読める形式の文字列として返します。
OPENTHREAD_CONFIG_UPTIME_ENABLE
を有効にする必要があります。
文字列は、時、分、秒、ミリ秒の場合は「
結果の文字列が aBuffer
(aSize
文字以内)に収まらない場合、文字列は切り捨てられますが、出力文字列は常に null で終端されます。
パラメータ
パラメータなし。
例
uptime
12:46:35.469
Done
CLI と API リファレンス
ベンダー appurl(セット)
ベンダーアプリの URL 文字列を設定します。
OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
が必要です。
aVendorAppUrl
は UTF8 で、最大長は 64 文字(MAX_VENDOR_APPL_URL_TLV_LENGTH
)にする必要があります。最大長に null 文字 \0
は含まれません。
パラメータ
vendor appurl url
例
vendor appurl http://www.example.com
Done
CLI と API リファレンス
ベンダー アプリケーションの URL
ベンダーアプリの URL 文字列を取得します。
パラメータ
パラメータなし。
例
vendor appurl
http://www.example.com
Done
CLI と API リファレンス
ベンダーモデル(セット)
ベンダーモデル文字列を設定します。
OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
が必要です。
aVendorModel
は UTF8 にする必要があります。最大長は 32 文字(MAX_VENDOR_MODEL_TLV_LENGTH
)です。最大長に null の \0
文字は含まれません。
パラメータ
vendor model name
例
vendor model Hub\ Max
Done
CLI と API リファレンス
ベンダーモデル
ベンダーモデル文字列を取得します。
パラメータ
パラメータなし。
例
vendor model
Hub Max
Done
CLI と API リファレンス
ベンダー名(セット)
ベンダー名の文字列を設定します。
OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
が必要です。
aVendorName
は UTF8 にする必要があります。最大長は 32 文字(MAX_VENDOR_NAME_TLV_LENGTH
)です。最大長に null の \0
文字は含まれません。
パラメータ
vendor name name
例
vendor name nest
Done
CLI と API リファレンス
ベンダー名
ベンダー名の文字列を取得します。
パラメータ
パラメータなし。
例
vendor name
nest
Done
CLI と API リファレンス
ベンダー swversion(セット)
ベンダーのソフトウェア バージョン文字列を設定します。
OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
が必要です。
aVendorSwVersion
は UTF8 で、最大長は 16 文字(MAX_VENDOR_SW_VERSION_TLV_LENGTH
)にする必要があります。最大長に null 文字 \0
は含まれません。
パラメータ
vendor swversion version
例
vendor swversion Marble3.5.1
Done
CLI と API リファレンス
ベンダーの切り替え
ベンダーのソフトウェア バージョン文字列を取得します。
パラメータ
パラメータなし。
例
vendor swversion
Marble3.5.1
Done
CLI と API リファレンス
Verhoeff の計算
指定された 10 進数文字列に対する Verhoeff チェックサムを計算します。
OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
が必要です。
パラメータ
verhoeff calculate decimalstring
例
verhoeff calculate 30731842
1
Done
CLI と API リファレンス
Verhoeff 検証
指定された 10 進数文字列に対する Verhoeff チェックサムを検証します。
OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
が必要です。
パラメータ
verhoeff validate decimalstring
例
verhoeff validate 307318421
Done
CLI と API リファレンス
バージョン API
API のバージョン番号を出力します。
パラメータ
パラメータなし。
例
version api
28
Done
CLI と API リファレンス
- 関連付けられている API はありません
バージョン
OpenThread バージョン文字列を取得します。
パラメータ
パラメータなし。
例
version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done