BLE 安全

此模块包含用于控制 BLE 安全（基于 BLE 的 TLS）通信的功能。

摘要

此模块包含用于实现 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)	typedef void(* 要在安全连接状态发生更改时调用的指针。
otHandleBleSecureReceive	typedef otHandleTcatApplicationDataReceive 通过 BLE 安全 TLS 连接接收数据时要调用的指针。
otHandleTcatApplicationDataReceive)(otInstance *aInstance, const otMessage *aMessage, int32_t aOffset, otTcatApplicationProtocol aTcatApplicationProtocol, const char *aServiceName, void *aContext)	typedef void(* 通过 TCAT TLS 连接接收应用数据时调用的指针。
otHandleTcatJoin)(otError aError, void *aContext)	typedef void(* 用于通知联接操作完成的调用指针。
otTcatApplicationProtocol	typedef enum otTcatApplicationProtocol 表示 TCAT 应用协议。
otTcatCommandClass	typedef enum otTcatCommandClass 表示 TCAT 命令类。
otTcatStatusCode	typedef enum otTcatStatusCode 表示 TCAT 状态代码。
otTcatVendorInfo	typedef struct otTcatVendorInfo 此结构表示 TCAT 供应商信息。

函数
otBleSecureConnect(otInstance *aInstance)	otError 初始化与使用已打开的 BLE 连接的对等方的 TLS 会话。
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 返回由对等 x509 证书主题的 OID 标识的属性值。
otBleSecureGetThreadAttributeFromOwnCertificate(otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength)	otError 返回自身 x509 证书的 v3 扩展中的 OID 1.3.6.1.4.1.44970.x 的属性值，其中最后一位数 x 设置为 aThreadOidDescriptor。
otBleSecureGetThreadAttributeFromPeerCertificate(otInstance *aInstance, int aThreadOidDescriptor, uint8_t *aAttributeBuffer, size_t *aAttributeLength)	otError 返回对等 x509 证书的 v3 扩展的 OID 1.3.6.1.4.1.44970.x 的属性值，最后一位数 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 发送包含 TCAT 发送应用数据 TLV 的安全 BLE 数据包。
otBleSecureSendMessage(otInstance *aInstance, otMessage *aMessage)	otError 发送安全的 BLE 消息。
otBleSecureSetCaCertificateChain(otInstance *aInstance, const uint8_t *aX509CaCertificateChain, uint32_t aX509CaCertChainLength)	void 设置可信顶级 CA。
otBleSecureSetCertificate(otInstance *aInstance, const uint8_t *aX509Cert, uint32_t aX509Length, const uint8_t *aPrivateKey, uint32_t aPrivateKeyLength)	void 通过 TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 使用 TLS 会话的相应私钥设置本地设备的 X509 证书。
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 安全服务器。
otBleSecureTcatStart(otInstance *aInstance, const otTcatVendorInfo *aVendorInfo, otHandleTcatJoin aHandler)	otError 启用基于 BLE 安全的 TCAT 协议。

结构体
otTcatVendorInfo	此结构表示 TCAT 供应商信息。

枚举

otTcatApplicationProtocol

 otTcatApplicationProtocol

表示 TCAT 应用协议。

属性
OT_TCAT_APPLICATION_PROTOCOL_NONE	在未启用 TCAT 代理的情况下发送的消息。
OT_TCAT_APPLICATION_PROTOCOL_STATUS	定向到 UDP 服务的消息。
OT_TCAT_APPLICATION_PROTOCOL_TCP	定向到 TCP 服务的消息。

otTcatCommandClass

 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

 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 的值存在错误。

类型定义符

otHandleBleSecureConnect

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

要在安全连接状态发生更改时调用的指针。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aConnected 如果建立了安全连接，则为 TRUE，否则为 FALSE。 [in] aBleConnectionOpen 如果建立了 BLE 连接以传输 TLS 数据流，则为 TRUE，否则为 FALSE。 [in] aContext 指向任意上下文信息的指针。

otHandleBleSecureReceive

otHandleTcatApplicationDataReceive otHandleBleSecureReceive

通过 BLE 安全 TLS 连接接收数据时要调用的指针。

otHandleTcatApplicationDataReceive

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 应用协议。

otTcatCommandClass

enum otTcatCommandClass otTcatCommandClass

表示 TCAT 命令类。

otTcatStatusCode

enum otTcatStatusCode otTcatStatusCode

表示 TCAT 状态代码。

otTcatVendorInfo

struct otTcatVendorInfo otTcatVendorInfo

此结构表示 TCAT 供应商信息。

在运行 TCAT 会话时，此结构的内容必须保持不变。

函数

otBleSecureConnect

otError otBleSecureConnect(
  otInstance *aInstance
)

初始化与使用已打开的 BLE 连接的对等方的 TLS 会话。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。
返回值	OT_ERROR_NONE 已成功启动 TLS 连接。

otBleSecureDisconnect

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
)

