CLI-Befehlsreferenz

BA sitzungsspezifischer Schlüssel

Gibt an, ob ein sitzungsspezifischer Schlüssel derzeit aktiv ist.

Erfordert OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Parameter

Keine Parameter.

Beispiele

ba ephemeralkey
active
Done

Befehlszeilen- und API-Referenzen

ba sitzungsspezifischer Schlüssel-Callback (aktivieren, deaktivieren)

Legt die Callback-Funktion fest, die vom Border Agent verwendet wird, um über Änderungen im Zusammenhang mit der Verwendung eines sitzungsspezifischen Schlüssels informiert zu werden.

Erfordert OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Durch einen nachfolgenden Aufruf dieser Funktion werden alle zuvor festgelegten Callbacks ersetzt.

Parameter

Keine Parameter.

Beispiele

ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive

Befehlszeilen- und API-Referenzen

ba sitzungskey löschen

Bricht den verwendeten sitzungsspezifischen Schlüssel ab.

Erfordert OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Kann verwendet werden, um einen zuvor festgelegten sitzungsspezifischen Schlüssel zu löschen, bevor eine Zeitüberschreitung auftritt. Wenn der Border Agent nicht ausgeführt wird oder kein sitzungsspezifischer Schlüssel verwendet wird, hat das Aufrufen dieser Funktion keine Auswirkungen.

Wenn ein Provisioner über den sitzungsspezifischen Schlüssel verbunden und derzeit aktiv ist, wird durch den Aufruf dieser Funktion ihr Status nicht geändert. In diesem Fall gibt otBorderAgentIsEphemeralKeyActive() weiterhin TRUE zurück, bis die Verbindung zum Kommissar getrennt wird.

Parameter

Keine Parameter.

Beispiele

ba ephemeralkey clear
Done

Befehlszeilen- und API-Referenzen

ba-sitzungsspezifischer Schlüssel [timeout-in-ms] [port]

Legt den sitzungsspezifischen Schlüssel für ein bestimmtes Zeitlimit fest.

Erfordert OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Der sitzungsspezifische Schlüssel kann festgelegt werden, wenn der Border Agent bereits ausgeführt wird und derzeit mit keinem externen Bevollmächtigten verbunden ist (d.h. er sich im Status OT_BORDER_AGENT_STATE_STARTED befindet). Andernfalls wird OT_ERROR_INVALID_STATE zurückgegeben.

Der angegebene aKeyString wird direkt als sitzungsspezifischer PSK verwendet (mit Ausnahme des nachgestellten null-\0-Zeichens). Die aKeyString-Länge muss zwischen OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH und OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH (jeweils einschließlich) liegen.

Wenn Sie den sitzungsspezifischen Schlüssel noch einmal festlegen, bevor eine Zeitüberschreitung für einen zuvor festgelegten Schlüssel eintritt, wird der zuvor festgelegte Schlüssel ersetzt und das Zeitlimit zurückgesetzt.

Während das Zeitlimitintervall gilt, kann der sitzungsspezifische Schlüssel von einem externen Auftraggeber nur einmal zur Verbindung verwendet werden. Nachdem die Verbindung des Kommissars getrennt wurde, wird der sitzungsspezifische Schlüssel gelöscht und der Border Agent verwendet wieder PSKc.

Parameter

Keine Parameter.

Beispiele

ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done

Befehlszeilen- und API-Referenzen

BID (get,set)

Ruft die 16 Byte große Border Router-ID ab oder legt sie fest, anhand derer das Gerät unter mehreren BR eindeutig identifiziert werden kann.

Parameter

ba id [border-agent-id]

Verwenden Sie das optionale Argument border-agent-id, um die Border-Agent-ID festzulegen.

Beispiele

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done

Befehlszeilen- und API-Referenzen

Ba-Port

Ruft den UDP-Port des Thread Border Agent-Diensts ab.

Parameter

Keine Parameter.

Beispiele

ba port
49153
Done

Befehlszeilen- und API-Referenzen

BA State

Ruft den otBorderAgentState der Rolle "Thread Border Agent" ab.

Parameter

Keine Parameter.

Beispiele

ba state
Started
Done

Befehlszeilen- und API-Referenzen

BBR

Gibt die aktuellen Informationen zum primären Backbone-Router für das Thread-Gerät zurück.

Parameter

Keine Parameter.

Beispiele

bbr
BBR Primary:
server16: 0xE400
seqno:    10
delay:    120 secs
timeout:  300 secs
Done
bbr
BBR Primary: None
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

bbr-Konfiguration (festlegen)

Legt die Konfiguration des lokalen Backbone-Routers otBackboneRouterConfig fest.

Die Serverdatenanfragenachricht SRV_DATA.ntf wird automatisch initiiert, wenn sich das BBR-Dataset für den primären Backbone-Router ändert.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

bbr register sollte explizit ausgegeben werden, um den Backbone-Router-Dienst beim Leader für einen sekundären Backbone-Router zu registrieren.

Parameter

bbr config [seqno seqno] [delay delay] [timeout timeout]

Beispiele

bbr config seqno 20 delay 30
Done

Befehlszeilen- und API-Referenzen

BBR-Konfiguration

Ruft die Konfiguration des lokalen Backbone-Routers ab.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

bbr config
seqno:    10
delay:    120 secs
timeout:  300 secs
Done

Befehlszeilen- und API-Referenzen

bbr deaktivieren

Aktiviert oder deaktiviert die Backbone-Funktion.

Wenn diese Option aktiviert ist, wird die Serverdatenanfragenachricht SRV_DATA.ntf für das angeschlossene Gerät ausgelöst, wenn in den Thread-Netzwerkdaten kein Backbone-Routerdienst vorhanden ist.

Ist die Richtlinie deaktiviert, wird SRV_DATA.ntf ausgelöst, wenn sich der Backbone-Router im primären Status befindet.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

bbr disable
Done

Befehlszeilen- und API-Referenzen

BBR aktivieren

Aktiviert oder deaktiviert die Backbone-Funktion.

Wenn diese Option aktiviert ist, wird die Serverdatenanfragenachricht SRV_DATA.ntf für das angeschlossene Gerät ausgelöst, wenn in den Thread-Netzwerkdaten kein Backbone-Routerdienst vorhanden ist.

Ist die Richtlinie deaktiviert, wird SRV_DATA.ntf ausgelöst, wenn sich der Backbone-Router im primären Status befindet.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

bbr enable
Done

Befehlszeilen- und API-Referenzen

BRBR-Jitter (get,set)

Ruft den Jitter (in Sekunden) für die Registrierung des Backbone-Routers ab oder legt ihn fest.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

bbr jitter [jitter]

Beispiele

bbr jitter
20
Done
bbr jitter 10
Done

Befehlszeilen- und API-Referenzen

BBR-Verwaltung für Dua

Mit dem meshLocalIid wird mit diesem Befehl der Antwortstatus für die nächste DUA-Registrierung konfiguriert. Antworten Sie ohne meshLocalIid auf die nächste DUA.req mit dem angegebenen status oder coap-code.

Verfügbar, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Parameter

bbr mgmt dua status|coap-code [meshLocalIid]

Für status oder coap-code verwenden Sie:

  • 0: ST_DUA_SUCCESS
  • 1: ST_DUA_REREGISTER,
  • 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-Code 5.00

Beispiele

bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done

Befehlszeilen- und API-Referenzen

bbr mgmt mlr Listener hinzufügen

Fügt einen Multicast-Listener mit einem Zeitlimit in Sekunden hinzu.

Übergeben Sie 0, um das standardmäßige MLR-Zeitlimit zu verwenden.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE und OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert sind.

Parameter

bbr mgmt mlr listener add ipaddress [timeout-seconds]

Beispiele

bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done

Befehlszeilen- und API-Referenzen

bbr mgmt mlr-Listener

Gibt die Multicast-Listener mit dem otBackboneRouterMulticastListenerInfomTimeout in Sekunden zurück.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE und OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE aktiviert sind.

Parameter

Keine Parameter.

Beispiele

bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done

Befehlszeilen- und API-Referenzen

bbr mgmt mlr Listener klar

Löscht die Multicast-Listener.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE und OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert sind.

Parameter

Keine Parameter.

Beispiele

bbr mgmt mlr listener clear
Done

Befehlszeilen- und API-Referenzen

bbr mgmt mlr-Antwort

Konfiguriert den Antwortstatus für die nächste Multicast-Listener-Registrierung.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE und OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert sind.

Parameter

bbr mgmt mlr response status-code

Für status-code verwenden Sie:

  • 0: ST_MLR_SUCCESS
  • 2: ST_MLR_UNGÜLTIG
  • 3: ST_MLR_NO_PERSISTENT
  • 4: ST_MLR_NO_RESOURCES.
  • 5: ST_MLR_BBR_NOT_PRIMARY
  • 6: ST_MLR_GENERAL_FAILURE

Beispiele

bbr mgmt mlr response 2
Done

Befehlszeilen- und API-Referenzen

BBR-Register

Registriert die Konfiguration des lokalen Backbone-Routers explizit.

Für das angeschlossene Gerät wird die Nachricht „Serverdatenanfrage“ SRV_DATA.ntf ausgelöst.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

bbr register
Done

Befehlszeilen- und API-Referenzen

BBR-Status

Ruft den Backbone-Router otBackboneRouterState ab.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done

Befehlszeilen- und API-Referenzen

br deaktivieren

Deaktiviert den Border Routing Manager.

Parameter

Keine Parameter.

Beispiele

br disable
Done

Befehlszeilen- und API-Referenzen

BR aktivieren

Aktiviert den Border Routing Manager.

Parameter

Keine Parameter.

Beispiele

br enable
Done

Befehlszeilen- und API-Referenzen

Britisch

Initialisiert den Border Routing Manager.

Parameter

br init infrastructure-network-index is-running

Beispiele

br init 2 1
Done

Befehlszeilen- und API-Referenzen

BR nat64Präfix

Gibt sowohl lokale als auch bevorzugte NAT64-Präfixe aus.

Parameter

Keine Parameter.

Beispiele

br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done

Befehlszeilen- und API-Referenzen

br nat64prefix bevorzugt

Ruft das aktuell bevorzugte NAT64-Präfix ab.

Das bevorzugte NAT64-Präfix kann über den Infrastrukturlink erkannt oder das lokale NAT64-Präfix dieses Geräts sein.

Parameter

Keine Parameter.

Beispiele

br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done

Befehlszeilen- und API-Referenzen

br nat64prefix lokal

Ruft das lokale NAT64-Präfix des Border-Routers ab.

Das NAT64-Präfix wird im Thread-Netzwerk möglicherweise nicht beworben.

OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE muss aktiviert sein.

Parameter

Keine Parameter.

Beispiele

br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done

Befehlszeilen- und API-Referenzen

BR OMR-Präfix

Gibt sowohl das lokale als auch das bevorzugte OMR-Präfix aus.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

BR omrpräfix bevorzugt

Ruft das aktuell bevorzugte OMR-Präfix (Off-Mesh-Routable) ab.

Das bevorzugte OMR-Präfix kann aus Netzwerkdaten ermittelt werden oder das lokale OMR-Präfix dieses Geräts sein.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

br omrpräfix lokal

Ruft das lokale OMR-Präfix (Off-Mesh-Routable) ab, z. B. fdfc:1ff5:1512:5622::/64.

Ein OMR-Präfix ist ein zufällig generiertes 64-Bit-Präfix, das im Thread-Netzwerk veröffentlicht wird, wenn es noch kein OMR-Präfix gibt. Dieses Präfix ist über das lokale WLAN oder Ethernet-Netzwerk erreichbar.

Parameter

Keine Parameter.

Beispiele

br omrprefix local
fdfc:1ff5:1512:5622::/64
Done

Befehlszeilen- und API-Referenzen

br onlinkpräfix

Gibt sowohl lokale als auch bevorzugte Präfixe bei der Verbindung aus.

Parameter

Keine Parameter.

Beispiele

br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done

Befehlszeilen- und API-Referenzen

br onlinkprefix bevorzugt

Ruft das aktuell bevorzugte On-Link-Präfix ab.

Das bevorzugte Präfix ist entweder ein erkanntes On-Link-Präfix im Infrastrukturlink oder das lokale Präfix für die Verbindung.

Parameter

Keine Parameter.

Beispiele

br onlinkprefix favored
2600::0:1234:da12::/64
Done

Befehlszeilen- und API-Referenzen

br onlinkprefix lokal

Ruft das lokale On-Link-Präfix für den angrenzenden Infrastrukturlink ab.

Das lokale On-Link-Präfix ist ein 64-Bit-Präfix, das im Infrastrukturlink beworben wird, wenn für den Link noch kein verwendbares Präfix für den Link vorhanden ist.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

br-Präfixtabelle

Rufen Sie die vom Border Routing Manager erkannten Präfixe über den Infrastrukturlink ab. Informationen pro Präfixeintrag:

  • Das Präfix
  • Gibt an, ob das Präfix eine Verbindung oder Route hat
  • Millisekunden seit der letzten Router-Anzeige mit diesem Präfix
  • Präfixlebensdauer in Sekunden
  • Bevorzugte Lebensdauer in Sekunden nur dann, wenn das Präfix „On-Link“ ist
  • Routenpräferenz (niedrig, mittel, hoch), wenn das Präfix eine Route ist (nicht auf der Verbindung)
  • Die IPv6-Adresse des Routers, die dieses Präfix anbietet
  • Flags im empfangenen Router-Advertising-Header:
    • M: Flag für die Konfiguration der verwalteten Adresse
    • O: Anderes Konfigurations-Flag
    • Stub: Flag „Stub-Router“ (gibt an, ob der Router ein Stub-Router ist)

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

b raoptions (fest,löschen)

Legt zusätzliche Optionen fest, die am Ende von RA-Nachrichten (Router Advertisement) angehängt werden.

Der Inhalt von aOptions wird intern kopiert und kann daher ein temporärer Zwischenspeicher sein (z.B. ein zugewiesenes Stack-Array).

Nachfolgende Aufrufe dieser Funktion überschreiben den zuvor festgelegten Wert.

Parameter

br raoptions options|clear

br raoptions clear übergibt nullptr an otBorderRoutingSetExtraRouterAdvertOptions. Andernfalls können Sie das options-Byte als Hex-Daten übergeben.

Beispiele

br raoptions 0400ff00020001
Done
br raoptions clear
Done

Befehlszeilen- und API-Referenzen

br rioprf (hoch,mittel,niedrig)

Hiermit wird explizit die Einstellung festgelegt, die beim Bewerben von Route Info Options (RIO) in Router-Advertising-Nachrichten verwendet werden soll, die über den Infrastrukturlink gesendet werden.

Nach dem Aufruf dieser Funktion verwendet BR die vorgegebene Präferenz für alle beworbenen RIOs. Sie können die Einstellung löschen, indem Sie otBorderRoutingClearRouteInfoOptionPreference() aufrufen.

Parameter

br rioprf [high|med|low]

Beispiele

br rioprf low
Done

Befehlszeilen- und API-Referenzen

BR Rioprf

Ruft die aktuelle Einstellung ab, die beim Bewerben von Routeninformationsoptionen (RIO) in Router-Advertising-Nachrichten verwendet wird, die über den Infrastrukturlink gesendet werden.

Die RIO-Einstellung wird so festgelegt:

  • Wenn die Einstellung explizit durch den Nutzer durch Aufrufen von otBorderRoutingSetRouteInfoOptionPreference() festgelegt wird, wird die angegebene Einstellung verwendet.
  • Andernfalls wird sie anhand der aktuellen Rolle des Geräts ermittelt: mittlere Präferenz für Router-/Leader-Rolle und niedrige Präferenz für untergeordnete Rolle.

Parameter

Keine Parameter.

Beispiele

br rioprf
med
Done

Befehlszeilen- und API-Referenzen

BR rioprf klar

Löscht einen zuvor festgelegten Präferenzwert für beworbene Routeninformationen.

Nach dem Aufruf dieser Funktion verwendet BR die Rolle des Geräts, um die RIO-Präferenz zu bestimmen: mittlere Präferenz bei Router-/Leader-Rolle und niedrige Präferenz bei untergeordneter Rolle.

Parameter

Keine Parameter.

Beispiele

br rioprf clear
Done

Befehlszeilen- und API-Referenzen

br Routeprf (hoch,mittel,niedrig)

Legt die Einstellung für veröffentlichte Routen in Netzwerkdaten explizit fest.

Nach dem Aufruf dieser Funktion verwendet die BR die vorgegebene Präferenz. Sie können die Einstellung löschen, indem Sie otBorderRoutingClearRoutePreference() aufrufen.

Parameter

br routeprf [high|med|low]

Beispiele

br routeprf low
Done

Befehlszeilen- und API-Referenzen

BR Routeprf

Ruft die aktuelle Einstellung ab, die für veröffentlichte Routen in Netzwerkdaten verwendet wird.

Die Präferenz wird so festgelegt:

  • Wenn die Einstellung explizit durch den Nutzer durch Aufrufen von otBorderRoutingSetRoutePreference() festgelegt wird, wird die angegebene Einstellung verwendet.
  • Andernfalls wird sie von RoutingManager automatisch anhand der Rolle des Geräts und der Linkqualität ermittelt.

Parameter

Keine Parameter.

Beispiele

br routeprf
med
Done

Befehlszeilen- und API-Referenzen

brrouteprf klar

Löscht einen zuvor festgelegten Präferenzwert für veröffentlichte Routen in den Netzwerkdaten.

Nach dem Aufruf dieser Funktion bestimmt die AF die Präferenz automatisch basierend auf der Rolle des Geräts und der Qualität der Verknüpfung (bei der Rolle des Endgeräts mit dem Elternteil).

Parameter

Keine Parameter.

Beispiele

br routeprf clear
Done

Befehlszeilen- und API-Referenzen

BR Router

Rufen Sie die Liste der vom Border Routing Manager erkannten Router über den Infrastrukturlink ab. Informationen pro Router:

  • IPv6-Adresse des Routers
  • Flags im empfangenen Router-Advertising-Header:
    • M: Flag für die Konfiguration der verwalteten Adresse
    • O: Anderes Konfigurations-Flag
    • Stub: Flag „Stub-Router“ (gibt an, ob der Router ein Stub-Router ist)

Parameter

Keine Parameter.

Beispiele

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done

Befehlszeilen- und API-Referenzen

BR-Bundesstaat

Ruft den aktuellen Status von Border Routing Manager ab.

Parameter

Keine Parameter.

Beispiele

br state
running

Befehlszeilen- und API-Referenzen

Zwischenspeicherinformationen

Ruft die aktuellen Informationen zum Nachrichtenpuffer ab.

  • total: Zeigt die Gesamtzahl der Nachrichtenzwischenspeicher im Pool an.
  • free: Zeigt die Anzahl der kostenlosen Zwischenspeicher für Nachrichten an.
  • max-used zeigt die maximale Anzahl gleichzeitiger Zwischenspeicher seit der Initialisierung des OT-Stacks oder der letzten bufferinfo reset an.

Als Nächstes zeigt die Befehlszeile Informationen zu verschiedenen Warteschlangen an, die vom OpenThread-Stack verwendet werden, z. B. 6lo send. Jede Zeile nach der Warteschlange stellt Informationen zu einer Warteschlange dar:

  • Die erste Zahl steht für die Anzahl der Nachrichten in der Warteschlange.
  • Die zweite Zahl gibt die Anzahl der Puffer an, die von allen Nachrichten in der Warteschlange verwendet wurden.
  • Die dritte Zahl entspricht der Gesamtzahl der Byte aller Nachrichten in der Warteschlange.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Zwischenspeicherinformationen zurücksetzen

Setzen Sie den Informationszähler für den Nachrichtenpuffer zurück, der die maximale Anzahl gleichzeitig verwendeter Puffer verfolgt.

Dadurch wird mMaxUsedBuffers in otBufferInfo zurückgesetzt.

Parameter

Keine Parameter.

Beispiele

bufferinfo reset
Done

Befehlszeilen- und API-Referenzen

ccathreshold (get,set)

Ruft den CCA-Grenzwert in dBm ab, gemessen am Antennenanschluss, gemäß IEEE 802.15.4 – 2015, Abschnitt 10.1.4.

Parameter

ccathreshold [CCA-threshold-dBm]

Verwenden Sie das optionale Argument CCA-threshold-dBm, um den CCA-Grenzwert festzulegen.

Beispiele

ccathreshold
-75 dBm
Done
ccathreshold -62
Done

Befehlszeilen- und API-Referenzen

channel (get,set)

Ruft den IEEE 802.15.4-Channelwert ab oder legt ihn fest.

Parameter

channel [channel-num]

Verwenden Sie channel-num, um die Version festzulegen.

Beispiele

channel
11
Done
channel 11
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Kanalmanager (automatisch)

Aktiviert oder deaktiviert die Funktion zur automatischen Kanalauswahl für den Netzwerkkanal.

Wenn diese Option aktiviert ist, ruft ChannelManager regelmäßig ein RequestChannelSelect(false) auf. Das Periodenintervall kann durch otChannelManagerSetAutoChannelSelectionInterval() festgelegt werden.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager auto enable

1 ist ein boolescher Wert für enable.

Beispiele

channel manager auto 1
channel manager auto 1
Done

Befehlszeilen- und API-Referenzen

Änderung des Kanalmanagers

Fordert eine Änderung des Thread-Netzwerkkanals an.

Das Netzwerk wechselt nach einer bestimmten Verzögerung zum angegebenen Kanal (siehe otChannelManagerSetDelay()). Der Kanalwechsel wird ausgeführt, indem das ausstehende operative Dataset aktualisiert wird.

Durch einen nachfolgenden Aufruf wird eine laufende, zuvor angeforderte Kanaländerung abgebrochen.

Das Feld „OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE“ darf nicht leer sein.

Parameter

channel manager change channel-num

Beispiele

channel manager change 11
channel manager change 11
Done

Befehlszeilen- und API-Referenzen

Kanalmanager

Rufe den Status des Kanalmanagers ab. OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE ist erforderlich.

Parameter

Keine Parameter.

Beispiele

channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done

Befehlszeilen- und API-Referenzen

Verzögerung des Kanalmanagers

Legt die Verzögerung (in Sekunden) für den Wechsel eines Netzwerkkanals fest.

Nur auf FTDs verfügbar. Die Verzögerung sollte vorzugsweise länger sein als das maximale Datenabfrageintervall, das von allen schläfrigen Endgeräten im Thread-Netzwerk verwendet wird.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager delay delay-seconds

Beispiele

channel manager delay 120
channel manager delay 120
Done

Befehlszeilen- und API-Referenzen

Kanalmanager bevorzugt

Legt die Maske des bevorzugten Kanals fest.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager favored mask

Beispiele

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

Befehlszeilen- und API-Referenzen

Channel Manager-Intervall

Legt das Zeitraumintervall (in Sekunden) fest, das von der Funktion zur automatischen Kanalauswahl verwendet wird.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager interval interval-seconds

Beispiele

channel manager interval 10800
channel manager interval 10800
Done

Befehlszeilen- und API-Referenzen

Auswahl des Kanalmanagers

Fordert ChannelManager auf, einen neuen Kanal zu prüfen und auszuwählen und einen Kanalwechsel zu starten.

Im Gegensatz zu otChannelManagerRequestChannelChange() , bei dem der Kanal als Parameter angegeben werden muss, fordert diese Funktion ChannelManager auf, selbst einen Kanal auszuwählen (basierend auf den erfassten Informationen zur Kanalqualität).

Nach dem Aufruf führt der Kanalmanager die folgenden drei Schritte aus:

1) ChannelManager entscheidet, ob der Kanalwechsel hilfreich ist. Diese Prüfung kann übersprungen werden, wenn „aSkipQualityCheck“ auf „true“ gesetzt ist, d. h., dass eine Kanalauswahl erzwungen und die Qualitätsprüfung übersprungen wird. Bei diesem Schritt werden die auf dem Gerät erfassten Messwerte zur Linkqualität (z. B. CCA-Fehlerrate, Frame- und Nachrichtenfehlerraten pro Nachbarn usw.) verwendet, um festzustellen, ob die aktuelle Kanalqualität dem Niveau entspricht, das eine Kanaländerung rechtfertigt.

