Collegamento
Questo modulo include funzioni che controllano la configurazione a livello di link.
Riepilogo
Enumerazioni |
|
---|---|
otMacFilterAddressMode{
|
enum Definisce la modalità indirizzo del filtro Mac. |
Typedef |
|
---|---|
otActiveScanResult
|
typedefstruct otActiveScanResult
Rappresenta un beacon IEEE 802.15.4 ricevuto. |
otEnergyScanResult
|
typedefstruct otEnergyScanResult
Rappresenta il risultato della scansione energetica. |
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
|
typedefvoid(*
Il puntatore 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)
|
typedefvoid(*
Il puntatore viene chiamato durante una scansione energetica IEEE 802.15.4 quando il risultato per un canale è pronto o la scansione è terminata. |
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
|
typedefvoid(*
Il puntatore viene chiamato alla ricezione di un frame IEEE 802.15.4. |
otMacCounters
|
typedefstruct otMacCounters
Rappresenta i contatori del livello MAC. |
otMacFilterAddressMode
|
typedef Definisce la modalità indirizzo del filtro Mac. |
otMacFilterEntry
|
typedefstruct otMacFilterEntry
Rappresenta una voce di Filtro Mac. |
otMacFilterIterator
|
typedefuint8_t
Utilizzato per eseguire l'iterazione delle voci del filtro Mac. |
otThreadLinkInfo
|
typedefstruct otThreadLinkInfo
Rappresenta le informazioni specifiche per i messaggi ricevuti dalla radio Thread. |
Funzioni |
|
---|---|
otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
|
Avvia una scansione attiva IEEE 802.15.4.
|
otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)
|
int8_t
Converte la qualità del link in un'intensità tipica del segnale ricevuto.
|
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
|
uint8_t
Converte l'intensità del segnale ricevuto in qualità del link.
|
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
|
Avvia una scansione energetica IEEE 802.15.4.
|
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
|
Aggiunge un indirizzo esteso al filtro MAC.
|
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
|
Aggiunge l'indirizzo esteso specificato all'elenco
RssIn (o modifica un indirizzo esistente nell'elenco RssIn ) e imposta la voce dell'intensità del segnale ricevuto (in dBm) per i messaggi provenienti da quell'indirizzo. |
otLinkFilterClearAddresses(otInstance *aInstance)
|
void
Cancella tutti gli indirizzi estesi dal filtro MAC.
|
otLinkFilterClearAllRssIn(otInstance *aInstance)
|
void
Cancella tutte le voci dell'intensità del segnale ricevuto (
rss ) e dell'indicatore di qualità del link (lqi ) (incluse le impostazioni predefinite) dall'elenco RssIn . |
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
|
void
Cancella l'intensità del segnale ricevuto (in dBm) predefinita in precedenza impostata sul filtro MAC.
|
otLinkFilterGetAddressMode(otInstance *aInstance)
|
Visualizza la modalità degli indirizzi del filtro MAC.
|
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
|
Restituisce una voce di filtro degli indirizzi in uso.
|
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
|
Restituisce una voce di filtro RssIn in uso.
|
otLinkFilterRemoveAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
|
void
Rimuove un indirizzo esteso dal filtro MAC.
|
otLinkFilterRemoveRssIn(otInstance *aInstance, const otExtAddress *aExtAddress)
|
void
Rimuove l'indirizzo esteso specificato dall'elenco
RssIn . |
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
|
void
Imposta la modalità degli indirizzi del filtro MAC.
|
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
|
void
Consente di impostare l'intensità del segnale ricevuto predefinita (in dBm) sul filtro MAC.
|
otLinkGetCcaFailureRate(otInstance *aInstance)
|
uint16_t
Restituisce l'attuale tasso di errore CCA (Clear Channel Assessment).
|
otLinkGetChannel(otInstance *aInstance)
|
uint8_t
Scarica il canale IEEE 802.15.4.
|
otLinkGetCounters(otInstance *aInstance)
|
const otMacCounters *
Ottieni i contatori del livello MAC.
|
otLinkGetCslChannel(otInstance *aInstance)
|
uint8_t
Ottieni il canale CSL.
|
otLinkGetCslPeriod(otInstance *aInstance)
|
uint32_t
Restituisce il periodo CSL in microsecondi.
|
otLinkGetCslTimeout(otInstance *aInstance)
|
uint32_t
Restituisce il timeout CSL.
|
otLinkGetExtendedAddress(otInstance *aInstance)
|
const otExtAddress *
Restituisce l'indirizzo esteso IEEE 802.15.4.
|
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
|
void
Richiedi lo standard IEEE EUI-64 assegnato dal produttore.
|
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
|
uint8_t
Restituisce il numero massimo di nuovi tentativi di frame durante la trasmissione diretta.
|
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
|
uint8_t
Restituisce il numero massimo di nuovi tentativi di frame durante la trasmissione indiretta.
|
otLinkGetPanId(otInstance *aInstance)
|
Procurati l'ID PAN IEEE 802.15.4.
|
otLinkGetPollPeriod(otInstance *aInstance)
|
uint32_t
Ottieni il periodo di sondaggio dei dati del dispositivo finale assonnato.
|
otLinkGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
|
Ottieni il codice regione.
|
otLinkGetShortAddress(otInstance *aInstance)
|
Procurati 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 *
Visualizza l'istogramma dei nuovi tentativi per un singolo pacchetto diretto fino all'esito positivo.
|
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
|
const uint32_t *
Restituisce l'istogramma dei nuovi tentativi per un singolo pacchetto indiretto fino all'esito positivo.
|
otLinkIsActiveScanInProgress(otInstance *aInstance)
|
bool
Indica se è in corso una scansione attiva IEEE 802.15.4.
|
otLinkIsCslEnabled(otInstance *aInstance)
|
bool
Indica se la crittografia lato client è attivata o meno.
|
otLinkIsCslSupported(otInstance *aInstance)
|
bool
Indica se il dispositivo è connesso a un genitore che supporta CSL.
|
otLinkIsEnabled(otInstance *aInstance)
|
bool
Indica se il livello link è abilitato o meno.
|
otLinkIsEnergyScanInProgress(otInstance *aInstance)
|
bool
Indica se è attualmente in corso una scansione energetica IEEE 802.15.4.
|
otLinkIsInTransmitState(otInstance *aInstance)
|
bool
Indica se un MAC IEEE 802.15.4 è in stato di trasmissione.
|
otLinkIsPromiscuous(otInstance *aInstance)
|
bool
Indica se la modalità promiscuo è attivata o meno a livello di link.
|
otLinkIsRadioFilterEnabled(otInstance *aInstance)
|
bool
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
Cancella le statistiche a istogrammi per le trasmissioni dirette e indirette.
|
otLinkSendDataRequest(otInstance *aInstance)
|
Mette in coda un messaggio IEEE 802.15.4 Data Request per la trasmissione.
|
otLinkSendEmptyData(otInstance *aInstance)
|
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.
|
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)
|
Imposta il canale CSL.
|
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)
|
Imposta il periodo CSL in microsecondi.
|
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)
|
Imposta il timeout CSL in secondi.
|
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
|
Attiva o disattiva il livello di collegamento.
|
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
|
Imposta l'indirizzo esteso IEEE 802.15.4.
|
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
|
void
Imposta il numero massimo di nuovi tentativi di frame durante la trasmissione diretta.
|
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
|
void
Imposta il numero massimo di nuovi tentativi frame durante la trasmissione indiretta.
|
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
|
Imposta l'ID PAN IEEE 802.15.4.
|
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
|
void
Registra un callback per fornire i frame IEEE 802.15.4 non elaborati ricevuti.
|
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
|
Imposta/cancella un periodo di sondaggio per i dati esterni o specificati dall'utente per il dispositivo finale assonnato.
|
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
|
Attiva o disattiva la modalità promiscuo del livello dei link.
|
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
|
void
Attiva/disattiva la modalità di filtro radio IEEE 802.15.4.
|
otLinkSetRegion(otInstance *aInstance, uint16_t aRegionCode)
|
Imposta il codice regione.
|
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
|
Imposta la maschera del canale supportata del livello MAC.
|
Strutture |
|
---|---|
otActiveScanResult |
Rappresenta un beacon IEEE 802.15.4 ricevuto. |
otEnergyScanResult |
Rappresenta il risultato della scansione energetica. |
otMacCounters |
Rappresenta i contatori del livello MAC. |
otMacFilterEntry |
Rappresenta una voce di Filtro Mac. |
otThreadLinkInfo |
Rappresenta le informazioni specifiche 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 è attiva. |
OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
|
La modalità di filtro degli indirizzi della lista bloccata è attiva. |
OT_MAC_FILTER_ADDRESS_MODE_DISABLED
|
Il filtro degli indirizzi è disattivato. |
Typedef
otActiveScanResult
struct otActiveScanResult otActiveScanResult
Rappresenta un beacon IEEE 802.15.4 ricevuto.
otEnergyScanResult
struct otEnergyScanResult otEnergyScanResult
Rappresenta il risultato della scansione energetica.
otHandleActiveScanResult
void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
Il puntatore 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)
Il puntatore viene chiamato durante una scansione energetica IEEE 802.15.4 quando il risultato per un canale è pronto o la scansione è terminata.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkPcapCallback
void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
Il puntatore viene chiamato alla ricezione di un frame IEEE 802.15.4.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
otMacFilterAddressMode
enum otMacFilterAddressMode otMacFilterAddressMode
Definisce la modalità indirizzo del filtro Mac.
otMacFilterIterator
uint8_t otMacFilterIterator
Utilizzato per eseguire l'iterazione delle voci del filtro Mac.
otThreadLinkInfo
struct otThreadLinkInfo otThreadLinkInfo
Rappresenta le informazioni specifiche per i messaggi ricevuti dalla radio Thread.
Funzioni
otLinkActiveScan
otError otLinkActiveScan( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext )
Avvia una scansione attiva IEEE 802.15.4.
Dettagli | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||||
Valori restituiti |
|
otLinkConvertLinkQualityToRss
int8_t otLinkConvertLinkQualityToRss( otInstance *aInstance, uint8_t aLinkQuality )
Converte la qualità del link in un'intensità tipica del segnale ricevuto.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Restituisce |
La piattaforma tipica ha ricevuto la mappatura dell'intensità del segnale su
aLinkQuality . |
otLinkConvertRssToLinkQuality
uint8_t otLinkConvertRssToLinkQuality( otInstance *aInstance, int8_t aRss )
Converte l'intensità del segnale ricevuto in qualità del link.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Restituisce |
Collega la mappatura dei valori di qualità a
aRss . |
otLinkEnergyScan
otError otLinkEnergyScan( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext )
Avvia una scansione energetica IEEE 802.15.4.
Dettagli | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||||
Valori restituiti |
|
otLinkFilterAddAddress
otError otLinkFilterAddAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
Aggiunge un indirizzo esteso al filtro MAC.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkFilterAddRssIn
otError otLinkFilterAddRssIn( otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss )
Aggiunge l'indirizzo esteso specificato all'elenco RssIn
(o modifica un indirizzo esistente nell'elenco RssIn
) e imposta la voce dell'intensità del segnale ricevuto (in dBm) per i messaggi provenienti da quell'indirizzo.
L'indirizzo esteso non deve necessariamente essere incluso nel filtro address allowlist/denylist
per impostare rss
.
OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkFilterClearAddresses
void otLinkFilterClearAddresses( otInstance *aInstance )
Cancella tutti gli indirizzi estesi dal filtro MAC.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||
---|---|---|---|
Parametri |
|
otLinkFilterClearAllRssIn
void otLinkFilterClearAllRssIn( otInstance *aInstance )
Cancella tutte le voci dell'intensità del segnale ricevuto (rss
) e dell'indicatore di qualità del link (lqi
) (incluse le impostazioni predefinite) dall'elenco RssIn
.
L'esecuzione di questa azione significa che tutti gli indirizzi estesi utilizzeranno il segnale in onda.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||
---|---|---|---|
Parametri |
|
otLinkFilterClearDefaultRssIn
void otLinkFilterClearDefaultRssIn( otInstance *aInstance )
Cancella l'intensità del segnale ricevuto (in dBm) predefinita in precedenza impostata sul filtro MAC.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||
---|---|---|---|
Parametri |
|
otLinkFilterGetAddressMode
otMacFilterAddressMode otLinkFilterGetAddressMode( otInstance *aInstance )
Visualizza la modalità degli indirizzi del filtro MAC.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
la modalità indirizzo.
|
otLinkFilterGetNextAddress
otError otLinkFilterGetNextAddress( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
Restituisce una voce di filtro degli indirizzi in uso.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkFilterGetNextRssIn
otError otLinkFilterGetNextRssIn( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
Restituisce una voce di filtro RssIn in uso.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkFilterRemoveAddress
void otLinkFilterRemoveAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
Rimuove un indirizzo esteso dal filtro MAC.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Non viene eseguita alcuna azione se nel filtro non esistono voci corrispondenti all'indirizzo esteso specificato.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkFilterRemoveRssIn
void otLinkFilterRemoveRssIn( otInstance *aInstance, const otExtAddress *aExtAddress )
Rimuove l'indirizzo esteso specificato dall'elenco RssIn
.
Una volta rimosso dall'elenco RssIn
, questo indirizzo MAC utilizzerà invece le impostazioni predefinite di rss
e lqi
, se i valori predefiniti sono stati impostati. Se non sono state impostate impostazioni predefinite, viene utilizzato il segnale over-air.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Non viene eseguita alcuna azione se nell'elenco RssIn
non esistono voci corrispondenti all'indirizzo esteso specificato.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkFilterSetAddressMode
void otLinkFilterSetAddressMode( otInstance *aInstance, otMacFilterAddressMode aMode )
Imposta la modalità degli indirizzi del filtro MAC.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkFilterSetDefaultRssIn
void otLinkFilterSetDefaultRssIn( otInstance *aInstance, int8_t aRss )
Consente di impostare l'intensità del segnale ricevuto predefinita (in dBm) sul filtro MAC.
È disponibile quando la configurazione di 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 |
|
otLinkGetCcaFailureRate
uint16_t otLinkGetCcaFailureRate( otInstance *aInstance )
Restituisce l'attuale tasso di errore CCA (Clear Channel Assessment).
La frequenza viene mantenuta per una finestra di (approssimativamente) le ultime OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW
trasmissioni di frame.
Dettagli | |
---|---|
Restituisce |
La percentuale di errori CCA con valore massimo
0xffff corrispondente a un tasso di errore del 100%. |
otLinkGetChannel
uint8_t otLinkGetChannel( otInstance *aInstance )
Scarica il canale IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il canale IEEE 802.15.4.
|
otLinkSetChannel
otLinkGetCounters
const otMacCounters * otLinkGetCounters( otInstance *aInstance )
Ottieni i contatori del livello MAC.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Un puntatore ai contatori del livello MAC.
|
otLinkGetCslChannel
uint8_t otLinkGetCslChannel( otInstance *aInstance )
Ottieni il canale CSL.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il canale CSL.
|
otLinkGetCslPeriod
uint32_t otLinkGetCslPeriod( otInstance *aInstance )
Restituisce il periodo CSL in microsecondi.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il periodo CSL in microsecondi.
|
otLinkGetCslTimeout
uint32_t otLinkGetCslTimeout( otInstance *aInstance )
Restituisce il timeout CSL.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Timeout CSL in secondi.
|
otLinkGetExtendedAddress
const otExtAddress * otLinkGetExtendedAddress( otInstance *aInstance )
Restituisce l'indirizzo esteso IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Un puntatore all'indirizzo esteso IEEE 802.15.4.
|
otLinkGetFactoryAssignedIeeeEui64
void otLinkGetFactoryAssignedIeeeEui64( otInstance *aInstance, otExtAddress *aEui64 )
Richiedi lo standard IEEE EUI-64 assegnato dal produttore.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkGetMaxFrameRetriesDirect
uint8_t otLinkGetMaxFrameRetriesDirect( otInstance *aInstance )
Restituisce il numero massimo di nuovi tentativi di frame durante la trasmissione diretta.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il numero massimo di nuovi tentativi durante la trasmissione diretta.
|
otLinkGetMaxFrameRetriesIndirect
uint8_t otLinkGetMaxFrameRetriesIndirect( otInstance *aInstance )
Restituisce il numero massimo di nuovi tentativi di frame durante la trasmissione indiretta.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il numero massimo di nuovi tentativi durante la trasmissione indiretta.
|
otLinkGetPanId
otPanId otLinkGetPanId( otInstance *aInstance )
Procurati l'ID PAN IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
L'ID PAN IEEE 802.15.4.
|
otLinkSetPanId
otLinkGetPollPeriod
uint32_t otLinkGetPollPeriod( otInstance *aInstance )
Ottieni il periodo di sondaggio dei dati del dispositivo finale assonnato.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
Il periodo di sondaggio dei dati del dispositivo finale assonnato in millisecondi.
|
otLinkSetPollPeriod
otLinkGetRegion
otError otLinkGetRegion( otInstance *aInstance, uint16_t *aRegionCode )
Ottieni il codice regione.
Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.
Dettagli | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parametri |
|
||||||||
Valori restituiti |
|
otLinkGetShortAddress
otShortAddress otLinkGetShortAddress( otInstance *aInstance )
Procurati l'indirizzo breve IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
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 |
|
||
Restituisce |
La maschera del canale supportata come
uint32_t con il bit 0 (lsb) mappato al canale 0, il bit 1 al canale 1 e così via. |
otLinkGetTxDirectRetrySuccessHistogram
const uint32_t * otLinkGetTxDirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
Visualizza l'istogramma dei nuovi tentativi per un singolo pacchetto diretto fino all'esito positivo.
È valido quando la configurazione OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Restituisce |
Un puntatore all'istogramma dei nuovi tentativi (in una forma di array). L'n-esimo elemento indica che il pacchetto è stato inviato con un n-esimo tentativo.
|
otLinkGetTxIndirectRetrySuccessHistogram
const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
Restituisce l'istogramma dei nuovi tentativi per un singolo pacchetto indiretto fino all'esito positivo.
È valido quando la configurazione OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Restituisce |
Un puntatore all'istogramma dei nuovi tentativi (in una forma di array). L'n-esimo elemento indica che il pacchetto è stato inviato con un n-esimo tentativo.
|
otLinkIsActiveScanInProgress
bool otLinkIsActiveScanInProgress( otInstance *aInstance )
Indica se è in corso una scansione attiva IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
true se è in corso una scansione attiva IEEE 802.15.4, altrimenti false.
|
otLinkIsCslEnabled
bool otLinkIsCslEnabled( otInstance *aInstance )
Indica se la crittografia lato client è attivata o meno.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkIsCslSupported
bool otLinkIsCslSupported( otInstance *aInstance )
Indica se il dispositivo è connesso a un genitore che supporta CSL.
Dettagli | |||||
---|---|---|---|---|---|
Valori restituiti |
|
otLinkIsEnabled
bool otLinkIsEnabled( otInstance *aInstance )
Indica se il livello link è abilitato o meno.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkIsEnergyScanInProgress
bool otLinkIsEnergyScanInProgress( otInstance *aInstance )
Indica se è attualmente in corso una scansione energetica IEEE 802.15.4.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
true se è in corso una scansione energetica IEEE 802.15.4, false negli altri casi.
|
otLinkIsInTransmitState
bool otLinkIsInTransmitState( otInstance *aInstance )
Indica se un MAC IEEE 802.15.4 è in stato di trasmissione.
Il modulo MAC è in stato di trasmissione durante la procedura CSMA/CA, la trasmissione del frame CCA, dati, beacon o richiesta 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 di beacon.
Dettagli | |||
---|---|---|---|
Parametri |
|
||
Restituisce |
true se un MAC IEEE 802.15.4 è in stato di trasmissione, altrimenti false.
|
otLinkIsPromiscuous
bool otLinkIsPromiscuous( otInstance *aInstance )
Indica se la modalità promiscuo è attivata o meno a livello di link.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkIsRadioFilterEnabled
bool otLinkIsRadioFilterEnabled( otInstance *aInstance )
Indica se il filtro radio IEEE 802.15.4 è abilitato o meno.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Dettagli | |||||
---|---|---|---|---|---|
Valori restituiti |
|
otLinkResetCounters
void otLinkResetCounters( otInstance *aInstance )
Reimposta i contatori del livello MAC.
Dettagli | |||
---|---|---|---|
Parametri |
|
otLinkResetTxRetrySuccessHistogram
void otLinkResetTxRetrySuccessHistogram( otInstance *aInstance )
Cancella le statistiche a istogrammi per le trasmissioni dirette e indirette.
È valido quando la configurazione OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE è abilitata.
Dettagli | |||
---|---|---|---|
Parametri |
|
otLinkSendDataRequest
otError otLinkSendDataRequest( otInstance *aInstance )
Mette in coda un messaggio IEEE 802.15.4 Data Request per la trasmissione.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkSendEmptyData
otError otLinkSendEmptyData( otInstance *aInstance )
Indica al dispositivo di inviare un frame di dati IEEE 802.15.4 vuoto.
È supportato solo su un dispositivo Rx-Off-When-Idle per inviare un frame di dati vuoto al dispositivo padre. Nota: disponibile solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkSetChannel
otError otLinkSetChannel( otInstance *aInstance, uint8_t aChannel )
Imposta il canale IEEE 802.15.4.
Ha successo solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende non validi i set di dati operativi attivi e in attesa nella memoria non volatile.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkGetChannel
otLinkSetCslChannel
otError otLinkSetCslChannel( otInstance *aInstance, uint8_t aChannel )
Imposta il canale CSL.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkSetCslPeriod
otError otLinkSetCslPeriod( otInstance *aInstance, uint32_t aPeriod )
Imposta il periodo CSL in microsecondi.
Disattiva CSL impostando questo parametro su 0
.
Il periodo CSL DEVE essere un multiplo di OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC
, altrimenti viene restituito OT_ERROR_INVALID_ARGS
.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkSetCslTimeout
otError otLinkSetCslTimeout( otInstance *aInstance, uint32_t aTimeout )
Imposta il timeout CSL in secondi.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkSetEnabled
otError otLinkSetEnabled( otInstance *aInstance, bool aEnable )
Attiva o disattiva il livello di collegamento.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkSetExtendedAddress
otError otLinkSetExtendedAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
Imposta l'indirizzo esteso IEEE 802.15.4.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkSetMaxFrameRetriesDirect
void otLinkSetMaxFrameRetriesDirect( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect )
Imposta il numero massimo di nuovi tentativi di frame durante la trasmissione diretta.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkSetMaxFrameRetriesIndirect
void otLinkSetMaxFrameRetriesIndirect( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect )
Imposta il numero massimo di nuovi tentativi frame durante la trasmissione indiretta.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkSetPanId
otError otLinkSetPanId( otInstance *aInstance, otPanId aPanId )
Imposta l'ID PAN IEEE 802.15.4.
Ha successo solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende non valido anche i set di dati operativi attivi e in attesa nella memoria non volatile.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkGetPanId
otLinkSetPcapCallback
void otLinkSetPcapCallback( otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext )
Registra un callback per fornire i frame IEEE 802.15.4 non elaborati ricevuti.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
otLinkSetPollPeriod
otError otLinkSetPollPeriod( otInstance *aInstance, uint32_t aPollPeriod )
Imposta/cancella un periodo di sondaggio per i dati esterni o specificati dall'utente per il dispositivo finale assonnato.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkGetPollPeriod
otLinkSetPromiscuous
otError otLinkSetPromiscuous( otInstance *aInstance, bool aPromiscuous )
Attiva o disattiva la modalità promiscuo del livello dei link.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
otLinkSetRadioFilterEnabled
void otLinkSetRadioFilterEnabled( otInstance *aInstance, bool aFilterEnabled )
Attiva/disattiva la modalità di filtro radio IEEE 802.15.4.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Il filtro radio è destinato principalmente ai test. Può essere usato per bloccare temporaneamente tutti i tx/rx sulla radio 802.15.4. Quando il filtro della radio è attivato, la radio viene attivata anziché ricevere (per garantire che il dispositivo non riceva frame e/o potenzialmente invii ACK). Inoltre, le richieste di trasmissione del frame ritornano immediatamente senza inviare il frame over-the-air (restituisci l'errore "no ack" se viene richiesto un ACK, altrimenti restituisce l'esito positivo).
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
otLinkSetRegion
otError otLinkSetRegion( otInstance *aInstance, uint16_t aRegionCode )
Imposta il codice regione.
Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.
Dettagli | |||||||
---|---|---|---|---|---|---|---|
Parametri |
|
||||||
Valori restituiti |
|
otLinkSetSupportedChannelMask
otError otLinkSetSupportedChannelMask( otInstance *aInstance, uint32_t aChannelMask )
Imposta la maschera del canale supportata del livello MAC.
Ha successo solo quando i protocolli Thread sono disabilitati.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
||||
Valori restituiti |
|
Macro
OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC
OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC (160)
Rappresenta l'unità di simboli del periodo CSL dieci in microsecondi.
Il periodo CSL (in microsecondi) DEVE essere un multiplo di questo valore.
OT_MAC_FILTER_FIXED_RSS_DISABLED
OT_MAC_FILTER_FIXED_RSS_DISABLED 127
Utilizzato per indicare che non è stata impostata un'intensità del segnale ricevuto fissa.
OT_MAC_FILTER_ITERATOR_INIT
OT_MAC_FILTER_ITERATOR_INIT 0
Inizializzatore per otMacFilterIterator.
OT_US_PER_TEN_SYMBOLS
OT_US_PER_TEN_SYMBOLS OT_RADIO_TEN_SYMBOLS_TIME
Tempo per 10 simboli in unità di microsecondi.
Risorse
Gli argomenti di riferimento dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.