Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Collega

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.

Defin
otActiveScanResult Typedef
Questa struttura rappresenta un beacon IEEE 802.15.4 ricevuto.
otEnergyScanResult Typedef
Questa struttura rappresenta un risultato di scansione energetica.
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext) Typedef
void(*
Questo puntatore di funzione viene chiamato durante una scansione attiva di IEEE 802.15.4 quando viene ricevuto un beacon di IEEE 802.15.4 o viene completata la scansione.
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext) Typedef
void(*
Questo puntatore di funzione viene richiamato durante un'analisi energetica IEEE 802.15.4 quando il risultato di un canale è pronto o la scansione è completata.
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext) Typedef
void(*
Questo puntatore di funzione viene chiamato alla ricezione di un frame IEEE 802.15.4.
otMacCounters Typedef
struct otMacCounters
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 eseguire l'iterazione tramite voci di filtro Mac.
otThreadLinkInfo Typedef
Questa struttura rappresenta informazioni specifiche per i link ricevute 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 all'intensità del segnale ricevuta.
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
uint8_t
Questo metodo converte l'intensità del segnale ricevuta in qualità di 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)
Imposta il canale CSL.
otLinkCslSetPeriod(otInstance *aInstance, uint16_t aPeriod)
Imposta il periodo CSL in unità di 10 simboli.
otLinkCslSetTimeout(otInstance *aInstance, uint32_t aTimeout)
Imposta il timeout CSL in secondi.
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 (in dBm) per i messaggi provenienti da un determinato indirizzo esteso nel filtro MAC.
otLinkFilterClearAddresses(otInstance *aInstance)
void
Questo metodo cancella tutti i filtri da indirizzi estesi di MAC.
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
Questo metodo cancella tutte le voci di potenza del segnale ricevute (incluso quello RSS-in predefinito) su MAC Filter.
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
Questo metodo cancella l'intensità del segnale ricevuto (in dBm) predefinita impostata in precedenza sul filtro MAC.
otLinkFilterGetAddressMode(otInstance *aInstance)
Questa funzione ottiene la modalità indirizzo del filtro MAC.
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
Questo metodo riceve una voce di filtro 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 del filtro MAC per l'impostazione dell'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 l'intensità del segnale ricevuta predefinita (in dBm) sul filtro MAC.
otLinkGetCcaFailureRate(otInstance *aInstance)
uint16_t
Questa funzione restituisce il tasso di errore CCA (Clear Channel Assessment) corrente.
otLinkGetChannel(otInstance *aInstance)
uint8_t
Ottieni il canale IEEE 802.15.4.
otLinkGetCounters(otInstance *aInstance)
const otMacCounters *
Recupera i contatori del livello MAC.
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
Recupera l'indirizzo esteso IEEE 802.15.4.
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
Ottieni lo standard IEEE EUI-64 assegnato in fabbrica.
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
Questo metodo restituisce il numero massimo di nuovi tentativi durante la trasmissione diretta.
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
Questo metodo restituisce il numero massimo di nuovi tentativi di frame durante la trasmissione indiretta.
otLinkGetPanId(otInstance *aInstance)
Ottieni l'ID PAN di IEEE 802.15.4.
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
Ricevi il periodo del sondaggio dati sul 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 riceve un istogramma di nuovi tentativi per un singolo pacchetto diretto fino al completamento dell'operazione.
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 o meno.
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
Questa funzione indica se è in corso una scansione energetica IEEE 802.15.4.
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 di 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 del livello MAC.
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
void
Questo metodo cancella le statistiche sull'istogramma per le trasmissioni dirette e indirette.
otLinkSendDataRequest(otInstance *aInstance)
Questa funzione accoda un messaggio di richiesta di 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 attiva o disattiva il livello link.
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
Imposta l'indirizzo esteso IEEE 802.15.4.
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
Questo metodo imposta il numero massimo di nuovi tentativi di frame 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 di 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 periodo di sondaggio esterno specificato dall'utente/per 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/disabilita la modalità filtro radio IEEE 802.15.4.
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
Imposta la maschera del canale supportata del livello MAC.

Struttura
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 del livello MAC.

OtMacFilterEntry

Questa struttura rappresenta una voce del filtro Mac.

otThreadLinkInfo

Questa struttura rappresenta informazioni specifiche per i link ricevute 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 è attivata.

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

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

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

Il filtro degli indirizzi è disattivato.

Defin

otActiveScanResult

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.

otHandleActiveScanResult

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

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

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

otHandleEnergyScanResult

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

Questo puntatore di funzione viene richiamato durante un'analisi energetica IEEE 802.15.4 quando il risultato di un canale è pronto o la scansione è completata.

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

OtLinkPcapCallback

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

Questo puntatore di funzione viene chiamato alla ricezione di un frame IEEE 802.15.4.

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

OtMacContatori

struct otMacCounters otMacCounters

Questa struttura rappresenta i contatori del livello MAC.

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

Definisce la modalità indirizzo del filtro mac.

Ingresso filtro oMac

struct otMacFilterEntry otMacFilterEntry

Questa struttura rappresenta una voce del filtro Mac.

otMacFilterIterator

uint8_t otMacFilterIterator

Utilizzato per eseguire l'iterazione tramite voci di filtro Mac.

OtThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

Questa struttura rappresenta informazioni specifiche per i link ricevute 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 a un'istanza OpenThread.
[in] aScanChannels
Un bit vettoriale che indica quali canali cercare (ad es. OT_CHANNEL_11_MASK).
[in] aScanDuration
Il tempo espresso in millisecondi impiegato per analizzare ogni canale.
[in] aCallback
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
Richiesta di scansione attiva accettata.
OT_ERROR_BUSY
Scansione già in corso.

otLinkConvertLinkQualitàToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

Questo metodo converte la qualità del link all'intensità del segnale ricevuta.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aLinkQuality
Il valore della qualità del link deve essere compreso nell'intervallo [0,3].
Restituisce
La piattaforma tipica ha ricevuto una 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 qualità di link.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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 a un'istanza OpenThread.
Restituisce
Il canale CSL.

otLinkCslGetPeriod

uint16_t otLinkCslGetPeriod(
  otInstance *aInstance
)

Questa funzione riceve il periodo CSL.

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

otLinkCslGetTimeout

uint32_t otLinkCslGetTimeout(
  otInstance *aInstance
)

Questa funzione riceve il timeout CSL.

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

OtLinkCslSetChannel

otError otLinkCslSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

Imposta il canale CSL.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aChannel
Il canale di esempio CSL. Il valore del canale deve essere 0 (canale CSL non specificato) oppure compreso nell'intervallo [1, 10] (se supportato da 915 MHz) e 11, 26.
Valori restituiti
OT_ERROR_NONE
Impostazione dei parametri CSL riuscita.
OT_ERROR_INVALID_ARGS
aChannel non valido.

OtLinkCslSetPeriod

otError otLinkCslSetPeriod(
  otInstance *aInstance,
  uint16_t aPeriod
)

Imposta il periodo CSL in unità di 10 simboli.

Disattiva i criteri CSL impostando questo parametro su 0.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aPeriod
Il periodo CSL in unità di 10 simboli.
Valori restituiti
OT_ERROR_NONE
Il periodo CSL è stato impostato correttamente.
OT_ERROR_INVALID_ARGS
Periodo CSL non valido.

otLinkCslSetTimeout

otError otLinkCslSetTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

Imposta il timeout CSL in secondi.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aTimeout
Il timeout di CSL in secondi.
Valori restituiti
OT_ERROR_NONE
Timeout CSL impostato.
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 a un'istanza OpenThread.
[in] aScanChannels
Un piccolo vettore che indica su quali canali eseguire la scansione energetica.
[in] aScanDuration
Il tempo espresso in millisecondi impiegato per analizzare ogni canale.
[in] aCallback
Un puntatore a una funzione chiamata per passare al risultato della scansione indica che la scansione è stata completata.
[in] aCallbackContext
Un puntatore al contesto specifico dell'applicazione.
Valori restituiti
OT_ERROR_NONE
Ha accettato la richiesta di scansione dell'energia.
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
Un puntatore a un'istanza OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso (NON DEVE essere NULL).
Valori restituiti
OT_ERROR_NONE
aExtAddress aggiunto al filtro MAC.
OT_ERROR_NO_BUFS
Nessuna voce disponibile.

otLinkFilterAddRssIn

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

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

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso IEEE 802.15.4. NON DEVE essere NULL.
[in] aRss
Intensità del segnale ricevuta (in dBm).
Valori restituiti
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 i filtri da indirizzi estesi di MAC.

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

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

otLinkFilterCancellaAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

Questo metodo cancella tutte le voci di potenza del segnale ricevute (incluso quello RSS-in predefinito) su MAC Filter.

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

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

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

Questo metodo cancella l'intensità del segnale ricevuto (in dBm) predefinita impostata in precedenza sul filtro MAC.

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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
Un puntatore a un'istanza OpenThread.
Restituisce
la modalità indirizzo.

otLinkFilterGetNextAddress

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

Questo metodo riceve una voce di filtro indirizzo in uso.

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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 che indica dove vengono posizionate le informazioni. NON DEVE essere NULL.
Valori restituiti
OT_ERROR_NONE
Voce di filtro dell'indirizzo in uso recuperata.
OT_ERROR_NOT_FOUND
Non esistono voci successive.

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 OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in,out] aIterator
Un puntatore al contesto dell'iteratore del filtro MAC. NON DEVE essere NULL. Per ricevere la prima voce, è necessario impostarla su OT_MAC_filter_ITERATOR_INIT.
[out] aEntry
Un puntatore che indica dove vengono posizionate le informazioni. L'ultima voce avrebbe l'indirizzo esteso come tutto 0xff per indicare l'intensità del segnale ricevuta predefinita se era impostata. aEntry NON DEVE essere NULL.
Valori restituiti
OT_ERROR_NONE
Voce successiva recuperata.
OT_ERROR_NOT_FOUND
Non esistono voci successive.

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.

