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 letztenbufferinfo 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
Childrouter-Links (get,set)
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ätigtnon-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ätigtnon-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
oderblock-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ätigtnon-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 oderresponse
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 Millisekundenack_random_factor_numerator
: 3ack_random_factor_denominator
: 2max_retransmit
: 4
ack_timeout
: DieACK_TIMEOUT
(0-UINT32_MAX) in Millisekunden. Weitere Informationen finden Sie in RFC 7252.ack_random_factor_numerator
: Der ZählerACK_RANDOM_FACTOR
mit möglichen Werten zwischen 0 und 255. Weitere Informationen finden Sie in RFC 7252.ack_random_factor_denominator
: Der Nenner vonACK_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ätigtnon-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
oderblock-1024
.
payload
: CoAP-Nutzlastanfrage, die je nachtype
entweder ein String oder eine Ganzzahl ist. Wenntype
den Wertcon
odernon-con
hat, ist der Parameterpayload
optional. Wenn Sie den Parameterpayload
weglassen, wird eine leere Nutzlast gesendet. Wenn Sie den Parameterpayload
verwenden, muss sein Wert jedoch ein String wiehellothere
sein. Wenntype
den Wertblock-
hat, muss der Wert des Parameterspayload
eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typblock-
mussOPENTHREAD_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ätigtnon-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
oderblock-1024
.
payload
: CoAP-Nutzlastanfrage, die je nachtype
entweder ein String oder eine Ganzzahl ist. Wenntype
den Wertcon
odernon-con
hat, ist der Parameterpayload
optional. Wenn Sie den Parameterpayload
weglassen, wird eine leere Nutzlast gesendet. Wenn Sie den Parameterpayload
verwenden, muss sein Wert jedoch ein String wiehellothere
sein. Wenntype
den Wertblock-
hat, muss der Wert des Parameterspayload
eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typblock-
mussOPENTHREAD_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ätigtnon-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ätigtnon-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
oderblock-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ätigtnon-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
oderblock-1024
.
payload
: CoAPS-Nutzlastanfrage, die je nachtype
entweder ein String oder eine Ganzzahl ist. Wenntype
den Wertcon
odernon-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 wiehellothere
sein. Wenntype
den Wertblock-
hat, muss der Wert des Nutzlastparameters eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typblock-
mussOPENTHREAD_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üsselpsk-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ätigtnon-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
oderblock-1024
.
payload
: CoAPS-Nutzlastanfrage, die je nachtype
entweder ein String oder eine Ganzzahl ist. Wenntype
den Wertcon
odernon-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 wiehellothere
sein. Wenntype
den Wertblock-
hat, muss der Wert des Nutzlastparameters eine Ganzzahl sein, die die Anzahl der zu sendenden Blöcke angibt. Für den Typblock-
mussOPENTHREAD_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
auftrue
hat denselben Effekt wie das Weglassen des Arguments, nämlich dass der Wert voncheck-peer-cert
true
und der Wertmax-conn-attempts
0 ist. check-peer-cert
wird auffalse
festgelegt: Dercheck-peer-cert
-Wert istfalse
und dermax-conn-attempts
-Wert ist 0.- Angabe einer Zahl:
check-peer-cert
isttrue
und der Wertmax-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 Formatnumber/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 Formatnumber/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
odernetworkkey
. - 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
- otDatasetSendMgmtActiveGet
- Befehl "dataset mgmtget" ausstehend
- Dataset mgmtsetcommand aktiv
- Befehl "dataset mgmtset" ausstehend
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
- otDatasetSendMgmtPendingGet
- Dataset mgmtgetcommand aktiv
- Dataset mgmtsetcommand aktiv
- Befehl "dataset mgmtset" ausstehend
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
- otDatasetSendMgmtActiveSet
- Dataset mgmtgetcommand aktiv
- Befehl "dataset mgmtget" ausstehend
- Befehl "dataset mgmtset" ausstehend
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
- otDatasetSendMgmtPendingSet
- Dataset mgmtgetcommand aktiv
- Befehl "dataset mgmtget" ausstehend
- Dataset mgmtsetcommand aktiv
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]]
- Verwenden Sie
rotationtime
fürthrKeyRotation
in Stunden. - Sicherheitsrichtlinienbefehle verwenden die Argumentzuordnungen
onrcCepR
zum Abrufen und Festlegen von otSecurityPolicy-Mitgliedern.o
steht beispielsweise für otSecurityPolicy::mretrieveNetworkKeyEnabled. Weitere Informationen finden Sie unter Datasets mit OT-CLI anzeigen und verwalten.
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
undRemoved
. - Adresse/Präfixlänge: Unicast-Adresse mit ihrer Präfixlänge (in Bit).
- Ursprung: Mögliche Werte sind
thread
,slaac
,dhcp6
odermanual
. - 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
undUnsubscribed
. - Multicast-Adresse
- Ursprung: Mögliche Werte sind
Thread
undManual
.
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
oderRouter
ein. - Ereignis: Mögliche Werte sind
Added
,Removed
oderChanged
. - 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
oderdisabled
. - 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
undRemoved
. - Präfix
- Markierungen/Bedeutung:
p
: bevorzugtes Flaga
: 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
oderlow
. - 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
undRemoved
. - Route
- Markierungen/Bedeutung:
s
: stabiles Flag.n
: NAT64-Flag.
- Präf.: Präferenz. Mögliche Werte sind
high
,med
oderlow
. - 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
oderCostChanged
. - 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 Wertinf
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
undICMP6
(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).
- IPv6-Nachrichtentyp, z. B.
- 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
odernet
(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 mitTX-F
im Tabellenformat odertx-success:no
im Listenformat angegeben. Beispiele für fehlgeschlagene Übertragungen sindtx
, wenn die Übertragung abgebrochen wird, und keineack
, 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 als0xffff
angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie alsunknwn
im Tabellenformat oder als0xfffe
im Listenformat angezeigt. - Radio: Radiolink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn
OPENTHREAD_CONFIG_MULTI_RADIO
aktiviert ist). Kann15.4
,trel
oderall
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
undICMP6
(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).
- IPv6-Nachrichtentyp, z. B.
- 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
odernet
(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 mitTX-F
im Tabellenformat odertx-success:no
im Listenformat angegeben. Beispiele für fehlgeschlagene Übertragungen sindtx
, wenn die Übertragung abgebrochen wird, und keineack
, 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 als0xffff
angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie alsunknwn
im Tabellenformat oder als0xfffe
im Listenformat angezeigt. - Radio: Radiolink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn
OPENTHREAD_CONFIG_MULTI_RADIO
aktiviert ist). Kann15.4
,trel
oderall
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
undICMP6
(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).
- IPv6-Nachrichtentyp, z. B.
- 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
odernet
(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 mitTX-F
im Tabellenformat odertx-success:no
im Listenformat angegeben. Beispiele für fehlgeschlagene Übertragungen sindtx
, wenn die Übertragung abgebrochen wird, und keineack
, 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 als0xffff
angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie alsunknwn
im Tabellenformat oder als0xfffe
im Listenformat angezeigt. - Radio: Radiolink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn
OPENTHREAD_CONFIG_MULTI_RADIO
aktiviert ist). Kann15.4
,trel
oderall
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
: kannthread
,slaac
,dhcp6
odermanual
sein und gibt den Ursprung der Adresse anplen
: Präfixlängepreferred
: 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}
, umdiscerner
festzulegen. joiner discerner clear
setztaDiscerner
aufnullptr
.
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.
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
unda
] sind otLinkMetricsSeriesFlags zugeordnet.X
steht für keinen derotLinkMetricsSeriesFlags
, 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
undr
] 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
undr
] 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,
oderDisabled
- 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: entwederAllowList
,DenyList,
oderDisabled
- 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 dierss
so eingestellt wurde, dass sie sich vom Standardwert unterscheidet. Default rss
: Zeigt gegebenenfalls die Standardwerte für die Einstellungenrss
undlqi
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ürrss
undlqi
sind einander zugeordnet. Wenn Sie eines festlegen, wird der Wert der anderen automatisch festgelegt. Diese Adressenliste wird alsRssIn List
bezeichnet. Wenn Sie entwederrsi
oderlqi
festlegen, wird die entsprechende erweiterte Adresse der ListeRssIn
hinzugefügt. Default rss
: Zeigt gegebenenfalls die Standardwerte für die Einstellungenrss
undlqi
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 hat2-links
: Router-IDs, zu denen dieser Router eine eingehende Verbindung mit Linkqualität 2 hat1-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ätn
: 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 aktiviertD
: Full-Thread-GerätN
: 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)
- netdata Publish dnssrp Unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
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)
- Netdata Publish dnssrp Anycast
- otNetDataPublishDnsSrpServiceUnicast
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 dnssrp unicast (addr,port)
- Netdata Publish dnssrp Anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
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-Adresse1
: Address16 TLV2
: Modus TLV3
: Zeitlimit TLV (maximaler Abfragezeitraum für SEDs)4
: TLV-Verbindung5
: Route64 TLV6
: TLV für Leader-Daten7
: Netzwerkdaten-TLV8
: TLV6-Adressenliste9
: MAC-Zähler – TLV14
: TLV-Akkustand15
: Versorgungsspannung TLV16
: Untergeordnete Tabelle TLV17
: TLV für Kanalseiten19
: Maximales Zeitlimit für untergeordnete Elemente (TLV)23
: EUI64 TLV24
: Version TLV (Versionsnummer für die Protokolle und Funktionen)25
: Name des Anbieters TLV26
: Anbietermodell TLV27
: SW-Version TLV des Anbieters28
: Thread-Stack-Version TLV (Versionskennung als UTF-8-String für Thread-Stack-Codebase/commit/version)29
: untergeordnetes TLV34
: MLE-Zähler – TLV35
: 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
Suche nach Eltern
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:
- 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.
- Anycast-Einträge, die jeweils eine Sequenznummer haben Es wird die größte Sequenznummer gemäß Serial Number Arithmetic Logic in RFC-1982 bevorzugt.
- 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 istfalse
. - 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 istfalse
). Dieser Parameter kann nur angegeben werden, wenn der Parameterremovekeylease
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
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
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
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
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 gibtInvalidState
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 auffast
gesetzt ist, ist TCP Fast Open für diese Verbindung aktiviert. Wenn dieser Parameter aufslow
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
odercircular
: Beide Optionen bedeuten, dass TLS nicht verwendet werden soll und der angegebene Zwischenspeichertyp für die TCP-Zwischenspeicherung verwendet werden sollte. Das Verhalten vonlinked
undcircular
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 inOPENTHREAD_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 dertcp
-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 gibtInvalidState
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 BefehlInvalidState
zurück.port
: UDP-Zielport.- Kombinationen
type
/value
:-t
: Die Nutzlast im Parametervalue
wird als Text behandelt. Wenn keintype
-Wert eingegeben wird, wird die Nutzlast im Parametervalue
ebenfalls als Text behandelt.-s
: Automatisch generierte Nutzlast mit der im Parametervalue
angegebenen Länge.-x
: Binärdaten im Hexadezimalformat, die im Parametervalue
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 „
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