Getting Started with Raxda Rock – How to Generate and Flash Ubuntu Saucy Server and Desktop Images

I’ve already written a guide showing how to build and install Android in Radxa Rock. Today I’m going to build the Linux kernel, generate a Ubuntu server images based latest Ubuntu Linaro server release, flash the image to the NAND flash, and show how to install LXDE or XFCE desktop environment. If you are just interested in installing one of the latest supported images, you can download Android, dual boot (Android/Ubuntu), Ubuntu ALIP, and Router images for Radxa Rock @ http://dl.radxa.com/rock/images/, and skip “build” and “generate” instructions, and just follow the flashing instructions below. All steps in this tutorial will be done in Ubuntu 13.10, and lots of the instructions below follow hwswbits blog and Ubuntu Radxa Wiki.

Build the Linux kernel

Let’s start by building the Linux kernel. I’m assuming you’ve already install development tools in Ubuntu (e.g. apt-get install build-essentials). You can refer to the list at the beginning of the Radxa Rock Android post for packages to install with apt-get.

Let’s create a working directory, get the code, and build the kernel.

mkdir radxa_ubuntu
cd radxa_ubuntu


At this stage, we’ve build the kernel. However, if we use it as is, DNS and some other network functions will not work because CONFIG_ANDROID_PARANOID is enabled in the default config file. Run make arch=ARM menuconfig, and go to Networking support -> Networking options to disable Only allow certain groups to create sockets. Run make again:


Let’s complete this section, by building the kernel modules:

Generate Initrd

The initrd is used at boot time to speed up boot among other things.

Generate Boot.img

In order to create boot.img which will be flashed in the boot partition, we need to download mkbootimg tool, and run the following commands:


That’s all good as we should now have a working boot.img. I’ll upload my boot.img soon. You  can download boot-radxa-20140127.img.xz.

Generate Ubuntu (Linaro) Server Rootfs

We will first create an empty 1GB file (rock_rootfs.img), format it to EXT-4, and mount it as a loop device:


I’ll download and extract the latest Ubuntu Saucy server image from Linaro available as today:


Now we need to copy the kernel modules and firmware to our rootfs:


I’d like Ethernet to work at boot time with DHCP so I edit the relevant file:


and add the two lines:


If you’ve already referred to Radxa Rock Ubuntu wiki, at this stage they use qemu and chroot to install extra package, I’ll skip that part, because it can be done inside the board instead, and I came across some error with qemu when accessing the network:


We still have one more step to create and enable a script to automatically detect the rootfs partition at boot time.


And copy the following to the file:


Make sure the script is executable and edit one of the startup script:


And add the line below before exit 0:


We are done, let’s umount the rootfs:


I’ll upload my Ubuntu Saucy Server rootfs soon.  Download link for Ubuntu Saucy server rootfs: radxa_rock_ubuntu_server_saucy_20140127.img.xz (95.4 MB)

Flashing Ubuntu to Radxa Rock

Now that we’ve got boot.img and rock_rootfs.img, we are ready to flash Ubuntu to the board. If you’ve haven’t installed it already, install RKFlashKit, press the recovery button on Radxa Rock, start RkFlashKit, and flash boot.img and rock_rootfs.img respectively to “boot” and “linuxroot” partitions.
Flash_rootfs_radxa_rockClick on Reboot device, and you should be able to access the console via HDMI or the serial console.

Ubuntu Saucy Server Available RAM and storage

SSH is not installed, but you can call install dropbear or ssh if you want to access the board remotely:


You can now SSH the board with linaro user using the password: linaro.

We’ve got plenty of available RAM:


But there’s only a 1GB flash partition usable with 409MB available.


However, there’s also a 4GB “user” partition:


We can mount it as follows:


And get some extra space:


But we’d still only get 5GB out of a 8GB NAND flash, and there’s not enough space on the rootfs to install a desktop environment.

Increasing Radxa Rock Ubuntu Rootfs Partition Size

Let’s see what can be done to get rid off useless Android partition, and get a 7GB rootfs.

First we need to modify the Android parameter file to change the MTD layout for linux (parameter-linux). Refer to the Android post to get the parameter files in rockdev directory.


Edit parameter-linux as follow with only 2 partitions for boot.img and rock_rootfs.img (linuxroot):

