BLE безопасный

Этот модуль включает в себя функции, которые управляют связью BLE Secure (TLS поверх BLE).

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

Этот модуль включает функции, реализующие связь TCAT.

Функции в этом модуле доступны, когда включена функция BLE Secure API ( OPENTHREAD_CONFIG_BLE_TCAT_ENABLE ).

Функции этого модуля доступны, когда включена функция TCAT ( OPENTHREAD_CONFIG_BLE_TCAT_ENABLE ).

Перечисления
otTcatApplicationProtocol { OT_TCAT_APPLICATION_PROTOCOL_NONE = 0, OT_TCAT_APPLICATION_PROTOCOL_STATUS = 1, OT_TCAT_APPLICATION_PROTOCOL_TCP = 2 }	перечисление Представляет протокол приложения TCAT.
otTcatCommandClass { OT_TCAT_COMMAND_CLASS_GENERAL = 0, OT_TCAT_COMMAND_CLASS_COMMISSIONING = 1, OT_TCAT_COMMAND_CLASS_EXTRACTION = 2, OT_TCAT_COMMAND_CLASS_DECOMMISSIONING = 3, OT_TCAT_COMMAND_CLASS_APPLICATION = 4 }	перечисление Представляет класс команд TCAT.
otTcatStatusCode { OT_TCAT_STATUS_SUCCESS = 0, OT_TCAT_STATUS_UNSUPPORTED = 1, OT_TCAT_STATUS_PARSE_ERROR = 2, OT_TCAT_STATUS_VALUE_ERROR = 3, OT_TCAT_STATUS_GENERAL_ERROR = 4, OT_TCAT_STATUS_BUSY = 5, OT_TCAT_STATUS_UNDEFINED = 6, OT_TCAT_STATUS_HASH_ERROR = 7, OT_TCAT_STATUS_UNAUTHORIZED = 16 }	перечисление Представляет код состояния TCAT.

