TREL: Pila de hilos

En este módulo, se definen las APIs de Thread Radio Encapsulation Link (TREL) para la infraestructura de Thread Over.

Resumen

Las funciones de este módulo requieren que se habilite OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE.

Typedefs

otTrelPeer typedef
struct otTrelPeer
Representa un par TREL.
otTrelPeerIterator typedef
uint16_t
Representa un iterador para iterar a través de entradas de tablas de pares TREL.

Funciones

otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Itera en las entradas de la tabla de pares y obtiene la siguiente entrada de la tabla.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
Inicializa un iterador de tablas de intercambio de tráfico.
otTrelIsEnabled(otInstance *aInstance)
bool
Indica si la operación TREL está habilitada.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
Indica si el modo de filtro está habilitado o no.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
Habilita o inhabilita la operación TREL.
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
Establece el modo de filtro (habilita o inhabilita el filtrado).

Structs

otTrelPeer

Representa un par TREL.

Typedefs

otTrelPeer

struct otTrelPeer otTrelPeer

Representa un par TREL.

otTrelPeerIterator

uint16_t otTrelPeerIterator

Representa un iterador para iterar a través de entradas de tablas de pares TREL.

Funciones

otTrelGetNextPeer

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

Itera en las entradas de la tabla de pares y obtiene la siguiente entrada de la tabla.

Detalles
Parámetros
[in] aInstance
La instancia de OpenThread.
[in] aIterator
El iterador DEBE inicializarse.
Qué muestra
Un puntero para la siguiente entrada otTrelPeer o NULL si no hay más entradas en la tabla

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Inicializa un iterador de tablas de intercambio de tráfico.

Detalles
Parámetros
[in] aInstance
La instancia de OpenThread.
[in] aIterator
El iterador que se inicializará.

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

Indica si la operación TREL está habilitada.

Detalles
Parámetros
[in] aInstance
La instancia de OpenThread.
Valores que se muestran
TRUE
si la operación TREL está habilitada.
FALSE
si la operación TREL está inhabilitada.

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

Indica si el modo de filtro está habilitado o no.

Detalles
Parámetros
[in] aInstance
La instancia de OpenThread.
Valores que se muestran
TRUE
si el modo de filtro TREL está habilitado.
FALSE
si el modo de filtro TREL está inhabilitado.

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Habilita o inhabilita la operación TREL.

Cuando aEnable es verdadero, esta función inicia una búsqueda de DNS-SD en curso en el nombre de servicio "_trel._udp" dentro del dominio de navegación local para descubrir otros dispositivos que admitan TREL. El dispositivo también registra un nuevo servicio para anunciarlo mediante DNS-SD, con el nombre "_trel._udp", que indica su compatibilidad con TREL. El dispositivo estará listo para recibir mensajes TREL de pares.

Cuando aEnable es falso, esta función detiene la navegación DNS-SD en el nombre de servicio "_trel._udp", deja de anunciar el servicio DNS-SD y borra la tabla de intercambio de tráfico TREL.

Detalles
Parámetros
[in] aInstance
Un puntero para una instancia de OpenThread.
[in] aEnable
Un valor booleano para habilitar o inhabilitar la operación TREL.

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

Establece el modo de filtro (habilita o inhabilita el filtrado).

Cuando está habilitado el modo de filtro, cualquier tráfico rx y tx a través de la interfaz TREL se descarta de forma silenciosa. Esto está diseñado principalmente para su uso durante las pruebas.

A diferencia de otTrel{Enable/Disable}(), que inicia o detiene por completo la operación TREL, cuando el modo de filtro está habilitado, la interfaz de TREL continúa habilitada.

Detalles
Parámetros
[in] aInstance
La instancia de OpenThread.
[in] aFiltered
TRUE para habilitar el modo de filtro y FALSE para inhabilitarlo.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o colaborar con nuestra documentación, consulta la sección Recursos.