# IQOS Bar：读取 IQOS ILUMA 使用计数的 USB HID 客户端

> IQOS Bar 通过只读 USB HID 查询 IQOS ILUMA i ONE，在桌面托盘或菜单栏显示电量与累计使用计数。协议笔记说明 HID 帧格式、寄存器读取命令及 hidapi 响应偏移；命令层沿用并适配了 iqos-scope 的研究成果。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/tiritfurkan/iqos-bar>
- 一手来源：<https://github.com/tiritfurkan/iqos-bar/blob/9d56260550247402941b10f50c9aec0b338a9118/PROTOCOL.md>
- 目录页面：<https://awesomerea.org/zh/resources/iqos-bar-case/>
- 记录 JSON：<https://awesomerea.org/resources/iqos-bar-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/iqos-bar-case/index.md)

## 使用条件与局限

- **前提条件：**应用可在 macOS、Windows 和 Linux 运行；Linux 可能需要配置 HID 访问的 udev 规则。
- **范围：**作者确认的设备是通过 USB 连接的 IQOS ILUMA i ONE；其他型号不提供的字段会留空。
- **局限：**每日图表需要记录约两天的设备累计计数后才会逐渐填满。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/tiritfurkan/iqos-bar/blob/9d56260550247402941b10f50c9aec0b338a9118/PROTOCOL.md>
2. <https://github.com/tiritfurkan/iqos-bar/blob/9d56260550247402941b10f50c9aec0b338a9118/README.md>

## 同分区更多条目：协议

- [Chorus：重建 Logitech Harmony 遥控器编程流程](https://awesomerea.org/zh/resources/chorus-harmony-remote-case/index.md) · 案例
- [tinycoral：重建 Coral Edge TPU 指令集与 USB 运行时](https://awesomerea.org/zh/resources/tinycoral-edge-tpu-case/index.md) · 案例
- [ninebot-go：重建 Ninebot App 云端通信](https://awesomerea.org/zh/resources/ninebot-go-case/index.md) · 案例
- [open-g2-hub：基于 BLE 协议研究的 Even G2 本地客户端](https://awesomerea.org/zh/resources/open-g2-hub-case/index.md) · 案例
- [Edifier Speakers BLE：重构 M60 与 M90 音箱控制协议](https://awesomerea.org/zh/resources/edifier-speakers-ble-case/index.md) · 案例
- [Halyard：在掌机上重建 Shadow 云电脑串流](https://awesomerea.org/zh/resources/halyard-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。