Nieprzetworzony link

Ten moduł zawiera funkcje, które kontrolują nieprzetworzoną konfigurację warstwy linków.

Podsumowanie

Typy
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Ten wskaźnik funkcji podczas odbierania ramki IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Ten wskaźnik funkcji podczas odbierania ramki IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Ten wskaźnik funkcji podczas odbierania ramki IEEE 802.15.4.

Funkcje
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Ta metoda rozpoczyna sekwencję skanowania energii w radiu.
otLinkRawGetCaps(otInstance *aInstance)
Korzystaj z radia.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Ta funkcja uzyskuje stan trybu widocznego.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Pobierz bieżący czas platformy (64-bitowa szerokość) elementu radiowego.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Pobierz najnowsze pomiary RSSI.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
Przełącza radio z Transmituj na Odbierz.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Ta funkcja wskazuje, czy włączona jest nieprzetworzona warstwa linku.
otLinkRawReceive(otInstance *aInstance)
Przełączanie radia ze snu do odbierania.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Ustawia bieżącą wartość licznika klatek MAC.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
Zaktualizuj klucze MAC i indeks kluczy.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Ta funkcja umożliwia włączanie i wyłączanie trybu widocznego.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Ta funkcja włącza lub wyłącza nieprzetworzoną warstwę linków.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Ustaw krótki adres do filtrowania adresów.
otLinkRawSleep(otInstance *aInstance)
Przełącz radio ze odbiornika na sen.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Dodaję rozszerzony adres do źródłowej tabeli odpowiedników.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Dodaję krótki adres do tabeli odpowiedników źródła.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Usuwam wszystkie rozszerzone adresy z tabeli dopasowania źródła.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Usuwam rozszerzony adres do tabeli odpowiedników źródła.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Usunięcie wszystkich krótkich adresów z tabeli źródłowej.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Usuwam krótki adres do tabeli odpowiedników źródła.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Włącz/wyłącz dopasowanie źródła dla ramki oczekuje na sprawdzenie.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Ta metoda rozpoczyna sekwencję transmisji w radiu.

Typy

otLinkRawEnergyScanDone

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

Ten wskaźnik funkcji podczas odbierania ramki IEEE 802.15.4.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aEnergyScanMaxRssi
Maksymalna liczba RSSI napotkana na zeskanowanym kanale.

otLinkRawReceiveDone

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

Ten wskaźnik funkcji podczas odbierania ramki IEEE 802.15.4.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aFrame
Wskaźnik odbierającej ramki lub wartość NULL, jeśli operacja odbioru została przerwana.
[in] aError
OT_ERROR_NONE po otrzymaniu klatki. OT_ERROR_ABORT, gdy odbiór został przerwany i ramka nie została odebrana.

otLinkRawTransmitDone

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

Ten wskaźnik funkcji podczas odbierania ramki IEEE 802.15.4.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aFrame
Wskaźnik klatki, która została przesłana.
[in] aAckFrame
Wskaźnik ramki ACK.
[in] aError
OT_ERROR_NONE podczas przesyłania klatki. OT_ERROR_NO_ACK, gdy ramka została przesłana, ale nie odebrano ACK OT_ERROR_CHANNEL_ACCESS_FAILURE, gdy nie można było nawiązać połączenia z powodu aktywności na kanale. OT_ERROR_ABORT, gdy transmisja została przerwana z innych powodów.

Funkcje

Skanowanie OTLinkRawEnergyScan

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

Ta metoda rozpoczyna sekwencję skanowania energii w radiu.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aScanChannel
Kanał, na którym ma zostać przeprowadzone skanowanie energii.
[in] aScanDuration
Czas skanowania kanału w milisekundach.
[in] aCallback
Wskaźnik do funkcji wywoływanej po zakończeniu skanowania kanału.
Zwracane wartości
OT_ERROR_NONE
Skanowanie kanału zostało rozpoczęte.
OT_ERROR_BUSY
Radio przeprowadza skanowanie w całości.
OT_ERROR_NOT_IMPLEMENTED
Radio nie obsługuje skanowania energetycznego.
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

OTLinkRawGetCaps,

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Korzystaj z radia.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Wektor bazowy funkcji radiowej. Stos włącza lub wyłącza niektóre funkcje na podstawie tej wartości.

otLinkRawGetPromiscuus,

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Ta funkcja uzyskuje stan trybu widocznego.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
true
Tryb eksperta jest włączony.
false
Tryb podpowiedzi jest wyłączony.

OTLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Pobierz bieżący czas platformy (64-bitowa szerokość) elementu radiowego.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Bieżąca godzina w mikrosekundach.

otLinkRawGetRssi,

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Pobierz najnowsze pomiary RSSI.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Plik RSSI w dBm, gdy jest prawidłowy. 127, jeśli RSSI jest nieprawidłowy.

otLinkRawGetTransmitBuffer,

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Przełącza radio z Transmituj na Odbierz.

Ta metoda zwraca wskaźnik do bufora transmisji.

Wywołuje on ramkę IEEE 802.15.4 w tym buforze, a następnie wywołuje metodę otLinkRawTransmit(), by zażądać transmisji.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Wskaźnik do bufora transmisji lub wartości NULL, jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Ta funkcja wskazuje, czy włączona jest nieprzetworzona warstwa linku.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
true
Nieprzetworzona warstwa linku jest włączona.
false
Nieprzetworzona warstwa linków jest wyłączona.