返回由对等 x509 证书主题的 OID 标识的属性值。

对等 OID 以二进制格式提供。如果属性读取成功，则设置属性长度；如果读取失败，则设置零。如果属性被成功读取，则按照 ITU-T X.690 标准中定义的 ASN.1 类型进行设置。

注意：需要启用构建时功能 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
)

返回自身 x509 证书的 v3 扩展中的 OID 1.3.6.1.4.1.44970.x 的属性值，其中最后一位数 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
)

返回对等 x509 证书的 v3 扩展的 OID 1.3.6.1.4.1.44970.x 的属性值，最后一位数 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 命令类未获得授权。

otBleSecureIsConnected

bool otBleSecureIsConnected(
  otInstance *aInstance
)

指示是否已连接 TLS 会话。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。
返回值	TRUE TLS 会话已连接。 FALSE TLS 会话未连接。

otBleSecureIsConnectionActive

bool otBleSecureIsConnectionActive(
  otInstance *aInstance
)

指示 TLS 会话是否处于活跃状态（已连接或正在连接）。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。
返回值	TRUE 是否启用 TLS 会话。 FALSE 如果 TLS 会话未处于活动状态。

otBleSecureIsTcatEnabled

bool otBleSecureIsTcatEnabled(
  otInstance *aInstance
)

指明 TCAT 代理是否已启用。

具体说明
返回值	TRUE TCAT 代理已启用。 FALSE TCAT 代理未启用。

otBleSecureSend

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

发送安全的 BLE 数据包。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aBuf 指向要作为 TCAT 发送应用数据 TLV 的值发送的数据的指针。 [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
)

发送包含 TCAT 发送应用数据 TLV 的安全 BLE 数据包。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aBuf 指向要作为 TCAT 发送应用数据 TLV 的值发送的数据的指针。 [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
)

设置可信顶级 CA。

验证对等方的证书需要它。

用于安全 BLE 的 TLS 模式“ECDHE ECDSA with AES 128 CCM 8”。

注意：需要 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aX509CaCertificateChain 指向 PEM 格式的 X509 CA 链的指针。 [in] aX509CaCertChainLength 链的长度。

otBleSecureSetCertificate

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

通过 TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 使用 TLS 会话的相应私钥设置本地设备的 X509 证书。

注意：需要 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED=1。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aX509Cert 指向 PEM 格式的 X509 证书的指针。 [in] aX509Length 证书的长度。 [in] aPrivateKey 指向 PEM 格式的私钥的指针。 [in] aPrivateKeyLength 私钥的长度。

otBleSecureSetPsk

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 身份长度。

otBleSecureSetSslAuthMode

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 模式处于活动状态时，在收到完整 TLV 并且消息偏移量指向 TLV 值后，系统会调用函数 aReceiveHandler。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aConnectHandler 指向在连接状态更改时调用的函数的指针。 [in] aReceiveHandler 指向通过 TLS 连接接收数据后调用的函数的指针。 [in] aTlvMode 指示是否应激活线条模式的布尔值。 [in] aContext 指向任意上下文信息的指针。如果未使用，可为 NULL。
返回值	OT_ERROR_NONE 已成功启动 BLE 安全服务器。 OT_ERROR_ALREADY 已经声明过这项服务。

otBleSecureStop

void otBleSecureStop(
  otInstance *aInstance
)

停止 BLE 安全服务器。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。

otBleSecureTcatStart

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

启用基于 BLE 安全的 TCAT 协议。

具体说明
参数	[in] aInstance 指向 OpenThread 实例的指针。 [in] aVendorInfo 指向供应商信息的指针（在方法调用后必须保持有效，可以是 NULL）。 [in] aHandler 指向联接操作完成时调用的函数的指针。
返回值	OT_ERROR_NONE 已成功启用 BLE 安全联接者角色。 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 服务名称的最大字符串长度（不包括 null 字符）。

资源

OpenThread API 参考文档源自 GitHub 上提供的源代码。如需了解详情，或者为我们的文档做贡献，请参阅资源。