Se il filtro non contiene una voce corrispondente all'indirizzo esteso specificato, non viene eseguita alcuna azione.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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 del filtro MAC per l'impostazione dell'intensità del segnale ricevuta fissa per un determinato indirizzo esteso.

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

Se il filtro non contiene una voce corrispondente all'indirizzo esteso specificato, non viene eseguita alcuna azione.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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
Un puntatore a un'istanza OpenThread.
[in] aMode
La modalità dell'indirizzo da impostare.

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

Questo metodo imposta l'intensità del segnale ricevuta 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 Filtro (aggiunto utilizzando otLinkFilterAddRssIn()).

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aRss
Intensità del segnale ricevuta predefinita (in dBm) da impostare.

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

Questa funzione restituisce il tasso di errore CCA (Clear Channel Assessment) corrente.

La frequenza viene mantenuta su una finestra di (circa) ultime OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW trasmissioni del 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 a un'istanza OpenThread.
Restituisce
Il canale IEEE 802.15.4.
Vedi anche:
otLinkSetChannel

OtLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

Recupera i contatori del livello MAC.

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

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

Recupera l'indirizzo esteso IEEE 802.15.4.

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

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

Ottieni lo standard IEEE EUI-64 assegnato in fabbrica.

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

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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 di frame durante la trasmissione indiretta.

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