otLinkRawReceive,

otError otLinkRawReceive(
  otInstance *aInstance
)

Przełączanie radia ze snu do odbierania.

Włącz radio.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Przeniesiono do Odebrania.
OT_ERROR_INVALID_STATE
Radio było wyłączone lub było transmitowane.

Licznik otLinkRawSetMacFrame

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Ustawia bieżącą wartość licznika klatek MAC.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aMacFrameCounter
Wartość licznika klatek MAC.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

OTLinkRawSetMacKey.

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

Zaktualizuj klucze MAC i indeks kluczy.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aKeyIdMode
Tryb identyfikatora klucza.
[in] aKeyId
Indeks klucza.
[in] aPrevKey
Poprzedni klucz MAC.
[in] aCurrKey
Obecny klucz MAC.
[in] aNextKey
Następny klucz MAC.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

OTLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Ta funkcja umożliwia włączanie i wyłączanie trybu widocznego.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aEnable
Wartość do włączenia lub wyłączenia trybu widocznego.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSetReceive Gotowane

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Ta funkcja włącza lub wyłącza nieprzetworzoną warstwę linków.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aCallback
Wskaźnik do funkcji wywołanej po otrzymaniu ramki według IEEE 802.15.4. Wartość NULL, aby wyłączyć warstwę nieprzetworzonego linku.
Zwracane wartości
OT_ERROR_FAILED
Nie można włączyć ani wyłączyć radia.
OT_ERROR_INVALID_STATE
Jeśli interfejs IPv6 OpenThread został już włączony.
OT_ERROR_NONE
Jeśli stan włączenia został ustawiony.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Ustaw krótki adres do filtrowania adresów.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aShortAddress
Krótki adres: IEEE 802.15.4.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSle

otError otLinkRawSleep(
  otInstance *aInstance
)

Przełącz radio ze odbiornika na sen.

Wyłącz radio.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Udało się przejść w tryb uśpienia.
OT_ERROR_BUSY
Stacja radiowa
OT_ERROR_INVALID_STATE
Radio zostało wyłączone

otLinkRawSrcMatchAddExtEntry,

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

Dodaję rozszerzony adres do źródłowej tabeli odpowiedników.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aExtAddress
Rozszerzony adres, który chcesz dodać.
Zwracane wartości
OT_ERROR_NONE
Rozszerzony adres został dodany do tabeli odpowiedników źródłowej.
OT_ERROR_NO_BUFS
Brak dostępnego wpisu w tabeli odpowiedników źródła.
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSrcMatchAddShortEntry,

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Dodaję krótki adres do tabeli odpowiedników źródła.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aShortAddress
Krótki adres do dodania.
Zwracane wartości
OT_ERROR_NONE
Krótki adres został dodany do źródłowej tabeli odpowiedników.
OT_ERROR_NO_BUFS
Brak dostępnego wpisu w tabeli odpowiedników źródła.
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Usuwam wszystkie rozszerzone adresy z tabeli dopasowania źródła.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSrcMatchClearExtEntry

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

Usuwam rozszerzony adres do tabeli odpowiedników źródła.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aExtAddress
Rozszerzony adres do usunięcia.
Zwracane wartości
OT_ERROR_NONE
Rozszerzony adres został usunięty z tabeli odpowiedników źródła.
OT_ERROR_NO_ADDRESS
Rozszerzonego adresu nie ma w tabeli odpowiedników źródła.
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Usunięcie wszystkich krótkich adresów z tabeli źródłowej.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Usuwam krótki adres do tabeli odpowiedników źródła.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aShortAddress
Krótki adres do usunięcia.
Zwracane wartości
OT_ERROR_NONE
Krótki adres został usunięty z źródłowej tabeli odpowiedników.
OT_ERROR_NO_ADDRESS
Krótki adres nie znajduje się w tabeli odpowiedników źródła.
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Włącz/wyłącz dopasowanie źródła dla ramki oczekuje na sprawdzenie.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aEnable
Włącz/wyłącz dopasowanie źródła dla ramki oczekującej.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda,
OT_ERROR_INVALID_STATE
Jeśli nieprzetworzona warstwa linków jest wyłączona.

OTLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Ta metoda rozpoczyna sekwencję transmisji w radiu.

Przed przesłaniem prośby rozmówca musi utworzyć ramkę IEEE 802.15.4 w buforze dostarczonym przez otLinkRawGetTransmitBuffer(). Kanał i moc transmisji są również uwzględnione w strukturze otRadioFrame.

Sekwencja przesyłania składa się z:

  1. Zmieniam radio w Odebranie.
  2. Pozwala przesyłać dyrektywę PSDU dla danego kanału i informacji o mocy transmisji.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aCallback
Wskaźnik do funkcji nazywanej po zakończeniu przesyłania.
Zwracane wartości
OT_ERROR_NONE
Przeniesiono do Transmitowania.
OT_ERROR_INVALID_STATE
Radio nie było w stanie odbierania.

Zasoby

Tematy referencyjne interfejsu API OpenThread pochodzą z kodu źródłowego i są dostępne w GitHub. Więcej informacji oraz dodatkowe informacje znajdziesz w materiałach.