Skip to content

Ubuntu 22.04 LTS

Jump to bottom
Joshua Riek edited this page Jul 30, 2024 · 8 revisions

System Customization

How to make general system modifications.

Changing the Linux Boot Parameters

If your application or configuration requires specific arguments, you can simply modify the file /etc/kernel/cmdline and use the u-boot-update utility to update the extlinux configuration file.

ubuntu@ubuntu:~$ sudo nano /etc/kernel/cmdline

After updating the Linux kernel boot arguments, run the u-boot-update utility to update the bootargs passed the Linux kernel on the next reboot.

ubuntu@ubuntu:~$ sudo u-boot-update

Changing the Device Tree

If you need to load a different device tree, you can use the u-boot-update utility and open the file /etc/default/u-boot. Modify the variable U_BOOT_FDT with a device tree as shown in the example below:

U_BOOT_FDT="device-tree/rockchip/rk3588s-orangepi-5.dtb"

After updating the device tree variable, run the u-boot-update utility to update the device tree to be loaded on the next reboot.

ubuntu@ubuntu:~$ sudo u-boot-update

Using a Device Tree Overlay

If you need to load a device tree overlay, you can use the u-boot-update utility and open the file /etc/default/u-boot. Modify the variable U_BOOT_FDT_OVERLAYS with a device tree overlay as shown in the example below:

U_BOOT_FDT_OVERLAYS="device-tree/rockchip/overlay/rk3588-i2c0-m1.dtbo"

After updating the device tree overlay variable, run the u-boot-update utility to update the overlay to be loaded on the next reboot.

ubuntu@ubuntu:~$ sudo u-boot-update

Freeze the Linux Kernel

If you would like to prevent the Linux kernel from updating, please enter the below command.

ubuntu@ubuntu:~$ sudo apt-mark hold linux-rockchip linux-image-rockchip linux-headers-rockchip linux-tools-rockchip

Install U-Boot to the SPI Flash

Booting directly from a USB or NVMe requires flashing U-Boot to the SPI, simply enter the below command:

ubuntu@ubuntu:~$ sudo u-boot-install-mtd

Install U-Boot to an SD Card or eMMC

Installing the latest bootloader version to your SD Card or eMMC can be done with the below command:

ubuntu@ubuntu:~$ sudo u-boot-install /dev/mmcblkX

The SD Card is /dev/mmcblk1 while the eMMC is /dev/mmcblk0.

Install Ubuntu onto an NVMe from Linux

The ubuntu-rockchip-install command can copy your currently running system onto an NVMe.

ubuntu@ubuntu:~$ sudo ubuntu-rockchip-install /dev/nvme0n1

If applicable, install U-Boot to the SPI Flash with u-boot-install-mtd.

Install Ubuntu onto an eMMC from Linux

The ubuntu-rockchip-install command can copy your currently running system onto an eMMC.

ubuntu@ubuntu:~$ sudo ubuntu-rockchip-install /dev/mmcblk0

Source Code

Important packages used in the Ubuntu Rockchip ecosystem, all which are available on GitHub and packaged on Launchpad.

Kernel Package

Kernel source code.

Kernel Meta Package

Meta Linux packages for automated kernel upgrades.

Ubuntu Rockchip Settings Package

This package contains some default system level settings and hacks that are specific to Ubuntu Rockchip.

Ubuntu Rockchip Meta Package

This package depends on all of the packages in the Ubuntu Server or Desktop system for Ubuntu Rockchip.

Clone this wiki locally