2) Wenn der erste Schritt erfolgreich ist, wählt ChannelManager einen potenziell besseren Kanal aus. Dabei werden die vom Modul ChannelMonitor erhobenen Daten zur Kanalqualität verwendet. In diesem Schritt werden die unterstützten und bevorzugten Kanäle verwendet. (siehe otChannelManagerSetSupportedChannels() und otChannelManagerSetFavoredChannels() ).

3) Wenn sich der neu ausgewählte Kanal vom aktuellen Kanal unterscheidet, fordert ChannelManager den Kanaländerungsprozess an bzw. startet den Kanalwechsel und ruft dabei intern einen RequestChannelChange() auf.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager select skip-quality-check

Verwenden Sie 1 oder 0 als booleschen Wert skip-quality-check.

Beispiele

channel manager select 1
channel manager select 1
Done

Befehlszeilen- und API-Referenzen

Kanalmanager unterstützt

Legt die unterstützte Kanalmaske fest.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager supported mask

Beispiele

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

Befehlszeilen- und API-Referenzen

Grenzwert für Kanalmanager

Legt den Grenzwert für die CCA-Fehlerrate fest.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE oder OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE und OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sind erforderlich.

Parameter

channel manager threshold threshold-percent

Verwenden Sie für threshold-percent einen Hex-Wert. 0 wird 0% und 0xffff 100 % zugeordnet.

Beispiele

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

Befehlszeilen- und API-Referenzen

Kanalüberwachung

Aktuellen Status der Kanalüberwachung und Kanalbelegung abrufen. Das Feld „OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE“ darf nicht leer sein.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Kanalüberwachung starten

Starten Sie die Kanalüberwachung. Die OT-Befehlszeile sendet den booleschen Wert true an otChannelMonitorSetEnabled. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE ist erforderlich.

Parameter

Keine Parameter.

Beispiele

channel monitor start
channel monitor start
Done

Befehlszeilen- und API-Referenzen

Kanalüberwachung beenden

Beenden Sie die Kanalüberwachung. Die OT-Befehlszeile sendet den booleschen Wert false an otChannelMonitorSetEnabled. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE ist erforderlich.

Parameter

Keine Parameter.

Beispiele

channel monitor stop
channel monitor stop
Done

Befehlszeilen- und API-Referenzen

Kanal bevorzugt

Ruft die Maske des bevorzugten Radiosenders für den bevorzugten Kanal ab.

Parameter

Keine Parameter.

Beispiele

channel preferred
0x7fff800
Done

Befehlszeilen- und API-Referenzen

unterstützter Kanal

Rufen Sie die von Radio unterstützte Kanalmaske ab, die das Gerät nutzen darf.

Parameter

Keine Parameter.

Beispiele

channel supported
0x7fff800
Done

Befehlszeilen- und API-Referenzen

untergeordnetes Element (ID)

Ruft Diagnoseinformationen für ein verknüpftes untergeordnetes Element anhand seiner untergeordneten ID oder RLOC16 ab.

Parameter

child child-id

Beispiele

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

Befehlszeilen- und API-Referenzen

untergeordnete Liste

Gibt eine Liste der angehängten untergeordneten IDs zurück

Parameter

Keine Parameter.

Beispiele

child list
1 2 3 6 7 8
Done

Befehlszeilen- und API-Referenzen

untergeordnete Tabelle

Gibt eine Tabelle der angehängten untergeordneten Elemente aus.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Childip

Ruft eine Liste von IP-Adressen ab, die für untergeordnete MTD-Konten gespeichert sind.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Max. untergeordnete IP (festgelegt)

Legt die maximale Anzahl von IP-Adressen fest oder stellt sie wieder her, die jedes untergeordnete MTD-untergeordnete MTD als übergeordnetes Gerät auf diesem Gerät registrieren kann.

Übergeben Sie 0, um die Einstellung zu löschen und die Standardeinstellung wiederherzustellen.

Verfügbar, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Parameter

childip max count

Beispiele

childip max 2
Done

Befehlszeilen- und API-Referenzen

Max. untergeordnete IP

Ruft die maximale Anzahl von IP-Adressen ab, die jedes untergeordnete MTD-Gerät auf diesem Gerät als übergeordnet registrieren kann.

Parameter

Keine Parameter.

Beispiele

childip max
4
Done

Befehlszeilen- und API-Referenzen

kindmax (festgelegt)

Legt die derzeit maximal zulässige Anzahl von untergeordneten Elementen fest.

Dieser Parameter kann nur festgelegt werden, wenn der Thread-Protokollvorgang beendet wurde.

Parameter

childmax count

Beispiele

childmax 2
Done

Befehlszeilen- und API-Referenzen

ChildMax

Ruft die aktuell maximal zulässige Anzahl von untergeordneten Elementen ab.

Parameter

Keine Parameter.

Beispiele

childmax
5
Done

Befehlszeilen- und API-Referenzen

Ruft den MLE_CHILD_ROUTER_LINKS-Wert ab oder legt ihn fest.

Parameter

childrouterlinks [links]

Beispiele

childrouterlinks
16
Done
childrouterlinks 16
Done

Befehlszeilen- und API-Referenzen

Auscheckzeit für die Elternaufsicht (fest)

Legt das Zeitlimitintervall für die Elternaufsicht für das Kind in Sekunden fest.

Parameter

childsupervision checktimeout timeout-seconds

Beispiele

childsupervision checktimeout 30
Done

Befehlszeilen- und API-Referenzen

Auschecken bei Kinderaufsicht

Ruft das Zeitlimit für die Prüfung der Elternaufsicht für das Kind in Sekunden ab.

Wenn das Gerät ein schläfriges Kind ist und es innerhalb des festgelegten Zeitlimits nichts von seinem Elternteil hört, wird der Vorgang zum erneuten Anhängen gestartet, d. h., es tauscht die MLE-Anfrage/-Antwort für eine Aktualisierung des untergeordneten Elements mit dem übergeordneten Element aus.

Parameter

Keine Parameter.

Beispiele

childsupervision checktimeout
30
Done

Befehlszeilen- und API-Referenzen

Intervall für die Beaufsichtigung von Kindern (festgelegt)

Legt das Intervall der Elternaufsicht für das Kind in Sekunden fest.

Parameter

childsupervision interval interval-seconds

Beispiele

childsupervision interval 30
Done

Befehlszeilen- und API-Referenzen

Intervall für die Beaufsichtigung von Kindern

Ruft das Elternaufsichtsintervall (in Sekunden) für ein Kind ab

Die Funktion „Elternaufsicht für Kinder“ bietet einen Mechanismus, mit dem Eltern sicherstellen können, dass jedes schläfrige Kind innerhalb des Elternaufsichtsintervalls eine Nachricht erhält. Erfolgt innerhalb des Beaufsichtigungsintervalls keine Übertragung an das Kind, stellt OpenThread eine Warteschlange für die Beaufsichtigung von Kindern ein und sendet sie an das Kind.

Parameter

Keine Parameter.

Beispiele

childsupervision interval
30
Done

Befehlszeilen- und API-Referenzen

Childtimeout (festgelegt)

Legt das Zeitlimit für untergeordnete Threads (in Sekunden) fest, das beim Betrieb in der Rolle des untergeordneten Threads verwendet wird.

Parameter

childtimeout timeout-seconds

Beispiele

childtimeout 300
Done

Befehlszeilen- und API-Referenzen

Childtimeout

Ruft das Zeitlimit für untergeordnete Threads (in Sekunden) ab, das bei einem Betrieb in der untergeordneten Rolle verwendet wird.

Parameter

Keine Parameter.

Beispiele

childtimeout
300
Done

Befehlszeilen- und API-Referenzen

Coap abbrechen

Kündigt ein vorhandenes Beobachtungsabo für eine Remote-Ressource auf dem CoAP-Server.

Parameter

Keine Parameter.

Beispiele

coap cancel
Done

Befehlszeilen- und API-Referenzen

coap löschen

Löscht die angegebene CoAP-Ressource.

Parameter

coap delete address uri-path [type] [payload]
  • address: IPv6-Adresse des CoAP-Servers.
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
  • payload: Der CoAP-Nutzlaststring. Beispiel: hellothere.

Beispiele

coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coap get

Ruft Informationen zur angegebenen CoAP-Ressource auf dem CoAP-Server ab.

Parameter

coap get address uri-path [type]
  • address: IPv6-Adresse des CoAP-Servers.
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
    • block-: Verwenden Sie diese Option, gefolgt vom blockorientierten Wert, wenn die Antwort blockweise übertragen werden soll. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coap Beobachtung

Löst eine Aboanfrage aus, mit der der CoAP-Client die angegebene Ressource auf dem CoAP-Server auf mögliche Statusänderungen prüfen kann.

Parameter

coap observe address uri-path [type]
  • address: IPv6-Adresse des CoAP-Servers.
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung).

Beispiele

coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

coap-parameter(get,set)

Ruft die aktuellen CoAP-Parameterwerte ab, wenn der Befehl ohne optionale Parameter ausgeführt wird.

Legt die CoAP-Parameter je nach ausgewählter Syntax entweder auf ihre Standardwerte oder auf die von Ihnen angegebenen Werte fest.

Parameter

coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
  • type: request für CoAP-Anfragen oder response für CoAP-Antworten. Wenn keine weiteren Parameter angegeben werden, gibt der Befehl die aktuelle Konfiguration aus.
  • default: Legt die Übertragungsparameter auf die folgenden Standardwerte fest:
    • ack_timeout: 2.000 Millisekunden
    • ack_random_factor_numerator: 3
    • ack_random_factor_denominator: 2
    • max_retransmit: 4
  • ack_timeout: Die ACK_TIMEOUT (0-UINT32_MAX) in Millisekunden. Weitere Informationen finden Sie in RFC 7252.
  • ack_random_factor_numerator: Der Zähler ACK_RANDOM_FACTOR mit möglichen Werten zwischen 0 und 255. Weitere Informationen finden Sie in RFC 7252.
  • ack_random_factor_denominator: Der Nenner von ACK_RANDOM_FACTOR mit möglichen Werten zwischen 0 und 255. Weitere Informationen finden Sie in RFC 7252.
  • max_retransmit: MAX_RETRANSMIT (0–255). Weitere Informationen finden Sie in RFC 7252.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coap Post

Erstellt die angegebene CoAP-Ressource. Weitere Informationen finden Sie unter Konnektivität mit einer CoAP-Ressource (Constrained Application Protocol) mithilfe der OT CLI testen.

Parameter

coap post address uri-path [type] [payload]
  • address: IPv6-Adresse des CoAP-Servers.
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
    • block-: Verwenden Sie diese Option, gefolgt vom blockbasierten Wert, um Blöcke mit einer zufällig generierten Anzahl von Byte für die Nutzlast zu senden. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.
  • payload: CoAP-Nutzlastanfrage, die je nach type entweder ein String oder eine Ganzzahl ist. Wenn type den Wert con oder non-con hat, ist der Parameter payload optional. Wenn Sie den Parameter payload weglassen, wird eine leere Nutzlast gesendet. Wenn Sie den Parameter payload verwenden, muss sein Wert jedoch ein String wie hellothere sein. Wenn type den Wert block- hat, muss der Wert des Parameters payload eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typ block- muss OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE festgelegt werden.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coap Put

Ändert die angegebene CoAP-Ressource. Weitere Informationen finden Sie unter Konnektivität mit einer CoAP-Ressource (Constrained Application Protocol) mithilfe der OT CLI testen.

Parameter

coap put address uri-path [type] [payload]
  • address: IPv6-Adresse des CoAP-Servers.
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
    • block-: Verwenden Sie diese Option, gefolgt vom blockbasierten Wert, um Blöcke mit einer zufällig generierten Anzahl von Byte für die Nutzlast zu senden. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.
  • payload: CoAP-Nutzlastanfrage, die je nach type entweder ein String oder eine Ganzzahl ist. Wenn type den Wert con oder non-con hat, ist der Parameter payload optional. Wenn Sie den Parameter payload weglassen, wird eine leere Nutzlast gesendet. Wenn Sie den Parameter payload verwenden, muss sein Wert jedoch ein String wie hellothere sein. Wenn type den Wert block- hat, muss der Wert des Parameters payload eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typ block- muss OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE festgelegt werden.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coap-Ressource (get,set)

Ruft den URI-Pfad der CoAP-Serverressource ab oder legt ihn fest.

Parameter

coap resource [uri-path]

Beispiele

coap resource test-resource
Done
coap resource
test-resource
Done

Befehlszeilen- und API-Referenzen

Coap Set

Legt den von der Ressource auf den CoAP-Server gesendeten Inhalt fest. Wenn ein CoAP-Client die Ressource beobachtet, wird eine Benachrichtigung an diesen Client gesendet.

Parameter

coap set new-content

Beispiele

coap set Testing123
Done

Befehlszeilen- und API-Referenzen

Coap-Start

Startet den CoAP-Server. Weitere Informationen finden Sie unter Konnektivität mit einer CoAP-Ressource (Constrained Application Protocol) mithilfe der OT CLI testen.

Parameter

Keine Parameter.

Beispiele

coap start
Done

Befehlszeilen- und API-Referenzen

Coap Stop

Stoppt den CoAP-Server.

Parameter

Keine Parameter.

Beispiele

coap stop
Done

Befehlszeilen- und API-Referenzen

Coaps Connect

Initialisiert eine DTLS-Sitzung (Datagram Transport Layer Security) mit einem Peer. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

coaps connect address

Der Parameter address ist die IPv6-Adresse des Peers.

Beispiele

coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected

Befehlszeilen- und API-Referenzen

coaps löschen

Der zu löschende CoAPS-Nutzlaststring.

Parameter

coaps delete uri-path [type] [payload]
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
  • payload: CoAPS-Nutzlastanfrage.

Beispiele

coaps delete test-resource con hellothere
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coaps trennen

Beendet die DTLS-Sitzung.

Parameter

Keine Parameter.

Beispiele

coaps disconnect
coaps disconnected
Done

Befehlszeilen- und API-Referenzen

Coaps bekommen

Ruft Informationen zur angegebenen CoAPS-Ressource auf dem CoAPS-Server ab. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

coaps get uri-path [type]
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
    • block-: Verwenden Sie diese Option, gefolgt vom blockorientierten Wert, wenn die Antwort blockweise übertragen werden soll. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.

Beispiele

coaps get test-resource
Done
coaps get test-resource block-1024
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coaps isclosed

Gibt an, ob der CoAP Secure-Dienst geschlossen ist. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

Keine Parameter.

Beispiele

coaps isclosed
no
Done

Befehlszeilen- und API-Referenzen

Coaps isconnactive

Gibt an, ob die CoAP Secure-Dienstverbindung aktiv ist (entweder bereits verbunden oder gerade beim Herstellen einer Verbindung). Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

Keine Parameter.

Beispiele

coaps isconnactive
yes
Done

Befehlszeilen- und API-Referenzen

coaps ist verbunden

Gibt an, ob der CoAP Secure-Dienst verbunden ist. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

Keine Parameter.

Beispiele

coaps isconnected
yes
Done

Befehlszeilen- und API-Referenzen

Coaps Post

Erstellt die angegebene CoAPS-Ressource. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

uri-path [type] [payload]
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
    • block-: Verwenden Sie diese Option, gefolgt vom blockbasierten Wert, um Blöcke mit einer zufällig generierten Anzahl von Byte für die Nutzlast zu senden. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.
  • payload: CoAPS-Nutzlastanfrage, die je nach type entweder ein String oder eine Ganzzahl ist. Wenn type den Wert con oder non-con hat, ist der Nutzlastparameter optional. Wenn Sie den Nutzlastparameter weglassen, wird eine leere Nutzlast gesendet. Wenn Sie den Nutzlastparameter verwenden, muss sein Wert jedoch ein String wie hellothere sein. Wenn type den Wert block- hat, muss der Wert des Nutzlastparameters eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typ block- muss OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE festgelegt werden.

Beispiele

coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coaps PSK

Legt den vorinstallierten Schlüssel (PSK) und die Cipher Suite DTLS_PSK_WITH_AES_128_CCM_8 fest.

Parameter

coaps psk psk-value psk-id
  • psk-value: der vorinstallierte Schlüssel
  • psk-id: Die vorinstallierte Schlüssel-ID.

Beispiele

coaps psk 1234 key1
Done

Befehlszeilen- und API-Referenzen

Coaps setzen

Ändert die angegebene CoAPS-Ressource. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

uri-path [type] [payload]
  • uri-path: URI-Pfad der Ressource.
  • type:
    • con: Bestätigt
    • non-con: Nicht bestätigt (Standardeinstellung)
    • block-: Verwenden Sie diese Option, gefolgt vom blockbasierten Wert, um Blöcke mit einer zufällig generierten Anzahl von Byte für die Nutzlast zu senden. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.
  • payload: CoAPS-Nutzlastanfrage, die je nach type entweder ein String oder eine Ganzzahl ist. Wenn type den Wert con oder non-con hat, ist der Nutzlastparameter optional. Wenn Sie den Nutzlastparameter weglassen, wird eine leere Nutzlast gesendet. Wenn Sie den Nutzlastparameter verwenden, muss sein Wert jedoch ein String wie hellothere sein. Wenn type den Wert block- hat, muss der Wert des Nutzlastparameters eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typ block- muss OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE festgelegt werden.

Beispiele

coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coaps-Ressource (get,set)

Ruft den URI-Pfad der CoAPS-Serverressource ab oder legt ihn fest. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

coaps resource [uri-path]

Beispiele

coaps resource test-resource
Done
coaps resource
test-resource
Done

Befehlszeilen- und API-Referenzen

coaps einrichten

Legt den von der Ressource auf dem CoAPS-Server gesendeten Inhalt fest. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

coaps set new-content

Beispiele

coaps set Testing123
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Coaps starten

Startet den CoAP Secure-Dienst. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

coaps start [check-peer-cert | max-conn-attempts]

Der Parameter check-peer-cert bestimmt, ob die Peer-Zertifikatsprüfung aktiviert (Standard) oder deaktiviert ist. Der Parameter max-conn-attempts legt die maximale Anzahl der zulässigen Versuche, ob erfolgreich oder fehlgeschlagen, für die Verbindung zum CoAP Secure-Server fest. Der Standardwert dieses Parameters ist 0. Das bedeutet, dass die Anzahl der Versuche nicht begrenzt ist. Die Parameter check-peer-cert und max-conn-attempts funktionieren in den folgenden Kombinationen, obwohl Sie nur ein Argument angeben können:

  • Kein Argument angegeben: Es werden Standardeinstellungen verwendet.
  • Das Festlegen von check-peer-cert auf true hat denselben Effekt wie das Weglassen des Arguments, nämlich dass der Wert von check-peer-cert true und der Wert max-conn-attempts 0 ist.
  • check-peer-cert wird auf false festgelegt: Der check-peer-cert-Wert ist false und der max-conn-attempts-Wert ist 0.
  • Angabe einer Zahl: check-peer-cert ist true und der Wert max-conn-attempts ist die im Argument angegebene Zahl.

Beispiele

coaps start
Done
coaps start false
Done
coaps start 8
Done

Befehlszeilen- und API-Referenzen

Coaps stopp

Beendet den CoAP Secure-Dienst. Weitere Informationen finden Sie unter Konnektivität mit einer CoAPS-Ressource (Eingeschränkte Application Protocol Secure) mithilfe der OT CLI testen.

Parameter

Keine Parameter.

Beispiele

coaps stop
Done

Befehlszeilen- und API-Referenzen

Coaps x509

Legt das X509-Zertifikat des lokalen Geräts mit dem entsprechenden privaten Schlüssel für die DTLS-Sitzung mit DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 fest.

Parameter

Keine Parameter.

Beispiele

coaps x509
Done

Befehlszeilen- und API-Referenzen

Mitteilung durch das Kommissar

Sendet eine Nachricht über den Beginn der Ansage.

Parameter

commissioner announce mask count period destination
  • mask: Bitmaske, die Kanäle zum Senden von MLE-Announce-Nachrichten identifiziert.
  • count: Anzahl der MLE-Announce-Übertragungen pro Kanal.
  • period: Anzahl der Millisekunden zwischen aufeinanderfolgenden MLE-Announce-Übertragungen.
  • destination: IPv6-Zieladresse für die Nachricht. Die Nachricht kann eine Multicast-Nachricht sein.

Beispiele

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

Befehlszeilen- und API-Referenzen

Beauftragte Energie

Sendet eine Nachricht zur Energiescan-Abfrage. Die Befehlsausgabe wird beim Empfang gedruckt.

Parameter

commissioner energy mask count period scanDuration destination
  • mask: Bitmaske, die Kanäle zum Ausführen von IEEE 802.15.4-Energiescans identifiziert.
  • count: Anzahl der IEEE 802.15.4-Energiescans pro Kanal.
  • period: Anzahl der Millisekunden zwischen aufeinanderfolgenden IEEE 802.15.4-Energiescans.
  • scanDuration: Scandauer in Millisekunden, die beim Ausführen eines IEEE 802.15.4-Energiescans verwendet werden soll.
  • destination: IPv6-Zieladresse für die Nachricht. Die Nachricht kann eine Multicast-Nachricht sein.

Beispiele

commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0

Befehlszeilen- und API-Referenzen

Provisioner-ID (get,set)

Ruft den OpenThread-Provisions-ID-Namen ab oder legt ihn fest.

Parameter

commissioner id name

Beispiele

commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done

Befehlszeilen- und API-Referenzen

Auftraggeber hinzufügen

Fügt einen Joiner-Eintrag hinzu.

Parameter

commissioner joiner add eui64|discerner pksd [timeout]
  • eui64: IEEE EUI-64 des Joiners. Verwenden Sie *, um einen beliebigen JOIN zu abgleichen.
  • discerner: Die Joiner-Erkennung im Format number/length.
  • pksd: Vorinstallierter Schlüssel für den Joiner.
  • timeout: Das Zeitlimit für Joiner in Sekunden.

Beispiele

commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done

Befehlszeilen- und API-Referenzen

Beauftragter Mitarbeiter entfernen

Entfernt einen Joiner-Eintrag.

Parameter

commissioner joiner remove eui64|discerner
  • eui64: IEEE EUI-64 des Joins. Verwenden Sie *, um einen beliebigen JOIN zu abgleichen.
  • discerner: Die Joiner-Erkennung im Format number/length.

Beispiele

commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done

Befehlszeilen- und API-Referenzen

Tabelle „Provisioner Joiner“

Listet alle Joiner-Einträge im Tabellenformat auf.

Parameter

Keine Parameter.

Beispiele

commissioner joiner table
| ID                    | PSKd                             | Expiration |
+-----------------------+----------------------------------+------------+
|                     * |                           J01NME |      81015 |
|      d45e64fa83f81cf7 |                           J01NME |     101204 |
| 0x0000000000000abc/12 |                           J01NME |     114360 |
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Auftragsverwaltung

Sendet eine MGMT_GET-Nachricht (Management Get) an den Leader. Variablenwerte, die mit dem Befehl commissioner mgmtset festgelegt wurden, werden zurückgegeben.

Parameter

commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
  • locator: Border Router RLOC16.
  • sessionid: Sitzungs-ID des Beauftragten.
  • steeringdata: Daten zur Steuerung.
  • joinerudpport: Joiner-UDP-Port.
  • TLVs: Der Satz der abzurufenden TLVs.

Beispiele

commissioner mgmtget locator sessionid
Done

Befehlszeilen- und API-Referenzen

Auftragsverwaltungsset

Sendet eine MGMT_SET-Nachricht (Management Set) an den Leader und legt die Variablen auf die angegebenen Werte fest.

