Create projects
Before you build Digi Embedded Yocto, you need to create a platform-specific project.
If you are using the Digi Embedded Yocto Docker container, the startup script offers to create a new project. If you already created one, go directly to Build images. You can also follow these steps to create a project manually. |
Use the mkproject.sh
script to check supported platforms:
$ source /usr/local/dey-4.0/mkproject.sh -l
To initialize the project and environment, use the mkproject.sh
script.
For example, for the ConnectCore MP13 Development Kit, do the following:
$ mkdir -p ${HOME}/workspace/ccmp13-dvk
$ cd ${HOME}/workspace/ccmp13-dvk
$ source /usr/local/dey-4.0/mkproject.sh -p ccmp13-dvk
This initializes the project with a conf directory and two configuration files:
-
bblayers.conf
: The available layers are configured here. -
local.conf
: Local configuration variables affecting only this project are customized here.
The mkproject.sh
script sets the environment for the build in the current running terminal.
It also creates a dey-setup-environment
script in the project’s root folder.
This script can safely be rerun over existing projects to set up the build environment on a new terminal.
If you close your current terminal and open a new one, you must run the dey-setup-environment script before you use Digi Embedded Yocto.
|
Update existing projects
When updating your installation of Digi Embedded Yocto, you need to erase the tmp
and sstate-cache
directories from existing projects and build them from scratch.
Leaving the directories intact may result in problems in the build and the final images.
Build images
By default, ConnectCore MP13 Digi Embedded Yocto images include the {graphical-backend} desktop backend.
To build Digi Embedded Yocto images, use the command bitbake <image-recipe>
from your project’s directory.
For example:
$ bitbake core-image-base
The compilation can take several hours on a powerful state-of-the-art workstation, depending on the selected image recipe. |
Inspect build deliverables
You can find generated images inside your project’s directory, in the <project_folder>/tmp/deploy/images/ccmp13-dvk
folder.
This directory contains the following files:
-
Boot image, with the
boot.ubifs
file extension, which contains the Linux kernel, device trees and U-Boot scripts -
Root file system images in the following formats:
-
rootfs.ubifs
, a UBIFS partition image suitable for NAND devices -
rootfs.tar.bz2
, a compressed root file system tarball that you can use to set up a remote NFS share to boot from -
rootfs.manifest
, a text file with the list of all the built packages
-
-
Recovery image, with the
recovery.ubifs
file extension, which contains the recovery Linux kernel, device tree files, and U-Boot scripts -
ARM Trusted Firmware image, inside the
arm-trusted-firmware/
subfolder with thestm32
, the first stage boot loader that runs after the ROM loader -
FIP image
fip-ccmp13-dvk-optee.bin
, inside thefip
subfolder, with the U-Boot boot loader and Trusted Execution Environment (TEE) -
Linux kernel images with the
bin
file extension, which you can use to update an existing boot partition -
Linux kernel device tree images with the
dtb
file extension, which you can use to update an existing boot partition
Build a software update package
The procedure to create an SWU update package varies depending on the type of SWU package you want to create:
See Update firmware using SWU packages to learn more about firmware updates based on SWU packages.
SWU update packages can be programmed in the device in different ways. See Program an SWU package to learn how to program SWU packages.