Galaxy Buds RFComm 通信协议深度解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00470/article/details/148549129

Galaxy Buds RFComm 通信协议深度解析

GalaxyBudsClient Unofficial Galaxy Buds Manager for Windows, macOS, and Linux 项目地址: https://gitcode.com/gh_mirrors/gal/GalaxyBudsClient

协议概述

Galaxy Buds 系列无线耳机通过蓝牙 RFComm 协议与客户端设备进行通信，这套协议定义了耳机与客户端之间的数据交换格式和交互逻辑。本文将详细解析这套通信协议的结构、消息类型及其功能实现。

数据包结构

基本数据包格式

Galaxy Buds 的通信数据包采用固定格式，分为非分片和分片两种类型：

非分片数据包结构：

| 字段名 | 值(十六进制) | 大小 | 说明 | |--------------|--------------|----------|----------------------------------------------------------------------| | 前导码 | FE | 1字节 | 标识数据包开始 | | 类型 | 0x | 1字节 | 0表示请求，1表示响应 | | 负载大小 | xx | 1字节 | 负载部分的总大小 | | 消息ID | xx | 1字节 | 标识消息类型 | | 消息负载 | ... | 动态大小 | 实际数据内容，大小为：负载大小 - 1字节(消息ID) - 2字节(CRC) | | 校验和 | xx xx | 2字节 | CRC16-CCITT算法计算的校验和，覆盖消息ID和内容 | | 后导码 | EE | 1字节 | 标识数据包结束 |

分片数据包：用于大容量数据传输(如固件OTA、核心转储等)，本文暂不展开讨论。

消息类型详解

发送消息类型

1. 时间同步(MSG_ID_UPDATE_TIME)

用于同步客户端设备的时间到耳机：

| 索引 | 字段名 | 说明 | 大小 | |------|-----------|-------------------------------|--------| | 0 | 时间戳 | 1970年以来的毫秒数(长整型) | 8字节 | | 8 | 时区偏移 | 需要添加的毫秒数(整型) | 4字节 |

2. 设备信息(MSG_ID_MANAGER_INFO)

向耳机报告客户端设备信息：

| 索引 | 字段名 | 说明 | 大小 | |------|-----------------|-------------------------------|--------| | 0 | 固定值 | 始终为1 | 1字节 | | 1 | 是否为三星设备 | 1=三星设备，2=其他设备 | 1字节 | | 2 | Android版本 | Android SDK版本号 | 1字节 |

此消息可能用于启用手机专属功能。

3. 均衡器设置(MSG_ID_EQUALIZER)

控制耳机的均衡器设置：

| 索引 | 字段名 | 说明 | 大小 | |------|---------|---------------------|--------| | 0 | 启用 | 0=禁用，1=启用 | 1字节 | | 1 | 预设 | 0-10之间的预设值 | 1字节 |

预设值对应表：

| 预设ID | 描述 | |--------|--------------------------| | 0 | 低音增强(Dolby优化) | | 1 | 柔和(Dolby优化) | | 2 | 动态(Dolby优化) | | 3 | 清晰(Dolby优化) | | 4 | 高音增强(Dolby优化) | | 5 | 低音增强 | | 6 | 柔和 | | 7 | 动态 | | 8 | 清晰 | | 9 | 高音增强 |

4. 触摸板锁定(MSG_ID_LOCK_TOUCHPAD)

锁定/解锁耳机触摸板：

| 索引 | 字段名 | 说明 | 大小 | |------|---------|---------------------|--------| | 0 | 启用 | 0=解锁，1=锁定 | 1字节 |

5. 环境音模式(MSG_ID_SET_AMBIENT_MODE)

控制环境音模式：

| 索引 | 字段名 | 说明 | 大小 | |------|---------|---------------------|--------| | 0 | 启用 | 0=禁用，1=启用 | 1字节 |

6. 触摸板选项设置(MSG_ID_SET_TOUCHPAD_OPTION)

自定义触摸板操作：

| 索引 | 字段名 | 说明 | 大小 | |------|--------------|-------------------------------|--------| | 0 | 左耳选项 | 左耳触摸操作ID | 1字节 | | 1 | 右耳选项 | 右耳触摸操作ID | 1字节 |

可用操作选项：

| ID | 描述 | |-----|-------------------------------| | 0 | 语音助手 | | 1 | 快速环境音 | | 2 | 音量控制(左=减，右=增) | | 3 | 环境音 | | 4 | Spotify SpotOn(需客户端支持) | | 5 | 其他...(仅左耳) | | 6 | 其他...(仅右耳) |

接收消息类型

1. 扩展状态更新(MSG_ID_EXTENDED_STATUS_UPDATED)

耳机发送的详细状态信息：

| 索引 | 字段名 | 说明 | 大小 | |------|---------------------|-------------------------------------------|--------| | 0 | 版本号 | 1或2，也用于检查新环境音模块 | 1字节 | | 1 | 耳机类型 | 未使用 | 1字节 | | 2 | 左耳电量 | 0-100% | 1字节 | | 3 | 右耳电量 | 0-100% | 1字节 | | 4 | TWS状态 | 0或1，配对设备状态 | 1字节 | | 5 | 主连接 | 0=右耳，1=左耳 | 1字节 | | 6 | 佩戴状态 | 0=未戴，1=左耳，16=右耳，17=双耳 | 1字节 | | 7 | 环境音启用 | 0=禁用，1=启用 | 1字节 | | 8 | 环境音类型 | 0=默认，1=语音聚焦 | 1字节 | | 9 | 环境音音量 | 1-5级 | 1字节 | | 10 | 均衡器启用 | 0=禁用，1=启用 | 1字节 | | 11 | 均衡器类型 | 0-10之间的预设值 | 1字节 | | 12 | 动态字段 | 触摸锁定状态+单选项(如果字节13未使用) | 1字节 | | 13 | 动态字段(可选) | 触摸选项(左右耳) | 1字节 |

2. 状态更新(MSG_ID_STATUS_UPDATED)

耳机发送的基本状态信息：

| 索引 | 字段名 | 说明 | 大小 | |------|---------------|-------------------------------------------|--------| | 0 | 耳机类型 | 未使用 | 1字节 | | 1 | 左耳电量 | 0-100% | 1字节 | | 2 | 右耳电量 | 0-100% | 1字节 | | 3 | TWS状态 | 0或1，配对设备状态 | 1字节 | | 4 | 主连接 | 0=右耳，1=左耳 | 1字节 | | 5 | 佩戴状态 | 0=未戴，1=左耳，16=右耳，17=双耳 | 1字节 |

协议交互流程

状态更新流程：
- 耳机发送状态更新消息(MSG_ID_EXTENDED_STATUS_UPDATED或MSG_ID_STATUS_UPDATED)
- 客户端应返回相同的消息(类型改为响应)
- 随后客户端应发送设备信息(MSG_ID_MANAGER_INFO)
命令响应流程：
- 客户端发送命令请求
- 耳机返回响应消息(MSG_ID_RESP)，包含：
  - 原始消息ID
  - 结果代码(0=成功)
  - 可选额外数据