Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Link

Questo modulo include funzioni che controllano la configurazione del livello di collegamento.

Sommario

Enumerazioni

otMacFilterAddressMode {
OT_MAC_FILTER_ADDRESS_MODE_DISABLED ,
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST ,
OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
}		 enum
Definisce la modalità indirizzo del filtro mac.

Typedef

otActiveScanResult typedef
Questa struttura rappresenta un Beacon IEEE 802.15.4 ricevuto.
otEnergyScanResult typedef
Questa struttura rappresenta un risultato della scansione energetica.
otHandleActiveScanResult )(otActiveScanResult *aResult, void *aContext) typedef
void(*
Questo puntatore a funzione viene chiamato durante una scansione attiva IEEE 802.15.4 quando viene ricevuto un beacon IEEE 802.15.4 o la scansione viene completata.
otHandleEnergyScanResult )(otEnergyScanResult *aResult, void *aContext) typedef
void(*
Questo puntatore alla funzione viene richiamato durante una scansione energetica IEEE 802.15.4 quando il risultato per un canale è pronto o la scansione viene completata.
otLinkPcapCallback )(const otRadioFrame *aFrame, bool aIsTx, void *aContext) typedef
void(*
Questo puntatore a funzione viene chiamato quando viene ricevuto un frame IEEE 802.15.4.
otMacCounters typedef
Questa struttura rappresenta i contatori del livello MAC.
otMacFilterAddressMode typedef
Definisce la modalità indirizzo del filtro mac.
otMacFilterEntry typedef
Questa struttura rappresenta una voce del filtro Mac.
otMacFilterIterator typedef
uint8_t
Utilizzato per scorrere le voci del filtro Mac.
otThreadLinkInfo typedef
Questa struttura rappresenta le informazioni specifiche del collegamento per i messaggi ricevuti dalla radio Thread.

Funzioni

otLinkActiveScan ( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
Questa funzione avvia una scansione attiva IEEE 802.15.4.
otLinkConvertLinkQualityToRss ( otInstance *aInstance, uint8_t aLinkQuality)
int8_t
Questo metodo converte la qualità del collegamento nella tipica potenza del segnale ricevuto.
otLinkConvertRssToLinkQuality ( otInstance *aInstance, int8_t aRss)
uint8_t
Questo metodo converte la potenza del segnale ricevuto in qualità di collegamento.
otLinkCslGetChannel ( otInstance *aInstance)
uint8_t
Questa funzione ottiene il canale CSL.
otLinkCslGetPeriod ( otInstance *aInstance)
uint16_t
Questa funzione ottiene il periodo CSL.
otLinkCslGetTimeout ( otInstance *aInstance)
uint32_t
Questa funzione ottiene il timeout CSL.
otLinkCslSetChannel ( otInstance *aInstance, uint8_t aChannel)
Questa funzione imposta il canale CSL.
otLinkCslSetPeriod ( otInstance *aInstance, uint16_t aPeriod)
Questa funzione imposta il periodo CSL.
otLinkCslSetTimeout ( otInstance *aInstance, uint32_t aTimeout)
Questa funzione imposta il timeout CSL.
otLinkEnergyScan ( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
Questa funzione avvia una scansione energetica IEEE 802.15.4.
otLinkFilterAddAddress ( otInstance *aInstance, const otExtAddress *aExtAddress)
Questo metodo aggiunge un indirizzo esteso al filtro MAC.
otLinkFilterAddRssIn ( otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
Questo metodo aggiunge una voce di potenza del segnale ricevuto fissa (in dBm) per i messaggi da un determinato indirizzo esteso nel filtro MAC.
otLinkFilterClearAddresses ( otInstance *aInstance)
void
Questo metodo cancella tutti gli indirizzi estesi dal filtro MAC.
otLinkFilterClearAllRssIn ( otInstance *aInstance)
void
Questo metodo cancella tutte le voci di potenza del segnale ricevuto (incluso l'ingresso RSS predefinito) sul filtro MAC.
otLinkFilterClearDefaultRssIn ( otInstance *aInstance)
void
Questo metodo cancella qualsiasi potenza del segnale ricevuto predefinito precedentemente impostato (in dBm) sul filtro MAC.
otLinkFilterGetAddressMode ( otInstance *aInstance)
Questa funzione ottiene la modalità indirizzo del filtro MAC.
otLinkFilterGetNextAddress ( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Questo metodo ottiene una voce di filtro degli indirizzi in uso.
otLinkFilterGetNextRssIn ( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Questo metodo ottiene una voce di filtro RssIn in uso.
otLinkFilterRemoveAddress ( otInstance *aInstance, const otExtAddress *aExtAddress)
void
Questo metodo rimuove un indirizzo esteso dal filtro MAC.
otLinkFilterRemoveRssIn ( otInstance *aInstance, const otExtAddress *aExtAddress)
void
Questo metodo rimuove una voce di filtro MAC per l'impostazione dell'intensità del segnale ricevuto fisso per un determinato indirizzo esteso.
otLinkFilterSetAddressMode ( otInstance *aInstance, otMacFilterAddressMode aMode)
void
Questa funzione imposta la modalità indirizzo del filtro MAC.
otLinkFilterSetDefaultRssIn ( otInstance *aInstance, int8_t aRss)
void
Questo metodo imposta la potenza del segnale ricevuto predefinito (in dBm) sul filtro MAC.
otLinkGetCcaFailureRate ( otInstance *aInstance)
uint16_t
Questa funzione restituisce l'attuale tasso di errore CCA (Clear Channel Assessment).
otLinkGetChannel ( otInstance *aInstance)
uint8_t
Ottieni il canale IEEE 802.15.4.
otLinkGetCounters ( otInstance *aInstance)
const otMacCounters *
Ottieni i contatori del livello MAC.
otLinkGetExtendedAddress ( otInstance *aInstance)
const otExtAddress *
Ottieni l'indirizzo esteso IEEE 802.15.4.
otLinkGetFactoryAssignedIeeeEui64 ( otInstance *aInstance, otExtAddress *aEui64)
void
Ottieni l'IEEE EUI-64 assegnato in fabbrica.
otLinkGetMaxFrameRetriesDirect ( otInstance *aInstance)
uint8_t
Questo metodo restituisce il numero massimo di tentativi di frame durante la trasmissione diretta.
otLinkGetMaxFrameRetriesIndirect ( otInstance *aInstance)
uint8_t
Questo metodo restituisce il numero massimo di tentativi di frame durante la trasmissione indiretta.
otLinkGetPanId ( otInstance *aInstance)
Ottieni l'ID PAN IEEE 802.15.4.
otLinkGetPollPeriod ( otInstance *aInstance)
uint32_t
Ottieni il periodo di polling dei dati del dispositivo finale assonnato.
otLinkGetShortAddress ( otInstance *aInstance)
Ottieni l'indirizzo breve IEEE 802.15.4.
otLinkGetSupportedChannelMask ( otInstance *aInstance)
uint32_t
Ottieni la maschera del canale supportata del livello MAC.
otLinkGetTxDirectRetrySuccessHistogram ( otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Questo metodo ottiene l'istogramma dei tentativi per un singolo pacchetto diretto fino al successo.
otLinkGetTxIndirectRetrySuccessHistogram ( otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Questo metodo ottiene l'istogramma dei tentativi per un singolo pacchetto indiretto fino al successo.
otLinkIsActiveScanInProgress ( otInstance *aInstance)
bool
Questa funzione indica se è attualmente in corso una scansione attiva IEEE 802.15.4.
otLinkIsEnabled ( otInstance *aInstance)
bool
Questa funzione indica se il livello di collegamento è abilitato o meno.
otLinkIsEnergyScanInProgress ( otInstance *aInstance)
bool
Questa funzione indica se è attualmente in corso una scansione energetica IEEE 802.15.4.
otLinkIsInTransmitState ( otInstance *aInstance)
bool
Questa funzione indica se un MAC IEEE 802.15.4 è in stato di trasmissione.
otLinkIsPromiscuous ( otInstance *aInstance)
bool
Questa funzione indica se la modalità promiscua è abilitata o meno a livello di collegamento.
otLinkOutOfBandTransmitRequest ( otInstance *aInstance, otRadioFrame *aOobFrame)
Questa funzione accoda un frame IEEE 802.15.4 fuori banda per la trasmissione.
otLinkResetCounters ( otInstance *aInstance)
void
Reimposta i contatori del livello MAC.
otLinkResetTxRetrySuccessHistogram ( otInstance *aInstance)
void
Questo metodo cancella le statistiche degli istogrammi per le trasmissioni dirette e indirette.
otLinkSendDataRequest ( otInstance *aInstance)
Questa funzione accoda un messaggio di richiesta dati IEEE 802.15.4 per la trasmissione.
otLinkSendEmptyData ( otInstance *aInstance)
Questa funzione indica al dispositivo di inviare un frame di dati IEEE 802.15.4 vuoto.
otLinkSetChannel ( otInstance *aInstance, uint8_t aChannel)
Imposta il canale IEEE 802.15.4.
otLinkSetEnabled ( otInstance *aInstance, bool aEnable)
Questa funzione abilita o disabilita il livello di collegamento.
otLinkSetExtendedAddress ( otInstance *aInstance, const otExtAddress *aExtAddress)
Questa funzione imposta l'indirizzo esteso IEEE 802.15.4.
otLinkSetMaxFrameRetriesDirect ( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
Questo metodo imposta il numero massimo di tentativi di frame durante la trasmissione diretta.
otLinkSetMaxFrameRetriesIndirect ( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
Questo metodo imposta il numero massimo di tentativi di frame durante la trasmissione indiretta.
otLinkSetPanId ( otInstance *aInstance, otPanId aPanId)
Impostare l'ID PAN IEEE 802.15.4.
otLinkSetPcapCallback ( otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
Questa funzione registra un callback per fornire frame IEEE 802.15.4 non elaborati ricevuti.
otLinkSetPollPeriod ( otInstance *aInstance, uint32_t aPollPeriod)
Imposta / cancella il periodo di polling dati esterno / specificato dall'utente per il dispositivo finale assonnato.
otLinkSetPromiscuous ( otInstance *aInstance, bool aPromiscuous)
Questa funzione abilita o disabilita la modalità promiscua del livello di collegamento.
otLinkSetSupportedChannelMask ( otInstance *aInstance, uint32_t aChannelMask)
Imposta la maschera del canale supportata del livello MAC.

Structs

otActiveScanResult

Questa struttura rappresenta un Beacon IEEE 802.15.4 ricevuto.

otEnergyScanResult

Questa struttura rappresenta un risultato della scansione energetica.

otMacCounters

Questa struttura rappresenta i contatori del livello MAC.

otMacFilterEntry

Questa struttura rappresenta una voce del filtro Mac.

otThreadLinkInfo

Questa struttura rappresenta le informazioni specifiche del collegamento per i messaggi ricevuti dalla radio Thread.

Enumerazioni

otMacFilterAddressMode

 otMacFilterAddressMode

Definisce la modalità indirizzo del filtro mac.

Proprietà
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

La modalità di filtro degli indirizzi della lista consentita è abilitata

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

La modalità di filtro degli indirizzi denylist è abilitata.

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

Il filtro degli indirizzi è disabilitato.

Typedef

otActiveScanResult

struct otActiveScanResult otActiveScanResult

Questa struttura rappresenta un Beacon IEEE 802.15.4 ricevuto.

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

Questa struttura rappresenta un risultato della scansione energetica.

otHandleActiveScanResult

void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)

Questo puntatore a funzione viene chiamato durante una scansione attiva IEEE 802.15.4 quando viene ricevuto un beacon IEEE 802.15.4 o la scansione viene completata.

Dettagli
Parametri
[in] aResult
Un puntatore valido alle informazioni sul beacon o NULL al termine della scansione attiva.
[in] aContext
Un puntatore al contesto specifico dell'applicazione.

otHandleEnergyScanResult

void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)

Questo puntatore a funzione viene richiamato durante una scansione energetica IEEE 802.15.4 quando il risultato per un canale è pronto o la scansione viene completata.

Dettagli
Parametri
[in] aResult
Un puntatore valido alle informazioni sui risultati della scansione energetica o NULL al termine della scansione energetica.
[in] aContext
Un puntatore al contesto specifico dell'applicazione.

otLinkPcapCallback

void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

Questo puntatore a funzione viene chiamato quando viene ricevuto un frame IEEE 802.15.4.

Dettagli
Parametri
[in] aFrame
Un puntatore al frame IEEE 802.15.4 ricevuto.
[in] aIsTx
Indica se questo frame viene trasmesso, non ricevuto.
[in] aContext
Un puntatore al contesto specifico dell'applicazione.

otMacCounters

struct otMacCounters otMacCounters

Questa struttura rappresenta i contatori del livello MAC.

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

Definisce la modalità indirizzo del filtro mac.

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

Questa struttura rappresenta una voce del filtro Mac.

otMacFilterIterator

uint8_t otMacFilterIterator

Utilizzato per scorrere le voci del filtro Mac.

otThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

Questa struttura rappresenta le informazioni specifiche del collegamento per i messaggi ricevuti dalla radio Thread.

Funzioni

otLinkActiveScan

otError otLinkActiveScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

Questa funzione avvia una scansione attiva IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aScanChannels
Un vettore di bit che indica quali canali scansionare (es. OT_CHANNEL_11_MASK).
[in] aScanDuration
Il tempo in millisecondi da dedicare alla scansione di ogni canale.
[in] aCallback
Viene completato un puntatore a una funzione chiamata alla ricezione di un beacon o di una scansione.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Ha accettato la richiesta di scansione attiva.
OT_ERROR_BUSY
Sto già eseguendo una scansione attiva.

otLinkConvertLinkQualityToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

Questo metodo converte la qualità del collegamento nella tipica potenza del segnale ricevuto.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aLinkQuality
Il valore LinkQuality dovrebbe essere compreso nell'intervallo [0,3].
ritorna
La tipica piattaforma ha ricevuto la mappatura aLinkQuality segnale su aLinkQuality .

otLinkConvertRssToLinkQuality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

Questo metodo converte la potenza del segnale ricevuto in qualità di collegamento.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aRss
Il valore dell'intensità del segnale ricevuto da convertire.
ritorna
Collega la mappatura del valore della qualità ad aRss .

otLinkCslGetChannel

uint8_t otLinkCslGetChannel(
  otInstance *aInstance
)

Questa funzione ottiene il canale CSL.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il canale CSL.

otLinkCslGetPeriod

uint16_t otLinkCslGetPeriod(
  otInstance *aInstance
)

Questa funzione ottiene il periodo CSL.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il periodo CSL in unità di 10 simboli.

otLinkCslGetTimeout

uint32_t otLinkCslGetTimeout(
  otInstance *aInstance
)

Questa funzione ottiene il timeout CSL.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il timeout CSL in secondi.

otLinkCslSetChannel

otError otLinkCslSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Questa funzione imposta il canale CSL.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aChannel
Il canale di esempio CSL. Il valore del canale deve essere 0 (Imposta canale CSL non specificato) o compreso nell'intervallo [1, 10] (se supportato a 915 MHz) e 11, 26 .
Valori restituiti
OT_ERROR_NONE
Impostare correttamente i parametri CSL.
OT_ERROR_INVALID_ARGS
aChannel non valido.

otLinkCslSetPeriod

otError otLinkCslSetPeriod(
  otInstance *aInstance,
  uint16_t aPeriod
)

Questa funzione imposta il periodo CSL.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aPeriod
Il periodo CSL in unità di 10 simboli.
Valori restituiti
OT_ERROR_NONE
Imposta correttamente il periodo CSL.
OT_ERROR_INVALID_ARGS
Periodo CSL non valido.

otLinkCslSetTimeout

otError otLinkCslSetTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

Questa funzione imposta il timeout CSL.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aTimeout
Il timeout CSL in secondi.
Valori restituiti
OT_ERROR_NONE
Impostare correttamente il timeout CSL.
OT_ERROR_INVALID_ARGS
Timeout CSL non valido.

otLinkEnergyScan

otError otLinkEnergyScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleEnergyScanResult aCallback,
  void *aCallbackContext
)

Questa funzione avvia una scansione energetica IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aScanChannels
Un vettore di bit che indica su quali canali eseguire la scansione energetica.
[in] aScanDuration
Il tempo in millisecondi da dedicare alla scansione di ogni canale.
[in] aCallback
Un puntatore a una funzione chiamata per trasmettere il risultato della scansione indica il completamento della scansione.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Accettata la richiesta di Energy Scan.
OT_ERROR_BUSY
Impossibile avviare la scansione energetica.

otLinkFilterAddAddress

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

Questo metodo aggiunge un indirizzo esteso al filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso (NON DEVE essere NULLO).
Valori restituiti
OT_ERROR_NONE
Aggiunto con successo aExtAddress al filtro MAC.
OT_ERROR_NO_BUFS
Nessuna voce disponibile esiste.

otLinkFilterAddRssIn

otError otLinkFilterAddRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  int8_t aRss
)

Questo metodo aggiunge una voce di intensità del segnale ricevuto fissa (in dBm) per i messaggi da un determinato indirizzo esteso nel filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso IEEE 802.15.4. NON DEVE essere NULL.
[in] aRss
Una potenza del segnale ricevuto (in dBm).
Valori restituiti
OT_ERROR_NONE
Aggiunta di una voce per aExtAddress e aRss .
OT_ERROR_NO_BUFS
Nessuna voce disponibile esiste.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

Questo metodo cancella tutti gli indirizzi estesi dal filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

Questo metodo cancella tutte le voci di potenza del segnale ricevute (incluso l'ingresso RSS predefinito) sul filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

Questo metodo cancella qualsiasi potenza del segnale ricevuto predefinito precedentemente impostato (in dBm) sul filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

Questa funzione ottiene la modalità indirizzo del filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
la modalità indirizzo.

otLinkFilterGetNextAddress

otError otLinkFilterGetNextAddress(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Questo metodo ottiene una voce di filtro degli indirizzi in uso.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in,out] aIterator
Un puntatore al contesto dell'iteratore del filtro MAC. Per ottenere la prima voce del filtro degli indirizzi in uso, deve essere impostata su OT_MAC_FILTER_ITERATOR_INIT. NON DEVE essere NULL.
[out] aEntry
Un puntatore a dove si trovano le informazioni. NON DEVE essere NULL.
Valori restituiti
OT_ERROR_NONE
Recupero di una voce di filtro dell'indirizzo in uso riuscito.
OT_ERROR_NOT_FOUND
Non esiste alcuna voce successiva.

otLinkFilterGetNextRssIn

otError otLinkFilterGetNextRssIn(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

Questo metodo ottiene una voce di filtro RssIn in uso.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in,out] aIterator
Un puntatore al contesto dell'iteratore del filtro MAC. NON DEVE essere NULL. Per ottenere la prima voce, deve essere impostata su OT_MAC_FILTER_ITERATOR_INIT.
[out] aEntry
Un puntatore a dove si trovano le informazioni. L'ultima voce avrebbe l'indirizzo esteso come tutti 0xff per indicare l'intensità del segnale ricevuto predefinito se fosse stato impostato. aEntry NON DEVE essere NULL.
Valori restituiti
OT_ERROR_NONE
Recupero della voce successiva riuscito.
OT_ERROR_NOT_FOUND
Non esiste alcuna voce successiva.

otLinkFilterRemoveAddress

void otLinkFilterRemoveAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Questo metodo rimuove un indirizzo esteso dal filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Nessuna azione viene eseguita se non è presente alcuna voce in Filtro che corrisponde all'indirizzo esteso specificato.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso (NON DEVE essere NULLO).

otLinkFilterRemoveRssIn

void otLinkFilterRemoveRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Questo metodo rimuove una voce di filtro MAC per l'impostazione dell'intensità del segnale ricevuto fisso per un determinato indirizzo esteso.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Nessuna azione viene eseguita se non è presente alcuna voce in Filtro che corrisponde all'indirizzo esteso specificato.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso IEEE 802.15.4. NON DEVE essere NULL.

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

Questa funzione imposta la modalità indirizzo del filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aMode
La modalità indirizzo da impostare.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

Questo metodo imposta la potenza del segnale ricevuto predefinita (in dBm) sul filtro MAC.

Questa funzione è disponibile quando la configurazione OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Il valore RSS predefinito viene utilizzato per tutti i frame ricevuti da indirizzi per i quali non esiste una voce RSS-IN esplicita nell'elenco dei filtri (aggiunto utilizzando otLinkFilterAddRssIn() ).

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aRss
La potenza predefinita del segnale ricevuto (in dBm) da impostare.

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

Questa funzione restituisce l'attuale tasso di errore CCA (Clear Channel Assessment).

La velocità viene mantenuta su una finestra di (circa) ultime trasmissioni di frame OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW .

Dettagli
ritorna
Il tasso di errore CCA con valore massimo 0xffff corrispondente al tasso di errore del 100%.

otLinkGetChannel

uint8_t otLinkGetChannel(
  otInstance *aInstance
)

Ottieni il canale IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il canale IEEE 802.15.4.
Guarda anche:
otLinkSetChannel

otLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

Ottieni i contatori del livello MAC.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Un puntatore ai contatori del livello MAC.

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

Ottieni l'indirizzo esteso IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Un puntatore all'indirizzo esteso IEEE 802.15.4.

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

Ottieni l'IEEE EUI-64 assegnato in fabbrica.

Dettagli
Parametri
[in] aInstance
Un puntatore all'istanza di OpenThread.
[out] aEui64
Un puntatore a dove si trova l'IEEE EUI-64 assegnato in fabbrica.

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

Questo metodo restituisce il numero massimo di tentativi di frame durante la trasmissione diretta.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il numero massimo di tentativi durante la trasmissione diretta.

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

Questo metodo restituisce il numero massimo di tentativi di frame durante la trasmissione indiretta.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il numero massimo di tentativi durante la trasmissione indiretta.

otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

Ottieni l'ID PAN IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
L'ID PAN IEEE 802.15.4.
Guarda anche:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

Ottieni il periodo di polling dei dati del dispositivo finale assonnato.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Il periodo di polling dei dati del dispositivo finale inattivo in millisecondi.
Guarda anche:
otLinkSetPollPeriod

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

Ottieni l'indirizzo breve IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
Un puntatore all'indirizzo breve IEEE 802.15.4.

otLinkGetSupportedChannelMask

uint32_t otLinkGetSupportedChannelMask(
  otInstance *aInstance
)

Ottieni la maschera del canale supportata del livello MAC.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
La maschera di canale supportata come uint32_t con il bit 0 (lsb) mappato al canale 0, il bit 1 al canale 1 e così via.

otLinkGetTxDirectRetrySuccessHistogram

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Questo metodo ottiene l'istogramma dei tentativi per un singolo pacchetto diretto fino al successo.

Questa funzione è valida quando la configurazione OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[out] aNumberOfEntries
Un puntatore a dove si trova la dimensione della matrice di istogrammi restituita.
ritorna
Un puntatore all'istogramma dei tentativi (in una forma di matrice). L'elemento n-esimo indica che il pacchetto è stato inviato con l'n-esimo tentativo.

otLinkGetTxIndirectRetrySuccessHistogram

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

Questo metodo ottiene l'istogramma dei tentativi per un singolo pacchetto indiretto fino al successo.

Questa funzione è valida quando la configurazione OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[out] aNumberOfEntries
Un puntatore a dove si trova la dimensione della matrice di istogrammi restituita.
ritorna
Un puntatore all'istogramma dei tentativi (in una forma di matrice). L'elemento n-esimo indica che il pacchetto è stato inviato con l'n-esimo tentativo.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

Questa funzione indica se è attualmente in corso una scansione attiva IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
true se è in corso una scansione attiva IEEE 802.15.4, altrimenti false.

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

Questa funzione indica se il livello di collegamento è abilitato o meno.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
Valori restituiti
true
Il livello di collegamento è abilitato.
false
Il livello di collegamento non è abilitato.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

Questa funzione indica se è attualmente in corso una scansione energetica IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
true se è in corso una scansione energetica IEEE 802.15.4, altrimenti false.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

Questa funzione indica se un MAC IEEE 802.15.4 è in stato di trasmissione.

Il modulo MAC è nello stato di trasmissione durante la procedura CSMA / CA, la trasmissione di frame CCA, Data, Beacon o Data Request e riceve un ACK di un frame trasmesso. Il modulo MAC non è nello stato di trasmissione durante la trasmissione di un frame ACK o di un frame di richiesta beacon.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
ritorna
true se un MAC IEEE 802.15.4 è nello stato di trasmissione, altrimenti false.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

Questa funzione indica se la modalità promiscua è abilitata o meno a livello di collegamento.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
Valori restituiti
true
La modalità promiscua è abilitata.
false
La modalità promiscua non è abilitata.

otLinkOutOfBandTransmitRequest

otError otLinkOutOfBandTransmitRequest(
  otInstance *aInstance,
  otRadioFrame *aOobFrame
)

Questa funzione accoda un frame IEEE 802.15.4 fuori banda per la trasmissione.

Un frame Out of Band è uno che è stato generato al di fuori di OpenThread.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aOobFrame
Un puntatore al frame da trasmettere.
Valori restituiti
OT_ERROR_NONE
Programmata con successo la trasmissione del frame.
OT_ERROR_ALREADY
Il livello MAC è impegnato a inviare un frame richiesto in precedenza.
OT_ERROR_INVALID_STATE
Il livello MAC non è abilitato.
OT_ERROR_INVALID_ARGS
L'argomento aOobFrame è NULL.

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

Reimposta i contatori del livello MAC.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

Questo metodo cancella le statistiche degli istogrammi per le trasmissioni dirette e indirette.

Questa funzione è valida quando la configurazione OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

Questa funzione accoda un messaggio di richiesta dati IEEE 802.15.4 per la trasmissione.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
Valori restituiti
OT_ERROR_NONE
Accodamento riuscito di un messaggio di richiesta dati IEEE 802.15.4.
OT_ERROR_ALREADY
Un messaggio di richiesta dati IEEE 802.15.4 è già accodato.
OT_ERROR_INVALID_STATE
Il dispositivo non è in modalità rx-off-when-idle.
OT_ERROR_NO_BUFS
Buffer messaggi insufficienti disponibili.

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

Questa funzione indica al dispositivo di inviare un frame di dati IEEE 802.15.4 vuoto.

Questa funzione è supportata solo su un dispositivo Rx-Off-When-Idle per inviare un frame di dati vuoto al suo genitore. Nota: disponibile solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è abilitato.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
Valori restituiti
OT_ERROR_NONE
Accodato con successo un messaggio vuoto.
OT_ERROR_INVALID_STATE
Il dispositivo non è in modalità Rx-Off-When-Idle.
OT_ERROR_NO_BUFS
Buffer messaggi insufficienti disponibili.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Imposta il canale IEEE 802.15.4.

Questa funzione riesce solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione invalida i set di dati operativi attivi e in sospeso nella memoria non volatile.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aChannel
Il canale IEEE 802.15.4.
Valori restituiti
OT_ERROR_NONE
Impostare correttamente il canale.
OT_ERROR_INVALID_ARGS
Se un aChannel non è nell'intervallo [11, 26] o non è nella maschera del canale supportata.
OT_ERROR_INVALID_STATE
I protocolli dei thread sono abilitati.
Guarda anche:
otLinkGetChannel

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Questa funzione abilita o disabilita il livello di collegamento.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aEnable
true per abilitare il livello di collegamento o false in caso contrario.
Valori restituiti
OT_ERROR_NONE
Abilitato / disabilitato con successo il livello di collegamento.
OT_ERROR_INVALID_STATE
Impossibile disabilitare il livello di collegamento perché l'interfaccia Thread è abilitata.

otLinkSetExtendedAddress

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

Questa funzione imposta l'indirizzo esteso IEEE 802.15.4.

Questa funzione riesce solo quando i protocolli Thread sono disabilitati.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso IEEE 802.15.4.
Valori restituiti
OT_ERROR_NONE
Impostare correttamente l'indirizzo esteso IEEE 802.15.4.
OT_ERROR_INVALID_ARGS
aExtAddress era NULL.
OT_ERROR_INVALID_STATE
I protocolli dei thread sono abilitati.

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

Questo metodo imposta il numero massimo di tentativi di frame durante la trasmissione diretta.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aMaxFrameRetriesDirect
Il numero massimo di tentativi durante la trasmissione diretta.

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

Questo metodo imposta il numero massimo di tentativi di frame durante la trasmissione indiretta.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aMaxFrameRetriesIndirect
Il numero massimo di tentativi durante la trasmissione indiretta.

otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

Impostare l'ID PAN IEEE 802.15.4.

Questa funzione riesce solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione invalida anche i set di dati operativi attivi e in sospeso nella memoria non volatile.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aPanId
L'ID PAN IEEE 802.15.4.
Valori restituiti
OT_ERROR_NONE
Impostare correttamente il PAN ID.
OT_ERROR_INVALID_ARGS
Se aPanId non è compreso nell'intervallo [0, 65534].
OT_ERROR_INVALID_STATE
I protocolli dei thread sono abilitati.
Guarda anche:
otLinkGetPanId

otLinkSetPcapCallback

void otLinkSetPcapCallback(
  otInstance *aInstance,
  otLinkPcapCallback aPcapCallback,
  void *aCallbackContext
)

Questa funzione registra un callback per fornire frame IEEE 802.15.4 non elaborati ricevuti.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aPcapCallback
Puntatore a una funzione chiamata quando si riceve un frame di collegamento IEEE 802.15.4 o NULL per disabilitare il callback.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

Imposta / cancella il periodo di polling dei dati esterno / specificato dall'utente per il dispositivo finale assonnato.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aPollPeriod
periodo di polling dei dati in millisecondi.
Valori restituiti
OT_ERROR_NONE
Periodo di polling specificato dall'utente impostato / cancellato correttamente.
OT_ERROR_INVALID_ARGS
Se aPollPeriod non è valido.
Guarda anche:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

Questa funzione abilita o disabilita la modalità promiscua del livello di collegamento.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aPromiscuous
true per abilitare la modalità promiscua o false in caso contrario.
Valori restituiti
OT_ERROR_NONE
Modalità promiscua abilitata con successo.
OT_ERROR_INVALID_STATE
Impossibile abilitare la modalità promiscua perché l'interfaccia Thread è abilitata.

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Imposta la maschera del canale supportata del livello MAC.

Questa funzione riesce solo quando i protocolli Thread sono disabilitati.

Dettagli
Parametri
[in] aInstance
Puntatore a un'istanza di OpenThread.
[in] aChannelMask
La maschera del canale supportata (bit 0 o mappatura lsb sul canale 0 e così via).
Valori restituiti
OT_ERROR_NONE
Imposta correttamente la maschera del canale supportata.
OT_ERROR_INVALID_STATE
I protocolli dei thread sono abilitati.

Macro

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

Utilizzato per indicare che non è stata impostata l'intensità del segnale ricevuto fisso.

OT_MAC_FILTER_ITERATOR_INIT

 OT_MAC_FILTER_ITERATOR_INIT 0

Inizializzatore per otMacFilterIterator.

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS 160

I microsecondi per 10 simboli.