Определения типов
otHandleBleSecureConnect )(otInstance *aInstance, bool aConnected, bool aBleConnectionOpen, void *aContext)	определение типа void(* Указатель для вызова при изменении состояния безопасного соединения.
otHandleBleSecureReceive	определение типа otHandleTcatApplicationDataReceive Указатель для вызова, когда данные были получены через соединение BLE Secure TLS.
otHandleTcatApplicationDataReceive )(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext)	определение типа void(* Указатель на вызов, когда данные приложения были получены через соединение TCAT TLS.
otHandleTcatJoin )(otError aError, void *aContext)	определение типа void(* Указатель на вызов для уведомления о завершении операции соединения.
otTcatApplicationProtocol	определение типа enum otTcatApplicationProtocol Представляет протокол приложения TCAT.
otTcatCommandClass	определение типа enum otTcatCommandClass Представляет класс команд TCAT.
otTcatStatusCode	определение типа enum otTcatStatusCode Представляет код состояния TCAT.
otTcatVendorInfo	определение типа struct otTcatVendorInfo Эта структура представляет информацию о поставщике TCAT.

Функции
otBleSecureConnect ( otInstance *aInstance)	otError Инициализирует сеанс TLS с одноранговым узлом, используя уже открытое соединение BLE.
otBleSecureDisconnect ( otInstance *aInstance)	void Останавливает соединение BLE и TLS.
otBleSecureFlush ( otInstance *aInstance)	otError Очищает буфер отправки.
otBleSecureGetPeerCertificateBase64 ( otInstance *aInstance, unsigned char *aPeerCert, size_t *aCertLength)	otError Возвращает сертификат узла x509 в кодировке Base64.
otBleSecureGetPeerSubjectAttributeByOid ( otInstance *aInstance, const char *aOid, size_t aOidLength, uint8_t *aAttributeBuffer, size_t *aAttributeLength, int *aAsn1Type)	otError Возвращает значение атрибута, идентифицированное его OID из субъекта сертификата x509 узла.
otBleSecureGetThreadAttributeFromOwnCertificate ( otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength)	otError Возвращает значение атрибута для OID 1.3.6.1.4.1.44970.x из расширений v3 собственного сертификата x509, где последней цифре x присвоено значение aThreadOidDescriptor.
otBleSecureGetThreadAttributeFromPeerCertificate ( otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength)	otError Возвращает значение атрибута для OID 1.3.6.1.4.1.44970.x из расширений версии 3 однорангового сертификата x509, где последней цифре x присвоено значение aThreadOidDescriptor.
otBleSecureIsCommandClassAuthorized ( otInstance *aInstance, otTcatCommandClass aCommandClass)	bool Указывает, авторизован ли класс команд TCAT.
otBleSecureIsConnected ( otInstance *aInstance)	bool Указывает, подключен ли сеанс TLS.
otBleSecureIsConnectionActive ( otInstance *aInstance)	bool Указывает, активен ли сеанс TLS (подключен или подключен).
otBleSecureIsTcatEnabled ( otInstance *aInstance)	bool Указывает, включен ли агент TCAT.
otBleSecureSend ( otInstance *aInstance, uint8_t *aBuf, uint16_t aLength)	otError Отправляет защищенный пакет данных BLE.
otBleSecureSendApplicationTlv ( otInstance *aInstance, uint8_t *aBuf, uint16_t aLength)	otError Отправляет безопасный пакет данных BLE, содержащий TLV данных приложения отправки TCAT.
otBleSecureSendMessage ( otInstance *aInstance, otMessage *aMessage)	otError Отправляет защищенное сообщение BLE.
otBleSecureSetCaCertificateChain ( otInstance *aInstance, const uint8_t *aX509CaCertificateChain, uint32_t aX509CaCertChainLength)	void Устанавливает доверенные центры сертификации верхнего уровня.
otBleSecureSetCertificate ( otInstance *aInstance, const uint8_t *aX509Cert, uint32_t aX509Length, const uint8_t *aPrivateKey, uint32_t aPrivateKeyLength)	void Устанавливает сертификат X509 локального устройства с соответствующим закрытым ключом для сеанса TLS с TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.
otBleSecureSetPsk ( otInstance *aInstance, const uint8_t *aPsk, uint16_t aPskLength, const uint8_t *aPskIdentity, uint16_t aPskIdLength)	void Устанавливает предварительный общий ключ (PSK) и набор шифров TLS_PSK_WITH_AES_128_CCM_8.
otBleSecureSetSslAuthMode ( otInstance *aInstance, bool aVerifyPeerCertificate)	void Устанавливает режим аутентификации для безопасного соединения BLE.
otBleSecureStart ( otInstance *aInstance, otHandleBleSecureConnect aConnectHandler, otHandleBleSecureReceive aReceiveHandler, bool aTlvMode, void *aContext)	otError Запускает службу BLE Secure.
otBleSecureStop ( otInstance *aInstance)	void Останавливает сервер BLE Secure.
otBleSecureTcatStart ( otInstance *aInstance, const otTcatVendorInfo *aVendorInfo, otHandleTcatJoin aHandler)	otError Включает протокол TCAT через BLE Secure.

Структуры
otTcatVendorInfo	Эта структура представляет информацию о поставщике TCAT.

Перечисления

otTcatApplicationProtocol

 otTcatApplicationProtocol

Представляет протокол приложения TCAT.

Характеристики
OT_TCAT_APPLICATION_PROTOCOL_NONE	Сообщение, отправленное без активации агента TCAT.
OT_TCAT_APPLICATION_PROTOCOL_STATUS	Сообщение направлено в службу UDP.
OT_TCAT_APPLICATION_PROTOCOL_TCP	Сообщение направлено в службу TCP.

отткаткоммандкласс

 otTcatCommandClass

Представляет класс команд TCAT.

Характеристики
OT_TCAT_COMMAND_CLASS_APPLICATION	Команды TCAT, относящиеся к прикладному уровню.
OT_TCAT_COMMAND_CLASS_COMMISSIONING	Команды TCAT, связанные с вводом в эксплуатацию.
OT_TCAT_COMMAND_CLASS_DECOMMISSIONING	Команды TCAT, связанные с выводом из эксплуатации.
OT_TCAT_COMMAND_CLASS_EXTRACTION	Команды TCAT, связанные с извлечением ключей.
OT_TCAT_COMMAND_CLASS_GENERAL	Команды TCAT, относящиеся к общим операциям.

отТкатстатускоде

 otTcatStatusCode

Представляет код состояния TCAT.

Характеристики
OT_TCAT_STATUS_BUSY	Команду невозможно выполнить, поскольку ресурс занят.
OT_TCAT_STATUS_GENERAL_ERROR	Произошла ошибка, не соответствующая ни одной другой категории.
OT_TCAT_STATUS_HASH_ERROR	Хэш-значение, представленное комиссаром, было неверным.
OT_TCAT_STATUS_PARSE_ERROR	Запрос/команду не удалось правильно разобрать.
OT_TCAT_STATUS_SUCCESS	Команда или запрос успешно обработаны.
OT_TCAT_STATUS_UNAUTHORIZED	Отправитель не имеет достаточных полномочий для данной команды.
OT_TCAT_STATUS_UNDEFINED	Запрошенное значение, данные или услуга не определены (в настоящее время) или отсутствуют.
OT_TCAT_STATUS_UNSUPPORTED	Запрошенная команда или полученный TLV не поддерживаются.
OT_TCAT_STATUS_VALUE_ERROR	Значение переданного TLV содержит ошибку.

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

отхандлеблесекуреконнект

void(* otHandleBleSecureConnect)(otInstance *aInstance, bool aConnected, bool aBleConnectionOpen, void *aContext)

Указатель для вызова при изменении состояния безопасного соединения.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aConnected TRUE, если было установлено безопасное соединение, FALSE в противном случае. [in] aBleConnectionOpen TRUE, если было установлено соединение BLE для передачи потока данных TLS, в противном случае FALSE. [in] aContext Указатель на произвольную контекстную информацию.

otHandleBleSecureReceive

otHandleTcatApplicationDataReceive otHandleBleSecureReceive

Указатель для вызова, когда данные были получены через соединение BLE Secure TLS.

отхандлеткатаппликатиондатарецеиве

void(* otHandleTcatApplicationDataReceive)(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext)

Указатель на вызов, когда данные приложения были получены через соединение TCAT TLS.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aMessage Указатель на сообщение. [in] aOffset Смещение, с которого начинаются данные приложения. [in] aTcatApplicationProtocol Тип протокола полученного сообщения. [in] aServiceName Имя службы, на которую направлено сообщение. [in] aContext Указатель на произвольную контекстную информацию.

otHandleTcatJoin

void(* otHandleTcatJoin)(otError aError, void *aContext)

Указатель на вызов для уведомления о завершении операции соединения.

Подробности
Параметры	[in] aError OT_ERROR_NONE, если процесс присоединения завершился успешно. OT_ERROR_SECURITY, если процесс присоединения не удался из-за учетных данных безопасности. [in] aContext Указатель на произвольную контекстную информацию.

otTcatApplicationProtocol

enum otTcatApplicationProtocol otTcatApplicationProtocol

Представляет протокол приложения TCAT.

отткаткоммандкласс

enum otTcatCommandClass otTcatCommandClass

Представляет класс команд TCAT.

отТкатстатускоде

enum otTcatStatusCode otTcatStatusCode

Представляет код состояния TCAT.

otTcatVendorInfo

struct otTcatVendorInfo otTcatVendorInfo

Эта структура представляет информацию о поставщике TCAT.

Содержимое этой структуры ДОЛЖНО сохраняться и оставаться неизменным во время сеанса TCAT.

Функции

отBleSecureConnect

otError otBleSecureConnect(
  otInstance *aInstance
)

Инициализирует сеанс TLS с одноранговым узлом, используя уже открытое соединение BLE.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread.
Возвращаемые значения	OT_ERROR_NONE Соединение TLS успешно запущено.

отBleSecureDisconnect

void otBleSecureDisconnect(
  otInstance *aInstance
)

Останавливает соединение BLE и TLS.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread.

otBleSecureFlush

otError otBleSecureFlush(
  otInstance *aInstance
)

Очищает буфер отправки.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread.
Возвращаемые значения	OT_ERROR_NONE Выходной буфер успешно очищен. OT_ERROR_NO_BUFS Не удалось выделить буферную память. OT_ERROR_INVALID_STATE TLS-соединение не было инициализировано.

otBleSecureGetPeerCertificateBase64

otError otBleSecureGetPeerCertificateBase64(
  otInstance *aInstance,
  unsigned char *aPeerCert,
  size_t *aCertLength
)

Возвращает сертификат узла x509 в кодировке Base64.

Примечание. Требуется, чтобы были включены функции времени сборки MBEDTLS_BASE64_C и MBEDTLS_SSL_KEEP_PEER_CERTIFICATE .

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [out] aPeerCert Указатель на буфер сертификата в кодировке Base64. [in,out] aCertLength На входе размер — максимальный размер aPeerCert . На выходе длина сертификата узла в кодировке Base64.
Возвращаемые значения	OT_ERROR_NONE Успешно получите сертификат партнера. OT_ERROR_INVALID_ARGS aInstance или aCertLength недействительны. OT_ERROR_INVALID_STATE Еще не подключен. OT_ERROR_NO_BUFS Невозможно выделить память для сертификата.

otBleSecureGetPeerSubjectAttributeByOid

otError otBleSecureGetPeerSubjectAttributeByOid(
  otInstance *aInstance,
  const char *aOid,
  size_t aOidLength,
  uint8_t *aAttributeBuffer,
  size_t *aAttributeLength,
  int *aAsn1Type
)

Возвращает значение атрибута, идентифицированное его OID из субъекта сертификата x509 узла.

Одноранговый OID предоставляется в двоичном формате. Длина атрибута устанавливается, если атрибут был успешно прочитан, или равна нулю в случае неудачного чтения. Тип ASN.1 устанавливается в соответствии со стандартом ITU-T X.690, если атрибут был успешно прочитан.

Примечание. Требуется включить функцию времени сборки MBEDTLS_SSL_KEEP_PEER_CERTIFICATE .

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aOid Указатель на OID, который необходимо найти. [in] aOidLength Длина OID. [out] aAttributeBuffer Указатель на буфер атрибутов. [in,out] aAttributeLength На входе размер равен максимальному размеру aAttributeBuffer . На выходе длина атрибута, записываемого в буфер. [out] aAsn1Type Указатель на тип ASN.1 атрибута, записываемого в буфер.
Возвращаемые значения	OT_ERROR_INVALID_STATE Еще не подключен. OT_ERROR_INVALID_ARGS Недопустимая длина атрибута. OT_ERROR_NONE Атрибут успешно прочитан. OT_ERROR_NO_BUFS Недостаточно памяти для хранения значения атрибута.

otBleSecureGetThreadAttributeFromOwnCertificate

otError otBleSecureGetThreadAttributeFromOwnCertificate(
  otInstance *aInstance,
  int aThreadOidDescriptor,
  uint8_t *aAttributeBuffer,
  size_t *aAttributeLength
)

Возвращает значение атрибута для OID 1.3.6.1.4.1.44970.x из расширений v3 собственного сертификата x509, где последней цифре x присвоено значение aThreadOidDescriptor.

Длина атрибута устанавливается, если атрибут был успешно прочитан, или равна нулю в случае неудачного чтения. Требуется подключение для активности.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aThreadOidDescriptor Последняя цифра OID атрибута потока. [out] aAttributeBuffer Указатель на буфер атрибутов. [in,out] aAttributeLength На входе размер равен максимальному размеру aAttributeBuffer . На выходе длина атрибута, записываемого в буфер.
Возвращаемые значения	OT_ERROR_NONE Атрибут успешно прочитан. OT_ERROR_INVALID_ARGS Недопустимая длина атрибута. OT_NOT_FOUND Запрошенный атрибут не найден. OT_ERROR_NO_BUFS Недостаточно памяти для хранения значения атрибута. OT_ERROR_INVALID_STATE Еще не подключен. OT_ERROR_NOT_IMPLEMENTED Значение aThreadOidDescriptor составляет >127. OT_ERROR_PARSE Расширения сертификата не удалось проанализировать.

otBleSecureGetThreadAttributeFromPeerCertificate

otError otBleSecureGetThreadAttributeFromPeerCertificate(
  otInstance *aInstance,
  int aThreadOidDescriptor,
  uint8_t *aAttributeBuffer,
  size_t *aAttributeLength
)

Возвращает значение атрибута для OID 1.3.6.1.4.1.44970.x из расширений версии 3 однорангового сертификата x509, где последней цифре x присвоено значение aThreadOidDescriptor.

Длина атрибута устанавливается, если атрибут был успешно прочитан, или равна нулю в случае неудачного чтения. Требуется подключение для активности.

Примечание. Требуется включить функцию времени сборки MBEDTLS_SSL_KEEP_PEER_CERTIFICATE .

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aThreadOidDescriptor Последняя цифра OID атрибута потока. [out] aAttributeBuffer Указатель на буфер атрибутов. [in,out] aAttributeLength На входе размер равен максимальному размеру aAttributeBuffer . На выходе длина атрибута, записываемого в буфер.
Возвращаемые значения	OT_ERROR_NONE Атрибут успешно прочитан. OT_ERROR_INVALID_ARGS Недопустимая длина атрибута. OT_NOT_FOUND Запрошенный атрибут не найден. OT_ERROR_NO_BUFS Недостаточно памяти для хранения значения атрибута. OT_ERROR_INVALID_STATE Еще не подключен. OT_ERROR_NOT_IMPLEMENTED Значение aThreadOidDescriptor составляет >127. OT_ERROR_PARSE Расширения сертификата не удалось проанализировать.

otBleSecureIsCommandClassAuthorized

bool otBleSecureIsCommandClassAuthorized(
  otInstance *aInstance,
  otTcatCommandClass aCommandClass
)

Указывает, авторизован ли класс команд TCAT.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aCommandClass Класс команды для проверки.
Возвращаемые значения	TRUE Класс команды авторизован. FALSE Класс команды не авторизован.

отБлесекуреисконнектед

bool otBleSecureIsConnected(
  otInstance *aInstance
)

Указывает, подключен ли сеанс TLS.

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

отБлесекуреисконнектионактиве

bool otBleSecureIsConnectionActive(
  otInstance *aInstance
)

Указывает, активен ли сеанс TLS (подключен или подключен).

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread.
Возвращаемые значения	TRUE Если сеанс TLS активен. FALSE Если сеанс TLS не активен.

отблесекуреисткатенаблед

bool otBleSecureIsTcatEnabled(
  otInstance *aInstance
)

Указывает, включен ли агент TCAT.

Подробности
Возвращаемые значения	TRUE Агент TCAT включен. FALSE Агент TCAT не включен.

отBleSecureSend

otError otBleSecureSend(
  otInstance *aInstance,
  uint8_t *aBuf,
  uint16_t aLength
)

Отправляет защищенный пакет данных BLE.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aBuf Указатель на данные для отправки в качестве значения TLV данных приложения отправки TCAT. [in] aLength Число, указывающее длину буфера данных.
Возвращаемые значения	OT_ERROR_NONE Данные успешно отправлены. OT_ERROR_NO_BUFS Не удалось выделить буферную память. OT_ERROR_INVALID_STATE TLS-соединение не было инициализировано.

otBleSecureSendApplicationTlv

otError otBleSecureSendApplicationTlv(
  otInstance *aInstance,
  uint8_t *aBuf,
  uint16_t aLength
)

Отправляет безопасный пакет данных BLE, содержащий TLV данных приложения отправки TCAT.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aBuf Указатель на данные для отправки в качестве значения TLV данных приложения отправки TCAT. [in] aLength Число, указывающее длину буфера данных.
Возвращаемые значения	OT_ERROR_NONE Данные успешно отправлены. OT_ERROR_NO_BUFS Не удалось выделить буферную память. OT_ERROR_INVALID_STATE TLS-соединение не было инициализировано.

otBleSecureSendMessage

otError otBleSecureSendMessage(
  otInstance *aInstance,
  otMessage *aMessage
)

Отправляет защищенное сообщение BLE.

Если возвращаемое значение — OT_ERROR_NONE, OpenThread становится владельцем aMessage , и вызывающая сторона больше не должна ссылаться на aMessage . Если возвращаемое значение не OT_ERROR_NONE, вызывающая сторона сохраняет право собственности на aMessage , включая освобождение aMessage если буфер сообщений больше не нужен.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aMessage Указатель на сообщение для отправки.

Подробности
Возвращаемые значения	OT_ERROR_NONE Сообщение успешно отправлено. OT_ERROR_NO_BUFS Не удалось выделить буферную память. OT_ERROR_INVALID_STATE TLS-соединение не было инициализировано.

otBleSecureSetCaCertificateChain

void otBleSecureSetCaCertificateChain(
  otInstance *aInstance,
  const uint8_t *aX509CaCertificateChain,
  uint32_t aX509CaCertChainLength
)

Устанавливает доверенные центры сертификации верхнего уровня.

Это необходимо для проверки сертификата узла.

Режим TLS «ECDHE ECDSA с AES 128 CCM 8» для безопасного BLE.

Примечание. Требуется MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1 .

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aX509CaCertificateChain Указатель на цепочку CA X509 в формате PEM. [in] aX509CaCertChainLength Длина цепочки.

отБлесекуресетсертификате

void otBleSecureSetCertificate(
  otInstance *aInstance,
  const uint8_t *aX509Cert,
  uint32_t aX509Length,
  const uint8_t *aPrivateKey,
  uint32_t aPrivateKeyLength
)

Устанавливает сертификат X509 локального устройства с соответствующим закрытым ключом для сеанса TLS с TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.

Примечание. Требуется MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1 .

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aX509Cert Указатель на сертификат X509 в формате PEM. [in] aX509Length Длина сертификата. [in] aPrivateKey Указатель на закрытый ключ в формате PEM. [in] aPrivateKeyLength Длина закрытого ключа.

отБлеСекуресетПск

void otBleSecureSetPsk(
  otInstance *aInstance,
  const uint8_t *aPsk,
  uint16_t aPskLength,
  const uint8_t *aPskIdentity,
  uint16_t aPskIdLength
)

Устанавливает предварительный общий ключ (PSK) и набор шифров TLS_PSK_WITH_AES_128_CCM_8.

Примечание. Требуется включить функцию времени сборки MBEDTLS_KEY_EXCHANGE_PSK_ENABLED .

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aPsk Указатель на PSK. [in] aPskLength Длина PSK. [in] aPskIdentity Идентификационное имя для PSK. [in] aPskIdLength Длина идентификатора PSK.

отБлесекуресетсслааутмоде

void otBleSecureSetSslAuthMode(
  otInstance *aInstance,
  bool aVerifyPeerCertificate
)

Устанавливает режим аутентификации для безопасного соединения BLE.

Отключите или включите проверку сертификата узла. Перед началом необходимо позвонить.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aVerifyPeerCertificate true, чтобы проверить сертификат узла.

otBleSecureStart

otError otBleSecureStart(
  otInstance *aInstance,
  otHandleBleSecureConnect aConnectHandler,
  otHandleBleSecureReceive aReceiveHandler,
  bool aTlvMode,
  void *aContext
)

Запускает службу BLE Secure.

Когда режим TLV активен, функция aReceiveHandler будет вызываться после получения полного TLV и смещение сообщения указывает на значение TLV.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aConnectHandler Указатель на функцию, которая будет вызываться при изменении состояния соединения. [in] aReceiveHandler Указатель на функцию, которая будет вызываться после получения данных по TLS-соединению. [in] aTlvMode Логическое значение, указывающее, должен ли быть активирован линейный режим. [in] aContext Указатель на произвольную контекстную информацию. Может быть NULL, если не используется.
Возвращаемые значения	OT_ERROR_NONE Сервер BLE Secure запущен успешно. OT_ERROR_ALREADY Услуга уже была указана.

otBleSecureStop

void otBleSecureStop(
  otInstance *aInstance
)

Останавливает сервер BLE Secure.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread.

отБлеСекуреТкатСтарт

otError otBleSecureTcatStart(
  otInstance *aInstance,
  const otTcatVendorInfo *aVendorInfo,
  otHandleTcatJoin aHandler
)

Включает протокол TCAT через BLE Secure.

Подробности
Параметры	[in] aInstance Указатель на экземпляр OpenThread. [in] aVendorInfo Указатель на информацию о поставщике (должен оставаться действительным после вызова метода, может иметь значение NULL). [in] aHandler Указатель на функцию, которая вызывается после завершения операции соединения.
Возвращаемые значения	OT_ERROR_NONE Роль BLE Secure Joiner успешно запущена. OT_ERROR_INVALID_ARGS aElevationPsk или aVendorInfo недействительны. OT_ERROR_INVALID_STATE Функция BLE не запущена или не выбран линейный режим.

Макросы

OT_TCAT_MAX_SERVICE_NAME_LENGTH

 OT_TCAT_MAX_SERVICE_NAME_LENGTH 15

Максимальная длина строки имени службы UDP или TCP (не включает нулевые символы).

Ресурсы

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