Skip to main content

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

All documentation followed by Tai. These come w/ 20221216 or 20221224 firmware specific instructions for the Miyoo Mini V3

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 official thread it is here: https://www.reddit.com/r/MiyooMini/comments/104qbak/community_firmware_patch_for_new_devices/?sort=new

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

Official Instructions Below

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.

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.
Misc / Optional for those w/ 3D printers

1. Better Shoulder Buttons (Resin Printer Only)

https://www.thingiverse.com/thing:5422756?fbclid=IwAR3wYwFHE8u9aMYB9TKvuPvuKTGEvZgeqSSwVD5HAZTReKVpZ0Ggb6eptx0

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

2. Screen Protector (Any 3D Printer)

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