Rohlink

Dieses Modul enthält Funktionen, die die Konfiguration der Rohverbindungsschicht steuern.

Zusammenfassung

Typedefs
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Zeiger bei Empfang eines IEEE 802.15.4-Frames.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Zeiger bei Empfang eines IEEE 802.15.4-Frames.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Zeiger bei Empfang eines IEEE 802.15.4-Frames.

Funktionen
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Startet die Sequenz des Energiescans im Radio.
otLinkRawGetCaps(otInstance *aInstance)
Hol dir die Radiofunktion.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Ruft den Status des promiskuitiven Modus ab.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Aktuelle Plattformzeit (64-Bit-Breite) des Radiochips abrufen.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Aktuelle RSSI-Messung abrufen.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
Die Funkübertragung wechselt von „Übertragen“ zu „Empfangen“.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Gibt an, ob die Rohlink-Layer aktiviert ist.
otLinkRawReceive(otInstance *aInstance)
Das Radio wird vom Ruhemodus auf den Empfang umgestellt.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Legt den aktuellen Wert des MAC-Frame-Zählers fest.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
Legt den aktuellen MAC-Frame-Zählerwert nur fest, wenn der neue Wert größer als der aktuelle ist.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
MAC-Schlüssel und Schlüsselindex aktualisieren.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Aktiviert oder deaktiviert den promiskuitiven Modus.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Aktiviert/deaktiviert die Rohlink-Layer.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Legen Sie die Kurzadresse für die Adressfilterung fest.
otLinkRawSleep(otInstance *aInstance)
Stelle das Radio von „Empfangen“ auf „Ruhemodus“ um.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Der Quell-Match-Table wird die erweiterte Adresse hinzugefügt.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Kurzadresse zur Quell-Match-Table hinzufügen
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Alle erweiterten Adressen werden aus der Quell-Match-Table entfernt.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Die erweiterte Adresse wird aus der Quell-Match-Table des Radiosenders entfernt.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Alle Kurzadressen werden aus der Quell-Match-Table entfernt.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Die Kurzadresse wird aus der Quell-Match-Table entfernt.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Quellabgleich für Frame ausstehend aktivieren/deaktivieren.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Startet die Übertragungssequenz im Radio.

Typedefs

otLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

Zeiger bei Empfang eines IEEE 802.15.4-Frames.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnergyScanMaxRssi
Der maximal auf dem gescannten Kanal gefundene RSSI.

otLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

Zeiger bei Empfang eines IEEE 802.15.4-Frames.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aFrame
Ein Zeiger auf den empfangenen Frame oder NULL, wenn der Empfangsvorgang abgebrochen wurde.
[in] aError
OT_ERROR_NONE wenn ein Frame erfolgreich empfangen wurde. OT_ERROR_ABORT, wenn der Empfang abgebrochen und kein Frame empfangen wurde.

otLinkRawTransmitDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

Zeiger bei Empfang eines IEEE 802.15.4-Frames.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aFrame
Ein Zeiger auf den Frame, der übertragen wurde.
[in] aAckFrame
Ein Zeiger auf den ACK-Frame.
[in] aError
OT_ERROR_NONE zurückgegeben, als der Frame übertragen wurde. OT_ERROR_NO_ACK , wenn der Frame übertragen wurde, aber kein ACK empfangen wurde OT_ERROR_CHANNEL_ACCESS_FAILURE , wenn die Übertragung aufgrund von Aktivitäten auf dem Kanal nicht stattfinden konnte. OT_ERROR_ABORT, wenn die Übertragung aus anderen Gründen abgebrochen wurde.

Funktionen

otLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

Startet die Sequenz des Energiescans im Radio.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aScanChannel
Der Kanal, für den der Energiesuchlauf durchgeführt werden soll.
[in] aScanDuration
Die Dauer in Millisekunden für den Suchlauf des Kanals.
[in] aCallback
Ein Zeiger auf eine Funktion, die nach Abschluss eines Scans aufgerufen wird.
Rückgabewerte
OT_ERROR_NONE
Kanalsuche erfolgreich gestartet.
OT_ERROR_BUSY
Das Radio sucht nun nach Energie.
OT_ERROR_NOT_IMPLEMENTED
Energiescan wird vom Radio nicht unterstützt.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Hol dir die Radiofunktion.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der Bitvektor für die Funkfähigkeit. Der Stapel aktiviert oder deaktiviert einige Funktionen basierend auf diesem Wert.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Ruft den Status des promiskuitiven Modus ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
true
Der promiskuitive Modus ist aktiviert.
false
Der promiskuitive Modus ist deaktiviert.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Aktuelle Plattformzeit (64-Bit-Breite) des Radiochips abrufen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Die aktuelle Radiozeit in Mikrosekunden.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Aktuelle RSSI-Messung abrufen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
RSSI in dBm, wenn er gültig ist. wenn RSSI ungültig ist.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Die Funkübertragung wechselt von „Übertragen“ zu „Empfangen“.

Gibt einen Zeiger an den Übertragungspuffer zurück.

Der Aufrufer bildet den IEEE 802.15.4-Frame in diesem Puffer und ruft dann otLinkRawTransmit() auf, um die Übertragung anzufordern.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Ein Zeiger auf den Übertragungspuffer oder NULL, wenn die Rohlink-Layer nicht aktiviert ist.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Gibt an, ob die Rohlink-Layer aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
true
Der unformatierte Link-Layer ist aktiviert.
false
Der unformatierte Link-Layer ist deaktiviert.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Das Radio wird vom Ruhemodus auf den Empfang umgestellt.

