Releases: TriForceX/MiyooCFW
Version 2.0.0 Beta 2 (Pre-Release)
This is the second beta update which is aimed at improving and fixing issues/requests reported after the first 2.0.0-beta release, theres also several improvements to RetroArch, so many thanks to the developement team and the people who took their time to report and test the latest builds.
Remember we are still on beta phase, that means some parts has to be installed and configured manually. Please read the setup & install instructions below and notes from first 2.0.0-beta release.
Full Changelog
- Main Modules:
- Use miyoo_video driver instead uEnv.txt file to get the proper settings for LCD
- Add target ARM specific optimizations for all modules
- Update with fixed folder creation name (UMTPRD)
- Remove obsolete uboot miyoo logo format (Board)
- Add
screenprogram (Package) - Add PYGAME along side with new pkg PYGAME_MENU (Python)
- Fix for linux and android devices (USB-HID)
- Fix brightness setting lost at low battery screen blinking (Daemon)
- GMenu2X:
- Add generic gamepad input configuration
- Add UNICODE chars support with GNU Unifont
- Update code to read 3rd analog movement
- Refactor themes (Skins), add new skinMenu settings
- Updated languages translations and added new OFL fonts
- Fix sound level not being saved
- Make
about.txtavailable for translation - Remove skin and remove fonts voliating license restrictions
- RetroArch:
- Update
retroarchto commit 35e140a - Add fix patch for sdl input driver
- Reduce audio latency to 64ms to fix frame pacing
- Revert video sync option G-sync option as it disables ff function
- Update picodrive, gpsp cores to latest
- Change input driver from "sdl_dingux" to "sdl"
- Add generic gamepad auto configuration
- Optimize & disable BLARGG_APU for libretro-snes9x2005 core
- Optimized cores: fceumm, mame2000, snes9x2002, tyrquake, gpsp, pcsx_rearmed, prboom
- Use unai_old gpu for pcsx_rearmed libretro core (See notes)
- Update
Setup & Install
- This update requires a full SD card reflash
- Remember to backup your apps & configs from main partition (Except gmenu2x, but you can keep your custom sections)
- For proper setup please read the instructions and notes from the first 2.0 Beta Pre-Release here
Version 2.0.0 Beta (Pre-Release)
This is the first public beta release for Miyoo CFW 2.0 which is aimed to experienced users or those who want to test the software before we make the final/stable release.
Due this is a Pre-Release you should keep in mind that there are things that are not finished or things that are still missing, roughly speaking we are only including for the moment the core firmware files, RetroArch and some standard apps and emulators with test roms.
We have to thank all the people and developers who have supported us, specially to who have made this possible to: @tiopex, @Apaczer, @nfriedly, @Rezzy-dev, @szymor, @gameblabla and everyone from the special thanks section.
Major Updates
There have been quite a few changes, updates and fixes, but in general terms they can be summarized as follows:
New TV-Out feature:
Connect to any TV via headphone jack using an A/V cable (usually included in the console).
New USB driver features:
Connect to PC easily via USB to transfer files, use it as external controller and access to terminal console.
New GMenu2X integration:
Reworked and updated main menu system and its features.
Safer File System:
Introduced a new file system BTRFS that allows unsafe shutdown to prevent data corruption.
Built-in RetroArch:
The popular multi-emulator is now included on the CFW with the latest mainline updates.
One for All:
One single CFW image/install file for all the supported consoles.
Fully working Source Code:
This means more frequently updates and patches.
Full Changelog
The next list is all the changes, updates and fixes registered on the custom firmware at this point.
- One single CFW image / install file for all the supported consoles
- Fully working and clean source code (this means more frecuently updates)
- Added TV out video support
- Added console support XYC Q8 / SUP M3
- Added support for L2 and R2 buttons on Powkiddy V90
- Added support for secondary button (plus sign) on Powkiddy Q20 and Q90
- Added new first initial boot setup
- Added console variant auto-detection on first boot setup
- Added auto-expand storage for main partition on first boot setup
- Added USB data transfer support from PC via MTD protocol
- Added USB serial console support
- Added SD card custom icons for PC drives
- Added current CFW build version on boot screen
- Added option to disable battery warning
- Added support for 1bit consoles from software (no hardware mods required)
- Added option to configure internal clock (useful for time-based games)
- Added option to configure tearing effect fix
- Added support for IPK packages via OPKG library
- Added screen recording in background via ffmpeg (WIP)
- Added audio recording in background via arecord (silent mode)
- Added auto-start feature on main menu system GMenu2X
- Added per-app input mapping customization on main menu system GMenu2X
- Added new file system BTRFS that allows unsafe shutdown to prevent data corruption
- Added Joy-Map app to emulate connected gamepad inputs to keyboard mapping
- Added USB-Host script to connect external devices (e.g joystick)
- Added USB-MTD script to activate mass-storage (transfer files via USB OTG)
- Added USB-Serial Console script to communicate with you device via serial TTY
- Added USB-HID app to transform your handheld into external gamepad for connected PC
- Added experimental musl build CFW version
- Updated kernel to version 5.15 with BTRFS and USB support
- Updated u-boot to version 2020.07 with USB support
- Updated buildroot to version 2022.02.9 with GCC 9.x
- Updated main configuration files options (CFG files)
- Updated custom bash scripts methods to launch custom stuff
- Updated video backend engine to display splash screen or console logs from uboot
- Updated the entire GMenu2X menu front-end (previously GMenuNX)
- Updated customizable boot splash screen (BMP format)
- Increased DRAM clock speed to 174Mhz
- Fixed screen-tearing issue, enabled through TE-fix setting in GMenu2X (only for ST7789S displays)
- Fixed text overflow on GMenu2X file explorer when screenshot preview is enabled
- Fixed many other small bugs thanks to the core updates (kernel, u-boot, buildroot, etc...)
Setup & Install
Requirements:
- Handheld console
- BittBoy v1, v2, v2.5, v3, v3.5
- Pocket Go
- PowKiddy Q90, V90 or Q20 Mini
- Sup M3 v1, v2 (With F1C100S or F1C500S CPU)
- XYC Q8
- SD card (2GB minimum)
- PC (Windows, Linux or MacOS)
First setup on PC:
- Download one of the CFW builds from this release or latest one here
- uClibc build is the current standard at the moment, it has more compatibility with most apps and stuff from CFW 1.3.3 version
- musl build is an updated but experimental version which aims to improve performance and some other related correctness
- Download a flash tool to write/install the CFW image into your SD card
- Popular apps such as BalenaEtcher or USBimager serves for this purpose
- Prepare your SD card
- Initially you need to format your SD card (ideally to FAT32 with default allocation)
- All partitions must be removed when formatting, you can use apps like SD Card Formatter
- Is highly recommended to not use unbranded SD cards due it can be corrupted easily
- Flash/Write the CFW image (.img format) into your SD card using the downloaded flash tool
Setup and configuration on console:
- Insert your already prepared SD card into your console and turn it ON
- Is recommended to have your console fully charged
- Once the first setup begins you will see the next steps (Press start to confirm your options)
- Auto detect showing the detected hardware
- Screen test
- Device selection
- Confirm device
- License agreement
- Auto-expand main partition (Optional)
- When you confirm the console will reboot and the gameboy-like boot animation appears, it means you are done!
Important Notes
For regular users:
- Check the version you are using at the bottom of boot screen with the format
v2.0.0 CFW=XXXXXX (type) BETA - To test all your console buttons use IOTester app from here
- You have to manually install the apps you want, for the moment just RetroArch and other few apps were added
- For recommended RetroArch setup read the guide on wiki
- We highly recommend to get the latest versions of apps from resources
- To connect your console to a PC you need to have the console turned ON and an USB charge & data cable
- Once is connected a new drive named "Miyoo Handheld" will appear, it includes boot, main and rootfs partitions
- If drive doesn't appear in your PC launch the USB MTD icon on console
- If for you are not able to connect via USB read the notes "For other developers"
- If you still want to access SD card directly without console USB use this driver
- For unsafe shutdowns, it is necessary to wait at least 5 sec. before shutting down the console to save the in-game state, otherwise the saved state will be lost. (Is still recommended to use the in-game power off option)
For other developers:
- To enable console logs in uboot read here
- To develop apps, games, emulators, and more, you can use the next Docker images with configured toolchain:
Whats needed for the 2.0 public final release?
- Fully CFW testing and its main components on all consoles
- Main menu GMenu2X testing and all of its features
- Testing and update all apps, tools, emus and games
- Update Wiki guides (and website) for 2.0 version and beyond
- Collaboration and support from the community
