Link

Questo modulo include funzioni che controllano la configurazione del livello link.

Riepilogo

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.

Defdef
otActiveScanResult tipodef
Questa struttura rappresenta un beacon IEEE 802.15.4 ricevuto.
otEnergyScanResult tipodef
Questa struttura rappresenta un risultato di scansione energetica.
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext) tipodef
void(*
Questo puntatore 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) tipodef
void(*
Questo puntatore funzione viene chiamato 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) tipodef
void(*
Questo puntatore funzione viene chiamato quando si riceve un frame IEEE 802.15.4.
otMacCounters tipodef
struct otMacCounters
Questa struttura rappresenta i contatori livello MAC.
otMacFilterAddressMode tipodef
Definisce la modalità indirizzo del filtro Mac.
otMacFilterEntry tipodef
Questa struttura rappresenta una voce del filtro Mac.
otMacFilterIterator tipodef
uint8_t
Utilizzato per eseguire l'iterazione attraverso le voci del filtro MAC.
otThreadLinkInfo tipodef
Questa struttura rappresenta le informazioni specifiche dei link per i messaggi ricevuti dalla radio Thread.

Functions
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 link nella potenza del segnale ricevuta.
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
uint8_t
Questo metodo converte l'intensità del segnale ricevuta in una qualità dei link.
otLinkCslGetChannel(otInstance *aInstance)
uint8_t
Questa funzione recupera il canale CSL.
otLinkCslGetPeriod(otInstance *aInstance)
uint16_t
Questa funzione riceve il periodo CSL.
otLinkCslGetTimeout(otInstance *aInstance)
uint32_t
Questa funzione riceve 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 fissa del segnale ricevuto (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 intensità del segnale ricevute (incluso il RSS-in predefinito) nel filtro MAC.
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
Questo metodo cancella qualsiasi intensità del segnale ricevuta (in dBm) predefinita impostata in precedenza sul filtro MAC.
otLinkFilterGetAddressMode(otInstance *aInstance)
Questa funzione recupera la modalità indirizzo del filtro MAC.
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Questo metodo riceve un filtro per l'indirizzo in uso.
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Questo metodo riceve 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 filtro MAC per l'impostazione di intensità del segnale ricevuta fissa 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 ricevuta (in dBm) predefinita 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 MAC.
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
Ottieni l'Indirizzo esteso IEEE 802.15.4
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
Ricevi lo IEEE EUI-64 assegnato in fabbrica.
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
Questo metodo restituisce il numero massimo di nuovi tentativi per il frame durante la trasmissione diretta.
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
Questo metodo restituisce il numero massimo di nuovi tentativi durante la trasmissione indiretta.
otLinkGetPanId(otInstance *aInstance)
Ottieni l'ID PAN per IEEE 802.15.4.
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
Recupera il periodo di sondaggio sui dati del dispositivo finale addormentato.
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 riceve un istogramma di nuovi tentativi per un singolo pacchetto diretto fino alla riuscita.
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
Questo metodo riceve un istogramma di nuovi tentativi per un singolo pacchetto indiretto fino al completamento dell'operazione.
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 link è abilitato.
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
Questa funzione indica se una scansione energetica IEEE 802.15.4 è attualmente in corso.
otLinkIsInTransmitState(otInstance *aInstance)
bool
Questa funzione indica se un MAC IEEE 802.15.4 è o meno in stato di trasmissione.
otLinkIsPromiscuous(otInstance *aInstance)
bool
Questa funzione indica se la modalità promiscua è abilitata o meno al livello del link.
otLinkIsRadioFilterEnabled(otInstance *aInstance)
bool
Questa funzione indica se il filtro radio IEEE 802.15.4 è abilitato o meno.
otLinkResetCounters(otInstance *aInstance)
void
Reimposta i contatori livello MAC.
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
void
Questo metodo cancella le statistiche dell'istogramma per le trasmissioni dirette e indirette.
otLinkSendDataRequest(otInstance *aInstance)
Questa funzione accoda un messaggio di richiesta di dati IEEE 802.15.4.
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 attiva o disattiva il livello link.
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 nuovi tentativi durante la trasmissione diretta.
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
Questo metodo imposta il numero massimo di nuovi tentativi di frame durante la trasmissione indiretta.
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
Imposta l'ID PAN per IEEE 802.15.4.
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
Questa funzione registra un callback per fornire i frame IEEE 802.15.4 ricevuti.
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
Imposta/cancella un periodo di sondaggio sui dati specificato dall'utente/esterno per il dispositivo finale inattivo.
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
Questa funzione attiva o disattiva la modalità promiscua del livello link.
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
void
Questa funzione abilita/disattiva la modalità filtro radio IEEE 802.15.4.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
Imposta la maschera del canale supportata per il livello MAC.

Strutture
otActiveScanResult

Questa struttura rappresenta un beacon IEEE 802.15.4 ricevuto.

otEnergyScanResult

Questa struttura rappresenta un risultato di scansione energetica.

otMacCounters

Questa struttura rappresenta i contatori livello MAC.

otMacFilterEntry

Questa struttura rappresenta una voce del filtro Mac.

otThreadLinkInfo

Questa struttura rappresenta le informazioni specifiche dei link per i messaggi ricevuti dalla radio Thread.

Enumerazioni

Ot MacFilterAddressMode

 otMacFilterAddressMode

Definisce la modalità indirizzo del filtro Mac.

Proprietà
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

La modalità filtro degli indirizzi della lista consentita è attivata.

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

La modalità filtro degli indirizzi della lista bloccata è attivata.

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

Il filtro degli indirizzi è disabilitato.

Defdef

Risultato ActiveScan

struct otActiveScanResult otActiveScanResult

Questa struttura rappresenta un beacon IEEE 802.15.4 ricevuto.

OtEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

Questa struttura rappresenta un risultato di scansione energetica.

Risultato dell'analisi otHandleActive

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

Questo puntatore 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 sulle informazioni beacon o sul NULL al termine della scansione attiva.
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.

otHandleEnergyScanResult

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

Questo puntatore funzione viene chiamato 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 al NULL al termine della scansione.
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.

OtLinkPcapCallback

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

Questo puntatore funzione viene chiamato quando si riceve un frame IEEE 802.15.4.

Dettagli
Parametri
[in] aFrame
Un puntatore sul frame IEEE 802.15.4 ricevuto.
[in] aIsTx
Indica se il frame viene trasmesso o meno.
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.

oMac

struct otMacCounters otMacCounters

Questa struttura rappresenta i contatori livello MAC.

Ot MacFilterAddressMode

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 eseguire l'iterazione attraverso le voci del filtro MAC.

Informazioni otThreadLink

struct otThreadLinkInfo otThreadLinkInfo

Questa struttura rappresenta le informazioni specifiche dei link per i messaggi ricevuti dalla radio Thread.

Functions

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
Un puntatore su un'istanza di OpenThread.
[in] aScanChannels
Un bit Vettore che indica quali canali cercare (ad es. OT_CHANNEL_11_MASK).
[in] aScanDuration
Il tempo in millisecondi impiegato per analizzare ogni canale.
[in] aCallback
Il suggerimento di una funzione chiamata alla ricezione di un beacon o di una scansione viene completato.
[in] aCallbackContext
Un puntatore sul contesto specifico dell'applicazione.
Valori di ritorno
OT_ERROR_NONE
Richiesta di scansione attiva accettata.
OT_ERROR_BUSY
È già in corso una scansione attiva.

otLinkConvertLinkQualitàToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

Questo metodo converte la qualità del link nella potenza del segnale ricevuta.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aLinkQuality
Il valore in qualità dei link deve essere compreso nell'intervallo [0,3].
Restituisce
La piattaforma standard ha ricevuto la mappatura dell'intensità del segnale a aLinkQuality.

otLinkConvertRssToLinkQualità

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

Questo metodo converte l'intensità del segnale ricevuta in una qualità dei link.

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

otLinkCslGetChannel

uint8_t otLinkCslGetChannel(
  otInstance *aInstance
)

Questa funzione recupera il canale CSL.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il canale CSL.

otLinkCslGetPeriod

uint16_t otLinkCslGetPeriod(
  otInstance *aInstance
)

Questa funzione riceve il periodo CSL.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il periodo di CSL in unità di 10 simboli.

otLinkCslGetTimeout

uint32_t otLinkCslGetTimeout(
  otInstance *aInstance
)

Questa funzione riceve il timeout CSL.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il timeout del CSL in secondi.

otLinkCslSetChannel

otError otLinkCslSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Questa funzione imposta il canale CSL.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aChannel
Il canale di esempio CSL. Il valore del canale deve essere 0 (imposta il canale CSL non specificato) o compreso nell'intervallo [1, 10] (se supportato da 915 MHz) e 11, 26.
Valori di ritorno
OT_ERROR_NONE
Impostazione dei parametri CSL riuscita.
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
Un puntatore su un'istanza di OpenThread.
[in] aPeriod
Il periodo di CSL in unità di 10 simboli.
Valori di ritorno
OT_ERROR_NONE
Impostazione del periodo CSL riuscita.
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
Un puntatore su un'istanza di OpenThread.
[in] aTimeout
Il timeout del CSL in secondi.
Valori di ritorno
OT_ERROR_NONE
Timeout CSL riuscito.
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
Un puntatore su un'istanza di OpenThread.
[in] aScanChannels
Un piccolo vettore che indica su quali canali eseguire la scansione energetica.
[in] aScanDuration
Il tempo in millisecondi impiegato per analizzare ogni canale.
[in] aCallback
Un puntatore a una funzione chiamata per ignorare il risultato della scansione su indica il completamento della scansione.
[in] aCallbackContext
Un puntatore sul contesto specifico dell'applicazione.
Valori di ritorno
OT_ERROR_NONE
Richiesta Energia accettata.
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 di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso (NON DEVE essere NULL).
Valori di ritorno
OT_ERROR_NONE
Aggiunta di aExtAddress al filtro MAC riuscita.
OT_ERROR_NO_BUFS
Nessuna voce disponibile.

otLinkFilterAddRssIn

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

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

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aExtAddress
Un suggerimento dell'indirizzo esteso IEEE 802.15.4. NON DEVE essere NULL.
[in] aRss
Intensità del segnale ricevuta (in dBm).
Valori di ritorno
OT_ERROR_NONE
Una voce per aExtAddress e aRss è stata aggiunta.
OT_ERROR_NO_BUFS
Nessuna voce disponibile.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

Questo metodo cancella tutti gli indirizzi estesi dal filtro MAC.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.

OtLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

Questo metodo cancella tutte le voci di intensità del segnale ricevute (incluso il RSS-in predefinito) nel filtro MAC.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

Questo metodo cancella qualsiasi intensità del segnale ricevuta (in dBm) predefinita impostata in precedenza sul filtro MAC.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

Questa funzione recupera la modalità indirizzo del filtro MAC.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
la modalità indirizzo.

otLinkFilterGetNextAddress

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

Questo metodo riceve un filtro per l'indirizzo in uso.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in,out] aIterator
Un puntatore al contesto dell'iteratore del filtro MAC. Per ottenere la prima voce del filtro di indirizzo in uso, deve essere impostata su OT_MAC_FILTER_ITERATOR_INIT. NON DEVE essere NULL.
[out] aEntry
Un puntatore relativo alla posizione in cui vengono inserite le informazioni. NON DEVE essere NULL.
Valori di ritorno
OT_ERROR_NONE
Recupero di una voce del filtro dell'indirizzo in corso riuscito.
OT_ERROR_NOT_FOUND
Non esiste alcuna voce successiva.

otLinkFilterGetNextRssIn

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

Questo metodo riceve una voce di filtro RssIn in uso.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su 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, è necessario impostare su OT_MAC_FILTER_ITERATOR_INIT.
[out] aEntry
Un puntatore relativo alla posizione in cui vengono inserite le informazioni. L'ultima voce avrebbe l'indirizzo esteso come tutto 0xff per indicare l'intensità del segnale ricevuta predefinita se era stata impostata. aEntry NON DEVE essere NULL.
Valori di ritorno
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 di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Se non è presente alcuna voce nel filtro corrispondente all'indirizzo esteso specificato, non viene eseguita alcuna azione.

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

otLinkFilterRemoveRssIn

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

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

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Se non è presente alcuna voce nel filtro corrispondente all'indirizzo esteso specificato, non viene eseguita alcuna azione.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aExtAddress
Un suggerimento dell'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 di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aMode
La modalità di indirizzo da impostare.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

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

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aRss
L'intensità 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 (circa) ultime OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW trasmissioni di frame.

Dettagli
Restituisce
La percentuale di errori 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
Un puntatore su un'istanza di OpenThread.
Restituisce
Il canale IEEE 802.15.4
Vedi anche:
otLinkSetChannel

OtLinkGetCounter

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

Ottieni i contatori MAC.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Un puntatore sui contatori MAC.

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

Ottieni l'Indirizzo esteso IEEE 802.15.4

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Un suggerimento dell'indirizzo esteso IEEE 802.15.4.

otLinkGetFactoryAssegnaIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

Ricevi lo IEEE EUI-64 assegnato in fabbrica.

Dettagli
Parametri
[in] aInstance
Un puntatore sull'istanza di OpenThread.
[out] aEui64
Un puntatore nel punto in cui è posizionato lo IEEE EUI-64 assegnato alla fabbrica.

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il numero massimo di nuovi tentativi durante la trasmissione diretta.

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il numero massimo di nuovi tentativi durante la trasmissione indiretta.

ID otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

Ottieni l'ID PAN per IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
ID PAN IEEE 802.15.4.
Vedi anche:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

Recupera il periodo di sondaggio sui dati del dispositivo finale addormentato.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il periodo di polling dei dati del dispositivo finale assonnato in millisecondi.
Vedi anche:
otLinkSetPollPeriod

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

Ottieni l'indirizzo breve IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Un puntatore allo 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
Un puntatore su un'istanza di OpenThread.
Restituisce
La maschera del canale supportata come uint32_t con mappatura del bit 0 (lsb) al canale 0, dal bit 1 al canale 1 e così via.

otLinkGetTxDirectTrySuccessHistogram

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

Questo metodo riceve un istogramma di nuovi tentativi per un singolo pacchetto diretto fino alla riuscita.

Questa funzione è valida quando è abilitata la configurazione OPENthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[out] aNumberOfEntries
Un puntatore che indica dove si trovano le dimensioni dell'array di istogrammi restituiti.
Restituisce
Un puntatore sull'istogramma dei nuovi tentativi (in un array). L'elemento n-th indica che il pacchetto è stato inviato con n-th Nuovo tentativo.

otLinkGetTxIndirectTrySuccessHistogram

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

Questo metodo riceve un istogramma di nuovi tentativi per un singolo pacchetto indiretto fino al completamento dell'operazione.

Questa funzione è valida quando è abilitata la configurazione OPENthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[out] aNumberOfEntries
Un puntatore che indica dove si trovano le dimensioni dell'array di istogrammi restituiti.
Restituisce
Un puntatore sull'istogramma dei nuovi tentativi (in un array). L'elemento n-th indica che il pacchetto è stato inviato con n-th Nuovo tentativo.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
true se è in corso una scansione attiva IEEE 802.15.4, false in caso contrario.

OtLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

Questa funzione indica se il livello link è abilitato.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Valori di ritorno
true
Livello link abilitato.
false
Livello link non abilitato.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
true se è in corso una scansione energetica IEEE 802.15.4, altrimenti su false.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

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

Il modulo MAC è in stato di trasmissione durante la procedura CSMA/CA, la trasmissione CCA, dei dati, di beacon o della richiesta di dati e la ricezione di un ACK di un frame trasmesso. Il modulo MAC non è in stato di trasmissione durante la trasmissione di un frame ACK o di un frame di richiesta beacon.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
true se un MAC IEEE 802.15.4 è in stato di trasmissione, false negli altri casi.

OtLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

Questa funzione indica se la modalità promiscua è abilitata o meno al livello del link.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Valori di ritorno
true
La modalità promiscua è attiva.
false
La modalità promiscua non è attiva.

otLinkIsRadioFilterEnabled

bool otLinkIsRadioFilterEnabled(
  otInstance *aInstance
)

Questa funzione indica se il filtro radio IEEE 802.15.4 è abilitato o meno.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Dettagli
Valori di ritorno
TRUE
Se il filtro radio è attivo.
FALSE
Se il filtro radio è disattivato.

OtLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

Reimposta i contatori livello MAC.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.

otLinkReimpostaTxTrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

Questo metodo cancella le statistiche dell'istogramma per le trasmissioni dirette e indirette.

Questa funzione è valida quando è abilitata la configurazione OPENthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

Questa funzione accoda un messaggio di richiesta di dati IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Valori di ritorno
OT_ERROR_NONE
È stato accodato correttamente un messaggio di richiesta di dati IEEE 802.15.4.
OT_ERROR_INVALID_STATE
Il dispositivo non è in modalità rx-off-when-idle.
OT_ERROR_NO_BUFS
Buffer di messaggio insufficienti.

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 all'elemento padre. Nota: disponibile solo quando è abilitato OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Valori di ritorno
OT_ERROR_NONE
Hai accodato correttamente un messaggio vuoto.
OT_ERROR_INVALID_STATE
Il dispositivo non è in modalità Rx-Off-Quando è inattivo.
OT_ERROR_NO_BUFS
Buffer di messaggio insufficienti.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Imposta il canale IEEE 802.15.4.

Questa funzione ha esito positivo solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione invalida i set di dati operativi attivi e in attesa in memoria non volatile.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aChannel
Il canale IEEE 802.15.4
Valori di ritorno
OT_ERROR_NONE
Impostazione del canale riuscita.
OT_ERROR_INVALID_ARGS
Se aChannel non è compreso nell'intervallo [11, 26] o non è nella maschera del canale supportata.
OT_ERROR_INVALID_STATE
I protocolli Thread sono abilitati.
Vedi anche:
otLinkGetChannel

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Questa funzione attiva o disattiva il livello link.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aEnable
true per abilitare il livello link o false in caso contrario.
Valori di ritorno
OT_ERROR_NONE
Attivazione / disattivazione del livello link.
OT_ERROR_INVALID_STATE
Impossibile disabilitare il livello di link perché l'interfaccia di Thread è abilitata.

Indirizzo OtLinkSetExtended

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

Questa funzione imposta l'indirizzo esteso IEEE 802.15.4.

Questa funzione ha esito positivo solo quando i protocolli Thread sono disabilitati.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aExtAddress
Un suggerimento dell'indirizzo esteso IEEE 802.15.4.
Valori di ritorno
OT_ERROR_NONE
Impostazione dell'indirizzo esteso IEEE 802.15.4 riuscita.
OT_ERROR_INVALID_ARGS
aExtAddress era NULL.
OT_ERROR_INVALID_STATE
I protocolli Thread sono abilitati.

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aMaxFrameRetriesDirect
Il numero massimo di nuovi tentativi durante la trasmissione diretta.

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aMaxFrameRetriesIndirect
Il numero massimo di nuovi tentativi durante la trasmissione indiretta.

ID otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

Imposta l'ID PAN per IEEE 802.15.4.

Questa funzione ha esito positivo solo quando i protocolli Thread sono disabilitati. Una chiamata a questa funzione riuscita annulla anche i set di dati operativi attivi e in attesa in memoria non volatile.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aPanId
ID PAN IEEE 802.15.4.
Valori di ritorno
OT_ERROR_NONE
ID PAN impostato correttamente.
OT_ERROR_INVALID_ARGS
Se aPanId non è compreso nell'intervallo [0, 65534].
OT_ERROR_INVALID_STATE
I protocolli Thread sono abilitati.
Vedi anche:
otLinkGetPanId

otLinkSetPcapCallback

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

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

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

OtLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

Imposta/cancella un periodo di sondaggio sui dati specificato dall'utente/esterno per il dispositivo finale inattivo.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aPollPeriod
il periodo di un sondaggio di dati in millisecondi.
Valori di ritorno
OT_ERROR_NONE
Periodo del sondaggio specificato dall'utente impostato/cancellato correttamente.
OT_ERROR_INVALID_ARGS
Se aPollPeriod non è valido.
Vedi anche:
otLinkGetPollPeriod

OtLinkSetPromiscuo

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

Questa funzione attiva o disattiva la modalità promiscua del livello link.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aPromiscuous
true per abilitare la modalità promiscua o false in caso contrario.
Valori di ritorno
OT_ERROR_NONE
Attivazione della modalità promiscua riuscita.
OT_ERROR_INVALID_STATE
Impossibile abilitare la modalità profonda perché l'interfaccia Thread è attivata.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

Questa funzione abilita/disattiva la modalità filtro radio IEEE 802.15.4.

Questa funzione è disponibile quando la configurazione di OPENthread_CONFIG_MAC_FILTER_ENABLE è attivata.

Il filtro radio è destinato principalmente ai test. Può essere utilizzato temporaneamente per bloccare tutti i tx/rx sulla radio 802.15.4. Quando il filtro radio è attivato, la radio viene impostata sulla modalità di sospensione anziché su quella di ricezione (per assicurarsi che il dispositivo non riceva frame e/o possa inviare ACK). Inoltre, le richieste di trasmissione del frame vengono restituite immediatamente senza inviare il frame over-the-air (restituzione "nessun errore" se viene richiesto l'errore, in caso contrario il reso viene completato).

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aFilterEnabled
TRUE per abilitare il filtro radio, FALSE per disattivarle

OtLinkSetSupportedMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Imposta la maschera del canale supportata per il livello MAC.

Questa funzione ha esito positivo solo quando i protocolli Thread sono disabilitati.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aChannelMask
La maschera del canale supportata (mappatura di bit 0 o lsb a canale 0 e così via).
Valori di ritorno
OT_ERROR_NONE
Impostazione della maschera del canale supportata riuscita.
OT_ERROR_INVALID_STATE
I protocolli Thread sono abilitati.

Macro

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

Indica che non è stata impostata alcuna intensità del segnale ricevuta.

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.

Risorse

Gli argomenti di riferimento per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per ulteriori informazioni o per contribuire alla nostra documentazione, consulta la sezione Risorse.