This release of UnofficialOS brings fixed and updated cores and emulators, a bunch of bug fixes, and R36 Ultra support. Be aware that only the v1 Ultra has LED stick support at the moment. Clone users please see the updated directions here. These are important steps for these units, so please review this wiki page. Special thanks to @Pretz for the G350 PR, @KitFox618 and @Sundownersport for the help with testing.
R36 Ultra Bug Fix
I apologize to the users of the Ultra, there was a tiny bug in the current stable that stopped the device switches from showing in EmulationStation, which will break ota updates on this unit. This file can be downloaded and placed in the root on the partition where the boot.ini is, the overlay folder etc. Make sure its placed where the boot.ini, dtb files are and not in the overlays folder. With this file, ota updates will succeed, and the switch can be flipped next update. Thanks, and sorry for the inconvenience. As I don't have a unit to test, I missed this.
New Supported Devices and Features
- R36 Ultra (LED sticks work on v1) See Wiki Above
- EmulationStation Clone Device Switch for R36 Ultra
- Added Per Device Docs back / fixed building
Bug Fixes
- Fixed Webtool for MyMini Overlays
- BatleXP G350 - fixed Menu button thanks to @Pretz
- BatleXP G350 - fixed Drastic and PPSSPP to open menu with M key
- Game Console R36S - fixed PPSSPP to open menu with M key
- Xifan MyMini - fixed LED joystick color and added flow option, fixed ppsspp/drastic configs
- Xifan XF35H / XF40H - fixed LED joystick color
- G350 / R36S - Fixed gamecontrollerdb.txt
- Removed AdvanceMame and gbsp from ES emu options
- Fixed TIC-80 / added savestates
- Fixed vbam
- Misc build fixes
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- Extract the .img and flash the image to your microSD card using your favorite image writing tool (Balena Etcher, Raspberry Pi Imager, Win32 Disk Imager, dd etc.)
Installation Image Downloads
| Device/Platform | Install Image |
|---|---|
| Anbernic Win600, AOKZOE A1 PRO, AYANEO 2/2S/AIR/PRO/PLUS, Atari VCS, Ayn Loki Zero/Max, GPD Win4/Max2 | AMD64 |
| Anbernic 351P/V/M, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, MagicX XU10 | RK3326 |
| BatleXP G350, GameConsole R33S/R35S/R36S, MagicX XU Mini M, Kinhank K36, Clones These Units Must Follow Wiki Install Instructions | RK3326-CLONE |
| Anbernic 353P/PS/V/VS/M/RG503, Powkiddy RGB10 Max 3/RGB20 Pro/RGB30/RK2023 | RK3566-BSP |
| Powkiddy X55 | RK3566-BSP-X55 |
| Anbernic RG552 | RK3399 |
| Gameforce Ace, Orange Pi 5, Radxa Rock 5b, Indiedroid Nova (must set dtb in extlinux.conf) | RK3588 |
| Hardkernel Odroid Go Ultra, Powkiddy RGB10 Max 3 Pro | S922X-Odroid_GOU |
| Hardkernel Odroid N2 | S922X-Odroid_N2 |
| Hardkernel Odroid N2L | S922X-Odroid_N2L |
Upgrading Over the Air (OTA)
If your device has access to the internet you can update UnofficialOS directly from EmulationStation.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- Scroll to the System Update header and select Start Update
Upgrading Manually
If you device does not have access to the internet you can still update manually
- Download the latest update (.tar) of UnofficialOS for your device from below or the releases page.
- Make sure to download the correct .tar file for your device. For example; if you are installing UnofficialOS on a RG351P you would download the
UnofficialOS-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- Make sure to download the correct .tar file for your device. For example; if you are installing UnofficialOS on a RG351P you would download the
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- Reboot the device, and the update will begin automatically.
Update Package Downloads
| Device/Platform | Update Package |
|---|---|
| Anbernic Win600, AOKZOE A1 PRO, AYANEO 2/2S/AIR/PRO/PLUS, Atari VCS, Ayn Loki Zero/Max, GPD Win4/Max2 | AMD64 |
| Anbernic 351P/V/M, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, MagicX XU10 | RK3326 |
| BatleXP G350, GameConsole R33S/R35S/R36S, MagicX XU Mini M, Kinhank K36, Clone units | RK3326-CLONE |
| Anbernic 353P/PS/V/VS/M/RG503, Powkiddy RGB10 Max 3/RGB20 Pro/RGB30/RK2023 | RK3566-BSP |
| Powkiddy X55 | RK3566-BSP-X55 |
| Anbernic RG552 | RK3399 |
| Gameforce Ace, Orange Pi 5, Radxa Rock 5b, Indiedroid Nova (must set dtb in extlinux.conf) | RK3588 |
| Hardkernel Odroid Go Ultra/N2/N2L, Powkiddy RGB10 Max 3 Pro | S922X |
IMPORTANT Known Bugs/Issues
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- Powering down fully for more then a few minutes at a time resets the battery meter. This IS NOT drain, its a bad meter reading.
- And last, sleeping the unit breaks sound.
What I have been doing currently is charging the unit to 100%, sleeping the unit when not in use, then I'll wake it and reboot when I want to use it. It still has very good battery life when sleeping, as I only lose between 5% and 10% battery daily. Not ideal I know, I'm working towards a fix.
Odroid Go Advance
There is currently hotkey issues with this unit, specifically with PortMaster. Ports require a hard shutdown (not recommended).
Working on fixes for all mentioned issues and bugs. Please report bugs/issues to the uOS discord here.
Changelog
The commits and changes can be viewed here in the pull request for this release.
Donate
Love this project? Please consider supporting us on Ko-Fi