TREL – Pile de fils de discussion

Ce module définit les API TREL (Radio Encapsulation Link) Thread pour Thread Over Infrastructure.

Résumé

Les fonctions de ce module nécessitent l'activation de OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE.

Typedefs
otTrelPeer typedef
struct otTrelPeer
Représente un pair TREL.
otTrelPeerIterator typedef
uint16_t
Représente un itérateur pour l'itération des entrées du tableau des pairs TREL.

distantes
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Itère les entrées du tableau des pairs et obtient l'entrée suivante de la table.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
Initialise un itérateur de table appairée.
otTrelIsEnabled(otInstance *aInstance)
bool
Indique si l'opération TREL est activée.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
Indique si le mode de filtrage est activé ou non.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
Active ou désactive l'opération TREL.
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
Définit le mode de filtrage (active/désactive le filtrage).

Structs
otTrelPeer

Représente un pair TREL.

Typedefs

otTrelPeer

struct otTrelPeer otTrelPeer

Représente un pair TREL.

otTrelPeerIterator

uint16_t otTrelPeerIterator

Représente un itérateur pour l'itération des entrées du tableau des pairs TREL.

distantes

otTrelGetNextPeer

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

Itère les entrées du tableau des pairs et obtient l'entrée suivante de la table.

Détails
Paramètres
[in] aInstance
L'instance OpenThread.
[in] aIterator
Itérateur DOIT être initialisé.
Renvoie
Pointeur vers l'entrée otTrelPeer suivante ou NULL si la table ne contient plus d'entrées.

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Initialise un itérateur de table appairée.

Détails
Paramètres
[in] aInstance
L'instance OpenThread.
[in] aIterator
Itérateur à initialiser.

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

Indique si l'opération TREL est activée.

Détails
Paramètres
[in] aInstance
L'instance OpenThread.
Valeurs de retour
TRUE
si l'opération TREL est activée.
FALSE
si l'opération TREL est désactivée.

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

Indique si le mode de filtrage est activé ou non.

Détails
Paramètres
[in] aInstance
L'instance OpenThread.
Valeurs de retour
TRUE
si le mode de filtrage TREL est activé.
FALSE
si le mode de filtrage TREL est désactivé.

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Active ou désactive l'opération TREL.

Lorsque aEnable est défini sur "true", cette fonction lance une navigation DNS-SD en cours sur le nom de service "_trel._udp" dans le domaine de navigation local afin de détecter les autres appareils compatibles avec TREL. L'appareil enregistre également un nouveau service à annoncer à l'aide de DNS-SD. Le nom du service est "_trel._udp", ce qui indique sa compatibilité avec TREL. L'appareil est alors prêt à recevoir les messages TREL des pairs.

Lorsque aEnable est défini sur "false", cette fonction arrête la navigation DNS-SD sur le nom de service "_trel._udp", cesse de faire la promotion du service DNS-SD TREL et efface la table des pairs TREL.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance OpenThread.
[in] aEnable
Valeur booléenne permettant d'activer ou de désactiver l'opération TREL.

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

Définit le mode de filtrage (active/désactive le filtrage).

Lorsque le mode de filtrage est activé, tout trafic rx et tx via l'interface TREL est supprimé sans notification. Elle est principalement destinée à être utilisée pendant les tests.

Contrairement à otTrel{Enable/Disable}(), qui démarre/arrête complètement l'opération TREL, lorsque le mode de filtrage est activé, l'interface TREL continue d'être activée.

Détails
Paramètres
[in] aInstance
L'instance OpenThread.
[in] aFiltered
TRUE pour activer le mode de filtrage, FALSE pour désactiver le mode de filtrage.

Ressources

Les sujets de référence de l'API OpenThread proviennent du code source, disponible sur GitHub. Pour en savoir plus ou pour contribuer à notre documentation, consultez la section Ressources.