Google 致力于为黑人社区推动种族平等。查看具体行动。

此页面由 Cloud Translation API 翻译。

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 上提供的源代码。如需了解详情，或者为我们的文档做贡献，请参阅资源。

BLE 安全

摘要

枚举

类型定义符

函数

结构体

枚举

otTcatApplicationProtocol

otTcatCommandClass

otTcatStatusCode

类型定义符

otHandleBleSecureConnect

otHandleBleSecureReceive

otHandleTcatApplicationDataReceive

otHandleTcatJoin

otTcatApplicationProtocol

otTcatCommandClass

otTcatStatusCode

otTcatVendorInfo

函数

otBleSecureConnect

otBleSecureDisconnect

otBleSecureFlush

otBleSecureGetPeerCertificateBase64

otBleSecureGetPeerSubjectAttributeByOid

otBleSecureGetThreadAttributeFromOwnCertificate

otBleSecureGetThreadAttributeFromPeerCertificate

otBleSecureIsCommandClassAuthorized

otBleSecureIsConnected

otBleSecureIsConnectionActive

otBleSecureIsTcatEnabled

otBleSecureSend

otBleSecureSendApplicationTlv

otBleSecureSendMessage

otBleSecureSetCaCertificateChain

otBleSecureSetCertificate

otBleSecureSetPsk

otBleSecureSetSslAuthMode

otBleSecureStart

otBleSecureStop

otBleSecureTcatStart

宏

OT_TCAT_MAX_SERVICE_NAME_LENGTH

资源