Read First

This guide describes how to make Ubuntu rootfs to work on RZ/G2L, RZ/G2LC, RZ/G2UL evaluation board kit.

There are many steps to make the Ubuntu environment, but the following package includes shell scripts that make the process easy.

r01us0774ec0100-ubuntu-setup-script.pdf
- This document describes the package and how to use the shell scripts.
RZG2L-Ubuntu-Environment_Auto-Scripts_v1.0.ZIP
- This package includes the above document and shell scripts.

Notice

The Ubuntu environment created by using the scripts can be used only for evaluation purpose.

Ubuntu is a registered trademark of Canonical Ltd. Users need to follow Ubuntu IPR policy. For more information, please refer to Ubuntu "Intellectual property rights policy".

SoC: All

Specification

Target Ubuntu OS Version: 20.04, 18.04

Target reference board: RZ/G2L,/G2LC,/G2UL SMARC

Host PC Environment: Ubuntu20.04

Ubuntu Filesystem Building

Install QEMU

Run below command on Host Ubuntu PC

sudo apt-get install qemu-user-static

Download Required Files

Expand

title

...

Download ubuntu-base-20.04.4-base-arm64

$ wget https://cdimage.ubuntu.com/ubuntu-base/releases/20.04/release/ubuntu-base-20.04.4-base-arm64.tar.gz

or

$ wget https://cdimage.ubuntu.com/ubuntu-base/releases/focal/release/ubuntu-base-20.04.4-base-arm64.tar.gz

Download ubuntu-base-18.04.5-base-arm64

$ wget http://cdimage.ubuntu.com/ubuntubase/releases/18.04.5/release/ubuntu-base-18.04.5-basearm64.tar.gz

Prepare Files

In the following example, please replace "version" as below name as you need

ubuntu-base-20.04.4-base-arm64：

...

ExpandInitial preparation

ExpandCreate a new script file

...

Expand

title	Initial preparation

$ mkdir ~/work

$ cd ~/work

$ mkdir root

$ sudo tar -xpf ubuntu-base-<version>-base-arm64.tar.gz -C root

$ sudo cp /usr/bin/qemu-aarch64-static ./root/usr/bin/

$ sudo cp -b /etc/resolv.conf root/etc/resolv.conf

Expand

title	Create a new script file

vim ch-mount.sh

#!/bin/bash
function mnt() {
echo "MOUNTING"
sudo mount -t proc /proc ${2}proc
sudo mount -t sysfs /sys ${2}sys
sudo mount -o bind /dev ${2}dev
sudo chroot ${2}
}
function umnt() {
echo "UNMOUNTING"
sudo umount ${2}proc
sudo umount ${2}sys
sudo umount ${2}dev
}
if [ "$1" == "-m" ] && [ -n "$2" ] ;
then
mnt $1 $2
elif [ "$1" == "-u" ] && [ -n "$2" ];
then
umnt $1 $2
else
echo ""
echo "Either 1'st, 2'nd or both parameters were missing"
echo ""
echo "1'st parameter can be one of these: -m(mount) OR -u(umount)"
echo "2'nd parameter is the full path of rootfs directory(with trailing
'/')"
echo ""
echo "For example: ch-mount -m /media/sdcard/"
echo ""
echo 1st parameter : ${1}
echo 2nd parameter : ${2}
fi

...

Expand

title	vim /etc/init.d/ttyS0.conf

start on stopped rc or RUNLEVEL=[12345]

stop on RUNLEVEL [!12345]

respawn exec /sbin/getty -L 115200 ttyLP0 vt102

Network setup

# echo "auto eth0" > /etc/network/interfaces.d/eth0

...

Install Wayland, Wayland-Protocols and Weston

Environment Setup

Expand

title	install required packages

# apt-get install pkg-config
# apt install ninja-build cmake git python3-pip kmod
# apt install libffi-dev libxml2 libxml2-dev graphviz doxygen xsltproc xmlto xdot libxkbcommon-dev libpixman-1-dev libinput-dev
# apt-get install libcairo-dev glib-2.0 libpango1.0-dev libjpeg-dev libwebp-dev libegl-mesa0 libsystemd-dev libgles2-mesa libgles2-mesa-dev libpam0g-dev libgbm-dev freerdp2-dev liblcms2-dev libx11-xcb-dev libcolord-dev libxcb-xkb1 libpipewire-0.2-dev libdbus-1-dev libxcb-xkb-dev libdrm-dev automake
# pip3 install --user meson -i https://pypi.mirrors.ustc.edu.cn/simple/
# apt install glmark2-es2-wayland
# apt install gstreamer1.0-libav gstreamer1.0-plugins-bad

Exit FileSystem

exit
./ch-mount.sh -u root/

packaged FileSystem

cd root
tar -cjf rootfs.tar.bz2 ./*

Deploy FileSystem to SD Card

Prepare a SD card with ext4 partition: Learning/Linux#Partitioning and Formatting an SD Card

extract ubuntu .bz2 package to SD card

sudo tar -xvf rootfs.tar.gz -C /media/xxx/rootfs

Install Wayland, Wayland-Protocols and Weston

Environment Setup

...

Testing

Install testing tool

sudo apt install glmark2-es2-wayland

Start Weston desktop

Only root user can launch weston service, please switch to root user in advance

insmod mali_kbase.ko

...

weston --tty 1 &

Run glmark2 test

glmark2-es2-wayland --fullscreen

Image Removedglmark2 version	Image Removedglmark2 result
Image Removed

...

Expandcopy gstreamer related lib

Expandmodify omx plugin configuration

Expandinstall gstreamer dependency

Test gstreamer

Expandlogin as root and insmod drivers

ExpandSpecify gstreamer location

ExpandLaunch weston

ExpandPlay Video

Run below command in new Terminal:

copy codec drivers

$ sudo cp ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/lib/modules/5.10.201-cip41-yocto-standard/extra/* \
 ~/work/root/home/xxx/vlp_deploy/modules

copy gstreamer related lib

$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/bin/gst-* ~/work/root/usr/bin/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/libgst* ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l

...

Pleaes copy this .bz2 file to Ubuntu SD card and run below instruction on reference board

unzip core-image-qt-smarc-rzg2l.tar.bz2 or core-image-weston-smarc-rzg2l.tar.bz2 to folder "yocto"

Expandcopy codec drivers

-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/gstreamer-1.0/ ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/girepository-1.0/ ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/libmmngr* ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/libvspm.so.1* ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/libexec/gstreamer-1.0/ ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/share/gstreamer-1.0/ ~/work/root/usr/share/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/share/gst-plugins-base/ ~/work/root/usr/share/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/share/locale/en_GB/LC_MESSAGES/gst* ~/work/root/usr/share/locale/en_GB/LC_MESSAGES/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/libomxr_* ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/usr/lib64/libuvcs_* ~/work/root/usr/lib/aarch64-linux-gnu/
$ sudo mkdir ~/work/root/lib64
$ sudo cp -rd ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/lib64/ld-* ~/work/root/lib64/
$ sudo cp ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/etc/xdg/gstomx.conf ~/work/root/etc/xdg/
$ sudo cp ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/etc/gstpbfilter.conf ~/work/root/etc/
$ sudo cp -r ~YOUR_VLP_FOLDER/build/tmp/work/smarc_rzg2l-poky-linux/core-image-qt/1.0-r0/rootfs/etc/omxr/ ~/work/root/etc/

modify omx plugin configuration

sudo vi ~/work/root/etc/xdg/gstomx.conf

replace "lib64" as "lib/aarch64-linux-gnu"

[omxh264dec]
type-name=GstOMXH264Dec
core-name=/usr/lib/aarch64-linux-gnu/libomxr_core.so
component-name=OMX.RENESAS.VIDEO.DECODER.H264
·····
[omxh264enc]
type-name=GstOMXH264Enc
core-name=/usr/lib/aarch64-linux-gnu/libomxr_core.so
component-name=OMX.RENESAS.VIDEO.ENCODER.H264
····

i.e. core-image-qt-smarc-rzg2l.tar.bz2

Pleaes copy this .bz2 file to Ubuntu SD card and run below instruction on reference board

...

ExpandPort Qt lib

Start Weston RZ-G/RZ-G2 BSP Porting Ubuntu#Start Weston desktop

...

Collapsecompile qt5

download qt5 source code by git (ignore)

mkdir qt5-build cd qt5-build make make install （rsync to SD）

We suggest to compile the qt5 with scrips

Notes: About the flags parameter in configure of Qt5. -qpa should be set as wayland or wayland-egl. We didn't support xcomposite-egl option

Install Qt by apt-get

apt-get install qt5-default qtwayland5

Notes: The above installation commands can only run part of Qt functions. If you need more functions, you need to continue installing Qt related packages.

Exit FileSystem

exit

./ch-mount.sh -u root/

packaged FileSystem

sudo tar cjf rootfs.tar.bz2 root .

Deploy FileSystem to SD Card

Prepare a SD card with ext4 partition: SD Card Loading and Booting

extract ubuntu rootfs package to SD card

sudo tar -xvf rootfs.tar.gz -C /media/xxx/rootfs

Testing on Board

Weston & openGLES

Only root user can launch weston service, please switch to root user in advance

Please connect a USB mouse before starting weston

insmod mali_kbase.ko

export XDG_RUNTIME_DIR=/usr/lib/
export RUNLEVEL=3

weston --tty 1 &

Run glmark2 test

glmark2-es2-wayland --fullscreen

Image Addedglmark2 version	Image Addedglmark2 result
Image Added

gstreamer

login as root and insmod drivers

insmod /home/xxx/vlp_deploy/modules/mali_kbase.ko

insmod /home/xxx/vlp_deploy/modules/mmngr.ko

insmod /home/xxx/vlp_deploy/modules/mmngrbuf.ko

insmod /home/xxx/vlp_deploy/modules/uvcs_drv.ko

insmod /home/xxx/vlp_deploy/modules/vspm.ko

insmod /home/xxx/vlp_deploy/modules/vspm_if.ko

Specify gstreamer location

export GST_PLUGIN_SCANNER=/usr/lib/aarch64-linux-gnu/gstreamer-1.0/gst-plugin-scanner

export GST_PLUGIN_PATH=/usr/lib/aarch64-linux-gnu/gstreamer-1.0

Launch weston

weston –tty 1 &

Play Video

Play video only:

gst-launch-1.0 filesrc location=/root/video/sintel_trailer-720p.mp4 ! qtdemux ! queue ! h264parse ! omxh264dec ! waylandsink

Play video & audio

gst-launch-1.0 filesrc location=/root/video/sintel_trailer-720p.mp4 ! qtdemux name=d d. ! queue ! h264parse ! omxh264dec ! waylandsink d. ! queue ! faad ! alsasink device=plughw:0,0

Qt Demo

Start Weston Start Weston desktop

export QT_QPA_PLATFORM=wayland
export QT_PLUGIN_PATH=/usr/lib/aarch64-linux-gnu/qt5/plugins/

Then run the Qt example in /usr/share/qt5/examples

Qt APPs development and testing

This section introduce how to develop Qt application on PC.

SDK build and installation

bitbake core-image-qt -c populate_sdk

The generated installation file is located at:

build/tmp/deploy/sdk/poky-glibc-x86_64-core-image-qtaarch64-smarc-rzg2l-toolchain-3.1.14.sh

Install this SDK to PC, default folder is /opt/poky/3.1.14

setup SDK runtime environment

source /opt/poky/3.1.14/environment-setup-aarch64-poky-linux

QT creator configuration

Add Device

...

Navigation

Page tree

Page History

Versions Compared

Old Version 1

New Version Current

Key

Read First

SoC: All

Specification

Ubuntu Filesystem Building

Install QEMU

Download Required Files

Prepare Files

Configure Filesystem

Enter Filesystem

Install required software

Add users

Configure UART

Network setup

Install Wayland, Wayland-Protocols and Weston

Environment Setup

Exit FileSystem

packaged FileSystem

Deploy FileSystem to SD Card

Install Wayland, Wayland-Protocols and Weston

Environment Setup

Compile and install Wayland

Compile and install Wayland-protocol

Compile and install Weston

Port GPU Libraries

Migrate GPU drivers

Migrate GPU Libraries

Testing

Install testing tool

Start Weston desktop

Port codec Librasries

Test gstreamer

Port Qt

Port from VLP

Compile from source

Install Qt by apt-get

Exit FileSystem

packaged FileSystem

Deploy FileSystem to SD Card

Testing on Board

Weston & openGLES

gstreamer

Qt Demo

Qt APPs development and testing

SDK build and installation

QT creator configuration