docs: rinci kompatibilitas perangkat (hidraw, model teruji), batasan firmware, dan pratinjau dua mode layar

This commit is contained in:
oxpoe committed 2026-10-13 06:26:52 +07:00
1 parent f58a011f4d
commit a8baf6d4fd
2 files changed
+40 -4

No files matched your search

+23 -1
View File
@@ -7,10 +7,29 @@ Reverse engineered independently from the Windows vendor software
(`PcInfoMonitorPro.exe` / "IceBurg Digital Software"); the protocol notes are in
[`docs/reverse-engineering.md`](docs/reverse-engineering.md) (Indonesian).
Author: **oxpoe** · License: **MIT** · Please read [DISCLAIMER.md](DISCLAIMER.md).
Author: **oxpoe** · License: **MIT** · Independent project, **not affiliated with the
vendor** — please read [DISCLAIMER.md](DISCLAIMER.md) before using it.
> **Compatibility**
> - **OS:** Linux only (Windows is handled by the vendor software). No kernel module,
> no patched driver — it talks to the standard `hidraw` interface.
> - **Tested on:** CachyOS (Arch) · kernel 7.2.9 · KDE Plasma Wayland · Python 3.14,
> with the panel of a **GAMEMAX IceBurg 240 Digital BK** (HID `5131:2007`,
> vendor-defined usage page `0xFF00`, 64-byte reports).
> - Other IceBurg Digital models/sizes very likely share the same protocol; if a panel
> revision differs, `gamemax_report.py --dry-run` lets you inspect the report without
> writing to the device.
> - The panel keeps animating on its own; the firmware offers **no command to power the
> display off** and **no way to change the logo** — blank mode simply sends zeros.
![Tray app preview](assets/preview.png)
### Screen modes
| Normal — sensor values | Blank — zeros (indicator is clear) |
|---|---|
| ![normal](assets/preview.png) | ![blank mode](assets/preview-blank-mode.png) |
## Features
- Sends CPU temp/load/clock/fan/power, GPU temp/load/clock/fan/power, RAM and disk
@@ -32,6 +51,9 @@ The GUI labels are in Indonesian.
## Requirements
- A GAMEMAX IceBurg Digital panel connected over USB (VID `0x5131`, PID `0x2007`)
- `hidraw` access for your user (see the udev rule in *Install*)
- Linux with a working `hidraw` stack (tested on CachyOS / Arch, KDE Wayland)
- Python 3.10+ for the sender (stdlib only)
- For the tray app: PySide6 (`uv run --with pyside6 python src/gamemax_gui.py`)