Repository navigation
Releases
Releases · sdparklab/Voltide
Voltide v2.1.4
新增设备
| 设备 | 类型 | 贡献者 |
|---|---|---|
| MCHOSE K7 V2 Ultra+ | 鼠标 | @whitzard0421 |
| MCHOSE A5 V3 | 鼠标 | @koobzx |
| TAIDU TSG809 | 鼠标 | @ptaritsu |
| ROG Delta II、Pelta | 耳机 | @Cantrarella |
四位都在真实硬件上逆向并验证过,代码里保留了各自的协议实现。
修复:MCHOSE 偶发读成 0%
接收器在回电前会先回显一次查询帧,旧代码把它当成了回复:
TX 13 4A 01 00 00 ... ← 查询
RX 13 4A 01 00 00 ... ← 回显![5] 是 0,不是电量
RX 13 4A 01 00 02 62 01 ... ← 真正的回复
现在会跳过回显,只接受完整校验的回复:
if (p.Length == 20 && p[4] == 0 && p[19] == Checksum(p)) continue;
if (TryParseBattery(p, out percent, out charging)) return p;顺带修了两个同源问题:
- 电量 > 100 时不再静默截断成 100,改为报告「电量回复无效」
- 充电状态改读
frame[6]的高四位(低位是 fullStatus)
如果之前偶尔看到 K99 v2 显示 0% 然后刷新一次就恢复正常,那就是这个 bug。
界面:统一回退名
设备匹配上但查不到型号时,不再显示 PID_XXXX 这类开发者向的占位,改用大类:
| 品牌 | 回退名 |
|---|---|
| Logitech | Mouse / Keyboard(按设备名判断) |
| MCHOSE 键盘 | Keyboard |
| MCHOSE A5 | Mouse |
| Razer | Mouse |
| TAIDU | Mouse |
| ROG 耳机 | Headset |
精确 PID 匹配的设备(K7 V2 Ultra+、ATK、IMECOO、ROG 键盘、雷蛇耳机)保持写死型号——
它们只认一个 PID,不存在「认错」的可能。
另外把 DELTA II KJP 合并成了 DELTA II。
完整文件
Voltide.exe(8.32 MB,单文件,无需安装)
要求 Windows 10 / 11 + .NET Framework 4.8
Voltide v2.1.3
新增设备
- IMECOO P1(2.4G 鼠标,
3554:FB34):17 字节帧,与 ATK A9 Air 同属 CompX 系协议 - Xbox 手柄(XInput 通用):Series X|S、8BitDo Ultimate 等所有 XInput 设备
两个适配均由 @Mor16rty 在真实硬件上实现并验证(#5、#6),特此致谢。
关于 Xbox 电量精度
XInput 只提供四档,不是百分比:
| 档位 | 显示 |
|---|---|
| Full | 100% |
| Medium | 50% |
| Low | 20% |
| Empty | 5% |
卡片详情行会标注 XInput 四档,提醒这不是实测值。有线连接时如实显示 100% + 充电中。
界面修正
- 详情行的中英文改用各自字体混排(拉丁 Montserrat、汉字阿里巴巴普惠体)
- 设备型号统一英文短名,避免压到闪电图案
完整文件
Voltide.exe(8.3 MB,单文件,无需安装)
要求 Windows 10 / 11 + .NET Framework 4.8
Voltide v2.1.2
新增设备
- 雷蛇鼠标:毒蝰终极版、毒蝰 V3 Pro / SE、炼狱蝰蛇 V3 / V4 Pro、巴塞利斯蛇 V3 Pro 等 24 个型号
- 雷蛇旋风黑鲨 V2 专业版(耳机)
- ATK A9 Air 大师+(鼠标)
- ATK N9 V2 Ultimate(耳机)
ATK 系列由 @yiwluoq 在真实硬件上逆向并验证(#3),雷蛇与狼蛛协议由 B 站网友 木兮丶念旧 提供,一并致谢。
界面
- 托盘菜单按新设计稿重做:标题条 + 数据行网格,高度随设备数变化(19 + 9 + n×39)
- 每行带电量进度条,休眠 / 读取中添加灰显
- 窗口右上角弹出,12px 圆角,点击任意位置关闭
- 设备型号统一改为英文短名,避免压到闪电图案
- 等待读数的卡片与休眠卡片一样灰显,且不再绘制液体
修复
- 刷新按钮加 5 秒冷却:连点会让 2.4G 接收器暂时不响应,反而读不到电量
- 冷却期间显示「刷新过于频繁,请稍候」,图标左右摆动
- 手动刷新立即触发液面重灌,不再等数据回来才动
已知限制
- Xbox Series X|S 手柄暂不支持:Windows 只暴露 Game Pad 输入报告(Output / Feature 均为 0),
xboxgip也不会为 Series 手柄注册接口。改用蓝牙连接可以读取——蓝牙 HID 带标准 Battery Service(0x180F)。 - 迈丛 G75 Pro 会显示为 K99 v2(共用同一接收器标识与协议)
- 狼蛛键盘可能被识别为迈丛型号
完整文件:Voltide.exe
要求:Windows 10 / 11,.NET Framework 4.8
Voltide v2.1.0
首个公开版本。
- 直接通过 HID 读取罗技(HID++ 2.0)、迈丛与 ROG 设备的电量
- 无需安装厂商软件,无后台服务
- 单个 8.3 MB 可执行文件,字体已嵌入
- 液面指示,分绿 / 黄/ 红三档配色
- 设备休眠后保留最后一次读数
- 刷新间隔可调(15 / 30 / 90 秒)
- 可选开机自启
- 托盘菜单列出全部设备