CLI コマンド リファレンス

ba エフェメラルキー

エフェメラル キーが現在アクティブかどうかを示します。

OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE が必要です。

パラメータ

パラメータなし。

例

ba ephemeralkey
active
Done

CLI と API リファレンス

ba エフェメラルキー コールバック(有効、無効)

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 Agent が実行されていない場合、またはエフェメラル キーが使用されていない場合は、この関数を呼び出しても効果はありません。

コミッショナーがエフェメラル キーを使用して接続され、現在アクティブになっている場合、この関数を呼び出しても状態は変更されません。この場合、コミッショナーが切断されるまで otBorderAgentIsEphemeralKeyActive() は引き続き TRUE を返します。

パラメータ

パラメータなし。

例

ba ephemeralkey clear
Done

CLI と API リファレンス

ba ephemeralkey set [timeout-in-msec] [port]

指定したタイムアウト期間のエフェメラル キーを設定します。

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 の状態

スレッド ボーダー エージェント ロールの 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 config(設定)

ローカル バックボーン ルーター構成 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 jitter(get、set)

バックボーン ルーター登録のジッター(秒単位)を取得または設定します。

OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE が有効な場合に利用可能です。

パラメータ

bbr jitter [jitter]

例

bbr jitter
20
Done
bbr jitter 10
Done

CLI と API リファレンス

BBR 管理 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 mgmt 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 mgmt 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
  • 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 プレフィックスの両方を出力します。

パラメータ

パラメータなし。

例

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 プレフィックスと優先 OMR プレフィックスの両方を出力します。

パラメータ

パラメータなし。

例

br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done

CLI と API リファレンス

ブラジル オムルプレフィックス 好意的

現在優先されているオフメッシュ ルーティング可能(OMR)プレフィックスを取得します。

優先する OMR プレフィックスは、ネットワーク データから見つけることも、このデバイスのローカル OMR プレフィックスすることもできます。

パラメータ

パラメータなし。

例

br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done

CLI と API リファレンス

br omrprefix ローカル

ローカルの Off-Mesh-Routable(OMR)プレフィックスを取得します(例: fdfc:1ff5:1512:5622::/64)。

OMR プレフィックスはランダムに生成される 64 ビットのプレフィックスで、まだ OMR プレフィックスがない場合に Thread ネットワークで公開されます。このプレフィックスには、ローカル 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 local

隣接するインフラストラクチャ リンクのローカル オンリンク接頭辞を取得します。

ローカルのオンリンク接頭辞は 64 ビットの接頭辞で、リンクでアドバタイズされる使用可能なオンリンク接頭辞がまだない場合に、インフラストラクチャ リンクでアドバタイズされます。

パラメータ

パラメータなし。

例

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

CLI と API リファレンス

br pd(enable、disable)

DHCPv6 プレフィックス委任を有効または無効にします。

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE を有効にする必要があります。

パラメータ

br pd enable|disable

例

br pd enable
Done
br pd disable
Done

CLI と API リファレンス

br pd omrprefix

DHCPv6 プレフィックス委任(PD)で提供されるオフメッシュ ルーティング可能(OMR)プレフィックスを取得します。

返されるプレフィックス情報では、mPrefix、mValidLifetime、mPreferredLifetime フィールドのみが使用されます。

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE を有効にする必要があります。

パラメータ

パラメータなし。

例

br pd omrprefix
2001:db8:cafe:0:0/64 lifetime:1800 preferred:1800
Done

CLI と API リファレンス

br pd 状態

DHCPv6 プレフィックス委任の現在の状態を取得します。

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE を有効にする必要があります。

パラメータ

パラメータなし。

例

br pd state
running
Done

CLI と API リファレンス

br 同業他社

ネットワーク データ エントリで見つかったピア BR のリストを取得します。OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE は必須です。ピア BR は、外部 IP 接続を提供する Thread メッシュ内の他のデバイスです。ネットワーク データエントリに関して次の条件の少なくとも 1 つが満たされている場合、デバイスは外部 IP 接続を提供しているとみなされます。

  • 外部ルートエントリが 1 つ以上追加されている。
  • デフォルト ルートとメッシュ上のフラグの両方が設定された 1 つ以上のプレフィックス エントリが追加されています。
  • 少なくとも 1 つのドメイン接頭辞(ドメインとメッシュ上のフラグの両方を設定)が追加されている。ピア BR のリストでは、現在のデバイスがそれ自体が BR として動作している場合でも、明示的に除外されます。BR エントリごとの情報:
  • ブラジルの RLOC16
  • ネットワーク データでこの BR が表示されてからの経過時間です。期間が 24 時間未満の場合は、時間、分、秒の {hh}:{mm}:{ss} の形式になります。期間が 24 時間以上の場合、形式は {dd}d.{hh}:{mm}:{ss}(日、時間、分、秒)になります。

パラメータ

パラメータなし。

例

br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Done

CLI と API リファレンス

br ピア数

ネットワーク データで検出されたピア BR の数を返します。

OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE が必要です。

ピア BR は、外部 IP 接続を提供する Thread メッシュ内の他のデバイスです。ネットワーク データエントリに関して次の条件の少なくとも 1 つが満たされている場合、デバイスは外部 IP 接続を提供しているとみなされます。

  • 外部ルートエントリが 1 つ以上追加されている。
  • デフォルト ルートとメッシュ上のフラグの両方が設定された 1 つ以上のプレフィックス エントリが追加されています。
  • 少なくとも 1 つのドメイン接頭辞(ドメインとメッシュ上のフラグの両方を設定)が追加されている。

ピア BR のリストでは、現在のデバイスがそれ自体が BR として動作している場合でも、明示的に除外されます。

パラメータ

パラメータなし。

例

br peers count
2 min-age:00:00:47
Done

CLI と API リファレンス

br プレフィックス表

