TREL: Pila de subprocesos

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

Resumen

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

Typedefs

otTrelPeer typedef
struct otTrelPeer
Representa un intercambio de tráfico de TREL.
otTrelPeerIterator typedef
uint16_t
Representa un iterador para iterar sobre entradas de tablas de pares de TREL.

remotas

otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Itera sobre 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 tabla 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/inhabilita el filtrado).

Structs

otTrelPeer

Representa un intercambio de tráfico de TREL.

Typedefs

otTrelPeer

struct otTrelPeer otTrelPeer

Representa un intercambio de tráfico de TREL.

otTrelPeerIterator

uint16_t otTrelPeerIterator

Representa un iterador para iterar sobre entradas de tablas de pares de TREL.

remotas

otTrelGetNextPeer

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

Itera sobre 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. SE DEBE inicializar.
Qué muestra
Un puntero a la siguiente entrada de otTrelPeer o NULL si no hay más entradas en la tabla.

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Inicializa un iterador de tabla 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 navegación de DNS-SD en curso en el nombre del servicio "_trel._udp" dentro del dominio de navegación local para detectar otros dispositivos compatibles con TREL. El dispositivo también registra un nuevo servicio que se anunciará mediante DNS-SD. El nombre del servicio es "_trel._udp", lo que indica la compatibilidad con TREL. El dispositivo estará listo para recibir mensajes TREL de pares.

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

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

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

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

Cuando el modo de filtro está habilitado, el tráfico rx y tx a través de la interfaz TREL se descarta en silencio. Está destinado principalmente para su uso durante las pruebas.

A diferencia de otTrel{Enable/Disable}(), que inicia o detiene por completo la operación TREL, cuando se habilita el modo de filtro, la interfaz de TREL sigue habilitada.

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

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 contribuir a nuestra documentación, consulta Recursos.