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)	otError Uruchamia sekwencję skanowania energii w radiu.
otLinkRawGetCaps(otInstance *aInstance)	otRadioCaps 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)	otRadioFrame * 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)	otError Przechodzenie radia ze uśpienia na Odbierz.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)	otError Ustawia bieżącą wartość licznika klatek MAC.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)	otError 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)	otError Zaktualizuj klucze MAC i indeks kluczy.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)	otError Włącza lub wyłącza tryb nasłuchiwania.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)	otError Włącza lub wyłącza warstwę nieprzetworzonych linków.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)	otError Ustaw krótki adres na potrzeby filtrowania adresów.
otLinkRawSleep(otInstance *aInstance)	otError Przełącz radio z funkcji Odbieraj na Uśpienie.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)	otError Dodano rozszerzony adres do źródłowej tabeli odpowiedników.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)	otError Dodanie krótkiego adresu do źródłowej tabeli odpowiedników.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)	otError Usunięcie wszystkich rozszerzonych adresów ze źródłowej tabeli odpowiedników.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)	otError Usunięto rozszerzony adres ze źródłowej tabeli odpowiedników radia.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)	otError Usunięcie wszystkich krótkich adresów ze źródłowej tabeli odpowiedników.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)	otError Usunięcie krótkiego adresu ze źródłowej tabeli odpowiedników.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)	otError Włącz/wyłącz dopasowanie źródła dla oczekującej ramki.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)	otError 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.