Nieprzetworzony link

Ten moduł zawiera funkcje sterujące nieprzetworzoną konfiguracją warstwy linków.

Podsumowanie

Definicje typów
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Wskaźnik po otrzymaniu ramki IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Wskaźnik po otrzymaniu ramki IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Wskaźnik po otrzymaniu ramki IEEE 802.15.4.

Funkcje
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Uruchamia sekwencję skanowania energii w radiu.
otLinkRawGetCaps(otInstance *aInstance)
Korzystaj z funkcji radia.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Pobiera stan trybu nasłuchiwania.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Pobierz bieżący czas platformy (szerokość 64-bitowa) elementu radiowego.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Pobierz najnowsze pomiary RSSI.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
Radio przełączy się z trybu Nadaj na Odbieranie.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Wskazuje, czy nieprzetworzona warstwa linków jest włączona.
otLinkRawReceive(otInstance *aInstance)
Przechodzenie radia ze uśpienia na Odbierz.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Ustawia bieżącą wartość licznika klatek MAC.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
Ustawia bieżącą wartość licznika klatek MAC tylko wtedy, gdy nowa wartość jest większa od bieżącej.
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)
Włącza lub wyłącza tryb nasłuchiwania.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Włącza lub wyłącza warstwę nieprzetworzonych linków.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Ustaw krótki adres na potrzeby filtrowania adresów.
otLinkRawSleep(otInstance *aInstance)
Przełącz radio z funkcji Odbieraj na Uśpienie.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Dodano rozszerzony adres do źródłowej tabeli odpowiedników.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Dodanie krótkiego adresu do źródłowej tabeli odpowiedników.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Usunięcie wszystkich rozszerzonych adresów ze źródłowej tabeli odpowiedników.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Usunięto rozszerzony adres ze źródłowej tabeli odpowiedników radia.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Usunięcie wszystkich krótkich adresów ze źródłowej tabeli odpowiedników.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Usunięcie krótkiego adresu ze źródłowej tabeli odpowiedników.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Włącz/wyłącz dopasowanie źródła dla oczekującej ramki.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Rozpoczyna sekwencję transmisji w radiu.

Definicje typów

otLinkRawEnergyScanDone

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

Wskaźnik po otrzymaniu ramki IEEE 802.15.4.

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

otLinkRawReceiveDone

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

Wskaźnik po otrzymaniu ramki IEEE 802.15.4.

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

otLinkRawTransmitDone

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

Wskaźnik po otrzymaniu ramki IEEE 802.15.4.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aFrame
Wskaźnik przesłanej klatki.
[in] aAckFrame
Wskaźnik do ramki potwierdzenia.
[in] aError
OT_ERROR_NONE po przesłaniu klatki. OT_ERROR_NO_ACK po przesłaniu klatki, ale nie odebrano potwierdzenia potwierdzenia: OT_ERROR_CHANNEL_ACCESS_FAILURE, gdy transmisja nie mogła zostać przeprowadzona z powodu aktywności na kanale. OT_ERROR_ABORT, gdy transmisja została przerwana z innych przyczyn.

Funkcje

otLinkRawEnergyScan

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

Uruchamia 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 trwania skanowania kanału (w milisekundach).
[in] aCallback
Wskaźnik do funkcji wywoływanej po zakończeniu zeskanowanego kanału.
Zwracane wartości
OT_ERROR_NONE
Rozpoczęto skanowanie kanału.
OT_ERROR_BUSY
Radio przeprowadza skanowanie energii.
OT_ERROR_NOT_IMPLEMENTED
Radio nie obsługuje skanowania energii.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Korzystaj z funkcji radia.

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

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Pobiera stan trybu nasłuchiwania.

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

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

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

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Bieżący czas działania radiowego w mikrosekundach.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Pobierz najnowsze pomiary RSSI.

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

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Radio przełączy się z trybu Nadaj na Odbieranie.

Zwraca wskaźnik do bufora transmisji.

Element wywołujący tworzy w tym buforze ramkę IEEE 802.15.4, a następnie wywołuje metodę otLinkRawTransmit(), aby zażądać transmisji.

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

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Wskazuje, czy nieprzetworzona warstwa linków jest włączona.

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

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Przechodzenie radia ze uśpienia na Odbierz.

