GZ302-Linux-Setup

GZ302 Documentation

Documentation for the ASUS ROG Flow Z13 (GZ302) Linux Setup project.

Quick Links

Document	Description
Kernel Support	Kernel compatibility matrix, troubleshooting
AI/ML Packages	ROCm, Ollama, PyTorch setup
ROCm Support	ROCm 7.1.1 configuration
Testing Guide	How to test changes
Changelog	Version history
Obsolescence Analysis	Component lifecycle status

Hardware Specifications

ASUS ROG Flow Z13 (GZ302EA-XS99)

• CPU: AMD Ryzen AI MAX+ 395 (16 cores, 32 threads)
• GPU: AMD Radeon 8060S (RDNA 3.5, 40 CUs)
• NPU: AMD XDNA (50 TOPS)
• RAM: 128GB LPDDR5X (unified memory)
• WiFi: MediaTek MT7925e (Wi-Fi 7)
• Display: 13.4” 2.5K 180Hz OLED touchscreen

Supported Distributions

Distribution	Kernel	Support Level
Arch Linux	6.17+	✅ Full
CachyOS	6.18+	✅ Full
Fedora 43	6.17+	✅ Full
OpenSUSE TW	6.17+	✅ Full
Ubuntu 25.10	6.11+	⚠️ Upgrade HWE

Repository Structure

GZ302-Linux-Setup/
├── gz302-setup.sh         # Unified installer (v6.0.0)
├── gz302-lib/             # Shared bash libraries
├── modules/               # Optional modules (gaming, AI, hypervisor)
├── scripts/               # Standalone tools & utilities
│   └── uninstall/         # Cleanup scripts
├── command-center/        # Python/Qt6 system tray app
├── pkg/arch/              # Arch Linux PKGBUILD
└── docs/                  # Documentation (you are here)

Updating

To pull the latest fixes and apply them:

cd GZ302-Linux-Setup
git pull
sudo bash gz302-setup.sh

[!NOTE] Some fixes (like suspend hooks) are installed to system paths and require re-running the installer to update.

Getting Help

1. Check Kernel Support for compatibility issues
2. See Testing Guide for diagnostic commands
3. Open an issue: GitHub Issues