Schalten Sie das Radio ein.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Auf „Empfangen“ umgestellt.
OT_ERROR_INVALID_STATE
Das Radio wurde deaktiviert oder überträgt.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Legt den aktuellen Wert des MAC-Frame-Zählers fest.

Setzt den MAC-Zähler unabhängig vom aktuellen Wert immer auf den neuen Wert aMacFrameCounter.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aMacFrameCounter
Der Wert des MAC-Frame-Zählers.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Legt den aktuellen MAC-Frame-Zählerwert nur fest, wenn der neue Wert größer als der aktuelle ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aMacFrameCounter
Der Wert des MAC-Frame-Zählers.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

MAC-Schlüssel und Schlüsselindex aktualisieren.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aKeyIdMode
Schlüssel-ID-Modus.
[in] aKeyId
Der Schlüsselindex.
[in] aPrevKey
Der vorherige MAC-Schlüssel.
[in] aCurrKey
Der aktuelle MAC-Schlüssel.
[in] aNextKey
Der nächste MAC-Schlüssel.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Aktiviert oder deaktiviert den promiskuitiven Modus.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnable
Ein Wert zum Aktivieren oder Deaktivieren des promiskuitiven Modus.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Aktiviert/deaktiviert die Rohlink-Layer.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aCallback
Ein Zeiger auf eine Funktion, die bei Empfang eines IEEE 802.15.4-Frames aufgerufen wird. NULL, um die Ebene der Rohdaten-Links zu deaktivieren.
Rückgabewerte
OT_ERROR_FAILED
Das Radio konnte nicht aktiviert/deaktiviert werden.
OT_ERROR_INVALID_STATE
Wenn die OpenThread-IPv6-Schnittstelle bereits aktiviert ist.
OT_ERROR_NONE
Gibt an, ob der Aktivierungsstatus erfolgreich festgelegt wurde.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Legen Sie die Kurzadresse für die Adressfilterung fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aShortAddress
Die Kurzadresse gemäß IEEE 802.15.4.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Stelle das Radio von „Empfangen“ auf „Ruhemodus“ um.

Schalte das Radio aus.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Wechsel zu Ruhemodus.
OT_ERROR_BUSY
Das Radio sendete
OT_ERROR_INVALID_STATE
Das Radio wurde deaktiviert

otLinkRawSrcMatchAddExtEntry

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

Der Quell-Match-Table wird die erweiterte Adresse hinzugefügt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Die erweiterte Adresse, die hinzugefügt werden soll.
Rückgabewerte
OT_ERROR_NONE
Die erweiterte Adresse wurde der Quell-Match-Table hinzugefügt.
OT_ERROR_NO_BUFS
Kein Eintrag in der Quell-Match-Table verfügbar.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Kurzadresse zur Quell-Match-Table hinzufügen

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aShortAddress
Die kurze Adresse, die hinzugefügt werden soll.
Rückgabewerte
OT_ERROR_NONE
Die Kurzadresse wurde der Quell-Match-Table hinzugefügt.
OT_ERROR_NO_BUFS
Kein Eintrag in der Quell-Match-Table verfügbar.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Alle erweiterten Adressen werden aus der Quell-Match-Table entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSrcMatchClearExtEntry

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

Die erweiterte Adresse wird aus der Quell-Match-Table des Radiosenders entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Die erweiterte Adresse, die entfernt werden soll.
Rückgabewerte
OT_ERROR_NONE
Die erweiterte Adresse wurde aus der Quell-Match-Table entfernt.
OT_ERROR_NO_ADDRESS
Die erweiterte Adresse ist nicht in der Quell-Match-Table enthalten.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Alle Kurzadressen werden aus der Quell-Match-Table entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Die Kurzadresse wird aus der Quell-Match-Table entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aShortAddress
Die zu entfernende Kurzadresse.
Rückgabewerte
OT_ERROR_NONE
Die Kurzadresse wurde aus der Quell-Match-Table entfernt.
OT_ERROR_NO_ADDRESS
Die Kurzadresse ist nicht in der Quell-Match-Table enthalten.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Quellabgleich für Frame ausstehend aktivieren/deaktivieren.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnable
Quellübereinstimmung für Frame ausstehend aktivieren/deaktivieren.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich war.
OT_ERROR_INVALID_STATE
Wenn der unformatierte Link-Layer nicht aktiviert ist.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Startet die Übertragungssequenz im Radio.

Der Aufrufer muss den IEEE 802.15.4-Frame im von otLinkRawGetTransmitBuffer() bereitgestellten Zwischenspeicher erstellen, bevor er die Übertragung anfordert. Der Kanal und die Sendeleistung sind ebenfalls in der otRadioFrame-Struktur enthalten.

Die Übertragungssequenz besteht aus:

  1. Die Funkverbindung wird auf „Vom Empfangen“ übertragen.
  2. Überträgt die PSDU auf dem gegebenen Kanal und mit der angegebenen Sendeleistung.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aCallback
Ein Zeiger auf eine Funktion, die nach Abschluss der Übertragung aufgerufen wird.
Rückgabewerte
OT_ERROR_NONE
Auf Übertragen umgestellt.
OT_ERROR_INVALID_STATE
Das Radio befand sich nicht im Status „Empfangen“.

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.