Skip to main content

Miyoo Mini V3 20221216 or 20221224 Firmware Specific Guide for Onion OS

All documentation followed by Tai. This wiki also comes w/ 20221216 or 20221224 firmware specific instructions for the Miyoo Mini V3

0. Backup your official Miyoo SD Card

It's not mentioned on the OnionOS GitHub Installation Guide, but you should back up your official Miyoo SD Card. I just copied all the contents to my PC. It contains BIOS files and the ROMs. The BIOS being more important.

If you want to be extra safe  you can make an image of the offical Miyoo Card w/ a program called WIN32DiskImager on Windows.

image-1673087611871.png

On WIN32DiskImager I plugged in the Official SD Card into my Windows computer. Selected a location to save to. Then clicked "Read" to read the SD card image into my computer.

1. How to Use Higher Capacity MicroSD Cards on Miyoo V3

Skip this step if you're not using a microSD card bigger than 32GB. If you have a card higher than 32GB you'll have to format your higher capacity card in FAT32. I did this with Rufus in Windows. Video below shows you how to format.

2. Follow Onion OS Official Documenation

I followed the "Installing (on an empty SD card)" instructions since I wanted to use my bigger 256GB Samsung MicroSD card.

Official Onion OS GitHub Repository: https://github.com/OnionUI/Onion/wiki/Installation

Only install Onion OS v.4.0.4 or later for firmware versions starting with 20221216 or 20221224. If you don't you may encounter soft brick and have to recover w/ I2C methods. As long as you downloaded 4.0.4 or later you should be safe.

3. Upgrade Firmware from 20221216/2022124 to Hotfix Firmware

This is an important upgrade for our specific units running firmware 20221216XXXX or 20221224XXXX. Do not use this upgrade from any other firmware versions.

Why it is important?
* Reduces the startup time from 20s to 12s.
* Allows system settings to persist after reboot (this is only an issue on 20221216).

As of December 2022 Miyoo was no longer able to source the internal flash chip they were using so they sourced a new chip very similar in functionality, but they didn't immediately receive the additional drivers needed to enable full write functionality with this new chip. This is why the hotfix is solves the two issues above. Learn more here.

If you want to follow the discussion thread it is here: https://www.reddit.com/r/MiyooMini/comments/104qbak/community_firmware_patch_for_new_devices/?sort=new

The actual firmware is downloaded here: https://drive.google.com/drive/folders/1OvmkKEtSMEWv1RY8LPsbDk0ylWzOg_7j?usp=sharing

Official Instructions Below

Notes: Don't be like me and use a USB-C to USB-C cable w/ PD. It only worked w/ a USB-A to USB- C Cable. It's important that you follow all the steps, but especially "Step #3 Delete the firmware file".

Step 1 - Transfer the file
--------------------------

Copy the firmware image (miyoo283_fw.img) to the root of the SD card.


Step 2 - Flash the firmware
---------------------------

IMPORTANT: Do not power off device when upgrade starts

1. Make sure the device is off.

2. Insert the SD card into the device.

3. Insert the charging cable.
   - Do not press the POWER button.
   - It will power on and do the firmware upgrade automatically.

4. Wait for the upgrade to finish (about 2 minutes).

5. Unplug the charging cable when the charging screen appears.
   - Some devices will show "FINAL GATE / UNLOCKED", this is just a themed charging screen.
   - If you wait too long the screen will be off, it is still save to unplug then.
   - After removing the cable, wait for the device to power off.


Step 3 - Delete the firmware file
---------------------------------

IMPORTANT: Delete the firmware file from the SD card after the upgrade!


Notes on charging
-----------------

Use a known good USB-A to C charger.
 

Optional References / Resources Below

Onion Manual Displayed During Install

image-1673087943309.png

GitHub Docs (For More Help)

https://github.com/OnionUI/Onion/wiki 

For those w/ 3D printers

1. Better Shoulder Buttons (Resin Printer Only)

STL Files: https://www.thingiverse.com/thing:5422756

Tutorial: https://vinitleedoes.notion.site/Better-Buttons-Installation-Guide-63e9eb7d93b2453a8c98bdce345ff37f

Discussion Thread: https://old.reddit.com/r/MiyooMini/comments/voi09o/i_designed_better_shoulder_buttons_new_version/

2. Screen Protector (Any 3D Printer)

STL Files: https://www.printables.com/model/240152-miyoo-mini-minimal-flippable-screen-protector