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 リファレンス
childrouterlinks(get、set)
MLE_CHILD_ROUTER_LINKS 値を取得または設定します。
パラメータ
childrouterlinks [links]
例
childrouterlinks
16
Done
childrouterlinks 16
Done
CLI と API リファレンス
お子様管理のチェックアウトタイムアウト(設定済み)
お子様の管理機能チェックのタイムアウト間隔(秒単位)を設定します。
パラメータ
childsupervision checktimeout timeout-seconds
例
childsupervision checktimeout 30
Done
CLI と API リファレンス
お子様の管理機能のチェックアウト時間
子の管理機能チェックのタイムアウト間隔(秒単位)を取得します。
デバイスがスリープ状態にあり、指定されたチェック タイムアウト内に親から応答がない場合、再アタッチ プロセス(MLE 子更新リクエスト/応答の親との交換)を開始します。
パラメータ
パラメータなし。
例
childsupervision checktimeout
30
Done
CLI と API リファレンス
子管理機能の間隔(設定)
お子様の管理間隔(秒単位)をお子様に対して設定します。
パラメータ
childsupervision interval interval-seconds
例
childsupervision interval 30
Done
CLI と API リファレンス
子ども監督期間
子の子監視間隔(秒単位)を取得します。
「子どもの管理」機能では、管理期間内に眠っている各お子様にメッセージが確実に送信されるよう保護者が管理できます。管理間隔内に子への送信がない場合、OpenThread はキューに入り、子管理メッセージを子に送信します。
パラメータ
パラメータなし。
例
childsupervision interval
30
Done
CLI と API リファレンス
childtimeout(設定)
子ロールでの操作時に使用されるスレッドの子タイムアウト(秒単位)を設定します。
パラメータ
childtimeout timeout-seconds
例
childtimeout 300
Done
CLI と API リファレンス
子供のタイムアウト
子ロールでの操作時に使用されるスレッドの子タイムアウト(秒単位)を取得します。
パラメータ
パラメータなし。
例
childtimeout
300
Done
CLI と API リファレンス
coap キャンセル
CoAP サーバー上のリモート リソースに対する既存のモニタリング サブスクリプションをキャンセルします。
パラメータ
パラメータなし。
例
coap cancel
Done
CLI と API リファレンス
coap 削除
指定した CoAP リソースを削除します。
パラメータ
coap delete address uri-path [type] [payload]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可能(デフォルト)
payload
: CoAP ペイロード文字列。例:hellothere
例
coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
CLI と API リファレンス
- 関連付けられた API はありません
金を手に入れる
CoAP サーバー上の指定された 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
: 2max_retransmit
: 4 個
ack_timeout
:ACK_TIMEOUT
(0-UINT32_MAX)(ミリ秒単位)。RFC7252 をご覧ください。ack_random_factor_numerator
:ACK_RANDOM_FACTOR
分子。有効な値は 0 ~ 255 です。RFC7252 をご覧ください。ack_random_factor_denominator
:ACK_RANDOM_FACTOR
分母。有効な値は 0 ~ 255 です。RFC7252 をご覧ください。max_retransmit
:MAX_RETRANSMIT
(0 ~ 255)。RFC7252 をご覧ください。
例
coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
CLI と API リファレンス
- 関連付けられた API はありません
coap Post
指定された CoAP リソースを作成します。詳細については、OT CLI を使用した制約付きアプリケーション プロトコル(CoAP)リソースへの接続のテストをご覧ください。
パラメータ
coap post address uri-path [type] [payload]
address
: CoAP サーバーの IPv6 アドレス。uri-path
: リソースの URI パス。type
:con
: 確認可能non-con
: 確認不可能(デフォルト)block-
: このオプションを使用して、その後にブロック単位の値を付けて、ペイロード用にランダムに生成されたバイト数のブロックを送信します。有効な値は、block-16
、block-32
、block-64
、block-128
、block-256
、block-512
、block-1024
です。
payload
: CoAP ペイロード リクエスト。使用する場合は、type
に応じて文字列または整数になります。type
がcon
またはnon-con
の場合、payload
パラメータは省略可能です。payload
パラメータを省略すると、空のペイロードが送信されます。ただし、payload
パラメータを使用する場合、その値はhellothere
などの文字列にする必要があります。type
がblock-
の場合、payload
パラメータの値は、送信するブロック数を指定する整数にする必要があります。block-
タイプではOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
を設定する必要があります。
例
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
CLI と API リファレンス
- 関連付けられた API はありません
コインプット
指定された CoAP リソースを変更します。詳細については、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
: MLEAnnounce
メッセージを送信するためのチャネルを識別するビットマスク。count
: チャネルあたりの MLEAnnounce
送信の数。period
: 連続する MLEAnnounce
送信間のミリ秒数。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 リファレンス
- データセットの commit が有効です
- otDatasetSetActive
データセット遅延(get、set)
otOperationalDataset::mDelay を取得または設定します。
パラメータ
dataset delay [delay]
オプションの delay
引数を使用して、遅延タイマーの値を設定します。
例
dataset delay
1000
Done
dataset delay 1000
Done
CLI と API リファレンス
データセット extpanid(get、set)
otOperationalDataset::mExtendedPanId を取得または設定します。
パラメータ
dataset extpanid [extpanid]
オプションの extpanid
引数を使用して、拡張パーソナルエリア ネットワーク ID を設定します。
例
dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done
CLI と API リファレンス
データセットのヘルプ
dataset
CLI コマンドのリストを取得します。詳細については、OT CLI によるデータセットの表示および管理をご覧ください。
パラメータ
パラメータなし。
例
dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
set
tlvs
Done
CLI と API リファレンス
- 関連付けられた API はありません
データセット init(アクティブ、新規、保留中、tlvs)
OT CLI は、active
、pending
、または tlvs
をチェックし、対応する値を返します。それ以外の場合、OT CLI は新しいランダムなネットワークを作成し、新しいデータセットを返します。
パラメータ
dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]
new
を使用して新しいデータセットを初期化し、dataset commit active
コマンドを入力します。16 進数でエンコードされた TLV には tlvs
を使用します。
例
dataset init new
Done
CLI と API リファレンス
- データセットの commit が有効です
- データセットがアクティブです
データセット 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 リファレンス
- otDatasetSendMgmtActiveGet
- データセット mgmtgetcommand が保留中です
- データセット mgmtsetcommand が有効
- データセット mgmtsetcommand が保留中です
データセットの mgmtgetcommand が保留中です
MGMT_PENDING_GET を送信します。
パラメータ
dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]
これらのパラメータと引数マッピングの詳細については、OT CLI によるデータセットの表示および管理をご覧ください。
例
dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done
CLI と API リファレンス
- otDatasetSendMgmtPendingGet
- データセット mgmtgetcommand が有効
- データセット mgmtsetcommand が有効
- データセット mgmtsetcommand が保留中です
データセット mgmtsetcommand が有効
MGMT_ACTIVE_SET を送信します。
パラメータ
dataset mgmtsetcommand active [dataset-components] [-x tlv-list]
これらのパラメータと引数マッピングの詳細については、OT CLI によるデータセットの表示および管理をご覧ください。
例
dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done
CLI と API リファレンス
- otDatasetSendMgmtActiveSet
- データセット mgmtgetcommand が有効
- データセット mgmtgetcommand が保留中です
- データセット mgmtsetcommand が保留中です
データセットの mgmtsetcommand が保留中です
MGMT_PENDING_SET を送信します。
パラメータ
dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]
これらのパラメータと引数マッピングの詳細については、OT CLI によるデータセットの表示および管理をご覧ください。
例
dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done
CLI と API リファレンス
- otDatasetSendMgmtPendingSet
- データセット mgmtgetcommand が有効
- データセット mgmtgetcommand が保留中です
- データセット mgmtsetcommand が有効
データセットの networkkey(get、set)
otOperationalDataset::mNetworkKey を取得または設定します。
パラメータ
dataset networkkey [key]
オプションの key
引数を使用して、ネットワーク キーを設定します。
例
dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done
CLI と API リファレンス
- 関連付けられた API はありません
データセットの networkname(get、set)
otOperationalDataset::mNetworkName を取得または設定します。
パラメータ
dataset networkname [name]
オプションの name
引数を使用して、ネットワーク名を設定します。
例
dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done
CLI と API リファレンス
データセット 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]]
thrKeyRotation
(時間単位)にはrotationtime
を使用します。- セキュリティ ポリシー コマンドは、
onrcCepR
引数マッピングを使用して、otSecurityPolicy メンバーを取得および設定します。たとえば、o
は otSecurityPolicy::mObtainNetworkKeyEnabled を表します。詳細については、OT CLI によるデータセットの表示および管理をご覧ください。
例
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-idled
: フルスレッド デバイス。n
: 完全なネットワーク データ
- Ave RSS: エントリが記録された時点でネイバーから受信した平均フレーム数(dBm)。
パラメータ
history neighbor [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history neighbor
| Age | Type | Event | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
| 00:00:29.233 | Child | Added | ae5105292f0b9169 | 0x8404 | - | -20 |
| 00:01:38.368 | Child | Removed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:27.181 | Child | Changed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:51.236 | Router | Added | 865c7ca38a5fa960 | 0x9400 | rdn | -20 |
| 00:04:51.587 | Child | Removed | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:05:22.764 | Child | Changed | ae5105292f0b9169 | 0x8401 | rn | -20 |
| 00:06:40.764 | Child | Added | 4ec99efc874a1841 | 0x8403 | r | -20 |
| 00:06:44.060 | Child | Added | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:06:49.515 | Child | Added | ae5105292f0b9169 | 0x8401 | - | -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done
CLI と API リファレンス
履歴 ネット情報
ネットワーク情報の履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - Role: Device role。有効な値は
router
、child
、detached
、disabled
です。 - モード: MLE リンクモード。可能な値:
-
: フラグが設定されていません(rx-off-when-idle、最小限の Thread デバイス、安定したネットワーク データ)。r
: rx-on-when-idled
: フルスレッド デバイス。n
: 完全なネットワーク データ
- RLOC16
- パーティション ID。
パラメータ
history netinfo [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history netinfo
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:00:10.069 | router | rdn | 0x6000 | 151029327 |
| 00:02:09.337 | child | rdn | 0x2001 | 151029327 |
| 00:02:09.338 | child | rdn | 0x2001 | 151029327 |
| 00:07:40.806 | child | - | 0x2001 | 151029327 |
| 00:07:42.297 | detached | - | 0x6000 | 0 |
| 00:07:42.968 | disabled | - | 0x6000 | 0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:02:05.451 | router | rdn | 0x6000 | 151029327 |
| 00:04:04.719 | child | rdn | 0x2001 | 151029327 |
Done
CLI と API リファレンス
履歴の接頭辞
メッシュ プレフィックス履歴のネットワーク データをテーブルまたはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
またはRemoved
です。 - 接頭辞
- フラグ/意味:
p
: 優先フラグa
: ステートレス IPv6 アドレスの自動構成フラグ。d
: DHCPv6 IPv6 アドレス構成フラグ。c
: DHCPv6 のその他の構成フラグ。r
: デフォルト ルートフラグ。o
: メッシュのフラグ。s
: 安定版フラグ。n
: Nd Dns フラグ。D
: ドメイン接頭辞フラグ。
- 設定: 設定。値は
high
、med
、low
のいずれかです。 - RLOC16
パラメータ
history prefix [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history prefix
| Age | Event | Prefix | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:10.663 | Added | fd00:1111:2222:3333::/64 | paro | med | 0x5400 |
| 00:01:02.054 | Removed | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:21.136 | Added | fd00:abba:cddd:0::/64 | paos | med | 0x5400 |
| 00:01:45.144 | Added | fd00:dead:beef:1::/64 | paros | high | 0x3c00 |
| 00:01:50.944 | Added | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:59.887 | Added | fd00:dead:beef:1::/64 | paros | med | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done
CLI と API リファレンス
履歴のルート
ネットワーク データの外部ルート履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
またはRemoved
です。 - ルート
- フラグ/意味:
s
: 安定版フラグ。n
: NAT64 フラグ。
- 設定: 設定。値は
high
、med
、low
のいずれかです。 - RLOC16
パラメータ
history route [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history route
| Age | Event | Route | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:05.456 | Removed | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:29.310 | Added | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:42.822 | Added | fd00:1111:0::/48 | s | med | 0x5400 |
| 00:01:27.688 | Added | fd00:aaaa:bbbb:cccc::/64 | s | med | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done
CLI と API リファレンス
履歴ルーター
ルートテーブルの履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - イベント: 有効な値は
Added
、Removed
、NextHopChanged
、CostChanged
です。 - ID(RLOC16): ルーター ID とルーターの RLOC16。
- ネクストホップ: ネクストホップのルーター ID と RLOC16。ネクストホップがない場合、
none
が表示されます。 - 経路の費用: 以前の費用:
->
新しい費用。値inf
はパスコストが無限であることを示します。
パラメータ
history router [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history router
| Age | Event | ID (RLOC16) | Next Hop | Path Cost |
+----------------------+----------------+-------------+-------------+------------+
| 00:00:05.258 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:00:08.604 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:00:11.931 | Added | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 59 (0xec00) | none | inf -> inf |
| 00:00:14.948 | Removed | 54 (0xd800) | none | inf -> inf |
| 00:00:14.948 | Removed | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 7 (0x1c00) | none | inf -> inf |
| 00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) | 1 -> 5 |
| 00:02:33.735 | NextHopChanged | 54 (0xd800) | none | 15 -> inf |
| 00:03:10.915 | CostChanged | 54 (0xd800) | 34 (0x8800) | 13 -> 15 |
| 00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) | 15 -> 13 |
| 00:03:46.188 | CostChanged | 54 (0xd800) | 59 (0xec00) | 13 -> 15 |
| 00:04:19.124 | CostChanged | 54 (0xd800) | 59 (0xec00) | 11 -> 13 |
| 00:04:52.008 | CostChanged | 54 (0xd800) | 59 (0xec00) | 9 -> 11 |
| 00:05:23.176 | CostChanged | 54 (0xd800) | 59 (0xec00) | 7 -> 9 |
| 00:05:51.081 | CostChanged | 54 (0xd800) | 59 (0xec00) | 5 -> 7 |
| 00:06:48.721 | CostChanged | 54 (0xd800) | 59 (0xec00) | 3 -> 5 |
| 00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) | 1 -> 3 |
| 00:09:28.681 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:09:31.882 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf -> 1 |
| 00:09:54.204 | Added | 54 (0xd800) | none | inf -> inf |
| 00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
| 00:10:24.242 | Added | 34 (0x8800) | none | inf -> inf |
| 00:10:41.900 | NextHopChanged | 59 (0xec00) | none | 1 -> inf |
| 00:10:42.480 | Added | 3 (0x0c00) | 3 (0x0c00) | inf -> inf |
| 00:10:43.614 | Added | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done
CLI と API リファレンス
履歴 RX
IPv6 メッセージの RX 履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - タイプ:
- IPv6 メッセージ タイプ(
UDP
、TCP
、HopOpts
、ICMP6
(およびそのサブタイプ)など)。 src
: 送信元 IPv6 アドレスとポート番号。dst
: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP に対して有効で、それ以外の場合は 0)。
- IPv6 メッセージ タイプ(
- Len: IPv6 ペイロードの長さ(IPv6 ヘッダーを除く)。
- Chksum: メッセージ チェックサム(UDP、TCP、または ICMP6 メッセージに有効)。
- Sec: リンクレイヤ セキュリティが使用されているかどうかを示します。
- 優先度: メッセージの優先度。有効な値は
low
、norm
、high
、net
(スレッド制御メッセージの場合)です。 - RSS: 受信信号強度(dBm)。メッセージを形成したすべての受信フラグメント フレームでの平均。TX 履歴の場合は、
NA
(該当なし)が表示されます。 - Dir: メッセージの送信(
TX
)と受信(RX
)のどちらであるかを示します。送信に失敗した場合は、表形式のTX-F
またはリスト形式のtx-success:no
で示されます。送信失敗の例としては、tx
が中断され、どのメッセージ フラグメントについてピアからack
が送信されないこともあります。 - Neighb: メッセージが送受信されたネイバーの短いアドレス(RLOC16)。ブロードキャストされたフレームは、表形式では
bcast
、リスト形式では0xffff
として表示されます。ネイバーの短いアドレスが使用できない場合は、テーブル形式のunknwn
またはリスト形式の0xfffe
として表示されます。 - Radio: メッセージの送受信に使用されるラジオリンク(
OPENTHREAD_CONFIG_MULTI_RADIO
が有効な場合に有用)。15.4
、trel
、all
のいずれかです(すべてのラジオリンクで送信する場合)。
パラメータ
history rx [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history rx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xbd26 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x3f7d | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0x942c | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
| | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x2e37 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xe177 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0x82ee | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0x52df | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x5ccf | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
Done
history rx list 4
00:00:13.368
type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done
CLI と API リファレンス
履歴 answerx
IPv6 メッセージの RX 履歴と TX 履歴を組み合わせて、テーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - タイプ:
- IPv6 メッセージ タイプ(
UDP
、TCP
、HopOpts
、ICMP6
(およびそのサブタイプ)など)。 src
: 送信元 IPv6 アドレスとポート番号。dst
: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP に対して有効で、それ以外の場合は 0)。
- IPv6 メッセージ タイプ(
- Len: IPv6 ペイロードの長さ(IPv6 ヘッダーを除く)。
- Chksum: メッセージ チェックサム(UDP、TCP、または ICMP6 メッセージに有効)。
- Sec: リンクレイヤ セキュリティが使用されているかどうかを示します。
- 優先度: メッセージの優先度。有効な値は
low
、norm
、high
、net
(スレッド制御メッセージの場合)です。 - RSS: 受信信号強度(dBm)。メッセージを形成したすべての受信フラグメント フレームでの平均。TX 履歴の場合は、
NA
(該当なし)が表示されます。 - Dir: メッセージの送信(
TX
)と受信(RX
)のどちらであるかを示します。送信に失敗した場合は、表形式のTX-F
またはリスト形式のtx-success:no
で示されます。送信失敗の例としては、tx
が中断され、どのメッセージ フラグメントについてピアからack
が送信されないこともあります。 - Neighb: メッセージが送受信されたネイバーの短いアドレス(RLOC16)。ブロードキャストされたフレームは、表形式では
bcast
、リスト形式では0xffff
として表示されます。ネイバーの短いアドレスが使用できない場合は、テーブル形式のunknwn
またはリスト形式の0xfffe
として表示されます。 - Radio: メッセージの送受信に使用されるラジオリンク(
OPENTHREAD_CONFIG_MULTI_RADIO
が有効な場合に有用)。15.4
、trel
、all
のいずれかです(すべてのラジオリンクで送信する場合)。
パラメータ
history rxtx [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history rxtx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x6c6b | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0xc6a2 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
| | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0xc5a2 | yes | norm | NA | TX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
| | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xaa0d | yes | net | NA | TX | 0x0800 | 15.4 |
| 00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xc1d8 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x3cb1 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xeda0 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0xbdfa | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0x1c11 | no | net | NA | TX | 0x0800 | 15.4 |
| 00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0xedff | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0xd383 | no | net | NA | TX | bcast | 15.4 |
| 00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history rxtx list 5
00:00:02.100
type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done
CLI と API リファレンス
履歴 tx
IPv6 メッセージの送受信履歴をテーブル形式またはリスト形式で表示します。
各テーブルまたはリストエントリには次のものが含まれます。
- Age: コマンドが発行されてからの経過時間。
hours
:minutes
:seconds
:milliseconds
の形式で指定します。 - タイプ:
- IPv6 メッセージ タイプ(
UDP
、TCP
、HopOpts
、ICMP6
(およびそのサブタイプ)など)。 src
: 送信元 IPv6 アドレスとポート番号。dst
: 宛先 IPv6 アドレスとポート番号(ポート番号は UDP/TCP に対して有効で、それ以外の場合は 0)。
- IPv6 メッセージ タイプ(
- Len: IPv6 ペイロードの長さ(IPv6 ヘッダーを除く)。
- Chksum: メッセージ チェックサム(UDP、TCP、または ICMP6 メッセージに有効)。
- Sec: リンクレイヤ セキュリティが使用されているかどうかを示します。
- 優先度: メッセージの優先度。有効な値は
low
、norm
、high
、net
(スレッド制御メッセージの場合)です。 - RSS: 受信信号強度(dBm)。メッセージを形成したすべての受信フラグメント フレームでの平均。TX 履歴の場合は、
NA
(該当なし)が表示されます。 - Dir: メッセージの送信(
TX
)と受信(RX
)のどちらであるかを示します。送信に失敗した場合は、表形式のTX-F
またはリスト形式のtx-success:no
で示されます。送信失敗の例としては、tx
が中断され、どのメッセージ フラグメントについてピアからack
が送信されないこともあります。 - Neighb: メッセージが送受信されたネイバーの短いアドレス(RLOC16)。ブロードキャストされたフレームは、表形式では
bcast
、リスト形式では0xffff
として表示されます。ネイバーの短いアドレスが使用できない場合は、テーブル形式のunknwn
またはリスト形式の0xfffe
として表示されます。 - Radio: メッセージの送受信に使用されるラジオリンク(
OPENTHREAD_CONFIG_MULTI_RADIO
が有効な場合に有用)。15.4
、trel
、all
のいずれかです(すべてのラジオリンクで送信する場合)。
パラメータ
history tx [list] [num-entries]
- 出力をリスト形式で表示するには、
list
オプションを使用します。それ以外の場合、出力は表形式で表示されます。 num-entries
オプションを使用して、指定された最新のエントリ数に出力を制限します。このオプションを使用しない場合、保存されているすべてのエントリが出力に表示されます。
例
history tx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0x932c | yes | norm | NA | TX | 0x4800 | 15.4 |
| 00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
| | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xce87 | yes | net | NA | TX | 0x4800 | 15.4 |
| 00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0xf7ba | no | net | NA | TX | 0x4800 | 15.4 |
| 00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0x26d4 | no | net | NA | TX | bcast | 15.4 |
| 00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history tx list
00:00:23.957
type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[ff02:0:0:0:0:0:0:2]:19788
Done
CLI と API リファレンス
ifconfig(up、down)
IPv6 インターフェースを稼働させます。
これを呼び出して、IPv6 通信を有効または無効にします。
パラメータ
ifconfig up|down
例
ifconfig up
Done
ifconfig down
Done
CLI と API リファレンス
ifconfig
IPv6 インターフェースが稼働しているかどうかを示します。
パラメータ
パラメータなし。
例
ifconfig
down
Done
ifconfig
up
Done
CLI と API リファレンス
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 の受信リンクがあるルーター ID2-links
: このルーターにリンク品質 2 の受信リンクがあるルーター ID1-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-idled
: フルスレッド デバイス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)
- netdata 公開 dnssrp ユニキャスト(mle)
- otNetDataPublishDnsSrpServiceAnycast
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 公開 dnssrp ユニキャスト(addr,port)
- netdata 公開 dnssrp エニーキャスト
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
netdata 公開接頭辞
メッシュ上の接頭辞エントリを公開します。詳細については、OT CLI を使用してネットワーク データを表示および管理するを参照してください。
パラメータ
netdata publish prefix prefix [padcrosnD] [high|med|low]
OT CLI は、マッピングされた引数を使用して otBorderRouterConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
netdata publish prefix fd00:1234:5678::/64 paos med
Done
CLI と API リファレンス
netdata 公開 置換
以前に公開された外部ルートエントリを置き換えます。詳細については、OT CLI を使用してネットワーク データを表示および管理するを参照してください。
パラメータ
netdata publish replace oldprefix prefix [sn] [high|med|low]
OT CLI は、マッピングされた引数を使用して otExternalRouteConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
CLI と API リファレンス
netdata のパブリッシュ ルート
外部ルートエントリを公開します。詳細については、OT CLI を使用してネットワーク データを表示および管理するを参照してください。
パラメータ
publish route prefix [sn] [high|med|low]
OT CLI は、マッピングされた引数を使用して otExternalRouteConfig 値を構成します。詳細については、OpenThread CLI の概要をご覧ください。
例
netdata publish route fd00:1234:5678::/64 s high
Done
CLI と API リファレンス
netdata レジスタ
構成したプレフィックス、ルート、サービスをリーダーに登録する。
OT CLI は OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
をチェックします。OTBR が有効な場合は、ローカル ネットワーク データがリーダーに登録されます。それ以外の場合は、CLI 関数 otServerRegister
を呼び出します。詳細については、OT CLI を使用してネットワーク データを表示および管理するを参照してください。
パラメータ
パラメータなし。
例
netdata register
Done
CLI と API リファレンス
netdata steeringdata チェック(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 拡張アドレス TLV1
: Address16 TLV2
: モード TLV3
: タイムアウト TLV(SED の最大ポーリング時間)4
: 接続 TLV5
: Route64 TLV6
: リーダーデータ TLV7
: ネットワーク データ TLV8
: IPv6 アドレスリスト TLV9
: MAC カウンタ TLV14
: バッテリー残量 TLV15
: 電源電圧 TLV16
: 子テーブル TLV17
: チャンネル ページ TLV19
: 子タイムアウトの最大 TLV23
: EUI64 TLV24
: バージョン TLV(プロトコルと機能のバージョン番号)25
: ベンダー名 TLV26
: ベンダーモデル TLV27
: ベンダー SW バージョン TLV28
: スレッド スタック バージョン TLV(スレッド スタック コードベース/commit/バージョンの場合、UTF-8 文字列としてのバージョン識別子)29
: 子 TLV34
: MLE カウンタ TLV35
: ベンダーアプリ URL TLV
例
networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
PartitionId: 0x640b0f67
Weighting: 64
DataVersion: 116
StableDataVersion: 197
LeaderRouterId: 0x03
EUI64: 18b4300000000004
Done
networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done
CLI と API リファレンス
ネットワーク診断リセット
指定されたアドレスの指定されたタイプ長値(TLV)をリセットするネットワーク診断リクエストを送信します。このコマンドは、9
(MAC カウンタ TLV)または 34
(MLE カウンタ TLV)の TLV 値のみをサポートします。
パラメータ
networkdiagnostic reset addr type(s)
例
networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done
CLI と API リファレンス
networkidtimeout(get、set)
NETWORK_ID_TIMEOUT
パラメータを取得または設定します。
パラメータ
networkidtimeout [timeout]
オプションの timeout
引数を使用して、NETWORK_ID_TIMEOUT
パラメータの値を設定します。
例
networkidtimeout 120
Done
networkidtimeout
120
Done
CLI と API リファレンス
networkkey(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 つのカテゴリのネットワーク データ エントリは、次の順序で優先されます。
- サーバー アドレスがサービスデータに含まれるユニキャスト エントリ。複数のオプションがある場合は、IPv6 アドレスの数値が最も小さいオプションが優先されます。
- それぞれシーケンス番号を持つエニーキャスト エントリ。RFC-1982 の Serial Number Arithmetic Logic で指定された最大のシーケンス番号が優先されます。
- サーバー アドレス情報がサーバー データに含まれるユニキャスト エントリ。複数のオプションがある場合は、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
パラメータを使用して、自動ホスト アドレス モードを有効にします。有効にすると、クライアントはリンクローカル アドレスとメッシュローカル アドレスを除くすべての優先 Threadnetif
ユニキャスト アドレスを自動的に使用します。有効なアドレスがない場合、メッシュのローカル EID アドレスが追加されます。スレッドnetif
上のアドレスが追加または削除されたり、非優先とマークされたりすると、SRP クライアントは自動的に再登録されます。- ホストアドレスのリストを明示的に指定します。各アドレスはスペースで区切ります。このリストは、クライアントの実行時に設定できます。これにより、自動ホストアドレス モードも無効になります。
例
srp client host address auto
Done
srp client host address fd00::cafe
Done
CLI と API リファレンス
srp クライアント ホストを消去
すべてのホスト情報とすべてのサービスを消去します。
パラメータ
パラメータなし。
例
srp client host clear
Done
CLI と API リファレンス
srp クライアントのホスト名(get、set)
SRP クライアントのホスト名を取得または設定します。詳細については、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 リファレンス
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
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 リファレンス
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
tcp 中止
サンプルの TCP エンドポイントに関連付けられた TCP 接続が意図せず終了し、TCP エンドポイントが閉じた状態に移行します。
パラメータ
パラメータなし。
例
tcp abort
TCP: Connection reset
Done
CLI と API リファレンス
TCP ベンチマークの結果
TCP ベンチマーク テストの最新の結果を表示します。ステータス値の例は次のとおりです。
- 継続中
- 完了
- 未テスト
このコマンドは、TCP ベンチマーク テストを自動化するスクリプトの作成を主な目的としています。
パラメータ
パラメータなし。
例
tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s
CLI と API リファレンス
- 関連付けられた API はありません
TCP ベンチマークの実行
tcp
CLI で提供されるサンプル TCP エンドポイントに現在関連付けられている TCP 接続を使用して、指定されたバイト数を転送します。
パラメータ
tcp benchmark run [size]
size
パラメータを使用して、ベンチマーク用に送信するバイト数を指定します。size
パラメータを使用しない場合は、デフォルト値(OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE
)が使用されます。
例
tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s
CLI と API リファレンス
- 関連付けられた API はありません
TCP バインド
IPv6 アドレスとポートを、tcp
CLI で提供されるサンプル TCP エンドポイントに関連付けます。TCP エンドポイントを IPv6 アドレスとポートに関連付けることを「TCP エンドポイントの命名」と呼びます。これにより、通信のためにエンドポイントがバインドされます。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp bind ip port
ip
: バインドする IPv6 アドレス。TCP/IPv6 スタックにバインディング IPv6 アドレスを割り当てる場合は、未指定の IPv6 アドレス(::
)を使用します。port
: バインドする TCP ポート番号。
例
tcp bind :: 30000
Done
CLI と API リファレンス
TCP 接続
指定したピアとの接続を確立します。
接続の確立に成功すると、結果の TCP 接続はサンプルの TCP エンドポイントに関連付けられます。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp connect ip port [fastopen]
ip
: ピアの IP アドレス。アドレスは IPv4 アドレスにできます。これは、ネットワーク データから優先される NAT64 プレフィックスを使用して IPv6 アドレスに合成されます。優先 NAT64 プレフィックスが使用できない場合、このコマンドはInvalidState
を返します。port
: ピアの TCP ポート番号。fastopen
: このパラメータは省略可能です。fast
に設定すると、この接続で TCP Fast Open が有効になります。それ以外の場合、このパラメータをslow
に設定するか、使用しない場合、TCP Fast Open は無効になります。
例
tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established
tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
CLI と API リファレンス
tcp の定義
この TCP エンドポイントの初期化を解除します。
つまり、OpenThread はこの TCP エンドポイントを追跡しなくなり、この TCP エンドポイントに内部で割り当てられたすべてのリソースの割り当てを解除します。アプリケーションは、TCP エンドポイントの背後にあるメモリを適宜再利用できます。
ライブ TCP 接続に対応する場合、接続は無意識に終了します(otTcpAbort() など)。アプリケーションがこの TCP エンドポイント用に提供しているすべてのリソース(送信バッファ用のリンク バッファ、受信バッファ用のメモリ、aEndpoint
構造体自体など)は、すぐにアプリケーションに返されます。
パラメータ
パラメータなし。
例
tcp deinit
Done
CLI と API リファレンス
tcp init
tcp
CLI で提供されるサンプル TCP リスナーとサンプル TCP エンドポイントを初期化します。
パラメータ
tcp init [mode] [size]
mode
には、次の 3 つの値を指定できます。tls
: 2 つのノード間の TCP 接続でも TCP 上で TLS プロトコルを使用することを指定します。2 つのノードが TCP を介して通信する場合、非 TLS エンドポイントは TLS エンドポイントと通信できないため、両方のノードで TLS を使用するか、どちらのノードも TLS を使用する必要があります。linked
またはcircular
: これらのオプションのいずれかは、TLS を使用せず、指定されたバッファタイプを TCP バッファリングに使用する必要があることを意味します。linked
とcircular
の動作は同じです。コードを調べて、この 2 つのバッファリング タイプの違いを確認します。TCP 接続の 2 つのエンドポイントで同じバッファリング タイプを使用する必要はありません。
size
パラメータは、サンプルの TCP エンドポイントに関連付ける受信バッファのサイズを設定します。指定しない場合は、最大サイズが使用されます。最大サイズはOPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE
で設定されます。
例
tcp init tls
Done
CLI と API リファレンス
TCP リッスン
TCP リスナーの例を使用して、指定された IPv6 アドレスとポートで受信接続をリッスンします。詳細については、OT CLI を使用した TCP 機能のテストをご覧ください。
パラメータ
tcp listen ip port
次のパラメータを指定します。
ip
:tcp
CLI によって提供されるサンプル TCP リスナーの IPv6 アドレスまたは未指定の IPv6 アドレス(::
)。port
: サンプルの TCP リスナーの TCP ポート。サンプルの TCP エンドポイントに TCP 接続が関連付けられていない場合、指定された IPv6 アドレスとポートに一致する受信接続が受け入れられ、サンプルの TCP エンドポイントに関連付けられます。
例
tcp listen :: 30000
Done
CLI と API リファレンス
tcp 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
を有効にする必要があります。
文字列は、「
結果の文字列が(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