Concitech AI · 深度长文
2026/11/07 06:29
Claude Code助攻AirPods 3变鼠标!Linux项目开源,突破口是蓝牙MTU
MousePods作者借助Claude Code梳理AirPods 3头部追踪协议,项目公开RemoteHID文档、源码与抓包。蓝牙接收MTU从672字节改为2582字节,运动传感器公告出现。约210Hz属于项目方测量,硬件兼容性与游戏体验具有验证边界。
一副AirPods 3,成了Linux电脑的鼠标输入设备。
开源项目MousePods读取耳机运动数据,计算头部姿态与转动,控制层映射这些动作为光标移动。项目提供了源码、协议文档、抓包文件与本地控制界面。
作者Matteo Gaudioso(starman-tech)介绍,Claude Code承担代码编写、资料检索与协议探索,他负责耳机操作、硬件测试和方案判断。作者给出的研发耗时是一下午;README回顾了约300次失败尝试。原始帖子
这件事的技术价值,包含两项发现:AirPods 3采用另一条运动数据协议;Linux连接的接收MTU影响传感器公告。
项目地址:github.com/starman-tech/mousepods
耳机已有传感器,缺口是数据通道
AirPods 3的空间音频功能包含动态头部追踪。苹果的产品规格介绍了这项功能,以及运动检测加速度传感器。Apple产品规格
MousePods的目标,是连接这些运动数据与Linux输入系统。
项目文档记录,AirPods Pro 2等设备采用SensorDataWX。相同启动方式缺少AirPods 3的有效回复,传感器硬件的存在与协议兼容性形成了落差。
作者的线索来自iOS的RemoteHID.framework伪代码,以及相关开源分析。AirPods 3的通道是RemoteHID,运动传感器表现为虚拟HID设备,通信承载于AACP协议的RTBuddy 0x800通道。
HID是键盘、鼠标等输入设备采用的一类描述方式。这里的HID设备是耳机中的传感器服务,主机读取设备描述、请求数据报告。项目协议文档
协议识别解决了“怎样对话”,另一个问题是“主机看到了哪些设备”。
672与2582:一个接收参数,改变设备可见性
MTU指最大传输单元。这个案例的关键参数,是L2CAP连接的接收MTU,即主机接收数据单元的尺寸上限。
项目报告,测试环境的默认接收MTU为672字节。这个设置对应的设备公告包含3项服务,运动传感器缺席。2582字节设置对应的公告增加了devmotion6、gyro、accel等服务。
原因涉及公告长度:运动融合服务devmotion6的一条公告占833字节,超过672字节。2582字节的接收空间容纳了这条公告。发现记录
本文的静态解码对象是仓库中的两份十六进制抓包文件,结果如下:
| 接收MTU | 文件中的设备公告 | 运动融合服务devmotion6 |
|---|---|---|
| 672字节 | 3条 | 缺席 |
| 2582字节 | 8条 | 出现,公告833字节 |
这项核对确认了文件内容与文档描述的对应关系。耳机的真实行为与其他环境的兼容性,需要硬件复测。
软件报告“设备缺席”,原因包含通信条件。硬件功能与主机可见性,是两个问题。
![]()
图1:MousePods文档与公开抓包的中文重绘图。原始发现:Matteo Gaudioso(starman-tech),CC BY 4.0;本文增加中文解释与流程归纳。
读到数据之后,怎样变成鼠标?
MousePods的通信顺序是主机发送HostConnect,耳机返回DeviceConnect公告,主机发送SetReport配置报告间隔,耳机输出InputReport。
程序解码运动数据块,提取旋转速度、重力与姿态信息。运动计算层处理坐标轴、校准和陀螺仪偏置,控制层生成鼠标事件,/dev/uinput负责虚拟输入设备。
这条链路支持Wayland与X11。项目的运行前提包括Linux、BlueZ、完成配对与连接的AirPods,以及用户的/dev/uinput写权限。
项目提供3种控制模式。鼠标模式的输入是转动,输出是光标运动;指向模式采用角点校准;耳机的桌面位移,构成滑动模式的输入。模式的验证程度存在差别。
![]()
图2:项目提供的界面截图,展示姿态、光标与角速度。来源:MousePods by Matteo Gaudioso(starman-tech),CC BY 4.0;本文调整显示尺寸。界面标签属于软件状态,项目说明定义硬件支持范围。
约210Hz,是传感器数据率
项目文档报告了约210Hz的最高测得数据率。这个数字描述传感器数据,鼠标端到端延迟、光标渲染频率与游戏体验属于其他指标。
高数据率存在代价。作者记录的一组共享蓝牙链路测试,数据率为约180Hz,23秒包含12次超过50毫秒的间隔。程序采用100Hz的默认请求设置,意图降低链路中断。
数据率与稳定性构成取舍,峰值数据率与持续使用体验,属于不同的评价对象。
README的验证表包含这些限制:
- AirPods 3与AirPods Pro 2的运动流具有项目方硬件验证,其他型号需要对应测试。
- 鼠标模式具有硬件试用记录,指向模式的角点校准验证来自模拟。
- 桌面滑动模式属于实验功能,滚动、漂移与传感器休眠影响结果。
- 模拟器方向提供opentrack与虚拟摇杆输出;数据格式和角度计算具有测试,游戏内体验缺少项目方实测。
- AirPods 3的充电盒内传感器处于关闭状态,“充电盒变鼠标”缺少硬件支持。
模拟器输出提供旋转方向,属于3个旋转自由度;身体前后左右的平移需要另一类测量。支持状态
Claude Code的作用,是缩短线索与实验的距离
原帖的故事包含一个分工:AI检索开源项目、分析框架代码、生成协议实现,人操作真实耳机、观察结果、选择后续实验。
公开材料让这个故事具有检查入口。仓库保存了成功配置、失败尝试与原始抓包,源码中的接收MTU、协议封装和报告启动逻辑,对应文档中的解释。
这份记录保留了一项待解问题:Apple PnP DeviceID与重新配对发生于首次成功之前,这些条件的独立作用需要隔离实验。MTU的作用具有对照抓包,完整的最小成功条件需要后续确认。
我的判断是,这类项目的AI价值体现在搜索范围与试验组织。成功的标志是模型给出的解释获得数据支持,公开代码与记录提供复核条件。
本文核对了源码、文档与两份公告抓包,缺少AirPods硬件实测。项目的鼠标精度、持续使用体验与更多型号兼容性,属于待验证结果。
MousePods的代码采用Apache-2.0,文档与抓包采用CC BY 4.0。本文介绍的是社区项目,Apple官方产品支持属于另一种性质。MousePods仓库与许可
