NXP Semiconductors
UM11483
Getting Started with NXP-based Wireless Modules on i.MX 8M Quad EVK Running Linux OS
4.3 Building the image
This section provides the information along with the instructions to build an image.
4.3.1 Build configurations
The i.MX BSP provides the script
imx-setup-release.sh
, which simplifies the process of
creating a new built target for the i.MX BSP. A built target is any combination of target
i.MX chipset, and distribution. The script sets up a directory and the configuration files for
the specified machine and backend.
i.MX 8M Quad machine configuration file is
imx8mqevk
and the distro configuration is
fsl-
imx-xwayland
.
The syntax for the
imx-setup-release.sh
script is as follows:
ubuntu@ubuntu-desktop:/# DISTRO=fsl-imx-xwayland MACHINE=imx8mqevk
source imx-setup-release.sh -b build
When the script is running, it prompts the user to accept EULA license agreement. Once
the EULA is accepted, the acceptance is stored in
local.conf
inside each build folder and
the EULA acceptance query is no longer displayed for that build folder.
4.3.2 Command to build an image
The Yocto Project build uses the
bitbake
command. For example,
bitbake
<component>
builds the named component. Each component build has multiple tasks,
such as fetching, configuring, compiling, packaging, and deploying to the target
rootfs
.
The bitbake image build gathers all the components required by the image and build
following the order of the dependency per task.
Use the following command to build an image:
ubuntu@ubuntu-desktop:/imx-yocto-bsp/build # bitbake imx-image-full
4.3.3 Image deployment
The filesystem images are deployed to
<build directory>/tmp/deploy/images/imx8mqevk/
.
An image is, for the most part, specific to the machine set in the environment setup.
Each image build creates a U-Boot, a kernel, and an image type based on the
IMAGE_FSTYPES defined in the machine configuration file. Most machine configurations
provide an SD card image (
.wic
) and a rootfs image (
.tar
).
UM11483
All information provided in this document is subject to legal disclaimers.
© NXP B.V. 2021. All rights reserved.
User manual
Rev. 2 — 21 January 2021
27 / 41
