Skip to content

Releases: Ap0LoG1zE/EZ2.4G

Release list

EZ2.4G

Choose a tag to compare

@Ap0LoG1zE Ap0LoG1zE released this 19 Oct 22:51
604cfd4

EZ2.4G 更新内容

本次更新

  • 启动不再自动扫描并添加设备;没有设备时显示「请插入设备 / 或者拔插一下你想要添加的设备」
  • 插入或重新拔插设备时弹窗确认,显示设备名、VID:PID 和当前电量
  • 右键设备卡片可删除设备
  • 双击设备名可改名,名称写入配置并持久化
  • 设备休眠读不到时沿用上次成功电量,并标注「上次更新 HH:MM」
  • 面板更紧凑;右上角 ✕ 改为右下角「最小化」,只收进托盘
  • 抓包助手并入主程序,不再需要单独的 capture_helper.py
  • 抓包只按 VID:PID 分析目标设备:唯一字节直接采用,多字节时换电量二次抓包按差值匹配
  • 修复退出时 Tcl alloc: invalid block 崩溃
  • 添加确认框和右键菜单改为可靠的原生控件

本次修复

  • 修复右键菜单关闭后无法再次打开
  • 修复改名提交后刷新又恢复旧名
  • 协议只认「标准 HID 直接读取」或「抓包成功保存」,不再按 VID:PID 匹配内置设备
  • 抓包保存后立即回读验证;失败时尝试被动监听输入报告,仍失败则删除协议并提示
  • 回读值必须与输入电量一致;若是 100−回读值,自动保存为反向协议,避免 35% 显示成 65%
  • 设备休眠或读不到时沿用上次电量,文案为「上次更新 HH:MM · 设备休眠」
  • 接口不在时不再回退上次电量,直接显示「未连接」
  • 删除设备时同时清除该设备的协议和上次电量
  • 未抓包、也还没成功读取过的设备,仍显示「协议未知」
  • 抓包分析排除描述符、EP0 标准控制 setup 和全零报告,减少误判
  • 后台应用名、窗口名、托盘提示和开机启动项名统一改为「2.4G」
  • 托盘电量圆环改为 4 倍超采样后缩小,边缘更圆润
  • 重新打包 exe,包含以上修复

下载

  • 2.4G.exe:单文件,双击运行,无需安装 Python。
  • EZ2.4G.python.zip:源码包,装了 Python 3.10+ 可直接运行。
  • EZ2.4G.v1.0.0.all.zip:exe + 源码 + 说明 + 截图,一次下载。

未签名程序,Windows SmartScreen 提示时选“更多信息 → 仍要运行”。

抓包流程

  • 点「开始抓包」后自动查找 USBPcap、自动定位设备所在接口;
  • 按 VID:PID 只分析目标设备的帧;
  • 只有一个字节等于填入电量时直接保存;
  • 多个字节等于填入电量时,要求换一个电量再抓一次,比较两次字节差值;
  • 协议保存请求帧和电量字节位置,以后直接按协议读取。

说明

  • 仅支持 Windows 10/11 x64。
  • 电量由设备上报,可能是 5% 步进。
  • 加密或私有握手协议无法通过抓包读取。