Parameter

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
  • locator: Border Router RLOC16.
  • sessionid: Sitzungs-ID des Beauftragten.
  • steeringdata: Daten zur Steuerung.
  • joinerudpport: Joiner-UDP-Port.
  • TLVs: Der Satz der abzurufenden TLVs.

Beispiele

commissioner mgmtset joinerudpport 9988
Done

Befehlszeilen- und API-Referenzen

Commissioner Panid

Sendet eine PAN-ID-Abfrage. Die Befehlsausgabe wird beim Empfang zurückgegeben.

Parameter

commissioner panid panid mask destination
  • paind: PAN-ID zur Überprüfung auf Konflikte.
  • mask; Bitmaske, die Kanäle für aktive IEEE 802.15.4-Scans identifiziert.
  • destination: IPv6-Zieladresse für die Nachricht. Die Nachricht kann eine Multicast-Nachricht sein.

Beispiele

commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800

Befehlszeilen- und API-Referenzen

Bereitstellungs-URL für Provisioner

Legt die Bereitstellungs-URL für den Beauftragten fest.

Parameter

commissioner provisioningurl provisioningurl

Beispiele

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

Befehlszeilen- und API-Referenzen

Provisioner-Sitzungs-ID

Ruft die aktuelle Sitzungs-ID des Kommissars ab.

Parameter

Keine Parameter.

Beispiele

commissioner sessionid
0
Done

Befehlszeilen- und API-Referenzen

Auftragsbeginn

Startet die Rolle „Thread Commissioner“.

Parameter

Keine Parameter.

Beispiele

commissioner start
Commissioner: petitioning
Done
Commissioner: active

Befehlszeilen- und API-Referenzen

Kommissarstatus

Gibt den aktuellen Status des Commissioners zurück. Mögliche Werte sind active, disabled oder petition (Petition, Kommissionsmitglied zu werden).

Parameter

Keine Parameter.

Beispiele

commissioner state
active
Done

Befehlszeilen- und API-Referenzen

Provisioner-Stopp

Beendet die Rolle „Thread Commissioner“.

Parameter

Keine Parameter.

Beispiele

commissioner stop
Done

Befehlszeilen- und API-Referenzen

contextreusedelay (get,set)

Ruft den CONTEXT_ID_REUSE_DELAY-Wert ab oder legt ihn fest.

Parameter

contextreusedelay delay

Verwenden Sie das optionale Argument delay, um CONTEXT_ID_REUSE_DELAY festzulegen.

Beispiele

contextreusedelay
11
Done
contextreusedelay 11
Done

Befehlszeilen- und API-Referenzen

Zähler (Mac)

Rufen Sie die MAC-Ebenenzähler ab.

Parameter

counters mac

Beispiele

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

Befehlszeilen- und API-Referenzen

Zähler (mle)

Ruft die MLE-Zähler für Thread ab.

Parameter

counters mle

Beispiele

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

Befehlszeilen- und API-Referenzen

Zähler

Ruft die unterstützten Zählernamen ab.

Parameter

Keine Parameter.

Beispiele

counters
ip
mac
mle
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Zähler-IP

Ruft die IPv6-Zähler ab.

Parameter

counters ip

Beispiele

counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done

Befehlszeilen- und API-Referenzen

Zähler-IP zurücksetzen

Setzt die IPv6-Zähler zurück.

Parameter

counters ip reset

Beispiele

counters ip reset
Done

Befehlszeilen- und API-Referenzen

Zähler Mac zurücksetzen

Setzt die MAC-Ebenenzähler zurück.

Parameter

counters mac reset

Beispiele

counters mac reset
Done

Befehlszeilen- und API-Referenzen

Zähler Mle zurücksetzen

Setzt die Thread-MLE-Zähler zurück.

Parameter

counters mle reset

Beispiele

counters mle reset
Done

Befehlszeilen- und API-Referenzen

CSS-Kanal

Legt den CSL-Kanal fest.

Parameter

csl channel channel

Beispiele

csl channel 20
Done

Befehlszeilen- und API-Referenzen

CSS

Ruft die CSL-Konfiguration ab.

Parameter

Keine Parameter.

Beispiele

csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done

Befehlszeilen- und API-Referenzen

CSS-Periode

Legt den CSL-Zeitraum in Mikrosekunden fest.

Deaktivieren Sie CSL, indem Sie diesen Parameter auf 0 setzen.

Der CSL-Zeitraum MUSS ein Vielfaches von OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC sein, andernfalls wird OT_ERROR_INVALID_ARGS zurückgegeben.

Parameter

csl period period

Beispiele

csl period 3000000
Done

Befehlszeilen- und API-Referenzen

CSS-Zeitlimit

Legt das CSL-Zeitlimit in Sekunden fest.

Parameter

csl timeout timeout

Beispiele

cls timeout 10
Done

Befehlszeilen- und API-Referenzen

Dataset aktiv

Ruft das aktive operative Dataset ab.

Die OT-Befehlszeile verwendet otOperationalDataset-Mitglieder, um Dataset-Werte an die Konsole zurückzugeben.

Parameter

dataset active [-x]

Das optionale Argument -x gibt die Werte des aktiven operativen Datasets als hex-codierte TLVs aus.

Beispiele

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

Befehlszeilen- und API-Referenzen

Activetimestamp des Datasets (get, set)

Ruft otOperationalDataset::mActiveTimestamp ab oder legt diese fest.

Parameter

dataset activetimestamp [timestamp]

Übergeben Sie das optionale Argument timestamp, um den aktiven Zeitstempel festzulegen.

Beispiele

dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Channel (get,set)

Ruft otOperationalDataset::mChannel ab oder legt diese fest.

Parameter

dataset channel [channel-num]

Verwenden Sie das optionale Argument channel-num, um den Kanal festzulegen.

Beispiele

dataset channel
12
Done
dataset channel 12
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Kanalmaske (get,set)

Ruft otOperationalDataset::mChannelMask ab oder legt diese fest.

Parameter

dataset channelmask [channel-mask]

Verwenden Sie das optionale Argument channel-mask, um die Kanalmaske festzulegen.

Beispiele

dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset löschen

Setzen Sie den Zwischenspeicher des operativen Datasets zurück.

Parameter

Keine Parameter.

Beispiele

dataset clear
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Commit aktiv

Führen Sie einen Commit für den Zwischenspeicher des operativen Datasets in ein aktives operatives Dataset durch.

Parameter

Keine Parameter.

Beispiele

dataset commit active
Done

Befehlszeilen- und API-Referenzen

Dataset-Commit ausstehend

Führen Sie für den Zwischenspeicher des operativen Datasets ein Commit auf ein ausstehendes operatives Dataset durch.

Parameter

Keine Parameter.

Beispiele

dataset commit pending
Done

Befehlszeilen- und API-Referenzen

Dataset-Verzögerung (get,set)

Ruft otOperationalDataset::mDelay ab oder legt diese fest.

Parameter

dataset delay [delay]

Verwenden Sie das optionale Argument delay, um den Wert des Timers für die Verzögerung festzulegen.

Beispiele

dataset delay
1000
Done
dataset delay 1000
Done

Befehlszeilen- und API-Referenzen

Dataset-extpanid (get,set)

Ruft otOperationalDataset::mExtendedPanId ab oder legt diese fest.

Parameter

dataset extpanid [extpanid]

Verwende das optionale Argument extpanid, um die Extended Personal Area Network-ID festzulegen.

Beispiele

dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done

Befehlszeilen- und API-Referenzen

Hilfe zum Dataset

Ruft eine Liste von dataset-Befehlszeilenbefehlen ab. Weitere Informationen finden Sie unter Datasets mit OT-CLI anzeigen und verwalten.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset init (active,new,pending,tlvs)

Die OT-Befehlszeile sucht nach active, pending oder tlvs und gibt die entsprechenden Werte zurück. Andernfalls erstellt die OT-Befehlszeile ein neues, zufälliges Netzwerk und gibt ein neues Dataset zurück.

Parameter

dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]

Verwenden Sie new, um ein neues Dataset zu initialisieren, und geben Sie dann den Befehl dataset commit active ein. Verwenden Sie tlvs für hexadezimal codierte TLVs.

Beispiele

dataset init new
Done

Befehlszeilen- und API-Referenzen

Dataset Meshlocalprefix (get,set)

Ruft otOperationalDataset::mMeshLocalPräfix ab oder legt diese fest.

Parameter

dataset meshlocalprefix [meshlocalprefix]

Verwenden Sie das optionale Argument meshlocalprefix, um das Mesh-Local-Präfix festzulegen.

Beispiele

dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Mgmtgetcommand aktiv

Sendet MGMT_ACTIVE_GET.

Die OT-Befehlszeile sendet einen MGMT_ACTIVE_GET mit den entsprechenden Argumenten. Weitere Informationen zu diesen Parametern und Argumentzuordnungen finden Sie unter Datasets mit OT-Befehlszeile anzeigen und verwalten.

Parameter

dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
  • Verwenden Sie address, um das IPv6-Ziel anzugeben. Andernfalls wird standardmäßig der Leader-ALOC verwendet.
  • Für dataset-components können Sie eine beliebige Kombination von otOperationalDatasetComponents übergeben, z. B. activetimestamp, pendingtimestamp oder networkkey.
  • Das optionale Argument -x gibt Roh-TLVs an, die angefordert werden sollen.

Beispiele

dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done

Befehlszeilen- und API-Referenzen

Befehl mgmtget ausstehend

Sendet MGMT_PENDING_GET.

Parameter

dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]

Weitere Informationen zu diesen Parametern und Argumentzuordnungen finden Sie unter Datasets mit OT-Befehlszeile anzeigen und verwalten.

Beispiele

dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done

Befehlszeilen- und API-Referenzen

Dataset-Verwaltungsbefehl aktiv

Sendet MGMT_ACTIVE_SET.

Parameter

dataset mgmtsetcommand active [dataset-components] [-x tlv-list]

Weitere Informationen zu diesen Parametern und Argumentzuordnungen finden Sie unter Datasets mit OT-Befehlszeile anzeigen und verwalten.

Beispiele

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

Befehlszeilen- und API-Referenzen

Befehl mgmtset ausstehend

Sendet MGMT_PENDING_SET.

Parameter

dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]

Weitere Informationen zu diesen Parametern und Argumentzuordnungen finden Sie unter Datasets mit OT-Befehlszeile anzeigen und verwalten.

Beispiele

dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done

Befehlszeilen- und API-Referenzen

Dataset networkkey (get,set)

Ruft otOperationalDataset::mNetworkKey ab oder legt diese fest.

Parameter

dataset networkkey [key]

Verwenden Sie das optionale Argument key, um den Netzwerkschlüssel festzulegen.

Beispiele

dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Netzwerkname (get,set)

Ruft otOperationalDataset::mNetworkName ab oder legt diese fest.

Parameter

dataset networkname [name]

Verwenden Sie das optionale Argument name, um den Netzwerknamen festzulegen.

Beispiele

dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done

Befehlszeilen- und API-Referenzen

Dataset-Panid (get,set)

Ruft otOperationalDataset::mPanId ab oder legt diese fest.

Parameter

dataset panid [panid]

Verwende das optionale Argument panid, um die PAN-ID festzulegen.

Beispiele

dataset panid
0x1234
Done
dataset panid 0x1234
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset pendingtimestamp (get,set)

Ruft otOperationalDataset::mPendingTimestamp ab oder legt diese fest.

Parameter

dataset pendingtimestamp [timestamp]

Verwenden Sie das optionale Argument timestamp, um die Sekunden des Zeitstempels für die ausstehende Ausführung festzulegen.

Beispiele

dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-pskc (get,set)

Ruft otOperationalDataset::mPskc ab oder legt diese fest.

Parameter

dataset pskc [-p passphrase] | [key]

Verwenden Sie -p nur für FTD mit dem Argument passphrase. -p generiert aus der von dir angegebenen UTF-8-codierten passphrase eine PSKC-Datei sowie den Netzwerknamen und die erweiterte PAN-ID. Wenn festgelegt, verwendet -p den Dataset-Zwischenspeicher. Andernfalls wird der aktuelle Stack verwendet. Alternativ können Sie „pskc“ als key (Hexadezimalformat) festlegen.

Beispiele

dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Sicherheitsrichtlinie (get,set)

Ruft die Dataset-Sicherheitsrichtlinie ab oder legt sie fest.

Parameter

dataset securitypolicy [rotationtime [onrcCepR]]

Beispiele

dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Dataset-Gruppe (aktiv,ausstehend)

Legt das aktive operative Dataset fest.

Wenn das Dataset keinen aktiven Zeitstempel enthält, ist es nur teilweise vollständig.

Wenn Thread auf einem Gerät mit einem teilweise vollständigen aktiven Dataset aktiviert ist, versucht das Gerät, mithilfe der im Dataset vorhandenen Informationen eine Verbindung zu einem vorhandenen Thread-Netzwerk herzustellen. Zum Anhängen an ein Netzwerk ist nur der Thread-Netzwerkschlüssel erforderlich.

Wenn der Kanal nicht im Dataset enthalten ist, sendet das Gerät MLE-Nachrichten über verschiedene Kanäle an, um Nachbarn auf anderen Kanälen zu finden.

Wenn das Gerät erfolgreich mit einem Thread-Netzwerk verbunden wurde, ruft es das vollständige aktive Dataset von seinem übergeordneten Dataset ab. Hinweis: Ein Router-fähiges Gerät wechselt erst dann in die Rolle „Router“ oder „Leader“, wenn ein vollständiges aktives Dataset vorhanden ist.

Der Befehl dataset set der Befehlszeile legt das aktive operative Dataset mit hexadezimal codierten TLVs fest.

Parameter

dataset set {active|pending} tlvs

Beispiele

dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

Befehlszeilen- und API-Referenzen

Dataset-TLS-Dateien

Wandelt ein bestimmtes operatives Dataset in otOperationalDatasetTlvs um.

Parameter

Keine Parameter.

Beispiele

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

Befehlszeilen- und API-Referenzen

Dataset-Updater abbrechen

Bricht eine laufende Anfrage zur Aktualisierung eines operativen Datasets ab.

Verfügbar, wenn OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

@dataset updater cancel
Done

Befehlszeilen- und API-Referenzen

Dataset-Updater

Gibt an, ob eine Anfrage zum Aktualisieren des Vorgangs-Datasets vorhanden ist.

Verfügbar, wenn OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

dataset updater
Enabled
Done

Befehlszeilen- und API-Referenzen

Start des Dataset-Updaters

Fordert eine Aktualisierung des operativen Datasets an.

Verfügbar, wenn OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE aktiviert ist.

aDataset muss die zu aktualisierenden Felder und deren neuen Wert enthalten. Er darf keine Zeitstempelfelder für aktive oder ausstehende Zeitstempel enthalten. Das Feld „Delay“ ist optional. Wenn es nicht angegeben ist, wird ein Standardwert (1.000 ms) verwendet.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

debug

Führt eine Reihe von CLI-Befehlen aus, um Informationen über das Gerät und das Thread-Netzwerk zu erfassen. Dies dient der Fehlerbehebung. In der Ausgabe wird jeder ausgeführte CLI-Befehl mit vorangestelltem $ angezeigt, gefolgt von der generierten Ausgabe des entsprechenden Befehls. Die generierte Ausgabe umfasst die folgenden Informationen:

  • Version
  • Aktueller Status
  • RLOC16, erweiterte MAC-Adresse
  • Unicast- und Multicast-IPv6-Adressenliste
  • Kanal
  • PAN-ID und erweiterte PAN-ID
  • Netzwerkdaten
  • Partitions-ID
  • Leader-Daten

Wenn das Gerät als FTD arbeitet:

  • Untergeordnete und benachbarte Tabelle
  • Routertabelle und Informationen zum nächsten Hop
  • Adressen-Cache-Tabelle
  • Registrierte untergeordnete MTD-IPv6-Adresse
  • Geräteeigenschaften

Wenn das Gerät SRP-Client unterstützt und als dieser fungiert:

  • SRP-Clientstatus
  • SRP-Clientdienste und Hostinformationen

Wenn das Gerät SRP-Server unterstützt und als Server fungiert:

  • SRP-Serverstatus und Adressmodus
  • Vom SRP-Server registrierte Hosts und Dienste

Wenn das Gerät TREL unterstützt:

  • TREL-Status und Vergleichstabelle

Wenn das Gerät Border-Router unterstützt und als solche dient:

  • AF-Status
  • BR-Präfixe (OMR, On-Link, NAT64)
  • Erkannte Präfixtabelle

Parameter

Keine Parameter.

Beispiele

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Verzögerungszeitrmin (festgelegt)

Legt den Timer für die minimale Verzögerung in Sekunden fest.

Parameter

delaytimermin delaytimermin

Beispiele

delaytimermin 60
Done

Befehlszeilen- und API-Referenzen

Verzögerungszeitrmin

Ruft den Timer für die minimale Verzögerung in Sekunden ab.

Parameter

Keine Parameter.

Beispiele

delaytimermin
30
Done

Befehlszeilen- und API-Referenzen

detach async

Starten Sie den ordnungsgemäßen Trennvorgang ähnlich wie mit dem Befehl detach, ohne auf den Callback zu warten, dass der Trennvorgang abgeschlossen ist.

Parameter

Keine Parameter.

Beispiele

detach async
Done

Befehlszeilen- und API-Referenzen

detach

Starten Sie den Prozess des ordnungsgemäßen Trennens, indem Sie zuerst andere Knoten benachrichtigen (wenn sie als Router fungieren, senden Sie den Adressrelease oder setzen Sie den Wert für das Zeitlimit für untergeordnete Elemente für den übergeordneten Knoten auf null, wenn Sie als untergeordnetes Element agieren), und beenden Sie dann den Thread-Protokollvorgang.

Parameter

Keine Parameter.

Beispiele

detach
Finished detaching
Done

Befehlszeilen- und API-Referenzen

deviceprops (festgelegt)

Legt die Geräteeigenschaften fest.

Parameter

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

powerSupply: sollte „battery“, „external“, „external-stable“, „external-unstable“ sein.

Beispiele

deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply      : battery
IsBorderRouter   : no
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : -5
Done

Befehlszeilen- und API-Referenzen

Deviceprops

Aktuelle Geräteeigenschaften abrufen.

Erfordert OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

discover

Führe eine MLE-Erkennung durch.

Parameter

discover [channel]

channel: Der Kanal, auf dem du mehr entdecken möchtest. Wenn kein Kanal angegeben ist, deckt die Erkennung alle gültigen Kanäle ab.

Beispiele

discover
| J | Network Name     | Extended PAN     | PAN  | MAC Address      | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread       | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

Befehlszeilen- und API-Referenzen

reqcallback erkennen (aktivieren,deaktivieren)

Legt einen Callback für den Empfang von MLE-Discovery-Anfragedaten fest.

Parameter

discover reqcallback enable|disable

Beispiele

discover reqcallback enable
Done

Befehlszeilen- und API-Referenzen

DNS-Browsen

Durchsuchen (Dienstinstanzenumeration)-DNS-Abfrage, um die Liste der Dienste für einen bestimmten Dienstnamen abzurufen

Die Parameter nach service-name sind optional. Jeder nicht angegebene oder Nullwert für diese optionalen Parameter wird durch den Wert aus der aktuellen Standardkonfiguration (dns config) ersetzt.

Parameter

dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Beispiele

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

Befehlszeilen- und API-Referenzen

DNS-Komprimierung (aktivieren,deaktivieren)

Legen Sie den Modus „DNS-Namenskomprimierung“ fest.

Die Komprimierung des DNS-Namens ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, werden DNS-Namen vollständig und nie komprimiert angehängt. Dies gilt für die DNS- und SRP-Client-/Servermodule von OpenThread.“ Das Feld „OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE“ darf nicht leer sein.

Parameter

dns compression [enable|disable]

Beispiele

dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done

Befehlszeilen- und API-Referenzen

DNS-Komprimierung

Gibt an, ob der Modus „DNS-Namenskomprimierung“ aktiviert ist oder nicht.

Dies ist nur für Testzwecke vorgesehen und verfügbar, wenn die OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE-Konfiguration aktiviert ist.

Die Komprimierung des DNS-Namens ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, werden DNS-Namen vollständig und nie komprimiert angehängt. Dies gilt für die DNS- und SRP-Client-/Servermodule von OpenThread.“ Das Feld „OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE“ darf nicht leer sein.

Parameter

dns compression [enable|disable]

Beispiele

dns compression
Enabled

Befehlszeilen- und API-Referenzen

DNS-Konfiguration (festgelegt)

Legt die Standardabfragekonfiguration für den DNS-Client fest.

In einem nicht auf NULL gesetzten aConfig kann der Aufrufer festlegen, dass einige Felder in der otDnsQueryConfig -Instanz nicht angegeben sind (Wert 0). Die nicht angegebenen Felder werden durch die Definitionen der entsprechenden OT-Konfigurationsoptionen (OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}) ersetzt, um die Standardabfragekonfiguration zu bilden.

Wenn OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE aktiviert ist, wird die IPv6-Adresse des Servers in der Standardkonfiguration automatisch festgelegt und vom DNS-Client aktualisiert. Dies geschieht nur, wenn der Nutzer sie nicht explizit festlegt oder angibt. Für dieses Verhalten müssen der SRP-Client und die Autostart-Funktion aktiviert sein. Der SRP-Client überwacht dann die Thread-Netzwerkdaten auf DNS-/SRP-Diensteinträge, um einen SRP-Server auszuwählen. Die ausgewählte SRP-Serveradresse wird in der Standardkonfiguration auch als DNS-Serveradresse festgelegt.

Wir können einige Felder als nicht angegeben belassen oder den Wert null verwenden. Die nicht angegebenen Felder werden durch die Definitionen der entsprechenden OT-Konfigurationsoptionen (OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT) ersetzt, um die Standardabfragekonfiguration zu bilden. OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE ist erforderlich.

Parameter

dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode]

Beispiele

dns config fd00::1 1234 5000 2 0
Done
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 3000 ms
MaxTxAttempts: 3
RecursionDesired: yes
Done

Befehlszeilen- und API-Referenzen

DNS-Konfiguration

Ruft die aktuelle Standardabfragekonfiguration ab, die vom DNS-Client verwendet wird.

Beim Start des OpenThread-Stacks wird die Standardkonfiguration für DNS-Abfragen aus einer Reihe von OT-Konfigurationsoptionen wie OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS, _DEFAULT_SERVER_PORT, _DEFAULT_RESPONSE_TIMEOUT usw. bestimmt (siehe config/dns_client.h für alle zugehörigen Konfigurationsoptionen).

Die Konfiguration enthält die IPv6-Adresse und den Port des Servers, das Antwortzeitlimit in ms (Wartezeit auf RX-Antwort), die maximale Anzahl von tx-Versuchen vor dem Berichterstellungsfehler sowie ein boolesches Flag, das angibt, ob der Server die Anfrage rekursiv lösen kann. Das Feld „OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE“ darf nicht leer sein.

Parameter

Keine Parameter.

Beispiele

dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done

Befehlszeilen- und API-Referenzen

DNS-Auflösung

Sendet eine DNS-Abfrage zur Adressauflösung nach AAAA-Einträgen (IPv6) für einen bestimmten Hostnamen.

aConfig kann NULL sein. In diesem Fall wird die Standardkonfiguration (aus otDnsClientGetDefaultConfig() ) als Konfiguration für diese Abfrage verwendet. In einem aConfig-Objekt, das nicht NULL ist, dürfen einige Felder nicht angegeben werden (Wert 0). Die nicht angegebenen Felder werden dann durch die Werte aus der Standardkonfiguration ersetzt.

DNS-Abfrage senden, um die IPv6-Adresse für den angegebenen Hostnamen abzurufen.

Die Parameter nach dem Hostnamen sind optional. Jeder nicht angegebene (oder Null) Wert für diese optionalen Parameter wird durch den Wert aus der aktuellen Standardkonfiguration (DNS-Konfiguration) ersetzt.