インフラストラクチャ リンクの Border Routing Manager によって検出されたプレフィックスを取得します。プレフィックス エントリごとの情報:

  • 接頭辞
  • プレフィックスがリンク上かルート上か
  • この接頭辞を含むルーター アドバタイズメントを最後に受信してからのミリ秒数
  • プレフィックスの存続期間(秒)
  • プレフィックスがリンク上の場合にのみ優先される存続期間(秒)
  • プレフィックスがルート(リンク上ではない)の場合のみルート設定(低、中、高)
  • この接頭辞をアドバタイズするルーターの 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 リファレンス

Brrioprf

インフラストラクチャ リンクを介して送信されるルーター アドバタイズメント メッセージでルート情報オプション(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 routeprf Clear

ネットワーク データの公開ルートで以前に設定した設定値を消去します。

この関数が呼び出されると、BR はデバイスのロールとリンクの品質(エンドデバイスとして動作している場合は親に対するもの)に基づいて自動的に設定を決定します。

パラメータ

パラメータなし。

例

br routeprf clear
Done

CLI と API リファレンス

br ルーター

インフラストラクチャ リンクで Border Routing Manager によって検出されたルーターのリストを取得します。ルーターごとの情報:

  • ルーターの IPv6 アドレス
  • 受信したルーター アドバタイズメント ヘッダー内のフラグ:
    • M: マネージド アドレス構成フラグ
    • O: その他の構成フラグ
    • スタブ: スタブルーターフラグ(ルーターがスタブルーターかどうかを示します)
  • このルーターから最後にメッセージを受信してからのミリ秒数
  • ネットワーク到達性フラグ: 複数の Neighbor Solicitation プローブに応答できないルーターは、到達不能としてマークされます。
  • Age: このルーターが最初に検出されてからの経過時間。期間が 24 時間未満の場合は、時間、分、秒の {hh}:{mm}:{ss} の形式になります。期間が 24 時間以上の場合、形式は {dd}d.{hh}:{mm}:{ss}(日、時間、分、秒)になります。
  • (this BR) は、ルーターがローカル デバイス自体である場合に追加されます。
  • (peer BR) は、ルーターが同じ Thread メッシュに接続されたピア BR である可能性が高い場合に追加されます。これには OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE が必要です。

パラメータ

パラメータなし。

例

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done

CLI と API リファレンス

br の状態

Border Routing Manager の現在の状態を取得します。

パラメータ

パラメータなし。

例

br state
running

CLI と API リファレンス

bufferinfo

現在のメッセージ バッファ情報を取得します。

  • total は、プール内のメッセージ バッファの合計数を表示します。
  • free は、空きメッセージ バッファの数を表示します。
  • max-used は、OT スタックの初期化または最後の bufferinfo reset 以降に使用されているバッファの最大数を表示します。

次に、OpenThread スタックで使用されるさまざまなキューに関する情報が CLI に表示されます(例: 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 リファレンス

チャネル(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 ネットワーク内のすべてのスリープ エンド デバイスで使用される最大データ ポーリング間隔よりも長くすることをおすすめします。

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 リファレンス

チャイルディップ

MTD の子用に保存されている IP アドレスのリストを取得します。

パラメータ

パラメータなし。

例

childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done

CLI と API リファレンス

childip の最大値(設定)

各 MTD の子が親としてこのデバイスに登録できる IP アドレスの最大数を設定または復元します。

設定を消去してデフォルトに戻すには、0 を渡します。

OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE が有効な場合に利用可能です。

パラメータ

childip max count

例

childip max 2
Done

CLI と API リファレンス

子供の IP(最大)

各 MTD の子が親としてこのデバイスに登録できる IP アドレスの最大数を取得します。

パラメータ

パラメータなし。

例

childip max
4
Done

CLI と API リファレンス

子最大化(設定)

現在許可される子の最大数を設定します。

このパラメータは、Thread プロトコル オペレーションが停止している場合にのみ設定できます。

パラメータ

childmax count

例

childmax 2
Done

CLI と API リファレンス

チャイルドマックス

現在許可されている子の最大数を取得します。

パラメータ

パラメータなし。

例

childmax
5
Done

CLI と API リファレンス

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 サーバー上の指定された 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 観測

サブスクリプション リクエストをトリガーします。これにより、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: 2
    • max_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 リソースを変更します。詳細については、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 セット

CoAP サーバーでリソースによって送信されるコンテンツを設定します。CoAP クライアントがリソースを監視している場合、そのクライアントに通知が送信されます。

パラメータ

coap set new-content

例

coap set Testing123
Done

CLI と API リファレンス

coap Start

CoAP サーバーを起動します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル(CoAP)リソースへの接続のテストをご覧ください。

パラメータ

パラメータなし。

例

coap start
Done

CLI と API リファレンス

路面電車の停留所

CoAP サーバーを停止します。

パラメータ

パラメータなし。

例

coap stop
Done

CLI と API リファレンス

coaps connect

ピアとの 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 リファレンス

CANNOT TRANSLATE

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 はありません

合併・閉鎖

CoAP Secure サービスが閉じているかどうかを示します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストをご覧ください。

パラメータ

パラメータなし。

例

coaps isclosed
no
Done

CLI と API リファレンス

coaps isconnactive

CoAP Secure サービス接続がアクティブ(すでに接続されているか、接続を確立中か)を示します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル セキュア(CoAPS)リソースへの接続のテストをご覧ください。

パラメータ

パラメータなし。

例

coaps isconnactive
yes
Done

CLI と API リファレンス

通信がつながっている

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 リファレンス

コインプット

指定された 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 サーバーでリソースによって送信されるコンテンツを設定します。詳細については、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 サーバーに接続するための最大試行回数(成功または失敗)を設定します。このパラメータのデフォルト値は 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 リファレンス

駅構内

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: MLE Announce メッセージを送信するためのチャネルを識別するビットマスク。
  • count: チャネルあたりの MLE Announce 送信の数。
  • period: 連続する MLE Announce 送信間のミリ秒数。
  • destination: メッセージの宛先 IPv6 アドレス。メッセージはマルチキャストである可能性があります。

例

commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done

CLI と API リファレンス

コミッショナー エネルギー

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 リファレンス

コミッショナー参加者追加

Joiner エントリを追加します。

パラメータ

commissioner joiner add eui64|discerner pksd [timeout]
  • eui64: Joiner の IEEE EUI-64。任意の結合関数を照合するには、* を使用します。
  • discerner: number/length 形式の Joiner 識別ツール。
  • 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 リファレンス

コミッショナー結合テーブル

すべての 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(Management 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 リファレンス

コミッショナー Provisioningurl

コミッショナーのプロビジョニング URL を設定します。

パラメータ

commissioner provisioningurl provisioningurl

例

commissioner provisioningurl http://github.com/openthread/openthread
Done

CLI と API リファレンス

コミッショナー セッション ID

現在のコミッショナー セッション 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)

スレッド 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 リファレンス

カウンター メニューをリセットしました

Thread MLE カウンタをリセットします。

パラメータ

counters mle reset

例

counters mle reset
Done

CLI と API リファレンス

CSS チャネル

CSL チャネルを設定します。

パラメータ

csl channel channel

例

csl channel 20
Done

CLI と API リファレンス

CSS

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 引数は、Active Operational Dataset の値を 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 はありません

データセットの channelmask(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 リファレンス

  • データセット pskc (get,set)

データセットのヘルプ

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]
  • IPv6 の宛先を指定するには、address を使用します。それ以外の場合は、デフォルトでリーダー 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 リファレンス

データセットの 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 リファレンス

データセット 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 リファレンス

データセットの 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 リファレンス

データセットの 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 リファレンス

  • データセット pskc (get,set)

データセット panid(get、set)

otOperationalDataset::mPanId を取得または設定します。

パラメータ

dataset panid [panid]

オプションの panid 引数を使用して、PAN ID を設定します。

例

dataset panid
0x1234
Done
dataset panid 0x1234
Done

CLI と API リファレンス

  • 関連付けられた API はありません

データセット保留中タイムスタンプ(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 はありません

dataset securitypolicy(get、set)

データセット セキュリティ ポリシーを取得または設定します。

パラメータ

dataset securitypolicy [rotationtime [onrcCepR]]

例

dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done

CLI と API リファレンス

  • 関連付けられた API はありません

データセット セット(アクティブ、保留中)

アクティブな運用データセットを設定します。

データセットにアクティブなタイムスタンプが含まれていない場合、データセットは部分的にしか完成していません。

部分的に完全なアクティブ データセットを持つデバイスで Thread が有効になっている場合、デバイスはデータセット内の既存の情報を使用して、既存の Thread ネットワークへの接続を試みます。ネットワークへの接続に必要なのは、Thread ネットワーク キーだけです。

チャンネルがデータセットに含まれていない場合、デバイスはさまざまなチャンネル間で MLE Announce メッセージを送信し、他のチャンネルのネイバーを検出します。

デバイスが Thread ネットワークに正常に接続されると、デバイスは親からアクティブなデータセット全体を取得します。ルーター対応デバイスは、アクティブなデータセットが完成するまでルーターまたはリーダーのロールに移行しません。

この関数は一貫して OT_ERROR_NONE を返し、実質的に void の戻り値の型を持つものとして扱うことができます。以前は、その他のエラー(OT_ERROR_NOT_IMPLEMENTED など)は、以前の理由により許可されていました。ただし、Thread オペレーションには不揮発性ストレージが必須になったため、データセットの保存に失敗するとアサーションがトリガーされます。戻り値の型 otError は、下位互換性を維持するために保持されます。

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 には、更新するフィールドとその新しい値を含める必要があります。Active または Pending Timestamp フィールドを含めることはできません。[遅延] フィールドは省略できます。指定しない場合はデフォルト値(1, 000 ミリ秒)が使用されます。

パラメータ

パラメータなし。

例

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 プレフィックス(OMR、オンリンク、NAT64)
  • 検出された接頭辞の表

パラメータ

パラメータなし。

例

CLI と API リファレンス

  • 関連付けられた API はありません

delaytimermin(設定)

最小遅延タイマーを秒単位で設定します。

パラメータ

delaytimermin delaytimermin

例

delaytimermin 60
Done

CLI と API リファレンス

遅延タイマー分

最小遅延タイマー(秒単位)を取得します。

パラメータ

パラメータなし。

例

delaytimermin
30
Done

CLI と API リファレンス

非同期のデタッチ

ブロックせずに、接続解除の完了を示すコールバックを待たずに、detach コマンドと同様の正常な接続解除プロセスを開始します。

パラメータ

パラメータなし。

例

detach async
Done

CLI と API リファレンス

detach

正常なデタッチプロセスを開始するには、まず他のノードに通知し(ルーターとして動作している場合は Address Release を送信し、子として動作している場合は親で Child Timeout 値を 0 に設定)、その後 Thread プロトコル オペレーションを停止します。

パラメータ

パラメータなし。

例

detach
Finished detaching
Done

CLI と API リファレンス

deviceprops(セット)

デバイスのプロパティを設定します。

パラメータ

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 リファレンス

deviceprops

現在のデバイスのプロパティを取得します。

OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE が必要です。

パラメータ

パラメータなし。

例

deviceprops
PowerSupply      : external
IsBorderRouter   : yes
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : 0
Done

CLI と API リファレンス

おすすめ

MLE Discovery オペレーションを実行します。

パラメータ

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 リファレンス

Discover reqcallback(enable、disable)

MLE Discovery Request データを受け取るコールバックを設定します。

パラメータ

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 圧縮(enable、disable)

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 クライアントは、SRP サーバーを選択するために、DNS/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] [protocol]

例

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
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 6000 ms
MaxTxAttempts: 3
RecursionDesired: yes
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
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 アドレスとポート、レスポンス タイムアウト(ミリ秒)(rx レスポンスまでの待機時間)、失敗を報告するまでの最大 tx 試行回数、サーバーがクエリを再帰的に解決できるかどうかを示すブール値フラグが含まれます。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 構成)の値に置き換えられます。

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 Servicehost

指定されたサービス インスタンスの 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 リファレンス

ドメイン名

スレッドのドメイン名を取得します。

パラメータ

パラメータなし。

例

domainname
Thread
Done

CLI と API リファレンス

dua iid(セット、クリア)

[Thread Domain Unicast Address] に手動で指定したインターフェース識別子を設定またはクリアします。

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(設定)

IEEE 802.15.4 拡張アドレスを設定します。

パラメータ

extaddr extaddr

例

extaddr dead00beef00cafe
dead00beef00cafe
Done

CLI と API リファレンス

extaddr

IEEE 802.15.4 拡張アドレスを取得します。

パラメータ

パラメータなし。

例

extaddr
dead00beef00cafe
Done

CLI と API リファレンス

extpanid(設定)

IEEE 802.15.4 Extended 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
LNA gain 11 dBm
Done

CLI と API リファレンス

fem lnagain (get)

外部 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 リファレンス

履歴 ipmaddr

マルチキャスト 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-idle
    • d: フルスレッド デバイス。
    • 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 リファレンス

履歴 ネット情報

ネットワーク情報の履歴をテーブル形式またはリスト形式で表示します。

各テーブルまたはリストエントリには次のものが含まれます。

  • Age: コマンドが発行されてからの経過時間。hours:minutes:seconds:milliseconds の形式で指定します。
  • Role: Device role。有効な値は router、child、detached、disabled です。
  • モード: MLE リンクモード。可能な値:
    • -: フラグが設定されていません(rx-off-when-idle、最小限の Thread デバイス、安定したネットワーク データ)。
    • r: rx-on-when-idle
    • d: フルスレッド デバイス。
    • 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 メッセージの RX 履歴をテーブル形式またはリスト形式で表示します。

各テーブルまたはリストエントリには次のものが含まれます。

  • Age: コマンドが発行されてからの経過時間。hours:minutes:seconds:milliseconds の形式で指定します。
  • タイプ:
    • IPv6 メッセージ タイプ(UDP、TCP、HopOpts、ICMP6(およびそのサブタイプ)など)。
    • src: 送信元 IPv6 アドレスとポート番号。
    • dst: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP に対して有効で、それ以外の場合は 0)。
  • 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 リファレンス

履歴 answerx

IPv6 メッセージの RX 履歴と TX 履歴を組み合わせて、テーブル形式またはリスト形式で表示します。

各テーブルまたはリストエントリには次のものが含まれます。

  • Age: コマンドが発行されてからの経過時間。hours:minutes:seconds:milliseconds の形式で指定します。
  • タイプ:
    • IPv6 メッセージ タイプ(UDP、TCP、HopOpts、ICMP6(およびそのサブタイプ)など)。
    • src: 送信元 IPv6 アドレスとポート番号。
    • dst: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP に対して有効で、それ以外の場合は 0)。
  • 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)。
  • 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 リファレンス

