TREL - Stack Thread

Questo modulo definisce le API TREL (Thread Radio Encapsulation Link) per Thread Over Infrastructure.

Riepilogo

Le funzioni in questo modulo richiedono l'abilitazione di OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE.

Typedef
otTrelPeer typedef
struct otTrelPeer
Rappresenta un peer TREL.
otTrelPeerIterator typedef
uint16_t
Rappresenta un iteratore per l'iterazione delle voci della tabella peer TREL.

Funzioni
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Esegue l'iterazione sulle voci della tabella peer e recupera la voce successiva dalla tabella.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
Inizializza un iteratore della tabella peer.
otTrelIsEnabled(otInstance *aInstance)
bool
Indica se l'operazione TREL è abilitata.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
Indica se la modalità filtro è attivata o meno.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
Attiva o disattiva l'operazione TREL.
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
Imposta la modalità filtro (attiva/disattiva i filtri).

Strutture
otTrelPeer

Rappresenta un peer TREL.

Typedef

otTrelPeer

struct otTrelPeer otTrelPeer

Rappresenta un peer TREL.

otTrelPeerIterator

uint16_t otTrelPeerIterator

Rappresenta un iteratore per l'iterazione delle voci della tabella peer TREL.

Funzioni

otTrelGetNextPeer

const otTrelPeer * otTrelGetNextPeer(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Esegue l'iterazione sulle voci della tabella peer e recupera la voce successiva dalla tabella.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread.
[in] aIterator
L'iteratore. DEVE essere inizializzato.
Restituisce
Un puntatore alla voce otTrelPeer successiva o a NULL se non ci sono altre voci nella tabella.

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Inizializza un iteratore della tabella peer.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread.
[in] aIterator
L'iteratore da inizializzare.

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

Indica se l'operazione TREL è abilitata.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread.
Valori restituiti
TRUE
se l'operazione TREL è abilitata.
FALSE
se l'operazione TREL è disabilitata.

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

Indica se la modalità filtro è attivata o meno.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread.
Valori restituiti
TRUE
se è abilitata la modalità di filtro TREL.
FALSE
se la modalità di filtro TREL è disattivata.

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Attiva o disattiva l'operazione TREL.

Se aEnable è true, questa funzione avvia un'esplorazione DNS-SD continua sul nome del servizio "_trel._udp" all'interno del dominio di navigazione locale per trovare altri dispositivi che supportano TREL. Il dispositivo registra inoltre un nuovo servizio da pubblicizzare utilizzando DNS-SD. Il nome del servizio è "_trel._udp" e indica il supporto per TREL. Il dispositivo è quindi pronto a ricevere i messaggi TREL dei peer.

Quando aEnable è false, questa funzione interrompe l'esplorazione di DNS-SD sul nome del servizio "_trel._udp", interrompe la pubblicità del servizio TREL DNS-SD e cancella la tabella peer TREL.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aEnable
Un valore booleano per attivare/disattivare l'operazione TREL.

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

Imposta la modalità filtro (attiva/disattiva i filtri).

Quando la modalità filtro è attivata, tutto il traffico rx e tx attraverso l'interfaccia TREL viene ignorato. È destinata principalmente all'uso durante i test.

A differenza di otTrel{Enable/Disable}(), che avvia/interrompe completamente l'operazione TREL, quando la modalità filtro è attivata, l'interfaccia TREL continua a essere abilitata.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread.
[in] aFiltered
TRUE per abilitare la modalità filtro, FALSE per disabilitare la modalità filtro.

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.