Screen Revision DTB Instructions - RetroGFX/UnofficialOS GitHub Wiki
These are steps to get UnofficialOS working on units with new screen revisions. Most units have had the new screen revisions added already. Please be aware that if you swap the dtb file, some things may not work as expected if the dtb is not an officially built by us, and therefor offer no support. They are not guaranteed to work, but usually will. UnofficialOS uses multi-dtb install images, so one image supports multiple devices with the same chipset. The dtb being replaced has to be the exact dtb for the unit you are using, so make sure you replace the correct dtb. DO NOT delete the other dtb files, or the system will fail to boot.
Fresh Install
- Flash the image for your unit with your favorite image writing tool (Balena Etcher, Raspberry Pi Imager, Win32 Disk Imager, dd etc.)
- Go into the partition with the extlinux folder or boot.ini file and the DTB files. Copy the new dtb file to the device, and REPLACE the existing dtb on the SD card with the new one. MAKE SURE that you name the dtb exactly as the one being replaced, or the system will not pick it up.
- Insert the SD card into the unit, and boot normally. The screen should function as normal.
Manual or OTA Update
- Update by either Over the Air (OTA) updates, or via the TAR method.
- Allow the device to restart and boot as it normally would.
- Shut down the device safely if possible. The inputs to shut down without being able to see the screen are as follows: START > D_PAD UP > A > D_PAD UP > D_PAD UP > A > A. This will safely shut the device down without risking SD corruption.
- Refer to steps 2 and 3 in the Fresh Install instructions above to finish the setup.
We are working on getting all screen revisions added for the units that need them, but for now, this should work to use UnofficialOS on these units. Backup any dtb files on your pc so you have them, especially the stock dtb and/or the full sd image. This can be done with Win32 Disk Imager by using the read function with the sd chosen containing the stock firmware. If for whatever reason your screen stops working, repeating the steps should fix the issue.