instanceid

インスタンス 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 Del

スレッド インターフェースからネットワーク インターフェース アドレスを削除します。

パラメータ

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 linklocal

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 Del

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

Thread Link-Local All Thread Nodes マルチキャスト アドレスを取得します。

アドレスは、リンクローカルのユニキャスト プレフィックス ベースのマルチキャスト アドレス [RFC 3306] で、

  • flgs を 3 に設定(P = 1、T = 1)
  • scop を 2 に設定
  • 十分を 64 に設定
  • Mesh Local Prefix に設定されたネットワーク プレフィックス
  • グループ ID を 1 に設定しました

パラメータ

パラメータなし。

例

ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done

CLI と API リファレンス

ipmaddr rlatn

スレッド レルム ローカルのすべてのスレッド ノードのマルチキャスト アドレスを取得します。

アドレスはレルムローカルのユニキャストプレフィックスベースのマルチキャストアドレス [RFC 3306]であり、

  • flgs を 3 に設定(P = 1、T = 1)
  • スコープを 3 に設定
  • 十分を 64 に設定
  • Mesh Local Prefix に設定されたネットワーク プレフィックス
  • グループ ID を 1 に設定しました

パラメータ

パラメータなし。

例

ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done

CLI と API リファレンス

Joiner Diserner(セット)

