MISC-AN-001: Creating a root file system using Buildroot

Info Box Applies to AXEL ULite Application Notes Applies to SBC Lynx Application Notes Applies to RIALTO SBC Application Notes

History

Date	Version
Oct 2023	Buildroot 2022.05

Introduction

By default, AXEL ULite comes with a DESK-MX6UL-L Yocto distribution. Nevertheless, other distributions can be used as well. This application note shows how to run one of them, Buildroot.

Buildroot is known to be very simple to configure and build. An exhaustive discussion of Buildroot is beyond the scope of this application note. The interested reader can refer for example to this presentation which compares in detail Yocto and Buildroot.

The test bed used for this application note is composed of the same hardware/software platform delivered along with the DESK-MX6UL-L. About Buildroot, the version buildroot-2022.05 was used.

Donwloading, configuring and building

This process is straightforward. Once the file buildroot-2022.05.tar.gz is downloaded and decompressed on your Linux host machine, get into the Buildroot directory, and run make menuconfig.

Buildroot make menuconfig

Then enter the Target options menu and select:

• ARM (little endian) for Target Architecture
• cortex-A7 for Target Architecture Variant

as shown in the following picture.

Buildroot make menuconfig

Another important configuration is the Freescale i.MX Libraries settings for i.MX6UL processor and its imx-tools (imx-codec, imx-kobs, firmware)

i.MX libraries

That's it: after saving your configuration, and exiting menuconfig, you can start the build process by simply issuing the make command.

For your sake of convenience, the created .config file can be downloaded from [here].

Linux kernel

The latest Linux kernel version provided in the DAVE' git repositories can be used for building the kernel image too.

The kernel tarball can be copied into the proper Buildroot directory:

Linux kernel tarball

Package list

The root file system package composition has been created for a list of packages commonly used for creating a root file system good for all seasons.

Here below a list of most important selected packages:

• Qt5.15 libraries including: qt5declarative, qt5quickcontrols, qt5quickcontrols2, qt5sensors, qt5serialbus, qt5serialport, Qt SQlite and the very important qt5webkit
  • qt-web-kiosk browser can be used for creating a GUI with an embedded browser as a Kiosk application has been included too
• framebuffer utilities like: fbset, fbv, fbgrab and the fb-test application
• python3 interpreter including pyhton3-ssl, pyhton-flask, pyhton-httplib2, pyhton-jinja2, pyhton-pip, pyhton-py, pyhton-pymodbus, pyhton-pymysql, pyhton-pyqt5, pyhton-pyusb, pyhton-serial, pyhton-requests, pyhton-schedule, pyhton-socketio, pyhton-setupotools
• lua
• network applications: avahi, bluez, iptables, iw, lighthttpd, ntp, openssl, openssh, vsftpd, wget
• Javascript: angularjs, bootstrap
• opkg, rpm

Build the targets

It is enough tun run the make command and buildroot will start building the toolchain and then cross-compiling the overall selected packages.

Once the build process has been completed, the output/images directory will contain the binary artifact:

dvdk@vagrant:~/buildroot/buildroot-2022.05$ ls -la output/images/
total 769832                                                                                                                                                  
drwxr-xr-x 2 dvdk dvdk      4096 Oct 17 09:17 .
drwxrwxr-x 6 dvdk dvdk      4096 Oct 14 22:54 ..
-rwxr-xr-x 1 dvdk dvdk     32964 Oct 16 11:07 imx6ul-axelulite-cb003a.dtb
-rw-r--r-- 1 dvdk dvdk 293242880 Oct 18 13:19 rootfs.tar
-rw-r--r-- 1 dvdk dvdk  92090639 Oct 18 13:19 rootfs.tar.bz2
-rw-r--r-- 1 dvdk dvdk   7413264 Oct 16 11:07 uImage
dvdk@vagrant:~/buildroot/buildroot-2022.05$ 

If the SDK is required for building the application in the building environment, it is possible to generate the SDK using:

make sdk

and this will produce:

dvdk@vagrant:~/buildroot/buildroot-2022.05$ ls -la output/images/arm-*
-rw-r--r-- 1 dvdk dvdk 395504251 Oct 17 10:26 output/images/arm-buildroot-linux-gnueabihf_sdk-buildroot.tar.gz
dvdk@vagrant:~/buildroot/buildroot-2022.05$ 

Qt5 webkit build error

The Qt5 building has an error on producing the qt-webkit-kiosk artifacts. Following this thread you can find a patch for fixing the issue:

 QT5WEBKIT_CONF_OPTS += \
+	-DCMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT=ON \
 	-DENABLE_TOOLS=OFF \
 	-DPORT=Qt \
 	-DPYTHON_EXECUTABLE=$(HOST_DIR)/bin/python3 \
 	-DSHARED_CORE=ON \
 	-DUSE_LIBHYPHEN=OFF
 
+QT5WEBKIT_INSTALL_STAGING_OPTS = install/fast
+
+define QT5WEBKIT_INSTALL_TARGET_CMDS
+	$(TARGET_MAKE_ENV) $(BR2_CMAKE) --install $(QT5WEBKIT_BUILDDIR) \
+		--prefix $(TARGET_DIR)/usr
+endef
+
 $(eval $(cmake-package))

Adding further packages

In real world applications, additional packages are usually added by selecting them under the Target packages item of the configuration menu. Just look at the packages directory to see which ones are available out of the box. To add further packages, please refer to this link.