Skip to content

About

给英菲克(INPHIC)无线鼠标加一个任务栏电量显示

Topics

Resources

Stars

31 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Inphic 鼠标电量托盘

中文 | English

给英菲克(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)
未检测到 灰显 英菲克:未检测到设备

快速开始

方式一:直接用

  1. 下载 InphicBatteryTray.exe
  2. 放到一个固定目录(比如 %LOCALAPPDATA%\InphicBatteryTray\)
  3. 双击运行,托盘出现图标
  4. 右键图标 → 勾选「开机自动启动」

建议不要放在原厂软件目录里——卸载或重装 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 秒"推断。

为什么是 8 秒

上报周期 2 秒,8 秒 = 连续漏掉 4 帧,不会因为一次抖动误判,也不至于关机后太久才变灰。

连接方式怎么判断

不是问设备,是看 HID 接口路径:蓝牙设备走 BTHENUM 路径,其余判为 USB。这和厂商自己的做法一致(原厂软件靠 VID 区分不同连接模式)。

图标渲染

托盘图标是运行时用 GDI+ 逐像素画的,不是预先做好的图片:

  1. 把 MouseIcon.png 缩放到系统实际图标尺寸(通常 16×16)
  2. 找 alpha 边缘,把最外圈强行描成深色实线——16px 下描边本来只有半个像素,不这样会糊成一团
  3. 识别"绿色主体"像素(G - R > 45 && G - B > 45),按电量高度替换成状态色或灰色
  4. 描边、滚轮、顶部按键保持原色

这样即使只有 16×16,也能看出是鼠标而不是一个色块。

IN9 系列(另一套协议)

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.ps1

仓库结构

InphicBatteryTray/
├─ 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 / 灯光 / 按键映射一律不碰)
  • ❌ 不联网,无遥测

这也是开发过程中调试探针的硬约束:所有抓包脚本都显式过滤掉了键盘/鼠标接口。


已知限制

  1. 型号覆盖:IN10 在 Inphic KP 8K 上实测通过;IN9 按升级版实测协议实现(248A:5B2E / 248A:5B2F)。其余 INPHIC 型号(IN10 Pro / IN6 等)未验证,协议若有差异可能读不到电量。
  2. 电量精度就是 1%,硬件层面没有小数、没有电压、没有健康度。想显示 87.3% 只能靠软件插值造假,本项目没做。
  3. 无法配置上报频率。IN10 的 2 秒是固件定的,IN9 的 2.5 秒是软件定的;两代都没有"设置上报间隔"的命令。
  4. 离线靠超时猜测(8 秒),因为设备关机时不发通知。如果鼠标只是短暂休眠(不是关机),也可能被误判成离线。
  5. 16×16 图标下角标和细节会糊,这是托盘图标的物理上限。

读不到电量?

程序会在同目录写 tray.log(超过 512KB 自动换新),记录枚举到的接口、收发字节与解析结果。遇到问题把文件贴到 issue 里即可定位。


致谢

  • MRXie-zf/InphicBatteryTray-IN9 — 本项目的 IN9 衍生版,也是 v1.1.0 IN9 支持的全部依据。它从原厂 Inphic IN9 GM.exe 逆向出真实的 Feature Report 协议(报告 ID 0x0C、命令 0x20、电量 buf[0x12])并实机验证。若要更完整的 IN9 功能(低电量系统通知、--probe 诊断等),请直接用它。
  • RuiShu1024/InphicMouse — 同厂 IN9 系列早期的协议复原尝试,为理解厂商的通信设计(尤其是"连接模式靠 VID 判断")提供了参考。

免责声明

本项目是非官方的第三方工具,与英菲克(INPHIC)官方无关。

协议信息通过静态逆向 INPHIC HUB 1.0.1.19 与实机抓包得出,仅用于互操作性目的。程序本身只读,不修改设备与厂商软件。使用风险自负。


License

MIT

About

给英菲克(INPHIC)无线鼠标加一个任务栏电量显示

Topics

Resources

Stars

31 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages