-
Notifications
You must be signed in to change notification settings - Fork 110
Home
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!
- 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.
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.
- 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
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
The screen tearing fix is disabled by default for compatibility reasons. You can enable the screen tearing fix feature in GMenu2X in two ways:
- Globally:
- Go to GMenu2X settings and set the TEfix method to 1, 2, or 3
- 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
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.
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.
NOTE: To disable Autostart, quickly press the
Y
button when the GMenu2X hint box appears on the screen.
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
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
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
- Connect the external device to the handheld with external power
Allows to transfer files
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
Enable serial console (COM port)
On the main
partition, there is a file options.cfg
that can be used to configure the following additional settings:
MODULES_CUSTOM=0 - set 1 if you want to load custom modules defined in file `modules.custom.sh` on `boot` partition
FAT_CHECK=1 - set 0 to disable fsck `boot` partition
BOOT_LOGO=1 - set 0 to disable boot logo
FLIP=0 - Set to 1 to rotate the screen by 180 degrees
INVERT=0 - Set to 1 to invert colors on the screen
TVMODE=0 - set 1 to start handheld in TV-out mode
HOTKEY_CUSTOM=1
- Overview
- Console Hotkeys
- Build Image and SDK
- Build Kernel
- Build uBoot
- Get the prebuilt SDK from GH actions
- Making Games
- Using Docker to Compile Games
- Remote debugging
- Bug Reporting
- Discussions Topics
- Emulator Info
- Homebrew Info
- DosBox Setup
- RetroArch Setup
- GameBoy
- Gameboy Advance
- Arcade
- PlayStation
Themes
- GMenu2X
- SimpleMenu
Frontends
Projects
Modding
- ALL
- V90
- PocketGo
- BittBoy