joshua-riek / ubuntu-rockchip

Ubuntu 22.04 and 24.04 for Rockchip RK35XX Devices

Overview

This project aims to provide a default Ubuntu experience for Rockchip RK3588 devices. Get started today with an Ubuntu Server or Desktop image for a familiar environment. For additional information about this project or a specific device, please take a look at the documentation available on the Wiki.

The supported devices are undergoing continuous development. As a result, you may encounter bugs or missing features. I'll do my best to update this project with the most recent changes and fixes. If you find problems, please report them in the issues or discussions section.

Highlights

• Package management via apt using the official Ubuntu repositories
• Receive kernel, firmware, and bootloader updates through apt
• Desktop first-run wizard for user setup and configuration
• 3D hardware acceleration support via panfork
• Fully working GNOME desktop using wayland
• Chromium browser with smooth 4k youtube video playback
• MPV video player capable of smooth 4k video playback
• Gstreamer can be used as an alternative 4k video player from the command line
• Ubuntu 22.04 LTS with Rockchip Linux 5.10
• Ubuntu 24.04 LTS with Rockchip Linux 6.1

Supported Boards

• ArmSoM-Sige7
• ArmSoM-w3
• Indiedroid Nova
• ROC-RK3588S-PC
• LubanCat 4
• Mixtile Blade 3
• Mixtile Core 3588E
• NanoPC T6
• NanoPi R6C
• NanoPi R6S
• Orange Pi 5 Plus
• Orange Pi 5 Pro
• Orange Pi 5B
• Orange Pi 5
• Orange Pi 3B
• Radxa CM5 IO
• Radxa NX5 IO
• Radxa ROCK 5 ITX
• Radxa ROCK 5A
• Radxa ROCK 5B
• Radxa Zero 3
• Turing RK1

Installation

Make sure you use a good, reliable, and fast SD card. For example, suppose you encounter boot or stability troubles. Most of the time, this is due to either an insufficient power supply or related to your SD card (bad card, bad card reader, something went wrong when burning the image, or the card is too slow).

Download the Ubuntu image for your specific board from the latest release on GitHub. Then write the xz compressed image to your SD card using balenaEtcher since, unlike other tools, it can validate burning results, saving you from corrupted SD card contents.

Boot the System

Insert your SD card into the slot on the board and power on the device. The first boot may take up to two minutes, so please be patient.

Login Information

For the server image you will be able to login through HDMI, a serial console connection, or SSH. The predefined user is ubuntu and the password is ubuntu.

For the desktop image you must connect through HDMI and follow the setup-wizard.

Support the Project

There are a few things you can do to support the project:

• Star the repository and follow me on GitHub
• Share and upvote on sites like Twitter, Reddit, and YouTube
• Report any bugs, glitches, or errors that you find (some bugs I may not be able to fix)
• Sponsor me on GitHub; any contribution will be greatly appreciated

These things motivate me to continue development and provide validation that my work is appreciated. Thanks in advance!

ubuntu-rockchip's Issues

sound issues with web browsers

install image then set up everything a sweet ....reboot ....wheres all my programs and settings? .....booting from sdcard had this happen on both 1.5 and 1.6

Kodi

I was keen to see if Kodi would be able to play videos with hardware acceleration and followed the Kodi wiki to install a stable latest version and also latest nightly dev builds but whilst the process seems to complete, no app icon is created in order to run it.

I am only able to install an old 19.4 release that has no hardware accelerated playback.

hdmi not connected before login screen will not use wayland

If you power on your Orange Pi 5 with either desktop image without plugging in an HDMI cable the system will only use X11.

kernel: ashmem and binder? waydroid

waydroid/waydroid#136 similar issue?... different distro

sudo modprobe binder_linux modprobe: FATAL: Module ashmem_linux not found in directory /lib/modules/5.10.110-orange-pi modprobe: FATAL: Module binder_linux not found in directory /lib/modules/5.10.11

when trying to run waydroid:

ubuntu@orange-pi:~$ waydroid show-full-ui [02:43:20] Starting waydroid session [02:43:20] Failed to start Clipboard manager service, check logs [gbinder] Service manager /dev/binder has appeared [gbinder] WARNING: Service manager /dev/binder has died

terrified to mod the kernel or mod the kernel with outdated instructions that get a 404 on github

RTC time not work Perfectly

Helo,
I report the new finding about RTC, actually I realized it has happened since Ubuntu22.04 V1.5, now I'm using V1.7.
here is the detail :
I power-on at 6:00 (28/Feb/2023) the clock is update by internet time, then I shutdown the board in 8:00, and then I power on again in 16:30 without internet connection, the board clock is 1:00 and the date still the same (28/Feb/2023)
This is very important that the board clock always update while no internet connection, hope this will got your attention, Thank

USB boot does not work for me

I noted in the notes for v1.6 that USB booting had been enabled but having tried both this and v1.7 and all 4 USB ports, I was unable to get it to work.

hdmi not connected before login screen disables wayland

If you power on your Orange Pi 5 with either desktop image without plugging in an HDMI cable the system will only use X11.

An error appears when installing other language packs.

It's good to use right now, but to report a bug to make the good OS even better, I don't know if it's the case when adding other languages, but if I add Korean, an error occurs when downloading Thunderbird's Korean language pack.

So I can't apply the language pack, and I have to delete Thunderbird and install the language pack to install successfully.

Thanks for providing a fantastic OS.

Boot from SD card not working,10minites

Boot from SD card not working,10minites

reboot not working

Hi, I found that the ubuntu cannot reboot. OS: v1.8 desktop.

Dragging GPU-accelerated windows around in the Ubuntu 22.04 release is slow and laggy.

When dragging GPU-accelerated windows such as chromium or glmark2 around in the Ubuntu 22.04 release cause the window to lag.

feature request: special wifi support

im struggling im trying to get this driver to work can you bake it into the next release? they sold it to me at micro center in the pi isle sucks it dont work i keep getting errors on compile .....it was literally to cheap to be worth the hr drive $9
i would be eternally grateful

https://github.com/blahah/ralink_RT5370_linux_driver

make -C tools make[1]: Entering directory '/home/ubuntu/Downloads/stuff/ralink_RT5370_linux_driver-master/tools' gcc -g bin2h.c -o bin2h make[1]: Leaving directory '/home/ubuntu/Downloads/stuff/ralink_RT5370_linux_driver-master/tools' /home/ubuntu/Downloads/stuff/ralink_RT5370_linux_driver-master/tools/bin2h cp -f os/linux/Makefile.6 /home/ubuntu/Downloads/stuff/ralink_RT5370_linux_driver-master/os/linux/Makefile make -C /lib/modules/5.10.110-orange-pi/build SUBDIRS=/home/ubuntu/Downloads/stuff/ralink_RT5370_linux_driver-master/os/linux modules make[1]: Entering directory '/usr/src/linux-headers-5.10.110-orange-pi' SYNC include/config/auto.conf.cmd x86_64-binfmt-P: Could not open '/lib64/ld-linux-x86-64.so.2': No such file or directory make[3]: *** [scripts/kconfig/Makefile:71: syncconfig] Error 255 make[2]: *** [Makefile:627: syncconfig] Error 2 make[1]: *** [Makefile:738: include/config/auto.conf.cmd] Error 2 make[1]: Leaving directory '/usr/src/linux-headers-5.10.110-orange-pi' make: *** [Makefile:389: LINUX] Error 2 ubuntu@orange-pi5:~/Downloads/stuff/ralink_RT5370_linux_driver-master$

how to use wiringpi?

apt install wiringpi

and

gpio readall
Oops: Unable to determine board revision from /proc/device-tree/system/linux,revision
or from /proc/cpuinfo
-> No "Hardware" line
-> You'd best google the error to find out why.

build errors building arm64,orange pi 5

this is my terminal output:

` DTC arch/arm64/boot/dts/rockchip/overlay/rk3588-dmc.dtbo
MKIMAGE arch/arm64/boot/dts/rockchip/overlay/rk3588-fixup.scr
Image Name:
Created: Wed Feb 8 23:48:47 2023
Image Type: AArch64 Linux Script (uncompressed)
Data Size: 2692 Bytes = 2.63 KiB = 0.00 MiB
Load Address: 00000000
Entry Point: 00000000
Contents:
Image 0: 2684 Bytes = 2.62 KiB = 0.00 MiB
HOSTLD scripts/genksyms/genksyms
scripts/extract-cert.c: In function ‘display_openssl_errors’:
scripts/extract-cert.c:46:9: warning: ‘ERR_get_error_line’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
46 | while ((e = ERR_get_error_line(&file, &line))) {
| ^~~~~
In file included from scripts/extract-cert.c:23:
/usr/include/openssl/err.h:411:15: note: declared here
411 | unsigned long ERR_get_error_line(const char **file, int *line);
| ^~~~~~~~~~~~~~~~~~
scripts/extract-cert.c: In function ‘drain_openssl_errors’:
scripts/extract-cert.c:60:9: warning: ‘ERR_get_error_line’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
60 | while (ERR_get_error_line(&file, &line)) {}
| ^~~~~
In file included from scripts/extract-cert.c:23:
/usr/include/openssl/err.h:411:15: note: declared here
411 | unsigned long ERR_get_error_line(const char **file, int *line);
| ^~~~~~~~~~~~~~~~~~
scripts/extract-cert.c: In function ‘main’:
scripts/extract-cert.c:130:17: warning: ‘ENGINE_load_builtin_engines’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
130 | ENGINE_load_builtin_engines();
| ^~~~~~~~~~~~~~~~~~~~~~~~~~~
In file included from scripts/extract-cert.c:24:
/usr/include/openssl/engine.h:358:28: note: declared here
358 | OSSL_DEPRECATEDIN_3_0 void ENGINE_load_builtin_engines(void);
| ^~~~~~~~~~~~~~~~~~~~~~~~~~~
scripts/extract-cert.c:132:17: warning: ‘ENGINE_by_id’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
132 | e = ENGINE_by_id("pkcs11");
| ^
In file included from scripts/extract-cert.c:24:
/usr/include/openssl/engine.h:336:31: note: declared here
336 | OSSL_DEPRECATEDIN_3_0 ENGINE *ENGINE_by_id(const char *id);
| ^~~~~~~~~~~~
scripts/extract-cert.c:134:17: warning: ‘ENGINE_init’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
134 | if (ENGINE_init(e))
| ^~
In file included from scripts/extract-cert.c:24:
/usr/include/openssl/engine.h:620:27: note: declared here
620 | OSSL_DEPRECATEDIN_3_0 int ENGINE_init(ENGINE *e);
| ^~~~~~~~~~~
scripts/extract-cert.c:139:25: warning: ‘ENGINE_ctrl_cmd_string’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
139 | ERR(!ENGINE_ctrl_cmd_string(e, "PIN", key_pass, 0), "Set PKCS#11 PIN");
| ^~~
In file included from scripts/extract-cert.c:24:
/usr/include/openssl/engine.h:479:5: note: declared here
479 | int ENGINE_ctrl_cmd_string(ENGINE *e, const char *cmd_name, const char *arg,
| ^~~~~~~~~~~~~~~~~~~~~~
scripts/extract-cert.c:140:17: warning: ‘ENGINE_ctrl_cmd’ is deprecated: Since OpenSSL 3.0 [-Wdeprecated-declarations]
140 | ENGINE_ctrl_cmd(e, "LOAD_CERT_CTRL", 0, &parms, NULL, 1);
| ^~~~~~~~~~~~~~~
In file included from scripts/extract-cert.c:24:
/usr/include/openssl/engine.h:450:27: note: declared here
450 | OSSL_DEPRECATEDIN_3_0 int ENGINE_ctrl_cmd(ENGINE *e, const char *cmd_name,
| ^~~~~~~~~~~~~~~
CC scripts/mod/empty.o
HOSTCC scripts/mod/mk_elfconfig
/usr/bin/env: ‘python’: No such file or directory
make[1]: *** [scripts/Makefile.build:273: scripts/mod/empty.o] Error 127
make[1]: *** Waiting for unfinished jobs....
CC scripts/mod/devicetable-offsets.s
/usr/bin/env: ‘python’: No such file or directory
make[1]: *** [scripts/Makefile.build:117: scripts/mod/devicetable-offsets.s] Error 127
make: *** [Makefile:1322: prepare0] Error 2
Error: in ./scripts/build-kernel.sh on line 42
Error: in ./build.sh on line 29
ubuntu@orange-pi:~/Documents/ubuntu-orange-pi5$

`

also i have 3 directories in the build folder linux-orangepi , rkbin ,u-boot-orangepi

it says the image was created so not do i just put i directory into a img file? .....im kinda learning here also for the build dependencies i had to change grub-pc to grub-common ....once i under stand the whole build >theres my image>try it cycle ill be more help i hope

Chromium "has trouble" playing this YouTube video

I've been testing V1.7 for an hour -- I'm impressed.

First problem I found is minor. Chrome has trouble playing this YouTube video at 4K --> https://www.youtube.com/watch?v=bQSX04Hoxs0

Around 2:24 the view change to an overhead camera and Chromium falls apart. Sometimes playback will freeze or drop to one frame every few seconds (key frames?) Other times I'll get a white flash and then playback returns. Occasionally Chromium will hang. Takes many tries for a crash.

I realize the issue may be outside of this port. Just thought I'd should mention it in case it is it is an easy fix...

enable broadcom ap6275p bluetooth

Need to enable Bluetooth for the broadcom ap6275p. Currently, it cant be enabled through the ubuntu settings manager or look for any other Bluetooth devices.

KDE Plasma glitching out

First of all, thanks for making this! However, when I tried to install KDE Plasma on this, it didn't launch at all with SDDM (It just froze up after I entered the password) and with GDM (from Gnome) it launches with a bunch of weird artifacts. Not sure if this is KDE Plasma's problem or anything, but just thought I could get some support. Thanks!

Quake II Yamagi - No Audio

I've installed Quake II Yamagi from the snap store but there's no audio from HDMI nor the audio output jack. I've copied the required directories and PAK files over from the CDROM to the proper location, which on my system is: Home/snap/yamagi-quake2-beidl/current/.yq2

The game otherwise plays fine, just no audio.

Audio Not Working

Hi again, I'm rather new to this whole thing but I think the audio is not working? When I go into the "Sound" in Settings everything is blank.

There is a serious bug for users who using Chinese/Japanese/Korean.

There is a serious bug for users who using Chinese/Japanese/Korean.
There is no problem in Ubuntu for PC, but in Ubuntu for Orange Pi 5,

when connected as a normal user(ubuntu), the input method setting does not work properly.
For Chinese/Japanese/Korean, input methods such as ibus and uim are used.

If I connect as a normal user(ubuntu), the settings cannot be finished and it does not work,
but it works only if you connect as root (change ubuntu's privileges to 0).

Please check.

Thank you.

PCIe WiFi 6.0 Module (AP6275P)

I was pointed to this on another page, but it doesn't fit. oops https://www.amazon.com/gp/product/B08NSSJNV1

Do you know where I can get the official module that you reference in your FAQ? I think Amazon is just out of stock.

Also, sorry for making all of these posts, but I figured they would be better to be separate.

Flash U Boot Instructions - directory missing

Hi!

The directory /usr/share/orangepi/ is missing from release 1.7.

As a result we aren't able to flash the SATA & NVME bootloader's as per the instructions on https://github.com/Joshua-Riek/ubuntu-orange-pi5/wiki/Flash-U-Boot

Boot from SATA m.2 SSD not NVME

Hi, first of all thank you for the fantastic work you are doing and the support for this device.

I'm trying to boot your ubuntu on SATA ssd NOT nvme. Simply writing the .img 1.6 on Sata SSD with balena the system boot but stuck here:

In general distros do not start directly from this type ssd, at actual state of orange-pi5, the process is well described here

I looked inside /boot/ but there are no such files like /boot/orangepiEnv.txt or /boot/ubuntuEnv.txt

I'm available for further tests.

An error appears when installing the Korean language pack immediately after installing Ubuntu.

An error appears when installing the Korean language pack immediately after installing Ubuntu.
However,there is no problem if I install the language pack after updating the system.

xrdp server. login from windows10 got black screen after loginned

xrdp server. login from windows10 got black screen after loginned

I tried many way to mess with the config files, nothing work

in /etc/xrdp/startwm.sh
added
export GNOME_SHELL_SESSION_MODE=ubuntu
export XDG_CURRENT_DESKTOP=ubuntu:GNOME
unset DBUS_SESSION_BUS_ADDRESS
unset XDG_RUNTIME_DIR

in /etc/gdm3/custom.conf
WaylandEnable=false

Bluetooth Issue on Realtek 8821CU

I'm using a USB WiFi/Bluetooth combo dongle. The WiFi chip is a Realtek 8821CU and works fine. Bluetooth works, but only after unplugging and replugging the dongle.

The vendor ID for the Bluetooth is USB\VID_0BDA&PID_C820&REV_0200&MI_00 which is a generic Realtek bluetooth device.

After some searching, I found this very recent thread for implementing a fix: https://ubuntuforums.org/showthread.php?t=2482906
Would it be possible to roll this into the current or next release? Thanks for you hard work. I know you have to be extremely busy.

GPIO doesnt work

Hello, I got an error. Using
sudo gpio mode 2 out
sudo gpio write 2 1
Pin is not powered.
Is it possible that this problem is due to the system?

I can't log in to YouTube with the Chromium web browser.

In version 1.3, I was able to log in to YouTube with the Chromium web browser, but in version 1.4, I cannot log in.

Broadcom AP6275P find no wifi-networks

Broadcom AP6275P find no wifi-networks

I use m.2 wifi module from official orange pi5 ,the "ap6275p"

lshw showed the driver properly installed but cannot find any wifi network to join,
in the settings -> wifi "Visible networks" keep spinning. not a single wifi network show.

Running off NVME

Hi, been trying to get this image onto my NVME. I have been using etcher to clone the SD card onto the NVME on other images I have been using but unfortunately when I have used this image it won't boot. Any suggestions? Thanks

FireFox - No Audio

There's no audio when playing videos with FireFox. I know that isn't something you're likely able to fix but I think I found a solution to both the freezing Chromium issue as well as the FireFox missing audio. I've been a long-time user of the Brave browser on Windows. It's based on Google Chrome and works well in Windows so I installed it on my Pi 5. It works great. No issues with audio/video and no freezing when uploading attachments. Since it's Chrome based it can also use all the plug-ins we enjoy on Chrome.

No cpu.weight

Not sure it is a kernel issue or cpu doesn't support this feature, but don't see cpu.weight in /sys/fs/cgroup/.
Without it I can't run microk8s which was whole point of getting orange pi :(

Orangepi-config missing

Hi, (question from a beginner),

I am using the pre-installed Ubuntu 22.04 desktop/server image for the [Orange Pi 5] from your repository which works amazing!
I added an NVME drive and need to switch boot-device in the Orangepi Configuration tool (from SD to NVME).
Maybe/probably it is me, but I can not find this and the command line does not understand the sudo orangepi-config command.

Any suggestions?

Mouse pointer disappear after wake up on V1.6

I got this while on wayland and x11

I would like to ask, do I have to reinstall the system when I update to version 1.8?

I would like to ask, do I have to reinstall the system when I update to version 1.8? Or, just use apt update and apt upgrade.

Boot from USB not working

It seems like booting from a USB device is not working, a user found this in the discussions thread.

freezing on bootup

First of all, thank you for making this build. It's awesome!

I have been playing with it and see what you mean about uninstalling anything. :)

I have tried to install a few things via command line. Should I use an appstore or is command line better for now. It's just nice to be able to browse. If an app store is ok, which do you suggest.

Lastly, I have installed a few things, again, just playing around a bit and I have now twice gotten to the point where the bootup freezes and won't allow me to log in. I'm pretty sure it was a program that I installed. So, my question is, how can I just boot to a command prompt so I can apt remove the program and see if that helps? Previously, I just blew it away and started fresh, but now that it has happened a second time (with a different program), I'm wondering if there is a way to avoid a total redo.

Thanks again!

Vncserver, Qbittorrent, telegram, firefox

Vncserver Problem
i am using tightvncserver, when connecting to orangepi 5 using smartphone. it keep stuck on connecting screen

then I can't install several applications such as telegram, firefox, and qbittorrent via the terminal. On the terminal displays
Waiting for cache lock: Could not get lock /var/lib/dpkg/lock-frontend. It is heWaiting for cache lock: Could not get lock /var/lib/dpkg/lock-frontend. It is held by process 7716 (apt)

Can I install OBS studio?

I usually do YouTube streaming with my laptop and OBS software, but it would be great if I could do it on an SBC as well.

The 'apt install obs' command was installed without any errors, but when I try to run it, an error occurs.

start ubuntu on nvme

I'm a newbie, I'm using ubuntu on the ssd card but I would like to use nvme, can I migrate directly from ssd to nvme?

Can not run Xorg on v1.9 or v1.8

I tried to Install the fresh V1.9 image and it boot to Gnome-Wayland succesfully,
but when I choose to login with xorg ubuntu it can not load ubuntu-xorg and back to login screen. so I back to use gnome-wayland.
Then I install ubuntu-mate-desktop ( my favourite Desktop) then configure lightdm as default DM, after rebooted it cannot load lightdm loginscreen so I reconfigure the GDM3 as default and the V1.9 image only can gnome wayland and only GDM3 as DM, so I revert to V1.7

CM5 fork?

I don't know if you'd be interested in maintaining a fork of this project for the upcoming Radxa CM5? It also uses the RK3588S.

I believe https://wiki.radxa.com/Special:SpecialContact are providing early access $free dev kits for those that request them & make a good case, in advance of the main release next month.

ROS2 test

Would someone with this hardware be willing to run this script to see if it installs? https://github.com/linorobot/ros2me

Spdif passthrough not available

Hi!

the passthrough options aren't available in pavucontrol (see example in the attachment). Launching VLC from terminal i can see the following error: vlcpulse audio output error: digital pass-through stream connection failure: Not supported

Please let me know if you want to test something or you need more infos

Thanks!

Can not mount exFat usb stick

Can not mount exFat usb stick

got the error
error mouting unknown filesystem type 'exfat'

i tried
"sudo apt install exfatprogs"
but no luck

Monitor Brightness Control

I'm unable to set my monitor brightness under both releases of v1.6 and v1.7. Moving the brightness slider has no effect.

HW acceleration break by connecting two monitors

Connecting two monitors, one with hdmi and one with usb c the 'hardware acceleration breaks down. unplugging the monitor with usb c makes it work again.

usb tethering not working

simply the usb tethering isnt working

GPU rasterization not on in Chromium by default

I noticed that "GPU rasterization" could be enabled in the flags option of Chromium. Once I do that, then all but Vulcan are enabled and green.

Is there any way you could turn that on by default? Or maybe there is a reason to keep it off?

Thanks!

Chromium

When I try to use either Gmail or Yahoo Mail in Chromium and add attachments to an email that I want to send, the interface becomes totally unresponsive after the attachment gets uploaded to the server and I have to kill Chromium. FireFox works without any issues in this regard.