Link

Dieses Modul enthält Funktionen zur Steuerung der Konfiguration auf Link-Ebene.

Zusammenfassung

Aufzählungen
otMacFilterAddressMode{
  OT_MAC_FILTER_ADDRESS_MODE_DISABLED,
  OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST,
  OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
} 		enum
Definiert den Adressmodus des Mac-Filters.

Typedefs
otActiveScanResult typedef
Stellt ein empfangenes IEEE 802.15.4-Beacon dar.
otEnergyScanResult typedef
Stellt ein Ergebnis des Energiescans dar.
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext) typedef
void(*
Pointer wird während eines aktiven IEEE 802.15.4-Scans aufgerufen, wenn ein IEEE 802.15.4-Beacon empfangen wird oder der Scan abgeschlossen ist.
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext) typedef
void(*
Pointer wird während eines IEEE 802.15.4-Energiescans aufgerufen, wenn das Ergebnis für einen Kanal bereit ist oder der Scan abgeschlossen ist.
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext) typedef
void(*
Pointer wird aufgerufen, wenn ein IEEE 802.15.4-Frame empfangen wird.
otMacCounters typedef
struct otMacCounters
Stellt die MAC-Ebenenzähler dar.
otMacFilterAddressMode typedef
Definiert den Adressmodus des Mac-Filters.
otMacFilterEntry typedef
Stellt einen Mac-Filtereintrag dar.
otMacFilterIterator typedef
uint8_t
Wird verwendet, um durch Mac-Filtereinträge zu iterieren.
otThreadLinkInfo typedef
Linkspezifische Informationen zu Nachrichten, die vom Thread-Funk empfangen wurden.

Funktionen
otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
Startet einen aktiven Scan gemäß IEEE 802.15.4.
otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)
int8_t
Wandelt die Linkqualität in die typische Empfangssignalstärke um.
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
uint8_t
Wandelt die empfangene Signalstärke in die Linkqualität um.
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
Startet einen IEEE 802.15.4-Energiescan.
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
Fügt dem MAC-Filter eine erweiterte Adresse hinzu.
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
Fügt die angegebene erweiterte Adresse der RssIn-Liste hinzu (oder ändert eine vorhandene Adresse in der RssIn-Liste) und legt den Eintrag für die empfangene Signalstärke (in dBm) für Nachrichten von dieser Adresse fest.
otLinkFilterClearAddresses(otInstance *aInstance)
void
Löscht alle erweiterten Adressen aus dem MAC-Filter.
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
Löscht alle Einträge für die empfangene Signalstärke (rss) und die Linkqualitätsanzeige (lqi) (einschließlich Standardeinstellungen) aus der Liste RssIn.
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
Löscht die zuvor eingestellte Standardstärke des empfangenen Signals (in dBm) im MAC-Filter.
otLinkFilterGetAddressMode(otInstance *aInstance)
Ruft den Adressmodus des MAC-Filters ab.
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Ruft einen bereits verwendeten Adressfilter ab.
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Ruft einen bereits verwendeten RssIn-Filtereintrag ab.
otLinkFilterRemoveAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
Entfernt eine erweiterte Adresse aus dem MAC-Filter.
otLinkFilterRemoveRssIn(otInstance *aInstance, const otExtAddress *aExtAddress)
void
Entfernt die angegebene erweiterte Adresse aus der RssIn-Liste.
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
void
Legt den Adressmodus des MAC-Filters fest.
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
void
Legt die Standardstärke des empfangenen Signals (in dBm) für MAC Filter fest.
otLinkGetCcaFailureRate(otInstance *aInstance)
uint16_t
Gibt die aktuelle CCA-Fehlerrate (Clear Channel Assessment) zurück.
otLinkGetChannel(otInstance *aInstance)
uint8_t
Rufen Sie den IEEE 802.15.4-Kanal ab.
otLinkGetCounters(otInstance *aInstance)
const otMacCounters *
Rufen Sie die MAC-Ebenenzähler ab.
otLinkGetCslChannel(otInstance *aInstance)
uint8_t
Ruft den CSL-Kanal ab.
otLinkGetCslPeriod(otInstance *aInstance)
uint32_t
Ruft den CSL-Zeitraum in Mikrosekunden ab.
otLinkGetCslTimeout(otInstance *aInstance)
uint32_t
Ruft das CSL-Zeitlimit ab.
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
Ruft die erweiterte IEEE 802.15.4-Adresse ab.
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
Holen Sie sich das werkseitig zugewiesene IEEE EUI-64.
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
Gibt die maximale Anzahl von Frame-Wiederholungen während der direkten Übertragung zurück.
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
Gibt die maximale Anzahl von Frame-Wiederholungen während der indirekten Übertragung zurück.
otLinkGetPanId(otInstance *aInstance)
Rufen Sie die IEEE 802.15.4-PAN-ID ab.
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
Datenabfragezeitraum für ein schläfriges Endgerät abrufen.
otLinkGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
Rufen Sie den Regionscode ab.
otLinkGetShortAddress(otInstance *aInstance)
Rufen Sie die IEEE 802.15.4-Kurzadresse ab.
otLinkGetSupportedChannelMask(otInstance *aInstance)
uint32_t
Rufen Sie die unterstützte Kanalmaske der MAC-Ebene ab.
otLinkGetTxDirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Ruft das Histogramm der Wiederholungsversuche für ein einzelnes direktes Paket bis zum Erfolg ab.
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Ruft das Histogramm der Wiederholungsversuche für ein einzelnes indirektes Paket bis zum Erfolg ab.
otLinkIsActiveScanInProgress(otInstance *aInstance)
bool
Gibt an, ob gerade ein aktiver IEEE 802.15.4-Scan ausgeführt wird.
otLinkIsCslEnabled(otInstance *aInstance)
bool
Gibt an, ob CSL aktiviert ist.
otLinkIsCslSupported(otInstance *aInstance)
bool
Gibt an, ob das Gerät mit einem Elternteil verbunden ist, der CSL unterstützt.
otLinkIsEnabled(otInstance *aInstance)
bool
Gibt an, ob die Link-Ebene aktiviert ist.
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
Gibt an, ob gerade ein IEEE 802.15.4-Energiescan ausgeführt wird.
otLinkIsInTransmitState(otInstance *aInstance)
bool
Gibt an, ob sich ein IEEE 802.15.4-MAC im Übertragungsstatus befindet.
otLinkIsPromiscuous(otInstance *aInstance)
bool
Gibt an, ob der promiskuitive Modus auf Linkebene aktiviert ist.
otLinkIsRadioFilterEnabled(otInstance *aInstance)
bool
Gibt an, ob der IEEE 802.15.4-Funkfilter aktiviert ist oder nicht.
otLinkResetCounters(otInstance *aInstance)
void
Setzt die MAC-Ebenenzähler zurück.
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
void
Löscht Histogrammstatistiken für direkte und indirekte Übertragungen.
otLinkSendDataRequest(otInstance *aInstance)
Stellt eine IEEE 802.15.4-Datenanfragenachricht zur Übertragung in die Warteschlange.
otLinkSendEmptyData(otInstance *aInstance)
Weist das Gerät an, einen leeren IEEE 802.15.4-Dataframe zu senden.
otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)
Legen Sie den IEEE 802.15.4-Kanal fest.
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)
Legt den CSL-Kanal fest.
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)
Legt den CSL-Zeitraum in Mikrosekunden fest.
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)
Legt das CSL-Zeitlimit in Sekunden fest.
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
Aktiviert oder deaktiviert die Link-Ebene.
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
Legt die erweiterte IEEE 802.15.4-Adresse fest.
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
Legt die maximale Anzahl von Frame-Wiederholungen während der direkten Übertragung fest.
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
Legt die maximale Anzahl von Frame-Wiederholungen während der indirekten Übertragung fest.
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
Legen Sie die IEEE 802.15.4-PAN-ID fest.
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
Registriert einen Callback, um empfangene Roh-IEEE 802.15.4-Frames bereitzustellen.
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
Hiermit wird der Zeitraum der vom Nutzer angegebenen/externen Datenabfrage für schläfriges Endgerät festgelegt/gelöscht.
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
Aktiviert oder deaktiviert den promiskuitiven Modus der Link-Ebene.
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
void
Aktiviert/deaktiviert den IEEE 802.15.4-Funkfiltermodus.
otLinkSetRegion(otInstance *aInstance, uint16_t aRegionCode)
Legt den Regionscode fest.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
Legen Sie die unterstützte Kanalmaske der MAC-Ebene fest.

