包含本次会话修复: - iOS clickReady 警告 bug(默认 false 永远显示) - BLE 'handle is invalid' 排查(stale handle auto-retry 实验 + 回退) 项目结构: - glass-mouse/: 眼镜端原生 Kotlin App,前台服务 MouseService + 自定义 BLE GATT 桥接 ProxyBleServer + 无障碍 GestureDescription 注入 - ios/GlassRemote/: iPhone 端 SwiftUI + CoreBluetooth,通过 BLE 直连眼镜 - HTTP 投屏服务(:8000) 接 PPT/WPS 备注宏 POST 推送 技术栈: Android Kotlin (gradle 8.14.4, compileSdk 34), iOS Swift 5.10 (Xcode 26.5)
4.3 KiB
4.3 KiB
INMO 眼镜 BLE 协议实测手册
目的:在写 Mac 蓝牙 App 之前,先用工具确认三件事。这一步不过,写 App 就是赌博。 配套脚本:
ble_scan.py(Mac 跑,bleak);编码器:inmo_proto.py(生成测试字节)。
要确认的「三道坎」
| # | 待确认 | 决定了什么 |
|---|---|---|
| 1 | e49a25e0 / 25f8 / 28e1 哪个是 service / WRITE / READ(NOTIFY) |
我们往哪个特征 write 指令、从哪个收响应 |
| 2 | 连接/写入时是否要求配对或返回加密错误 | dex 有 HMAC-SHA256 线索;若加密,第三方直连需先逆向密钥 |
| 3 | 连上后直接 write 一个 ControlCommand,眼镜有无反应 | BleConnectBind 绑定鉴权是否阻塞指令(绑了别的账号就拒) |
三个候选 UUID(同一 128-bit base …f69a-11e8-8eb2-f2801f1b9fd1):
e49a25e0-f69a-11e8-8eb2-f2801f1b9fd1
e49a25f8-f69a-11e8-8eb2-f2801f1b9fd1
e49a28e1-f69a-11e8-8eb2-f2801f1b9fd1
方法 A:Android 手机 + nRF Connect(最直观,推荐)
- 眼镜进入可发现/配对态(设置里开蓝牙配对,或长按配对键;若已和官方 App 配对,先忽略该配对让眼镜可被发现)。
- 手机装 nRF Connect,扫描,找 INMO 设备。
- 连接 → 展开 GATT,记录三个
e49a…UUID 各自属性(WRITE / READ / NOTIFY)。 - 在 WRITE 特征用 HEX 模式写入测试字节(见下方「测试字节」),看眼镜是否点击。
- 动了 → 协议通,无加密、无绑定阻塞(最佳情况,直接能写 Mac App)。
- 没动 → 看 READ/NOTIFY 回什么(可能
UNSUPPORTED_CMD/ 绑定错误 / 加密错误)。
- 顺手测一下:先写
switch_mouse_mode()字节再写鼠标事件,看是否必须先切鼠标模式。
测试字节(在本机生成,别手敲)
cd glass-mouse
python3 -c "
import inmo_proto, binascii
print('mouse_mode:', binascii.hexlify(inmo_proto.switch_mouse_mode()).decode())
for i,b in enumerate(inmo_proto.mouse_click(0.5,0.5)):
print(f'click[{i}]:', binascii.hexlify(b).decode())
for i,b in enumerate(inmo_proto.key_press(inmo_proto.KEY_HOME)):
print(f'home[{i}]:', binascii.hexlify(b).decode())
"
把 click[0] 和 click[1] 的 HEX 依次写入 WRITE 特征(DOWN 后 UP)。
方法 B:Mac + ble_scan.py
cd glass-mouse
pip install bleak
# 1) 扫描,找眼镜 MAC(名字含 INMO / 出现 e49a… 广播 UUID)
python3 ble_scan.py scan
# 2) 连接枚举 GATT,确认 UUID 角色 + 属性
python3 ble_scan.py explore <眼镜MAC地址>
- 若
explore报not paired/encryption required→ 记下来,说明有鉴权/加密(坎 #2 命中)。 - 打印出的
props=write|notify等直接回答坎 #1。
⚠️ 本机(WorkBuddy 沙箱)的 BLE 不可用(扫描会 exit 137),脚本必须在你自有 Mac 终端跑。
回报清单(把结果贴回来,我据此写 Mac App)
1. 眼镜设备名 / MAC:________________
2. 三个 e49a… UUID 各自的角色与属性:
service = ________________ (props: ___)
WRITE = ________________ (props: write?)
READ = ________________ (props: read/notify?)
3. 连接是否要求配对/加密:是 / 否(报错原文:________)
4. 直接 write click 字节后眼镜反应:动了 / 没动(NOTIFY 回了:________)
5. 是否必须先 write switch_mouse_mode 才响应鼠标:是 / 否
判定
- 全开放(无加密、无绑定阻塞) → 直接写 Mac BLE App(Swift + CoreBluetooth),眼镜无需装 App,系统原生处理鼠标/按键。最优路径。
- 有加密/绑定鉴权 → 需先逆向密钥或绑定流程(抓包 + jadx 看
encryptToken/secretKey/userAccount),工作量升级;届时再评估是否回退到"稳网络 + 眼镜端 App"方案。 - 眼镜根本不广播/不可连 → 蓝牙路走不通,专心把 WS 网络做稳(自动重连 + 心跳)即可。
顺带:网络不稳的另一半
即便走蓝牙,也建议给现有 WS 补 自动重连 + 心跳(controller.html + MouseService)。当前 WS 断一次就一直断,很可能是你"感觉不稳定"的主因。这条和蓝牙互不冲突,可并行做——决定写 Mac App 前先告诉我是否要一起补上。