FIRMWARE_VER:4.2.2
MACHINE_MODEL:radxa_rock
MACHINE_ID:007
MANUFACTURER:RADXA
MAGIC: 0x5041524B
ATAG: 0x60000800
MACHINE: 3066
CHECK_MASK: 0x80
KERNEL_IMG: 0x60408000
#RECOVER_KEY: 1,1,0,20,0
CMDLINE:console=ttyFIQ0 console=tty0 root=/dev/block/mtd/by-name/linuxroot rw rootfstype=ext4 init=/sbin/init initrd=0x62000000,0x00800000 mtdparts=rk29xxnand:0x00008000@0x00002000(boot),0x00E00000@0x00A000(linuxroot)

Now get the upgrade_tool (download link), enter recovery mode and flash the parameter file:


Start RkFlashKit again to flash boot.img and rock_rootfs.img again. This time, you should only see two partitions in the tools: boot and linuxroot.

However, the first time I tried to flash rock_rootfs.img, I got the following error message in RkFlashKit:


And after reboot, in the serial console, I got quite a few error message similar to:


A low level format, before using RkFlashKit, and flashing the parameter file fixed the issue:


You may want to run the command above first in any case, because flashing rock_rootfs.img takes nearly 30 minutes… If you do so, the low level format command must be done before flashing all other files in including the parameter, boot, and rootfs files.

After flashing is completed, reboot the board. You’ll notice the rootfs is still 1GB. Simply resize the EXT-4 partition:


Let’s check:

root@linaro-server:~# df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/mtdblock1  7.3G  546M  6.4G   8% /
udev            924M   84K  924M   1% /dev
none            4.0K     0  4.0K   0% /sys/fs/cgroup
none            186M  260K  185M   1% /run
none            5.0M     0  5.0M   0% /run/lock
none            927M     0  927M   0% /run/shm
none            100M     0  100M   0% /run/user

Yes! Success! The rootfs partition is 7.3 GB with 6.4GB available.

Installing LXDE or XFCE Desktop Environment

If you just plan to use Radxa Rock as a server, you are done, but if you want to run a desktop environment one more step is needed. Since there are no GPU Linux drivers in RK3188 based devices, installing Unity is probably a very bad idea and would lead to poor performance. Two other lightweight desktop environments are frequently used: LXDE in distributions such as Lubuntu or ALIP, or XFCE in distributions such as Xubuntu.

The good news is that installation is very easy, but it can take a few hours to download and install all required packages. So if you want to skip the part below, you can download the compressed rootfs with Xubuntu-Desktop to flash directly to your board.

Lubuntu (LXDE) requires 378 MB of archives and 1166 MB of additional disk space, and can be installed with the following command:


Xubuntu (XFCE) requires 452 MB of archives and 1370 MB of additional disk space, and can be installed with the following command :


I decided to install Xubuntu desktop, and it took 2 to 3 hours. I’ll upload my Ubuntu Saucy XFCE rootfs soon if you want to skip that part.

Once installation is complete we still have 4.5GB free, but somehow it used nearly 2GB additional space, instead of the 1370 MB promised.


At boot time, you get the the login screen (use “linaro” user with “linaro” password), and the system is very usable. I’ve opened several programs including Gimp, Firefox, Abiword, a terminal window, a game, a music player, and more (See screenshot below), and  everything runs pretty smoothly. Stability may need to be improved however, since I’ve got one random reboot as I accessed SAMBA shares. I could not reproduce the issue.

Xubuntu in Radxa Rock (Click for Original Size)
Xubuntu in Radxa Rock (Click for Original Size)
Share this:

Support CNX Software! Donate via cryptocurrencies, become a Patron on Patreon, or purchase goods on Amazon or Aliexpress

ROCK 5 ITX RK3588 mini-ITX motherboard
Subscribe
Notify of
guest
The comment form collects your name, email and content to allow us keep track of the comments placed on the website. Please read and accept our website Terms and Privacy Policy to post a comment.
46 Comments
oldest
newest
dr. Bormental
dr. Bormental
10 years ago

screenshot from youtube (w/statictic activated would be good).

dr. Bormental
dr. Bormental
10 years ago

dr. Bormental :
statictic

->statistics

Murat
Murat
10 years ago

Hope one day they’ll have gpu acceleration that also works in other rk3188 sticks.

Toby Wintermute
10 years ago


The Ubuntu server link is coming back as “Page Not Found” now.

Alex
Alex
10 years ago

Great work, thank you! This is the first source to read of the command to flash the parameter file under Linux. However, I did the whole process and it left me with a command line and no network connection although I configured the wired network interface correctly. The Radxa Rock system could be pinged from outside within my home network using its IP address, but could not ping out (error message “Socket – access denied” even as root) and could not resolve a network address (host google.com — timeout; could not the apt addresses for apt-get update). Looks like a… Read more »

Alex
Alex
10 years ago


Thanks a lot for the quick reply. It must be deep in the night in Thailand.
As I said, I could not open your packages so I used a self-compiled kernel.
I am not sure about CONFIG_ANDROID_PARANOID, but I thought I did that. But then maybe I used a different boot.img from an earlier attempt or an original from radxa.

I will try it again!

Marty
Marty
10 years ago

Can boot.img and rock_rootfs.img be flashed to the RK3188 using Windows?

Marty
Marty
10 years ago


You have the Linux parameter file here:

http://dl.radxa.com/rock/images/ubuntu/2013-12-17/

will this change when I use my own compiled boot.img and rock_roofs.img for Linux?

Cristian
Cristian
10 years ago

Hello, Great Post!! I make my firsts testing with Linaro on ARM, I have a question, if posible (via Windows) to make a copy to .IMG file of the running image ?? That is because I use 4 or 5 for office basic use, and change various settings as language, wifi settings, etc.
Thanks, Cristian.
Argentina.

Gilles
Gilles
10 years ago

Is it possible to install the images on a micro SD card (with dd) and boot from that card without altering the onboard NAND memory? Just like on the Cubieboard.
Thanks.

Marty
Marty
10 years ago

I’ve had past success flashing the CX-919 in Windows using RkAndroidTool. So with that I need to flash my newly built boot.img and rock_rootfs.img along with the standard parameter file from above. What are the Adresses we should be using?

I used this setup, but it loads slow:

Address Name Path

0x00000000 parameter parameter
0x00008000 boot boot.img
0x00382000 linuxroot rock_rootfs.img

thehid
thehid
10 years ago

Hey cnxsoft, I wrote to you on an other articel. You advised to use the Minix X7 SDK for building a wheezy or ubuntu image. I just downloaded the SDK and extracted the files, bit they looks like the other kernels for rk3188 on github. Would you give me a some more hints, how to build the kernel and boot.img. The rest seems to be manageable with this articel. Many thanks for your help!

Marty
Marty
10 years ago


Are the addresses I’m using the right ones? Maybe rootfs should go in System which is 0x00282000??

Cristian
Cristian
10 years ago

Hello How are you… Can any help me to configure RKAndroidTool to flash my own kernel, I having problems to flash (with RKAndroidTool v1.37 ) my built boot.img (12.960 MB) and rock_rootfs.img (1.048.576 MB) along with the parameter file: CMDLINE:console=ttyFIQ0,115200 console=tty0 root=/dev/block/mtd/by-name/linuxroot rw rootfstype=ext4 init=/sbin/init initrd=0x62000000,0x00800000 mtdparts=rk29xxnand:0x00008000@0x00002000(boot),-@0x0000A000(linuxroot) Address Name Path 0×00000000 parameter parameter 0×00008000 boot boot.img 0×00382000 linuxroot rock_rootfs.img This are error on RKToolkit LOG are: ——————————- 02:27:55 145 INFO:Start to erase IDB 02:27:55 146 INFO:Start to lower format 02:28:06 175 INFO:Lower format OK 02:28:06 177 INFO:Erasing IDB OK 02:28:09 960 Image Thread Path(\\?\USB#VID_2207&PID_310B#6&380B6F11&0&1#{a5dcbf10-6530-11d2-901f-00c04fb951ed}),ThreadID=6184 02:28:09 961 INFO:Start to test device… Read more »

Ze Sousa
Ze Sousa
10 years ago

Hello. Please help. I bought the rock and I want it to be my Desktop Linux computer, but always worked on Windows so don’t understand much of this. I followed the section “Increasing Radxa Rock Ubuntu Rootfs Partition Size” because 1GB is not enough for a decent Operating system and when started the rock, it gave me the following errors in startup command line after a while: mount: mounting /dev/block/mtd/by-name/linuxroot on /root failed: Invalid argument (… some more mount errors…) (initramfs) Googling it for linux I only find comments like “put the CD wathever and run these commands”. But I’m… Read more »

Ze Sousa
Ze Sousa
10 years ago


Hi,

I made it from Windows using RKAndroidTool.
I find that RKFlashKit as a Linux app, I don’t have a Linux machine.

Ze Sousa
Ze Sousa
10 years ago

Ze Sousa :

Hi,
I made it from Windows using RKAndroidTool.
I find that RKFlashKit as a Linux app, I don’t have a Linux machine.

More specifically:

** start
1. open RKAndroidTool and connect the rock
2. erase IDB
3. run parameter file changed acoordingly to this tutorial
4. run files linuxroot and boot (only)
** end

Is anything missing here?

Ze Sousa
Ze Sousa
10 years ago


Yes, in the verification after run linuxroot and boot.
But ran it again and everything gone OK.
I’ll do it again step by step and write down any errors or warnings here.

Ze Sousa
Ze Sousa
10 years ago

Ze Sousa :

Yes, in the verification after run linuxroot and boot.
But ran it again and everything gone OK.
I’ll do it again step by step and write down any errors or warnings here.

This time everything went OK.
Sorry for everything, thank you for your time.

vk4tux
vk4tux
10 years ago

whoever built
radxa_rock_lubuntu_desktop_140626_sdcard.zip
26-Jun-2014 20:54

should be shot for not adding cdc-acm usb support, Its the worst arm package out there.
Sorry I ever got a RadXa.

Board27
Board27
10 years ago

Hi ,first thanks for the complete tutorial.(the first one that i’ve ever seen) Finally i’ve got here the Rock Pro and just flashed NAND following your istructions with the rootfs img and boot img. (i’ve used RKDevelopment toll for Win) It doesn’t turn on. It remain off status after flash. Maybe i have to add parameter file to tell where the root is? (but shouldn’t be done by .sh script?). Anyway since Ubuntu One file server is down, where can i get those two images to be sure i’ve not make any mistake?

Thanks in advance!

Regards

Kilo01
Kilo01
10 years ago

Hi, i’ve just flashed the ubuntu server image from radxa with Bathtools for Win.(i have a radxa pro) Then ssh to it to use it. Can you help me to add snd-usb-audio module and other audio package related? I’ve tried in 1000 ways but stil nothing. I’ve tried to setup up kernel source dir, make menuconfig added sound modules, make , make modules, make modules_install and make install. Everything seems to work during installation of the new kernel, but as soon as reboot, i’ve tried lsmod |grep snd …no trace of snd-usb-audio and sound modules anyway. I don’t know what… Read more »

Kilo01
Kilo01
10 years ago

Thanks,i’ll give it a try again. As soon i’ll get a USB/TTL to know what is going on over there.

Thanks for all.

vk4tux
vk4tux
9 years ago


Yes I did , but if you build an image for arm, including cdc-acm is basic requirement.

Michelangelo
Michelangelo
9 years ago

Is possible to install ZeroShell on Radxa?

marco
marco
6 years ago

hello i try to flash the radxa in a virtual machine in my macbook after the flash fails all i got is this:

mark@mark-VirtualBox:~/Desktop/Linux_Upgrade_Tool_v1.21$ sudo ./upgrade_tool
List of rockusb connected
DevNo=1 Vid=0x2207,Pid=0x310b,LocationID=103 Maskrom
Found 1 rockusb,Select input DevNo,Rescan press ,Quit press :q

mark@mark-VirtualBox:~/Desktop/Linux_Upgrade_Tool_v1.21$ sudo ./upgrade_tool lf
The Device did not support this operation!

mark@mark-VirtualBox:~/Desktop/Linux_Upgrade_Tool_v1.21$ sudo ./upgrade_tool uf /Desktop/radxa_rock_pro_ubuntu_14.04_desktop_fhd_140823_update.img
Loading firmware…
Loading firmware failed!

Boardcon Rockchip RK3588S SBC with 8K, WiFI 6, 4G LTE, NVME SSD, HDMI 2.1...