Strukturen
otActiveScanResult

Stellt ein empfangenes IEEE 802.15.4-Beacon dar.

otEnergyScanResult

Stellt ein Ergebnis des Energiescans dar.

otMacCounters

Stellt die MAC-Ebenenzähler dar.

otMacFilterEntry

Stellt einen Mac-Filtereintrag dar.

otThreadLinkInfo

Linkspezifische Informationen zu Nachrichten, die vom Thread-Funk empfangen wurden.

Aufzählungen

otMacFilterAddressMode

 otMacFilterAddressMode

Definiert den Adressmodus des Mac-Filters.

Attribute
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

Der Modus zum Filtern von Adressen auf der Zulassungsliste ist aktiviert.

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

Der Filtermodus für die Sperrliste ist aktiviert.

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

Adressfilter ist deaktiviert.

Typedefs

otActiveScanResult

struct otActiveScanResult otActiveScanResult

Stellt ein empfangenes IEEE 802.15.4-Beacon dar.

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

Stellt ein Ergebnis des Energiescans dar.

otHandleActiveScanResult

void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)

Pointer wird während eines aktiven IEEE 802.15.4-Scans aufgerufen, wenn ein IEEE 802.15.4-Beacon empfangen wird oder der Scan abgeschlossen ist.

Details
Parameter
[in] aResult
Ein gültiger Zeiger auf die Beacon-Informationen oder NULL bei Abschluss des aktiven Scans.
[in] aContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.

