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

+17 -3
View File
@@ -19,7 +19,15 @@ Linux bisa memakai perangkat yang secara resmi hanya didukung aplikasi Windows.
HID. Penulis telah mengujinya pada perangkat miliknya sendiri, tetapi tidak ada
jaminan apa pun — termasuk jaminan kelayakan untuk tujuan tertentu. Gunakan dengan
risiko Anda sendiri.
5. **Tanpa jaminan.** Perangkat lunak disediakan "sebagaimana adanya" di bawah
5. **Batasan perangkat.** Perangkat lunak ini hanya mengirim data sensor. Panel
**tidak bisa dimatikan** dan **logo pada panel tidak bisa diganti** lewat USB —
keduanya urusan firmware vendor, bukan sesuatu yang bisa dilakukan proyek ini.
Nilai yang ditampilkan panel terbatas dua digit dan berlabel °C.
6. **Diuji pada** panel GAMEMAX IceBurg 240 Digital (HID `5131:2007`) di CachyOS
(Arch), kernel 7.2.9, KDE Plasma Wayland, Python 3.14. Revisi firmware lain bisa
berbeda perilakunya; uji dulu dengan `--dry-run` (tidak menulis apa pun) sebelum
dipakai rutin.
7. **Tanpa jaminan.** Perangkat lunak disediakan "sebagaimana adanya" di bawah
lisensi MIT; lihat `LICENSE`.
6. **Perkakas pihak ketiga** yang dipakai saat analisis (mis. REA, Ghidra, PySide6)
tetap tunduk pada lisensinya masing-masing dan tidak didistribusikan ulang di sini.
@@ -34,6 +42,12 @@ only by a Windows application.
- Independently reverse engineered for interoperability. No vendor code, binaries,
or assets are redistributed; the application icon is original artwork.
- Trademarks belong to their respective owners.
- The software writes to a USB HID device. It was tested on the author's own hardware
only. Use at your own risk, provided "as is", without warranty of any kind (MIT).
- The panel cannot be powered off and its logo cannot be changed over USB; those are
firmware features of the vendor. Displayed values are limited to two digits and are
labelled °C by the firmware.
- The software writes to a USB HID device. Tested with a GAMEMAX IceBurg 240 Digital
panel (HID `5131:2007`) on CachyOS/Arch, kernel 7.2.9, KDE Wayland, Python 3.14.
Other firmware revisions may behave differently — inspect with `--dry-run` (writes
nothing) before relying on it. Use at your own risk, provided "as is", without
warranty of any kind (MIT).
- Third-party analysis tools keep their own licenses.
+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`)