Files
glass/glass-mouse/docs/ble_probe_guide.md
T
admin 2840e82685 Initial commit: Android GlassMouse + iOS GlassRemote 智能眼镜遥控项目
包含本次会话修复:
- 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)
2026-08-26 10:34:23 +08:00

4.3 KiB
Raw Blame History

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(最直观,推荐)

  1. 眼镜进入可发现/配对态(设置里开蓝牙配对,或长按配对键;若已和官方 App 配对,先忽略该配对让眼镜可被发现)。
  2. 手机装 nRF Connect,扫描,找 INMO 设备。
  3. 连接 → 展开 GATT,记录三个 e49a… UUID 各自属性(WRITE / READ / NOTIFY)。
  4. 在 WRITE 特征用 HEX 模式写入测试字节(见下方「测试字节」),看眼镜是否点击。
    • 动了 → 协议通,无加密、无绑定阻塞(最佳情况,直接能写 Mac App)。
    • 没动 → 看 READ/NOTIFY 回什么(可能 UNSUPPORTED_CMD / 绑定错误 / 加密错误)。
  5. 顺手测一下:先写 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 前先告诉我是否要一起补上。