====== Mainline Fedora on Radxa CM5 ======

===== Prerequisites =====

  * Radxa CM5
  * Raspberry Pi CM4 I/O board (or any other board that uses the same pinouts for HDMI, USB and microSD)

===== Steps =====

I used rawhide.

  - Prepare physical media
    - Download radxa-cm5_UEFI_Release_v//...//.img from [[https://github.com/kwankiu/edk2-rk3588/releases]]
    - Write to a microSD card, insert into Radxa CM5
    - Download Fedora-Workstation-Disk-Rawhide-//...//aarch64.raw.xz  image from [[https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Workstation/aarch64/images/]]
    - Write to USB disk, insert into Radxa CM5
  - First boot (ACPI mode)
    - Power on Radxa CM5
    - Press F2 within 5 seconds to enter UEFI Setup
      - If the display is not at the native resolution of your monitor, 
        - Device Manager -> Rockchip Platform Configuration -> Display -> Preferred Mode
        - Set it to the actual native resolution of your LCD instead of Native
        - Press F10 -> Y to save the settings
        - Press Ctrl + Alt + Del to reset the system
    - Wait for Fedora to boot\\ **Be very patient, especially if your USB disk is slow**
      - There will be no boot progress indication, it will take several minutes to boot into the desktop environment
      - Gnome shell will take a few more minutes to load
      - You may see an “Oh no! Something has gone wrong.” pop up, you can ignore it, continue waiting
      - The Fedora welcome and first-time setup dialog will eventually appear
      - Finish the first-time setup
  - Prepare DTB
    - Open a Terminal window
    - `cd /boot/dtb/rockchip`
    - `cp rk3588s-rock-5c.dtb rk3588s-radxa-cm5-rpi-cm4-io.dtb`
    - Reboot the system
    - Press F2 within 5 seconds to enter UEFI Setup
    - Device Manager -> Rockchip Platform Configuration -> ACPI / Device Tree
      * Config Table Mode: Device Tree
      * Compatibility Mode: Mainline
      * Force UEFI GOP Display: Disabled
      * Support DTB override & overlays: Enabled
      * Firmware Fix-ups: Enabled
    - Press F10 -> Y to save the settings
    - Press Ctrl + Alt + Del to reset the system
  - Install Fedora to eMMC
    - TODO FIXME