Die IP-Adresse des DNS-Servers kann eine IPv4-Adresse sein, die unter Verwendung des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird.

Parameter

dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Beispiele

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

Befehlszeilen- und API-Referenzen

DNS-Dienst

Startet die Auflösung einer DNS-Dienstinstanz für eine bestimmte Dienstinstanz.

Ist verfügbar, wenn OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE aktiviert ist.

aConfig kann NULL sein. In diesem Fall wird die Standardkonfiguration (aus otDnsClientGetDefaultConfig() ) als Konfiguration für diese Abfrage verwendet. In einem aConfig-Objekt, das nicht NULL ist, dürfen einige Felder nicht angegeben werden (Wert 0). Die nicht angegebenen Felder werden dann durch die Werte aus der Standardkonfiguration ersetzt.

Die Funktion sendet Abfragen nach SRV- und/oder TXT-Einträgen für die angegebene Dienstinstanz. Mit dem Feld mServiceMode in otDnsQueryConfig wird festgelegt, welche Datensätze abgefragt werden sollen (nur SRV, nur TXT oder sowohl SRV als auch TXT) und wie die Abfrage durchgeführt wird (zusammen in derselben Nachricht, separat parallel oder im optimierten Modus, in dem der Client zuerst versucht, dieselbe Nachricht zu senden, und dann separat, wenn keine Antwort erfolgt).

Der SRV-Eintrag enthält Informationen über den Dienstport, die Priorität und die Gewichtung sowie den Hostnamen, der der Dienstinstanz zugeordnet ist. Diese Funktion führt NICHT eine Adressauflösung für den Hostnamen durch, der aus dem SRV-Eintrag erkannt wurde. Der Server/Resolver kann im Abschnitt „Zusätzliche Daten“ der Antwort auf die SRV-/TXT-Anfrage AAAA/A-Einträge für den Hostnamen angeben. Diese Informationen können mit otDnsServiceResponseGetServiceInfo() in otDnsServiceCallback abgerufen werden. Nutzer dieser API DÜRFEN NICHT davon ausgehen, dass die Hostadresse immer über otDnsServiceResponseGetServiceInfo() verfügbar ist.

DNS-Abfrage zur Auflösung einer Dienstinstanz für eine bestimmte Dienstinstanz senden. Das Dienstinstanzlabel wird zuerst angegeben, gefolgt vom Dienstnamen. Beachten Sie, dass das Label der Dienstinstanz den Punkt „.“ enthalten kann.

Die Parameter nach service-name sind optional. Jeder nicht angegebene oder Nullwert für diese optionalen Parameter wird durch den Wert aus der aktuellen Standardkonfiguration (dns config) ersetzt.

Parameter

dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Beispiele

Befehlszeilen- und API-Referenzen

DNS-Diensthost

Startet die Auflösung einer DNS-Dienstinstanz für eine bestimmte Dienstinstanz mit einer potenziellen Auflösung der Folgeadresse für den Hostnamen, der für die Dienstinstanz erkannt wurde.

Ist verfügbar, wenn OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE aktiviert ist.

aConfig kann NULL sein. In diesem Fall wird die Standardkonfiguration (aus otDnsClientGetDefaultConfig() ) als Konfiguration für diese Abfrage verwendet. In einem aConfig-Objekt, das nicht NULL ist, dürfen einige Felder nicht angegeben werden (Wert 0). Die nicht angegebenen Felder werden dann durch die Werte aus der Standardkonfiguration ersetzt. Diese Funktion kann nicht verwendet werden, wenn mServiceMode in der DNS-Konfiguration auf OT_DNS_SERVICE_MODE_TXT festgelegt ist (d.h. nur der TXT-Eintrag abgefragt wird) und gibt OT_ERROR_INVALID_ARGS zurück.

Verhält sich ähnlich wie otDnsClientResolveService() , wenn Anfragen nach SRV- und TXT-Einträgen gesendet werden. Wenn der Server/Resolver jedoch in der Antwort auf die SRV-Anfrage keine AAAA/A-Einträge für den Hostnamen bereitstellt (im Abschnitt „Zusätzliche Daten“), wird der Hostnamen aufgelöst (durch Senden einer AAAA-Abfrage) für den im SRV-Eintrag ermittelten Hostnamen. Der Callback aCallback wird aufgerufen, wenn Antworten für alle Anfragen empfangen werden, d.h., sowohl die Dienst- als auch die Hostadresse abgeschlossen ist.

DNS-Abfrage zur Auflösung der Dienstinstanz für eine bestimmte Dienstinstanz mit potenzieller Auflösung des Hostnamens im Nachgang senden. Das Dienstinstanzlabel wird zuerst angegeben, gefolgt vom Dienstnamen. Beachten Sie, dass das Label der Dienstinstanz den Punkt „.“ enthalten kann.

Die Parameter nach service-name sind optional. Jeder nicht angegebene oder Nullwert für diese optionalen Parameter wird durch den Wert aus der aktuellen Standardkonfiguration (dns config) ersetzt.

Parameter

dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Beispiele

Befehlszeilen- und API-Referenzen

Domainname (festgelegt)

Legt den Thread-Domainnamen fest.

Funktioniert nur, wenn Thread-Protokolle deaktiviert sind.

Parameter

domainname name

Verwenden Sie backslash als Escapezeichen für Leerzeichen.

Beispiele

domainname Test\ Thread
Done

Befehlszeilen- und API-Referenzen

Domainname

Ruft den Thread-Domainnamen ab.

Parameter

Keine Parameter.

Beispiele

domainname
Thread
Done

Befehlszeilen- und API-Referenzen

Dua Iid (fest,löschen)

Legt die Schnittstellen-ID fest, die manuell für die Unicast-Adresse der Thread-Domain angegeben wurde, oder löscht sie.

Verfügbar, wenn OPENTHREAD_CONFIG_DUA_ENABLE aktiviert ist.

Parameter

dua iid iid|clear

dua iid clear übergibt nullptr an otThreadSetFixedDuaInterfaceIdentifier. Andernfalls können Sie die iid übergeben.

Beispiele

dua iid 0004000300020001
Done
dua iid clear
Done

Befehlszeilen- und API-Referenzen

Dua Iid

Ruft die Schnittstellen-ID ab, die manuell für die Unicast-Adresse der Thread-Domain angegeben wurde.

Verfügbar, wenn OPENTHREAD_CONFIG_DUA_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

dua iid
0004000300020001
Done

Befehlszeilen- und API-Referenzen

Eidcache

Gibt die EID-zu-RLOC-Cache-Einträge zurück.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

eui64

Ruft den werkseitig zugewiesenen IEEE EUI-64 für diese Schnittstelle ab.

Parameter

Keine Parameter.

Beispiele

eui64
0615aae900124b00
Done

Befehlszeilen- und API-Referenzen

Extaddr (fest)

Legt die erweiterte IEEE 802.15.4-Adresse fest.

Parameter

extaddr extaddr

Beispiele

extaddr dead00beef00cafe
dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

Extaddr

Ruft die erweiterte IEEE 802.15.4-Adresse ab.

Parameter

Keine Parameter.

Beispiele

extaddr
dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

extpanid (fest)

Legt die erweiterte IEEE 802.15.4-PAN-ID fest.

Parameter

extpanid extpanid

Beispiele

extpanid dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

Expanid

Ruft die erweiterte IEEE 802.15.4-PAN-ID ab.

Parameter

Keine Parameter.

Beispiele

extpanid
dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

Auf Werkseinstellungen zurücksetzen

Löscht alle Einstellungen, die im nichtflüchtigen Speicher gespeichert sind, und löst dann eine Plattformzurücksetzung aus.

Parameter

Keine Parameter.

Beispiele

factoryreset

Befehlszeilen- und API-Referenzen

fake (a,an)

Sendet gefälschte Thread-Nachrichten.

Verfügbar, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Parameter

fake /a/an dst-ipaddr target meshLocalIid

Beispiele

fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done

Befehlszeilen- und API-Referenzen

fem

Ruft externe FEM-Parameter ab.

Parameter

Keine Parameter.

Beispiele

fem
LNA gain 11 dBm
Done

Befehlszeilen- und API-Referenzen

Fem Lnagain (get)

Ruft den Rx-LNA-Verstärkung des externen FEM in dBm ab.

Parameter

Keine Parameter.

Beispiele

fem lnagain
11
Done

Befehlszeilen- und API-Referenzen

Fem Lnagain (fest)

Legt die Rx-LNA-Verstärkung der externen FEM in dBm fest.

Parameter

Keine Parameter.

Beispiele

fem lnagain 8
Done

Befehlszeilen- und API-Referenzen

Verlaufs-IPaddr

Zeigt den Unicast-IPv6-Adressverlauf im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Ereignis: Mögliche Werte sind Added und Removed.
  • Adresse/Präfixlänge: Unicast-Adresse mit ihrer Präfixlänge (in Bit).
  • Ursprung: Mögliche Werte sind thread, slaac, dhcp6 oder manual.
  • Bereich: IPv6-Adressbereich.
  • P: Präferenz.
  • V: Valid-Flag.
  • RLOC (R): Dieses Flag gibt an, ob die IPv6-Adresse eine Routingsuche ist.

Parameter