otHandleEnergyScanResult

void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)

Pointer wird während eines IEEE 802.15.4-Energiescans aufgerufen, wenn das Ergebnis für einen Kanal bereit ist oder der Scan abgeschlossen ist.

Details
Parameter
[in] aResult
Ein gültiger Zeiger auf die Ergebnisinformationen des Energy Scans oder NULL, wenn der Energy Scan abgeschlossen ist.
[in] aContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.

otLinkPcapCallback

void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

Pointer wird aufgerufen, wenn ein IEEE 802.15.4-Frame empfangen wird.

Details
Parameter
[in] aFrame
Ein Zeiger auf den empfangenen IEEE 802.15.4-Frame.
[in] aIsTx
Gibt an, ob dieser Frame übertragen, nicht empfangen wird.
[in] aContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.

otMacCounters

struct otMacCounters otMacCounters

Stellt die MAC-Ebenenzähler dar.

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

Definiert den Adressmodus des Mac-Filters.

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

Stellt einen Mac-Filtereintrag dar.

otMacFilterIterator

uint8_t otMacFilterIterator

Wird verwendet, um durch Mac-Filtereinträge zu iterieren.

otThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

Linkspezifische Informationen zu Nachrichten, die vom Thread-Funk empfangen wurden.

Funktionen

otLinkActiveScan

otError otLinkActiveScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

Startet einen aktiven Scan gemäß IEEE 802.15.4.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aScanChannels
Ein Bitvektor, der angibt, nach welchen Kanälen gesucht werden soll (z.B. OT_CHANNEL_11_MASK).
[in] aScanDuration
Zeit in Millisekunden, die für den Suchlauf der einzelnen Kanäle benötigt wird.
[in] aCallback
Ein Zeiger auf eine Funktion, die beim Empfang eines Beacons oder Scans aufgerufen wird.
[in] aCallbackContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Die Anfrage für den aktiven Scan wurde akzeptiert.
OT_ERROR_BUSY
Es wird bereits ein aktiver Scan durchgeführt.

otLinkConvertLinkQualityToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

Wandelt die Linkqualität in die typische Empfangssignalstärke um.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aLinkQuality
LinkQuality-Wert, sollte im Bereich [0,3] liegen.
Rückgabe
Typische Plattform hat eine Zuordnung der Signalstärke zu aLinkQuality empfangen.

otLinkConvertRssToLinkQuality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

Wandelt die empfangene Signalstärke in die Linkqualität um.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aRss
Der Wert der empfangenen Signalstärke, der umgewandelt werden soll.
Rückgabe
Zuordnung des Qualitätswerts zu aRss verknüpfen.

otLinkEnergyScan

otError otLinkEnergyScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleEnergyScanResult aCallback,
  void *aCallbackContext
)