ID otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

Ottieni l'ID PAN di IEEE 802.15.4.

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

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

Ricevi il periodo del sondaggio dati sul dispositivo finale assonnato.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Restituisce
Il periodo del sondaggio sui dati del dispositivo finale assonnato, espresso in millisecondi.
Vedi anche:
otLinkSetPollPeriod

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

Ottieni l'indirizzo breve IEEE 802.15.4.

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

otLinkGetTxDirectRetrySuccessHistogram

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

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

Questa funzione è valida quando la configurazione OPENThread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.

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

otLinkGetTxIndirectRiprovaSuccessHistogram

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 la configurazione OPENThread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[out] aNumberOfEntries
Un puntatore che indica dove vengono posizionate le dimensioni dell'array di istogrammi restituiti.
Restituisce
Un puntatore all'istogramma dei nuovi tentativi (in forma di 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 a un'istanza 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 o meno.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
true
Il livello link è attivato.
false
Il livello link non è abilitato.

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Restituisce
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 è o meno in stato di trasmissione.

Il modulo MAC è in stato di trasmissione durante la procedura CSMA/CA, la trasmissione CCA, di dati, di beacon o di richiesta di dati e la ricezione di un ACK di frame 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 a un'istanza OpenThread.
Restituisce
true se un MAC IEEE 802.15.4 è in stato di trasmissione, false negli altri casi.

