说明

以下函数负责向存在连接的远程设备发送多个字符。该函数接收一个参数，该参数指示要传输的字节数。此函数在成功执行时返回零，而在出现错误时返回负值。根据 SPPLE 的设备角色是服务器还是客户端，调用的 API 函数为 GATT_Handle_Value_Notification 或 GATT_Write_Without_Response_Request；这两个函数分别通知接收额度特性或向传输额度特性发送无响应的写入数据包。

参数

LESend 需要两个参数。第一个是您要发送到的设备的远程蓝牙地址。第二个是要发送的字节数。该值必须大于 10。

命令调用示例

• “LeSend 0017E7FEFD7C 100”尝试向 0017E7FEFD7C 发送 100 字节的数据。
• “LeSend B8FFFEAF1CAD 25”尝试向 B8FFFEAF1CAD 发送 25 字节的数据。

可能的返回值

• (0) 成功发送了数据
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-67) BTPS_ERROR_RFCOMM_NOT_INITIALIZED
• (-85) BTPS_ERROR_SPP_NOT_INITIALIZED

API 调用

GATT_Handle_Value_Notification(BluetoothStackID, SPPLEServiceID, ConnectionID, SPPLE_TX_CHARACTERISTIC_ATTRIBUTE_OFFSET, (Word_t)DataCount, SPPLEBuffer)

或者

GATT_Write_Without_Response_Request(BluetoothStackID, ConnectionID, DeviceInfo->ClientInfo.Rx_Characteristic, (Word_t)DataCount, SPPLEBuffer)

API 原型

int BTPSAPI GATT_Handle_Value_Notification(unsigned int BluetoothStackID, unsigned int ServiceID, unsigned int ConnectionID, Word_t AttributeOffset, Word_tAttributeValueLength, Byte_t *AttributeValue)

或者

int BTPSAPI GATT_Write_Without_Response_Request(unsigned int BluetoothStackID, unsigned int ConnectionID, Word_t AttributeHandle, Word_t AttributeLength, void*AttributeValue)

API 说明

第一个 API 函数用于向远程 GATT 客户端发送句柄/值通知。此函数的第一个参数是本地蓝牙协议栈的 ID。第二个参数是发送句柄/值通知的服务的 ID。第三个参数指定接收句柄/值通知的连接的 ID。第四个参数指定正在通知的属性在服务表（通过调用 GATT_Register_Service() 函数注册）中的偏移量。第五个参数是正在通知的属性值的长度（以字节为单位）。第六个参数是指向要通知的实际属性值的指针。此函数返回一个非负值，该值表示已通知的属性值的实际长度；如果出现错误，则返回负的错误代码。

提供第二个 API 函数是为了能够针对指定的属性向远程设备执行无响应的写入请求。该函数的第一个参数是本地蓝牙协议栈的 ID，依次后跟所连接远程设备的连接 ID、要写入的属性的句柄、要写入的值数据的长度（以字节为单位）以及要写入的实际值。此函数返回成功写入的字节数或负的错误代码。