Startet einen IEEE 802.15.4-Energiescan.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aScanChannels
Ein Bitvektor, der angibt, für welche Kanäle der Energiesuchlauf durchgeführt werden soll.
[in] aScanDuration
Zeit in Millisekunden, die für den Suchlauf der einzelnen Kanäle benötigt wird.
[in] aCallback
Ein Zeiger auf eine Funktion, die aufgerufen wird, um das Scanergebnis bei Abschluss des Scans zu übergeben.
[in] aCallbackContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Die Energiescan-Anforderung wurde akzeptiert.
OT_ERROR_BUSY
Der Energiescan konnte nicht gestartet werden.

otLinkFilterAddAddress

otError otLinkFilterAddAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Fügt dem MAC-Filter eine erweiterte Adresse hinzu.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Ein Zeiger auf die erweiterte Adresse (DARF NICHT NULL sein).
Rückgabewerte
OT_ERROR_NONE
aExtAddress wurde dem MAC-Filter hinzugefügt.
OT_ERROR_NO_BUFS
Kein verfügbarer Eintrag vorhanden.

otLinkFilterAddRssIn

otError otLinkFilterAddRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  int8_t aRss
)

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

Die erweiterte Adresse muss nicht unbedingt im Filter address allowlist/denylist enthalten sein, um rss festzulegen.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Ein Verweis auf die erweiterte IEEE 802.15.4-Adresse. DARF NICHT NULL sein.
[in] aRss
Die Stärke des empfangenen Signals (in dBm).
Rückgabewerte
OT_ERROR_NONE
Für aExtAddress und aRss wurde ein Eintrag hinzugefügt.
OT_ERROR_NO_BUFS
Kein verfügbarer Eintrag vorhanden.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

Löscht alle erweiterten Adressen aus dem MAC-Filter.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

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

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

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

Löscht die zuvor eingestellte Standardstärke des empfangenen Signals (in dBm) im MAC-Filter.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

Ruft den Adressmodus des MAC-Filters ab.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
im Adressmodus.

otLinkFilterGetNextAddress

