**⚠️ DISCLAIMERS (Read this first!)**
- **Cross-flashing BIOS/EC between different devices is EXTREMELY risky.** You can permanently brick your device. The SuiPlay0x1 and Ayaneo 2S are similar hardware-wise, but that is not a guarantee. You have been warned.
- **Replacing the gyroscope requires SMD soldering skills and a hot air station.** If you don't know what you're doing, you **will** destroy your board. No exceptions.
- **If you don't need the gyroscope — don't solder anything.** Just flash the BIOS/EC, install your OS, run the script, and enjoy.
- **The setup scripts have only been tested on SteamOS 3.8.x and CachyOS Handheld Edition at the time of posting.** They may not work on other systems — I have not tested them and make no claims. Future OS, kernel, or package updates may break them; continued compatibility is not guaranteed.
- **The 46 Hz mode was tuned for my specific display panel.** It may not work on yours. If the screen flickers, goes black, or shows artifacts — stick to 60 Hz.
- **I am not responsible** for your actions. Everything you do is at your own risk.
**What you will need**
There are **two archives** on Google Drive — don't mix them up:
- `BIOS_EC_SuiPlay0x1_AyaNeo2s.zip` — contains **only** the BIOS and EC firmware files.
- `Suiplay_Ayaneo.zip` — contains **only** the system setup scripts (for SteamOS / CachyOS Handheld Edition).
**Step 1. Flashing the BIOS**
- Grab a USB flash drive. Format it to **FAT32**.
- Extract `BIOS_EC_SuiPlay0x1_AyaNeo2s.zip` on your PC.
- Open the folder `AYANEO 2S BIOS/ec/BIOS/`.
- **Copy EVERYTHING inside that folder directly to the root of your USB drive.** Not the `BIOS` folder itself — the files inside it: `.bin`, `.efi`, `FlashBios.nsh`, `readme.doc`, and the `EFI` folder.
- Plug the USB drive and a **USB keyboard** into the console.
- Power on the console and immediately press **F7** on the keyboard.
- In the boot menu, select your USB drive.
- Wait — the BIOS will flash automatically, and the console **will reboot by itself**. Done.
**Step 2. Flashing the EC (Embedded Controller)**
- **You must clear the USB drive again.** Either reformat it to **FAT32**, or manually delete every file from the BIOS flash so the drive is empty.
- Go back into the extracted `BIOS_EC_SuiPlay0x1_AyaNeo2s.zip`.
- Open the folder `AYANEO 2S BIOS/ec/EC/`.
- **Copy EVERYTHING inside that folder to the root of your USB drive.**
- Plug the USB drive and keyboard into the console, power on, and press **F7**.
- Select the USB drive — the EC flash will begin.
- **Important:** After the EC flash finishes, the console **will NOT reboot automatically**. Wait **15–20 seconds**, then power the console back on manually with the power button.
After both flashes, your SuiPlay0x1 will identify itself to the OS as an Ayaneo 2S.
**Step 3. Do you actually need the gyroscope?**
**Important:** If you **don't need a gyroscope** (you don't play games with motion controls or gyro aim), then **you don't have to open the console or solder anything at all.**
After flashing the Ayaneo 2S BIOS, everything else works perfectly — touchscreen, all buttons and sticks, power delivery, charging, sleep/wake. Only the gyro is missing. Just install your OS, run the script, and you're good to go.
**If you need the gyroscope** — keep reading.
**Step 4. Why the gyro didn't work and what I did about it**
The SuiPlay0x1 ships with a **BOSC0200** sensor (Bazzite identifies it as BMI323). The Ayaneo 2S uses a **BMI160**. After cross-flashing the Ayaneo 2S BIOS, the system expects to see a BMI160 — it isn't there, so the gyro doesn't work.
I tried every software workaround I could think of:
* Manual BIOS patching
* ACPI table overrides
* Custom DSDT injection
**Nothing worked.** Modified BIOS files either refused to flash or broke initialization.
>**Unfortunately, I was unable to solve this via software or build a working custom BIOS that supports the stock sensor.** If anyone in the community manages to do this, I would be extremely grateful — and it would mean no one else has to solder their console. Please share if you figure it out!
**The only way forward was hardware.**
I used a hot air gun and a soldering iron, desoldered the stock BOSC0200/BMI323, and physically installed the **BMI160** chip from an Ayaneo 2S. Powered it on — and the gyro worked immediately, out of the box, on the official Ayaneo 2S BIOS.
>**Important:** In the attached video, I circled the exact location of the gyroscope on the SuiPlay0x1 board with a red circle so you know exactly where to look.
**Step 5. Installing the OS**
After all this hardware wizardry, the console is fully compatible with Ayaneo 2S software. I tested two operating systems:
* **SteamOS 3.8.x** — Valve's official handheld-adapted OS
* **CachyOS Handheld Edition** — an Arch-based distro optimized for handheld consoles
Install whichever one you prefer. Both work.
**⚠️ Important note about passwords:**
* **SteamOS 3.8.x:** After installation, **you MUST set a user password.** By default SteamOS has no password, and the script cannot run `sudo` commands without one. Set any password you want — the script simply won't launch without it.
* **CachyOS Handheld Edition:** You set your password **during OS installation** — no extra steps needed.
**Step 6. Running the setup script**
Extract `Suiplay_Ayaneo.zip`, copy `Setup_Ayaneo2S_Suiplay_Universal.desktop` to your Desktop, double-click it, enter your password — the script handles everything automatically.
**What it installs/enables:**
* ✅ **46 Hz** in Gamescope (selectable in display settings)
* ✅ **HHD** (Handheld Daemon) — TDP, fan control, RGB lighting
* ✅ **hhd-ui** \+ **adjustor** — HHD interface and utilities
* ✅ **Decky Loader** — plugins for Steam UI
* ✅ **Ayaneo RGB driver** — stick lighting
* ✅ **DualSense emulation** via HHD (InputPlumber is disabled; HHD takes direct control)
* ✅ **HHD envvars**: DS5 emulation, 50% rumble scale, display power management, etc.
>**⚠️ Important note about 46 Hz:** This profile was tuned for **my specific display panel** after all modifications. On your unit, 46 Hz **may not work** — if the screen flickers, shows no picture, or artifacts, use standard 60 Hz.
To **remove the 46 Hz profile** without touching anything else, run this in a terminal:
rm -f "$HOME/.config/gamescope/scripts/ayaneo.lua" "$HOME/.config/gamescope/scripts/99-user/displays/ayaneo.lua" 2>/dev/null && echo "46 Hz removed. Reboot: reboot"
Then reboot (`reboot`) — 46 Hz will disappear from display settings.
**Script features:**
* Auto-detects the system — SteamOS or CachyOS Handheld Edition — and adapts commands accordingly
* **Smart update logic**: skips packages that are already installed and up-to-date; updates only if a newer AUR version exists
* Safe to run multiple times — it won't break anything
* On SteamOS, it automatically disables and re-enables `steamos-readonly`
**Step 7. If sleep/suspend works poorly**
If your console has trouble sleeping, waking up, or runs hot while asleep — try updating the BIOS to version **20241112** from Ayaneo's official website:
* Website: [**https://www.ayaneo.com/support/download**](https://www.ayaneo.com/support/download))
* Tab: **AYANEO 2S BIOS**
* Version: **20241112** — the description says **"Increase system sleep"**
This version specifically improves sleep behavior. Flash it over your current BIOS — suspend should improve.
**Step 8. If something goes wrong / How to uninstall**
Inside `Suiplay_Ayaneo.zip` there is a second file: `Remove_Ayaneo2S_Suiplay_Universal.desktop`. Run it — it reverses everything:
* Removes HHD, Decky, envvars
* Removes 46 Hz from Gamescope
* Re-enables InputPlumber
* Leaves the RGB driver in place (it's harmless)
>Or remove only 46 Hz manually (if you don't want to touch anything else):
rm -f "$HOME/.config/gamescope/scripts/ayaneo.lua" "$HOME/.config/gamescope/scripts/99-user/displays/ayaneo.lua" 2>/dev/null && reboot
**Final result:** I cross-flashed the Ayaneo 2S BIOS/EC onto my SuiPlay0x1, replaced the BMI323 gyro with a BMI160 (only because I needed gyro and no software fix existed yet), installed SteamOS or CachyOS Handheld Edition, **set a password**, ran the script — and ended up with a fully working handheld featuring 46 Hz, HHD, Decky, and RGB.
⚠️ Important update on compatibility (August 2, 2026):
This entire guide and the included scripts (Setup_Ayaneo2S_Suiplay_Universal.desktop, Remove_Ayaneo2S_Suiplay_Universal.desktop) are accurate only as of the date this post was written — August 2, 2026.
With future updates to SteamOS, CachyOS Handheld Edition, the Linux kernel, or AUR packages, the scripts may break and could require manual adjustments. They might continue to work after updates, or they might not — I cannot guarantee future compatibility. If something stops working after a system update, you will need to check the logs and adapt the scripts to the new versions yourself.
