CLI-Befehlsreferenz

BA Ephemeralkey

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

• otBorderAgentIsEphemeralKeyActive

ba sitzungsspezifischerkey Callback (aktivieren, deaktivieren)

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

Erfordert OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Ein nachfolgender Aufruf dieser Funktion ersetzt alle zuvor festgelegten Callbacks.

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

• otBorderAgentSetEphemeralKeyCallback

Ba ephemeralkey Clear

Bricht den sitzungsspezifischen Schlüssel ab, der verwendet wird.

Erfordert OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Kann verwendet werden, um einen zuvor festgelegten sitzungsspezifischen Schlüssel abzubrechen, 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 sein Status durch das Aufrufen dieser Funktion nicht geändert. In diesem Fall gibt otBorderAgentIsEphemeralKeyActive() so lange TRUE zurück, bis die Verbindung vom Commissioner getrennt wird.

Parameter

Keine Parameter.

Beispiele

ba ephemeralkey clear
Done

Befehlszeilen- und API-Referenzen

• otBorderAgentClearEphemeralKey

sitzungsspezifischer Schlüssel festgelegt: [timeout-in-msec] [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 Grenzagent bereits ausgeführt wird und derzeit nicht mit einem externen Provisioner 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 (ohne das abschließende Null-Zeichen \0). Die aKeyString-Länge muss zwischen OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH und OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH liegen.

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

Während das Zeitlimit gilt, kann der sitzungsspezifische Schlüssel von einem externen Dienstleister nur einmal für die Verbindung verwendet werden. Sobald der Auftraggeber die Verbindung trennt, 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

• otBorderAgentSetEphemeralKey

ba id (get,set)

Ruft die 16-Byte-Border-Router-ID ab oder legt sie fest, mit der das Gerät unter mehreren BRs 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

• otBorderAgentGetId
• otBorderAgentSetId

Ba Port

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

Parameter

Keine Parameter.

Beispiele

ba port
49153
Done

Befehlszeilen- und API-Referenzen

• otBorderAgentGetUdpPort

B.A. State

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

Parameter

Keine Parameter.

Beispiele

ba state
Started
Done

Befehlszeilen- und API-Referenzen

• otBorderAgentGetState

BBR

Gibt die Informationen des aktuellen primären Backbone-Routers 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 (fest)

Legt die Konfiguration des lokalen Backbone-Routers otBackboneRouterConfig fest.

Die Nachricht SRV_DATA.ntf zu Serverdatenanfragen wird automatisch initiiert, wenn sich das BBR-Dataset für den primären Backbonerouter ändert.

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

bbr register muss explizit ausgestellt werden, um den Backbone-Router-Dienst als Leader für den 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

• otBackboneRouterSetConfig

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

• otBackboneRouterGetConfig

bbr deaktivieren

Aktiviert oder deaktiviert die Backbone-Funktionalität.

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

Wenn diese Option deaktiviert ist, 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

• otBackboneRouterSetEnabled

bbr aktivieren

Aktiviert oder deaktiviert die Backbone-Funktionalität.

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

Wenn diese Option deaktiviert ist, 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

• otBackboneRouterSetEnabled

BBR-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

• otBackboneRouterGetRegistrationJitter
• otBackboneRouterSetRegistrationJitter

BBR Management

Mit dem meshLocalIid wird mit diesem Befehl der Antwortstatus für die nächste DUA-Registrierung konfiguriert. Ohne meshLocalIid auf die nächste „DUA.req“-Anfrage mit dem angegebenen status oder coap-code antworten.

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 (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

• otBackboneRouterConfigNextDuaRegistrationResponse

BBR mgmt mlr Listener hinzufügen

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

Übergeben Sie 0, um das MLR-Standardzeitlimit 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

• otBackboneRouterMulticastListenerAdd

BR-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

• otBackboneRouterMulticastListenerGetNext

BBR-Marketingpartner MLR-Listener verständlich

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

• otBackboneRouterMulticastListenerClear

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

Verwende für status-code Folgendes:

• 0: ST_MLR_ERFOLG
• 2: ST_MLR_INVALID (ST_MLR_INVALID)
• 3: ST_MLR_NO_PERSISTENT
• 4: ST_MLR_NO_RESOURCES (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

• otBackboneRouterConfigNextMulticastListenerRegistrationResponse

BBR Register

Registriert die Konfiguration des lokalen Backbone-Routers explizit.

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

Verfügbar, wenn OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

bbr register
Done

Befehlszeilen- und API-Referenzen

• otBackboneRouterRegister

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

• otBackboneRouterGetState

BR deaktivieren

Deaktiviert den Border Routing Manager.

Parameter

Keine Parameter.

Beispiele

br disable
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingSetEnabled

br aktivieren

Aktiviert den Border Routing Manager.

Parameter

Keine Parameter.

Beispiele

br enable
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingSetEnabled

BR init

Initialisiert den Border Routing Manager.

Parameter

br init infrastructure-network-index is-running

Beispiele

br init 2 1
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingInit

br nat64prefix

Gibt lokale und 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

• otBorderRoutingGetNat64Prefix
• otBorderRoutingGetFavoredNat64Prefix

br nat64prefix bevorzugt

Ruft das aktuell bevorzugte NAT64-Präfix ab.

Das bevorzugte NAT64-Präfix kann über den Infrastrukturlink ermittelt werden 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

• otBorderRoutingGetFavoredNat64Prefix

br nat64prefix lokal

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

Das NAT64-Präfix wird möglicherweise nicht im Thread-Netzwerk 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

• otBorderRoutingGetNat64Prefix

br omrprä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

• otBorderRoutingGetOmrPrefix
• otBorderRoutingGetFavoredOmrPrefix

br omrpräfix bevorzugt

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

Das bevorzugte OMR-Präfix kann in den 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

• otBorderRoutingGetFavoredOmrPrefix

br omrprefix 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, sofern noch kein OMR-Präfix vorhanden ist. Dieses Präfix ist über das lokale WLAN oder Ethernet erreichbar.

Hinweis :Wenn DHCPv6 PD aktiviert ist, veröffentlicht der Border-Router möglicherweise das Präfix des DHCPv6 PD.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetOmrPrefix

br onlinkprefix

Gibt lokale und bevorzugte On-Link-Präfixe aus.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetOnLinkPrefix
• otBorderRoutingGetFavoredOnLinkPrefix

br onlinkprefix bevorzugt

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

Das bevorzugte Präfix ist entweder ein erkanntes Präfix der Verbindung auf dem Infrastrukturlink oder das Präfix der lokalen Verbindung.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetFavoredOnLinkPrefix

br onlinkprefix lokal

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

Das lokale On-Link-Präfix ist ein 64-Bit-Präfix, das auf dem Infrastrukturlink beworben wird, wenn noch kein verwendbares On-Link-Präfix vorhanden ist.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetOnLinkPrefix

br pd (aktivieren,deaktivieren)

Aktiviert / deaktiviert die DHCPv6-Präfixdelegierung.

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE muss aktiviert sein.

Parameter

br pd enable|disable

Beispiele

br pd enable
Done

br pd disable
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingDhcp6PdSetEnabled

br pd omrprefix

Ruft das von DHCPv6 Prefix Delegation (PD) bereitgestellte Präfix für das Off-Mesh-Routable (OMR) ab.

In den zurückgegebenen Präfixinformationen werden nur die Felder mPrefix, mValidLifetime und mPreferredLifetime verwendet.

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE muss aktiviert sein.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetPdOmrPrefix

BR PD-Status

Ruft den aktuellen Status der DHCPv6-Präfixdelegierung ab.

Hierfür muss OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE aktiviert sein.

Parameter

Keine Parameter.

Beispiele

br pd state
running
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingDhcp6PdGetState

br Peers

Rufen Sie die Liste der Peer-BRs ab, die in Netzwerkdateneinträgen gefunden wurden. Das Feld „OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE“ darf nicht leer sein. Peer-BRs sind andere Geräte innerhalb des Thread-Mesh, die externe IP-Verbindungen bereitstellen. Es wird davon ausgegangen, dass ein Gerät eine externe IP-Verbindung bereitstellt, wenn mindestens eine der folgenden Bedingungen bezüglich seiner Netzwerkdateneinträge erfüllt ist:

• Es wurde mindestens ein externer Routeneintrag hinzugefügt.
• Es wurde mindestens ein Präfixeintrag hinzugefügt, in dem sowohl das Flag „default-route“ als auch das Flag „on-mesh“ festgelegt ist.
• Es wurde mindestens ein Domainpräfix hinzugefügt, wobei sowohl die Domain- als auch die On-Mesh-Flags festgelegt sind. In der Liste der AF-Vergleiche ist das aktuelle Gerät ausgeschlossen, auch wenn es selbst als AF fungiert. Informationen pro Eintrag im AF:
• RLOC16 in Brasilien
• Alter als Dauerintervall, seit diese AF in den Netzwerkdaten angezeigt wurde. Sie ist als {hh}:{mm}:{ss} für Stunden, Minuten und Sekunden formatiert, wenn die Dauer weniger als 24 Stunden beträgt. Bei einer Dauer von mindestens 24 Stunden wird {dd}d.{hh}:{mm}:{ss} für Tage, Stunden, Minuten, Sekunden verwendet.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetNextPrefixTableEntry

Anzahl der BR-Peers

Gibt die Anzahl der Peer-BRs zurück, die in den Netzwerkdaten gefunden wurden.

Erfordert OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.

Peer-BRs sind andere Geräte innerhalb des Thread-Mesh, die externe IP-Verbindungen bereitstellen. Es wird davon ausgegangen, dass ein Gerät eine externe IP-Verbindung bereitstellt, wenn mindestens eine der folgenden Bedingungen bezüglich seiner Netzwerkdateneinträge erfüllt ist:

• Es wurde mindestens ein externer Routeneintrag hinzugefügt.
• Es wurde mindestens ein Präfixeintrag hinzugefügt, in dem sowohl das Flag „default-route“ als auch das Flag „on-mesh“ festgelegt ist.
• Es wurde mindestens ein Domainpräfix hinzugefügt, wobei sowohl die Domain- als auch die On-Mesh-Flags festgelegt sind.

In der Liste der AF-Vergleiche ist das aktuelle Gerät ausgeschlossen, auch wenn es selbst als AF fungiert.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingCountPeerBrs

br Präfixtabelle

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

• Das Präfix
• Angabe, ob sich das Präfix im Link oder auf der Route befindet
• Millisekunden seit dem letzten empfangenen Router-Advertising mit diesem Präfix
• Präfixlebensdauer in Sekunden
• Bevorzugte Lebensdauer in Sekunden, nur wenn das Präfix per Link bereitgestellt wird
• Routeneinstellung (niedrig, mittel, hoch) nur, wenn das Präfix eine Route ist (nicht eine Verbindung auf dem Link)
• 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 des Stub-Routers (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

• otBorderRoutingGetNextPrefixTableEntry

br raoptions (set,clear)

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

Der Inhalt von aOptions wird intern kopiert, sodass er ein temporärer Zwischenspeicher sein kann (z.B. ein vom Stapel zugewiesenes Array).

Durch nachfolgende Aufrufe dieser Funktion wird der zuvor festgelegte Wert überschrieben.

Parameter

br raoptions options|clear

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

Beispiele

br raoptions 0400ff00020001
Done

br raoptions clear
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingSetExtraRouterAdvertOptions

br rioprf (hoch,mittel,niedrig)

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

Nach einem Aufruf dieser Funktion verwendet BR die angegebene Präferenz für alle beworbenen RIOs. Du kannst die Einstellung durch Aufrufen von otBorderRoutingClearRouteInfoOptionPreference() löschen.

Parameter

br rioprf [high|med|low]

Beispiele

br rioprf low
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingSetRouteInfoOptionPreference

Br Rioprf

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

Die RIO-Präferenz wird so festgelegt:

• Wurde die Einstellung durch den Nutzer explizit durch Aufrufen von otBorderRoutingSetRouteInfoOptionPreference() festgelegt, wird die angegebene Einstellung verwendet.
• Andernfalls wird sie anhand der aktuellen Rolle des Geräts ermittelt: mittlere Präferenz bei Router/Leader-Rolle und geringe Präferenz bei Kinderrolle.

Parameter

Keine Parameter.

Beispiele

br rioprf
med
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetRouteInfoOptionPreference

Br Rioprf klar

Löscht einen zuvor festgelegten Einstellungswert für beworbene Routeninformationen.

Nach einem Aufruf dieser Funktion verwendet die AF die Geräterolle, um die RIO-Präferenz zu bestimmen: mittlere Präferenz in der Router-/Leader-Rolle und niedrige Präferenz in Kinderrolle.

Parameter

Keine Parameter.

Beispiele

br rioprf clear
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingClearRouteInfoOptionPreference

br routeprf (hoch,mittel,niedrig)

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

Nach einem Aufruf dieser Funktion verwendet BR die vorgegebene Einstellung. Du kannst die Einstellung durch Aufrufen von otBorderRoutingClearRoutePreference() löschen.

Parameter

br routeprf [high|med|low]

Beispiele

br routeprf low
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingSetRoutePreference

BR Routeprf

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

Die Präferenz wird wie folgt festgelegt:

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

Parameter

Keine Parameter.

Beispiele

br routeprf
med
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetRoutePreference

br routeprf klar

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

Nach dem Aufruf dieser Funktion bestimmt die AF die Einstellung automatisch anhand der Rolle des Geräts und der Linkqualität (mit dem übergeordneten Element, wenn es als Endgerät agiert).

Parameter

Keine Parameter.

Beispiele

br routeprf clear
Done

Befehlszeilen- und API-Referenzen

• otBorderRoutingClearRoutePreference

brrouter

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

• Die 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 des Stub-Routers (gibt an, ob der Router ein Stub-Router ist)
• Millisekunden seit der letzten von diesem Router empfangenen Nachricht
• Erreichbarkeits-Flag: Ein Router wird als nicht erreichbar markiert, wenn er nicht auf mehrere Anfragen für Nachbarnanfragen reagiert.
• Alter: Dauerintervall seit der ersten Erkennung dieses Routers. Sie ist als {hh}:{mm}:{ss} für Stunden, Minuten und Sekunden formatiert, wenn die Dauer weniger als 24 Stunden beträgt. Bei einer Dauer von mindestens 24 Stunden wird {dd}d.{hh}:{mm}:{ss} für Tage, Stunden, Minuten, Sekunden verwendet.
• (this BR) wird angehängt, wenn der Router das lokale Gerät selbst ist.
• (peer BR) wird angehängt, wenn der Router wahrscheinlich eine Peer-BR ist, die mit demselben Thread-Mesh verbunden ist. Hierfür sind OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE erforderlich.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetNextRouterEntry

BR State

Ruft den aktuellen Status des Border Routing Manager ab.

Parameter

Keine Parameter.

Beispiele

br state
running

Befehlszeilen- und API-Referenzen

• otBorderRoutingGetState

bufferinfo

Ruft die Informationen zum aktuellen Nachrichtenpuffer ab.

• total: Zeigt die Gesamtzahl der Nachrichtenpuffer im Pool an.
• free zeigt die Anzahl der kostenlosen Nachrichtenzwischenspeicher an.
• max-used zeigt die maximale Anzahl der gleichzeitig verwendeten Zwischenspeicher seit der Initialisierung des OT-Stacks oder der letzten bufferinfo reset an.

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

• 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 werden.
• Die dritte Zahl zeigt die Gesamtzahl der Bytes 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

• otMessageGetBufferInfo

Pufferinformationen zurückgesetzt

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

Dadurch wird mMaxUsedBuffers in otBufferInfo zurückgesetzt.

Parameter

Keine Parameter.

Beispiele

bufferinfo reset
Done

Befehlszeilen- und API-Referenzen

• otMessageResetBufferInfo

ccathreshold (get,set)

Ruft den CCA-Schwellenwert in dBm ab oder legt ihn fest, 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-Schwellenwert festzulegen.

Beispiele

ccathreshold
-75 dBm
Done

ccathreshold -62
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetCcaEnergyDetectThreshold
• otPlatRadioSetCcaEnergyDetectThreshold

channel (get,set)

Ruft den IEEE 802.15.4-Kanalwert 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 RequestChannelSelect(false) auf. Das Periodenintervall kann mit 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

• otChannelManagerSetAutoChannelSelectionEnabled

Änderung des Kanalmanagers

Fordert eine Änderung des Thread-Netzwerkkanals an.

Das Netzwerk wechselt nach einer gewissen Verzögerung zum gegebenen Kanal (siehe otChannelManagerSetDelay()). Der Kanalwechsel erfolgt durch Aktualisieren des ausstehenden operativen Datasets.

Durch einen nachfolgenden Aufruf wird eine 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

• otChannelManagerRequestChannelChange

Kanalmanager

Status des Kanalmanagers abrufen 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

• otChannelManagerGetRequestedChannel

Verzögerung des Kanalmanagers

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

Nur für FTDs verfügbar. Die Verzögerung sollte vorzugsweise länger sein als das maximale Datenabfrageintervall, das von allen schlafenden 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

• otChannelManagerSetDelay

Channel Manager bevorzugt

Legt die Maske für den bevorzugten Kanal 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

• otChannelManagerSetFavoredChannels

Kanalmanager-Intervall

Legt das Intervall 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

• otChannelManagerSetAutoChannelSelectionInterval

Kanalmanager auswählen

Beantragt, dass ChannelManager einen neuen Kanal prüft, auswählt und einen Kanalwechsel startet.

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

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

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

2) Wenn der erste Schritt erfolgreich ist, wählt ChannelManager einen potenziell besseren Kanal aus. Dabei werden die von ChannelMonitor Modul erfassten 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 ihn, wodurch intern ein RequestChannelChange() aufgerufen 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 select skip-quality-check

Verwenden Sie 1 oder 0 für den booleschen Wert skip-quality-check.

Beispiele

channel manager select 1
channel manager select 1
Done

Befehlszeilen- und API-Referenzen

• otChannelManagerRequestChannelSelect

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

• otChannelManagerSetSupportedChannels

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 einen Hexadezimalwert für threshold-percent. 0 entspricht 0% und 0xffff wird 100 % zugeordnet.

Beispiele

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

Befehlszeilen- und API-Referenzen

• otChannelManagerSetCcaFailureRateThreshold

Kanalmonitor

Rufen Sie den aktuellen Kanalüberwachungsstatus und die Kanalbelegung ab. 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

Kanalüberwachung starten Die OT-Befehlszeile sendet den booleschen Wert true an otChannelMonitorSetEnabled. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE ist ein Pflichtfeld.

Parameter

Keine Parameter.

Beispiele

channel monitor start
channel monitor start
Done

Befehlszeilen- und API-Referenzen

• otChannelMonitorSetEnabled

Kanalmonitor beenden

Beenden Sie den Kanalmonitor. Die OT-Befehlszeile sendet den booleschen Wert false an otChannelMonitorSetEnabled. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE ist ein Pflichtfeld.

Parameter

Keine Parameter.

Beispiele

channel monitor stop
channel monitor stop
Done

Befehlszeilen- und API-Referenzen

• otChannelMonitorSetEnabled

Kanal bevorzugt

Ruft die Maske für den Radio-Bevorzugten Kanal ab, auf der das Gerät bevorzugt werden soll.

Parameter

Keine Parameter.

Beispiele

channel preferred
0x7fff800
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetPreferredChannelMask

Kanal unterstützt

Ruft die vom Radio unterstützte Kanalmaske ab, die das Gerät verwenden darf.

Parameter

Keine Parameter.

Beispiele

channel supported
0x7fff800
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetSupportedChannelMask

untergeordnetes Element (ID)

Ruft Diagnosedaten für ein angehängtes untergeordnetes Element anhand seiner Child-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

• otThreadGetChildInfoById

Liste der untergeordneten Elemente

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

• otThreadGetChildInfoByIndex

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

• otThreadGetChildInfoByIndex

ChildIP

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

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otThreadGetChildNextIp6Address

max. untergeordnete IP-Adresse (fest)

Legt die maximale Anzahl von IP-Adressen fest oder stellt sie wieder her, die jedes untergeordnete MTD-Team auf diesem Gerät als übergeordnetes 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.

Hinweis: Wird nur vom Thread Test Harness verwendet, um die Adressregistrierungen des übergeordneten Referenzelements zu begrenzen und die MTD-DUT-Reaktion zu testen.

Parameter

childip max count

Beispiele

childip max 2
Done

Befehlszeilen- und API-Referenzen

• otThreadSetMaxChildIpAddresses

max. untergeordnete IP-Adresse

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

Parameter

Keine Parameter.

Beispiele

childip max
4
Done

Befehlszeilen- und API-Referenzen

• otThreadGetMaxChildIpAddresses

ChildMax (fest)

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

• otThreadSetMaxAllowedChildren

ChildMax

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

Parameter

Keine Parameter.

Beispiele

childmax
5
Done

Befehlszeilen- und API-Referenzen

• otThreadGetMaxAllowedChildren

Childrouterlinks (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

• otThreadGetChildRouterLinks
• otThreadSetChildRouterLinks

Checktimeout für die Elternaufsicht (festgelegt)

Legt das Zeitlimit für die Überprüfung der Elternaufsicht (in Sekunden) für das Kind fest.

Parameter

childsupervision checktimeout timeout-seconds

Beispiele

childsupervision checktimeout 30
Done

Befehlszeilen- und API-Referenzen

• otChildSupervisionSetCheckTimeout

Checktimeout für die Elternaufsicht

Ruft das Zeitlimit für die Überprüfung der Elternaufsicht (in Sekunden) für das Kind ab.

Wenn das Gerät ein inaktives Kind ist und innerhalb des angegebenen Zeitlimits für die Prüfung nichts von seinem übergeordneten Gerät hört, wird der Prozess zum erneuten Anhängen ausgelöst.

Parameter

Keine Parameter.

Beispiele

childsupervision checktimeout
30
Done

Befehlszeilen- und API-Referenzen

• otChildSupervisionGetCheckTimeout

Intervall der untergeordneten Elternaufsicht (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

• otChildSupervisionSetInterval

Intervall der untergeordneten Elternaufsicht

Ruft das Überwachungsintervall (in Sekunden) eines untergeordneten Publishers ab.

Mit der Funktion für die Elternaufsicht können Eltern dafür sorgen, dass jedes schläfrige Kind innerhalb des Aufsichtsintervalls eine Nachricht erhält. Wenn es innerhalb des Beaufsichtigungsintervalls keine Übertragung an die untergeordnete Organisation findet, stellt OpenThread die Warteschlange und sendet eine Nachricht zur Elternaufsicht an das untergeordnete Netzwerk.

Parameter

Keine Parameter.

Beispiele

childsupervision interval
30
Done

Befehlszeilen- und API-Referenzen

• otChildSupervisionGetInterval

Childtimeout (festgelegt)

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

Parameter

childtimeout timeout-seconds

Beispiele

childtimeout 300
Done

Befehlszeilen- und API-Referenzen

• otThreadSetChildTimeout

Zeitüberschreitung bei Kindern

Ruft das Zeitlimit für untergeordnete Threads (in Sekunden) ab, das beim Ausführen in der Rolle „Untergeordnetes Element“ verwendet wird.

Parameter

Keine Parameter.

Beispiele

childtimeout
300
Done

Befehlszeilen- und API-Referenzen

• otThreadGetChildTimeout

Coap-Abbrechen

Storniert ein bestehendes Beobachtungsabo für eine Remote-Ressource auf dem CoAP-Server.

Hinweis: Dieser Befehl ist nur verfügbar, wenn OPENTHREAD_CONFIG_COAP_OBSERVE_API_ENABLE festgelegt ist.

Parameter

Keine Parameter.

Beispiele

coap cancel
Done

Befehlszeilen- und API-Referenzen

• Coap-Beobachtung

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ätigungsfähig
  • non-con: Nicht bestätigungsfähig (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ätigungsfähig
  • non-con: Nicht bestätigungsfähig (Standardeinstellung)
  • block-: Verwenden Sie diese Option, gefolgt vom Wert für den Block, wenn die Antwort blockweise übertragen werden soll. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.

Beispiele

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

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

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Coap beobachten

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.

Hinweis: Dieser Befehl ist nur verfügbar, wenn OPENTHREAD_CONFIG_COAP_OBSERVE_API_ENABLE festgelegt ist.

Parameter

coap observe address uri-path [type]

• address: IPv6-Adresse des CoAP-Servers.
• uri-path: URI-Pfad der Ressource.
• type:
  • con: bestätigungsfähig
  • non-con: Nicht bestätigungsfähig (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 aktuelle CoAP-Parameterwerte ab, wenn der Befehl ohne optionale Parameter ausgeführt wird.

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

Parameter

coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]

• type: request für CoAP-Anfragen oder response für CoAP-Antworten. Wenn keine weiteren Parameter angegeben werden, gibt der Befehl die aktuelle Konfiguration aus.
• default: Legt die Übertragungsparameter auf die folgenden Standardwerte fest:
  • ack_timeout: 2.000 Millisekunden
  • ack_random_factor_numerator: 3
  • ack_random_factor_denominator: 2
  • max_retransmit: 4
• ack_timeout: Der ACK_TIMEOUT (0-UINT32_MAX) in Millisekunden. Weitere Informationen finden Sie unter RFC 7252.
• ack_random_factor_numerator: Der Zähler ACK_RANDOM_FACTOR mit möglichen Werten von 0–255. Weitere Informationen finden Sie unter RFC 7252.
• ack_random_factor_denominator: Der Nenner für ACK_RANDOM_FACTOR mit möglichen Werten zwischen 0 und 255. Weitere Informationen finden Sie unter RFC 7252.
• max_retransmit: Der MAX_RETRANSMIT (0–255). Weitere Informationen finden Sie unter 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 Verbindung zu einer CoAP-Ressource (Constrained Application Protocol) mithilfe der OT-Befehlszeile testen.

Parameter

coap post address uri-path [type] [payload]

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

Beispiele

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

coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Coap Put

Ändert die angegebene CoAP-Ressource. Weitere Informationen finden Sie unter Verbindung zu einer CoAP-Ressource (Constrained Application Protocol) mithilfe der OT-Befehlszeile testen.

Parameter

coap put address uri-path [type] [payload]

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

Beispiele

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

coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Coap-Ressource (get,set)

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

Parameter

coap resource [uri-path]

Beispiele

coap resource test-resource
Done

coap resource
test-resource
Done

Befehlszeilen- und API-Referenzen

• otCoapAddResource
• otCoapAddBlockWiseResource

Coap-Set

Legt den Inhalt fest, der von der Ressource auf dem CoAP-Server gesendet wird. 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-Beobachtung
• otCoapMessageInit
• otCoapNewMessage

Coap-Start

Startet den CoAP-Server. Weitere Informationen finden Sie unter Verbindung zu einer CoAP-Ressource (Constrained Application Protocol) mithilfe der OT-Befehlszeile testen.

Parameter

Keine Parameter.

Beispiele

coap start
Done

Befehlszeilen- und API-Referenzen

• otCoapStart

Coap Stop

Stoppt den CoAP-Server.

Parameter

Keine Parameter.

Beispiele

coap stop
Done

Befehlszeilen- und API-Referenzen

• otCoapStop

Coaps verbinden

Initialisiert eine DTLS-Sitzung (Datagram Transport Layer Security) mit einem Peer. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile 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

• otCoapSecureConnect

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ätigungsfähig
  • non-con: Nicht bestätigungsfähig (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

• otCoapSecureDisconnect

coaps erhalten

Ruft Informationen zur angegebenen CoAPS-Ressource auf dem CoAPS-Server ab. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

coaps get uri-path [type]

• uri-path: URI-Pfad der Ressource.
• type:
  • con: bestätigungsfähig
  • non-con: Nicht bestätigungsfähig (Standardeinstellung)
  • block-: Verwenden Sie diese Option, gefolgt vom Wert für den Block, wenn die Antwort blockweise übertragen werden soll. Gültige Werte sind: block-16, block-32, block-64, block-128, block-256, block-512 oder block-1024.

Beispiele

coaps get test-resource
Done

coaps get test-resource block-1024
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Überbrückung geschlossen

Gibt an, ob der CoAP Secure-Dienst geschlossen ist. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

Keine Parameter.

Beispiele

coaps isclosed
no
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureIsClosed

Coaps isconnactive

Gibt an, ob die Verbindung zum CoAP Secure-Dienst aktiv ist (entweder bereits verbunden oder gerade hergestellt). Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

Keine Parameter.

Beispiele

coaps isconnactive
yes
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureIsConnectionActive

Coaps ist verbunden

Gibt an, ob der CoAP Secure-Dienst verbunden ist. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

Keine Parameter.

Beispiele

coaps isconnected
yes
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureIsConnected

Coaps Post

Erstellt die angegebene CoAPS-Ressource. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

uri-path [type] [payload]

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

Beispiele

coaps post test-resource con hellothere
Done

coaps post test-resource block-1024 10
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Coaps Psk

Legt den vorinstallierten Schlüssel (Pre-Shared Key, PSK) und die Cipher Suite DTLS_PSK_WITH_AES_128_CCM_8 fest.

Hinweis: Für diesen Befehl muss das Build-Zeit-Feature MBEDTLS_KEY_EXCHANGE_PSK_ENABLED aktiviert sein.

Parameter

coaps psk psk-value psk-id

• psk-value: der vorinstallierte Schlüssel
• psk-id: Die ID des vorinstallierten Schlüssels.

Beispiele

coaps psk 1234 key1
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureSetPsk

Überwinden

Ändert die angegebene CoAPS-Ressource. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

uri-path [type] [payload]

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

Beispiele

coaps put test-resource con hellothere
Done

coaps put test-resource block-1024 10
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Coaps-Ressource (get,set)

Ruft den URI-Pfad der CoAPS-Serverressource ab oder legt ihn fest. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

coaps resource [uri-path]

Beispiele

coaps resource test-resource
Done

coaps resource
test-resource
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureAddBlockWiseResource

Überhängen gesetzt

Legt den von der Ressource auf dem CoAPS-Server gesendeten Inhalt fest. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

coaps set new-content

Beispiele

coaps set Testing123
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Beginn der Abspannung

Startet den CoAP Secure-Dienst. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

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

Der Parameter check-peer-cert bestimmt, ob die Peer-Zertifikatsprüfung aktiviert (Standardeinstellung) oder deaktiviert ist. Mit dem Parameter max-conn-attempts wird die maximale Anzahl zulässiger Versuche oder fehlgeschlagener Versuche festgelegt, eine Verbindung zum CoAP Secure-Server herzustellen. Der Standardwert dieses Parameters ist 0. Die Anzahl der Versuche ist also nicht begrenzt. Die Parameter check-peer-cert und max-conn-attempts funktionieren bei den folgenden Kombinationen zusammen, obwohl Sie nur ein Argument angeben können:

• Kein Argument angegeben: Standardeinstellungen werden verwendet.
• check-peer-cert auf true festlegen: Hat denselben Effekt wie das Weglassen des Arguments, nämlich dass der Wert für check-peer-cert true und der Wert für max-conn-attempts 0 ist.
• Wenn Sie check-peer-cert auf false setzen: Der Wert von check-peer-cert ist false und der Wert von max-conn-attempts ist 0.
• Angabe einer Zahl: check-peer-cert ist true und der Wert max-conn-attempts ist die im Argument angegebene Zahl.

Beispiele

coaps start
Done

coaps start false
Done

coaps start 8
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureStart
• otCoapSecureSetSslAuthMode
• otCoapSecureSetClientConnectedCallback

Coaps stopp

Stoppt den CoAP Secure-Dienst. Weitere Informationen finden Sie unter Verbindung zu einer Constrained Application Protocol Secure (CoAPS)-Ressource mithilfe der OT-Befehlszeile testen.

Parameter

Keine Parameter.

Beispiele

coaps stop
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureStop

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.

Hinweis: Für diesen Befehl muss MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1 aktiviert sein. Das X.509-Zertifikat wird unter folgendem Pfad gespeichert: src/cli/x509_cert_key.hpp.

Parameter

Keine Parameter.

Beispiele

coaps x509
Done

Befehlszeilen- und API-Referenzen

• otCoapSecureSetCertificate
• otCoapSecureSetCaCertificateChain

Mitteilung des Beauftragten

Sendet eine Ansage-Nachricht zu Beginn.

Hinweis: Verwenden Sie diesen Befehl nur, wenn Sie die Provisioner-Rolle mit dem Befehl commissioner start erfolgreich gestartet haben.

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: Ziel-IPv6-Adresse für die Nachricht. Die Nachricht kann Multicast sein.

Beispiele

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

Befehlszeilen- und API-Referenzen

• Start für Provisioner
• otCommissionerAnnounceBegin

Commissioner Energy

Sendet eine Anfragenachricht zum Energiescan. Die Befehlsausgabe wird beim Empfang ausgegeben.

Hinweis: Verwenden Sie diesen Befehl nur, wenn Sie die Provisioner-Rolle mit dem Befehl commissioner start erfolgreich gestartet haben.

Parameter

commissioner energy mask count period scanDuration destination

• mask: Bitmaske, die Kanäle für die Durchführung von Energiescans gemäß IEEE 802.15.4 identifiziert.
• count: Anzahl der IEEE 802.15.4-Energiescans pro Kanal.
• period: Anzahl der Millisekunden zwischen aufeinanderfolgenden Energiescans gemäß IEEE 802.15.4.
• scanDuration: Scandauer in Millisekunden, die beim Ausführen eines IEEE 802.15.4-Energiescans verwendet werden soll.
• destination: Ziel-IPv6-Adresse für die Nachricht. Die Nachricht kann Multicast 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

• Start für Provisioner
• otCommissionerEnergyScan

Commissioner-ID (get,set)

Ruft den OpenThread Commissioner-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

• otCommissionerSetId

Kommissar hinzufügen

Fügt einen Joiner-Eintrag hinzu.

Hinweis: Verwenden Sie diesen Befehl nur, wenn Sie die Provisioner-Rolle mit dem Befehl commissioner start erfolgreich gestartet haben.

Parameter

commissioner joiner add eui64|discerner pksd [timeout]

• eui64: IEEE EUI-64 des Joiner. Verwenden Sie *, um einen JOINer zu abgleichen.
• discerner: Der JOINer im Format number/length.
• pksd: Vorinstallierter Schlüssel für den Joiner.
• timeout: Das Zeitlimit für Joiner in Sekunden.

Beispiele

commissioner joiner add d45e64fa83f81cf7 J01NME
Done

commissioner joiner add 0xabc/12 J01NME
Done

Befehlszeilen- und API-Referenzen

• Start für Provisioner
• otCommissionerAddJoiner
• otCommissionerAddJoinerWithDiscerner

Kommissar entfernen

Entfernt einen Joiner-Eintrag.

Hinweis: Verwenden Sie diesen Befehl nur, wenn Sie die Provisioner-Rolle mit dem Befehl commissioner start erfolgreich gestartet haben.

Parameter

commissioner joiner remove eui64|discerner

• eui64: IEEE-EUI-64 des Joiners. Verwenden Sie *, um einen JOINer zu abgleichen.
• discerner: Entspricht dem Joiner-Erkennungszeichen im Format number/length.

Beispiele

commissioner joiner remove d45e64fa83f81cf7
Done

commissioner joiner remove 0xabc/12
Done

Befehlszeilen- und API-Referenzen

• Start für Provisioner
• otCommissionerRemoveJoiner
• otCommissionerRemoveJoinerWithDiscerner

Tabelle „Commissioner 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

Provisionsmanagement

Sendet eine MGMT_GET-Nachricht (Verwaltungsabruf) 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 Kommissars.
• steeringdata: Steuerungsdaten.
• joinerudpport: Joiner-UDP-Port.
• TLVs: Gruppe der abzurufenden TLVs.

Beispiele

commissioner mgmtget locator sessionid
Done

Befehlszeilen- und API-Referenzen

• otCommissionerSendMgmtGet

Provisionsmanagement

Sendet die Nachricht MGMT_SET (Verwaltungsgruppe) 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 Kommissars.
• steeringdata: Steuerungsdaten.
• joinerudpport: Joiner-UDP-Port.
• TLVs: Gruppe der abzurufenden TLVs.

Beispiele

commissioner mgmtset joinerudpport 9988
Done

Befehlszeilen- und API-Referenzen

• otCommissionerSendMgmtSet

Panid-Behörde

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

Hinweis: Verwenden Sie diesen Befehl nur, wenn Sie die Provisioner-Rolle mit dem Befehl commissioner start erfolgreich gestartet haben.

Parameter

commissioner panid panid mask destination

• paind: PAN zur Prü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 Multicast sein.

Beispiele

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

Befehlszeilen- und API-Referenzen

• Start für Provisioner
• otCommissionerPanIdQuery

Bereitstellungs-URL für Provisioner

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

Parameter

commissioner provisioningurl provisioningurl

Beispiele

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

Befehlszeilen- und API-Referenzen

• otCommissionerSetProvisioningUrl

Provisioner-Sitzungs-ID

Ruft die aktuelle Commissioner-Sitzungs-ID ab.

Parameter

Keine Parameter.

Beispiele

commissioner sessionid
0
Done

Befehlszeilen- und API-Referenzen

• otCommissionerGetSessionId

Start des Provisioners

Startet die Rolle „Thread Commissioner“.

Hinweis: Die commissioner-Befehle sind nur verfügbar, wenn OPENTHREAD_CONFIG_COMMISSIONER_ENABLE und OPENTHREAD_FTD festgelegt sind.

Parameter

Keine Parameter.

Beispiele

commissioner start
Commissioner: petitioning
Done
Commissioner: active

Befehlszeilen- und API-Referenzen

• otCommissionerStart

Commissioner State

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

Parameter

Keine Parameter.

Beispiele

commissioner state
active
Done

Befehlszeilen- und API-Referenzen

• otCommissionerState

Tankstelle

Beendet die Thread Commissioner-Rolle.

Parameter

Keine Parameter.

Beispiele

commissioner stop
Done

Befehlszeilen- und API-Referenzen

• otCommissionerStop

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

• otThreadGetContextIdReuseDelay
• otThreadSetContextIdReuseDelay

Zähler (Mac)

MAC-Layer-Zähler abrufen

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

• otLinkGetCounters

Zähler (mle)

Ruft die Thread-MLE-Zähler 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

• otThreadGetMleCounters

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

• otThreadGetIp6Counters

Zähler-IP zurückgesetzt

Setzt die IPv6-Zähler zurück.

Parameter

counters ip reset

Beispiele

counters ip reset
Done

Befehlszeilen- und API-Referenzen

• otThreadResetIp6Counters

Zähler Mac zurückgesetzt

Setzt die Zähler der MAC-Ebene zurück.

Parameter

counters mac reset

Beispiele

counters mac reset
Done

Befehlszeilen- und API-Referenzen

• otLinkResetCounters

Zähler mle zurückgesetzt

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

Parameter

counters mle reset

Beispiele

counters mle reset
Done

Befehlszeilen- und API-Referenzen

• otThreadResetMleCounters

CSL-Kanal

Legt den CSL-Kanal fest.

Parameter

csl channel channel

Beispiele

csl channel 20
Done

Befehlszeilen- und API-Referenzen

• otLinkSetCslChannel

CSL

Ruft die CSL-Konfiguration ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkGetCslChannel
• otLinkGetCslPeriod
• otLinkGetCslPeriod
• otLinkGetCslTimeout

CSL-Zeitraum

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

• otLinkSetCslPeriod

CSL-Zeitlimit

Legt das CSL-Zeitlimit in Sekunden fest.

Parameter

csl timeout timeout

Beispiele

cls timeout 10
Done

Befehlszeilen- und API-Referenzen

• otLinkSetCslTimeout

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 hexadezimal 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

• otDatasetGetActive

Dataset Activetimestamp (get, set)

Ruft otOperationalDataset::mActiveTimestamp ab oder legt sie 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-Kanal (get,set)

Ruft otOperationalDataset::mChannel ab oder legt sie 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

Kanalmaske des Datasets (get,set)

Ruft otOperationalDataset::mChannelMask ab oder legt sie 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

Datensatz 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 ein Commit des Zwischenspeichers des operativen Datasets in das aktive operative Dataset durch.

Parameter

Keine Parameter.

Beispiele

dataset commit active
Done

Befehlszeilen- und API-Referenzen

• ausstehender Dataset-Commit
• otDatasetSetPending

Commit für Dataset ausstehend

Übertragen Sie den Zwischenspeicher des operativen Datasets auf das ausstehende operative Dataset.

Parameter

Keine Parameter.

Beispiele

dataset commit pending
Done

Befehlszeilen- und API-Referenzen

• Dataset-Commit aktiv
• otDatasetSetActive

Dataset-Verzögerung (get,set)

Ruft otOperationalDataset::mDelay ab oder legt sie fest.

Parameter

dataset delay [delay]

Verwenden Sie das optionale Argument delay, um den Wert des Verzögerungs-Timers festzulegen.

Beispiele

dataset delay
1000
Done

dataset delay 1000
Done

Befehlszeilen- und API-Referenzen

• otDatasetSetDelayTimerMinimal

Dataset extpanid (get,set)

Ruft otOperationalDataset::mExtendedPanId ab oder legt sie fest.

Hinweis: Die Anmeldedaten für die Inbetriebnahme im Dataset-Zwischenspeicher sind veraltet, nachdem dieser Wert geändert wurde. Zum Zurücksetzen dataset pskc verwenden.

Parameter

dataset extpanid [extpanid]

Verwenden Sie 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

• Dataset PSC (get,set)

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 (aktiv,neu,ausstehend,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]

Initialisieren Sie mit new ein neues Dataset und geben Sie dann den Befehl dataset commit active ein. Verwende tlvs für hexadezimal codierte TLVs.

Beispiele

dataset init new
Done

Befehlszeilen- und API-Referenzen

• Dataset-Commit aktiv
• Dataset aktiv

Dataset-Meshlocalpräfix (get,set)

Ruft otOperationalDataset::mMeshLocalPrefix ab oder legt es 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 eine MGMT_ACTIVE_GET mit den entsprechenden Argumenten. Weitere Informationen zu diesen Parametern und Argumentzuordnungen finden Sie unter Datasets mit der OT-Befehlszeile anzeigen und verwalten.

Hinweis: Dieser Befehl wird hauptsächlich zu Testzwecken verwendet.

Parameter

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

• Verwenden Sie address, um das IPv6-Ziel anzugeben. Andernfalls wird standardmäßig der Leader-ALOC verwendet.
• Für dataset-components können Sie eine beliebige Kombination von otOperationalDatasetComponents übergeben, z. B. activetimestamp, pendingtimestamp oder networkkey.
• Das optionale Argument -x gibt die anzufordernden TLV-Rohdaten an.

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
• Dataset-Verwaltungsbefehl ausstehend
• Dataset-Verwaltungsbefehl aktiv
• Dataset-Verwaltungsbefehl ausstehend

Dataset-Mgmtget-Befehl ausstehend

Sendet MGMT_PENDING_GET.

Hinweis: Dieser Befehl wird hauptsächlich zu Testzwecken verwendet.

Parameter

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

Weitere Informationen zu diesen Parametern und Argumentzuordnungen finden Sie unter Datasets mit der 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-Verwaltungsbefehl aktiv
• Dataset-Verwaltungsbefehl aktiv
• Dataset-Verwaltungsbefehl ausstehend

Dataset-Verwaltungsbefehl aktiv

Sendet MGMT_ACTIVE_SET.

Hinweis: Dieser Befehl wird hauptsächlich zu Testzwecken verwendet.

Parameter

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

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

Beispiele

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

Befehlszeilen- und API-Referenzen

• otDatasetSendMgmtActiveSet
• Dataset-Verwaltungsbefehl aktiv
• Dataset-Verwaltungsbefehl ausstehend
• Dataset-Verwaltungsbefehl ausstehend

Dataset-Mgmtset-Befehl ausstehend

Sendet MGMT_PENDING_SET.

Hinweis: Dieser Befehl wird hauptsächlich zu Testzwecken verwendet.

Parameter

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

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

Beispiele

dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done

Befehlszeilen- und API-Referenzen

• otDatasetSendMgmtPendingSet
• Dataset-Verwaltungsbefehl aktiv
• Dataset-Verwaltungsbefehl ausstehend
• Dataset-Verwaltungsbefehl aktiv

Dataset-Netzwerkschlüssel (get,set)

Ruft otOperationalDataset::mNetworkKey ab oder legt sie 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 sie fest.

Hinweis: Die Anmeldedaten für die Inbetriebnahme im Dataset-Zwischenspeicher sind nach Änderung dieses Werts veraltet. Zum Zurücksetzen dataset pskc verwenden.

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

Dataset-Panid (get,set)

Ruft otOperationalDataset::mPanId ab oder legt sie fest.

Parameter

dataset panid [panid]

Verwenden Sie 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 sie fest.

Parameter

dataset pendingtimestamp [timestamp]

Verwenden Sie das optionale Argument timestamp, um die Sekunden des ausstehenden Zeitstempels 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 sie fest.

Parameter

dataset pskc [-p passphrase] | [key]

Verwenden Sie nur für FTD -p mit dem Argument passphrase. -p generiert eine pskc-Datei aus der von dir bereitgestellten UTF-8-codierten passphrase, zusammen mit dem Netzwerknamen und der erweiterten PAN-ID. Wenn dies festgelegt ist, verwendet -p den Dataset-Zwischenspeicher. Andernfalls wird der aktuelle Stapel 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]]

• Verwende rotationtime für thrKeyRotation in Stunden.
• Sicherheitsrichtlinienbefehle verwenden die onrcCepR-Argumentzuordnungen zum Abrufen und Festlegen von otSecurityPolicy-Mitgliedern. Beispielsweise steht o für otSecurityPolicy::mObtainNetworkKeyEnabled. 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.

Enthält das Dataset keinen aktiven Zeitstempel, 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. Für die Verbindung mit einem Netzwerk wird nur der Thread-Netzwerkschlüssel benötigt.

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

Wenn das Gerät erfolgreich mit einem Thread-Netzwerk verbunden wurde, ruft das Gerät das vollständige aktive Dataset von seinem übergeordneten Netzwerk ab. Beachten Sie, dass ein Router-fähiges Gerät erst auf die Router- oder Leader-Rolle umgestellt wird, wenn es über ein vollständiges aktives Dataset verfügt.

Diese Funktion gibt konsistent OT_ERROR_NONE zurück und kann effektiv so behandelt werden, als hätte sie einen void-Rückgabetyp. Zuvor wurden andere Fehler (z.B. OT_ERROR_NOT_IMPLEMENTED) wurden aus Legacy-Gründen zugelassen. Da jedoch nichtflüchtiger Speicher für den Thread-Vorgang jetzt obligatorisch ist, wird bei jedem Fehler beim Speichern des Datasets eine Assertion ausgelöst. Der Rückgabetyp otError wird aus Gründen der Abwärtskompatibilität beibehalten.

Der Befehl dataset set in der Befehlszeile legt das aktive operative Dataset mithilfe von 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

• otDatasetSetActive

Dataset-TLS

Konvertiert ein bestimmtes operatives Dataset in otOperationalDatasetTlvs .

Parameter

Keine Parameter.

Beispiele

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

Befehlszeilen- und API-Referenzen

• otDatasetConvertToTlvs

Abbrechen der Dataset-Aktualisierung

Bricht eine laufende (falls vorhanden) Anfrage zur Aktualisierung des 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

• otDatasetUpdaterCancelUpdate

Dataset-Updater

Gibt an, ob eine laufende Anfrage zur Aktualisierung des Vorgangs-Datasets vorliegt.

Verfügbar, wenn OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE aktiviert ist.

Parameter

Keine Parameter.

Beispiele

dataset updater
Enabled
Done

Befehlszeilen- und API-Referenzen

• otDatasetUpdaterIsUpdateOngoing

Start des Dataset-Updaters

Fordert eine Aktualisierung des operativen Datasets an.

Verfügbar, wenn OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE aktiviert ist.

aDataset sollte die zu aktualisierenden Felder und den neuen Wert enthalten. Er darf keine aktiven oder ausstehenden Zeitstempelfelder enthalten. Das Feld „Verzögerung“ ist optional. Wenn Sie nichts angeben, 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

• otDatasetUpdaterRequestUpdate

debug

Führt eine Reihe von CLI-Befehlen aus, um Informationen zum Gerät und Thread-Netzwerk zu erfassen. Dies ist für das Debugging vorgesehen. In der Ausgabe wird jeder ausgeführte Befehlszeilenbefehl mit vorangestelltem $ angezeigt, gefolgt von der generierten Ausgabe des entsprechenden Befehls. Die generierte Ausgabe enthält 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
• Führende Daten

Wenn das Gerät als FTD betrieben wird:

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

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

• Status des SRP-Clients
• SRP-Clientdienste und Hostinformationen

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

• Status und Adressmodus des SRP-Servers
• Für SRP-Server registrierte Hosts und Dienste

Wenn das Gerät TREL unterstützt:

• TREL-Status und Peer-Tabelle

Wenn das Gerät als Border-Router unterstützt wird und als Border-Router fungiert:

• AF-Status
• BR-Präfixe (OMR, On-Link, NAT64)
• Tabelle mit erkannten Präfixen

Parameter

Keine Parameter.

Beispiele

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Verspätungs-Timer (eingestellt)

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

Parameter

delaytimermin delaytimermin

Beispiele

delaytimermin 60
Done

Befehlszeilen- und API-Referenzen

• otDatasetSetDelayTimerMinimal

Verspätungstimermin

Rufen Sie den Timer für die minimale Verzögerung (in Sekunden) ab.

Parameter

Keine Parameter.

Beispiele

delaytimermin
30
Done

Befehlszeilen- und API-Referenzen

• otDatasetGetDelayTimerMinimal

Asynchron trennen

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

Parameter

Keine Parameter.

Beispiele

detach async
Done

Befehlszeilen- und API-Referenzen

• Trennen
• otThreadDetachGracefully

detach

Starten Sie den ordnungsgemäßen Trennvorgang, indem Sie zuerst andere Knoten benachrichtigen (die Adressfreigabe senden, wenn Sie als Router agieren, oder den Wert für das Zeitlimit des untergeordneten Elements für das übergeordnete Element auf null setzen, wenn Sie als untergeordneter Knoten agieren). Dann beenden Sie den Thread-Protokollvorgang.

Parameter

Keine Parameter.

Beispiele

detach
Finished detaching
Done

Befehlszeilen- und API-Referenzen

• otThreadDetachGracefully

Geräterequisiten (set)

Legt die Geräteeigenschaften fest.

Parameter

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

powerSupply: sollte „battery“, „external“, „external-stable“ und „external-instable“ 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

• führendes Gewicht
• führendes Gewicht (set)
• otThreadSetDeviceProperties

deviceprops

Rufen Sie die aktuellen Geräteeigenschaften ab.

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

• otThreadGetDeviceProperties

discover

Führen Sie einen MLE-Erkennungsvorgang aus.

Parameter

discover [channel]

channel: Der Kanal, auf dem Inhalte entdeckt werden sollen. Wenn Sie keinen Kanal angeben, 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

• otThreadDiscover

analytics reqcallback (aktivieren,deaktivieren)

Legt einen Callback zum Empfang von MLE-Erkennungsanfragedaten fest.

Parameter

discover reqcallback enable|disable

Beispiele

discover reqcallback enable
Done

Befehlszeilen- und API-Referenzen

• otThreadSetDiscoveryRequestCallback

DNS-Suche

DNS-Suchanfrage (Dienstinstanzauflistung) senden, um die Liste der Dienste für einen bestimmten Dienstnamen abzurufen

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

Hinweis: Die IP-Adresse des DNS-Servers kann eine IPv4-Adresse sein, die mithilfe des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn die IP-Adresse des DNS-Servers eine IPv4-Adresse ist, das bevorzugte NAT64-Präfix aber nicht verfügbar ist. Beim Testen des DNS-SD-Discovery-Proxys lautet die Zone nicht local, sondern sollte default.service.arpa sein. OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE ist ein Pflichtfeld.

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

• otDnsClientBrowse

DNS-Komprimierung (aktivieren,deaktivieren)

Legen Sie die DNS-Namenskomprimierung fest. .

Standardmäßig ist die DNS-Namenskomprimierung aktiviert. Wenn diese Option deaktiviert ist, werden DNS-Namen als vollständige und nie komprimiert angehängt. Dies gilt für die DNS- und SRP-Client/Server-Module 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

• otDnsSetNameCompressionEnabled

DNS-Komprimierung

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

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

Standardmäßig ist die DNS-Namenskomprimierung aktiviert. Wenn diese Option deaktiviert ist, werden DNS-Namen als vollständige und nie komprimiert angehängt. Dies gilt für die DNS- und SRP-Client/Server-Module 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

• otDnsIsNameCompressionEnabled

DNS-Konfiguration (eingestellt)

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

Hinweis: Alle laufenden Abfragen verwenden die Konfiguration ab dem Zeitpunkt, an dem sie gestartet wurde. Die neue Standardkonfiguration wird für alle zukünftigen DNS-Abfragen verwendet.

In einem Nicht-NULL-aConfig kann der Aufrufer auswählen, dass einige der Felder in der otDnsQueryConfig -Instanz nicht angegeben werden sollen (Wert null). Die nicht angegebenen Felder werden durch die entsprechenden Optionsdefinitionen für die OT-Konfiguration (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 vom DNS-Client festgelegt und aktualisiert. Dies geschieht nur, wenn der Nutzer ihn nicht explizit festlegt oder angibt. Für dieses Verhalten müssen der SRP-Client und seine 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 ist in der Standardkonfiguration auch als Adresse des DNS-Servers festgelegt.

Wir können für einige Felder keine Angabe machen oder den Wert Null verwenden. Die nicht angegebenen Felder werden durch die entsprechenden Optionsdefinitionen für die OT-Konfiguration (OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT) ersetzt, um die Standardabfragekonfiguration zu bilden. OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE ist ein Pflichtfeld.

Parameter

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

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
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done

dns config fd00::2
Done

dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 6000 ms
MaxTxAttempts: 3
RecursionDesired: yes
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done

Befehlszeilen- und API-Referenzen

• otDnsClientSetDefaultConfig

DNS-Konfiguration

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

Beim Start des OpenThread-Stacks wird die Standard-DNS-Abfragekonfiguration 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 Zeitlimit für die Antwort in ms (Wartezeit bis zur rx-Antwort), die maximale Anzahl der tx-Versuche bis zur Meldung eines Fehlers sowie ein boolesches Flag, das angibt, ob der Server die Abfrage rekursiv auflö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

• otDnsClientGetDefaultConfig

DNS-Auflösung

Sendet eine DNS-Anfrage zur Adressauflösung für AAAA-Einträge (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 Nicht-NULL-aConfig können einige der Felder nicht angegeben werden (Wert null). Die nicht angegebenen Felder werden dann durch die Werte aus der Standardkonfiguration ersetzt.

DNS-Abfrage senden, um die IPv6-Adresse für einen bestimmten Hostnamen abzurufen

Die Parameter nach dem Hostnamen sind optional. Jeder nicht spezifizierte Wert (oder null) 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 mithilfe des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird.

Hinweis: Der Befehl gibt InvalidState zurück, wenn die DNS-Server-IP-Adresse eine IPv4-Adresse ist, das bevorzugte NAT64-Präfix aber nicht verfügbar ist. OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE ist ein Pflichtfeld.

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

• otDnsClientResolveAddress

DNS-Dienst

Startet eine DNS-Dienstinstanzauflösung 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 Nicht-NULL-aConfig können einige der Felder nicht angegeben werden (Wert null). Die nicht angegebenen Felder werden dann durch die Werte aus der Standardkonfiguration ersetzt.

Die Funktion sendet Abfragen für SRV- und/oder TXT-Einträge für die angegebene Dienstinstanz. Das Feld mServiceMode in otDnsQueryConfig legt fest, welche Datensätze abgefragt werden sollen (nur SRV, nur TXT oder sowohl SRV und TXT) und wie die Abfrage ausgeführt wird (gemeinsam in derselben Nachricht, separat parallel oder im optimierten Modus, in dem der Client zuerst dieselbe Nachricht versucht und dann separat, wenn er keine Antwort erhält).

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

Senden Sie eine DNS-Abfrage für die Dienstinstanzauflösung für eine bestimmte Dienstinstanz. Das Dienstinstanzlabel wird zuerst angegeben, gefolgt vom Dienstnamen. Beachten Sie, dass das Dienstinstanzlabel den Punkt (.) enthalten kann.

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

Hinweis: Die IP-Adresse des DNS-Servers kann eine IPv4-Adresse sein, die mithilfe des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn die IP-Adresse des DNS-Servers eine IPv4-Adresse ist, das bevorzugte NAT64-Präfix aber nicht verfügbar ist. OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE ist ein Pflichtfeld.

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

• otDnsClientResolveService

DNS-Servicehost

Startet eine DNS-Dienstinstanzauflösung für eine bestimmte Dienstinstanz mit einer möglichen Folgeadressesauflösung für den Hostnamen, der für die Dienstinstanz gefunden 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 Nicht-NULL-aConfig können einige der Felder nicht angegeben werden (Wert null). 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 Abfrage für einen TXT-Eintrag) und gibt OT_ERROR_INVALID_ARGS zurück.

Verhält sich ähnlich wie otDnsClientResolveService() , das Anfragen für SRV- und TXT-Einträge sendet. Stellt der Server bzw. Resolver jedoch in der Antwort auf die SRV-Anfrage (im Abschnitt „Zusätzliche Daten“) keine AAAA/A-Einträge für den Hostnamen bereit, nimmt er eine Auflösung des Hostnamens (eine AAAA-Abfrage) für den erkannten Hostnamen aus dem SRV-Eintrag vor. Der Callback aCallback wird aufgerufen, wenn Antworten für alle Abfragen empfangen werden, d.h., wenn sowohl die Dienst- als auch die Hostadresse aufgelöst wurde.

Senden Sie eine DNS-Abfrage für die Dienstinstanzauflösung für eine bestimmte Dienstinstanz mit möglicher anschließender Auflösung des Hostnamens. Das Dienstinstanzlabel wird zuerst angegeben, gefolgt vom Dienstnamen. Beachten Sie, dass das Dienstinstanzlabel den Punkt (.) enthalten kann.

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

Hinweis: Die IP-Adresse des DNS-Servers kann eine IPv4-Adresse sein, die mithilfe des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn die IP-Adresse des DNS-Servers eine IPv4-Adresse ist, das bevorzugte NAT64-Präfix aber nicht verfügbar ist. OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE ist ein Pflichtfeld.

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

• otDnsClientResolveServiceAndHostAddress

Domainname (set)

Legt den Thread-Domainnamen fest.

Funktioniert nur, wenn Thread-Protokolle deaktiviert sind.

Hinweis: Verfügbar seit Thread 1.2.

Parameter

domainname name

Leerzeichen können mit dem Escapezeichen backslash maskiert werden.

Beispiele

domainname Test\ Thread
Done

Befehlszeilen- und API-Referenzen

• otThreadSetDomainName

Domainname

Ruft den Thread-Domainnamen ab.

Hinweis: Verfügbar seit Thread 1.2.

Parameter

Keine Parameter.

Beispiele

domainname
Thread
Done

Befehlszeilen- und API-Referenzen

• otThreadGetDomainName

Dua-ID (festlegen,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.

Hinweis :Nur seit Thread 1.2 verfügbar.

Parameter

dua iid iid|clear

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

Beispiele

dua iid 0004000300020001
Done

dua iid clear
Done

Befehlszeilen- und API-Referenzen

• otThreadSetFixedDuaInterfaceIdentifier

Dua Iid

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

Verfügbar, wenn OPENTHREAD_CONFIG_DUA_ENABLE aktiviert ist.

Hinweis :Nur seit Thread 1.2 verfügbar.

Parameter

Keine Parameter.

Beispiele

dua iid
0004000300020001
Done

Befehlszeilen- und API-Referenzen

• otThreadGetFixedDuaInterfaceIdentifier

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

• otThreadGetNextCacheEntry

eui64

Ruft die werkseitig zugewiesene IEEE EUI-64 für diese Schnittstelle ab.

Parameter

Keine Parameter.

Beispiele

eui64
0615aae900124b00
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetIeeeEui64

Extaddr (set)

Legt die erweiterte IEEE 802.15.4-Adresse fest.

Hinweis: Funktioniert nur, wenn Thread-Protokolle deaktiviert sind.

Parameter

extaddr extaddr

Beispiele

extaddr dead00beef00cafe
dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

• otLinkSetExtendedAddress

extaddr

Ruft die erweiterte IEEE 802.15.4-Adresse ab.

Parameter

Keine Parameter.

Beispiele

extaddr
dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

• otLinkGetExtendedAddress

extpanid (set)

Legt die erweiterte IEEE 802.15.4-PAN-ID fest.

Hinweis: Kann nur aufgerufen werden, wenn Thread-Protokolle deaktiviert sind. Ein erfolgreicher Aufruf dieser Funktion führt dazu, dass die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig werden.

Hinweis: Nach dem Ändern dieses Werts sind die aktuellen Anmeldedaten für die Inbetriebnahme veraltet. Zum Zurücksetzen pskc verwenden.

Parameter

extpanid extpanid

Beispiele

extpanid dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

• otThreadSetExtendedPanId

Expanid

Ruft die erweiterte IEEE 802.15.4-PAN-ID ab.

Parameter

Keine Parameter.

Beispiele

extpanid
dead00beef00cafe
Done

Befehlszeilen- und API-Referenzen

• otThreadGetExtendedPanId

auf Werkseinstellungen zurücksetzen

Löscht alle im nichtflüchtigen Speicher gespeicherten Einstellungen und löst dann ein Zurücksetzen der Plattform aus.

Parameter

Keine Parameter.

Beispiele

factoryreset

Befehlszeilen- und API-Referenzen

• otInstanceFactoryReset

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

• otThreadSendAddressNotification

Fem

Ruft externe FEM-Parameter ab.

Parameter

Keine Parameter.

Beispiele

fem
LNA gain 11 dBm
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetFemLnaGain

Fem Lnagain (get)

Ruft die Rx-LNA-Verstärkung der externen FEM in dBm ab.

Parameter

Keine Parameter.

Beispiele

fem lnagain
11
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetFemLnaGain

Fem Lnagain (set)

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

Parameter

Keine Parameter.

Beispiele

fem lnagain 8
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioSetFemLnaGain

Verlauf 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. Wird im Format hours:minutes:seconds:milliseconds angegeben.
• Ereignis: Mögliche Werte sind Added und Removed.
• Adresse/Präfixlänge: Unicast-Adresse mit ihrer Präfixlänge (in Bit).
• Ursprung: Mögliche Werte sind thread, slaac, dhcp6 oder manual.
• Bereich: IPv6-Adressbereich.
• P: Bevorzugt.
• V: Gültiges Flag.
• RLOC (R): Dieses Flag gibt an, ob die IPv6-Adresse ein Routing-Finder ist.

Hinweis: Für alle Befehle unter history muss die Funktion OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE aktiviert sein.

Parameter

history ipaddr [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerEntryAgeToString
• otHistoryTrackerIterateUnicastAddressHistory

Geschichte Ipmaddr

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

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

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

Parameter

history ipmaddr [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerEntryAgeToString
• otHistoryTrackerIterateMulticastAddressHistory

Verlauf Nachbar

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. Wird im Format hours:minutes:seconds:milliseconds angegeben.
• Geben Sie Child oder Router ein.
• Ereignis: Mögliche Werte sind Added, Removed oder Changed.
• Erweiterte Adresse
• RLOC16
• Modus: MLE-Linkmodus. Mögliche Werte:
  • -: Keine Flags festgelegt (rx-off-when-idle, minimales Thread-Gerät, stabile Netzwerkdaten).
  • r: rx-on-when-idle
  • d: Full-Thread-Gerät.
  • n: Vollständige Netzwerkdaten
• Ave RSS: Durchschnittliche Anzahl der Frames (in dBm), die zum Zeitpunkt der Aufzeichnung des Eintrags vom Nachbarn empfangen wurden.

Parameter

history neighbor [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateNeighborHistory

Verlauf von Netinfo

Zeigt den Netzwerkinfoverlauf im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

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

Parameter

history netinfo [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateNetInfoHistory

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. Wird im Format hours:minutes:seconds:milliseconds angegeben.
• Ereignis: Mögliche Werte sind Added und Removed.
• Präfix
• Markierungen/Bedeutung:
  • p: bevorzugtes Flag
  • a: Flag für die automatische Konfiguration von IPv6-Adressen.
  • d: Konfigurations-Flag für DHCPv6-IPv6-Adresse.
  • c: DHCPv6-Flag für andere Konfiguration.
  • r: Standard-Flag für die Route.
  • o: bei Mesh-Flag.
  • s: stabiles Flag.
  • n: Nd-Flag Dns.
  • D: Domainpräfix-Flag.
• Präf: Präferenz. Mögliche Werte sind high, med oder low.
• RLOC16

Parameter

history prefix [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateOnMeshPrefixHistory

Verlaufsroute

Zeigt den Verlauf der Netzwerkdaten externer Routen im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

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

Parameter

history route [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateExternalRouteHistory

Verlaufsrouter

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

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

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

Parameter

history router [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateRouterHistory

Verlauf Rx

Zeigt den RX-Verlauf von IPv6-Nachrichten im Tabellen- oder Listenformat an.

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

• Alter: Seit der Ausführung des Befehls verstrichene Zeit. Wird im Format hours:minutes:seconds:milliseconds angegeben.
• Typ:
  • IPv6-Nachrichtentyp, z. B. UDP, TCP, HopOpts und ICMP6 (und ihr Untertyp).
  • src: IPv6-Quelladresse und Portnummer.
  • dst: Ziel-IPv6-Adresse und Portnummer (die Portnummer gilt für UDP/TCP, andernfalls „0“).
• Len: Länge der IPv6-Nutzlast ohne IPv6-Header.
• Prüfsumme: Nachrichtenprüfsumme (gültig für UDP-, TCP- oder ICMP6-Nachrichten).
• Sek.: Gibt an, ob die Sicherheit auf Linkebene verwendet wurde.
• Prio: Nachrichtenpriorität. Mögliche Werte sind low, norm, high oder net (für Thread-Steuernachrichten).
• RSS: Signalstärke des empfangenen Signals (in dBm), gemittelt über alle empfangenen Fragment-Frames, aus denen die Nachricht besteht. Im TX-Verlauf wird NA (nicht zutreffend) angezeigt.
• Verzeichnis: Gibt an, ob die Nachricht gesendet (TX) oder empfangen (RX) wurde. Eine fehlgeschlagene Übertragung wird mit TX-F im Tabellenformat oder tx-success:no im Listenformat angezeigt. Zu einer fehlgeschlagenen Übertragung gehört beispielsweise, dass tx abgebrochen wird und keine ack vom Peer für eines der Nachrichtenfragmente gesendet wird.
• Nachbarn: Kurze Adresse (RLOC16) des Nachbarn, an den die Nachricht gesendet/empfangen wurde. Wenn der Frame übertragen wurde, wird er als bcast im Tabellenformat oder als 0xffff im Listenformat angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie als unknwn im Tabellenformat oder als 0xfffe im Listenformat angezeigt.
• Radio: Funklink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn OPENTHREAD_CONFIG_MULTI_RADIO aktiviert ist). Kann 15.4, trel oder all sein (falls bei allen Funkverbindungen gesendet).

Parameter

history rx [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateRxHistory

Geschichte von rxtx

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

Jeder Tabellen- oder Listeneintrag enthält Folgendes:

• Alter: Seit der Ausführung des Befehls verstrichene Zeit. Wird im Format hours:minutes:seconds:milliseconds angegeben.
• Typ:
  • IPv6-Nachrichtentyp, z. B. UDP, TCP, HopOpts und ICMP6 (und ihr Untertyp).
  • src: IPv6-Quelladresse und Portnummer.
  • dst: Ziel-IPv6-Adresse und Portnummer (die Portnummer gilt für UDP/TCP, andernfalls „0“).
• Len: Länge der IPv6-Nutzlast ohne IPv6-Header.
• Prüfsumme: Nachrichtenprüfsumme (gültig für UDP-, TCP- oder ICMP6-Nachrichten).
• Sek.: Gibt an, ob die Sicherheit auf Linkebene verwendet wurde.
• Prio: Nachrichtenpriorität. Mögliche Werte sind low, norm, high oder net (für Thread-Steuernachrichten).
• RSS: Signalstärke des empfangenen Signals (in dBm), gemittelt über alle empfangenen Fragment-Frames, aus denen die Nachricht besteht. Im TX-Verlauf wird NA (nicht zutreffend) angezeigt.
• Verzeichnis: Gibt an, ob die Nachricht gesendet (TX) oder empfangen (RX) wurde. Eine fehlgeschlagene Übertragung wird mit TX-F im Tabellenformat oder tx-success:no im Listenformat angezeigt. Zu einer fehlgeschlagenen Übertragung gehört beispielsweise, dass tx abgebrochen wird und keine ack vom Peer für eines der Nachrichtenfragmente gesendet wird.
• Nachbarn: Kurze Adresse (RLOC16) des Nachbarn, an den die Nachricht gesendet/empfangen wurde. Wenn der Frame übertragen wurde, wird er als bcast im Tabellenformat oder als 0xffff im Listenformat angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie als unknwn im Tabellenformat oder als 0xfffe im Listenformat angezeigt.
• Radio: Funklink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn OPENTHREAD_CONFIG_MULTI_RADIO aktiviert ist). Kann 15.4, trel oder all sein (falls bei allen Funkverbindungen gesendet).

Parameter

history rxtx [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateRxHistory
• otHistoryTrackerIterateTxHistory

Verlauf – TX

Zeigt den 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. Wird im Format hours:minutes:seconds:milliseconds angegeben.
• Typ:
  • IPv6-Nachrichtentyp, z. B. UDP, TCP, HopOpts und ICMP6 (und ihr Untertyp).
  • src: IPv6-Quelladresse und Portnummer.
  • dst: Ziel-IPv6-Adresse und Portnummer (die Portnummer gilt für UDP/TCP, andernfalls „0“).
• Len: Länge der IPv6-Nutzlast ohne IPv6-Header.
• Prüfsumme: Nachrichtenprüfsumme (gültig für UDP-, TCP- oder ICMP6-Nachrichten).
• Sek.: Gibt an, ob die Sicherheit auf Linkebene verwendet wurde.
• Prio: Nachrichtenpriorität. Mögliche Werte sind low, norm, high oder net (für Thread-Steuernachrichten).
• RSS: Signalstärke des empfangenen Signals (in dBm), gemittelt über alle empfangenen Fragment-Frames, aus denen die Nachricht besteht. Im TX-Verlauf wird NA (nicht zutreffend) angezeigt.
• Verzeichnis: Gibt an, ob die Nachricht gesendet (TX) oder empfangen (RX) wurde. Eine fehlgeschlagene Übertragung wird mit TX-F im Tabellenformat oder tx-success:no im Listenformat angezeigt. Zu einer fehlgeschlagenen Übertragung gehört beispielsweise, dass tx abgebrochen wird und keine ack vom Peer für eines der Nachrichtenfragmente gesendet wird.
• Nachbarn: Kurze Adresse (RLOC16) des Nachbarn, an den die Nachricht gesendet/empfangen wurde. Wenn der Frame übertragen wurde, wird er als bcast im Tabellenformat oder als 0xffff im Listenformat angezeigt. Wenn die Kurzadresse des Nachbarn nicht verfügbar ist, wird sie als unknwn im Tabellenformat oder als 0xfffe im Listenformat angezeigt.
• Radio: Funklink, über den die Nachricht gesendet/empfangen wurde (nützlich, wenn OPENTHREAD_CONFIG_MULTI_RADIO aktiviert ist). Kann 15.4, trel oder all sein (falls bei allen Funkverbindungen gesendet).

Parameter

history tx [list] [num-entries]

• Mit der Option list rufen Sie die Ausgabe im Listenformat auf. Andernfalls wird die Ausgabe im Tabellenformat angezeigt.
• Mit der Option num-entries können Sie die Ausgabe auf die angegebene Anzahl der zuletzt angegebenen Einträge 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

• otHistoryTrackerIterateTxHistory

ifconfig (oben,unten)

Hebt die IPv6-Schnittstelle auf oder ab.

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

• otIp6SetEnabled

ifconfig

Gibt an, ob die IPv6-Schnittstelle aktiv ist.

Parameter

Keine Parameter.

Beispiele

ifconfig
down
Done

ifconfig
up
Done

Befehlszeilen- und API-Referenzen

• otIp6IsEnabled

instanceid

Ruft die Instanzkennung ab.

Die Instanzkennung wird beim Erstellen der Instanz auf einen zufälligen Wert festgelegt. Dieser Wert ändert sich nach der Initialisierung nicht.

Parameter

Keine Parameter.

Beispiele

instanceid
468697314
Done

Befehlszeilen- und API-Referenzen

• otInstanceGetId

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 extern hinzugefügter 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

• otIp6AddUnicastAddress

Ipaddr Del

Entfernt eine Netzwerkschnittstellenadresse aus der Thread-Schnittstelle.

Parameter

ipaddr del aAddress

Beispiele

ipaddr del 2001::dead:beef:cafe
Done

Befehlszeilen- und API-Referenzen

• otIp6RemoveUnicastAddress

Ipaddr

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

Parameter

ipaddr [-v]

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

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

Beispiele

ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done

Befehlszeilen- und API-Referenzen

• otIp6GetUnicastAddresses

Ipaddr – Linklokal

Ruft die Link-Local-IPv6-Adresse des Threads ab.

Die lokale Adresse des Thread-Links 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

• otThreadGetLinkLocalIp6Address

Ipaddr Mleid

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

• otThreadGetMeshLocalEid

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

• otThreadGetRloc

Hinzufügen von IPMaddr

Abonniert die Thread-Schnittstelle einer Netzwerkschnittstellen-Multicast-Adresse.

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

Parameter

ipmaddr add aAddress

Beispiele

ipmaddr add ff05::1
Done

Befehlszeilen- und API-Referenzen

• otIp6SubscribeMulticastAddress

Ipmaddr Del

Kündigt die Thread-Schnittstelle von einer Netzwerkschnittstellen-Multicast-Adresse.

Parameter

ipmaddr del aAddress

Beispiele

ipmaddr del ff05::1
Done

Befehlszeilen- und API-Referenzen

• otIp6UnsubscribeMulticastAddress

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

• otIp6GetMulticastAddresses

Ipmaddr LATN

Ruft die Multicast-Adresse für Thread-Link-Local – alle Thread-Knoten ab.

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

• flgs ist auf 3 gesetzt (P = 1 und T = 1)
• Scop auf 2 festgelegt
• Plen auf 64 festgelegt
• 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

• otThreadGetLinkLocalAllThreadNodesMulticastAddress

ISMaddr Rlatn

Ruft die Multicast-Adresse von Thread Realm-Local All Thread Nodes ab.

Die Adresse ist eine bereichsbasierte Unicast-Präfixbasierte Multicast-Adresse [RFC 3306] mit:

• flgs ist auf 3 gesetzt (P = 1 und T = 1)
• Scop auf 3 festgelegt
• Plen auf 64 festgelegt
• 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

• otThreadGetRealmLocalAllThreadNodesMulticastAddress

Joiner Discerner (Satz)

Legt den Joiner Discerner fest.

Hinweis: Der Joiner Discerner ersetzt den Joiner EUI-64 während der Joiner-Sitzung der Thread-Inbetriebnahme.

Parameter

joiner discerner discerner

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

Beispiele

joiner discerner 0xabc/12
Done

Befehlszeilen- und API-Referenzen

• otJoinerSetDiscerner

Joiner Discerner klar

Löscht den Joiner-Unterscheider.

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

• otJoinerGetDiscerner

Joiner-Hilfe

Drucken Sie das Hilfemenü joiner aus.

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 kein Joiner Discerner festgelegt ist, sind die ersten 64 Bits der Berechnung von SHA-256 über die werkseitig zugewiesene IEEE EUI-64. Andernfalls wird die Joiner-ID aus dem Wert des Joiner Discerner 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

• otJoinerGetId

Joiner-Start

Aktiviert die Rolle „Thread Joiner“.

Parameter

joiner start joining-device-credential [provisioning-url]

• joining-device-credential: Joiner-Passphrase. Muss ein String aus allen alphanumerischen Zeichen in Großbuchstaben (0–9 und A–Y, mit Ausnahme von I, O, Q und Z) sein, um die Lesbarkeit zu verbessern, mit einer Länge zwischen 6 und 32 Zeichen.
• provisioning-url: Bereitstellungs-URL für den Joiner (optional).

Beispiele

joiner start J01NM3
Done

Befehlszeilen- und API-Referenzen

• otJoinerStart

Joiner State

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

• otJoinerGetState

Joiner Stop

Deaktiviert die Rolle „Thread Joiner“.

Parameter

Keine Parameter.

Beispiele

joiner stop
Done

Befehlszeilen- und API-Referenzen

• otJoinerStop

Joinerport (Satz)

Legt den Joiner-UDP-Port fest.

Parameter

joinerport udp-port

Beispiele

joinerport 1000
Done

Befehlszeilen- und API-Referenzen

• otThreadSetJoinerUdpPort

Joinerport

Ruft den Joiner-UDP-Port ab.

Parameter

Keine Parameter.

Beispiele

joinerport
1000
Done

Befehlszeilen- und API-Referenzen

• otThreadGetJoinerUdpPort

Tastensequenzzähler (set)

Legt den thrKeySequenceCounter fest.

Hinweis :Diese API ist nur für Test- und Demozwecke reserviert. Wenn Sie die Einstellungen mit dieser API ändern, ist eine Produktionsanwendung nicht mehr mit der Thread-Spezifikation kompatibel.

Parameter

keysequence counter counter

Beispiele

keysequence counter 10
Done

Befehlszeilen- und API-Referenzen

• otThreadSetKeySequenceCounter

Tastensequenzzähler

Ruft den thrKeySequenceCounter ab.

Parameter

Keine Parameter.

Beispiele

keysequence counter
10
Done

Befehlszeilen- und API-Referenzen

• otThreadGetKeySequenceCounter

Schlüsselsequenz-Guardtime (festgelegt)

Legt die thrKeySwitchGuardTime (in Stunden) fest.

Hinweis :Diese API ist nur für Test- und Demozwecke reserviert. Wenn Sie die Einstellungen mit dieser API ändern, ist eine Produktionsanwendung nicht mehr mit der Thread-Spezifikation kompatibel.

Parameter

keysequence guardtime guardtime-hours

Verwende 0 bis Thread Key Switch, wenn eine Schlüsselindexübereinstimmung vorliegt.

Beispiele

keysequence guardtime 0
Done

Befehlszeilen- und API-Referenzen

• otThreadSetKeySwitchGuardTime

Guardtime für Schlüsselsequenz

Ruft die thrKeySwitchGuardTime (in Stunden) ab.

Parameter

Keine Parameter.

Beispiele

keysequence guardtime
0
Done

Befehlszeilen- und API-Referenzen

• otThreadGetKeySwitchGuardTime

Leaderdaten

Ruft die Daten des Thread-Leaders 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

• otThreadGetLeaderData

Leaderweight (set)

Legt das Gewicht des Thread-Leaders fest, der in der Rolle „Leader“ verwendet wird.

Setzt die Leader-Gewichtung direkt auf den neuen Wert, wodurch der vorherige Wert ersetzt wird (der möglicherweise aus dem aktuellen otDeviceProperties ermittelt wurde).

Parameter

leaderweight weight

Beispiele

leaderweight 128
Done

Befehlszeilen- und API-Referenzen

• otThreadSetLocalLeaderWeight

führendes Gewicht

Ruft das Gewicht des Thread-Leaders ab, der in der Rolle „Leader“ verwendet wird.

Parameter

Keine Parameter.

Beispiele

leaderweight
128
Done

Befehlszeilen- und API-Referenzen

• otThreadGetLocalLeaderWeight

Linkmetrics-Konfiguration erweitert – Bestätigung löschen

Sendet eine Anfrage zur Verwaltung von Link-Messwerten, um eine erweiterte Bestätigung auf Basis einer Prüfung zu löschen.

Parameter

linkmetrics config [async] peer-ipaddr enhanced-ack clear

• async: Nicht blockierenden Modus verwenden.
• peer-ipaddr sollte die Link-Local-Adresse des Nachbargeräts sein.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkMetricsConfigEnhAckProbing

Linkmetrics-Konfigurationsdatei für erweiterte Bestätigung

Die zusätzliche r ist optional und wird nur für Referenzgeräte verwendet. Wenn diese Option angegeben wird, wird der Typ/Durchschnitts-Enum-Wert jedes Typ-ID-Flags auf „reserviert“ gesetzt. Hiermit wird überprüft, ob das Prüfungssubjekt ungültige Typ-ID-Flags korrekt verarbeitet. Diese Funktion ist nur verfügbar, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Sendet eine Anfrage zur Verwaltung von Link-Messwerten, um eine erweiterte Bestätigung per Prüfung zu registrieren.

Parameter

linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]

• async: Nicht blockierenden Modus verwenden.
• [q, m und r] sind otLinkMetricsValues zugeordnet. Gemäß Spezifikation 4.11.3.4.4.6 kannst du maximal zwei Optionen gleichzeitig verwenden, z. B. q oder qm.
  • q: Ebene-2-LQI.
  • m: Linkrand.
  • r: RSSI.

Beispiele

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

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

Befehlszeilen- und API-Referenzen

• otLinkMetricsConfigEnhAckProbing

Linkmetrics-Konfiguration – weiterleiten

Sendet eine Anfrage zur MLE-Link-Messwertverwaltung zum Konfigurieren oder Löschen einer Forward Tracking-Serie.

Parameter

linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]

• async: Nicht blockierenden Modus verwenden.
• peer-ipaddr: Peer-Adresse.
• series-id: Die Serien-ID.
• [l, d, r und a] werden otLinkMetricsSeriesFlags zugeordnet. X steht für keine der otLinkMetricsSeriesFlags, stoppt die Erfassung und entfernt die Reihe.
  • l: MLE-Link-Prüfung.
  • d: MAC-Daten.
  • r: MAC-Datenanfrage.
  • a: MAC-Bestätigung
  • X: Kann nur ohne andere Flags verwendet werden.
• [p, q, m und r] sind otLinkMetricsValues zugeordnet.
  • p: Ebene-2-Anzahl der empfangenen PDUs.
  • q: Ebene-2-LQI.
  • m: Linkrand.
  • r: RSSI.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkMetricsConfigForwardTrackingSeries

Linkmetrics-Prüfung

Sendet eine Nachricht zur MLE-Linkprüfung.

Parameter

linkmetrics probe peer-ipaddr series-id length

• peer-ipaddr: Peer-Adresse.
• series-id: Die Serien-ID, auf die diese Prüfungsnachricht ausgerichtet ist.
• 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

• otLinkMetricsSendLinkProbe

linkmetrics Anfrageweiterleitung

Führen Sie eine Abfrage für Linkmesswerte (Forward Tracking Series) durch.

Parameter

linkmetrics query [async] peer-ipaddr forward series-id

• async: Nicht blockierenden Modus verwenden.
• peer-ipaddr: Peer-Adresse.
• series-id: Die Serien-ID.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkMetricsQuery

linkmetrics-Anfrage einzeln

Führen Sie eine Linkmesswert-Abfrage durch (einzelne Prüfung).

Parameter

linkmetrics request [async] peer-ipaddr single [pqmr]

• async: Nicht blockierenden Modus verwenden.
• peer-ipaddr: Peer-Adresse.
• [p, q, m und r] sind otLinkMetrics zugeordnet.
  • p: Ebene-2-Anzahl der empfangenen PDUs.
  • q: Ebene-2-LQI.
  • m: Linkrand.
  • r: RSSI.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkMetricsQuery

linkmetricsmgr (aktivieren,deaktivieren)

Link Metrics Manager aktivieren oder deaktivieren.

Parameter

linkmetricsmgr enable|disable

Beispiele

linkmetricmgr enable
Done

linkmetricmgr disable
Done

Befehlszeilen- und API-Referenzen

• otLinkMetricsManagerSetEnabled

Linkmetricsmgr-Show

Ruft Link-Messwert-Daten eines Nachbarn anhand seiner erweiterten Adresse ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkMetricsManagerGetMetricsValueByExtAddr

lokalisieren (set)

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

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

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

• otThreadLocateAnycastDestination

suchen

Ruft den aktuellen Status (In Progress oder Idle) eines Anycast-Finders 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

• otThreadIsAnycastLocateInProgress

Protokolldateiname

Gibt den Dateinamen zum Erfassen von otPlatLog() -Nachrichten an. Dies ist hilfreich bei der Fehlerbehebung für automatisierte Testskripts unter Linux, wenn die Protokollierung die automatisierten Testskripts beeinträchtigt.

Erfordert OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART und OPENTHREAD_POSIX.

Parameter

log filename filename

Beispiele

Befehlszeilen- und API-Referenzen

• otPlatDebugUart_logfile

Logebene (festgelegt)

Legt die Logebene fest.

Hinweis :Für diese Funktion ist OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1 erforderlich.

Parameter

log level level

Beispiele

log level 4
Done

Befehlszeilen- und API-Referenzen

• otLoggingSetLevel

Logebene

Rufen Sie die Logebene ab.

Parameter

Keine Parameter.

Beispiele

log level
1
Done

Befehlszeilen- und API-Referenzen

• otLoggingGetLevel

MAC-Wiederholungsversuche (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-Wiederholungsversuche festzulegen.

Beispiele

mac retries direct
3
Done

mac retries direct 5
Done

Befehlszeilen- und API-Referenzen

• otLinkGetMaxFrameRetriesDirect
• otLinkSetMaxFrameRetriesDirect

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

• otLinkGetMaxFrameRetriesIndirect
• otLinkSetMaxFrameRetriesIndirect

MAC senden

Weist ein Rx-Off-When-Idle-Gerät an, einen MAC-Frame an sein übergeordnetes Element zu senden. Dieser Befehl dient der 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 zwei Argumente auswählen:

• datarequest: Stellt eine IEEE 802.15.4-Datenanfragenachricht zur Ü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

• otLinkSendDataRequest
• otLinkSendEmptyData

Macfilter addr add

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. Wenn Sie das optionale Argument rss angeben, wird damit 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 keinen Standardwert festgelegt haben, wird die Stärke des terrestrisches Signal verwendet.

Parameter

macfilter addr add extaddr [rss]

Beispiele

macfilter addr add 0f6127e33af6b403 -95
Done

macfilter addr add 0f6127e33af6b402
Done

Befehlszeilen- und API-Referenzen

• otLinkFilterAddAddress

Zulassungsliste für Macfilter addr

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

Parameter

Keine Parameter.

Beispiele

macfilter addr allowlist
Done

Befehlszeilen- und API-Referenzen

• otLinkFilterSetAddressMode

Macfilter addr 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.

Hinweis: Dieser Befehl wirkt sich nicht auf Einträge in der RssIn-Liste aus. Diese Liste enthält erweiterte Adressen, bei denen für rss ein fester Wert festgelegt wurde, der vom Standardwert abweicht.

Parameter

Keine Parameter.

Beispiele

macfilter addr clear
Done

Befehlszeilen- und API-Referenzen

• otLinkFilterClearAddresses

Sperrliste für Macfilter addr

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

Parameter

Keine Parameter.

Beispiele

macfilter addr denylist
Done

Befehlszeilen- und API-Referenzen

• otLinkFilterSetAddressMode

Macfilter addr deaktivieren

Deaktiviert die MAC-Filtermodi.

Parameter

Keine Parameter.

Beispiele

macfilter addr disable
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Macfilter addr

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

Enthält die folgenden Informationen:

• Aktueller Modus der MAC-Filterliste: AllowList, DenyList, oder Disabled
• Eine Liste aller erweiterten Adressen im Filter. Die Empfangsstärke (rss) und der Linkqualitätsindikator (lqi) werden neben der Adresse aufgeführt, wenn diese Werte von den Standardwerten abweichen.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkFilterGetAddressMode

Macfilter addr 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.

Hinweis: Wenn die angegebene erweiterte Adresse nicht mit einem Eintrag in der MAC-Filterliste übereinstimmt, wird keine Aktion ausgeführt.

Parameter

macfilter addr remove extaddr

Beispiele

macfilter addr remove 0f6127e33af6b402
Done

Befehlszeilen- und API-Referenzen

• otLinkFilterRemoveAddress

Macfilter

Enthält die folgenden Informationen:

• Address Mode: Aktueller Modus des MAC-Filters: AllowList, DenyList, oder Disabled
• Eine Liste aller erweiterten Adressen in der MAC-Filterliste. Die Empfangsstärke (rss) und der Linkqualitätsindikator (lqi) werden neben der Adresse aufgeführt, wenn diese Werte von den Standardwerten abweichen.
• Eine separate Liste (RssIn List), in der alle erweiterten Adressen angezeigt werden, bei denen „rss“ so festgelegt wurde, dass sie vom Standardwert abweicht.
• Default rss: Zeigt gegebenenfalls die Standardwerte für die Einstellungen rss und lqi an.

Hinweis: Eine erweiterte Adresse kann in der RssIn-Liste enthalten sein, aber nicht in der MAC-Filterliste.

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

• otLinkFilterSetAddressMode
• otLinkFilterGetNextAddress
• otLinkFilterGetNextRssIn

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 die Empfangsstärke (in dBm) für Nachrichten von dieser Adresse fest.

Hinweis: Die Liste RssIn enthält erweiterte Adressen, deren Werte für rss oder Linkqualitätsindikator (lqi) von den Standardwerten abweichen.

Parameter

macfilter rss add extaddr rss

Um einen Standardwert für die empfangene Signalstärke aller 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

• otLinkFilterAddRssIn

Macfilter RSS-Add-Lqi

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

Hinweis: Die Liste RssIn enthält erweiterte Adressen, deren Werte für lqi oder die Empfangsstärke (rss) nicht mit den Standardwerten übereinstimmen. lqi wird automatisch in einen entsprechenden rss-Wert konvertiert.

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 den Link-Qualitätsindikator 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

• otLinkConvertLinkQualityToRss
• otLinkFilterSetDefaultRssIn

Macfilter RSS löschen

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

Wenn Sie diese Aktion ausführen, verwenden alle erweiterten Adressen das On-Air-Signal.

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

• otLinkFilterClearAllRssIn

Macfilter RSS

Enthält die folgenden Informationen:

• Liste aller erweiterten Adressen, bei denen festgelegt wurde, dass die Signalstärke (rss) vom Standardwert abweicht. Außerdem wird der Link-Qualitätsindikator (lqi) angezeigt. Die Einstellungen rss und lqi sind einander zugeordnet. Wenn Sie eines festlegen, wird der Wert des anderen automatisch festgelegt. Diese Liste von Adressen wird als RssIn List bezeichnet. Wenn Sie entweder rsi oder lqi festlegen, wird die entsprechende erweiterte Adresse der RssIn-Liste hinzugefügt.
• Default rss: Zeigt gegebenenfalls die Standardwerte für die Einstellungen rss und lqi an.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otLinkFilterGetNextRssIn

macfilter rss entfernen

Entfernt die angegebene erweiterte Adresse aus der Liste RssIn.

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

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

Wenn kein Eintrag in der RssIn-Liste vorhanden ist, der mit der angegebenen erweiterten Adresse übereinstimmt, 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, Einträge aus der RssIn-Liste werden jedoch nicht entfernt.

Beispiele

macfilter rss remove *
Done

macfilter rss remove 0f6127e33af6b404
Done

Befehlszeilen- und API-Referenzen

• otLinkFilterRemoveRssIn

Meshdiag untergeordnete IP-Adresse6

Senden Sie eine Abfrage an ein übergeordnetes Element, um die IPv6-Adressen aller untergeordneten MTD-Elemente 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

• otMeshDiagQueryChildrenIp6Addrs

Untergeordnete Tabelle mit Meshdiag

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

• RLOC16
• Erweiterte MAC-Adresse
• Thread-Version
• Zeitlimit (in Sekunden)
• Alter (Sekunden seit der letzten Erfassung)
• Überwachungsintervall (in Sekunden)
• Anzahl der Nachrichten in der Warteschlange (falls das Kind inaktiv ist)
• Gerätemodus
• RSS (Durchschnitt und letzter)
• Fehlerraten: Frame tx (auf MAC-Schicht), IPv6-Nachrichten tx (über MAC)
• Verbindungszeit (Sekunden seit dem Format des {dd}d.{hh}:{mm}:{ss}-Verbindungsaufbaus)
• CSL-Informationen:
  • Falls synchronisiert
  • Zeitraum (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 Nachbar

Starten Sie eine Abfrage für die Tabelle der Nachbarn (Router) eines Routers mit einem bestimmten RLOC16. Die Ausgabe listet alle Einträge der Nachbarn des Routers auf. Informationen pro Beitrag:

• RLOC16
• Erweiterte MAC-Adresse
• Thread-Version
• RSS (Durchschnitt und letzter) und Link-Marge
• Fehlerraten, Frame tx (auf MAC-Schicht), IPv6-Nachrichten tx (über MAC)
• Verbindungszeit (Sekunden seit dem Format des {dd}d.{hh}:{mm}:{ss}-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

• otMeshDiagQueryRouterNeighborTable

Meshdiag-Topologie

Netzwerktopologie prüfen (Liste der Router und ihrer Verbindungen) Parameter sind optional und kennzeichnen zusätzliche Artikel, die entdeckt werden sollen. 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 dieses Gerät selbst ist (me)
• Gibt an, ob der Router dem Gerät übergeordnet ist, wenn das Gerät ein Kind 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 einen Link hat:
  • 3-links: Router-IDs, an die dieser Router einen eingehenden Link mit Linkqualität 3 hat
  • 2-links: Router-IDs, an die dieser Router einen eingehenden Link mit Linkqualität 2 hat
  • 1-links: Router-IDs, an die dieser Router einen eingehenden Link mit der Linkqualität 1 hat
  • Wenn eine Liste leer ist, wird sie im Out-Element weggelassen.
• Falls ip6-addrs, Liste der IPv6-Adressen des Routers
• Falls children, Liste aller untergeordneten Elemente des Routers. Informationen pro Kind:
  • RLOC16
  • Qualität eingehender Links aus der Perspektive der übergeordneten zu untergeordneten Seite (Null bedeutet unbekannt)
  • Untergeordneter Gerätemodus (r rx-on-when-idle, d Full-Thread-Gerät, n vollständige Netzwerkdaten, - keine Flags festgelegt)
  • Gibt an, ob das Kind dieses Gerät selbst ist (me)
  • Gibt an, ob das untergeordnete Element als Border-Router für externe Konnektivität fungiert (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

• otMeshDiagDiscoverTopology

Mleadvimax

Ruft den aktuellen Wert für das maximale Intervall ab, der vom Werbe-Trickle-Timer verwendet wird.

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

Parameter

Keine Parameter.

Beispiele

mleadvimax
12000
Done

Befehlszeilen- und API-Referenzen

• otThreadGetAdvertisementTrickleIntervalMax

Mliid

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

Erfordert OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

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

Nur zum Testen/Referenzgerät.

Parameter

mliid iid

Beispiele

mliid 1122334455667788
Done

Befehlszeilen- und API-Referenzen

• otIp6SetMeshLocalIid

MLR Reg.

Registriert Multicast-Listener beim primären Backbonerouter.

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 auf dem primären Backbone Router zu verwenden.

Verwenden Sie „zeitlimit = 0“, um die Registrierung von Multicast-Listenern 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

• otIp6RegisterMulticastListeners

mode (get,set)

Konfiguration für den MLE-Linkmodus festlegen

Parameter

mode [rdn]

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

Beispiele

mode rdn
Done

mode -
Done

Befehlszeilen- und API-Referenzen

• otThreadSetLinkMode

Multiradio

Rufen Sie die Liste der unterstützten Funklinks für das 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-Funkverbindungsinformationen 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

• otMultiRadioGetNeighborInfo

Multi-Radio-Nachbar

Ruft die Multi-Funkverbindungsinformationen 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

• otMultiRadioGetNeighborInfo

nat64 (aktivieren,deaktivieren)

NAT64-Funktionen aktivieren oder deaktivieren.

Hinweis: Dies gilt für NAT64 Translator (wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist) und NAT64 Prefix Manager (wenn OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE aktiviert ist).

Wenn OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE aktiviert ist und die Einstellung auf „true“ gesetzt 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

• otNat64SetEnabled

Nat64 Cider

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

• otNat64GetCidr

nat64-Zähler

Ruft das NAT64-Übersetzerpaket und die Fehlerzähler 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

• otNat64GetCounters
• otNat64GetErrorCounters

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

• otNat64GetNextAddressMapping

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 Routing-Manager 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 einer höheren 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: NAT64-Übersetzer ist deaktiviert.
• NotRunning: NAT64-Übersetzer ist aktiviert, übersetzt aber keine Pakete. Dies kann bedeuten, dass der Übersetzer 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

• otNat64GetPrefixManagerState
• otNat64GetTranslatorState

Liste der Nachbarn

Gibt die Verbindungszeit und das Alter der Nachbarn aus. Dieser Befehl ähnelt neighbor conntime, die Informationen werden jedoch in einem Listenformat angezeigt. Alter und 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

Nachbar Conntime

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

• RLOC16
• Erweiterter MAC
• Zuletzt gehört (Alter): Anzahl der Sekunden, seitdem du das letzte Mal von einem Nachbarn gehört hast.
• Verbindungszeit: Anzahl der Sekunden seit dem Aufbau einer Verbindung mit dem Nachbarn. Dauerintervalle sind als {hh}:{mm}:{ss} für Stunden, Minuten und Sekunden formatiert, wenn die Dauer weniger als einen Tag beträgt. Wenn die Dauer mehr als einen Tag beträgt, wird das Format {dd}d.{hh}:{mm}:{ss} verwendet.

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-Kontaktliste

Nachbar-Linkqualität

Gibt Informationen zur Verbindungsqualität aller 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

Liste der Nachbarn

Listet die RLOC16 jedes Nachbarn auf.

Parameter

Keine Parameter.

Beispiele

neighbor list
0xcc01 0xc800 0xf000
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Nachbartabelle

Gibt Informationen zu allen 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 an
• D: Full-Thread-Gerät
• N: vollständige Netzwerkdaten

Parameter

Keine Parameter.

Beispiele

neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC     |
+------+--------+-----+----------+-----------+-+-+-+------------------+
|   C  | 0xcc01 |  96 |      -46 |       -46 |1|1|1| 1eb9ba8a6522636b |
|   R  | 0xc800 |   2 |      -29 |       -29 |1|1|1| 9a91556102c39ddb |
|   R  | 0xf000 |   3 |      -28 |       -28 |1|1|1| 0ad7ed6beaa6016d |
Done

Befehlszeilen- und API-Referenzen

• otThreadGetNextNeighborInfo

Netdata voll

Mit „Ja“ drucken oder „Nein“ gibt an, ob die Spalte „Nettodaten voll“ Callback wurde seit Beginn des Thread-Vorgangs oder seit dem letzten Zurücksetzen des Flags mit netdata full reset aufgerufen. Für diesen Befehl ist OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL erforderlich. Die Spalte „Nettodaten voll“ -Rückruf wird immer dann ausgelöst, wenn

• Das Gerät fungiert als Leader und empfängt eine Netzwerkdatenregistrierung von einem Border Router (BR), die es nicht zu Netzwerkdaten hinzufügen kann, weil der Speicherplatz ausgeht.
• Das Gerät fungiert als AF und es können keine neuen Einträge zu den lokalen Netzwerkdaten hinzugefügt werden.
• Das Gerät fungiert als AF 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

• otBorderRouterSetNetDataFullCallback

netdata vollständig zurücksetzen

Markierung für „Nettodaten voll“ zurücksetzen -Callback ausgelöst wurde.

Parameter

Keine Parameter.

Beispiele

netdata full reset
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Netzdatenlänge

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

Parameter

Keine Parameter.

Beispiele

netdata length
23
Done

Befehlszeilen- und API-Referenzen

• otNetDataGetLength

Netdata-Maximallänge

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

Parameter

Keine Parameter.

Beispiele

netdata maxlength
40
Done

Befehlszeilen- und API-Referenzen

• otNetDataGetMaxLength

Netdata-Maximallänge zurücksetzen

Setzen Sie die erfasste maximale Länge der Thread-Netzwerkdaten zurück.

Parameter

Keine Parameter.

Beispiele

netdata maxlength reset
Done

Befehlszeilen- und API-Referenzen

• otNetDataResetMaxLength

netdata Publish DNSsrp Anycast

Veröffentlicht eine Anycast-Adresse des DNS/SRP-Dienstes mit einer Sequenznummer. Jeder aktuelle DNS/SRP-Diensteintrag, der über einen vorherigen publish dnssrp{anycast|unicast}-Befehl veröffentlicht wurde, wird entfernt und durch neue 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 Portinformationen sind in den Dienst-TLV-Daten enthalten. Jeder aktuelle DNS/SRP-Diensteintrag, der über einen vorherigen publish dnssrp{anycast|unicast}-Befehl veröffentlicht wurde, wird entfernt und durch neue 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 Server-TLV-Daten enthalten. Mit dem Befehl netdata publish dnssrp unicast (addr,port) können Sie eine andere Unicast-Adresse verwenden.

Jeder aktuelle DNS/SRP-Diensteintrag, der über einen vorherigen publish dnssrp{anycast|unicast}-Befehl veröffentlicht wurde, wird entfernt und durch neue 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-Veröffentlichungspräfix

Veröffentlichen Sie einen On-Mesh-Präfixeintrag. Weitere Informationen finden Sie unter Netzwerkdaten mit der 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

• otNetDataPublishOnMeshPrefix

Netdata Publish ersetzen

Ersetzt einen zuvor veröffentlichten externen Routeneintrag. Weitere Informationen finden Sie unter Netzwerkdaten mit der 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

• otNetDataReplacePublishedExternalRoute

netdata-route für veröffentlichungen

Veröffentlichen Sie einen externen Routeneintrag. Weitere Informationen finden Sie unter Netzwerkdaten mit der 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

• otNetDataPublishExternalRoute

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 Netzwerkdaten mit der OT-Befehlszeile anzeigen und verwalten.

Parameter

Keine Parameter.

Beispiele

netdata register
Done

Befehlszeilen- und API-Referenzen

• Präfix hinzufügen
• otBorderRouterRegister
• otServerAddService

netdata steeringdata check (Erkennung)

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

Parameter

netdata steeringdata check discerner

• discerner: Der JOINer im Format {number}/{length}.

Beispiele

netdata steeringdata check 0xabc/12
Done

netdata steeringdata check 0xdef/12
Error 23: NotFound

Befehlszeilen- und API-Referenzen

• otNetDataSteeringDataCheckJoinerWithDiscerner
• Joiner Discerner

Netdata-SteeringData-Prüfung (eui64)

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

Parameter

netdata steeringdata check eui64

• eui64: Die IEEE-EUI-64 des Joiner-Elements.

Beispiele

netdata steeringdata check d45e64fa83f81cf7
Done

Befehlszeilen- und API-Referenzen

• otNetDataSteeringDataCheckJoiner
• eui64

Veröffentlichung von netdata aufheben (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 Netzwerkdaten mit der OT-Befehlszeile anzeigen und verwalten.

Parameter

netdata unpublish prefix

Beispiele

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

Befehlszeilen- und API-Referenzen

• otNetDataUnpublishPrefix

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

• otNetDataUnpublishDnsSrpService

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

• otUdpGetSockets

Netzwerkdiagnose abrufen

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

Parameter

networkdiagnostic get addr type(s)

Für addr löst eine Unicast-Adresse ein Diagnostic Get aus. Eine Multicast-Adresse löst ein Diagnostic Query aus. Die TLV-Werte, die Sie angeben können (durch ein Leerzeichen getrennt, wenn Sie mehrere TLV-Werte angeben):

• 0: Erweiterte MAC-Adresse (TLV)
• 1: Adresse 16 TLV
• 2: Modus TLV
• 3: Zeitlimit TLV (der maximale Abfragezeitraum für SEDs)
• 4: Konnektivitäts-TLV
• 5: Route64 TLV
• 6: Daten zum führenden Anbieter (TLV)
• 7: Netzwerkdaten-TLV
• 8: IPv6-Adressliste (TLV)
• 9: MAC-Zähler TLV
• 14: Akkustand – TLV
• 15: Versorgungsspannung TLV
• 16: Untergeordnete Tabelle TLV
• 17: Kanalseiten (TLV)
• 19: Zeitlimit für max. untergeordnetes Limit – TLV
• 23: EUI64 TLV
• 24: Version TLV (Versionsnummer für die Protokolle und Funktionen)
• 25: Anbietername TLV
• 26: Anbietermodell – TLV
• 27: Anbieter-Softwareversion – TLV
• 28: Thread-Stack-Version TLV (Versionskennung als UTF-8-String für Thread-Stack-Codebasis/commit/Version)
• 29: Kinder-TLV
• 34: MLE-Zähler – TLV
• 35: Anbieter-App-URL – TLV

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

• otThreadSendDiagnosticGet

Netzwerkdiagnose zurücksetzen

Sendet eine Netzwerkdiagnoseanfrage zum Zurücksetzen der angegebenen Typlängenwerte für die angegebene (n) Adresse(n). 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

• otThreadSendDiagnosticReset

networkidtimeout (get,set)

Ruft den NETWORK_ID_TIMEOUT-Parameter ab oder legt ihn fest.

Hinweis: Dieser Befehl ist nur für Test- und Demozwecke reserviert. Wenn Sie die Einstellungen mit dieser API ändern, ist eine Produktionsanwendung nicht mehr mit der Thread-Spezifikation kompatibel.

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

• otThreadGetNetworkIdTimeout
• otThreadSetNetworkIdTimeout

networkkey (Schlüssel)

Legen Sie den Thread-Netzwerkschlüssel fest.

Funktioniert nur, wenn Thread-Protokolle deaktiviert sind. Ein erfolgreicher Aufruf dieser Funktion führt dazu, dass die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig werden.

Parameter

networkkey key

Beispiele

networkkey 00112233445566778899aabbccddeeff
Done

Befehlszeilen- und API-Referenzen

• otThreadSetNetworkKey

Netzwerkschlüssel

Thread-Netzwerkschlüssel abrufen.

Parameter

Keine Parameter.

Beispiele

networkkey
00112233445566778899aabbccddeeff
Done

Befehlszeilen- und API-Referenzen

• otThreadGetNetworkKey

Netzwerkname (Name)

Legen Sie den Thread-Netzwerknamen fest.

Funktioniert nur, wenn Thread-Protokolle deaktiviert sind. Ein erfolgreicher Aufruf dieser Funktion führt dazu, dass die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig werden.

Hinweis :Nachdem dieser Wert geändert wurde, sind die aktuellen Anmeldedaten für die Inbetriebnahme veraltet. Zum Zurücksetzen pskc verwenden.

Parameter

networkname name

Beispiele

networkname OpenThread
Done

Befehlszeilen- und API-Referenzen

• otThreadSetNetworkName

Netzwerkname

Rufen Sie den Thread-Netzwerknamen ab.

Parameter

Keine Parameter.

Beispiele

networkname
OpenThread
Done

Befehlszeilen- und API-Referenzen

• otThreadGetNetworkName

Netzwerkzeit (festgelegt)

Legt die Parameter für die Zeitsynchronisierung fest.

• timesyncperiod: Der Zeitraum der zeitlichen Synchronisierung in Sekunden.
• xtalthreshold: der XTAL-Genauigkeitsgrenzwert für ein Router-fähiges Gerät in PPM.

Parameter

networktime timesyncperiod xtalthreshold

Beispiele

networktime 100 300
Done

Befehlszeilen- und API-Referenzen

• otNetworkTimeSetSyncPeriod
• otNetworkTimeSetXtalThreshold

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

• otNetworkTimeGet
• otNetworkTimeGetSyncPeriod
• otNetworkTimeGetXtalThreshold

nexthop (get)

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

Kann verwendet werden, wobei entweder aNextHopRloc16 oder aPathCost NULL ist. Dies gibt an, 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

• otThreadGetNextHopAndPathCost

nexthop

Ausgabetabelle mit den zugewiesenen Router-IDs sowie 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

• otThreadGetNextHopAndPathCost
• otThreadIsRouterIdAllocated

Panid (Panid)

Legen Sie die IEEE 802.15.4-PAN-ID fest.

Funktioniert nur, wenn Thread-Protokolle deaktiviert sind. Ein erfolgreicher Aufruf dieser Funktion führt auch dazu, dass die aktiven und ausstehenden operativen Datasets im nichtflüchtigen Speicher ungültig werden.

Parameter

panid panid

Beispiele

panid 0xdead
Done

Befehlszeilen- und API-Referenzen

• otLinkSetPanId

Panid

Rufen Sie die IEEE 802.15.4-PAN-ID ab.

Parameter

Keine Parameter.

Beispiele

panid
0xdead
Done

Befehlszeilen- und API-Referenzen

• otLinkGetPanId

Übergeordnetes Element

Diagnoseinformationen für einen Thread-Router als übergeordnetes Element abrufen.

Wenn Sie als Thread-Router arbeiten und OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist, gibt dieser Befehl die im Cache gespeicherten Informationen zurück, die erfasst wurden, als das Gerät zuvor als untergeordnetes Thread-Element angehängt war. Die Rückgabe von im Cache gespeicherten Informationen ist erforderlich, um das „Thread Test Harness – Test Szenario 8.2.x“ zu unterstützen, das die vorherige übergeordnete MAC-Adresse (d.h. die MAC-Adresse des Joiner Routers) anfordert, auch wenn das Gerät bereits zu einem Router hochgestuft wurde.

Hinweis: Wenn OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE aktiviert ist, gibt dieser Befehl zwei zusätzliche Zeilen mit Informationen zurück, die für den CSL-Empfängerbetrieb relevant sind.

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

• otThreadGetParentInfo

Elternsuche

Startet den Vorgang für den untergeordneten Partner, um nach einem besseren übergeordneten Element zu suchen, ohne das aktuelle übergeordnete Element beizubehalten.

Muss verwendet werden, wenn das Gerät für ein Kind angeschlossen ist.

Parameter

Keine Parameter.

Beispiele

parent search
Done

Befehlszeilen- und API-Referenzen

• otThreadSearchForBetterParent

ParentPriority (get,set)

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

Parameter

parentpriority [parentpriority]

Beispiele

parentpriority
1
Done

parentpriority 1
Done

Befehlszeilen- und API-Referenzen

• otThreadGetParentPriority
• otThreadSetParentPriority

partitionid

Rufen Sie die Thread-Netzwerkpartitions-ID ab.

Parameter

Keine Parameter.

Beispiele

partitionid
4294967295
Done

Befehlszeilen- und API-Referenzen

• otThreadGetPartitionId

partitionid 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

• otThreadGetPreferredLeaderPartitionId
• otThreadSetPreferredLeaderPartitionId

Plattform

Aktuelle Plattform drucken

Parameter

Keine Parameter.

Beispiele

platform
NRF52840
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Umfrageperiode (get,set)

Sie können den Zeitraum für die benutzerdefinierte Datenabfrage des inaktiven Endgeräts (Millisekunden) abrufen oder festlegen. Nur für Zertifizierungsprüfungen.

Parameter

Keine Parameter.

Beispiele

pollperiod
0
Done

pollperiod 10
Done

Befehlszeilen- und API-Referenzen

• otLinkGetPollPeriod
• otLinkSetPollPeriod

bevorzugter Router-ID

Gibt die bevorzugte Router-ID an, die der Leader angeben soll, wenn er angefordert wird.

Parameter

preferrouterid routerid

Beispiele

preferrouterid 16
Done

Befehlszeilen- und API-Referenzen

• otThreadSetPreferredRouterId

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

• otBorderRouterAddOnMeshPrefix

Präfix "messlocal"

Rufen Sie das lokale Präfix des Mesh-Netzwerks 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.

Hinweis :Beim Thread 1.2-Border-Router mit Backbonefunktion ist auch das lokale Domainpräfix aufgeführt, das das Flag D enthält. Wenn die Backbonefunktion deaktiviert ist, wird vor dem lokalen Domainpräfix ein Bindestrich - ausgegeben.

Weitere Informationen zu den Flags otBorderRouterConfig finden Sie unter Ü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

• otBorderRouterGetNextOnMeshPrefix

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

• otBorderRouterRemoveOnMeshPrefix

promiskuitive (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den promiskuitiven Modus der Linkebene.

Hinweis :Der Promiskuitive Modus kann nur aktiviert werden, wenn die Thread-Schnittstelle deaktiviert ist.

Parameter

promiscuous enable|disable

Beispiele

promiscuous enable
Done

promiscuous disable
Done

Befehlszeilen- und API-Referenzen

• otLinkSetPromiscuous

promiskuitive

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

Parameter

Keine Parameter.

Beispiele

promiscuous
Disabled
Done

Befehlszeilen- und API-Referenzen

• otLinkIsPromiscuous
• otPlatRadioGetPromiscuous

pskc (set)

Legt pskc im Hexadezimalformat fest.

Parameter

pskc key

Beispiele

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

pskc –p

Generiert das pskc-Zertifikat 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

Thread-PSKc herunterladen.

Parameter

Keine Parameter.

Beispiele

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

Befehlszeilen- und API-Referenzen

• otThreadGetPskc

pskcref (set)

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

Hierfür muss das Build-Zeit-Feature OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE aktiviert sein.

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

Parameter

pskc keyref

Beispiele

pskc 0x20017
Done

Befehlszeilen- und API-Referenzen

• otThreadSetPskcRef

pskcref

Schlüsselreferenz zum gespeicherten Thread-PSKc abrufen.

Hierfür muss das Build-Zeit-Feature OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE aktiviert sein.

Parameter

Keine Parameter.

Beispiele

pskcref
0x80000000
Done

Befehlszeilen- und API-Referenzen

• otThreadGetPskcRef

Radio (aktivieren,deaktivieren)

Aktiviert oder deaktiviert das Radio.

Parameter

radio enable|disable

Beispiele

radio enable
Done

radio disable
Done

Befehlszeilen- und API-Referenzen

• otLinkSetEnabled

Radiostatistiken klar

Setzt die Radiostatistik zurück

Alle Zeiten werden auf 0 zurückgesetzt.

Parameter

Keine Parameter.

Beispiele

radio stats clear
Done

Befehlszeilen- und API-Referenzen

• otRadioTimeStatsReset

Radiostatistik

Ruft die Radiostatistik ab.

Die Funkstatistiken beinhalten die Zeit, zu der das Radio sich im TX-/RX-/Ruhemodus befindet. Diese Zeiten werden in Mikrosekunden 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

• otRadioTimeStatsGet

RDP-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

• otPlatRadioGetVersionString

Region (set)

Legt den Regionscode fest.

Das Funkregionformat ist die 2-Byte-ASCII-Darstellung des Alpha-2-Codes nach ISO 3166.

Eine Änderung kann sich auf die Begrenzung der Sendeleistung auswirken.

Parameter

Keine Parameter.

Beispiele

region US
Done

Befehlszeilen- und API-Referenzen

• otLinkSetRegion

Region

Rufen Sie den Regionscode ab.

Das Funkregionformat ist die 2-Byte-ASCII-Darstellung des Alpha-2-Codes nach ISO 3166.

Parameter

Keine Parameter.

Beispiele

region
US
Done

Befehlszeilen- und API-Referenzen

• otLinkGetRegion

Releaserouterid (Routerid)

Geben Sie eine Router-ID frei, die vom Gerät als Leader zugewiesen wurde.

Hinweis :Diese API ist nur für Test- und Demozwecke reserviert. Wenn Sie die Einstellungen mit dieser API ändern, ist eine Produktionsanwendung nicht mehr mit der Thread-Spezifikation kompatibel.

Parameter

releaserouterid [routerid]

Beispiele

releaserouterid 16
Done

Befehlszeilen- und API-Referenzen

• otThreadReleaseRouterId

rloc16

Hol dir das RLOC16.

Parameter

Keine Parameter.

Beispiele

rloc16
0xdead
Done

Befehlszeilen- und API-Referenzen

• otThreadGetRloc16

Route hinzufügen

Für Parameter verwenden Sie:

• s: Stable-Flag
• N: NAT64-Flag
• prf: Einstellung für Standardrouter, [hoch, mittel, 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

• otExternalRouteConfig

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

• otBorderRouterRemoveRoute

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

• otBorderRouterGetNextRoute

Router (ID)

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

Drucken Sie Diagnosedaten für einen Thread-Router aus. 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

• otThreadGetRouterInfo

Routerliste

Listet die zugewiesenen Router-IDs auf.

Parameter

Keine Parameter.

Beispiele

router list
8 24 50
Done

Befehlszeilen- und API-Referenzen

• otThreadGetRouterInfo

Routertabelle

Gibt eine Liste der Router im 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

• otThreadGetRouterInfo

Routerdowngrade-Grenzwert (get,set)

Ruft den ROUTER_DOWNGRADE_THRESHOLD-Wert ab oder legt diesen fest.

Parameter

routerdowngradethreshold [threshold]

Beispiele

 routerdowngradethreshold
23
Done

 routerdowngradethreshold 23
Done

Befehlszeilen- und API-Referenzen

• otThreadGetRouterDowngradeThreshold
• otThreadSetRouterDowngradeThreshold

Router-fähig (aktivieren,deaktivieren)

Aktiviert oder deaktiviert die Routerrolle.

Parameter

routereligible [enable|disable]

Beispiele

routereligible enable
Done

routereligible disable
Done

Befehlszeilen- und API-Referenzen

• otThreadSetRouterEligible

für Router geeignet

Gibt an, ob die Routerrolle aktiviert oder deaktiviert ist.

Parameter

Keine Parameter.

Beispiele

routereligible
Enabled
Done

Befehlszeilen- und API-Referenzen

• otThreadIsRouterEligible

routerselectionjitter

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

• otThreadGetRouterSelectionJitter
• otThreadSetRouterSelectionJitter

Routerupgradethreshold (get,set)

Ruft den ROUTER_UPGRADE_THRESHOLD-Wert ab oder legt ihn fest.

Parameter

routerupgradethreshold [threshold]

Beispiele

routerupgradethreshold
16
Done

routerupgradethreshold 16
Done

Befehlszeilen- und API-Referenzen

• otThreadGetRouterUpgradeThreshold
• otThreadSetRouterUpgradeThreshold

energie scannen

Führt einen IEEE 802.15.4-Energiescan durch und zeigt die Zeit in Millisekunden an, die für die Suche nach jedem Kanal benötigt wird. Es werden alle Kanäle angezeigt, es sei denn, Sie geben mit der Kanaloption einen bestimmten Kanal an.

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

• otLinkEnergyScan

Durchsuchen

Führt einen aktiven IEEE 802.15.4-Scan durch. Wenn kein Kanal angegeben ist, werden alle Kanäle durchsucht. 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

• otLinkActiveScan

Dienst hinzufügen

Fügt den Netzwerkdaten einen Dienst hinzu.

• enterpriseNumber: IANA-Unternehmensnummer
• serviceData: Hex-codierte binäre Dienstdaten
• serverData: Hex-codierte binäre Serverdaten (leer, wenn nicht angegeben)

Hinweis: Damit jede Änderung bei der Dienstregistrierung wirksam wird, führen Sie den Befehl netdata register nach Ausführung des Befehls service add aus, um den Leader zu benachrichtigen.

Parameter

service add enterpriseNumber serviceData [serverData]

Beispiele

service add 44970 112233 aabbcc
Done

netdata register
Done

Befehlszeilen- und API-Referenzen

• otServerAddService
• Netdata-Register

Dienst entfernen

Entfernt den Dienst aus den Netzwerkdaten.

• enterpriseNumber: IANA-Unternehmensnummer
• serviceData: Hex-codierte binäre Dienstdaten

Hinweis: Damit jede Änderung bei der Dienstregistrierung wirksam wird, führen Sie den Befehl netdata register nach Ausführung des Befehls service remove aus, um den Leader zu benachrichtigen.

Parameter

service remove enterpriseNumber serviceData

Beispiele

service remove 44970 112233
Done

netdata register
Done

Befehlszeilen- und API-Referenzen

• otServerRemoveService
• Netdata-Register

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

• otThreadIsSingleton

sntp-Suchanfrage

Sendet eine SNTP-Abfrage, um die aktuelle Unix-Epochenzeit (ab 1. Januar 1970) abzurufen.

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

Hinweis: Dieser Befehl ist nur verfügbar, wenn OPENTHREAD_CONFIG_SNTP_CLIENT_ENABLE aktiviert ist.

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

• otSntpClientQuery

srp-client autostart (get)

Zeigt den aktuellen Status des Autostart-Modus an (aktiviert oder deaktiviert). Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

Keine Parameter.

Beispiele

srp client autostart
Disabled
Done

Befehlszeilen- und API-Referenzen

• otSrpClientIsAutoStartModeEnabled

srp-Client-Autostart deaktiviert

Deaktiviert den Autostartmodus.

Durch das Deaktivieren des Autostart-Modus wird ein laufender Client nicht gestoppt. Der SRP-Client überwacht jedoch keine Thread-Netzwerkdaten mehr.

Parameter

Keine Parameter.

Beispiele

srp client autostart disable
Done

Befehlszeilen- und API-Referenzen

• otSrpClientDisableAutoStartMode

srp-Client-Autostart aktivieren

Aktiviert den Autostart-Modus.

Wenn „Autostart“ aktiviert ist, überwacht der SRP-Client die 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.

Drei Kategorien von Netzwerkdateneinträgen weisen auf das Vorhandensein eines SRP-Servers hin und werden in der folgenden Reihenfolge bevorzugt:

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

Parameter

Keine Parameter.

Beispiele

srp client autostart enable
Done

Befehlszeilen- und API-Referenzen

• otSrpClientEnableAutoStartMode

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

Ruft Druck-Callback-Ereignisse vom SRP-Client ab oder aktiviert bzw. deaktiviert sie. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp client callback [enable|disable]

Beispiele

srp client callback enable
Done

srp client callback
Enabled
Done

Befehlszeilen- und API-Referenzen

• otSrpClientSetCallback

srp-Client-Hostadresse (get)

Gibt an, ob der automatische Adressmodus aktiviert ist. Wenn der automatische Adressmodus nicht aktiviert ist, wird die Liste der SRP-Client-Hostadressen zurückgegeben. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) 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

• otSrpClientGetHostInfo

srp-Client-Hostadresse (festgelegt)

Aktivieren Sie den automatischen Hostadressenmodus oder legen Sie die Liste der Hostadressen explizit fest. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp client host address [auto|address...]

• Verwenden Sie den Parameter auto, um den Modus für die automatische Hostadresse 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 registriert sich automatisch neu, wenn Adressen im Thread „netif“ hinzugefügt, entfernt oder als nicht bevorzugt markiert werden.
• Geben Sie explizit die Liste der Hostadressen 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 automatische Hostadressmodus deaktiviert.

Beispiele

srp client host address auto
Done

srp client host address fd00::cafe
Done

Befehlszeilen- und API-Referenzen

• otSrpClientEnableAutoHostAddress
• otSrpClientSetHostAddresses

srp-Client-Host löschen

Löscht alle Hostinformationen und alle Dienste.

Parameter

Keine Parameter.

Beispiele

srp client host clear
Done

Befehlszeilen- und API-Referenzen

• otSrpClientBuffersFreeAllServices
• otSrpClientClearHostAndServices

Hostname des srp-Clients (get,set)

Ruft den Hostnamen des SRP-Clients ab oder legt ihn fest. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp client host name [name]

Um den Namen des Clienthosts festzulegen, wenn der Host entweder entfernt wurde oder noch nicht beim Server registriert wurde, verwenden Sie den Parameter name.

Beispiele

srp client host name dev4312
Done

srp client host name
dev4312
Done

Befehlszeilen- und API-Referenzen

• otSrpClientSetHostName

srp-Client-Host entfernen

Entfernt Informationen zum SRP-Clienthost und alle Dienste vom SRP-Server. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp client host remove [removekeylease] [sendunregtoserver]

• Der Parameter removekeylease ist ein optionaler boolescher Wert, der angibt, ob die Hostschlüsselfreigabe ebenfalls entfernt werden soll. Der Standardwert ist false.
• Der Parameter sendunregtoserver ist ein optionaler boolescher Wert, der angibt, ob der Clienthost eine Aktualisierung senden soll an den Server gesendet, auch wenn die Informationen zum Client-Host noch nicht beim Server registriert wurden (Standardeinstellung ist false). Dieser Parameter kann nur angegeben werden, wenn der Parameter removekeylease im Befehl zuerst angegeben wird.

Beispiele

srp client host remove 1
Done

Befehlszeilen- und API-Referenzen

• otSrpClientRemoveHostAndServices
• otSrpClientSetHostName

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

• otSrpClientGetHostInfo

Status des srp-Client-Hosts

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

• ToAdd: Element wird hinzugefügt/registriert.
• Adding: Der Artikel wird gerade hinzugefügt/registriert.
• ToRefresh: Element wird zur Verlängerung der Leasing-Verlängerung aktualisiert.
• Refreshing: Element wird beig aktualisiert.
• ToRemove: zu entfernendes Element.
• Removing: Element wird entfernt.
• Registered: Das Element ist beim Server registriert.
• Removed: 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üssel-Freigabeintervall 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

• otSrpClientGetKeyLeaseInterval
• otSrpClientSetKeyLeaseInterval

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

• otSrpClientGetLeaseInterval
• otSrpClientSetLeaseInterval

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-Client-Server-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, wird die Adresse nicht angegeben (alle Nullen) mit der Portnummer 0. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otSrpClientGetServerAddress

srp kundendienst hinzufügen

Fügt einen Dienst mit einem bestimmten Instanznamen, Dienstnamen und einer Portnummer hinzu. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

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

Der Parameter servicename kann optional eine Liste von durch Kommas getrennten Labels für Dienstuntertypen enthalten. In den Beispielen hier wird eine allgemeine Benennung verwendet. Die Parameter priority und weight (beide sind uint16_t-Werte) sind optional. Wenn nicht angegeben, wird Null verwendet. Mit dem optionalen Parameter txt werden die mit dem Dienst verknüpften TXT-Daten festgelegt. Der Wert txt muss im Hex-String-Format vorliegen und wird als bereits codierte Bytesequenz für TXT-Daten 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

• otSrpClientAddService

srp-Client-Dienstschlüssel (get,set)

Ruft den Einschlussmodus für Dienstschlüsseleinträge 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 unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

Keine Parameter.

Beispiele

srp client service key enable
Done

srp client service key
Enabled
Done

Befehlszeilen- und API-Referenzen

• otSrpClientIsServiceKeyRecordEnabled

Name des srp-Clientdiensts löschen

Löscht einen Dienst und wird sofort ohne Interaktion mit dem SRP-Server aus der Liste der Clientdienste entfernt.

Parameter

srp client service clear instancename servicename

Beispiele

srp client service clear ins2 _test2._udp
Done

Befehlszeilen- und API-Referenzen

• otSrpClientClearService

srp kundendienst entfernen

Fordert die Aufhebung der Registrierung eines Dienstes beim SRP-Server an.

Parameter

srp client service remove instancename servicename

Beispiele

srp client service remove ins2 _test2._udp
Done

Befehlszeilen- und API-Referenzen

• otSrpClientRemoveService

srp kundenservice

Ruft die Liste der vom Client verwalteten Dienste ab.

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

• otSrpClientGetServices

srp-Client starten

Startet den SRP-Clientvorgang. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp client start serveraddr serverport

Beispiele

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

Befehlszeilen- und API-Referenzen

• otSrpClientStart

Status des srp-Clients

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

Parameter

Keine Parameter.

Beispiele

srp client state
Enabled
Done

Befehlszeilen- und API-Referenzen

• otSrpClientIsRunning

srp-client stopp

Beendet den SRP-Clientvorgang.

Stoppt alle weiteren Interaktionen mit dem SRP-Server. Hinweis: Hostinformationen und/oder die Liste von Diensten werden dadurch nicht entfernt oder gelöscht. Sie kennzeichnet alle Services, die nach dem (Neu-)Starten des Clients wieder hinzugefügt/entfernt werden sollen.

Parameter

Keine Parameter.

Beispiele

srp client stop
Done

Befehlszeilen- und API-Referenzen

• otSrpClientStop

srp-client ttl (get,set)

Ruft den Wert für ttl(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

• otSrpClientGetTtl
• otSrpClientSetTtl

srp-Server (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den SRP-Server. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp server [enable|disable]

Beispiele

srp server disable
Done

Befehlszeilen- und API-Referenzen

• otSrpServerSetEnabled

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 bestimmen soll, die dann in den Thread-Netzwerkdaten veröffentlicht werden.

Parameter

srp server addrmode [anycast|unicast]

Beispiele

srp server addrmode anycast
Done

srp server addrmode
anycast
Done

Befehlszeilen- und API-Referenzen

• otSrpServerGetAddressMode
• otSrpServerSetAddressMode

srp-Server automatisch (aktivieren,deaktivieren)

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

Wenn dieser Modus aktiviert ist, steuert der 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 unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

srp server auto [enable|disable]

Beispiele

srp server auto enable
Done

srp server auto
Enabled
Done

Befehlszeilen- und API-Referenzen

• otSrpServerIsAutoEnableMode
• otSrpServerSetAutoEnableMode

srp-Serverdomain (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

• otSrpServerGetDomain
• otSrpServerSetDomain

srp-Server-Host

Gibt Informationen zu allen registrierten Hosts zurück. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) 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

• otSrpServerGetNextHost
• otSrpServerHostGetAddresses
• otSrpServerHostGetFullName

srp-Server-Lease (get,set)

Ruft die Freigabewerte des SRP-Servers 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

• otSrpServerGetLeaseConfig
• otSrpServerSetLeaseConfig

srp server seqnum (get,set)

Ruft die mit dem Anycast-Adressmodus verwendete Sequenznummer ab oder legt sie fest. Die Sequenznummer ist in der „Anycast-Adresse des DNS/SRP-Dienstes“ enthalten den unter Netzwerkdaten veröffentlichten Eintrag enthält.

Parameter

srp server seqnum [seqnum]

Beispiele

srp server seqnum 20
Done

srp server seqnum
20
Done

Befehlszeilen- und API-Referenzen

• otSrpServerGetAnycastModeSequenceNumber
• otSrpServerSetAnycastModeSequenceNumber

srp-serverdienst

Gibt Informationen zu registrierten Diensten zurück.

Der Datensatz TXT wird als Array von Einträgen angezeigt. Enthält ein Eintrag einen Schlüssel, wird der Schlüssel im ASCII-Format ausgegeben. Der Wertteil wird in hexadezimalen Byte ausgegeben. Weitere Informationen finden Sie unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) 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 kann aktiv werden, 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 unter SRP-Server-Client-Verbindung mit OT-CLI (Service Registration Protocol) einrichten.

Parameter

Keine Parameter.

Beispiele

srp server state
running
Done

Befehlszeilen- und API-Referenzen

• otSrpServerGetState

Bundesstaat

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

• child: Das Gerät wird derzeit als untergeordnetes Thread-Gerät 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 oder ‐Partition.
• disabled: Der Thread-Stack ist derzeit deaktiviert.

Mit einer der Optionen können Sie die aktuelle Rolle eines Geräts ändern, mit der Ausnahme, dass Sie den Status „disabled“ ändern oder wieder ändern können.

Parameter

state [child|router|leader|detached]

Beispiele

state
child
Done

state leader
Done

Befehlszeilen- und API-Referenzen

• otThreadGetDeviceRole
• otThreadBecomeChild
• otThreadBecomeRouter
• otThreadBecomeLeader
• otThreadBecomeDetached

tcp-abbruch

Beendet die TCP-Verbindung, die mit dem Beispiel-TCP-Endpunkt verknüpft ist, ohne Verzögerung, sodass der TCP-Endpunkt in den Status „Geschlossen“ versetzt wird.

Parameter

Keine Parameter.

Beispiele

tcp abort
TCP: Connection reset
Done

Befehlszeilen- und API-Referenzen

• otTcpAbort

TCP-Benchmark-Ergebnis

Zeigt das letzte Ergebnis des TCP-Benchmark-Tests. 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 mit der TCP-Verbindung, die derzeit mit dem von der tcp-Befehlszeile bereitgestellten Beispiel-TCP-Endpunkt verknüpft ist.

Hinweis: Sie müssen eine TCP-Verbindung herstellen, bevor Sie diesen Befehl ausführen.

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

Verbindet dem von der tcp-Befehlszeile bereitgestellten Beispiel-TCP-Endpunkt eine IPv6-Adresse und einen Port. Das Verknüpfen des TCP-Endpunkts mit einer IPv6-Adresse und einem Port wird als „Benennen des TCP-Endpunkts“ 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

• otTcpBind

TCP Connect

Stellt eine Verbindung mit dem angegebenen Peer her.

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

Parameter

tcp connect ip port [fastopen]

• ip: IP-Adresse des Peers. Bei der Adresse kann es sich um eine IPv4-Adresse handeln, die mithilfe des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn das bevorzugte NAT64-Präfix nicht verfügbar ist.
• port: TCP-Portnummer des Peers.
• fastopen: Dieser Parameter ist optional. Wenn fast festgelegt ist, ist TCP Fast Open für diese Verbindung aktiviert. Ist dieser Parameter auf slow gesetzt oder nicht verwendet, ist 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

• otTcpConnect

TCP-Deinit

Initialisiert diesen TCP-Endpunkt.

Dies bedeutet, dass OpenThread diesen TCP-Endpunkt nicht mehr verfolgt und alle Ressourcen freigibt, die es diesem TCP-Endpunkt intern zugewiesen hat. Die Anwendung kann den Arbeitsspeicher, der den TCP-Endpunkt stützt, nach Bedarf wiederverwenden.

Wenn sie einer Live-TCP-Verbindung entspricht, wird sie wie in otTcpAbort() unzeremonie beendet. 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

• otTcpEndpointDeinitialize

tcp init

Initialisiert den Beispiel-TCP-Listener und den von der tcp-Befehlszeile bereitgestellten Beispiel-TCP-Endpunkt.

Parameter

tcp init [mode] [size]

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

Beispiele

tcp init tls
Done

Befehlszeilen- und API-Referenzen

• otTcpListenerInitialize
• otTcpEndpointInitialize

TCP-Überwachung

Verwendet den Beispiel-TCP-Listener, um eingehende Verbindungen an der angegebenen IPv6-Adresse und dem angegebenen IPv6-Port zu erkennen. 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 TCP-Beispiel-Listeners, der von der tcp-Befehlszeile bereitgestellt wird.
• port: TCP-Port des Beispiel-TCP-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 dem Beispiel-TCP-Endpunkt zugeordnet.

Beispiele

tcp listen :: 30000
Done

Befehlszeilen- und API-Referenzen

• otTcpListen

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 „Ende des Streams“ Signal über die TCP-Verbindung, die mit dem über die tcp-Befehlszeile bereitgestellten Beispiel-TCP-Endpunkt verknüpft ist. Dadurch wird der Peer darauf hingewiesen, dass er über diese TCP-Verbindung keine weiteren Daten erhält.

Parameter

Keine Parameter.

Beispiele

tcp sendend
Done

Befehlszeilen- und API-Referenzen

• otTcpSendEndOfStream

TCP-Stopplisten

Weist den Beispiel-TCP-Listener an, das Warten auf eingehende TCP-Verbindungen zu beenden.

Parameter

Keine Parameter.

Beispiele

tcp stoplistening
Done

Befehlszeilen- und API-Referenzen

• otTcpStopListening

tmforiginfilter testen

Aktiviert oder deaktiviert den Filter zum Löschen von TMF-UDP-Nachrichten aus nicht vertrauenswürdigen Quellen.

Standardmäßig ist der Filter aktiviert, der TMF-UDP-Nachrichten aus nicht vertrauenswürdigen Quellen löscht. Wenn diese Option deaktiviert ist, sind UDP-Nachrichten zulässig, die an den TMF-Port gesendet werden und von nicht vertrauenswürdigen Quellen wie dem Host, der Befehlszeile oder einem externen IPv6-Knoten stammen.

Hinweis: OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE ist erforderlich.

Parameter

test tmforiginfilter [enable|disable]

Beispiele

test tmforiginfilter
Enabled

test tmforiginfilter enable
Done

test tmforiginfilter disable
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Thread-Anfang

Startet den Thread-Protokollvorgang.

Hinweis: Die Schnittstelle muss aktiviert sein, wenn dieser Befehl ausgeführt wird.

Parameter

Keine Parameter.

Beispiele

thread start
Done

Befehlszeilen- und API-Referenzen

• otThreadSetEnabled

Thread beenden

Stoppt 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.

Die Konstanten OT_THREADVERSION* definieren die numerischen Versionswerte.

Parameter

Keine Parameter.

Beispiele

 thread version
2
Done

Befehlszeilen- und API-Referenzen

• otThreadGetVersion

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 erfasst und als Dauer vom Hinzufügen einer Nachricht zur Übertragungswarteschlange bis zur Übergabe an die MAC-Ebene zur Übertragung oder Verwerfen gemessen.

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

Parameter

Keine Parameter.

Beispiele

timeinqueue max
281
Done

Befehlszeilen- und API-Referenzen

• otThreadGetMaxTimeInQueue
• Zeit in Warteschlange zurücksetzen

Zeit in Warteschlange zurücksetzen

Setzt die Statistik 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

• otThreadResetTimeInQueueStat

timeinqueue

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

Erfordert OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Ein Histogramm der Zeit, in der sich die Nachrichten in der Übertragungswarteschlange befinden, wird erfasst. Die Zeit in der Warteschlange wird nur für direkte Übertragungen erfasst und als Dauer vom Hinzufügen einer Nachricht zur Übertragungswarteschlange bis zur Übergabe an die MAC-Ebene zur Übertragung oder Verwerfen gemessen.

Das Histogramm wird als Array von uint32_t-Werten mit aNumBins-Einträgen zurückgegeben. Der erste Eintrag im Array (bei Index 0) gibt die Anzahl der Nachrichten an, deren Zeit in der Warteschlange kleiner als aBinInterval ist. Der zweite Eintrag gibt die Anzahl der Nachrichten an, 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 stellt die Anzahl der Nachrichten dar, bei denen die Zeit in der Warteschlange größer oder gleich (aNumBins - 1) * aBinInterval ist.

Die erfassten 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 Statistiksammlung durch Aufrufen von otThreadResetTimeInQueueStat() erfasst.

Die Cursor 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

• otThreadGetTimeInQueueHistogram
• Zeit in Warteschlange zurücksetzen

trel (aktivieren,deaktivieren)

Aktiviert oder deaktiviert den TREL-Radiobetrieb.

Parameter

trel enable|disable

Beispiele

trel enable
Done

trel disable
Done

Befehlszeilen- und API-Referenzen

• otTrelSetEnabled

Zähler zurücksetzen

Setzt die TREL-Zähler zurück.

Parameter

Keine Parameter.

Beispiele

trel counters reset
Done

Befehlszeilen- und API-Referenzen

• otTrelResetCounters

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

• otTrelGetCounters

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

• otTrelSetFilterEnabled

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 gelöscht.

Hinweis: Dieser Modus wird hauptsächlich für Tests verwendet.

Parameter

Keine Parameter.

Beispiele

trel filter
Disabled
Done

Befehlszeilen- und API-Referenzen

• otTrelIsFilterEnabled

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

• otTrelGetNextPeer

Trel

Gibt an, ob der TREL-Vorgang aktiviert ist.

Hinweis: OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE ist für alle trel-Unterbefehle erforderlich.

Parameter

Keine Parameter.

Beispiele

trel
Enabled
Done

Befehlszeilen- und API-Referenzen

• otTrelIsEnabled

tvcheck (aktivieren,deaktivieren)

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

Hinweis: OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE ist erforderlich.

Parameter

Keine Parameter.

Beispiele

tvcheck enable
Done

tvcheck disable
Done

Befehlszeilen- und API-Referenzen

• otThreadSetThreadVersionCheckEnabled

txpower (get,set)

Ruft die Sendeleistung in dBm ab oder legt sie mithilfe des optionalen Arguments txpower fest.

Parameter

txpower [txpower]

Beispiele

txpower -10
Done

txpower
-10 dBm
Done

Befehlszeilen- und API-Referenzen

• otPlatRadioGetTransmitPower
• otPlatRadioSetTransmitPower

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 bindende Netzwerkschnittstelle, die so festgelegt wird:
  • Kein Wert (diesen Parameter nicht im Befehl angeben): Die Thread-Netzwerkschnittstelle wird verwendet.
  • -u: Nicht angegebene Netzwerkschnittstelle. Das bedeutet, dass der UDP-/IPv6-Stack bestimmt, an welche Netzwerkschnittstelle der Socket gebunden werden soll.
  • -b: Die Backbone-Netzwerkschnittstelle wird verwendet.
• ip: Unicast-IPv6-Adresse, an die gebunden werden soll. Wenn der UDP/IPv6-Stack die IPv6-Bindungsadresse zuweisen oder an Multicast-IPv6-Adressen binden möchten, können Sie den folgenden Wert verwenden, um die nicht angegebene IPv6-Adresse zu verwenden: ::. In jedem Beispiel wird die nicht angegebene IPv6-Adresse verwendet.
• port: UDP-Portnummer, an die die Bindung erfolgen soll. In allen Beispielen wird die Portnummer 1234 verwendet.

Beispiele

udp bind :: 1234
Done

udp bind -u :: 1234
Done

udp bind -b :: 1234
Done

Befehlszeilen- und API-Referenzen

• otUdpBind

UDP schließen

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

Parameter

Keine Parameter.

Beispiele

udp close
Done

Befehlszeilen- und API-Referenzen

• otUdpClose

UDP verbinden

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 mithilfe des bevorzugten NAT64-Präfixes aus den Netzwerkdaten zu einer IPv6-Adresse synthetisiert wird. Der Befehl gibt InvalidState zurück, wenn das bevorzugte NAT64-Präfix nicht verfügbar ist.

Beispiele

udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done

udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

Befehlszeilen- und API-Referenzen

• otUdpConnect

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-Linksicherheit

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 geöffnet

Öffnen Sie einen UDP-/IPv6-Socket.

Parameter

Keine Parameter.

Beispiele

udp open
Done

Befehlszeilen- und API-Referenzen

• otUdpOpen

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

Die Kombination aus ip und port ist optional. Wenn Sie jedoch eins angeben, müssen Sie auch das andere angeben. Wenn ip und port nicht angegeben sind, wird die Socket-Peer-Adresse von udp connect aus verwendet.

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

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

• offenes UDP
• udp-Bindung
• UDP-Verbindung
• otUdpSend

unsicher abrufen

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

Parameter

Keine Parameter.

Beispiele

unsecure get
1234
Done

Befehlszeilen- und API-Referenzen

• otIp6GetUnsecurePorts

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

• otIp6AddUnsecurePort

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

• otIp6AddUnsecurePort
• otIp6RemoveAllUnsecurePorts

Betriebszeit in 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

• otInstanceGetUptime

Betriebszeit

Gibt die Verfügbarkeit der aktuellen Instanz als menschenlesbaren String zurück.

Hierfür muss OPENTHREAD_CONFIG_UPTIME_ENABLE aktiviert sein.

Die Zeichenfolge hat das Format "::.". für Stunden, Minuten, Sekunden und Millisekunden (bei Verfügbarkeit von weniger als einem Tag) oder „

d.::." (bei mehr als einem Tag)

Wenn der resultierende String nicht in aBuffer passt (innerhalb der aSize Zeichen), wird der String abgeschnitten, aber der ausgegebene String hat immer Nulltermin.

Parameter

Keine Parameter.

Beispiele

uptime
12:46:35.469
Done

Befehlszeilen- und API-Referenzen

• otInstanceGetUptimeAsString

Anbieter-App-URL (festgelegt)

Legen Sie den URL-String der Anbieter-App fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorAppUrl sollte UTF8 sein und darf maximal 64 Zeichen (MAX_VENDOR_APPL_URL_TLV_LENGTH) lang sein. Die maximale Länge umfasst nicht das Nullzeichen \0.

Parameter

vendor appurl url

Beispiele

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

Befehlszeilen- und API-Referenzen

• otThreadSetVendorAppUrl

Anbieter-App-URL

Rufen Sie den URL-String der Anbieter-App ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otThreadGetVendorAppUrl

Anbietermodell (set)

Legen Sie den String des Anbietermodells fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorModel sollte UTF8 sein und darf maximal 32 Zeichen (MAX_VENDOR_MODEL_TLV_LENGTH) lang sein. Die maximale Länge umfasst nicht das Nullzeichen \0.

Parameter

vendor model name

Beispiele

vendor model Hub\ Max
Done

Befehlszeilen- und API-Referenzen

• otThreadSetVendorModel

Anbietermodell

Rufen Sie den Anbietermodellstring ab.

Parameter

Keine Parameter.

Beispiele

vendor model
Hub Max
Done

Befehlszeilen- und API-Referenzen

• otThreadGetVendorModel

Anbietername (set)

Legen Sie den String für den Anbieternamen fest.

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorName sollte UTF8 sein und darf maximal 32 Zeichen (MAX_VENDOR_NAME_TLV_LENGTH) lang sein. Die maximale Länge umfasst nicht das Nullzeichen \0.

Parameter

vendor name name

Beispiele

vendor name nest
Done

Befehlszeilen- und API-Referenzen

• otThreadSetVendorName

Name des Anbieters

Rufen Sie den String für den Anbieternamen ab.

Parameter

Keine Parameter.

Beispiele

vendor name
nest
Done

Befehlszeilen- und API-Referenzen

• otThreadGetVendorName

Anbieterumstellung (set)

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

Erfordert OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

aVendorSwVersion sollte UTF8 sein und darf maximal 16 Zeichen(MAX_VENDOR_SW_VERSION_TLV_LENGTH) lang sein. Die maximale Länge umfasst nicht das Nullzeichen \0.

Parameter

vendor swversion version

Beispiele

vendor swversion Marble3.5.1
Done

Befehlszeilen- und API-Referenzen

• otThreadSetVendorSwVersion

Vendor Swversion

Rufen Sie den String der Softwareversion des Anbieters ab.

Parameter

Keine Parameter.

Beispiele

vendor swversion
Marble3.5.1
Done

Befehlszeilen- und API-Referenzen

• otThreadGetVendorSwVersion

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

• otVerhoeffChecksumCalculate

Verhoeff Validieren

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

Erfordert OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

Parameter

verhoeff validate decimalstring

Beispiele

verhoeff validate 307318421
Done

Befehlszeilen- und API-Referenzen

• otVerhoeffChecksumValidate

API-Version

Gibt die API-Versionsnummer aus.

Parameter

Keine Parameter.

Beispiele

version api
28
Done

Befehlszeilen- und API-Referenzen

• Keine verknüpfte API

Version

Ruft den OpenThread-Versionsstring ab.

Parameter

Keine Parameter.

Beispiele

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

Befehlszeilen- und API-Referenzen

• otGetVersionString