Włącz radio.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Przełączono na Odbieranie.
OT_ERROR_INVALID_STATE
Radio zostało wyłączone lub transmitowane.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

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

Zawsze ustawia licznik MAC na nową podaną wartość aMacFrameCounter niezależnie od bieżącej wartości.

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 nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Ustawia bieżącą wartość licznika klatek MAC tylko wtedy, gdy nowa wartość jest większa od bieżącej.

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 nie jest włączona warstwa nieprzetworzonych linków.

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
Bieżący klucz MAC.
[in] aNextKey
Następny klucz MAC.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Włącza lub wyłącza tryb nasłuchiwania.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aEnable
Wartość włączająca lub wyłączana tryb nasłuchiwania.
Zwracane wartości
OT_ERROR_NONE
Jeśli się uda.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Włącza lub wyłącza warstwę nieprzetworzonych linków.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aCallback
Wskaźnik do funkcji wywoływanej po otrzymaniu ramki IEEE 802.15.4. Wartość NULL, aby wyłączyć warstwę surowego linku.
Zwracane wartości
OT_ERROR_FAILED
Nie można włączyć lub wyłączyć radia.
OT_ERROR_INVALID_STATE
Jeśli interfejs IPv6 OpenThread jest już włączony.
OT_ERROR_NONE
Udało się ustawić stan włączenia.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Ustaw krótki adres na potrzeby 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 nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Przełącz radio z funkcji Odbieraj na Uśpienie.

Wyłącz radio.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Przełączono w tryb uśpienia.
OT_ERROR_BUSY
Radio transmitowało
OT_ERROR_INVALID_STATE
Radio zostało wyłączone

otLinkRawSrcMatchAddExtEntry

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

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

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aExtAddress
Rozszerzony adres do dodania.
Zwracane wartości
OT_ERROR_NONE
Adres rozszerzony został dodany do źródłowej tabeli odpowiedników.
OT_ERROR_NO_BUFS
Brak dostępnego wpisu w źródłowej tabeli odpowiedników.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Dodanie krótkiego adresu do źródłowej tabeli odpowiedników.

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 źródłowej tabeli odpowiedników.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Usunięcie wszystkich rozszerzonych adresów ze źródłowej tabeli odpowiedników.

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 nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSrcMatchClearExtEntry

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

Usunięto rozszerzony adres ze źródłowej tabeli odpowiedników radia.

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 ze źródłowej tabeli odpowiedników.
OT_ERROR_NO_ADDRESS
Rozszerzonego adresu nie ma w źródłowej tabeli odpowiedników.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

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

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 nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Usunięcie krótkiego adresu ze źródłowej tabeli odpowiedników.

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 ze źródłowej tabeli odpowiedników.
OT_ERROR_NO_ADDRESS
Krótkiego adresu nie ma w źródłowej tabeli odpowiedników.
OT_ERROR_INVALID_STATE
Jeśli nie jest włączona warstwa nieprzetworzonych linków.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Włącz/wyłącz dopasowanie źródła dla oczekującej ramki.

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

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Rozpoczyna sekwencję transmisji w radiu.

Przed wysłaniem żądania transmisji element wywołujący musi utworzyć ramkę IEEE 802.15.4 w buforze udostępnianym przez funkcję otLinkRawGetTransmitBuffer(). Moc kanału i transmisji jest również zawarta w strukturze otRadioFrame.

Sekwencja przesyłania składa się z tych elementów:

  1. Przełączam radio na przesyłanie z odbierania.
  2. Przesyła PSDU na dany kanał i przy danej mocy transmisji.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aCallback
Wskaźnik do funkcji wywoływanej po zakończeniu przesyłania.
Zwracane wartości
OT_ERROR_NONE
Przełączono na tryb Transmitowanie.
OT_ERROR_INVALID_STATE
Radio nie było w stanie odbierania.

Zasoby

Tematy referencyjne interfejsu OpenThread API pochodzą z kodu źródłowego dostępnego w GitHub. Aby dowiedzieć się więcej lub dołączyć do naszej dokumentacji, skorzystaj z sekcji Zasoby.