TREL: pilha de linhas de execução

Esse módulo define as APIs Thread Radio Encapsulation Link (TREL) para a infraestrutura Thread Over.

Resumo

As funções neste módulo exigem que o OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE esteja ativado.

Typedefs
otTrelPeer typedef
struct otTrelPeer
Representa um peering TREL.
otTrelPeerIterator typedef
uint16_t
Representa um iterador para iterar nas entradas da tabela de pares TREL.

remotas
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Itera sobre as entradas da tabela de peering e recebe a próxima entrada da tabela.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
Inicializa um iterador de tabela de peering.
otTrelIsEnabled(otInstance *aInstance)
bool
Indica se a operação TREL está ativada.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
Indica se o modo de filtro está ativado ou não.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
Ativa ou desativa a operação TREL.
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
Define o modo de filtro (ativa/desativa a filtragem).

Estruturas
otTrelPeer

Representa um peering TREL.

Typedefs

otTrelPeer

struct otTrelPeer otTrelPeer

Representa um peering TREL.

otTrelPeerIterator

uint16_t otTrelPeerIterator

Representa um iterador para iterar nas entradas da tabela de pares TREL.

remotas

otTrelGetNextPeer

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

Itera sobre as entradas da tabela de peering e recebe a próxima entrada da tabela.

Detalhes
Parâmetros
[in] aInstance
A instância do OpenThread.
[in] aIterator
O iterador. PRECISA ser inicializado.
Retorna
Um ponteiro para a próxima entrada otTrelPeer ou NULL se não houver mais entradas na tabela.

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Inicializa um iterador de tabela de peering.

Detalhes
Parâmetros
[in] aInstance
A instância do OpenThread.
[in] aIterator
O iterador a ser inicializado.

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

Indica se a operação TREL está ativada.

Detalhes
Parâmetros
[in] aInstance
A instância do OpenThread.
Valores de retorno
TRUE
se a operação TREL estiver ativada.
FALSE
se a operação TREL estiver desativada.

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

Indica se o modo de filtro está ativado ou não.

Detalhes
Parâmetros
[in] aInstance
A instância do OpenThread.
Valores de retorno
TRUE
se o modo de filtro TREL estiver ativado.
FALSE
se o modo de filtro TREL estiver desativado.

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Ativa ou desativa a operação TREL.

Quando aEnable é verdadeiro, essa função inicia uma navegação DNS-SD em andamento no nome do serviço "_trel._udp" no domínio de navegação local para descobrir outros dispositivos compatíveis com TREL. O dispositivo também registra um novo serviço a ser anunciado usando DNS-SD, com o nome "_trel._udp" indicando compatibilidade com TREL. O dispositivo está pronto para receber mensagens TREL de pares.

Quando aEnable é falso, essa função interrompe a navegação DNS-SD no nome de serviço "_trel._udp", para de anunciar o serviço DNS-SD TREL e limpa a tabela de pares TREL.

Detalhes
Parâmetros
[in] aInstance
Um ponteiro para uma instância do OpenThread.
[in] aEnable
Um booleano para ativar/desativar a operação TREL.

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

Define o modo de filtro (ativa/desativa a filtragem).

Quando o modo de filtro está ativado, qualquer tráfego rx e tx pela interface TREL é descartado silenciosamente. Isso se destina principalmente para uso durante testes.

Ao contrário de otTrel{Enable/Disable}(), que inicia/interrompe totalmente a operação TREL, quando o modo de filtro está ativado, a interface TREL continua ativa.

Detalhes
Parâmetros
[in] aInstance
A instância do OpenThread.
[in] aFiltered
TRUE para ativar o modo de filtro, FALSE para desativar o modo de filtro.

Recursos

Os tópicos de Referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para mais informações ou para contribuir com nossa documentação, consulte Recursos.