oxpoe/gamemax-linux-apps
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
oxpoe
2026-10-13 06:22:37 +07:00
parent f58a011f4d
commit a8baf6d4fd
2 changed files with 40 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
DISCLAIMER.md
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 HID. Penulis telah mengujinya pada perangkat miliknya sendiri, tetapi tidak ada
jaminan apa pun — termasuk jaminan kelayakan untuk tujuan tertentu. Gunakan dengan jaminan apa pun — termasuk jaminan kelayakan untuk tujuan tertentu. Gunakan dengan
risiko Anda sendiri. 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`. lisensi MIT; lihat `LICENSE`.
6. **Perkakas pihak ketiga** yang dipakai saat analisis (mis. REA, Ghidra, PySide6) 6. **Perkakas pihak ketiga** yang dipakai saat analisis (mis. REA, Ghidra, PySide6)
tetap tunduk pada lisensinya masing-masing dan tidak didistribusikan ulang di sini. 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, - Independently reverse engineered for interoperability. No vendor code, binaries,
or assets are redistributed; the application icon is original artwork. or assets are redistributed; the application icon is original artwork.
- Trademarks belong to their respective owners. - Trademarks belong to their respective owners.
- The software writes to a USB HID device. It was tested on the author's own hardware - The panel cannot be powered off and its logo cannot be changed over USB; those are
only. Use at your own risk, provided "as is", without warranty of any kind (MIT). 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. - Third-party analysis tools keep their own licenses.

24
README.md
View File

@@ -7,10 +7,29 @@ Reverse engineered independently from the Windows vendor software
(`PcInfoMonitorPro.exe` / "IceBurg Digital Software"); the protocol notes are in (`PcInfoMonitorPro.exe` / "IceBurg Digital Software"); the protocol notes are in
[`docs/reverse-engineering.md`](docs/reverse-engineering.md) (Indonesian). [`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) ![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 ## Features
- Sends CPU temp/load/clock/fan/power, GPU temp/load/clock/fan/power, RAM and disk - 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 ## 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) - Linux with a working `hidraw` stack (tested on CachyOS / Arch, KDE Wayland)
- Python 3.10+ for the sender (stdlib only) - Python 3.10+ for the sender (stdlib only)
- For the tray app: PySide6 (`uv run --with pyside6 python src/gamemax_gui.py`) - For the tray app: PySide6 (`uv run --with pyside6 python src/gamemax_gui.py`)