====== 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

====== New Instructions using Live Image and NVMe SSD ======

  - Prerequisites
    - MicroSD card for UEFI image
    - USB disk for Fedora live ISO
    - NVMe SSD as system drive (installation target)
  - 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-Live-Rawhide-//...//.n.0.aarch64.iso image from [[https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Workstation/aarch64/iso/]]
    - 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
      - Install Fedora to NVMe SSD (do not reboot after install is completed)
      - Open a Terminal
        - `cd /mnt/sysroot/boot/dtb/rockchip/`
        - `sudo cp rk3588s-rock-5c.dtb rk3588s-radxa-cm5-rpi-cm4-io.dtb`
        - `sudo reboot now`
      - TODO FIXME

===== Building DTBs =====

  * ''sudo dnf group install development-tools''
  * ''%%git clone --single-branch --branch rk3588s-radxa-cm5-rpi-cm4-io --depth 1 %%https://github.com/ndoo/linux.git%%%%''
  * ''make defconfig''
  * ''make -j$(nproc) dtbs''
  * ''sudo cp arch/arm64/boot/dts/rockchip/rk3588s-radxa-cm5*.dtb /boot/dtb/rockchip/''