Link
Questo modulo include funzioni che controllano la configurazione del livello link.
Riepilogo
Enumerazioni |
|
---|---|
otMacFilterAddressMode{
|
enum Definisce la modalità indirizzo del filtro Mac. |
Defdef |
|
---|---|
otActiveScanResult
|
tipodefstruct otActiveScanResult
Questa struttura rappresenta un beacon IEEE 802.15.4 ricevuto. |
otEnergyScanResult
|
tipodefstruct otEnergyScanResult
Questa struttura rappresenta un risultato di scansione energetica. |
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
|
tipodefvoid(*
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)
|
tipodefvoid(*
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)
|
tipodefvoid(*
Questo puntatore funzione viene chiamato quando si riceve un frame IEEE 802.15.4. |
otMacCounters
|
tipodefstruct otMacCounters
Questa struttura rappresenta i contatori livello MAC. |
otMacFilterAddressMode
|
tipodef Definisce la modalità indirizzo del filtro Mac. |
otMacFilterEntry
|
tipodefstruct otMacFilterEntry
Questa struttura rappresenta una voce del filtro Mac. |
otMacFilterIterator
|
tipodefuint8_t
Utilizzato per eseguire l'iterazione attraverso le voci del filtro MAC. |
otThreadLinkInfo
|
tipodefstruct otThreadLinkInfo
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 |
|
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 |
|
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 |
|
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 |
|
||||||||||
Valori di ritorno |
|
otLinkConvertLinkQualitàToRss
int8_t otLinkConvertLinkQualityToRss( otInstance *aInstance, uint8_t aLinkQuality )
Questo metodo converte la qualità del link nella potenza del segnale ricevuta.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
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 |
|
||||
Restituisce |
Collega la mappatura del valore della qualità a
aRss . |
otLinkCslGetChannel
uint8_t otLinkCslGetChannel( otInstance *aInstance )
Questa funzione recupera il canale CSL.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il canale CSL.
|
otLinkCslGetPeriod
uint16_t otLinkCslGetPeriod( otInstance *aInstance )
Questa funzione riceve il periodo CSL.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il periodo di CSL in unità di 10 simboli.
|
otLinkCslGetTimeout
uint32_t otLinkCslGetTimeout( otInstance *aInstance )
Questa funzione riceve il timeout CSL.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il timeout del CSL in secondi.
|
otLinkCslSetChannel
otError otLinkCslSetChannel( otInstance *aInstance, uint8_t aChannel )
Questa funzione imposta il canale CSL.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori di ritorno |
|
OtLinkCslSetPeriod
otError otLinkCslSetPeriod( otInstance *aInstance, uint16_t aPeriod )
Questa funzione imposta il periodo CSL.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori di ritorno |
|
otLinkCslSetTimeout
otError otLinkCslSetTimeout( otInstance *aInstance, uint32_t aTimeout )
Questa funzione imposta il timeout CSL.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori di ritorno |
|
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 |
|
||||||||||
Valori di ritorno |
|
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 |
|
||||
Valori di ritorno |
|
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 |
|
||||||
Valori di ritorno |
|
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 |
|
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 |
|
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 |
|
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 |
|
||
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 |
|
||||||
Valori di ritorno |
|
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 |
|
||||||
Valori di ritorno |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
||
Restituisce |
Il canale IEEE 802.15.4
|
otLinkSetChannel
OtLinkGetCounter
const otMacCounters * otLinkGetCounters( otInstance *aInstance )
Ottieni i contatori MAC.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Un puntatore sui contatori MAC.
|
otLinkGetExtendedAddress
const otExtAddress * otLinkGetExtendedAddress( otInstance *aInstance )
Ottieni l'Indirizzo esteso IEEE 802.15.4
Dettagli | |||
---|---|---|---|
Parametri |
|
||
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 |
|
otLinkGetMaxFrameRetriesDirect
uint8_t otLinkGetMaxFrameRetriesDirect( otInstance *aInstance )
Questo metodo restituisce il numero massimo di nuovi tentativi per il frame durante la trasmissione diretta.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
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 |
|
||
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 |
|
||
Restituisce |
ID PAN IEEE 802.15.4.
|
otLinkSetPanId
otLinkGetPollPeriod
uint32_t otLinkGetPollPeriod( otInstance *aInstance )
Recupera il periodo di sondaggio sui dati del dispositivo finale addormentato.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il periodo di polling dei dati del dispositivo finale assonnato in millisecondi.
|
otLinkSetPollPeriod
otLinkGetShortAddress
otShortAddress otLinkGetShortAddress( otInstance *aInstance )
Ottieni l'indirizzo breve IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
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 |
|
||
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 |
|
||||
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 |
|
||||
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 |
|
||
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 |
|
||||
Valori di ritorno |
|
otLinkIsEnergyScanInProgress
bool otLinkIsEnergyScanInProgress( otInstance *aInstance )
Questa funzione indica se una scansione energetica IEEE 802.15.4 è attualmente in corso.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
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 |
|
||
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 |
|
||||
Valori di ritorno |
|
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 |
|
OtLinkResetCounters
void otLinkResetCounters( otInstance *aInstance )
Reimposta i contatori livello MAC.
Dettagli | |||
---|---|---|---|
Parametri |
|
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 |
|
otLinkSendDataRequest
otError otLinkSendDataRequest( otInstance *aInstance )
Questa funzione accoda un messaggio di richiesta di dati IEEE 802.15.4.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori di ritorno |
|
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 |
|
||||||
Valori di ritorno |
|
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 |
|
||||||
Valori di ritorno |
|
otLinkGetChannel
otLinkSetEnabled
otError otLinkSetEnabled( otInstance *aInstance, bool aEnable )
Questa funzione attiva o disattiva il livello link.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori di ritorno |
|
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 |
|
||||||
Valori di ritorno |
|
otLinkSetMaxFrameRetriesDirect
void otLinkSetMaxFrameRetriesDirect( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect )
Questo metodo imposta il numero massimo di nuovi tentativi durante la trasmissione diretta.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
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 |
|
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 |
|
||||||
Valori di ritorno |
|
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 |
|
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 |
|
||||
Valori di ritorno |
|
otLinkGetPollPeriod
OtLinkSetPromiscuo
otError otLinkSetPromiscuous( otInstance *aInstance, bool aPromiscuous )
Questa funzione attiva o disattiva la modalità promiscua del livello link.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori di ritorno |
|
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 |
|
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 |
|
||||
Valori di ritorno |
|
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.