Joiner Discerner を設定します。

パラメータ

joiner discerner discerner
  • {number}/{length} を使用して discerner を設定します。
  • joiner discerner clear が aDiscerner を nullptr に設定します。

例

joiner discerner 0xabc/12
Done

CLI と API リファレンス

Joiner Diserner Clear

Joiner 識別ツールをクリアします。

パラメータ

パラメータなし。

例

joiner discerner clear
Done

CLI と API リファレンス

  • 関連付けられた API はありません

ジョイナー ディクナーナー

Joiner Discerner を取得します。

詳細については、otJoinerSetDiscerner をご覧ください。

パラメータ

パラメータなし。

例

joiner discerner
0xabc/12
Done

CLI と API リファレンス

Joiner ヘルプ

joiner のヘルプメニューを出力します。

パラメータ

パラメータなし。

例

joiner help
help
id
start
state
stop
Done

CLI と API リファレンス

  • 関連付けられた API はありません

Joiner 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 の開始

スレッド結合ロールを有効にします。

パラメータ

joiner start joining-device-credential [provisioning-url]
  • joining-device-credential: Joiner パスフレーズ。すべて大文字の英数字(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

スレッド結合ロールを無効にします。

パラメータ

パラメータなし。

例

joiner stop
Done

CLI と API リファレンス

Joinerport(セット)

Joiner UDP ポートを設定します。

パラメータ

joinerport udp-port

例

joinerport 1000
Done

CLI と API リファレンス

Joinerport

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 リファレンス

リーダーウェイト(セット)

リーダーロールで動作するときに使用される Thread Leader Weight を設定します。

リーダーの太さを新しい値に直接設定し、以前の値(現在の otDeviceProperties から決定されている場合があります)と置き換えます。

パラメータ

leaderweight weight

例

leaderweight 128
Done

CLI と API リファレンス

リーダーウェイト

リーダーロールで操作する際に使用される Thread Leader Weight を取得します。

パラメータ

パラメータなし。

例

leaderweight
128
Done

CLI と API リファレンス

linkmetrics 構成 Enhanced-ack のクリア

拡張 ACK ベースのプローブをクリアするために、リンク指標管理リクエストを送信します。

パラメータ

linkmetrics config [async] peer-ipaddr enhanced-ack clear
  • async: 非ブロック モードを使用します。
  • peer-ipaddr は、隣接デバイスのリンクローカル アドレスにする必要があります。

例

linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done

CLI と API リファレンス

linkmetrics 構成 Enhanced-ack レジスタ

追加の r はオプションであり、参照デバイスでのみ使用されます。このオプションを指定すると、各タイプ ID フラグのタイプ/平均列挙型が予約済みに設定されます。これは、プローブ対象サブジェクトが無効なタイプ ID フラグを正しく処理していることを確認するために使用されます。また、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE が有効になっている場合にのみ使用できます。

拡張 ACK ベースのプローブを登録するためのリンク指標管理リクエストを送信します。

パラメータ

linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
  • async: 非ブロック モードを使用します。
  • [q、m、r] は otLinkMetricsValues にマッピングされます。仕様 4.11.3.4.4.6 では、一度に最大 2 つのオプション(q、qm など)しか使用できません。
    • q: レイヤ 2 LQI。
    • m: リンクのマージン。
    • r: RSSI。

例

linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done
> linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
Done

CLI と API リファレンス

linkmetrics 構成転送

MLE Link Metrics Management リクエストを送信して、フォワード トラッキング シリーズを設定またはクリアします。

パラメータ

linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
  • async: 非ブロック モードを使用します。
  • 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 config fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
Done

CLI と API リファレンス

linkmetrics プローブ

MLE Link Probe メッセージを送信します。

パラメータ

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 [async] peer-ipaddr forward series-id
  • async: 非ブロック モードを使用します。
  • peer-ipaddr: ピアアドレス。
  • series-id: シリーズ ID。

例

linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 forward 1
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)
Done

