如何向BLE设备发送十六进制值？BLE时长参数写入问题求助

看起来你在给BLE设备传递十六进制时长参数时遇到了瓶颈——我之前处理过不少类似的BLE通信问题，大概率是字节序不匹配或者写入流程没走完整导致的。结合你的代码片段，给你梳理下可行的解决步骤：

1. 先确认特征的基础配置是否正确 #

首先要确保你操作的AppConstants.pulse_time特征是设备端专门用于接收时长参数的那个，并且具备写入权限：

• 检查特征的UUID是否和设备文档中指定的一致；
• 通过AppConstants.pulse_time.getProperties()确认是否包含BluetoothGattCharacteristic.PROPERTY_WRITE（你用的WRITE_TYPE_DEFAULT对应带响应的写入，要确保设备支持该模式）。

2. 正确转换时长为设备预期的十六进制字节数组 #

BLE特征的setValue方法用FORMAT_UINT16时，默认是小端字节序，但有些设备可能要求大端。如果之前的写法无效，建议手动构造字节数组来控制字节序，避免系统默认行为的差异：

比如你要传递时长3（十进制），对应的十六进制是0x0003：

• 如果设备用小端模式（多数BLE设备默认）：低字节在前，字节数组是{0x03, 0x00}
• 如果设备用大端模式：高字节在前，字节数组是{0x00, 0x03}

手动构造的代码示例：

// 假设你的目标时长是3秒
int targetDuration = 3;
byte[] durationBytes = new byte[2];

// 小端模式（优先尝试这个，多数设备用这个）
durationBytes[0] = (byte) (targetDuration & 0xFF);
durationBytes[1] = (byte) ((targetDuration >> 8) & 0xFF);

// 如果小端无效，换成大端模式
// durationBytes[0] = (byte) ((targetDuration >> 8) & 0xFF);
// durationBytes[1] = (byte) (targetDuration & 0xFF);

// 设置特征值
AppConstants.pulse_time.setValue(durationBytes);

3. 执行写入并监听回调结果 #

光设置特征值还不够，必须调用writeCharacteristic触发写入，并且在BluetoothGattCallback中确认写入是否成功：

完整流程代码：

// 1. 配置特征写入类型
AppConstants.pulse_time.setWriteType(BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT);

// 2. 构造时长字节数组（这里用小端示例）
int targetDuration = 3;
byte[] durationBytes = new byte[2];
durationBytes[0] = (byte) (targetDuration & 0xFF);
durationBytes[1] = (byte) ((targetDuration >> 8) & 0xFF);
AppConstants.pulse_time.setValue(durationBytes);

// 3. 发起写入请求
boolean writeInitiated = AppConstants.gatt.writeCharacteristic(AppConstants.pulse_time);
if (!writeInitiated) {
    Log.e("BLE", "写入请求发起失败，检查GATT连接状态");
}

// 4. 在BluetoothGattCallback中监听写入结果
@Override
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
    super.onCharacteristicWrite(gatt, characteristic, status);
    if (status == BluetoothGatt.GATT_SUCCESS) {
        Log.d("BLE", "时长参数写入成功！");
        // 这里可以触发设备运行的逻辑，或者等待设备的状态通知
    } else {
        Log.e("BLE", "写入失败，状态码：" + status);
        // 可以尝试重试写入，或者排查连接/特征权限问题
    }
}

4. 排查设备端的解析逻辑 #

如果写入成功但设备没按预期运行，那就要确认设备端是怎么解析这个参数的：

• 设备是把这个UINT16值直接作为时长（比如单位是秒、毫秒？）；
• 是否需要额外的指令前缀（比如有些设备需要先写入一个指令码，再写入时长值）；
• 设备是否要求时长参数是单字节（范围0-255）而非双字节的UINT16？

如果能拿到设备的通信文档，一定要对照文档里的字节格式来构造参数，这是最稳妥的方式。

内容的提问来源于stack exchange，提问作者Sudhansu Sekhar