otError otLinkFilterGetNextAddress(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Ruft einen bereits verwendeten Adressfilter ab.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf den Kontext des MAC-Filters. Um den ersten Adressfiltereintrag zu erhalten, muss dieser auf OT_MAC_FILTER_ITERATOR_INIT festgelegt werden. DARF NICHT NULL sein.
[out] aEntry
Ein Zeiger an die Stelle, an der die Informationen platziert werden. DARF NICHT NULL sein.
Rückgabewerte
OT_ERROR_NONE
Ein Adressfiltereintrag in Verwendung wurde abgerufen.
OT_ERROR_NOT_FOUND
Es ist kein nachfolgender Eintrag vorhanden.

otLinkFilterGetNextRssIn

otError otLinkFilterGetNextRssIn(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Ruft einen bereits verwendeten RssIn-Filtereintrag ab.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf den Kontext des MAC-Filters. DARF NICHT NULL sein. Um den ersten Eintrag zu erhalten, sollte er auf OT_MAC_FILTER_ITERATOR_INIT festgelegt werden.
[out] aEntry
Ein Zeiger an die Stelle, an der die Informationen platziert werden. Der letzte Eintrag hätte die erweiterte Adresse als alle 0xff, um die standardmäßige Stärke des empfangenen Signals anzugeben, sofern diese festgelegt wurde. aEntry DARF NICHT NULL sein.
Rückgabewerte
OT_ERROR_NONE
Der nächste Eintrag wurde abgerufen.
OT_ERROR_NOT_FOUND
Es ist kein nachfolgender Eintrag vorhanden.

otLinkFilterRemoveAddress

void otLinkFilterRemoveAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Entfernt eine erweiterte Adresse aus dem MAC-Filter.

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

Wenn im Filter kein Eintrag vorhanden ist, der mit der angegebenen erweiterten Adresse übereinstimmt, wird keine Aktion ausgeführt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Ein Zeiger auf die erweiterte Adresse (DARF NICHT NULL sein).

otLinkFilterRemoveRssIn

void otLinkFilterRemoveRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Entfernt die angegebene erweiterte Adresse aus der RssIn-Liste.

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

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

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Ein Verweis auf die erweiterte IEEE 802.15.4-Adresse. DARF NICHT NULL sein.

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

Legt den Adressmodus des MAC-Filters fest.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aMode
Der festzulegende Adressmodus.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

Legt die Standardstärke des empfangenen Signals (in dBm) für MAC Filter fest.

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

Der RSS-Standardwert wird für alle empfangenen Frames von Adressen verwendet, für die in der Filterliste kein expliziter RSS-IN-Eintrag vorhanden ist (durch otLinkFilterAddRssIn() hinzugefügt).

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aRss
Die festzulegende Standardstärke des empfangenen Signals (in dBm).

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

Gibt die aktuelle CCA-Fehlerrate (Clear Channel Assessment) zurück.

Die Rate wird über ein Fenster der (ungefähr) letzten Frameübertragungen von OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW beibehalten.

Details
Rückgabe
Die CCA-Fehlerrate mit dem Höchstwert 0xffff, der einer Fehlerrate von 100% entspricht.

otLinkGetChannel

uint8_t otLinkGetChannel(
  otInstance *aInstance
)

Rufen Sie den IEEE 802.15.4-Kanal ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der IEEE 802.15.4-Kanal.
Weitere Informationen:
otLinkSetChannel

otLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

Rufen Sie die MAC-Ebenenzähler ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Ein Zeiger auf die MAC-Ebenenzähler.

otLinkGetCslChannel

uint8_t otLinkGetCslChannel(
  otInstance *aInstance
)

Ruft den CSL-Kanal ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der CSL-Kanal.

otLinkGetCslPeriod

uint32_t otLinkGetCslPeriod(
  otInstance *aInstance
)

Ruft den CSL-Zeitraum in Mikrosekunden ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der CSL-Zeitraum in Mikrosekunden.

otLinkGetCslTimeout

uint32_t otLinkGetCslTimeout(
  otInstance *aInstance
)

Ruft das CSL-Zeitlimit ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Das CSL-Zeitlimit in Sekunden.

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

Ruft die erweiterte IEEE 802.15.4-Adresse ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Ein Verweis auf die erweiterte IEEE 802.15.4-Adresse.

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

Holen Sie sich das werkseitig zugewiesene IEEE EUI-64.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[out] aEui64
Ein Zeiger auf die Stelle, an der der werkseitig zugewiesene IEEE EUI-64 platziert wird.

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

Gibt die maximale Anzahl von Frame-Wiederholungen während der direkten Übertragung zurück.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Die maximale Anzahl der Wiederholungsversuche während der direkten Übertragung.

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

Gibt die maximale Anzahl von Frame-Wiederholungen während der indirekten Übertragung zurück.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Die maximale Anzahl der Wiederholungsversuche während der indirekten Übertragung.

otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

Rufen Sie die IEEE 802.15.4-PAN-ID ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Die IEEE 802.15.4-PAN-ID.
Siehe auch:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

Datenabfragezeitraum für ein schläfriges Endgerät abrufen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der Zeitraum der Datenabfrage des schläfrigen Endgeräts in Millisekunden.
Weitere Informationen:
otLinkSetPollPeriod

otLinkGetRegion

otError otLinkGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

Rufen Sie den Regionscode ab.

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

Details
Parameter
[in] aInstance
Die OpenThread-Instanzstruktur.
[out] aRegionCode
Der Regionscode der Funkschnittstelle. aRegionCode >> 8 ist das erste ASCII-Zeichen und aRegionCode & 0xff ist das zweite ASCII-Zeichen.
Rückgabewerte
OT_ERROR_INVALID_ARGS
aRegionCode ist nullptr.
OT_ERROR_FAILED
Andere plattformspezifische Fehler.
OT_ERROR_NONE
Regionscode wurde abgerufen.
OT_ERROR_NOT_IMPLEMENTED
Die Funktion ist nicht implementiert.

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

Rufen Sie die IEEE 802.15.4-Kurzadresse ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Ein Zeiger auf die IEEE 802.15.4-Kurzadresse.

otLinkGetSupportedChannelMask

uint32_t otLinkGetSupportedChannelMask(
  otInstance *aInstance
)

Rufen Sie die unterstützte Kanalmaske der MAC-Ebene ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Die unterstützte Kanalmaske als uint32_t mit einer Zuordnung von Bit 0 (lsb) zu Kanal 0, Bit 1 zu Kanal 1 usw.

otLinkGetTxDirectRetrySuccessHistogram

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Ruft das Histogramm der Wiederholungsversuche für ein einzelnes direktes Paket bis zum Erfolg ab.

Ist gültig, wenn die Konfiguration OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[out] aNumberOfEntries
Zeiger an die Stelle, an der die Größe des zurückgegebenen Histogrammarrays platziert wird.
Rückgabe
Ein Zeiger auf das Histogramm der Wiederholungsversuche (in Form eines Arrays). Das n-te Element gibt an, dass das Paket mit dem n-ten Wiederholungsversuch gesendet wurde.

otLinkGetTxIndirectRetrySuccessHistogram

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Ruft das Histogramm der Wiederholungsversuche für ein einzelnes indirektes Paket bis zum Erfolg ab.

Ist gültig, wenn die Konfiguration OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[out] aNumberOfEntries
Zeiger an die Stelle, an der die Größe des zurückgegebenen Histogrammarrays platziert wird.
Rückgabe
Ein Zeiger auf das Histogramm der Wiederholungsversuche (in Form eines Arrays). Das n-te Element gibt an, dass das Paket mit dem n-ten Wiederholungsversuch gesendet wurde.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

Gibt an, ob gerade ein aktiver IEEE 802.15.4-Scan ausgeführt wird.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
„true“, wenn ein aktiver Scan gemäß IEEE 802.15.4 ausgeführt wird, andernfalls „false“.

otLinkIsCslEnabled

bool otLinkIsCslEnabled(
  otInstance *aInstance
)

Gibt an, ob CSL aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
TRUE
Die Linkebene ist CSL aktiviert.
FALSE
Die Linkebene ist nicht CSL aktiviert.

otLinkIsCslSupported

bool otLinkIsCslSupported(
  otInstance *aInstance
)

Gibt an, ob das Gerät mit einem Elternteil verbunden ist, der CSL unterstützt.

Details
Rückgabewerte
TRUE
Ob ein Elternteil CSL unterstützt.
FALSE
Wenn ein Elternteil CSL nicht unterstützt.

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

Gibt an, ob die Link-Ebene aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
TRUE
Link-Ebene ist aktiviert.
FALSE
Link-Ebene ist nicht aktiviert.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

Gibt an, ob gerade ein IEEE 802.15.4-Energiescan ausgeführt wird.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
„true“, wenn ein IEEE 802.15.4-Energiescan ausgeführt wird, andernfalls „false“.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

Gibt an, ob sich ein IEEE 802.15.4-MAC im Übertragungsstatus befindet.

Das MAC-Modul befindet sich während der CSMA/CA-Verfahren bzw. der CCA-, Daten-, Beacon- oder Datenanfrage-Frameübertragung im Übertragungsstatus und empfängt eine Bestätigung eines übertragenen Frames. Das MAC-Modul befindet sich bei der Übertragung eines ACK-Frames oder eines Beacon-Request-Frames nicht im Übertragungsstatus.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
„true“, wenn ein IEEE 802.15.4-MAC im Übertragungsstatus ist, andernfalls „false“.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
TRUE
Der promiskuitive Modus ist aktiviert.
FALSE
Promiskuitiver Modus ist nicht aktiviert.

otLinkIsRadioFilterEnabled

bool otLinkIsRadioFilterEnabled(
  otInstance *aInstance
)

Gibt an, ob der IEEE 802.15.4-Funkfilter aktiviert ist oder nicht.

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

Details
Rückgabewerte
TRUE
Ob der Optionsfeldfilter aktiviert ist.
FALSE
Ob der Funkfilter deaktiviert ist.

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

Setzt die MAC-Ebenenzähler zurück.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

Löscht Histogrammstatistiken für direkte und indirekte Übertragungen.

Ist gültig, wenn die Konfiguration OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

Stellt eine IEEE 802.15.4-Datenanfragenachricht zur Übertragung in die Warteschlange.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Eine IEEE 802.15.4-Datenanfragenachricht wurde in die Warteschlange gestellt.
OT_ERROR_INVALID_STATE
Das Gerät befindet sich nicht im Modus „rx-off-when-idle“.
OT_ERROR_NO_BUFS
Nicht genügend Nachrichtenpuffer verfügbar.

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

Weist das Gerät an, einen leeren IEEE 802.15.4-Dataframe zu senden.

Wird nur auf einem Rx-Off-When-Idle-Gerät unterstützt, das einen leeren Dataframe an das übergeordnete Gerät sendet. Hinweis: Nur verfügbar, wenn OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Eine leere Nachricht wurde in die Warteschlange gestellt.
OT_ERROR_INVALID_STATE
Das Gerät befindet sich nicht im Modus „Rx-Off-When-Idle“.
OT_ERROR_NO_BUFS
Nicht genügend Nachrichtenpuffer verfügbar.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Legen Sie den IEEE 802.15.4-Kanal fest.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aChannel
Der IEEE 802.15.4-Kanal.
Rückgabewerte
OT_ERROR_NONE
Kanal wurde festgelegt.
OT_ERROR_INVALID_ARGS
Wenn aChannel nicht im Bereich [11, 26] oder nicht in der unterstützten Kanalmaske enthalten ist.
OT_ERROR_INVALID_STATE
Thread-Protokolle sind aktiviert.
Weitere Informationen:
otLinkGetChannel

otLinkSetCslChannel

otError otLinkSetCslChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Legt den CSL-Kanal fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aChannel
Der CSL-Beispielkanal. Der Kanalwert muss 0 (CSL-Kanal nicht angegeben) oder innerhalb des Bereichs [1, 10] (wenn 915 MHz unterstützt wird) und 11, 26 sein.
Rückgabewerte
OT_ERROR_NONE
CSL-Parameter wurden festgelegt.
OT_ERROR_INVALID_ARGS
aChannel ungültig.

otLinkSetCslPeriod

otError otLinkSetCslPeriod(
  otInstance *aInstance,
  uint32_t aPeriod
)

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.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aPeriod
Der CSL-Zeitraum in Mikrosekunden.
Rückgabewerte
OT_ERROR_NONE
CSL-Zeitraum erfolgreich festgelegt.
OT_ERROR_INVALID_ARGS
Ungültiger CSL-Zeitraum

otLinkSetCslTimeout

otError otLinkSetCslTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

Legt das CSL-Zeitlimit in Sekunden fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aTimeout
Das CSL-Zeitlimit in Sekunden.
Rückgabewerte
OT_ERROR_NONE
CSL-Zeitlimit erfolgreich festgelegt.
OT_ERROR_INVALID_ARGS
Ungültiges CSL-Zeitlimit.

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Aktiviert oder deaktiviert die Link-Ebene.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnable
true, um den Link-Layer zu aktivieren, oder false.
Rückgabewerte
OT_ERROR_NONE
Die Link-Ebene wurde aktiviert bzw. deaktiviert.
OT_ERROR_INVALID_STATE
Der Link-Layer konnte nicht deaktiviert werden, da die Thread-Schnittstelle aktiviert ist.

otLinkSetExtendedAddress

otError otLinkSetExtendedAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Legt die erweiterte IEEE 802.15.4-Adresse fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Ein Verweis auf die erweiterte IEEE 802.15.4-Adresse.
Rückgabewerte
OT_ERROR_NONE
Die erweiterte IEEE 802.15.4-Adresse wurde festgelegt.
OT_ERROR_INVALID_ARGS
aExtAddress war NULL.
OT_ERROR_INVALID_STATE
Thread-Protokolle sind aktiviert.

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

Legt die maximale Anzahl von Frame-Wiederholungen während der direkten Übertragung fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aMaxFrameRetriesDirect
Die maximale Anzahl der Wiederholungsversuche während der direkten Übertragung.

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

Legt die maximale Anzahl von Frame-Wiederholungen während der indirekten Übertragung fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aMaxFrameRetriesIndirect
Die maximale Anzahl der Wiederholungsversuche während der indirekten Übertragung.

otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

Legen Sie die IEEE 802.15.4-PAN-ID fest.

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aPanId
Die IEEE 802.15.4-PAN-ID.
Rückgabewerte
OT_ERROR_NONE
PAN-ID wurde festgelegt.
OT_ERROR_INVALID_ARGS
Wenn aPanId nicht im Bereich liegt [0, 65534].
OT_ERROR_INVALID_STATE
Thread-Protokolle sind aktiviert.
Siehe auch:
otLinkGetPanId

otLinkSetPcapCallback

void otLinkSetPcapCallback(
  otInstance *aInstance,
  otLinkPcapCallback aPcapCallback,
  void *aCallbackContext
)

Registriert einen Callback, um empfangene Roh-IEEE 802.15.4-Frames bereitzustellen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aPcapCallback
Ein Zeiger auf eine Funktion, die aufgerufen wird, wenn ein IEEE 802.15.4-Link-Frame oder NULL empfangen wird, um den Callback zu deaktivieren.
[in] aCallbackContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

Hiermit wird der Zeitraum der vom Nutzer angegebenen/externen Datenabfrage für schläfriges Endgerät festgelegt/gelöscht.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aPollPeriod
Zeitraum der Datenabfrage in Millisekunden.
Rückgabewerte
OT_ERROR_NONE
Der vom Nutzer angegebene Umfragezeitraum wurde festgelegt/gelöscht.
OT_ERROR_INVALID_ARGS
Wenn aPollPeriod ungültig ist.
Weitere Informationen:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

Aktiviert oder deaktiviert den promiskuitiven Modus der Link-Ebene.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aPromiscuous
true, um den promiskuitiven Modus zu aktivieren, oder false.
Rückgabewerte
OT_ERROR_NONE
Promiskuitiver Modus wurde aktiviert.
OT_ERROR_INVALID_STATE
Promiskuitiver Modus konnte nicht aktiviert werden, da die Thread-Oberfläche aktiviert ist.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

Aktiviert/deaktiviert den IEEE 802.15.4-Funkfiltermodus.

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

Der Funkfilter ist hauptsächlich zum Testen gedacht. Es kann verwendet werden, um vorübergehend alle tx/rx auf der 802.15.4-Funkschnittstelle zu blockieren. Wenn der Funkfilter aktiviert ist, wird das Radio in den Ruhezustand versetzt und nicht in den Empfang, um sicherzustellen, dass das Gerät keinen Frame empfängt und/oder keine Bestätigung sendet. Außerdem werden die Anfragen zur Frameübertragung sofort zurückgegeben, ohne dass der Frame over-the-air gesendet wird. Wenn eine Bestätigung angefordert wird, wird der Fehler „no ack“ zurückgegeben, andernfalls „Erfolg“.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aFilterEnabled
TRUE zum Aktivieren des Funkfilters, FALSE zum Deaktivieren

otLinkSetRegion

otError otLinkSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

Legt den Regionscode fest.

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

Details
Parameter
[in] aInstance
Die OpenThread-Instanzstruktur.
[in] aRegionCode
Der Regionscode der Funkschnittstelle. aRegionCode >> 8 ist das erste ASCII-Zeichen und aRegionCode & 0xff ist das zweite ASCII-Zeichen.
Rückgabewerte
OT_ERROR_FAILED
Andere plattformspezifische Fehler.
OT_ERROR_NONE
Regionscode erfolgreich festgelegt.
OT_ERROR_NOT_IMPLEMENTED
Die Funktion ist nicht implementiert.

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Legen Sie die unterstützte Kanalmaske der MAC-Ebene fest.

Nur erfolgreich, wenn Thread-Protokolle deaktiviert sind.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aChannelMask
Die unterstützte Kanalmaske (Bit 0 oder lsb-Zuordnung auf Kanal 0 usw.).
Rückgabewerte
OT_ERROR_NONE
Die unterstützte Kanalmaske wurde festgelegt.
OT_ERROR_INVALID_STATE
Thread-Protokolle sind aktiviert.

Makros

 OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC (160)

Stellt die Einheit des CSL-Zeitraums mit zehn Symbolen in Mikrosekunden dar.

Der CSL-Zeitraum (in Mikrosekunden) MUSS ein Vielfaches dieses Werts sein.

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

Wird verwendet, um anzuzeigen, dass keine feste Empfangssignalstärke eingestellt wurde.

OT_MAC_FILTER_ITERATOR_INIT

 OT_MAC_FILTER_ITERATOR_INIT 0

Initialisierer für otMacFilterIterator.

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS OT_RADIO_TEN_SYMBOLS_TIME

Zeit für 10 Symbole in Mikrosekunden.

Ressourcen

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.