diff --git a/DISCLAIMER.md b/DISCLAIMER.md index 0a08f16..4c266ad 100644 --- a/DISCLAIMER.md +++ b/DISCLAIMER.md @@ -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. diff --git a/README.md b/README.md index 7a3c0d1..2ef33d6 100644 --- a/README.md +++ b/README.md @@ -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`)