TREL — стек потоков

Этот модуль определяет API-интерфейсы Thread Radio Encapsulation Link (TREL) для Thread Over Infrastructure.

Краткое содержание

Для функций этого модуля необходимо включить OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE .

Определения типов

otTrelPeer определение типа
struct otTrelPeer
Представляет одноранговый узел TREL.
otTrelPeerIterator определение типа
uint16_t
Представляет итератор для перебора записей таблицы одноранговых узлов TREL.

Функции

otTrelGetNextPeer ( otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
Перебирает записи одноранговой таблицы и получает следующую запись из таблицы.
otTrelInitPeerIterator ( otInstance *aInstance, otTrelPeerIterator *aIterator)
void
Инициализирует итератор одноранговой таблицы.
otTrelIsEnabled ( otInstance *aInstance)
bool
Указывает, включена ли операция TREL.
otTrelIsFilterEnabled ( otInstance *aInstance)
bool
Указывает, включен ли режим фильтра.
otTrelSetEnabled ( otInstance *aInstance, bool aEnable)
void
Включает или отключает работу TREL.
otTrelSetFilterEnabled ( otInstance *aInstance, bool aEnable)
void
Устанавливает режим фильтрации (включает/отключает фильтрацию).

Структуры

отТрелПеер

Представляет одноранговый узел TREL.

Определения типов

отТрелПеер

struct otTrelPeer otTrelPeer

Представляет одноранговый узел TREL.

отТрелПеерИтератор

uint16_t otTrelPeerIterator

Представляет итератор для перебора записей таблицы одноранговых узлов TREL.

Функции

otTrelGetNextPeer

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

Перебирает записи одноранговой таблицы и получает следующую запись из таблицы.

Подробности
Параметры
[in] aInstance
Экземпляр OpenThread.
[in] aIterator
Итератор. ДОЛЖЕН быть инициализирован.
Возврат
Указатель на следующую запись otTrelPeer или NULL , если записей в таблице больше нет.

отТрелинитПееритератор

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

Инициализирует итератор одноранговой таблицы.

Подробности
Параметры
[in] aInstance
Экземпляр OpenThread.
[in] aIterator
Итератор для инициализации.

отТрелисенаблед

bool otTrelIsEnabled(
  otInstance *aInstance
)

Указывает, включена ли операция TREL.

Подробности
Параметры
[in] aInstance
Экземпляр OpenThread.
Возвращаемые значения
TRUE
если операция TREL включена.
FALSE
если операция TREL отключена.

отТрелисфилтеренаблед

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

Указывает, включен ли режим фильтра.

Подробности
Параметры
[in] aInstance
Экземпляр OpenThread.
Возвращаемые значения
TRUE
если включен режим фильтра TREL.
FALSE
если режим фильтра TREL отключен.

отТрелсетенаблед

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Включает или отключает работу TREL.

Если aEnable имеет значение true, эта функция инициирует постоянный просмотр DNS-SD для имени службы «_trel._udp» в локальном домене просмотра для обнаружения других устройств, поддерживающих TREL. Устройство также регистрирует новую службу, которая будет рекламироваться с использованием DNS-SD, с именем службы «_trel._udp», что указывает на ее поддержку TREL. После этого устройство готово принимать сообщения TREL от одноранговых узлов.

Если aEnable имеет значение false, эта функция останавливает просмотр DNS-SD по имени службы «_trel._udp», прекращает рекламировать службу TREL DNS-SD и очищает таблицу одноранговых узлов TREL.

Подробности
Параметры
[in] aInstance
Указатель на экземпляр OpenThread.
[in] aEnable
Логическое значение для включения/выключения операции TREL.

отТрелсетфилтеренаблед

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

Устанавливает режим фильтрации (включает/отключает фильтрацию).

Когда режим фильтра включен, любой трафик приема и передачи через интерфейс TREL автоматически отбрасывается. В основном это предназначено для использования во время тестирования.

В отличие от otTrel{Enable/Disable}() , которая полностью запускает/останавливает операцию TREL, когда включен режим фильтра, интерфейс TREL продолжает оставаться включенным.

Подробности
Параметры
[in] aInstance
Экземпляр OpenThread.
[in] aFiltered
TRUE для включения режима фильтра, FALSE для отключения режима фильтра.

Ресурсы

Справочные разделы API OpenThread взяты из исходного кода, доступного на GitHub . Для получения дополнительной информации или внесения вклада в нашу документацию обратитесь к Ресурсам .