CLI と API リファレンス

linkmetrics リクエスト(単一)

リンク指標のクエリ(単一プローブ)を実行します。

パラメータ

linkmetrics request [async] peer-ipaddr single [pqmr]
  • async: 非ブロック モードを使用します。
  • peer-ipaddr: ピアアドレス。
  • [p、q、m、r] は otLinkMetrics にマッピングされます。
    • p: 受信したレイヤ 2 PDU 数。
    • q: レイヤ 2 LQI。
    • m: リンクのマージン。
    • r: RSSI。

例

linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 single qmr
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)
Done

CLI と API リファレンス

linkmetricsmgr(enable、disable)

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

最も近い宛先は、現在のルーティング テーブルとスレッド メッシュ内のパスコストに基づいて決定されます。

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 引数を使用して、直接 TX 再試行の回数を設定します。

例

mac retries direct
3
Done
mac retries direct 5
Done

CLI と API リファレンス

mac による間接的な再試行(get、set)

MAC レイヤでの間接 TX 再試行の回数を取得または設定します。

パラメータ

mac retries indirect [number]

オプションの number 引数を使用して、間接 Tx 再試行の回数を設定します。

例

mac retries indirect
3
Done
 max retries indirect 5
Done

CLI と API リファレンス

MAC 送信

Rx-Off-When-Idle デバイスに、MAC フレームを親に送信するように指示します。このコマンドは認証用で、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 オプションを使用しない場合、アドレスでは設定したデフォルト値が使用されます。デフォルトの電波強度を設定していない場合、電波強度は無線(OTA)信号になります。

パラメータ

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 を消去

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 Addr の削除

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)がデフォルト値と異なる値に設定されている場合は、アドレスの横に表示されます。
  • rss がデフォルト値とは異なるように設定されている拡張アドレスをすべて表示する個別のリスト(RssIn List)。
  • 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 の設定を使用します。(デフォルトの設定がない場合は、無線(OTA)信号が使用されます)。

OPENTHREAD_CONFIG_MAC_FILTER_ENABLE 構成が有効な場合に使用できます。

指定された拡張アドレスに一致する既存のエントリが RssIn リストにない場合、アクションは実行されません。

パラメータ

macfilter rss remove extaddr

デフォルトの受信電波強度とリンク品質インジケーターの設定を削除するには、* を extaddr として使用します。これによってデフォルトの設定が解除されますが、RssIn リストからエントリが削除されることはありません。

例

macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done

CLI と API リファレンス

meshdiag childip6

