Rohlink

Dieses Modul enthält Funktionen zur Steuerung der Rohkonfiguration der Linkebene.

Fazit

Typdef.
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) Typdef
void(*
Dieser Funktionszeiger wird nach Empfang eines IEEE 802.15.4-Frames angezeigt.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) Typdef
void(*
Dieser Funktionszeiger wird nach Empfang eines IEEE 802.15.4-Frames angezeigt.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) Typdef
void(*
Dieser Funktionszeiger wird nach Empfang eines IEEE 802.15.4-Frames angezeigt.

Funktionen
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Diese Methode startet den Energiescan auf dem Radio.
otLinkRawGetCaps(otInstance *aInstance)
Hol dir Radio.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Diese Funktion erhält den Status des promiskuitiven Modus.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Rufen Sie die aktuelle Plattformzeit (64-Bit-Breite) des Radiochips ab.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Erhalten Sie die letzte RSSI-Messung.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
Das Radio wechselt von „Übertragen“ zu „Empfang“.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Diese Funktion gibt an, ob die standardmäßige Linkebene aktiviert ist.
otLinkRawReceive(otInstance *aInstance)
Das Radio wird von „Schlaf“ zu „Empfangen“ umgestellt.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Legt den aktuellen Wert des MAC-Frame-Zählers fest.
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)
Mit dieser Funktion wird der promiskuitive Modus aktiviert oder deaktiviert.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Mit dieser Funktion wird die standardmäßige Linkebene aktiviert bzw. deaktiviert.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Legen Sie die Kurzadresse für die Adressfilterung fest.
otLinkRawSleep(otInstance *aInstance)
Stelle das Radio von „Empfangen“ auf „Schlaf“ um.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Erweiterte Adresse zur Quellübereinstimmungstabelle hinzufügen.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Kurze Adresse wird der Match-Table der Quelle hinzugefügt.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Alle erweiterten Adressen aus der Quellübereinstimmungstabelle entfernen.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Erweiterte Adresse wird aus der Quellübereinstimmungstabelle des Radios entfernt.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Alle kurzen Adressen werden aus der Quellübereinstimmungstabelle entfernt.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Die kurze Adresse wird aus der Quellübereinstimmungstabelle entfernt.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Quellübereinstimmung für Frame ausstehend aktivieren/deaktivieren.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Diese Methode startet die Übertragungssequenz im Radio.

Typdef.

otLinkRawEnergyScanFertig

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

Dieser Funktionszeiger wird nach Empfang eines IEEE 802.15.4-Frames angezeigt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnergyScanMaxRssi
Die maximale RSSI, die im gescannten Kanal gefunden wurde.

otLinkRawReceiveDone

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

Dieser Funktionszeiger wird nach Empfang eines IEEE 802.15.4-Frames angezeigt.

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)

Dieser Funktionszeiger wird nach Empfang eines IEEE 802.15.4-Frames angezeigt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aFrame
Ein Zeiger auf den übertragenen Frame.
[in] aAckFrame
Ein Zeiger auf den ACK-Frame.
[in] aError
OT_ERROR_NONE, wenn der Frame übertragen wurde OT_ERROR_NO_ACK, wenn der Frame übertragen wurde, aber ACK nicht empfangen wurde OT_ERROR_CHANNEL_ACCESS_FAILURE, wenn die Übertragung aufgrund von Aktivitäten auf dem Kanal nicht durchgeführt werden 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
)

Diese Methode startet den Energiescan auf dem Radio.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aScanChannel
Der Kanal, auf dem der Energiescan durchgeführt werden soll.
[in] aScanDuration
Die Dauer in Millisekunden, die der Kanal gescannt wird.
[in] aCallback
Ein Zeiger auf eine Funktion, die nach Abschluss eines gescannten Kanals aufgerufen wird.
Rückgabewerte
OT_ERROR_NONE
Scannen des Kanals gestartet.
OT_ERROR_BUSY
Das Radio führt enge Scans durch.
OT_ERROR_NOT_IMPLEMENTED
Das Funkgerät unterstützt das Energiescannen.
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Hol dir Radio.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der Bit-Vektor für Funkfunktionen. Mit dem Stack werden einige Funktionen auf der Grundlage dieses Werts aktiviert oder deaktiviert.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Diese Funktion erhält den Status des promiskuitiven Modus.

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

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Rufen Sie die aktuelle Plattformzeit (64-Bit-Breite) des Radiochips ab.

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

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Erhalten Sie die letzte RSSI-Messung.

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

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Das Radio wechselt von „Übertragen“ zu „Empfang“.

Diese Methode gibt einen Zeiger an den Übertragungszwischenspeicher.

