How To Build HMI SDK¶
Introduction¶
HMI SDK is a quick and easy HMI Application development environment.
To modify Linux component, you need to build HMI SDK from source code.
HMI SDK source code will generate same Linux environment as HMI SDK.
This page explains how to build HMI SDK source code.
After you have completed this page, you would be able to change the source code and customize Linux environment (i.e., memory map, additional OSS etc...).
Requirement
- Users have launched Evaluation Board Kit according to Getting Started, which means they can run HMI Application on the board.
-
To build Yocto Linux, the below equipment should be prepared.
Equipment
Details
Linux PC
Approximately 110GB free space is necessary.
OS
Ubuntu 20.04 LTS
64bit OS must be used.
Step 1: Obtain HMI SDK source code¶
Download HMI SDK source code from below link.
Step 2: Build HMI SDK source code¶
This step explains how to build Linux environment with HMI SDK source code.
Note
In the following instructions, text in angle brackets should be replaced with a character string that depends on your environment.
The brackets <
and >
are unnecessary in the text.
-
Install the required packages
Install some packages into your Linux PC, which are necessary in the following steps.
-
Set up your
git
environmentSet up your
git
environment if you have never done it.git config --global user.email "<Your email address>" git config --global user.name "<Your user name>"
Note
For more information, refer to Yocto Project Quick Build.
-
Set environment variables
Set the following environment variables.
export WORK=<A directory path for building> export PLATFORM=rzg2l export BOARD=smarc-rzg2l export SDK_PKG_DIR=<A directory path for HMI SDK source code packages>
Note
Currently, RZ/G Linux HMI SDK supports only
rzg2l
forPLATFORM
andsmarc-rzg2l
forBOARD
.The directory set to
SDK_PKG_DIR
shall include the HMI SDK source code package such asRTK0EF0195F*SJ_linux-src.zip
. -
Extract Yocto recipe package
Decompress the source code package, create a working directory, and extract Yocto recipe package.
-
Initialize build environment
Run an environment setup script as follows.
-
Add layers
Add necessary Yocto
meta-layers
layer as follows. -
Set up environment for offline build
This step is configuration for offline building.
If you would like to get source code via network when you build the HMI SDK, skip this step.
Change the environment variable
BB_NO_NETWORK
inlocal.conf
from0
to1
usingsed
command.Decompress OSS source code package and set it into the build environment.
-
Modify configurations for build environment
Add
IMAGE_INSTALL_append
andWHITELIST_GPL-3.0
tolocal.conf
as follows. -
Build images
Run
bitbake
command to build images.Note
If you need to create an SDK toolchain, run
bitbake
command as follows.Note
After building images or SDK toolchain, you can find them in the following directories respectively.
- Images:
${WORK}/build/tmp/deploy/images/${BOARD}/
- SDK toolchain:
${WORK}/build/tmp/deploy/sdk/
- Images: