TREL - Plataforma

Este módulo incluye la abstracción de plataforma para Thread Radio encapsulation Link (TREL) con DNS-SD y UDP/IPv6.

Resumen

Typedefs
otPlatTrelPeerInfo	typedef struct otPlatTrelPeerInfo Representa una información de par de TREL que se descubrió mediante la navegación de DNS-SD en el nombre de servicio "_trel._udp".

remotas
otPlatTrelDisable(otInstance *aInstance)	void Inhabilita la capa de la plataforma TREL.
otPlatTrelEnable(otInstance *aInstance, uint16_t *aUdpPort)	void Inicializa y habilita la capa de la plataforma TREL.
otPlatTrelHandleDiscoveredPeerInfo(otInstance *aInstance, const otPlatTrelPeerInfo *aInfo)	void Esta es una función de devolución de llamada de la capa de la plataforma para informar una información de pares de TREL descubierto.
otPlatTrelHandleReceived(otInstance *aInstance, uint8_t *aBuffer, uint16_t aLength)	void Es una devolución de llamada de la plataforma para notificar sobre un paquete TREL UDP recibido.
otPlatTrelRegisterService(otInstance *aInstance, uint16_t aPort, const uint8_t *aTxtData, uint8_t aTxtLength)	void Registra un nuevo servicio para anunciar con DNS-SD [RFC6763].
otPlatTrelSend(otInstance *aInstance, const uint8_t *aUdpPayload, uint16_t aUdpPayloadLen, const otSockAddr *aDestSockAddr)	void Solicita que se envíe un paquete UDP de TREL a un destino determinado.

Structs
otPlatTrelPeerInfo	Representa una información de par de TREL que se descubrió mediante la navegación de DNS-SD en el nombre de servicio "_trel._udp".

Typedefs

otPlatTrelPeerInfo

struct otPlatTrelPeerInfo otPlatTrelPeerInfo

Representa una información de par de TREL que se descubrió mediante la navegación de DNS-SD en el nombre de servicio "_trel._udp".

remotas

otPlatTrelDisable

void otPlatTrelDisable(
  otInstance *aInstance
)

Inhabilita la capa de la plataforma TREL.

Después de esta llamada, la capa de la plataforma DEBE detener la navegación de DNS-SD en el nombre de servicio "_trel._udp", dejar de anunciar el servicio DNS-SD de TREL (de otPlatTrelRegisterService()) y DEBE cerrar el socket UDP utilizado para recibir los mensajes TREL.

[in] aInstance La instancia de OpenThread.

otPlatTrelEnable

void otPlatTrelEnable(
  otInstance *aInstance,
  uint16_t *aUdpPort
)

Inicializa y habilita la capa de la plataforma TREL.

Después de esta llamada, la capa de la plataforma DEBE realizar lo siguiente:

1) La capa de la plataforma TREL DEBE abrir un socket UDP para escuchar y recibir mensajes TREL de pares. El socket está vinculado a un número de puerto efímero que elige la capa de la plataforma. El número de puerto se DEBE devolver en aUdpPort. El socket también está vinculado a las interfaces de red en las que se admitirá TREL. El socket y el puerto elegido deben seguir siendo válidos mientras TREL está habilitado.

2) La capa de la plataforma DEBE iniciar una navegación de DNS-SD en curso en el nombre del servicio "_trel._udp" dentro del dominio de navegación local para descubrir otros dispositivos compatibles con TREL. La navegación continua producirá dos tipos de eventos diferentes: eventos "agregar" y eventos "quitar". Cuando se inicia la navegación, debe producir un evento "add" para cada par TREL actualmente presente en la red. Cada vez que un par de TREL se desconecta, se debe producir un evento "remove". Sin embargo, los eventos de eliminación no están garantizados. Cuando se descubre una instancia de servicio de TREL, se debe iniciar una nueva consulta de DNS-SD en curso para un registro AAAA en el nombre de host indicado en el registro SRV de la instancia descubierta. Si se descubren varias direcciones IPv6 de host para un par, se DEBE informar una con el mayor alcance entre todas las direcciones (si hay varias direcciones en el mismo alcance, se debe seleccionar una al azar).

La plataforma TREL DEBE indicar la información de pares descubierta mediante la devolución de llamada otPlatTrelHandleDiscoveredPeerInfo(). Esta devolución de llamada DEBE invocarse cuando se detecta un par nuevo, cuando se produce un cambio en una entrada existente (p.ej., un registro TXT nuevo, un número de puerto nuevo o una dirección IPv6 nueva) o cuando se quita el par.

Detalles
Parámetros	[in] aInstance La instancia de OpenThread. [out] aUdpPort Un puntero para mostrar el número de puerto seleccionado por capa de la plataforma.

otPlatTrelHandleDiscoveredPeerInfo

void otPlatTrelHandleDiscoveredPeerInfo(
  otInstance *aInstance,
  const otPlatTrelPeerInfo *aInfo
)

Esta es una función de devolución de llamada de la capa de la plataforma para informar una información de pares de TREL descubierto.

Nota: No es necesario que la estructura aInfo ni su contenido (p.ej., el búfer mTxtData) persistan después de regresar de esta llamada. El código de OpenThread hará una copia de toda la información que necesita.

Detalles
Parámetros	[in] aInstance La instancia de OpenThread. [in] aInfo Un puntero para la información de pares de TREL.

otPlatTrelHandleReceived

void otPlatTrelHandleReceived(
  otInstance *aInstance,
  uint8_t *aBuffer,
  uint16_t aLength
)

Es una devolución de llamada de la plataforma para notificar sobre un paquete TREL UDP recibido.

Nota: El núcleo de OpenThread puede cambiar el contenido del búfer (hasta su longitud especificada) (p.ej., desencriptado en el lugar), por lo que la implementación de la plataforma debería esperar que, después de mostrar esta función, el contenido de aBuffer se haya alterado.

Detalles
Parámetros	[in] aInstance Estructura de instancias de OpenThread [in] aBuffer Un búfer que contiene la carga útil UDP recibida. [in] aLength Longitud de la carga útil de UDP (cantidad de bytes).

otPlatTrelRegisterService

void otPlatTrelRegisterService(
  otInstance *aInstance,
  uint16_t aPort,
  const uint8_t *aTxtData,
  uint8_t aTxtLength
)

Registra un nuevo servicio para anunciar con DNS-SD [RFC6763].

El nombre del servicio es "_trel._udp". La plataforma debe usar su propio nombre de host, el cual, combinado con el nombre del servicio y el nombre de dominio DNS-SD local, producirá el nombre completo de la instancia de servicio, por ejemplo, "example-host._trel._udp.local.".

El dominio bajo el que aparece el nombre de la instancia de servicio será "local" para mDNS y será el dominio que se use para el registro del servicio en el caso de un servicio DNS-SD local que no sea mDNS.

Una llamada posterior a esta función actualiza el servicio anterior. Se usa para actualizar los datos del registro TXT o el número de puerto.

El búfer aTxtData no se conserva después de la devolución de esta función. La capa de la plataforma NO DEBE mantener el puntero y, en su lugar, copiar el contenido si es necesario.

Detalles
Parámetros	[in] aInstance La instancia de OpenThread. [in] aPort El número de puerto que se debe incluir en el registro SRV del servicio anunciado. [in] aTxtData Un puntero para los datos del registro TXT (codificados) que se incluirán en el servicio anunciado. [in] aTxtLength La longitud de aTxtData (cantidad de bytes).

otPlatTrelSend

void otPlatTrelSend(
  otInstance *aInstance,
  const uint8_t *aUdpPayload,
  uint16_t aUdpPayloadLen,
  const otSockAddr *aDestSockAddr
)

Solicita que se envíe un paquete UDP de TREL a un destino determinado.

Detalles
Parámetros	[in] aInstance Estructura de instancias de OpenThread [in] aUdpPayload Un puntero para la carga útil UDP. [in] aUdpPayloadLen La longitud de la carga útil (cantidad de bytes). [in] aDestSockAddr La dirección del socket de destino.

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.