Skip to content
tiopex edited this page Sep 12, 2024 · 114 revisions

miyoo-cfw

The definitive custom firmware for BittBoy, PocketGo, PowKiddy V90-Q90-Q20 (and 3rd party consoles) allows you unlock the potential of the hardware and use software from a wide variety of consoles and computers thanks to the availability of numerous emulators and native ports of several games!


miyoo-consoles

Compatible Consoles

  • BittBoy v1, v2, v2.5, v3, v3.5
  • Pocket Go
  • PowKiddy Q90
  • PowKiddy V90
  • PowKiddy Q20 Mini
  • Sup M3 v1, v2 (See notes)
  • XYC Q8
  • RS-77 (Not confirmed)
  • Powkiddy X7 (Not confirmed)

Notes: Only devices with Allwinner F1C100S or F1C500S SOC are supported and even these can come with not fully compatible components (e.g. unfamiliar LCD display). There were reports of console revisions with "updated" SOC - F1E200 or V100.

The Not confirmed consoles are not supported yet, these consoles are under revision and may not be on the final compatibility list.


General Information

SD Card

Is highly recommended to NOT use the SD card included in the package with the console or unbranded ones, it can be corrupted easily without reason due its bad quality. We recommend to use the common brands, 2GB minimum and class 10 for faster install process.


Shutting down the console

  • Version 2.0.0 uses the BTRFS file system to prevent data corruption during an unsafe shutdown. This system automatically writes data every 5 seconds, so if you save a game and immediately turn off the console, the save may be lost. Therefore, it is safe to wait at least 5 seconds before shutting down the system or to perform a proper shutdown procedure.
  • To safely shut down the console:
    • Exit from the emulator or game you are playing to return to the main menu (gmenu)
    • Hold the Start button to open the Power Menu
    • Press A to shut down
    • Alternatively, you can go to the settings section and use the "Shutdown" icon or use the Quick Shutdown Hotkey
    • When the screen turns black, flick the power switch

Screen timeout/sleep mode

This only applies while in the main menu:

  • Pressing the R/Reset button will put the device into sleep/suspend mode
    • Press R/Reset again to wake it up
  • The default screen timeout is 30 seconds, after this the screen will go black (the device will go to sleep)
  • Power timeout is disabled by default

Screen tearing fix

The screen tearing fix is disabled by default for compatibility reasons. You can enable the screen tearing fix feature in GMenu2X in two ways:

  1. Globally:
  • Go to GMenu2X settings and set the TEfix method to 1, 2, or 3
  1. Per app:
  • For a specific app, press "Select," choose "Edit," and set the TEfix method to 1, 2, or 3

NOTE: Choose the best TEfix method for your particular handheld's LCD panel. Some methods may not work correctly for you. Additionally, there may be a small FPS drop when TEfix is enabled


IPK Support

Miyoo supports installing IPK packages for apps, emulators, and games. To install an IPK, simply copy the IPK file (e.g., drpocketsnes.ipk) to the main partition. Then, run the GMenu2X explorer, select the IPK file, and install it.


Autostart

To enable the Autostart feature, go to GMenu2X settings and set Autostart to ON. Next, choose the app you want to autostart. When you quit the app, the handheld will shut down. After rebooting, the selected app will autostart. To disable Autostart, quickly press the Y button when the GMenu2X hint box appears on the screen.

TV-out mode

Miyoo supports TV-out mode. To enable TV-out, run "TVout ON/OFF" from the Apps section. The handheld will reboot and start working in TV-out mode

NOTE: To quickly exit TV-out mode, hold the select button after fully booting into GMenu2x


Supported USB modes

USB HID

Turn your handheld into USB gamepad for PC/Android

- Connect handheld to PC via USB
- Run this USB HID app
- Now you should be able to control PC/phone via handheld buttons
- Press RESET button to leave USB HID mode

USB Host

Allows to connect external device (keyboard, mouse, gamepad) to the handheld

- You need such cable to supply power from the charger to the external device since handheld doesn't provide it

366388842-7c04e30f-57fc-4c35-bb69-cdbcb6974b54 (1)

- Connect the external device to the handheld with external power

USB MTP

Allows to transfer files

USB Network

Enable network on the handheld

- IP address of handheld: 192.168.137.1
- After enabling this mode you can start FTP server app or SSH server app

USB Serial console

Enable serial console (COM port)


Alternative to access the "main" BTRFS partition on Windows (SD card)

BTRFS driver for windows

Clone this wiki locally