otLinkIsPromiscuo

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
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 OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

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

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

Reimposta i contatori del livello MAC.

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

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

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

Questa funzione è valida quando la configurazione OPENThread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.

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

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

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

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
OT_ERROR_NONE
È stato accodato un messaggio di richiesta dati IEEE 802.15.4.
OT_ERROR_INVALID_STATE
Il dispositivo non è in modalità rx-off-when-idle.
OT_ERROR_NO_BUFS
Buffer dei messaggi 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 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è attivato.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
OT_ERROR_NONE
Un messaggio vuoto è stato accodato.
OT_ERROR_INVALID_STATE
Il dispositivo non è in modalità Rx-Off-when-Idle.
OT_ERROR_NO_BUFS
Buffer dei messaggi 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 nella memoria non volatile.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aChannel
Il canale IEEE 802.15.4.
Valori restituiti
OT_ERROR_NONE
Impostazione del canale riuscita.
OT_ERROR_INVALID_ARGS
Se aChannel non è 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 a un'istanza OpenThread.
[in] aEnable
true per abilitare il livello link o false in caso contrario.
Valori restituiti
OT_ERROR_NONE
Attivazione / disattivazione del livello del link riuscita.
OT_ERROR_INVALID_STATE
Impossibile disattivare il livello link perché l'interfaccia del thread è attivata.

otLinkSetExtendedAddress

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

Imposta l'indirizzo esteso IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aExtAddress
Un puntatore all'indirizzo esteso IEEE 802.15.4.
Valori restituiti
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 di frame durante la trasmissione diretta.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza 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 a un'istanza 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 di IEEE 802.15.4.

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

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aPanId
L'ID PAN di IEEE 802.15.4.
Valori restituiti
OT_ERROR_NONE
ID PAN impostato.
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 a un'istanza OpenThread.
[in] aPcapCallback
Un puntatore a una funzione chiamata quando si riceve un frame di link 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 periodo di sondaggio esterno specificato dall'utente/per dispositivo finale inattivo.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aPollPeriod
il periodo di sondaggi dati in millisecondi.
Valori restituiti
OT_ERROR_NONE
Periodo di sondaggio specificato dall'utente superato/impostato 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 a un'istanza OpenThread.
[in] aPromiscuous
true per attivare la modalità promiscua o false in caso contrario.
Valori restituiti
OT_ERROR_NONE
Modalità promiscua abilitata.
OT_ERROR_INVALID_STATE
Impossibile abilitare la modalità promiscua perché l'interfaccia Thread è attivata.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

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

Questa funzione è disponibile quando la configurazione OPENThread_CONFIG_MAC_filter_ENABLE è abilitata.

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

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

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

Imposta la maschera del canale supportata del livello MAC.

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

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aChannelMask
La maschera del canale supportata (bit 0 o lsb mappatura al canale 0 e così via).
Valori restituiti
OT_ERROR_NONE
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

Utilizzato per indicare che non è stata impostata alcuna intensità di 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 dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per scoprire di più o per contribuire alla nostra documentazione, consulta le Risorse.