第4章 从回调中解析蓝牙数据：字节数组转换、协议解析、校验与异常处理

4.1 原理概述

蓝牙低功耗（BLE）的 notify 回调每次返回一个完整的 byte[] 包，但应用层通常需要从中提取结构化信息。解析链路包含三个核心环节：字节数组转换（Hex 可视化、子串提取）、协议解析（帧头/长度/命令/负载）、校验与异常处理（CRC/校验和/超时）。任何环节失败都可能导致数据丢弃或应用崩溃，因此必须建立容错机制。

4.2 实现流程

1. 字节数组 → 十六进制字符串：便于日志记录和边界检查。
2. 长度 & 帧头验证：检查最小包长、帧头魔数（如 0xAA）。
3. 协议解析：按字段偏移提取命令、序列号、数据负载。
4. 校验计算：对负载部分计算 CRC-8 或累加和，与包内校验值比对。
5. 异常处理：校验失败 → 丢弃+计数；解析越界 → 日志+重置状态机。

4.3 字节数组转换与协议解析（代码示例）

4.3.1 字节数组转十六进制字符串

public static String bytesToHex(byte[] bytes) {
    StringBuilder sb = new StringBuilder(bytes.length * 2);
    for (byte b : bytes) {
        sb.append(String.format("%02X", b & 0xFF));
    }
    return sb.toString();
}

4.3.2 协议帧定义与解析

假设自定义协议：帧头 0xAA (1B)、长度 (1B)、命令字 (1B)、数据负载 (N-3B)、校验和 (1B)。最小包长 4 字节。

public static class BlePacket {
    public byte cmd;
    public byte[] payload;
    public byte checksum;
}

public static BlePacket parsePacket(byte[] raw) throws IllegalArgumentException {
    if (raw == null || raw.length < 4) {
        throw new IllegalArgumentException("Packet too short");
    }
    if (raw[0] != (byte) 0xAA) {
        throw new IllegalArgumentException("Invalid frame header");
    }
    int length = raw[1] & 0xFF; // 期望负载长度
    if (length + 3 != raw.length) { // 帧头1+长度1+校验1 = 3
        throw new IllegalArgumentException("Length field mismatch");
    }
    BlePacket packet = new BlePacket();
    packet.cmd = raw[2];
    packet.payload = new byte[length];
    System.arraycopy(raw, 3, packet.payload, 0, length);
    packet.checksum = raw[raw.length - 1];
    return packet;
}

4.3.3 校验计算（累加和）

public static byte calcChecksum(byte[] data, int offset, int len) {
    int sum = 0;
    for (int i = offset; i < offset + len; i++) {
        sum += (data[i] & 0xFF);
    }
    return (byte) (sum & 0xFF);
}

// 使用示例
byte expected = calcChecksum(raw, 2, raw.length - 3);
if (expected != packet.checksum) {
    throw new SecurityException("Checksum mismatch: expected " + 
        String.format("%02X", expected) + 
        " but got " + String.format("%02X", packet.checksum));
}

4.4 调试方法

4.5 常见错误与处理

4.6 性能与稳定性优化

• 预分配缓冲区：避免在解析循环中频繁 new byte[]，使用 ByteArrayOutputStream 池或固定大小数组。
• 异常降级：校验失败时不抛出 RuntimeException，而是返回 null 并记录失败计数器，防止崩溃。
• 分包重组：若协议未保证一次回调完成一帧，需维护状态机合并字节缓存后再解析。

4.7 内联流程框图：蓝牙数据回调解析链路

4.8 完整解析调用示例

public void onCharacteristicChanged(BluetoothGatt gatt, 
                                    BluetoothGattCharacteristic characteristic) {
    byte[] data = characteristic.getValue();
    Log.d(TAG, "Raw hex: " + bytesToHex(data));
    try {
        BlePacket packet = parsePacket(data);
        byte checksum = calcChecksum(data, 2, data.length - 3);
        if (checksum != packet.checksum) {
            throw new SecurityException("Checksum mismatch");
        }
        // 成功解析，post到主线程存Room
        handler.post(() -> repository.insert(packet));
    } catch (IllegalArgumentException | SecurityException e) {
        Log.w(TAG, "Parse failed: " + e.getMessage());
    }
}