すべての 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 の受信リンクがあるルーター ID
    • 2-links: このルーターにリンク品質 2 の受信リンクがあるルーター ID
    • 1-links: このルーターにリンク品質 1 の受信リンクがあるルーター ID
    • リストが空の場合、out では省略されます。
  • ip6-addrs の場合、ルーターの IPv6 アドレスのリスト
  • children の場合、ルーターのすべての子のリスト。お子様ごとの情報:
    • RLOC16
    • 親から子への受信リンクの品質(ゼロは不明)
    • 子デバイスモード(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

アドバタイズメント トリクル タイマーで使用されている現在の Interval Max の値を取得します。

この API はテスト専用で、OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE が必要です。

パラメータ

パラメータなし。

例

mleadvimax
12000
Done

CLI と API リファレンス

mliid

メッシュ ローカル IID を設定します(テスト用)。

OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE が必要です。

スレッド スタックを有効にする前に使用する必要があります。

テスト/参照デバイス専用。

パラメータ

mliid iid

例

mliid 1122334455667788
Done

CLI と API リファレンス

MLR 規制

マルチキャスト リスナーをプライマリ バックボーン ルーターに登録します。

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-idle
  • d: フルスレッド デバイス
  • n: 完全なネットワーク データ

例

mode rdn
Done
mode -
Done

CLI と API リファレンス

マルチラジオ

デバイスでサポートされているラジオリンクのリストを取得します。

このコマンドは、デバイスでサポートされている無線通信が 1 つのみの場合でも、常に使用できます。

パラメータ

パラメータなし。

例

multiradio
[15.4, TREL]
Done

CLI と API リファレンス

  • 関連付けられた API はありません

マルチラジオ ネイバー リスト

指定された拡張アドレスを持つネイバーに関連付けられたマルチ無線リンク情報を取得します。

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(enable、disable)

NAT64 関数を有効または無効にします。

OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE が有効で、無効を 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 リファレンス

ネイバー接続時間リスト

ネイバーの接続時間と経過時間を出力します。このコマンドは 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 リファレンス

ネイバー接続時間

ネイバーの接続時間と経過時間を出力します。ネイバーごとの情報:

  • 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: アイドル状態のときに受信がオンになる
  • D: フルスレッド デバイス
  • 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 リファレンス

ネットデータがいっぱい

「はい」と表示するまたは「no」“ネットデータが満杯”かどうかを示すThread オペレーションの開始後、または最後に netdata full reset を使用してフラグをリセットした後に呼び出されています。このコマンドには OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL が必要です。「ネットデータがいっぱい」このコールバックは、次の場合に必ず呼び出されます。

  • デバイスはリーダーとして動作し、ネットワーク データに追加できないネットワーク データ登録をボーダー ルーター(BR)から受信しています(空き容量不足)。
  • デバイスは BR として動作しており、新しいエントリをローカル ネットワーク データに追加できません。
  • デバイスは BR として動作し、ローカル ネットワーク データ エントリをリーダーに登録しようとしましたが、ローカル エントリが収まらないと判断しました。

パラメータ

パラメータなし。

例

netdata full
no
Done

CLI と API リファレンス

netdata フルリセット

「net data full」かどうかをトラッキングするフラグをリセットコールバックが呼び出されたことを示します。

パラメータ

パラメータなし。

例

netdata full reset
Done

CLI と API リファレンス

  • 関連付けられた API はありません

netdata の長さ

Partition のスレッド ネットワーク データの現在の長さ(バイト数)を取得します。

パラメータ

パラメータなし。

例

netdata length
23
Done

CLI と API リファレンス

netdata の最大長

OT スタックの初期化以降、または前回の otNetDataResetMaxLength() 呼び出し以降のスレッド ネットワーク データの最大観測長を取得します。

パラメータ

パラメータなし。

例

netdata maxlength
40
Done

CLI と API リファレンス

netdata の最大長をリセット

スレッド ネットワーク データの追跡対象最大長をリセットします。

パラメータ

パラメータなし。

例

netdata maxlength reset
Done

CLI と API リファレンス

netdata 公開 dnssrp エニーキャスト

シーケンス番号を使用して 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 公開 dnssrp ユニキャスト(addr,port)

アドレスとポート番号を含む 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 公開 dnssrp ユニキャスト(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 公開接頭辞

メッシュ上の接頭辞エントリを公開します。詳細については、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 チェック(discerner)

ステアリング データに、指定された識別値を持つ Joiner が含まれているかどうかを確認します。

パラメータ

netdata steeringdata check discerner
  • discerner: {number}/{length} 形式の Joiner 識別ツール。

例

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 の公開停止(接頭辞)

以前に公開されたオンメッシュまたは外部ルートプレフィックスの公開を停止します。

OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE を有効にする必要があります。

詳細については、OT CLI を使用してネットワーク データを表示および管理するを参照してください。

パラメータ

netdata unpublish prefix

例

netdata unpublish fd00:1234:5678::/64
Done

CLI と API リファレンス

netdata dnssrp の公開停止

以前に追加された DNS/SRP(エニーキャストまたはユニキャスト)サービス エントリをスレッド ネットワーク データから公開停止します。

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE を有効にする必要があります。

パラメータ

パラメータなし。

例

netdata unpublish dnssrp
Done

CLI と API リファレンス

ネットワーク統計

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 拡張アドレス TLV
  • 1: Address16 TLV
  • 2: モード TLV
  • 3: タイムアウト TLV(SED の最大ポーリング時間)
  • 4: 接続 TLV
  • 5: Route64 TLV
  • 6: リーダーデータ TLV
  • 7: ネットワーク データ TLV
  • 8: IPv6 アドレスリスト TLV
  • 9: MAC カウンタ TLV
  • 14: バッテリー残量 TLV
  • 15: 電源電圧 TLV
  • 16: 子テーブル TLV
  • 17: チャンネル ページ TLV
  • 19: 子タイムアウトの最大 TLV
  • 23: EUI64 TLV
  • 24: バージョン TLV(プロトコルと機能のバージョン番号)
  • 25: ベンダー名 TLV
  • 26: ベンダーモデル TLV
  • 27: ベンダー SW バージョン TLV
  • 28: スレッド スタック バージョン TLV(スレッド スタック コードベース/commit/バージョンの場合、UTF-8 文字列としてのバージョン識別子)
  • 29: 子 TLV
  • 34: MLE カウンタ TLV
  • 35: ベンダーアプリ 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(key)

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 リファレンス

ネットワーク名

スレッド ネットワーク名を取得します。

パラメータ

パラメータなし。

例

networkname
OpenThread
Done

CLI と API リファレンス

networktime(設定)

時刻同期パラメータを設定します。

  • timesyncperiod: 時刻の同期期間(秒単位)。
  • xtalthreshold: デバイスがルーター対応デバイスになるための XTAL 精度のしきい値(PPM)。

パラメータ

networktime timesyncperiod xtalthreshold

例

networktime 100 300
Done

CLI と API リファレンス

ネットワーク時間

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 リファレンス

nexthop

各ルーターに割り当てられたルーター 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 リファレンス

親

親としての Thread Router の診断情報を取得します。

OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE が有効になっているときにスレッド ルーターとして動作している場合、このコマンドは、デバイスが以前に Thread の子としてアタッチされていたときにキャッシュされた情報を返します。Thread テストハーネス - テストシナリオ 8.2.x では、デバイスがすでにルーターに昇格している場合でも、以前の親(つまり Joiner Router の)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 リファレンス

親優先度(get、set)

割り当てられた親の優先値(1、0、-1、-2)を取得または設定します。-2 は未割り当てを意味します。

パラメータ

parentpriority [parentpriority]

例

parentpriority
1
Done
parentpriority 1
Done

CLI と API リファレンス

partitionid

スレッド ネットワーク パーティション ID を取得します。

パラメータ

パラメータなし。

例

partitionid
4294967295
Done

CLI と API リファレンス

partitionid Preferred(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(get、set)

スリープ時の終了デバイスのカスタマイズされたデータ ポーリング期間(ミリ秒)を取得または設定します。認定試験のみ。

パラメータ

パラメータなし。

例

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(有効、無効)

リンクレイヤのプロミスキャス モードを有効または無効にします。

パラメータ

promiscuous enable|disable

例

promiscuous enable
Done
promiscuous disable
Done

CLI と API リファレンス

無差別

リンクレイヤでプロミスキャス モードが有効になっているかどうかを示します。

パラメータ

パラメータなし。

例

promiscuous
Disabled
Done

CLI と API リファレンス

pskc(設定)

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

Thread PSKc を取得します。

パラメータ

パラメータなし。

例

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

CLI と API リファレンス

pskcref(設定)

キー参照をスレッド 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(set)

地域コードを設定します。

ラジオの地域形式は、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: Stable フラグ
  • 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 ルーターの診断情報を出力します。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 リファレンス

Routereligible(有効化、無効化)

ルーターのロールを有効または無効にします。

パラメータ

routereligible [enable|disable]

例

routereligible enable
Done
routereligible disable
Done

CLI と API リファレンス

ルーター対応

ルーターのロールが有効か無効かを示します。

パラメータ

パラメータなし。

例

routereligible
Enabled
Done

CLI と API リファレンス

routerselectionjitter

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 クエリ

SNTP クエリを送信して、現在の UNIX エポック時刻(1970 年 1 月 1 日以降)を取得します。

  • 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)

自動起動モードの現在の状態(有効または無効)を示します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

srp client autostart
Disabled
Done

CLI と API リファレンス

srp クライアント自動起動の無効化

自動起動モードを無効にします。

自動起動モードを無効にしても、実行中のクライアントは停止しません。ただし、SRP クライアントは Thread ネットワーク データのモニタリングを停止します。

パラメータ

パラメータなし。

例

srp client autostart disable
Done

CLI と API リファレンス

srp クライアント自動起動の有効化

自動起動モードを有効にします。

自動スタートが有効になっている場合、SRP クライアントは Thread ネットワーク データを監視して SRP サーバーを検出し、優先サーバーを選択し、SRP サーバーが検出されるとクライアントを自動的に起動および停止します。

SRP サーバーの存在を示す 3 つのカテゴリのネットワーク データ エントリは、次の順序で優先されます。

  1. サーバー アドレスがサービスデータに含まれるユニキャスト エントリ。複数のオプションがある場合は、IPv6 アドレスの数値が最も小さいオプションが優先されます。
  2. それぞれシーケンス番号を持つエニーキャスト エントリ。RFC-1982 の Serial Number Arithmetic Logic で指定された最大のシーケンス番号が優先されます。
  3. サーバー アドレス情報がサーバー データに含まれるユニキャスト エントリ。複数のオプションがある場合は、IPv6 アドレスの数値が最も小さいオプションが優先されます。

パラメータ

パラメータなし。

例

srp client autostart enable
Done

CLI と API リファレンス

srp クライアント コールバック(get、enable、disable)

SRP クライアントからの印刷コールバック イベントを取得または有効/無効にします。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

srp client callback [enable|disable]

例

srp client callback enable
Done
srp client callback
Enabled
Done

CLI と API リファレンス

srp クライアント ホスト アドレス(get)

自動アドレス モードが有効かどうかを示します。自動アドレス モードが有効になっていない場合は、SRP クライアント ホストアドレスのリストが返されます。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

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 クライアント ホスト アドレス(設定済み)

自動ホストアドレス モードを有効にするか、ホストアドレスのリストを明示的に設定します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

srp client host address [auto|address...]
  • auto パラメータを使用して、自動ホスト アドレス モードを有効にします。有効にすると、クライアントはリンクローカル アドレスとメッシュローカル アドレスを除くすべての優先 Thread netif ユニキャスト アドレスを自動的に使用します。有効なアドレスがない場合、メッシュのローカル 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 クライアントのホスト名を取得または設定します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

srp client host name [name]

ホストが削除されている場合や、まだサーバーに登録されていない場合に、クライアント ホスト名を設定するには、name パラメータを使用します。

例

srp client host name dev4312
Done
srp client host name
dev4312
Done

CLI と API リファレンス

srp クライアント ホストの削除

SRP クライアントのホスト情報とすべてのサービスを SRP サーバーから削除します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

srp client host remove [removekeylease] [sendunregtoserver]
  • パラメータ removekeylease は、ホストキーのリースも削除する必要があるかどうかを示すブール値です(省略可)。false
  • パラメータ sendunregtoserver は、クライアント ホストが「update」を送信する必要があるかどうかを示すブール値です(省略可)クライアント ホスト情報がまだサーバーに登録されていない場合でも、サーバーにメッセージが送信されます(デフォルトは 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 クライアント リース間隔(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 になります。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done

CLI と API リファレンス

srp クライアント サービスの追加

指定されたインスタンス名、サービス名、ポート番号を持つサービスを追加します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

srp client service add instancename servicename port [priority] [weight] [txt]

servicename パラメータには、必要に応じて、カンマで区切られたサービス サブタイプ ラベルのリストを含めることができます。この例では一般的な命名規則を使用しています。priority パラメータと weight(どちらも uint16_t 値)パラメータは省略可能です。指定しない場合はゼロが使用されます。オプションの 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 を有効にする必要があります。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

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 クライアント操作を開始します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

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 client ttl (get,set)

ttl(有効期間)の値を秒単位で取得または設定します。

パラメータ

srp client ttl [value]

例

srp client ttl 3600
Done
srp client ttl
3600
Done

CLI と API リファレンス

srp server(enable、disable)

SRP サーバーを有効または無効にします。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

srp server [enable|disable]

例

srp server disable
Done

CLI と API リファレンス

srp server addrmode(get、set)

SRP サーバーが使用するアドレスモードを取得または設定します。

アドレスモードは、SRP サーバーにアドレスとポート番号を決定する方法を指示し、それらは Thread ネットワーク データで公開されます。

パラメータ

srp server addrmode [anycast|unicast]

例

srp server addrmode anycast
Done
srp server addrmode
anycast
Done

CLI と API リファレンス

srp server auto(有効、無効)

SRP サーバーで自動有効化モードを有効または無効にします。

このモードを有効にすると、Border Routing Manager が SRP サーバーを有効または無効にするかどうかと、そのタイミングを制御します。

このコマンドを使用するには、OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE を有効にする必要があります。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

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 サーバー ホスト

登録されているすべてのホストに関する情報を返します。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

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 進数のバイト単位で出力されます。詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

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 リファレンス

srp サーバーの状態

SRP サーバーの次のいずれかの状態を返します。

  • disabled: SRP サーバーが有効になっていません。
  • stopped: SRP サーバーは有効になっていますが、Thread ネットワークですでにアクティブになっている既存の SRP サーバーが原因でアクティブになっていません。Thread ネットワーク内で既存の SRP サーバーがアクティブでなくなると、SRP サーバーがアクティブになることがあります。
  • running: SRP サーバーはアクティブで、サービス登録を処理できます。

詳細については、Set Up Service Registration Protocol(SRP)Server-Client Connectivity With OT CLI をご覧ください。

パラメータ

パラメータなし。

例

srp server state
running
Done

CLI と API リファレンス

state

Thread デバイスの現在のロールを返すか、いずれかのオプションで指定されたロールを変更します。デバイスのロールを問い合わせる際に返される可能性のある値は次のとおりです。

  • child: デバイスは現在 Thread の子として動作しています。
  • router: デバイスは現在 Thread ルーターとして動作しています。
  • leader: デバイスは現在 Thread リーダーとして動作しています。
  • detached: デバイスは現在 Thread ネットワーク/パーティションに参加していません。
  • disabled: スレッド スタックは現在無効になっています。

いずれかのオプションを使用すると、デバイスの現在の役割を変更できます。ただし、disabled 状態への変更は含まれません。

パラメータ

state [child|router|leader|detached]

例

state
child
Done
state leader
Done

CLI と API リファレンス

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 send

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 start
Done

CLI と API リファレンス

スレッド停止

スレッド プロトコル オペレーションを停止します。

パラメータ

パラメータなし。

例

thread stop
Done

CLI と API リファレンス

  • 関連付けられた API はありません

スレッドのバージョン

スレッド プロトコル バージョンを取得します。

定数 OT_THREADVERSION* はバージョンの数値値を定義します。

パラメータ

パラメータなし。

例

 thread version
2
Done

CLI と API リファレンス

キュー内の最大時間

TX キュー内のメッセージの最大キュー時間を取得します。

OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE が必要です。

キューインキュー時間は、直接送信についてのみ追跡され、メッセージが送信キューに追加されてから、送信のために MAC レイヤに渡されるか破棄されるまでの時間として測定されます。

収集された統計情報は、 otThreadResetTimeInQueueStat() を呼び出すことでリセットできます。

パラメータ

パラメータなし。

例

timeinqueue max
281
Done

CLI と API リファレンス

キュー内の待機時間をリセット

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 フィルタ(enable、disable)

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
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 アドレスを使用できます: ::。それぞれの例では、未指定の 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 linksecurity(enable、disable)

リンクのセキュリティを有効または無効にします。

パラメータ

パラメータなし。

例

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 を有効にする必要があります。

文字列は、「::.」の形式になります。時間、分、秒、ミリ秒(稼働時間が 1 日未満の場合)または「

d.::."(1 日以上の場合)。

結果の文字列が(aSize 文字内の)aBuffer に収まらない場合、文字列は切り捨てられますが、出力される文字列は常に null で終了します。

パラメータ

パラメータなし。

例

uptime
12:46:35.469
Done

CLI と API リファレンス

vendor 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 リファレンス

ベンダーの appurl

ベンダーアプリの 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 リファレンス

ベンダー swversion

ベンダー ソフトウェア バージョンの文字列を取得します。

パラメータ

パラメータなし。

例

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 はありません

version

OpenThread バージョン文字列を取得します。

パラメータ

パラメータなし。

例

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done

CLI と API リファレンス