给英菲克(INPHIC)无线鼠标加一个任务栏电量显示。支持 IN10(设备主动上报)与 IN9(Feature Report 主动查询)两代。
不修改原厂驱动、不注入原厂软件、不写入设备——只是监听鼠标本来就每 2 秒主动发出的电量报告,然后画在托盘上。
托盘里的实际效果:
不同电量下的显示:
原厂配置工具 INPHIC HUB 只在它自己的界面里显示电量,而且必须打开软件、点进设备页才看得到。托盘不显示电量,关掉程序就什么都不知道了。
Windows 自带的"蓝牙设备电量"对 2.4G 接收器无效,所以只能自己做一个。
| 特性 | 说明 |
|---|---|
| 电量图标 | 鼠标轮廓按电量从下往上填充 |
| 配色 | 青绿 #19fac6(>40%)/ 黄(16–40%)/ 红(≤15%) |
| 离线检测 | 8 秒收不到上报 → 整只灰显,悬停仍显示最后一次电量 |
| 连接方式 | 详情里标注 USB / 蓝牙(BLE) |
| 详情浮层 | 非模态,不抢焦点,4 秒自动消失 |
| 开机自启 | 注册表启动项,菜单里可开关 |
| 多设备 | IN10 扫 9 组 VID/PID;IN9 扫 248A,两代可同时显示 |
| 双协议 | IN10 被动监听 Input Report;IN9 主动查 Feature Report(0x0C) |
| 零依赖 | 单文件 exe,不需要 .NET SDK / 运行时安装 |
| 状态 | 图标 | 悬停提示 |
|---|---|---|
| 在线 | 青绿按电量填充 | 英菲克 电量 87% (2000ms 刷新) |
| 离线 | 整体灰显 | 英菲克:已断开 / 已关机(最后 87%,21:12:03) |
| 未检测到 | 灰显 | 英菲克:未检测到设备 |
- 下载
InphicBatteryTray.exe - 放到一个固定目录(比如
%LOCALAPPDATA%\InphicBatteryTray\) - 双击运行,托盘出现图标
- 右键图标 → 勾选「开机自动启动」
建议不要放在原厂软件目录里——卸载或重装 INPHIC HUB 时可能被一起删掉,开机自启就失效了。
见下方编译。
托盘图标:
| 操作 | 效果 |
|---|---|
| 悬停 | 显示电量与刷新间隔 |
| 右键 | 菜单:显示详情 / 重新扫描设备 / 开机自动启动 / 退出 |
| 双击 | 显示详情浮层 |
| 点击浮层 | 立即关闭(否则 4 秒后自己消失,鼠标停留则保持) |
原厂软件是纯用户态程序,用 hidapi 走 HID Output/Input Report,没有内核驱动。本工具直接用 Windows 的 hid.dll + setupapi.dll 枚举和读取,连 hidapi.dll 都不需要。
关键点:用 FILE_SHARE_READ | FILE_SHARE_WRITE 共享方式打开。HID 输入报告会复制给所有打开该接口的句柄,所以本工具可以和原厂软件同时运行,互不干扰。
电量走在 Usage Page 0x000A 那个接口上(注意不是 64 字节的厂商通道),固定 5 字节:
偏移 0 1 2 3 4
0x03 设备类型码 子命令 设备号 数据
| 字节 | 含义 |
|---|---|
[0] |
固定 0x03(Report ID) |
[1] |
设备类型码:0x95 / 0x90 / 0x93 / 0x99 / 0x98 / 0x73 |
[2] |
子命令:0x10 连接/设备号、0x20 状态、0x40 电量、0x50 充电 |
[3] |
设备号 1..7 |
[4] |
数据,电量时是 0..100 |
实测样本:
03 98 40 01 64 → 设备类型 0x98,电量报告,设备 #1,电量 0x64 = 100%
| 项目 | 实测值 |
|---|---|
| 方向 | 设备主动推送,主机全程不发查询 |
| 周期 | ≈2000 ms,抖动 ±60ms |
| 精度 | 整数百分比(1% 粒度),无小数、无电压/ADC 字段 |
| 关机行为 | 直接静默,不发任何"我要下线"通知 |
| 其它子命令 | 本机所有场景(开关机、插拔)均未触发过 0x10/0x20/0x50 |
最后两条是离线检测只能靠超时的原因:设备不会告诉你它走了,只能靠"沉默 8 秒"推断。
上报周期 2 秒,8 秒 = 连续漏掉 4 帧,不会因为一次抖动误判,也不至于关机后太久才变灰。
不是问设备,是看 HID 接口路径:蓝牙设备走 BTHENUM 路径,其余判为 USB。这和厂商自己的做法一致(原厂软件靠 VID 区分不同连接模式)。
托盘图标是运行时用 GDI+ 逐像素画的,不是预先做好的图片:
- 把
MouseIcon.png缩放到系统实际图标尺寸(通常 16×16) - 找 alpha 边缘,把最外圈强行描成深色实线——16px 下描边本来只有半个像素,不这样会糊成一团
- 识别"绿色主体"像素(
G - R > 45 && G - B > 45),按电量高度替换成状态色或灰色 - 描边、滚轮、顶部按键保持原色
这样即使只有 16×16,也能看出是鼠标而不是一个色块。
IN9 和 IN10 完全不通用,连传输方式都不一样:
| 项目 | IN10 | IN9 |
|---|---|---|
| 传输 | Input Report,设备主动推 | Feature Report(HidD_SetFeature / HidD_GetFeature) |
| 报告 ID | 0x03(状态)/ 0x04(配置) |
0x0C |
| 帧长 | 5 字节 | 33 字节 |
| 电量怎么来 | 被动收,每 2 秒一帧 | 主机发 0x20 主动查 |
| 电量位置 | 第 5 字节 | 响应 buf[0x12] |
| VID/PID | 1D57 / 045E 共 9 组 |
248A:5B2E(有线)/ 248A:5B2F(2.4G) |
IN9 帧格式:
[0] 0x0C 报告 ID
[1] 0x01 固定
[2] 命令码 0x20 = 查电量 0xF0 = 握手
[3] 0x00
[4] 序号(自增)
[5..] 载荷
- 握手:
0C 01 F0 00 <seq> 01 01 FF(只发不收) - 查电量:
0C 01 20 00 <seq> 00 00→ 等 10ms → 读回 33 字节
响应布局:
| 偏移 | 含义 |
|---|---|
[2] |
0x20 命令回显 |
[6] |
!= 0 才算有效响应 |
[8..0x0B] |
型号魔数(如 "M909") |
[0x0F] |
IC 型号 |
[0x12] |
电量 0–100 |
[0x13] |
2 = 充电中 |
[0x15] |
在线标志 |
帧格式与响应布局来自衍生项目 InphicBatteryTray-IN9,由原厂
Inphic IN9 GM.exe逆向并在 IN9 升级版上实机验证。
设备定位:VID == 248A 且 Feature 报告长度 ≥ 33 的接口(不是 MI_02)。两代扫描逻辑互不干扰,同时插着也能各自识别。
只需要 Windows 自带的 .NET Framework 编译器,不需要安装任何 SDK:
$csc = "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe"
& $csc /target:winexe /platform:x64 `
/win32icon:assets\app.ico `
/resource:assets\MouseIcon.png,MouseIcon.png `
/out:InphicBatteryTray.exe `
/reference:System.dll /reference:System.Windows.Forms.dll /reference:System.Drawing.dll `
src\InphicBatteryTray.cs src\AssemblyInfo.cs或者直接跑:
powershell -ExecutionPolicy Bypass -File build.ps1InphicBatteryTray/
├─ README.md 中文文档
├─ README.en.md English docs
├─ LICENSE
├─ .gitignore
├─ build.ps1
├─ src/
│ ├─ InphicBatteryTray.cs 全部逻辑(约 900 行,单文件)
│ └─ AssemblyInfo.cs 版本 / 作者信息
└─ assets/
├─ app.ico 程序图标(in + 鼠标角标)
├─ MouseIcon.png 托盘图标源图(256×256)
└─ preview-levels.png README 配图
改 src/InphicBatteryTray.cs 里这几个地方再重编译:
| 想改什么 | 位置 |
|---|---|
| 阈值配色 | StatusColor() |
| 离线超时 | const int OfflineAfterMs |
| 填充方向 | DrawIcon() 里的 fillTop / y >= fillTop |
| 图标外观 | 换 assets/MouseIcon.png |
| 支持的 VID/PID | Candidates 数组 |
| 上报周期假设 | OfflineAfterMs 建议保持 ≥ 4 倍上报周期 |
完整的设备匹配列表见源码里的 Candidates 数组(9 组 VID/PID,覆盖原厂软件枚举的 7 个型号与 2 组自建 VID)。
本工具只读,并且明确避开用户输入:
- ✅ 读取:IN10 状态通道(
Usage Page 0x000A)上的推送电量 - ✅ 查询:IN9 的 Feature Report 电量命令(
0x20,只读,不改任何设置) - ✅ 读取:HID 元数据(VID/PID、产品名、报告长度)
- ❌ 不读取任何
Usage Page 0x0001(Generic Desktop)接口——那是键盘和鼠标本体,上面跑的是按键和移动数据 - ❌ 不修改设备配置(DPI / 灯光 / 按键映射一律不碰)
- ❌ 不联网,无遥测
这也是开发过程中调试探针的硬约束:所有抓包脚本都显式过滤掉了键盘/鼠标接口。
- 型号覆盖:IN10 在
Inphic KP 8K上实测通过;IN9 按升级版实测协议实现(248A:5B2E/248A:5B2F)。其余 INPHIC 型号(IN10 Pro / IN6 等)未验证,协议若有差异可能读不到电量。 - 电量精度就是 1%,硬件层面没有小数、没有电压、没有健康度。想显示
87.3%只能靠软件插值造假,本项目没做。 - 无法配置上报频率。IN10 的 2 秒是固件定的,IN9 的 2.5 秒是软件定的;两代都没有"设置上报间隔"的命令。
- 离线靠超时猜测(8 秒),因为设备关机时不发通知。如果鼠标只是短暂休眠(不是关机),也可能被误判成离线。
- 16×16 图标下角标和细节会糊,这是托盘图标的物理上限。
程序会在同目录写 tray.log(超过 512KB 自动换新),记录枚举到的接口、收发字节与解析结果。遇到问题把文件贴到 issue 里即可定位。
- MRXie-zf/InphicBatteryTray-IN9 — 本项目的 IN9 衍生版,也是 v1.1.0 IN9 支持的全部依据。它从原厂
Inphic IN9 GM.exe逆向出真实的 Feature Report 协议(报告 ID0x0C、命令0x20、电量buf[0x12])并实机验证。若要更完整的 IN9 功能(低电量系统通知、--probe诊断等),请直接用它。 - RuiShu1024/InphicMouse — 同厂 IN9 系列早期的协议复原尝试,为理解厂商的通信设计(尤其是"连接模式靠 VID 判断")提供了参考。
本项目是非官方的第三方工具,与英菲克(INPHIC)官方无关。
协议信息通过静态逆向 INPHIC HUB 1.0.1.19 与实机抓包得出,仅用于互操作性目的。程序本身只读,不修改设备与厂商软件。使用风险自负。