history ipaddr [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlauf iPMaddr

Zeigt den Verlauf der Multicast-IPv6-Adressen im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Ereignis: Mögliche Werte sind Subscribed und Unsubscribed.
  • Multicast-Adresse
  • Ursprung: Mögliche Werte sind Thread und Manual.

Parameter

history ipmaddr [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlaufsnachbar

Zeigt den Verlauf der Nachbarn im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Geben Sie Child oder Router ein.
  • Ereignis: Mögliche Werte sind Added, Removed oder Changed.
  • Erweiterte Adresse
  • RLOC16
  • Modus: MLE-Linkmodus. Mögliche Werte:
    • -: keine Flags festgelegt (rx-off-when-idle, minimales Thread-Gerät, stabile Netzwerkdaten).
    • r: „rx-on-when-idle“
    • d: Full-Thread-Gerät.
    • n: Vollständige Netzwerkdaten
  • Ave RSS: Durchschnittliche Anzahl der Frames (in dBm), die bei der Aufzeichnung des Eintrags vom Nachbarn empfangen wurden.

Parameter

history neighbor [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlauf von Netinfo

Zeigt den Verlauf der Netzwerkinformationen im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Rolle: Geräterolle. Mögliche Werte sind router, child, detached oder disabled.
  • Modus: MLE-Linkmodus. Mögliche Werte:
    • -: keine Flags festgelegt (rx-off-when-idle, minimales Thread-Gerät, stabile Netzwerkdaten).
    • r: „rx-on-when-idle“
    • d: Full-Thread-Gerät.
    • n: Vollständige Netzwerkdaten
  • RLOC16
  • Partitions-ID.

Parameter

history netinfo [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlaufspräfix

Zeigt die Netzwerkdaten für den Mesh-Präfixverlauf im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Ereignis: Mögliche Werte sind Added und Removed.
  • Präfix
  • Markierungen/Bedeutung:
    • p: bevorzugtes Flag
    • a: Flag für die automatische Konfiguration von zustandslosen IPv6-Adressen.
    • d: Konfigurations-Flag für DHCPv6-IPv6-Adressen.
    • c: DHCPv6-Flag für weitere Konfiguration.
    • r: Standardrouten-Flag.
    • o: Bei Mesh-Flag.
    • s: stabiles Flag.
    • n: Nd Dns-Flag.
    • D: Domainpräfix-Flag.
  • Präf.: Präferenz. Mögliche Werte sind high, med oder low.
  • RLOC16

Parameter

history prefix [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlaufsroute

Zeigt den Verlauf der externen Routen für Netzwerkdaten im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Ereignis: Mögliche Werte sind Added und Removed.
  • Route
  • Markierungen/Bedeutung:
    • s: stabiles Flag.
    • n: NAT64-Flag.
  • Präf.: Präferenz. Mögliche Werte sind high, med oder low.
  • RLOC16

Parameter

history route [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

History Router

Zeigt den Verlauf der Routingtabellen im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Ereignis: Mögliche Werte sind Added, Removed, NextHopChanged oder CostChanged.
  • ID (RLOC16): Router-ID und RLOC16 des Routers.
  • Nächster Hop: Router-ID und RLOC16 des nächsten Hops. Wenn es keinen nächsten Hop gibt, wird none angezeigt.
  • Pfadkosten: alte Kosten -> neue Kosten. Der Wert inf steht für unendliche Pfadkosten.

Parameter

history router [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlaufs-Rx

Zeigt den RX-Verlauf der IPv6-Nachricht im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Typ:
    • IPv6-Nachrichtentyp, z. B. UDP, TCP, HopOpts und ICMP6 (und der Untertyp).
    • src: IPv6-Quelladresse und -Portnummer.
    • dst: IPv6-Zieladresse und -Portnummer (die Portnummer ist für UDP/TCP gültig, andernfalls lautet sie 0).
  • Len: Länge der IPv6-Nutzlast (ohne IPv6-Header).
  • Chksum: Nachrichtenprüfsumme (gültig für UDP-, TCP- oder ICMP6-Nachrichten).
  • Sek.: Gibt an, ob Sicherheit auf Link-Ebene verwendet wurde.
  • Prio: Nachrichtenpriorität. Mögliche Werte sind low, norm, high oder net (für Thread-Steuernachrichten).
  • RSS: Empfangsstärke (in dBm), gemittelt über alle empfangenen Fragment-Frames, aus denen die Nachricht gebildet wurde. Für den TX-Verlauf wird NA (nicht zutreffend) angezeigt.
  • Verzeichnis: Gibt an, ob die Nachricht gesendet (TX) oder empfangen (RX) wurde. Eine fehlgeschlagene Übertragung wird mit TX-F im Tabellenformat oder tx-success:no im Listenformat angegeben. Beispiele für fehlgeschlagene Übertragungen sind tx, wenn die Übertragung abgebrochen wird, und keine ack, die vom Peer für eines der Nachrichtenfragmente gesendet werden.
  • Neighb (Nachbar): Kurze Adresse (RLOC16) des Nachbarn, an den die Nachricht gesendet/empfangen wurde. Wenn der Frame übertragen wurde, wird er im Tabellenformat als bcast oder im Listenformat als 0xffff angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie als unknwn im Tabellenformat oder als 0xfffe im Listenformat angezeigt.
  • Radio: Radiolink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn OPENTHREAD_CONFIG_MULTI_RADIO aktiviert ist). Kann 15.4, trel oder all sein (wenn das Ereignis über alle Funklinks gesendet wird).

Parameter

history rx [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlauf rxtx

Zeigt den kombinierten RX- und TX-Verlauf der IPv6-Nachrichten im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Typ:
    • IPv6-Nachrichtentyp, z. B. UDP, TCP, HopOpts und ICMP6 (und der Untertyp).
    • src: IPv6-Quelladresse und -Portnummer.
    • dst: IPv6-Zieladresse und -Portnummer (die Portnummer ist für UDP/TCP gültig, andernfalls lautet sie 0).
  • Len: Länge der IPv6-Nutzlast (ohne IPv6-Header).
  • Chksum: Nachrichtenprüfsumme (gültig für UDP-, TCP- oder ICMP6-Nachrichten).
  • Sek.: Gibt an, ob Sicherheit auf Link-Ebene verwendet wurde.
  • Prio: Nachrichtenpriorität. Mögliche Werte sind low, norm, high oder net (für Thread-Steuernachrichten).
  • RSS: Empfangsstärke (in dBm), gemittelt über alle empfangenen Fragment-Frames, aus denen die Nachricht gebildet wurde. Für den TX-Verlauf wird NA (nicht zutreffend) angezeigt.
  • Verzeichnis: Gibt an, ob die Nachricht gesendet (TX) oder empfangen (RX) wurde. Eine fehlgeschlagene Übertragung wird mit TX-F im Tabellenformat oder tx-success:no im Listenformat angegeben. Beispiele für fehlgeschlagene Übertragungen sind tx, wenn die Übertragung abgebrochen wird, und keine ack, die vom Peer für eines der Nachrichtenfragmente gesendet werden.
  • Neighb (Nachbar): Kurze Adresse (RLOC16) des Nachbarn, an den die Nachricht gesendet/empfangen wurde. Wenn der Frame übertragen wurde, wird er im Tabellenformat als bcast oder im Listenformat als 0xffff angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie als unknwn im Tabellenformat oder als 0xfffe im Listenformat angezeigt.
  • Radio: Radiolink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn OPENTHREAD_CONFIG_MULTI_RADIO aktiviert ist). Kann 15.4, trel oder all sein (wenn das Ereignis über alle Funklinks gesendet wird).

Parameter

history rxtx [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

Verlaufs-Tx

Zeigt den TX-Verlauf der IPv6-Nachricht im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

  • Alter: Seit der Ausführung des Befehls verstrichene Zeit im Format hours:minutes:seconds:milliseconds
  • Typ:
    • IPv6-Nachrichtentyp, z. B. UDP, TCP, HopOpts und ICMP6 (und der Untertyp).
    • src: IPv6-Quelladresse und -Portnummer.
    • dst: IPv6-Zieladresse und -Portnummer (die Portnummer ist für UDP/TCP gültig, andernfalls lautet sie 0).
  • Len: Länge der IPv6-Nutzlast (ohne IPv6-Header).
  • Chksum: Nachrichtenprüfsumme (gültig für UDP-, TCP- oder ICMP6-Nachrichten).
  • Sek.: Gibt an, ob Sicherheit auf Link-Ebene verwendet wurde.
  • Prio: Nachrichtenpriorität. Mögliche Werte sind low, norm, high oder net (für Thread-Steuernachrichten).
  • RSS: Empfangsstärke (in dBm), gemittelt über alle empfangenen Fragment-Frames, aus denen die Nachricht gebildet wurde. Für den TX-Verlauf wird NA (nicht zutreffend) angezeigt.
  • Verzeichnis: Gibt an, ob die Nachricht gesendet (TX) oder empfangen (RX) wurde. Eine fehlgeschlagene Übertragung wird mit TX-F im Tabellenformat oder tx-success:no im Listenformat angegeben. Beispiele für fehlgeschlagene Übertragungen sind tx, wenn die Übertragung abgebrochen wird, und keine ack, die vom Peer für eines der Nachrichtenfragmente gesendet werden.
  • Neighb (Nachbar): Kurze Adresse (RLOC16) des Nachbarn, an den die Nachricht gesendet/empfangen wurde. Wenn der Frame übertragen wurde, wird er im Tabellenformat als bcast oder im Listenformat als 0xffff angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie als unknwn im Tabellenformat oder als 0xfffe im Listenformat angezeigt.
  • Radio: Radiolink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn OPENTHREAD_CONFIG_MULTI_RADIO aktiviert ist). Kann 15.4, trel oder all sein (wenn das Ereignis über alle Funklinks gesendet wird).

Parameter

history tx [list] [num-entries]
  • Verwenden Sie die Option list, um die Ausgabe im Listenformat anzuzeigen. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
  • Verwenden Sie die Option num-entries, um die Ausgabe auf die Anzahl der letzten Einträge zu beschränken. Wenn diese Option nicht verwendet wird, werden alle gespeicherten Einträge in der Ausgabe angezeigt.

Beispiele

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

Befehlszeilen- und API-Referenzen

ifconfig (nach oben,unten)

Bringt die IPv6-Schnittstelle nach oben oder unten.

Rufen Sie diese Option auf, um die IPv6-Kommunikation zu aktivieren oder zu deaktivieren.

Parameter

ifconfig up|down

Beispiele

ifconfig up
Done
ifconfig down
Done

Befehlszeilen- und API-Referenzen

ifconfig

Gibt an, ob die IPv6-Schnittstelle aktiv ist.

Parameter

Keine Parameter.

Beispiele

ifconfig
down
Done
ifconfig
up
Done

Befehlszeilen- und API-Referenzen

Instanz-ID

Ruft die Instanz-ID ab.

Die Instanzkennung wird beim Erstellen der Instanz auf einen zufälligen Wert gesetzt und ihr Wert ändert sich nach der Initialisierung nicht.

Parameter

Keine Parameter.

Beispiele

instanceid
468697314
Done

Befehlszeilen- und API-Referenzen

IPaddr hinzufügen

Fügt der Thread-Schnittstelle eine Netzwerkschnittstellenadresse hinzu.

Die übergebene Instanz aAddress wird von der Thread-Schnittstelle kopiert. Die Thread-Schnittstelle unterstützt nur eine feste Anzahl von extern hinzugefügten Unicast-Adressen. OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS ansehen.

Parameter

ipaddr add aAddress

Beispiele

ipaddr add 2001::dead:beef:cafe
Done

Befehlszeilen- und API-Referenzen

Ipaddr Del

Entfernt die Adresse einer Netzwerkschnittstelle aus der Thread-Schnittstelle.

Parameter

ipaddr del aAddress

Beispiele

ipaddr del 2001::dead:beef:cafe
Done

Befehlszeilen- und API-Referenzen

Ipaddr

Ruft die Liste der IPv6-Adressen ab, die der Thread-Schnittstelle zugewiesen sind.

Parameter

ipaddr [-v]

Verwenden Sie -v, um ausführlichere Informationen zur Adresse zu erhalten:

  • origin: kann thread, slaac, dhcp6 oder manual sein und gibt den Ursprung der Adresse an
  • plen: Präfixlänge
  • preferred: bevorzugtes Flag (boolesch)
  • valid: gültiges Flag (boolesch)

Beispiele

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

Befehlszeilen- und API-Referenzen

Ipaddr LinkLocal

Ruft die Link-Local-IPv6-Adresse von Thread ab.

Die lokale Thread-Link-Adresse wird mithilfe der erweiterten IEEE802.15.4-Adresse als Schnittstellen-ID abgeleitet.

Parameter

Keine Parameter.

Beispiele

ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

Befehlszeilen- und API-Referenzen

Ipaddr Werkzeug

Ruft die lokale EID-Adresse des Mesh-Netzwerks ab.

Parameter

Keine Parameter.

Beispiele

ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done

Befehlszeilen- und API-Referenzen

Ipaddr Rloc

Ruft die RLOC-Adresse (Thread Routing Locator) ab.

Parameter

Keine Parameter.

Beispiele

ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done

Befehlszeilen- und API-Referenzen

ipmaddr hinzufügen

Abonnieren der Thread-Schnittstelle eine Netzwerkschnittstellen-Multicast-Adresse.

Die übergebene Instanz aAddress wird von der Thread-Schnittstelle kopiert. Die Thread-Schnittstelle unterstützt nur eine feste Anzahl von extern hinzugefügten Multicast-Adressen. OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS ansehen.

Parameter

ipmaddr add aAddress

Beispiele

ipmaddr add ff05::1
Done

Befehlszeilen- und API-Referenzen

IPMaddr Del

Beendet die Thread-Schnittstelle für eine Netzwerkschnittstellen-Multicast-Adresse.

Parameter

ipmaddr del aAddress

Beispiele

ipmaddr del ff05::1
Done

Befehlszeilen- und API-Referenzen

ipmaddr

Ruft die Liste der IPv6-Multicast-Adressen ab, die die Thread-Schnittstelle abonniert haben.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

IPMaddr Llatn

Ruft die Multicast-Adresse der lokalen Thread-Link-Alle Thread-Knoten ab.

Die Adresse ist eine Link-Local-Unicast-Präfix-basierte Multicast-Adresse [RFC 3306] mit:

  • flgs auf 3 gesetzt (P = 1 und T = 1)
  • Scop auf 2 festgelegt
  • Plen auf 64 eingestellt
  • Netzwerkpräfix auf das lokale Mesh-Präfix festgelegt
  • Gruppen-ID auf „1“ festgelegt

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

ipmaddr promiskuit (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den promiskuitiven Multicast-Modus auf der Thread-Oberfläche.

Parameter

ipmaddr promiscuous enable|disable

Beispiele

ipmaddr promiscuous enable
Done
ipmaddr promiscuous disable
Done

Befehlszeilen- und API-Referenzen

ipmaddr promiskuit

Prüft, ob der promiskuitive Multicast-Modus auf der Thread-Schnittstelle aktiviert ist.

Parameter

Keine Parameter.

Beispiele

ipmaddr promiscuous
Disabled
Done

Befehlszeilen- und API-Referenzen

ipmaddr Rlatn

Ruft die Multicast-Adresse aller Thread-Knoten unter "Thread Realm-Local" ab.

Die Adresse ist eine bereichsspezifische, präfixbasierte Unicast-Multicast-Adresse [RFC 3306] mit:

  • flgs auf 3 gesetzt (P = 1 und T = 1)
  • Scop auf 3 festgelegt
  • Plen auf 64 eingestellt
  • Netzwerkpräfix auf das lokale Mesh-Präfix festgelegt
  • Gruppen-ID auf „1“ festgelegt

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Joiner Discerner (festgelegt)

Legt die Verbindungserkennung fest.

Parameter

joiner discerner discerner
  • Verwenden Sie {number}/{length}, um discerner festzulegen.
  • joiner discerner clear setzt aDiscerner auf nullptr.

Beispiele

joiner discerner 0xabc/12
Done

Befehlszeilen- und API-Referenzen

Joiner Discerner klar

Entfernen Sie das Verbindungselement.

Parameter

Keine Parameter.

Beispiele

joiner discerner clear
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Joiner Discerner

Ruft den Joiner Discerner ab.

Weitere Informationen finden Sie unter otJoinerSetDiscerner.

Parameter

Keine Parameter.

Beispiele

joiner discerner
0xabc/12
Done

Befehlszeilen- und API-Referenzen

Hilfe zu Joiner

Drucken Sie das Hilfemenü von joiner.

Parameter

Keine Parameter.

Beispiele

joiner help
help
id
start
state
stop
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Joiner-ID

Ruft die Joiner-ID ab.

Wenn keine Joiner Discerner festgelegt ist, sind die Joiner ID die ersten 64 Bit des Ergebnisses der Berechnung von SHA-256 über den werkseitig zugewiesenen IEEE EUI-64. Andernfalls wird die Joiner-ID aus dem Joiner Discerner-Wert berechnet.

Die Joiner-ID wird während der Inbetriebnahme auch als erweiterte IEEE 802.15.4-Adresse des Geräts verwendet.

Parameter

Keine Parameter.

Beispiele

joiner id
d65e64fa83f81cf7
Done

Befehlszeilen- und API-Referenzen

Joiner-Start

Aktiviert die Rolle „Thread Joiner“.

Parameter

joiner start joining-device-credential [provisioning-url]
  • joining-device-credential: Passphrase für den Teilnehmer. Muss aus einem String aus Großbuchstaben alphanumerische Zeichen (0–9 und A–Y, zur besseren Lesbarkeit mit Ausnahme von I, O, Q und Z) bestehen und zwischen 6 und 32 Zeichen lang sein.
  • provisioning-url: Nutzerverwaltungs-URL für den Joiner (optional).

Beispiele

joiner start J01NM3
Done

Befehlszeilen- und API-Referenzen

Joiner-Status

Ruft den Joiner-Status ab.

Gibt einen der folgenden Status zurück:

  • Idle
  • Discover
  • Connecting
  • Connected
  • Entrust
  • Joined

Parameter

Keine Parameter.

Beispiele

joiner state
Idle
Done

Befehlszeilen- und API-Referenzen

Joiner stopp

Deaktiviert die Rolle "Thread Joiner".

Parameter

Keine Parameter.

Beispiele

joiner stop
Done

Befehlszeilen- und API-Referenzen

Joinerport (festgelegt)

Legt den Joiner-UDP-Port fest.

Parameter

joinerport udp-port

Beispiele

joinerport 1000
Done

Befehlszeilen- und API-Referenzen

Joinerport

Ruft den Joiner-UDP-Port ab.

Parameter

Keine Parameter.

Beispiele

joinerport
1000
Done

Befehlszeilen- und API-Referenzen

Schlüsselsequenzzähler (fest)

Legt den thrKeySequenceCounter fest.

Parameter

keysequence counter counter

Beispiele

keysequence counter 10
Done

Befehlszeilen- und API-Referenzen

Schlüsselsequenzzähler

Ruft den thrKeySequenceCounter ab.

Parameter

Keine Parameter.

Beispiele

keysequence counter
10
Done

Befehlszeilen- und API-Referenzen

Guardtime für Schlüsselsequenz (festgelegt)

Legt die thrKeySwitchGuardTime (in Stunden) fest.

Parameter

keysequence guardtime guardtime-hours

Verwenden Sie 0, um sofort Thread Key Switch zu verwenden, wenn eine Schlüsselindexübereinstimmung besteht.

Beispiele

keysequence guardtime 0
Done

Befehlszeilen- und API-Referenzen

Guard-Zeit für Schlüsselsequenzen

Ruft die thrKeySwitchGuardTime (in Stunden) ab.

Parameter

Keine Parameter.

Beispiele

keysequence guardtime
0
Done

Befehlszeilen- und API-Referenzen

Leader-Daten

Ruft die Thread-Lead-Daten ab.

Parameter

Keine Parameter.

Beispiele

leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done

Befehlszeilen- und API-Referenzen

Führen-Gewichtung (festgelegt)

Legt die Gewichtung für Thread-Leader fest, die bei einem Betrieb in der Leader-Rolle verwendet wird.

Setzt die Leader-Gewichtung direkt auf den neuen Wert und ersetzt den vorherigen Wert, der möglicherweise aus dem aktuellen otDeviceProperties ermittelt wurde.

Parameter

leaderweight weight

Beispiele

leaderweight 128
Done

Befehlszeilen- und API-Referenzen

Leadergewicht

Ruft die Gewichtung der Thread-Leader ab, die bei einem Betrieb in der Leader-Rolle verwendet wird.

Parameter

Keine Parameter.

Beispiele

leaderweight
128
Done

Befehlszeilen- und API-Referenzen

Linkmetrics Management, erweiterte Bestätigung, klar

Sendet eine Anfrage zur Linkmesswert-Verwaltung, um eine erweiterte ACK-basierte Prüfung zu löschen.

Parameter

linkmetrics mgmt peer-ipaddr enhanced-ack clear

peer-ipaddr sollte die Link-Local-Adresse des benachbarten Geräts sein.

Beispiele

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

Befehlszeilen- und API-Referenzen

Linkmetrics Management, erweiterte Bestätigung, Register

Sendet eine Anfrage zur Linkmesswert-Verwaltung, um eine erweiterte ACK-basierte Prüfung zu registrieren.

Parameter

linkmetrics mgmt peer-ipaddr enhanced-ack register [qmr][r]

[q, m und r] sind otLinkMetricsValues zugeordnet. Gemäß Spezifikation 4.11.3.4.4.6 können maximal zwei Optionen gleichzeitig verwendet werden, z. B. q oder qm.

  • q: Ebene-2-LQI.
  • m: Linkrand.
  • r: RSSI.
Die zusätzliche r ist optional und wird nur für Referenzgeräte verwendet. Wenn diese Option angegeben ist, wird „Type/Average Enum“ für jedes Typ-ID-Flag auf „reserviert“ gesetzt. Hiermit wird geprüft, ob die prüfende Person ungültige Typ-ID-Flags korrekt verarbeitet. Sie ist nur verfügbar, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Beispiele

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

Befehlszeilen- und API-Referenzen

Linkmetrics Mgmt Forward

Sendet eine Anfrage zur Messwertverwaltung für MLE-Verknüpfungen, um eine Reihe von Weiterleitungsverfolgungen zu konfigurieren oder zu löschen.

Parameter

linkmetrics mgmt peer-ipaddr forward series-id [ldraX][pqmr]
  • peer-ipaddr: Peer-Adresse.
  • series-id: Die Serien-ID.
  • [l, d, r und a] sind otLinkMetricsSeriesFlags zugeordnet. X steht für keinen der otLinkMetricsSeriesFlags, die Erfassung wird beendet und die Reihe wird entfernt.
    • l: MLE-Linkprüfung.
    • d: MAC-Daten.
    • r: MAC-Datenanfrage.
    • a: MAC-Ack.
    • X: Kann nur ohne andere Flags verwendet werden.
  • [p, q, m und r] sind otLinkMetricsValues zugeordnet.
    • p: Anzahl der Ebene-2-PDUs, die empfangen wurden.
    • q: Ebene-2-LQI.
    • m: Linkrand.
    • r: RSSI.

Beispiele

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS

Befehlszeilen- und API-Referenzen

Linkmetrics-Prüfung

Sendet eine MLE-Linkprüfung-Nachricht.

Parameter

linkmetrics probe peer-ipaddr series-id length
  • peer-ipaddr: Peer-Adresse.
  • series-id: Die Serien-ID, auf die diese Prüfungsnachricht abzielt.
  • length: Die Länge der Prüfungsnachricht. Ein gültiger Bereich ist [0, 64].

Beispiele

linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done

Befehlszeilen- und API-Referenzen

Linkmetrics Abfrageweiterleitung

Führen Sie eine Abfrage mit Linkmesswerten (Forward Tracking Series) durch.

Parameter

linkmetrics query peer-ipaddr forward series-id
  • peer-ipaddr: Peer-Adresse.
  • series-id: Die Serien-ID.

Beispiele

linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)

Befehlszeilen- und API-Referenzen

linkmetrics-Abfrage einfach

Führen Sie eine Link-Messwert-Abfrage (Einzelprüfung) durch.

Parameter

linkmetrics query peer-ipaddr single [pqmr]
  • peer-ipaddr: Peer-Adresse.
  • [p, q, m und r] sind otLinkMetrics zugeordnet.
    • p: Anzahl der Ebene-2-PDUs, die empfangen wurden.
    • q: Ebene-2-LQI.
    • m: Linkrand.
    • r: RSSI.

Beispiele

linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)

Befehlszeilen- und API-Referenzen

linkmetricsmgr (aktivieren,deaktivieren)

Linkmesswert-Manager aktivieren oder deaktivieren.

Parameter

linkmetricsmgr enable|disable

Beispiele

linkmetricmgr enable
Done
linkmetricmgr disable
Done

Befehlszeilen- und API-Referenzen

linkmetricsmgr anzeigen

Linkmetrikdaten eines Nachbarn anhand seiner erweiterten Adresse abrufen.

Parameter

Keine Parameter.

Beispiele

linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done

Befehlszeilen- und API-Referenzen

suchen (festlegen)

Suchen Sie das nächstgelegene Ziel einer Anycast-Adresse (d.h. die lokale EID des Mesh-Netzwerks und RLOC16 des Ziels).

Das nächstgelegene Ziel wird anhand der aktuellen Routingtabelle und der Pfadkosten innerhalb des Thread-Mesh-Netzwerks bestimmt.

Verfügbar, wenn OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE aktiviert ist.

Parameter

locate anycastaddr

Beispiele

locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done

Befehlszeilen- und API-Referenzen

suchen

Ruft den aktuellen Status (In Progress oder Idle) der Anycast-Suche ab.

Verfügbar, wenn OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done

Befehlszeilen- und API-Referenzen

Logdateiname

Gibt den Dateinamen zum Erfassen von otPlatLog() -Nachrichten an. Dies ist hilfreich beim Debuggen von automatisierten Testskripts unter Linux, wenn die Protokollierung die automatisierten Testskripts unterbricht.

Erfordert OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART und OPENTHREAD_POSIX.

Parameter

log filename filename

Beispiele

Befehlszeilen- und API-Referenzen

Logebene (festgelegt)

Legt die Logebene fest.

Parameter

log level level

Beispiele

log level 4
Done

Befehlszeilen- und API-Referenzen

Logebene

Rufen Sie die Logebene ab.

Parameter

Keine Parameter.

Beispiele

log level
1
Done

Befehlszeilen- und API-Referenzen

Mac-Wiederholungsversuche direkt (get,set)

Ruft die Anzahl der direkten TX-Wiederholungsversuche auf der MAC-Ebene ab oder legt sie fest.

Parameter

mac retries direct [number]

Verwenden Sie das optionale Argument number, um die Anzahl der direkten TX-Wiederholungen festzulegen.

Beispiele

mac retries direct
3
Done
mac retries direct 5
Done

Befehlszeilen- und API-Referenzen

Mac-Wiederholungsversuche indirekt (get,set)

Ruft die Anzahl der indirekten TX-Wiederholungsversuche auf der MAC-Ebene ab oder legt sie fest.

Parameter

mac retries indirect [number]

Verwenden Sie das optionale Argument number, um die Anzahl der indirekten Tx-Wiederholungsversuche festzulegen.

Beispiele

mac retries indirect
3
Done
 max retries indirect 5
Done

Befehlszeilen- und API-Referenzen

Mac senden

Weist ein Rx-Off-When-Idle-Gerät an, einen MAC-Frame an das übergeordnete Gerät zu senden. Dieser Befehl dient zur Zertifizierung und kann nur verwendet werden, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Parameter

mac send datarequest | emptydata

Sie müssen eines der folgenden beiden Argumente auswählen:

  • datarequest: stellt eine IEEE 802.15.4-Datenanfragenachricht für die Übertragung in die Warteschlange.
  • emptydata: Weist das Gerät an, einen leeren IEEE 802.15.4-Dataframe zu senden.

Beispiele

mac send datarequest
Done
mac send emptydata
Done

Befehlszeilen- und API-Referenzen

MACfilter-Adresse hinzufügen

Ist nur verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Fügt der MAC-Filterliste eine erweiterte IEEE 802.15.4-Adresse hinzu. Durch Angabe des optionalen Arguments rss wird die Stärke des empfangenen Signals für Nachrichten von der Adresse korrigiert. Wenn Sie die Option rss nicht verwenden, wird für die Adresse der von Ihnen festgelegte Standardwert verwendet. Wenn Sie keine Standardeinstellung festgelegt haben, entspricht die Signalstärke dem Over-Air-Signal.

Parameter

macfilter addr add extaddr [rss]

Beispiele

macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done

Befehlszeilen- und API-Referenzen

Zulassungsliste für Macfilter-Addr

Aktiviert den MAC-Filtermodus allowlist. Das bedeutet, dass nur MAC-Adressen in der MAC-Filterliste Zugriff erhalten.

Parameter

Keine Parameter.

Beispiele

macfilter addr allowlist
Done

Befehlszeilen- und API-Referenzen

Macfilter Adresse löschen

Ist verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Mit diesem Befehl werden alle erweiterten Adressen aus der MAC-Filterliste gelöscht.

Parameter

Keine Parameter.

Beispiele

macfilter addr clear
Done

Befehlszeilen- und API-Referenzen

Sperrliste für Macfilter

Aktiviert den MAC-Filtermodus denylist. Das bedeutet, dass allen MAC-Adressen in der MAC-Filterliste der Zugriff verweigert wird.

Parameter

Keine Parameter.

Beispiele

macfilter addr denylist
Done

Befehlszeilen- und API-Referenzen

MACfilter-Adresse deaktivieren

Deaktiviert MAC-Filtermodi.

Parameter

Keine Parameter.

Beispiele

macfilter addr disable
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Macfilter-Adresse

Ist verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Stellt die folgenden Informationen bereit:

  • Aktueller Modus der MAC-Filterliste: entweder AllowList, DenyList, oder Disabled
  • Eine Liste aller erweiterten Adressen im Filter. Neben der Adresse werden die Stärke des empfangenen Signals (RSS) und der Linkqualitätsindikator (LQi) angezeigt, falls diese Werte von den Standardwerten abweichen.

Parameter

Keine Parameter.

Beispiele

macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done

Befehlszeilen- und API-Referenzen

MACfilter-Adresse entfernen

Ist verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Mit diesem Befehl wird die angegebene erweiterte Adresse aus der MAC-Filterliste entfernt.

Parameter

macfilter addr remove extaddr

Beispiele

macfilter addr remove 0f6127e33af6b402
Done

Befehlszeilen- und API-Referenzen

MacFilter

Stellt die folgenden Informationen bereit:

  • Address Mode: Aktueller Modus des MAC-Filters: entweder AllowList, DenyList, oder Disabled
  • Eine Liste aller erweiterten Adressen in der MAC-Filterliste. Neben der Adresse werden die Stärke des empfangenen Signals (RSS) und der Linkqualitätsindikator (LQi) angezeigt, falls diese Werte von den Standardwerten abweichen.
  • Eine separate Liste (RssIn List), die alle erweiterten Adressen enthält, bei denen die rss so eingestellt wurde, dass sie sich vom Standardwert unterscheidet.
  • Default rss: Zeigt gegebenenfalls die Standardwerte für die Einstellungen rss und lqi an.

Parameter

Keine Parameter.

Beispiele

macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

Befehlszeilen- und API-Referenzen

Macfilter RSS hinzufügen

Fügt die angegebene erweiterte Adresse der RssIn-Liste hinzu (oder ändert eine vorhandene Adresse in der RssIn-Liste) und legt den Eintrag für die empfangene Signalstärke (in dBm) für Nachrichten von dieser Adresse fest.

Parameter

macfilter rss add extaddr rss

Um einen Standardwert für die Stärke des empfangenen Signals für alle empfangenen Nachrichten festzulegen, verwenden Sie * für das Argument extaddr.

Beispiele

macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done

Befehlszeilen- und API-Referenzen

Macfilter RSS add-lqi

Fügt die angegebene erweiterte Adresse zur RssIn-Liste hinzu (oder ändert eine vorhandene Adresse in der RssIn-Liste) und legt den Indikator für die feste Linkqualität für Nachrichten von dieser Adresse fest. Die erweiterte Adresse muss nicht unbedingt im address allowlist/denylist-Filter enthalten sein, um lqi festzulegen.

Diese Option ist verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Parameter

macfilter rss add-lqi extaddr lqi

Um einen Standardwert für die Verbindungsqualitätskennzahl für alle empfangenen Nachrichten festzulegen, verwenden Sie * für das Argument extaddr. Der zulässige Bereich liegt zwischen 0 und 3.

Beispiele

macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done

Befehlszeilen- und API-Referenzen

Macfilter RSS Clear

Löscht alle Einträge für die empfangene Signalstärke (rss) und die Linkqualitätsanzeige (lqi) (einschließlich Standardeinstellungen) aus der Liste RssIn.

Das bedeutet, dass alle erweiterten Adressen das On-Air-Signal verwenden.

Ist verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Parameter

Keine Parameter.

Beispiele

macfilter rss clear
Done

Befehlszeilen- und API-Referenzen

Macfilter RSS

Stellt die folgenden Informationen bereit:

  • Liste aller erweiterten Adressen, bei denen die Stärke des empfangenen Signals (rss) so eingestellt wurde, dass sie vom Standardwert abweicht. Der Qualitätsindikator für die Verknüpfung (lqi) wird ebenfalls angezeigt. Die Einstellungen für rss und lqi sind einander zugeordnet. Wenn Sie eines festlegen, wird der Wert der anderen automatisch festgelegt. Diese Adressenliste wird als RssIn List bezeichnet. Wenn Sie entweder rsi oder lqi festlegen, wird die entsprechende erweiterte Adresse der Liste RssIn hinzugefügt.
  • Default rss: Zeigt gegebenenfalls die Standardwerte für die Einstellungen rss und lqi an.

Parameter

Keine Parameter.

Beispiele

macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

Befehlszeilen- und API-Referenzen

Macfilter RSS entfernen

Entfernt die angegebene erweiterte Adresse aus der Liste RssIn.

Nach dem Entfernen aus der RssIn-Liste verwendet diese MAC-Adresse stattdessen die Standardeinstellungen rss und lqi, sofern Standardeinstellungen festgelegt wurden. Wenn keine Standardeinstellungen festgelegt sind, wird das Over-Air-Signal verwendet.

Ist verfügbar, wenn die OPENTHREAD_CONFIG_MAC_FILTER_ENABLE-Konfiguration aktiviert ist.

Wenn in der RssIn-Liste kein Eintrag für die angegebene erweiterte Adresse vorhanden ist, wird keine Aktion ausgeführt.

Parameter

macfilter rss remove extaddr

Wenn du die Standardeinstellungen für die Empfangssignalstärke und die Linkqualitätsanzeige entfernen möchtest, verwende * als extaddr. Dadurch werden die Standardeinstellungen aufgehoben, aber es werden keine Einträge aus der RssIn-Liste entfernt.

Beispiele

macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done

Befehlszeilen- und API-Referenzen

Meshdiag Childip6

Senden Sie eine Abfrage an ein übergeordnetes Element, um die IPv6-Adressen aller untergeordneten MTD-Konten abzurufen.

Parameter

meshdiag childip6 parent-rloc16

Beispiele

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

Befehlszeilen- und API-Referenzen

Untergeordnete Tabelle Meshdiag

Starten Sie eine Abfrage für die untergeordnete Tabelle eines Routers mit einem bestimmten RLOC16. Ausgabe listet alle untergeordneten Einträge auf. Informationen pro Kind:

  • RLOC16
  • Erweiterte MAC-Adresse
  • Thread-Version
  • Zeitlimit (in Sekunden)
  • Alter (Sekunden seit dem letzten Aufruf)
  • Elternaufsichtsintervall (in Sekunden)
  • Anzahl der Nachrichten in der Warteschlange (falls das Kind schläfrig ist)
  • Gerätemodus
  • RSS (Durchschnitt und letzte)
  • Fehlerraten: Frame tx (auf der MAC-Ebene), IPv6-Nachricht tx (über MAC)
  • Verbindungszeit (Sekunden seit dem {dd}d.{hh}:{mm}:{ss}-Format des Verbindungsaufbaus)
  • CSL-Informationen:
    • Bei Synchronisierung
    • Punkt (in Zeiteinheit mit 10 Symbolen)
    • Zeitlimit (in Sekunden)

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Meshdiag-Router Nachbartabelle

Abfrage der Routernachbartabelle eines Routers mit einem bestimmten RLOC16 starten. Die Ausgabe listet alle Routernachbareinträge auf. Informationen pro Eintrag:

  • RLOC16
  • Erweiterte MAC-Adresse
  • Thread-Version
  • RSS (Durchschnitt und letzte) und Link-Marge
  • Fehlerraten, Frame tx (auf MAC-Ebene), IPv6-Nachricht tx (über MAC)
  • Verbindungszeit (Sekunden seit dem {dd}d.{hh}:{mm}:{ss}-Format des Verbindungsaufbaus)

Parameter

meshdiag routerneighbortable router-rloc16

Beispiele

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

Befehlszeilen- und API-Referenzen

Meshdiag-Topologie

Ermitteln Sie die Netzwerktopologie (Liste der Router und ihrer Verbindungen). Parameter sind optional und geben zusätzliche Elemente an, die ermittelt werden können. Kann in beliebiger Reihenfolge hinzugefügt werden.

  • ip6-addrs, um die Liste der IPv6-Adressen jedes Routers zu ermitteln.
  • children, um die untergeordnete Tabelle jedes Routers zu ermitteln.

Informationen pro Router:

  • Router-ID
  • RLOC16
  • Erweiterte MAC-Adresse
  • Thread-Version (falls bekannt)
  • Gibt an, ob der Router das Gerät selbst ist (me)
  • Gibt an, ob der Router der übergeordnete Router dieses Geräts ist, wenn das Gerät ein untergeordnetes Gerät ist (parent)
  • Ob der Router leader ist
  • Gibt an, ob der Router als Border-Router für externe Konnektivität fungiert (br)
  • Liste der Router, zu denen dieser Router eine Verbindung hat:
    • 3-links: Router-IDs, zu denen dieser Router eine eingehende Verbindung mit Linkqualität 3 hat
    • 2-links: Router-IDs, zu denen dieser Router eine eingehende Verbindung mit Linkqualität 2 hat
    • 1-links: Router-IDs, zu denen dieser Router eine eingehende Verbindung mit Linkqualität 1 hat
    • Wenn eine Liste leer ist, wird sie am Anfang weggelassen.
  • Wenn ip6-addrs, Liste der IPv6-Adressen des Routers
  • Wenn children, sind alle untergeordneten Elemente des Routers aufgelistet. Informationen pro Kind:
    • RLOC16
    • Eingehende Linkqualität aus der Perspektive des übergeordneten Elements (Null bedeutet, dass es unbekannt ist)
    • Untergeordneter Gerätemodus (r rx-on-if-idle, d Full-Thread-Gerät, n Vollständige Netzwerkdaten, - keine Flags gesetzt)
    • Gibt an, ob das Kind das Gerät selbst ist (me)
    • Gibt an, ob das untergeordnete Element als Border-Router fungiert und externe Konnektivität bereitstellt (br)

Parameter

meshdiag topology [ip6-addrs] [children]

Beispiele

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

Befehlszeilen- und API-Referenzen

Mleadvimax

Ruft den aktuellen Wert für den maximalen Intervallwert ab, der vom Anzeigen-Tricks-Timer verwendet wird.

Diese API erfordert OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE und ist nur für Testzwecke vorgesehen.

Parameter

Keine Parameter.

Beispiele

mleadvimax
12000
Done

Befehlszeilen- und API-Referenzen

mliid

Legt die lokale IID des Mesh-Netzwerks fest (zu Testzwecken).

Erfordert OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Es muss verwendet werden, bevor der Thread-Stack aktiviert wird.

Nur für Test-/Referenzgerät.

Parameter

mliid iid

Beispiele

mliid 1122334455667788
Done

Befehlszeilen- und API-Referenzen

MLR Reg

Registriert Multicast-Listener beim primären Backbone-Router.

OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE und OPENTHREAD_CONFIG_COMMISSIONER_ENABLE müssen aktiviert sein.

Lassen Sie das Zeitlimit aus, um das standardmäßige MLR-Zeitlimit für den primären Backbone-Router zu verwenden.

Verwenden Sie „timeout = 0“, um Multicast-Listener aus der Registrierung aufzuheben.

Parameter

mlr reg ipaddr [timeout]

Beispiele

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

Befehlszeilen- und API-Referenzen

Modus (get,set)

Legen Sie die Konfiguration des MLE-Linkmodus fest.

Parameter

mode [rdn]
  • -: keine Flags festgelegt (rx-off-when-idle, minimales Thread-Gerät, stabile Netzwerkdaten)
  • r: „rx-on-when-idle“
  • d: Full-Thread-Gerät
  • n: Vollständige Netzwerkdaten

Beispiele

mode rdn
Done
mode -
Done

Befehlszeilen- und API-Referenzen

Multiradio

Rufen Sie die Liste der unterstützten Radiolinks für das jeweilige Gerät ab.

Dieser Befehl ist immer verfügbar, auch wenn das Gerät nur eine einzige Funkschnittstelle unterstützt.

Parameter

Keine Parameter.

Beispiele

multiradio
[15.4, TREL]
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Multiradio-Nachbarliste

Ruft die Multi-Funk-Link-Informationen ab, die einem Nachbarn mit einer bestimmten erweiterten Adresse zugeordnet sind.

OPENTHREAD_CONFIG_MULTI_RADIO muss aktiviert sein.

Parameter

Keine Parameter.

Beispiele

multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done

Befehlszeilen- und API-Referenzen

Multiradio Nachbar

Ruft die Multi-Funk-Link-Informationen ab, die einem Nachbarn mit einer bestimmten erweiterten Adresse zugeordnet sind.

OPENTHREAD_CONFIG_MULTI_RADIO muss aktiviert sein.

Parameter

multiradio neighbor ext-address

Beispiele

multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done

Befehlszeilen- und API-Referenzen

nat64 (aktivieren,deaktivieren)

NAT64-Funktionen aktivieren oder deaktivieren

Wenn „OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE“ aktiviert und „true“ deaktiviert ist, wird die Zuordnungstabelle im Übersetzer zurückgesetzt.

Verfügbar, wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE oder OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE aktiviert ist.

Parameter

nat64 enable|disable

Beispiele

nat64 enable
Done
nat64 disable
Done

Befehlszeilen- und API-Referenzen

nat64 cidr

Parameter

Keine Parameter.

Beispiele

nat64 cidr 192.168.255.0/24
Done

Befehlszeilen- und API-Referenzen

Nat64 Cider

Ruft das im NAT64-Übersetzer konfigurierte IPv4-CIDR ab.

Verfügbar, wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

nat64 cidr
192.168.255.0/24
Done

Befehlszeilen- und API-Referenzen

nat64-Zähler

Ruft die Paket- und Fehlerzähler des NAT64-Übersetzers ab.

Verfügbar, wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

nat64-Zuordnungen

Ruft die nächsten AddressMapping-Informationen mithilfe eines Iterators ab.

Verfügbar, wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

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 |

Befehlszeilen- und API-Referenzen

nat64 State

Ruft den Status von NAT64-Funktionen ab.

Der Status PrefixManager ist verfügbar, wenn OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE aktiviert ist. Der Status Translator ist verfügbar, wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist.

Wenn OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE aktiviert ist, gibt PrefixManager einen der folgenden Status zurück:

  • Disabled: NAT64-Präfixmanager ist deaktiviert.
  • NotRunning: NAT64-Präfixmanager ist aktiviert, wird aber nicht ausgeführt. Dies kann bedeuten, dass der Routingmanager deaktiviert ist.
  • Idle: NAT64-Präfixmanager ist aktiviert und wird ausgeführt, veröffentlicht aber kein NAT64-Präfix. Dies kann passieren, wenn ein anderer Border-Router ein NAT64-Präfix mit höherer Priorität veröffentlicht.
  • Active: NAT64-Präfixmanager ist aktiviert, wird ausgeführt und veröffentlicht ein NAT64-Präfix.

Wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist, gibt Translator einen der folgenden Status zurück:

  • Disabled: Der NAT64-Übersetzer ist deaktiviert.
  • NotRunning: NAT64-Übersetzer ist aktiviert, übersetzt aber keine Pakete. Dies kann bedeuten, dass der Translator nicht mit einem NAT64-Präfix oder einem CIDR für NAT64 konfiguriert ist.
  • Active: NAT64-Übersetzer ist aktiviert und übersetzt Pakete.

Parameter

Keine Parameter.

Beispiele

nat64 state
PrefixManager: Active
Translator: Active
Done

Befehlszeilen- und API-Referenzen

Liste der Nachbarn

Gibt die Verbindungszeit und das Alter von Nachbarn aus. Dieser Befehl ähnelt neighbor conntime, zeigt die Informationen jedoch in einem Listenformat an. Das Alter und die Verbindungszeit werden in Sekunden angezeigt.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Nachbar Conntime

Gibt die Verbindungszeit und das Alter von Nachbarn aus. Informationen pro Nachbarn:

  • RLOC16
  • Erweiterte MAC
  • Zuletzt gehört (Alter): Anzahl der Sekunden, seitdem das letzte Mal von einem Nachbarn gehört wurde.
  • Verbindungszeit: Anzahl von Sekunden seit dem Aufbau der Verbindung mit dem Nachbarn. Dauerintervalle werden als {hh}:{mm}:{ss} für Stunden, Minuten und Sekunden formatiert, wenn die Dauer kürzer als ein Tag ist. Wenn die Dauer länger als einen Tag ist, lautet das Format {dd}d.{hh}:{mm}:{ss}.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Nachbar-Linkqualität

Gibt Informationen zur Linkqualität über alle Nachbarn aus.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Nachbarliste

Listet die RLOC16-Werte jedes Nachbarn auf.

Parameter

Keine Parameter.

Beispiele

neighbor list
0xcc01 0xc800 0xf000
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Nachbartabelle

Gibt Informationen über alle Nachbarn im Tabellenformat aus.

Für Role sind die einzigen möglichen Werte für diese Tabelle C (untergeordnet) oder R (Router).

Die folgenden Spalten enthalten Informationen zum Gerätemodus der Nachbarn. Jede Spalte hat den Wert 0 (aus) oder 1 (an).

  • R: RX bei Inaktivität aktiviert
  • D: Full-Thread-Gerät
  • N: Vollständige Netzwerkdaten

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Netdata voll

Gibt „yes“ oder „no“ aus und gibt an, ob der Callback „net data voll“ seit dem Start des Thread-Vorgangs oder seit dem letzten Zurücksetzen des Flags mit netdata full reset aufgerufen wurde. Für diesen Befehl ist OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL erforderlich. Der Callback "Nettodaten voll" wird in folgenden Fällen aufgerufen:

  • Das Gerät fungiert als Leiter und erhält eine Registrierung von Netzwerkdaten von einem Border Router (BR), das es nicht zu den Netzwerkdaten hinzufügen kann (zu wenig Speicherplatz).
  • Das Gerät fungiert als AF und seinen lokalen Netzwerkdaten können keine neuen Einträge hinzugefügt werden.
  • Das Gerät fungiert als BR und versucht, seine lokalen Netzwerkdateneinträge beim Leader zu registrieren, stellt jedoch fest, dass die lokalen Einträge nicht passen.

Parameter

Keine Parameter.

Beispiele

netdata full
no
Done

Befehlszeilen- und API-Referenzen

Netdata, vollständig zurückgesetzt

Setzen Sie das Flag zurück, mit dem erfasst wird, ob der Callback „Nettodaten voll“ aufgerufen wurde.

Parameter

Keine Parameter.

Beispiele

netdata full reset
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Netdata-Länge

Ruft die aktuelle Länge (Anzahl der Byte) der Thread-Netzwerkdaten von Partition ab.

Parameter

Keine Parameter.

Beispiele

netdata length
23
Done

Befehlszeilen- und API-Referenzen

Maximale Länge von Netdata

Ruft die maximal beobachtete Länge der Thread-Netzwerkdaten seit der Initialisierung des OT-Stacks oder seit dem letzten Aufruf von otNetDataResetMaxLength() ab.

Parameter

Keine Parameter.

Beispiele

netdata maxlength
40
Done

Befehlszeilen- und API-Referenzen

Netdata Maxlength zurücksetzen

Setzt die aufgezeichnete maximale Länge der Thread-Netzwerkdaten zurück.

Parameter

Keine Parameter.

Beispiele

netdata maxlength reset
Done

Befehlszeilen- und API-Referenzen

Netdata Publish dnssrp Anycast

Veröffentlicht eine Anycast-Adresse des DNS-/SRP-Dienstes mit einer Sequenznummer. Alle aktuellen DNS-/SRP-Diensteinträge, die über einen vorherigen publish dnssrp{anycast|unicast}-Befehl veröffentlicht werden, werden entfernt und durch die neuen Argumente ersetzt.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE muss aktiviert sein.

Parameter

netdata publish dnssrp anycast seq-num

Beispiele

netdata publish dnssrp anycast 1
Done

Befehlszeilen- und API-Referenzen

netdata Publish dnssrp Unicast (addr,port)

Veröffentlicht eine DNS-/SRP-Dienst-Unicast-Adresse mit einer Adresse und Portnummer. Die Adresse und der Port sind in den TLV-Daten des Dienstes enthalten. Alle aktuellen DNS-/SRP-Diensteinträge, die über einen vorherigen publish dnssrp{anycast|unicast}-Befehl veröffentlicht werden, werden entfernt und durch die neuen Argumente ersetzt.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE muss aktiviert sein.

Parameter

netdata publish dnssrp unicast address port

Beispiele

netdata publish dnssrp unicast fd00::1234 51525
Done

Befehlszeilen- und API-Referenzen

Netdata Publish dnssrp Unicast (mle)

Veröffentlicht die Mesh-Local-EID des Geräts mit einer Portnummer. MLE- und Portinformationen sind in den TLV-Daten des Servers enthalten. Verwenden Sie den Befehl netdata publish dnssrp unicast (addr,port), um eine andere Unicast-Adresse zu verwenden.

Alle aktuellen DNS-/SRP-Diensteinträge, die über einen vorherigen publish dnssrp{anycast|unicast}-Befehl veröffentlicht werden, werden entfernt und durch die neuen Argumente ersetzt.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE muss aktiviert sein.

Parameter

netdata publish dnssrp unicast port

Beispiele

netdata publish dnssrp unicast 50152
Done

Befehlszeilen- und API-Referenzen

Netdata Publish-Präfix

Veröffentlichen Sie einen Präfixeintrag für das Mesh-Netzwerk. Weitere Informationen finden Sie unter Display and Manage Network Data with OT CLI (Netzwerkdaten mit OT-Befehlszeile anzeigen und verwalten).

Parameter

netdata publish prefix prefix [padcrosnD] [high|med|low]

Die OT-Befehlszeile verwendet zugeordnete Argumente, um otBorderRouterConfig-Werte zu konfigurieren. Weitere Informationen finden Sie in der Übersicht zur OpenThread-Befehlszeile.

Beispiele

netdata publish prefix fd00:1234:5678::/64 paos med
Done

Befehlszeilen- und API-Referenzen

Netdata Publish-Option ersetzen

Ersetzt einen zuvor veröffentlichten externen Routeneintrag. Weitere Informationen finden Sie unter Display and Manage Network Data with OT CLI (Netzwerkdaten mit OT-Befehlszeile anzeigen und verwalten).

Parameter

netdata publish replace oldprefix prefix [sn] [high|med|low]

Die OT-Befehlszeile verwendet zugeordnete Argumente, um otExternalRouteConfig-Werte zu konfigurieren. Weitere Informationen finden Sie in der Übersicht zur OpenThread-Befehlszeile.

Beispiele

netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done

Befehlszeilen- und API-Referenzen

Netdata Publish-Route

Veröffentlichen Sie einen Eintrag für eine externe Route. Weitere Informationen finden Sie unter Display and Manage Network Data with OT CLI (Netzwerkdaten mit OT-Befehlszeile anzeigen und verwalten).

Parameter

publish route prefix [sn] [high|med|low]

Die OT-Befehlszeile verwendet zugeordnete Argumente, um otExternalRouteConfig-Werte zu konfigurieren. Weitere Informationen finden Sie in der Übersicht zur OpenThread-Befehlszeile.

Beispiele

netdata publish route fd00:1234:5678::/64 s high
Done

Befehlszeilen- und API-Referenzen

Netdata Register

Registrieren Sie konfigurierte Präfixe, Routen und Dienste beim Leader.

Die OT-Befehlszeile sucht nach OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE. Wenn OTBR aktiviert ist, werden lokale Netzwerkdaten beim Leader registriert. Andernfalls wird die Befehlszeilenfunktion otServerRegister aufgerufen. Weitere Informationen finden Sie unter Display and Manage Network Data with OT CLI (Netzwerkdaten mit OT-Befehlszeile anzeigen und verwalten).

Parameter

Keine Parameter.

Beispiele

netdata register
Done

Befehlszeilen- und API-Referenzen

netdata steeringdata check (Unterzeichner)

Prüfen Sie, ob die Lenkungsdaten einen Joiner mit einem bestimmten Discerner-Wert enthalten.

Parameter

netdata steeringdata check discerner
  • discerner: Die Joiner-Erkennung im Format {number}/{length}.

Beispiele

netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound

Befehlszeilen- und API-Referenzen

netdata steeringdata check (eui64)

Prüfen Sie, ob die Lenkungsdaten einen Joiner enthalten.

Parameter

netdata steeringdata check eui64
  • eui64: Der IEEE EUI-64 des Joiners.

Beispiele

netdata steeringdata check d45e64fa83f81cf7
Done

Befehlszeilen- und API-Referenzen

Netdata Unpublish (Präfix)

Hebt die Veröffentlichung eines zuvor veröffentlichten On-Mesh- oder externen Routenpräfixes auf.

OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE muss aktiviert sein.

Weitere Informationen finden Sie unter Display and Manage Network Data with OT CLI (Netzwerkdaten mit OT-Befehlszeile anzeigen und verwalten).

Parameter

netdata unpublish prefix

Beispiele

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

Befehlszeilen- und API-Referenzen

netdata unpublish dnssrp

Hebt die Veröffentlichung aller zuvor hinzugefügten DNS-/SRP-Diensteinträge (Anycast oder Unicast) aus den Thread-Netzwerkdaten auf.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE muss aktiviert sein.

Parameter

Keine Parameter.

Beispiele

netdata unpublish dnssrp
Done

Befehlszeilen- und API-Referenzen

Netstat

Ruft den Kopf der verknüpften Liste von UDP-Sockets ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

Netzwerkdiagnose abrufen

Sendet eine Netzwerkdiagnoseanfrage, um die angegebenen Typlängenwerte (Type Length Values, TLVs) für die angegebenen Adressen abzurufen.

Parameter

networkdiagnostic get addr type(s)

Bei addr löst eine Unicast-Adresse einen Diagnostic Get aus. Eine Multicast-Adresse löst einen Diagnostic Query aus. Sie können TLV-Werte angeben (durch Leerzeichen getrennt, wenn Sie mehr als einen TLV angeben):

  • 0: TLV der erweiterten MAC-Adresse
  • 1: Address16 TLV
  • 2: Modus TLV
  • 3: Zeitlimit TLV (maximaler Abfragezeitraum für SEDs)
  • 4: TLV-Verbindung
  • 5: Route64 TLV
  • 6: TLV für Leader-Daten
  • 7: Netzwerkdaten-TLV
  • 8: TLV6-Adressenliste
  • 9: MAC-Zähler – TLV
  • 14: TLV-Akkustand
  • 15: Versorgungsspannung TLV
  • 16: Untergeordnete Tabelle TLV
  • 17: TLV für Kanalseiten
  • 19: Maximales Zeitlimit für untergeordnete Elemente (TLV)
  • 23: EUI64 TLV
  • 24: Version TLV (Versionsnummer für die Protokolle und Funktionen)
  • 25: Name des Anbieters TLV
  • 26: Anbietermodell TLV
  • 27: SW-Version TLV des Anbieters
  • 28: Thread-Stack-Version TLV (Versionskennung als UTF-8-String für Thread-Stack-Codebase/commit/version)
  • 29: untergeordnetes TLV
  • 34: MLE-Zähler – TLV
  • 35: TLV der Anbieter-App-URL

Beispiele

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

Befehlszeilen- und API-Referenzen

Netzwerkdiagnose zurücksetzen

Sendet eine Netzwerkdiagnoseanfrage, um die angegebenen Typlängenwerte (Type Length Values, TLVs) für die angegebenen Adressen zurückzusetzen. Dieser Befehl unterstützt nur die folgenden TLV-Werte: 9 (MAC-Zähler-TLV) oder 34 (MLE-Zähler TLV)

Parameter

networkdiagnostic reset addr type(s)

Beispiele

networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done

Befehlszeilen- und API-Referenzen

networkidtimeout (get,set)

Ruft den Parameter NETWORK_ID_TIMEOUT ab oder legt ihn fest.

Parameter

networkidtimeout [timeout]

Verwenden Sie das optionale Argument timeout, um den Wert des Parameters NETWORK_ID_TIMEOUT festzulegen.

Beispiele

networkidtimeout 120
Done
networkidtimeout
120
Done

Befehlszeilen- und API-Referenzen

networkkey (Schlüssel)

Legen Sie den Thread-Netzwerkschlüssel fest.

Nur erfolgreich, wenn Thread-Protokolle deaktiviert sind. Durch einen erfolgreichen Aufruf dieser Funktion werden die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig.

Parameter

networkkey key

Beispiele

networkkey 00112233445566778899aabbccddeeff
Done

Befehlszeilen- und API-Referenzen

Netzwerkschlüssel

Rufen Sie den Thread-Netzwerkschlüssel ab.

Parameter

Keine Parameter.

Beispiele

networkkey
00112233445566778899aabbccddeeff
Done

Befehlszeilen- und API-Referenzen

Netzwerkname (Name)

Legen Sie den Thread-Netzwerknamen fest.

Nur erfolgreich, wenn Thread-Protokolle deaktiviert sind. Durch einen erfolgreichen Aufruf dieser Funktion werden die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig.

Parameter

networkname name

Beispiele

networkname OpenThread
Done

Befehlszeilen- und API-Referenzen

Netzwerkname

Rufen Sie den Thread-Netzwerknamen ab.

Parameter

Keine Parameter.

Beispiele

networkname
OpenThread
Done

Befehlszeilen- und API-Referenzen

networktime (festgelegt)

Legt die Parameter für die Zeitsynchronisierung fest.

  • timesyncperiod: Der Zeitraum der Synchronisierung in Sekunden.
  • xtalthreshold: Der Grenzwert für die XTAL-Genauigkeit, bis ein Gerät Router-fähiges Gerät wird (in PPM).

Parameter

networktime timesyncperiod xtalthreshold

Beispiele

networktime 100 300
Done

Befehlszeilen- und API-Referenzen

Netzwerkzeit

Ruft die Thread-Netzwerkzeit und die Zeitsynchronisierungsparameter ab.

Parameter

Keine Parameter.

Beispiele

networktime
Network Time:     21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold:   300ppm
Done

Befehlszeilen- und API-Referenzen

nexthop (get)

Ruft die nächsten Hop- und Pfadkosten für ein bestimmtes RLOC16-Ziel ab.

Kann verwendet werden, wenn aNextHopRloc16 oder aPathCost NULL ist, was bedeutet, dass der Aufrufer den Wert nicht abrufen möchte.

Parameter

nexthop rloc16

Beispiele

nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done

Befehlszeilen- und API-Referenzen

Nexthop

Ausgabetabelle mit zugewiesenen Router-IDs und den aktuellen Kosten für den nächsten Hop und Pfad für jeden Router.

Parameter

Keine Parameter.

Beispiele

nexthop
| ID   |NxtHop| Cost |
+------+------+------+
|    9 |    9 |    1 |
|   25 |   25 |    0 |
|   30 |   30 |    1 |
|   46 |    - |    - |
|   50 |   30 |    3 |
|   60 |   30 |    2 |
Done

Befehlszeilen- und API-Referenzen

Panid (Panid)

Legen Sie die IEEE 802.15.4-PAN-ID fest.

Nur erfolgreich, wenn Thread-Protokolle deaktiviert sind. Ein erfolgreicher Aufruf dieser Funktion macht auch die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig.

Parameter

panid panid

Beispiele

panid 0xdead
Done

Befehlszeilen- und API-Referenzen

Panid

Rufen Sie die IEEE 802.15.4-PAN-ID ab.

Parameter

Keine Parameter.

Beispiele

panid
0xdead
Done

Befehlszeilen- und API-Referenzen

parent

Rufen Sie die Diagnoseinformationen für einen Thread-Router als übergeordneten Router ab.

Wenn Sie als Thread-Router arbeiten und OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist, werden mit diesem Befehl die im Cache gespeicherten Informationen des Geräts zurückgegeben, das zuvor als untergeordnetes Thread-Konto verbunden war. Die Rückgabe von im Cache gespeicherten Informationen ist zur Unterstützung des Thread-Test-Harnischs – Testszenario 8.2.x erforderlich. Die vorherige übergeordnete MAC-Adresse (d. h. die MAC-Adresse von Joiner Router) wird angefordert, auch wenn das Gerät bereits zu einem Router hochgestuft wurde.

Parameter

Keine Parameter.

Beispiele

parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done

Befehlszeilen- und API-Referenzen

Startet den Prozess für das Kind, nach einem besseren Elternteil zu suchen, ohne mit dem aktuellen Elternteil verbunden zu bleiben.

Muss verwendet werden, wenn das Gerät als Kind angeschlossen ist.

Parameter

Keine Parameter.

Beispiele

parent search
Done

Befehlszeilen- und API-Referenzen

übergeordnete Priorität (get,set)

Ruft den zugewiesenen übergeordneten Prioritätswert 1, 0, -1 oder -2 ab oder legt ihn fest. -2 bedeutet nicht zugewiesen.

Parameter

parentpriority [parentpriority]

Beispiele

parentpriority
1
Done
parentpriority 1
Done

Befehlszeilen- und API-Referenzen

Partitions-ID

Rufen Sie die Thread-Netzwerkpartitions-ID ab.

Parameter

Keine Parameter.

Beispiele

partitionid
4294967295
Done

Befehlszeilen- und API-Referenzen

Partitions-ID bevorzugt (get,set)

Das Feld „OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE“ darf nicht leer sein.

Parameter

partitionid preferred partitionid

Beispiele

partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done

Befehlszeilen- und API-Referenzen

platform

Aktuelle Plattform drucken

Parameter

Keine Parameter.

Beispiele

platform
NRF52840
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Pollingperiod (get,set)

Benutzerdefinierte Datenabfragezeiträume für schläfriges Gerät (Millisekunden) abrufen oder festlegen Nur für die Zertifizierungsprüfung.

Parameter

Keine Parameter.

Beispiele

pollperiod
0
Done
pollperiod 10
Done

Befehlszeilen- und API-Referenzen

Preferredrouterid

Gibt die bevorzugte Router-ID an, die der Leader bei Anfrage angeben soll.

Parameter

preferrouterid routerid

Beispiele

preferrouterid 16
Done

Befehlszeilen- und API-Referenzen

Präfix hinzufügen

Fügt den Netzwerkdaten ein gültiges Präfix hinzu.

Parameter

prefix add prefix [padcrosnD] [high|med|low]

Die OT-Befehlszeile verwendet zugeordnete Argumente, um otBorderRouterConfig-Werte zu konfigurieren. Weitere Informationen finden Sie in der Übersicht zur OpenThread-Befehlszeile.

Beispiele

prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done

Befehlszeilen- und API-Referenzen

Präfix „MeshLocal“

Rufen Sie das lokale Präfix für das Mesh-Netzwerk ab.

Parameter

Keine Parameter.

Beispiele

prefix meshlocal
fdde:ad00:beef:0::/64
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Präfix

Rufen Sie die Präfixliste in den lokalen Netzwerkdaten ab.

Weitere Informationen zu den Flags otBorderRouterConfig finden Sie in der Übersicht über die OpenThread-Befehlszeile.

Parameter

Keine Parameter.

Beispiele

prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done

Befehlszeilen- und API-Referenzen

Präfix entfernen

Entfernen Sie eine Border-Router-Konfiguration aus den lokalen Netzwerkdaten.

Parameter

Keine Parameter.

Beispiele

prefix remove 2001:dead:beef:cafe::/64
Done

Befehlszeilen- und API-Referenzen

promiskuit (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den promiskuitiven Modus auf Linkebene.

Parameter

promiscuous enable|disable

Beispiele

promiscuous enable
Done
promiscuous disable
Done

Befehlszeilen- und API-Referenzen

promiskuit

Gibt an, ob der promiskuitive Modus auf der Linkebene aktiviert ist.

Parameter

Keine Parameter.

Beispiele

promiscuous
Disabled
Done

Befehlszeilen- und API-Referenzen

pskc (fest)

Legt den PSKC im Hexadezimalformat fest.

Parameter

pskc key

Beispiele

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

pskc–p

Erzeugt die PSKC-Datei aus der Passphrase (UTF-8-codiert) zusammen mit dem aktuellen Netzwerknamen und der erweiterten PAN-ID.

Parameter

pskc -p passphrase

Beispiele

pskc -p 123456
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

PSKC

Holen Sie sich den Thread-PSKc.

Parameter

Keine Parameter.

Beispiele

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

Befehlszeilen- und API-Referenzen

pskcref (fest)

Legen Sie die Schlüsselreferenz auf den Thread-PSKc fest.

Hierfür muss das Build-Zeitfeature OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE aktiviert sein.

Funktioniert nur, wenn Thread-Protokolle deaktiviert sind. Bei Erfolg werden dadurch auch die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig.

Parameter

pskc keyref

Beispiele

pskc 0x20017
Done

Befehlszeilen- und API-Referenzen

pskcref

Schlüsselreferenz zum gespeicherten Thread-PSKc abrufen.

Hierfür muss das Build-Zeitfeature OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE aktiviert sein.

Parameter

Keine Parameter.

Beispiele

pskcref
0x80000000
Done

Befehlszeilen- und API-Referenzen

Radio (aktivieren,deaktivieren)

Aktiviert oder deaktiviert das Radio.

Parameter

radio enable|disable

Beispiele

radio enable
Done
radio disable
Done

Befehlszeilen- und API-Referenzen

Radiostatistiken löschen

Setzt die Radiostatistik zurück.

Alle Zeitangaben werden auf 0 zurückgesetzt.

Parameter

Keine Parameter.

Beispiele

radio stats clear
Done

Befehlszeilen- und API-Referenzen

Radiostatistiken

Ruft die Radiostatistiken ab.

Die Radiostatistiken umfassen die Zeit, zu der sich das Radio im TX-, RX- oder Ruhemodus befindet. Diese Zeiten werden in Mikrosekundeneinheiten angegeben. Alle Zeiten werden ab dem letzten Zurücksetzen der Radiostatistiken berechnet.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

RPR-Version

Rufen Sie den Radioversionsstring ab.

Parameter

Keine Parameter.

Beispiele

rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun  4 2020 17:53:16
Done

Befehlszeilen- und API-Referenzen

Region (festgelegt)

Legt den Regionscode fest.

Das Format der Funkregion ist die 2-Byte-ASCII-Darstellung des Alpha-2-Codes nach ISO 3166.

Eine Änderung dieser Einstellung kann sich auf die Sendeleistungsgrenze auswirken.

Parameter

Keine Parameter.

Beispiele

region US
Done

Befehlszeilen- und API-Referenzen

Region

Rufen Sie den Regionscode ab.

Das Format der Funkregion ist die 2-Byte-ASCII-Darstellung des Alpha-2-Codes nach ISO 3166.

Parameter

Keine Parameter.

Beispiele

region
US
Done

Befehlszeilen- und API-Referenzen

Releaserouterid (Router-ID)

Geben Sie eine Router-ID frei, die vom Gerät mit der Rolle „Leader“ zugewiesen wurde.

Parameter

releaserouterid [routerid]

Beispiele

releaserouterid 16
Done

Befehlszeilen- und API-Referenzen

rloc16

Hol dir das RLOC16.

Parameter

Keine Parameter.

Beispiele

rloc16
0xdead
Done

Befehlszeilen- und API-Referenzen

Routen hinzufügen

Verwenden Sie für Parameter Folgendes:

  • s: Stabile Markierung
  • n: NAT64-Flag
  • prf: Einstellung des Standardrouters, [high, med, niedrig].

Fügen Sie den Netzwerkdaten eine gültige externe Route hinzu.

Parameter

route add prefix [sn] [high|med|low]

Beispiele

route add 2001:dead:beef:cafe::/64 s med
Done

Befehlszeilen- und API-Referenzen

Route entfernen

Entfernen Sie eine externe Routenkonfiguration aus den lokalen Netzwerkdaten.

Parameter

route remove [prefix]

Beispiele

route remove 2001:dead:beef:cafe::/64
Done

Befehlszeilen- und API-Referenzen

Route

Rufen Sie die Liste der externen Routen in den lokalen Netzwerkdaten ab.

Parameter

Keine Parameter.

Beispiele

route
2001:dead:beef:cafe::/64 s med
Done

Befehlszeilen- und API-Referenzen

Router (ID)

Die Funktion speichert Diagnoseinformationen für einen bestimmten Thread-Router.

Diagnoseinformationen für einen Thread-Router drucken. Die ID kann eine Router-ID oder ein RLOC16 sein.

Parameter

router [id]

Beispiele

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

Befehlszeilen- und API-Referenzen

Routerliste

Listen Sie die zugewiesenen Router-IDs auf.

Parameter

Keine Parameter.

Beispiele

router list
8 24 50
Done

Befehlszeilen- und API-Referenzen

Routertabelle

Gibt eine Liste der Router in einem Tabellenformat aus.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

routerdowngradethreshold (get,set)

Ruft den Wert ROUTER_DOWNGRADE_THRESHOLD ab oder legt ihn fest.

Parameter

routerdowngradethreshold [threshold]

Beispiele

 routerdowngradethreshold
23
Done
 routerdowngradethreshold 23
Done

Befehlszeilen- und API-Referenzen

Router-Berechtigung (aktivieren,deaktivieren)

Aktiviert oder deaktiviert die Routerrolle.

Parameter

routereligible [enable|disable]

Beispiele

routereligible enable
Done
routereligible disable
Done

Befehlszeilen- und API-Referenzen

Router zulässig

Gibt an, ob die Routerrolle aktiviert oder deaktiviert ist.

Parameter

Keine Parameter.

Beispiele

routereligible
Enabled
Done

Befehlszeilen- und API-Referenzen

Routerauswahljitter

Ruft den ROUTER_SELECTION_JITTER-Wert ab oder legt ihn fest.

Parameter

routerselectionjitter [jitter]

Beispiele

routerselectionjitter
120
Done
routerselectionjitter 120
Done

Befehlszeilen- und API-Referenzen

routerupgradethreshold (get,set)

Ruft den Wert ROUTER_UPGRADE_THRESHOLD ab oder legt ihn fest.

Parameter

routerupgradethreshold [threshold]

Beispiele

routerupgradethreshold
16
Done
routerupgradethreshold 16
Done

Befehlszeilen- und API-Referenzen

Energie scannen

Führt einen IEEE 802.15.4-Energiescan durch und zeigt die Zeit in Millisekunden an, die für den Scan jedes Kanals verwendet wird. Es werden alle Kanäle angezeigt, sofern Sie keinen bestimmten Kanal über die Kanaloption angeben.

Parameter

scan energy [duration] [channel]

Beispiele

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

Befehlszeilen- und API-Referenzen

Durchsuchen

Führt einen aktiven IEEE 802.15.4-Scan durch. Der Suchlauf deckt alle Kanäle ab, wenn kein Kanal angegeben wurde. Andernfalls deckt die Spanne nur den angegebenen Kanal ab.

Parameter

scan [channel]

Beispiele

scan
| PAN  | MAC Address      | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

Befehlszeilen- und API-Referenzen

Dienst hinzufügen

Fügt den Netzwerkdaten Dienst hinzu.

  • enterpriseNumber: IANA-Unternehmensnummer
  • serviceData: Hex-codierte Daten des binären Dienstes
  • serverData: Hex-codierte binäre Serverdaten

Parameter

service add enterpriseNumber serviceData serverData

Beispiele

service add 44970 112233 aabbcc
Done
netdata register
Done

Befehlszeilen- und API-Referenzen

Dienst entfernen

Entfernt den Dienst aus den Netzwerkdaten.

  • enterpriseNumber: IANA-Unternehmensnummer
  • serviceData: Hex-codierte Daten des binären Dienstes

Parameter

service remove enterpriseNumber serviceData

Beispiele

service remove 44970 112233
Done
netdata register
Done

Befehlszeilen- und API-Referenzen

Singleton

Gibt an, ob ein Knoten der einzige Router im Netzwerk ist. Gibt entweder true oder false zurück.

Parameter

Keine Parameter.

Beispiele

singleton
true
Done

Befehlszeilen- und API-Referenzen

sntp-Abfrage

Sendet eine SNTP-Abfrage, um die aktuelle Unix-Epoche-Zeit (vom 1. Januar 1970) abzurufen.

  • Standard-IP-Adresse des SNTP-Servers: 2001:4860:4806:8:: (Google IPv6 NTP-Server)
  • Standardport des SNTP-Servers: 123

Parameter

sntp query [SNTP server IP] [SNTP server port]

Beispiele

sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done

Befehlszeilen- und API-Referenzen

srp client autostart (get)

Zeigt den aktuellen Status des Autostartmodus an (aktiviert oder deaktiviert). Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

srp client autostart
Disabled
Done

Befehlszeilen- und API-Referenzen

srp-client autostart deaktivieren

Deaktiviert den Autostartmodus.

Durch das Deaktivieren des Autostartmodus wird ein ausgeführter Client nicht angehalten. Der SRP-Client beendet jedoch das Monitoring von Thread-Netzwerkdaten.

Parameter

Keine Parameter.

Beispiele

srp client autostart disable
Done

Befehlszeilen- und API-Referenzen

SRP-Client-Autostart aktivieren

Aktiviert den Autostartmodus.

Wenn die automatische Startfunktion aktiviert ist, überwacht der SRP-Client Thread-Netzwerkdaten, um SRP-Server zu erkennen, den bevorzugten Server auszuwählen und den Client automatisch zu starten und zu stoppen, wenn ein SRP-Server erkannt wird.

Es gibt drei Kategorien von Netzwerkdateneinträgen, die auf das Vorhandensein eines SRP-Servers hinweisen. Diese werden in der folgenden Reihenfolge bevorzugt:

  1. Unicast-Einträge, bei denen die Serveradresse in den Dienstdaten enthalten ist. Wenn mehrere Optionen vorhanden sind, wird die Option mit der niedrigsten numerischen IPv6-Adresse bevorzugt.
  2. Anycast-Einträge, die jeweils eine Sequenznummer haben Es wird die größte Sequenznummer gemäß Serial Number Arithmetic Logic in RFC-1982 bevorzugt.
  3. Unicast-Einträge, bei denen die Serveradresse in den Serverdaten enthalten ist. Wenn mehrere Optionen vorhanden sind, wird die Option mit der niedrigsten numerischen IPv6-Adresse bevorzugt.

Parameter

Keine Parameter.

Beispiele

srp client autostart enable
Done

Befehlszeilen- und API-Referenzen

srp-Client-Callback (get,enable,disable)

Ruft das Drucken von Callback-Ereignissen aus dem SRP-Client ab oder aktiviert/deaktiviert das Drucken von Callback-Ereignissen. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp client callback [enable|disable]

Beispiele

srp client callback enable
Done
srp client callback
Enabled
Done

Befehlszeilen- und API-Referenzen

srp-Client-Hostadresse (get)

Gibt an, ob der Modus für die automatische Adresse aktiviert ist. Wenn der automatische Adressmodus nicht aktiviert ist, wird die Liste der SRP-Client-Hostadressen zurückgegeben. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

srp-Client-Hostadresse (festgelegt)

Aktivieren Sie den automatischen Hostadressenmodus oder legen Sie die Liste der Hostadressen explizit fest. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp client host address [auto|address...]
  • Verwenden Sie den Parameter auto, um den automatischen Hostadressmodus zu aktivieren. Wenn diese Option aktiviert ist, verwendet der Client automatisch alle bevorzugten Thread-netif-Unicast-Adressen mit Ausnahme von Link-Local- und Mesh-Local-Adressen. Wenn keine gültige Adresse vorhanden ist, wird die lokale EID-Adresse des Mesh-Netzwerks hinzugefügt. Der SRP-Client wird automatisch neu registriert, wenn Adressen im Thread-netif hinzugefügt, entfernt oder als nicht bevorzugt markiert werden.
  • Geben Sie die Liste der Hostadressen explizit an und trennen Sie die einzelnen Adressen durch ein Leerzeichen. Sie können diese Liste festlegen, während der Client ausgeführt wird. Dadurch wird auch der Modus für die automatische Hostadresse deaktiviert.

Beispiele

srp client host address auto
Done
srp client host address fd00::cafe
Done

Befehlszeilen- und API-Referenzen

SrP-Client-Host gelöscht

Löscht alle Hostinformationen und alle Dienste.

Parameter

Keine Parameter.

Beispiele

srp client host clear
Done

Befehlszeilen- und API-Referenzen

srp-Client-Hostname (get,set)

Ruft den Hostnamen des SRP-Clients ab oder legt ihn fest. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp client host name [name]

Verwenden Sie den Parameter name, um den Client-Hostnamen festzulegen, wenn der Host entweder entfernt wurde oder noch nicht auf dem Server registriert ist.

Beispiele

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

Befehlszeilen- und API-Referenzen

SrP-Client-Host entfernen

Entfernt SRP-Client-Host-Informationen und alle Dienste vom SRP-Server. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp client host remove [removekeylease] [sendunregtoserver]
  • Der Parameter removekeylease ist ein optionaler boolescher Wert, der angibt, ob die Hostschlüsselfreigabe ebenfalls entfernt werden soll. Der Standardwert ist false.
  • Der Parameter sendunregtoserver ist ein optionaler boolescher Wert, der angibt, ob der Clienthost eine Aktualisierungsnachricht an den Server senden soll, auch wenn die Informationen zum Clienthost noch nicht beim Server registriert wurden (Standardwert ist false). Dieser Parameter kann nur angegeben werden, wenn der Parameter removekeylease zuerst im Befehl angegeben wurde.

Beispiele

srp client host remove 1
Done

Befehlszeilen- und API-Referenzen

srp-Client-Host

Ruft die Hostinformationen ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

srp-Client-Hoststatus

Gibt den Status des SRP-Clienthosts zurück Mögliche Status:

  • ToAdd: Element, das hinzugefügt/registriert werden soll.
  • Adding: Element wird hinzugefügt/registriert.
  • ToRefresh: Element, das für die Leasingverlängerung aktualisiert werden soll.
  • Refreshing: Element wird beig aktualisiert.
  • ToRemove: Element, das entfernt werden soll.
  • Removing: Element wird entfernt.
  • Registered: Das Element ist auf dem Server registriert.
  • Removed: Das Element wurde entfernt.

Parameter

Keine Parameter.

Beispiele

srp client host state
Registered
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

srp-client keyleaseinterval (get,set)

Ruft das Schlüsselfreigabeintervall in Sekunden ab oder legt es fest.

Parameter

srp client keyleaseinterval [interval]

Beispiele

srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done

Befehlszeilen- und API-Referenzen

srp-Client-Leaseinterval (get,set)

Ruft das Freigabeintervall in Sekunden ab oder legt es fest.

Parameter

srp client leaseinterval [interval]

Beispiele

srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done

Befehlszeilen- und API-Referenzen

srp-Client-Server-Adresse

Gibt die IPv6-Adresse des Servers zurück.

Parameter

Keine Parameter.

Beispiele

srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

SRP-Clientserver-Port

Gibt die Portnummer des Servers zurück.

Parameter

Keine Parameter.

Beispiele

srp client server port
4724
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

srp-Client-Server

Ruft die Socket-Adresse (IPv6-Adresse und Portnummer) des SRP-Servers ab, der vom SRP-Client verwendet wird. Wenn der Client nicht ausgeführt wird, ist die Adresse nicht angegeben (alle Nullen) mit der Portnummer 0. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

SRP-Clientdienst hinzufügen

Fügt einen Dienst mit einem bestimmten Instanznamen, Dienstnamen und einer Portnummer hinzu. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

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

Der Parameter servicename kann optional eine Liste von Labels für Dienstuntertypen enthalten, die durch Kommas getrennt sind. In den Beispielen werden allgemeine Bezeichnungen verwendet. Die Parameter priority und weight (beide sind Werte vom Typ uint16_t) sind optional. Wenn nicht angegeben, wird null verwendet. Der optionale Parameter txt legt die mit dem Dienst verknüpften TXT-Daten fest. Der Wert für txt muss im Hexadezimal-String-Format vorliegen und wird als bereits codierte TXT-Datenbyte-Sequenz behandelt.

Beispiele

srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done

Befehlszeilen- und API-Referenzen

srp-Clientdienstschlüssel (get,set)

Ruft den Einschlussmodus des Dienstschlüsseleintrags im SRP-Client ab oder legt ihn fest. Dieser Befehl ist nur für Testzwecke vorgesehen und erfordert, dass OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

srp client service key enable
Done
srp client service key
Enabled
Done

Befehlszeilen- und API-Referenzen

Name des SRP-Clientdiensts gelöscht

Löscht einen Dienst und entfernt ihn direkt aus der Clientdienstliste, ohne dass eine Interaktion mit dem SRP-Server stattfindet.

Parameter

srp client service clear instancename servicename

Beispiele

srp client service clear ins2 _test2._udp
Done

Befehlszeilen- und API-Referenzen

srp client service entfernen

Fordert die Abmeldung eines Dienstes auf dem SRP-Server an.

Parameter

srp client service remove instancename servicename

Beispiele

srp client service remove ins2 _test2._udp
Done

Befehlszeilen- und API-Referenzen

SRP-Client-Service

Ruft die Liste der Dienste ab, die vom Client verwaltet werden.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

SRP-Client starten

Startet den SRP-Clientvorgang. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp client start serveraddr serverport

Beispiele

srp client start fd00::d88a:618b:384d:e760 4724
Done

Befehlszeilen- und API-Referenzen

srp-Clientstatus

Gibt an, ob der SRP-Client ausgeführt wird oder nicht.

Parameter

Keine Parameter.

Beispiele

srp client state
Enabled
Done

Befehlszeilen- und API-Referenzen

srp-client stopp

Beendet den SRP-Clientvorgang.

Beendet alle weiteren Interaktionen mit dem SRP-Server. Beachten Sie, dass dadurch keine Hostinformationen und/oder eine Liste von Diensten entfernt oder gelöscht werden. Dadurch werden alle Dienste markiert, die nach dem (Neu-)Start des Clients wieder hinzugefügt/entfernt werden sollen.

Parameter

Keine Parameter.

Beispiele

srp client stop
Done

Befehlszeilen- und API-Referenzen

srp client ttl (get,set)

Ruft den ttl-Wert(Gültigkeitsdauer) in Sekunden ab oder legt ihn fest.

Parameter

srp client ttl [value]

Beispiele

srp client ttl 3600
Done
srp client ttl
3600
Done

Befehlszeilen- und API-Referenzen

Srp-Server (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den SRP-Server. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp server [enable|disable]

Beispiele

srp server disable
Done

Befehlszeilen- und API-Referenzen

srp-Server addrmode (get,set)

Ruft den vom SRP-Server verwendeten Adressmodus ab oder legt ihn fest.

Der Adressmodus teilt dem SRP-Server mit, wie er seine Adresse und Portnummer ermitteln soll. Diese werden dann in den Thread-Netzwerkdaten veröffentlicht.

Parameter

srp server addrmode [anycast|unicast]

Beispiele

srp server addrmode anycast
Done
srp server addrmode
anycast
Done

Befehlszeilen- und API-Referenzen

SRP-Server automatisch (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den automatischen Aktivierungsmodus auf dem SRP-Server.

Wenn dieser Modus aktiviert ist, steuert Border Routing Manager, ob und wann der SRP-Server aktiviert oder deaktiviert wird.

Für diesen Befehl muss OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE aktiviert sein. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

srp server auto [enable|disable]

Beispiele

srp server auto enable
Done
srp server auto
Enabled
Done

Befehlszeilen- und API-Referenzen

srp-Server-Domain (get,set)

Ruft den Domainnamen des SRP-Servers ab oder legt ihn fest.

Parameter

srp server domain [domain-name]

Beispiele

srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done

Befehlszeilen- und API-Referenzen

SRP-Serverhost

Gibt Informationen zu allen registrierten Hosts zurück Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

srp-Server-Lease (get,set)

Ruft die SRP-Serverfreigabewerte in Sekunden ab oder legt sie fest.

Parameter

srp server lease [min-lease max-lease min-key-lease max-key-lease]

Beispiele

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

Befehlszeilen- und API-Referenzen

srp-Server-Sequenz (get,set)

Ruft die mit dem Anycast-Adressmodus verwendete Sequenznummer ab oder legt sie fest. Die Sequenznummer ist im Eintrag „DNS/SRP-Dienst-Anycast-Adresse“ enthalten, der unter „Netzwerkdaten“ veröffentlicht wird.

Parameter

srp server seqnum [seqnum]

Beispiele

srp server seqnum 20
Done
srp server seqnum
20
Done

Befehlszeilen- und API-Referenzen

SRP-Serverdienst

Gibt Informationen zu registrierten Dienstleistungen zurück

Der Eintrag TXT wird als Array von Einträgen angezeigt. Wenn ein Eintrag einen Schlüssel enthält, wird der Schlüssel im ASCII-Format ausgegeben. Der Wertteil wird in hexadezimalen Byte ausgegeben. Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

SRP-Serverstatus

Gibt einen der folgenden möglichen Status des SRP-Servers zurück:

  • disabled: Der SRP-Server ist nicht aktiviert.
  • stopped: Der SRP-Server ist aktiviert, aber nicht aktiv, da vorhandene SRP-Server bereits im Thread-Netzwerk aktiv sind. Der SRP-Server wird möglicherweise aktiv, wenn die vorhandenen SRP-Server nicht mehr im Thread-Netzwerk aktiv sind.
  • running: Der SRP-Server ist aktiv und kann Dienstregistrierungen verarbeiten.

Weitere Informationen finden Sie im Hilfeartikel SRP-Server-Client-Konnektivität mit OT-CLI einrichten.

Parameter

Keine Parameter.

Beispiele

srp server state
running
Done

Befehlszeilen- und API-Referenzen

state

Gibt die aktuelle Rolle des Thread-Geräts zurück oder ändert die Rolle wie mit einer der Optionen angegeben. Mögliche Werte, die bei Anfragen zur Geräterolle zurückgegeben werden:

  • child: Das Gerät wird derzeit als untergeordnetes Thread-Element betrieben.
  • router: Das Gerät wird derzeit als Thread-Router betrieben.
  • leader: Das Gerät wird derzeit als Thread-Leader betrieben.
  • detached: Das Gerät ist derzeit nicht Teil eines Thread-Netzwerks bzw. einer Thread-Partition.
  • disabled: Der Thread-Stack ist derzeit deaktiviert.

Mit einer der Optionen können Sie die aktuelle Rolle eines Geräts ändern und dabei nicht den Status disabled ändern.

Parameter

state [child|router|leader|detached]

Beispiele

state
child
Done
state leader
Done

Befehlszeilen- und API-Referenzen

TCP-Abbrechen

Beendet die TCP-Verbindung, die mit dem Beispiel-TCP-Endpunkt verknüpft ist, und setzt den TCP-Endpunkt in den geschlossenen Status um.

Parameter

Keine Parameter.

Beispiele

tcp abort
TCP: Connection reset
Done

Befehlszeilen- und API-Referenzen

TCP-Benchmark-Ergebnis

Zeigt das letzte Ergebnis des TCP-Benchmark-Tests an. Mögliche Statuswerte:

  • Läuft
  • Abgeschlossen
  • Nicht getestet

Dieser Befehl ist in erster Linie zum Erstellen von Skripts gedacht, die den TCP-Benchmark-Test automatisieren.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

TCP-Benchmark-Ausführung

Überträgt die angegebene Anzahl von Byte über die TCP-Verbindung, die derzeit dem Beispiel-TCP-Endpunkt zugeordnet ist, der von der tcp-Befehlszeile bereitgestellt wird.

Parameter

tcp benchmark run [size]

Verwenden Sie den Parameter size, um die Anzahl der Byte anzugeben, die für die Benchmark gesendet werden sollen. Wenn Sie den Parameter size nicht verwenden, wird der Standardwert (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE) verwendet.

Beispiele

tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

TCP-Bindung

Verknüpft eine IPv6-Adresse und einen Port mit dem Beispiel-TCP-Endpunkt, der von der tcp-Befehlszeile bereitgestellt wird. Die Verknüpfung des TCP-Endpunkts mit einer IPv6-Adresse und einem IPv6-Port wird als „TCP-Endpunkt benennen“ bezeichnet. Dadurch wird der Endpunkt für die Kommunikation gebunden. Weitere Informationen finden Sie unter TCP-Funktionalität mit OT-CLI testen.

Parameter

tcp bind ip port
  • ip: IPv6-Adresse, an die gebunden werden soll. Wenn der TCP/IPv6-Stack die IPv6-Bindungsadresse zuweisen soll, verwenden Sie die nicht angegebene IPv6-Adresse: ::.
  • port: TCP-Portnummer, an die gebunden werden soll.

Beispiele

tcp bind :: 30000
Done

Befehlszeilen- und API-Referenzen

TCP Connect

Stellt eine Verbindung mit dem angegebenen Peer her.

Wenn der Verbindungsaufbau erfolgreich ist, wird die resultierende TCP-Verbindung dem TCP-Beispielendpunkt zugeordnet. Weitere Informationen finden Sie unter TCP-Funktionalität mit OT-CLI testen.

Parameter

tcp connect ip port [fastopen]
  • ip: IP-Adresse des Peers. Die Adresse kann eine IPv4-Adresse sein, die mit dem bevorzugten NAT64-Präfix aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn das bevorzugte NAT64-Präfix nicht verfügbar ist.
  • port: TCP-Portnummer des Peers.
  • fastopen: Dieser Parameter ist optional. Wenn die Richtlinie auf fast gesetzt ist, ist TCP Fast Open für diese Verbindung aktiviert. Wenn dieser Parameter auf slow gesetzt oder nicht verwendet wird, wird „TCP Fast Open“ deaktiviert.

Beispiele

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

Befehlszeilen- und API-Referenzen

TCP-Deinit

Deinitialisiert diesen TCP-Endpunkt.

Das bedeutet, dass OpenThread diesen TCP-Endpunkt nicht mehr verfolgt und alle Ressourcen aufgibt, die er intern für diesen TCP-Endpunkt zugewiesen hat. Die Anwendung kann den Arbeitsspeicher wiederverwenden, der den TCP-Endpunkt sichert.

Wenn sie einer aktiven TCP-Verbindung entspricht, wird die Verbindung ohne besonderes Verhalten beendet (wie in otTcpAbort()). Alle Ressourcen, die die Anwendung für diesen TCP-Endpunkt bereitgestellt hat (verknüpfte Zwischenspeicher für den Sendepuffer, Arbeitsspeicher für den Empfangspuffer, die aEndpoint-Struktur selbst usw.), werden sofort an die Anwendung zurückgegeben.

Parameter

Keine Parameter.

Beispiele

tcp deinit
Done

Befehlszeilen- und API-Referenzen

TCP-Init

Initialisiert den Beispiel-TCP-Listener und den Beispiel-TCP-Endpunkt, der von der tcp-Befehlszeile bereitgestellt wird.

Parameter

tcp init [mode] [size]
  • Der mode hat drei mögliche Werte:
    • tls: Gibt an, dass die TCP-Verbindung zwischen zwei Knoten auch das TLS-Protokoll zusätzlich zu TCP verwenden soll. Wenn zwei Knoten über TCP kommunizieren, müssen beide Knoten entweder TLS verwenden oder keiner der Knoten sollte TLS verwenden, da ein Nicht-TLS-Endpunkt nicht mit einem TLS-Endpunkt kommunizieren kann.
    • linked oder circular: Beide Optionen bedeuten, dass TLS nicht verwendet werden soll und der angegebene Zwischenspeichertyp für die TCP-Zwischenspeicherung verwendet werden sollte. Das Verhalten von linked und circular ist identisch. Überprüfen Sie den Code auf die Unterschiede zwischen diesen beiden Puffertypen. Zwei Endpunkte einer TCP-Verbindung sind nicht erforderlich, um denselben Puffertyp zu verwenden.
  • Der Parameter size legt die Größe des Empfangspuffers fest, der mit dem TCP-Beispielendpunkt verknüpft werden soll. Wenn nicht angegeben, wird die maximale Größe verwendet. Die maximale Größe wird in OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE festgelegt.

Beispiele

tcp init tls
Done

Befehlszeilen- und API-Referenzen

TCP Listener

Verwendet den Beispiel-TCP-Listener, um eingehende Verbindungen an der angegebenen IPv6-Adresse und dem angegebenen Port zu überwachen. Weitere Informationen finden Sie unter TCP-Funktionalität mit OT-CLI testen.

Parameter

tcp listen ip port

Folgende Parameter sind erforderlich:

  • ip: IPv6-Adresse oder die nicht angegebene IPv6-Adresse (::) des Beispiel-TCP-Listeners, der von der tcp-Befehlszeile bereitgestellt wird.
  • port: TCP-Port des TCP-Beispiel-Listeners. Wenn dem Beispiel-TCP-Endpunkt keine TCP-Verbindung zugeordnet ist, werden alle eingehenden Verbindungen, die mit der angegebenen IPv6-Adresse und dem angegebenen Port übereinstimmen, akzeptiert und mit dem TCP-Beispielendpunkt verknüpft.

Beispiele

tcp listen :: 30000
Done

Befehlszeilen- und API-Referenzen

TCP senden

Sendet Daten über die TCP-Verbindung, die mit dem Beispiel-TCP-Endpunkt verknüpft ist, der mit der tcp-Befehlszeile bereitgestellt wird. Weitere Informationen finden Sie unter TCP-Funktionalität mit OT-CLI testen.

Parameter

tcp send message

Der Parameter message enthält die Nachricht, die Sie an den Remote-TCP-Endpunkt senden möchten.

Beispiele

tcp send hello
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

TCP gesendet

Sendet das Signal „Ende des Streams“ über die TCP-Verbindung, die mit dem Beispiel-TCP-Endpunkt verknüpft ist, der von der tcp-Befehlszeile bereitgestellt wird. Dadurch wird der Peer darüber informiert, dass er über diese TCP-Verbindung keine weiteren Daten empfangen wird.

Parameter

Keine Parameter.

Beispiele

tcp sendend
Done

Befehlszeilen- und API-Referenzen

TCP-Stopp

Weist den TCP-Beispiel-Listener an, nicht mehr auf eingehende TCP-Verbindungen zu warten.

Parameter

Keine Parameter.

Beispiele

tcp stoplistening
Done

Befehlszeilen- und API-Referenzen

Threadstart

Startet den Thread-Protokollvorgang.

Parameter

Keine Parameter.

Beispiele

thread start
Done

Befehlszeilen- und API-Referenzen

Thread beenden

Beendet den Thread-Protokollvorgang.

Parameter

Keine Parameter.

Beispiele

thread stop
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Thread-Version

Ruft die Thread-Protokollversion ab.

Parameter

Keine Parameter.

Beispiele

 thread version
2
Done

Befehlszeilen- und API-Referenzen

Max. Zeit in Warteschlange

Ruft die maximale Zeit in der Warteschlange für Nachrichten in der TX-Warteschlange ab.

Erfordert OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Die Zeit in der Warteschlange wird nur für direkte Übertragungen verfolgt und bezieht sich auf die Zeit vom Hinzufügen einer Nachricht zur Übertragungswarteschlange bis zu ihrer Übergabe an die MAC-Ebene zur Übertragung oder zum Löschen der Nachricht.

Die erhobenen Statistiken können durch Aufrufen von otThreadResetTimeInQueueStat() zurückgesetzt werden.

Parameter

Keine Parameter.

Beispiele

timeinqueue max
281
Done

Befehlszeilen- und API-Referenzen

TimeInQueue zurücksetzen

Setzt die Statistiken für die Zeit in der TX-Warteschlange zurück.

Erfordert OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Parameter

Keine Parameter.

Beispiele

timeinqueue reset
Done

Befehlszeilen- und API-Referenzen

Timeinqueue

Ruft das Zeit-in-Warteschlangen-Histogramm für Nachrichten in der TX-Warteschlange ab.

Erfordert OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Histogramm der Zeit in der Warteschlange der Nachrichten in der Übertragungswarteschlange wird erfasst. Die Zeit in der Warteschlange wird nur für direkte Übertragungen verfolgt und bezieht sich auf die Zeit vom Hinzufügen einer Nachricht zur Übertragungswarteschlange bis zu ihrer Übergabe an die MAC-Ebene zur Übertragung oder zum Löschen der Nachricht.

Das Histogramm wird als Array von uint32_t-Werten mit aNumBins-Einträgen zurückgegeben. Der erste Eintrag im Array (bei Index 0) stellt die Anzahl der Nachrichten mit einer Zeit in der Warteschlange kleiner als aBinInterval dar. Der zweite Eintrag stellt die Anzahl der Nachrichten dar, deren Zeit in der Warteschlange größer oder gleich aBinInterval, aber kleiner als 2 * aBinInterval ist. Dies sind nur einige Beispiele für die Bedeutung von Data Governance. Der letzte Eintrag steht für die Anzahl der Nachrichten, deren Zeit in der Warteschlange größer oder gleich (aNumBins - 1) * aBinInterval ist.

Die erhobenen Statistiken können durch Aufrufen von otThreadResetTimeInQueueStat() zurückgesetzt werden. Die Histogramminformationen werden seit der Initialisierung der OpenThread-Instanz oder seit dem letzten Zurücksetzen der Statistikerfassung durch Aufrufen von otThreadResetTimeInQueueStat() erfasst.

Die Mauszeiger aNumBins und aBinInterval DÜRFEN NICHT NULL sein.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

trel (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den TREL-Funkbetrieb.

Parameter

trel enable|disable

Beispiele

trel enable
Done
trel disable
Done

Befehlszeilen- und API-Referenzen

Trel-Zähler zurückgesetzt

Setzt die TREL-Zähler zurück.

Parameter

Keine Parameter.

Beispiele

trel counters reset
Done

Befehlszeilen- und API-Referenzen

Trel-Zähler

Ruft die TREL-Zähler ab.

Parameter

Keine Parameter.

Beispiele

trel counters
Inbound:  Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done

Befehlszeilen- und API-Referenzen

trel-Filter (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den TREL-Filtermodus.

Parameter

trel filter enable|disable

Beispiele

trel filter enable
Done
trel filter disable
Done

Befehlszeilen- und API-Referenzen

trel-Filter

Gibt an, ob der TREL-Filtermodus aktiviert ist.

Wenn der Filtermodus aktiviert ist, wird der gesamte Rx- und Tx-Traffic, der über die TREL-Schnittstelle gesendet wird, ohne Meldung verworfen.

Parameter

Keine Parameter.

Beispiele

trel filter
Disabled
Done

Befehlszeilen- und API-Referenzen

Trel Peers

Ruft die TREL-Peer-Tabelle im Tabellen- oder Listenformat ab.

Parameter

trel peers [list]

Beispiele

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

Befehlszeilen- und API-Referenzen

Trel

Gibt an, ob der TREL-Vorgang aktiviert ist.

Parameter

Keine Parameter.

Beispiele

trel
Enabled
Done

Befehlszeilen- und API-Referenzen

tvcheck (aktivieren,deaktivieren)

Aktiviert oder deaktiviert die Thread-Versionsprüfung beim Upgrade auf einen Router oder Leader. Diese Prüfung ist standardmäßig aktiviert.

Parameter

Keine Parameter.

Beispiele

tvcheck enable
Done
tvcheck disable
Done

Befehlszeilen- und API-Referenzen

txpower (get,set)

Ruft die Sendeleistung in dBm ab (oder legt diese mit dem optionalen Argument txpower fest).

Parameter

txpower [txpower]

Beispiele

txpower -10
Done
txpower
-10 dBm
Done

Befehlszeilen- und API-Referenzen

UDP-Bindung

Weist einem offenen Socket eine IPv6-Adresse und einen Port zu, der den Socket für die Kommunikation bindet. Das Zuweisen der IPv6-Adresse und des IPv6-Ports wird als Benennung des Sockets bezeichnet. Weitere Informationen finden Sie unter UDP-Funktionalität mit OT-CLI testen.

Parameter

udp bind [netif] ip port
  • netif: Die Bindungsnetzwerkschnittstelle, die so bestimmt wird:
    • Kein Wert (Diesen Parameter aus dem Befehl weglassen): Es wird eine Thread-Netzwerkschnittstelle verwendet.
    • -u: Nicht angegebene Netzwerkschnittstelle. Dies bedeutet, dass der UDP/IPv6-Stack bestimmt, an welche Netzwerkschnittstelle der Socket gebunden wird.
    • -b: Backbone-Netzwerkschnittstelle wird verwendet.
  • ip: IPv6-Adresse, an die gebunden werden soll. Wenn Sie möchten, dass der UDP/IPv6-Stack die IPv6-Bindungsadresse zuweist, können Sie den folgenden Wert für die nicht angegebene IPv6-Adresse verwenden: ::. In jedem Beispiel wird die nicht angegebene IPv6-Adresse verwendet.
  • port: UDP-Portnummer, an die gebunden werden soll. In jedem der Beispiele wird die Portnummer 1234 verwendet.

Beispiele

udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done

Befehlszeilen- und API-Referenzen

UDP schließen

Schließen Sie einen UDP/IPv6-Socket.

Parameter

Keine Parameter.

Beispiele

udp close
Done

Befehlszeilen- und API-Referenzen

UDP Connect

Schließen Sie einen UDP/IPv6-Socket an.

Parameter

udp connect ip port

Folgende Parameter sind erforderlich:

  • ip: IP-Adresse des Peers.
  • port: UDP-Portnummer des Peers. Die Adresse kann eine IPv4-Adresse sein, die unter Verwendung des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn das bevorzugte NAT64-Präfix nicht verfügbar ist.

Beispiele

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

Befehlszeilen- und API-Referenzen

UDP-Linksecurity (aktivieren,deaktivieren)

Aktiviert oder deaktiviert die Linksicherheit.

Parameter

Keine Parameter.

Beispiele

udp linksecurity enable
Done
udp linksecurity disable
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

UDP Linksecurity

Gibt an, ob die Linksicherheit aktiviert oder deaktiviert ist.

Parameter

Keine Parameter.

Beispiele

udp linksecurity
Enabled
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

UDP öffnen

Öffnen Sie einen UDP/IPv6-Socket.

Parameter

Keine Parameter.

Beispiele

udp open
Done

Befehlszeilen- und API-Referenzen

UDP senden

Sendet eine UDP-Nachricht über den Socket. Weitere Informationen finden Sie unter UDP-Funktionalität mit OT-CLI testen.

Parameter

udp send [ip port] [type] value

ip und port sind als Paar optional. Wenn Sie jedoch eine Option angeben, müssen Sie auch eine andere angeben. Wenn ip und port nicht angegeben sind, wird die Socket-Peer-Adresse von udp connect verwendet.

  • ip: Zieladresse. Diese Adresse kann entweder eine IPv4- oder IPv6-Adresse sein. Eine IPv4-Adresse wird in eine IPv6-Adresse mit dem bevorzugten NAT64-Präfix aus den Netzwerkdaten synthetisiert. Wenn das bevorzugte NAT64-Präfix nicht verfügbar ist, gibt der Befehl InvalidState zurück.
  • port: UDP-Zielport.
  • Kombinationen type/value:
    • -t: Die Nutzlast im Parameter value wird als Text behandelt. Wenn kein type-Wert eingegeben wird, wird die Nutzlast im Parameter value ebenfalls als Text behandelt.
    • -s: Automatisch generierte Nutzlast mit der im Parameter value angegebenen Länge.
    • -x: Binärdaten im Hexadezimalformat, die im Parameter value angegeben sind.

Beispiele

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

Befehlszeilen- und API-Referenzen

unsicherer Abruf

Listet alle Ports aus der Liste der zulässigen ungesicherten Ports auf.

Parameter

Keine Parameter.

Beispiele

unsecure get
1234
Done

Befehlszeilen- und API-Referenzen

Unsecureport hinzufügen

Fügt der Liste der zulässigen ungesicherten Ports einen Port hinzu.

Parameter

unsecureport add port

Beispiele

unsecureport add 1234
Done

Befehlszeilen- und API-Referenzen

Unsecureport entfernen

Entfernt einen bestimmten Port oder alle Ports aus der Liste der zulässigen ungesicherten Ports.

Parameter

unsecureport remove port|all

Beispiele

unsecureport remove 1234
Done
unsecureport remove all
Done

Befehlszeilen- und API-Referenzen

Betriebszeit ms

Gibt die aktuelle Betriebszeit der Instanz (in ms) zurück.

Hierfür muss OPENTHREAD_CONFIG_UPTIME_ENABLE aktiviert sein.

Die Betriebszeit wird als Anzahl von Millisekunden seit der Initialisierung der OpenThread-Instanz angegeben.

Parameter

Keine Parameter.

Beispiele

uptime ms
426238
Done

Befehlszeilen- und API-Referenzen

uptime

Gibt die aktuelle Instanzlaufzeit als menschenlesbaren String zurück.

Hierfür muss OPENTHREAD_CONFIG_UPTIME_ENABLE aktiviert sein.

Der String hat das Format „::.“ für Stunden, Minuten, Sekunden und Millisekunde (wenn die Betriebszeit kürzer als ein Tag ist) oder „

d.::." (falls länger als ein Tag)

Wenn der resultierende String nicht in aBuffer (innerhalb der aSize-Zeichen) passt, wird der String abgeschnitten, aber der ausgegebene String wird immer mit Null beendet.

Parameter

Keine Parameter.

Beispiele

uptime
12:46:35.469
Done

Befehlszeilen- und API-Referenzen

Anbieter-App-URL (fest)

Legen Sie den URL-String der Anbieteranwendung fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorAppUrl muss UTF8-Code mit einer maximalen Länge von 64 Zeichen (MAX_VENDOR_APPL_URL_TLV_LENGTH) sein. \0-Zeichen sind nicht zulässig.

Parameter

vendor appurl url

Beispiele

vendor appurl http://www.example.com
Done

Befehlszeilen- und API-Referenzen

Anbieter-App-URL

Rufen Sie den URL-String der Anbieteranwendung ab.

Parameter

Keine Parameter.

Beispiele

vendor appurl
http://www.example.com
Done

Befehlszeilen- und API-Referenzen

Anbietermodell (fest)

Legen Sie den String des Anbietermodells fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorModel muss UTF8-Code mit einer maximalen Länge von 32 Zeichen (MAX_VENDOR_MODEL_TLV_LENGTH) sein. \0-Zeichen sind nicht zulässig.

Parameter

vendor model name

Beispiele

vendor model Hub\ Max
Done

Befehlszeilen- und API-Referenzen

Anbietermodell

Rufen Sie den Modellstring des Anbieters ab.

Parameter

Keine Parameter.

Beispiele

vendor model
Hub Max
Done

Befehlszeilen- und API-Referenzen

Anbietername (fest)

Legen Sie den String für den Anbieternamen fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorName muss UTF8-Code mit einer maximalen Länge von 32 Zeichen (MAX_VENDOR_NAME_TLV_LENGTH) sein. \0-Zeichen sind nicht zulässig.

Parameter

vendor name name

Beispiele

vendor name nest
Done

Befehlszeilen- und API-Referenzen

Anbietername

Rufen Sie den String des Anbieternamens ab.

Parameter

Keine Parameter.

Beispiele

vendor name
nest
Done

Befehlszeilen- und API-Referenzen

swversion des Anbieters (festgelegt)

Legen Sie den String für die Softwareversion des Anbieters fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorSwVersion sollte UTF8-Code mit einer maximalen Länge von 16 Zeichen(MAX_VENDOR_SW_VERSION_TLV_LENGTH) sein. \0-Zeichen sind nicht zulässig.

Parameter

vendor swversion version

Beispiele

vendor swversion Marble3.5.1
Done

Befehlszeilen- und API-Referenzen

swVersion des Anbieters

Rufen Sie den String der Softwareversion des Anbieters ab.

Parameter

Keine Parameter.

Beispiele

vendor swversion
Marble3.5.1
Done

Befehlszeilen- und API-Referenzen

Verhoeff berechnen

Berechnet die Verhoeff-Prüfsumme für eine gegebene Dezimalzeichenfolge.

Erfordert OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

Parameter

verhoeff calculate decimalstring

Beispiele

verhoeff calculate 30731842
1
Done

Befehlszeilen- und API-Referenzen

Verhoeff validieren

Validiert die Verhoeff-Prüfsumme für einen gegebenen Dezimalstring.

Erfordert OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

Parameter

verhoeff validate decimalstring

Beispiele

verhoeff validate 307318421
Done

Befehlszeilen- und API-Referenzen

API-Version

Gibt die API-Versionsnummer aus.

Parameter

Keine Parameter.

Beispiele

version api
28
Done

Befehlszeilen- und API-Referenzen

  • Keine verknüpfte API

Version

Ruft den OpenThread-Versionsstring ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen