1. Introduction

---

Like RHEL, Fedora and Ubuntu, ubinux is a solution of embedded platform operating system（including mass storage，small printers and scanners） based on Linux distribution.

2. Prepare

---

2.1 Download

Currently yocto-ubinux is managed on Github. You can get from there.

$ git clone https://github.com/ubinux/yocto-ubinux.git

Note

• Modify the value of the DOWNLOADS variable in the file setup_ubinux.sh to specify the download directory.

2.2 Build environment

• Please refer to the build environment of poky5.2(Walnascar). In addition, here are the packages needed to build the ubinux image on an Ubuntu distribution.

  $ sudo pip install html5lib
  $ sudo apt install gcc-multilib
  

• Ubuntu 24.04 is recommended. By default, bitbake is broken due to file permission problem on Ubuntu 24.04. The problem can be resolved by unloading the profile.

  $ sudo apparmor_parser -R /etc/apparmor.d/unprivileged_userns
  

• More than 400G space needs to be prepared for build.

3. Usage

3.1 Download repos

$ cd yocto-ubinux/
$ ./meta-ubinux/scripts/checkoutmetas.py

3.2 Set up build environment

$ . setup_ubinux.sh ${machine} ${build_dir}

Note

• ${machine} - the config file’s name of each arch

$ cd meta-ubinux/conf/machine
$ ls
ubinux-armv8.conf
ubinux-x86-64.conf

• ${build_dir} - build directory of ubinux and it's set by the user
• The multlib option is enabled in ubinux-armv8.conf, so if you compile this machine, it will actually compile aarch64 and armv7 together.

Example set up build environment of X86_64

$ . setup_ubinux.sh ubinux-x86-64 ../build-ubinux-x86-64

• You can enter the build directory to set the environment variables.

  $ cd ${build_dir}
  $ vi conf/local.conf
  

• You can find the explanation of environment variables from https://wiki.yoctoproject.org/wiki/Main_Page

3.3 Generate toolchain

Enter the build directory to generate the toolchain of the specified arch.

$ bitbake meta-toolchain

Note

• The toolchains of each arch are stored in the corresponding directory of ${build_dir}/tmp/deploy/sdk/

3.4 Generate image

Enter the build directory to generate the image of the specified arch.

$ cd ${build_dir}
$ bitbake ubinux-all

Note

• The rpms of each arch are stored in the corresponding directory of ${build_dir}/tmp/deploy/rpm
• Using dnf-plugin-tui(https://github.com/ubinux/dnf-plugin-tui) in toolchain generated in Chapter 3.4 to generate image.