Der Aufrufer bildet in diesem Puffer den IEEE 802.15.4-Frame 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 Übertragungszwischenspeicher oder NULL, wenn die Rohverbindungsebene aktiviert ist.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Diese Funktion gibt an, ob die standardmäßige Linkebene aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
true
Die standardmäßige Linkebene ist aktiviert.
false
Die standardmäßige Linkebene ist deaktiviert.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Das Radio wird von „Schlaf“ zu „Empfangen“ umgestellt.

Schalte das Radio ein.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Erfolgreich auf Empfang umgestellt.
OT_ERROR_INVALID_STATE
Das Radio wurde deaktiviert oder übertragen.

otLinkRawSetMacFrameZähler

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

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

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aMacFrameCounter
Der MAC-Frame-Zählerwert.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene 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 ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Mit dieser Funktion wird der promiskuitive Modus aktiviert oder deaktiviert.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnable
Wert, der den promiskuitiven Modus aktiviert oder deaktiviert.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSetReceivedFertig

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Mit dieser Funktion wird die standardmäßige Linkebene aktiviert bzw. deaktiviert.

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 zu deaktivieren
Rückgabewerte
OT_ERROR_FAILED
Das Radio konnte nicht aktiviert/deaktiviert werden.
OT_ERROR_INVALID_STATE
Wenn die IPv6-Schnittstelle von OpenThread bereits aktiviert ist.
OT_ERROR_NONE
Wenn 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
IEEE 802.15.4-Kurzadresse.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

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

Schalte das Radio aus.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Wechsel zu „Schlaf“ erfolgreich.
OT_ERROR_BUSY
Das Radio ging an
OT_ERROR_INVALID_STATE
Das Radio wurde deaktiviert

otLinkRawSrcMatchAddExtEntry

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

Erweiterte Adresse zur Quellübereinstimmungstabelle hinzufügen.

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übereinstimmungstabelle hinzugefügt.
OT_ERROR_NO_BUFS
Kein Eintrag in der Match-Table der Quelle verfügbar.
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Kurze Adresse wird der Match-Table der Quelle hinzugefügt.

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 zur Quellübereinstimmungstabelle hinzugefügt.
OT_ERROR_NO_BUFS
Kein Eintrag in der Match-Table der Quelle verfügbar.
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Alle erweiterten Adressen aus der Quellübereinstimmungstabelle entfernen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSrcMatchClearExtEntry

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

Erweiterte Adresse wird aus der Quellübereinstimmungstabelle des Radios entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aExtAddress
Die zu entfernende erweiterte Adresse.
Rückgabewerte
OT_ERROR_NONE
Die erweiterte Adresse wurde aus der Quellübereinstimmungstabelle entfernt.
OT_ERROR_NO_ADDRESS
Die erweiterte Adresse befindet sich nicht in der Quellübereinstimmungstabelle.
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Alle kurzen Adressen werden aus der Quellübereinstimmungstabelle entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Die kurze Adresse wird aus der Quellübereinstimmungstabelle entfernt.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aShortAddress
Die kurze Adresse, die entfernt werden soll.
Rückgabewerte
OT_ERROR_NONE
Die kurze Adresse wurde aus der Quellübereinstimmungstabelle entfernt.
OT_ERROR_NO_ADDRESS
Die kurze Adresse befindet sich nicht in der Quellübereinstimmungstabelle.
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Quellübereinstimmung für Frame ausstehend aktivieren/deaktivieren.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aEnable
Quellenübereinstimmung für Frame ausstehend aktivieren/deaktivieren.
Rückgabewerte
OT_ERROR_NONE
Wenn der Vorgang erfolgreich ist
OT_ERROR_INVALID_STATE
Wenn die standardmäßige Linkebene nicht aktiviert ist.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Diese Methode startet die Übertragungssequenz im Radio.

Der Aufrufer muss vor der Übertragung den IEEE 802.15.4-Frame im Puffer erstellen, der von otLinkRawGetTransmitBuffer() bereitgestellt wird. Die Kanal- und Übertragungsleistung ist auch in der otRadioFrame-Struktur enthalten.

Die Übertragungssequenz besteht aus:

  1. Das Radio wird von „Empfangen“ auf „Übertragen“ umgestellt.
  2. Sendet die PSDU auf dem angegebenen Kanal und bei der angegebenen Übertragungsleistung.

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
Erfolgreich auf Übertragen umgestellt.
OT_ERROR_INVALID_STATE
Das Radio befand sich nicht im Empfangsstatus.

Ressourcen

Die Themen der Referenzthread API basieren auf dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen sowie die Möglichkeit, in unserer Dokumentation mitzuwirken, finden Sie unter Ressourcen.