1.3. Simplified SDK Build Using Top-Level Makefile¶
1.3.1. Overview¶
Inside of the Processor SDK Linux AM69 package, there is a top-level Makefile that can be used to build some of the sub-components found within the SDK. This Makefile uses the Rules.make file and gives an example of how the various components can be built and the parameters to use for AM69.
Note
You should not call this makefile with the environment-setup script sourced. The sub-component Makefiles will handle sourcing this script where appropriate, but some make targets such as the Linux kernel make target do not work properly when this script is already sourced.
Required Host Packages
Please run the top level setup.sh script to install all packages required by the makefile targets.
Components:
The functionality of the Top Level Makefile is implemented by these components:
makerules/Makefile_* : These have all of the makerules that are common for TI SDKs across various platforms
Rules.make : This defines variables to configure Makefile for Processor SDK Linux AM69
Makefile : Only pulls in these variable definitions and the make rules
Below sections will give a bottoms-up description of these components in some more detail
1.3.1.1. makerules¶
Target Types
For each of the targets discussed below, the following target types are defined
<target> - This is the build target which will compile the release version of the component.
<target>_install - This target will install the component to the location pointed to by DESTDIR/BOOTFS
<target>_clean - This target will clean the component.
Component Targets
The following is a list of the basic Makefile targets that are provided in the Processor SDK Linux AM69 package as component Makefiles under makerules/ directory:
u-boot - This target will build the u-boot binaries for the SOC and SOC_TYPE combination defined in Rules.make. The built binaries will include:
tiboot3.bin,
tispl.bin,
u-boot.img
Refer to Build U-Boot section for more details on these binaries.
linux-dtbs - Compiles and creates the device tree blobs. It uses the KERNEL_DEVICETREE_PREFIX variable defined in Rules.make to parse which dtb[o]s to build.
linux - Configures the Linux kernel for TI SOCs and Compiles the following:
Image,
modules,
and dtbs.
For SOC_TYPE=hs, This also triggers a build for the linux-fitImage target.
Refer to Users Guide section for more details on the TI Linux Kernel.
linux-fitImage - Picks up images built by ‘u-boot-a72’ and ‘linux’ targets and generates a signed fitImage, u-boot-a72 combination. This is necessary to boot successfully on HS-SE devices (SOC_TYPE=hs), but the fitImage can optionally be authenticated on GP (gp), HS-FS (hs-fs) devices as well by manually setting boot_fit=1 in the u-boot prompt.
Refer to Creating the kernel fitImage for high security device / GP devices section for more information on the signed linux fitImage.
am-benchmarks - Builds the ARM Benchmarks for the ARCH defined in Rules.make.
cryptodev - Builds the kernel module for the crypto device driver
ti-img-rogue-driver - Builds the Kernel drivers for the PowerVR Rogue GPU
For a full list of supported subcomponent targets, one can also simply run make list-targets
at the SDK install location.
1.3.1.2. Rules.make¶
Here, we cover the Rules.make file found in the top-level of the Processor SDK Linux AM69 package. This file is used not only by the top-level Makefile, but also by many of the sub-component Makefiles to gain access to common shared variables and settings. The variables defined in here are all of the required flags/parameters that will be required to build/compile any of the sub-component makefile targets for AM69.
Key Variables Defined
Below we describe a subset of the variables defined in the Rules.make that can be editted/overriden by the user as required. These can either be editted into the Rules.make file itself (to reset new defaults) OR can be specified over command line when calling the make command.
SOC_TYPE - This describes the HS configuration to build for. It can be set to ‘gp’, ‘hs’, and ‘hs-fs’. It is used when building u-boot and linux to use unsigned or signed images as required.
KERNEL_DEVICETREE_PREFIX - This is a regex filter to parse which dtb[o]s should be built for AM69 SOC, when building linux kernel.
ROOTFS_PART - This points to the base installation directory that applications/drivers should be installed to. This is usually the root of a target file system but can be changed to point anywhere.
BOOT_PART - This points to the base installation directory that u-boot binaries should be installed to. This is usually the boot partition of an SD card but can be changed to point anywhere.
1.3.1.3. Top Level Makefile¶
Top-Level Targets
The Processor SDK Linux AM69 package provides the following targets by default, which will invoke the corresponding component targets:
all - This will call the build target for each component included in the Makefile.
install - This will call the install target for each component included in the Makefile.
clean - This will call the clean target for each component included in the Makefile.
list-targets - This only lists all the supported targets/components for the platform
1.3.2. Usage Examples¶
The following example demonstrates how to use the top-level Makefile for building and installing u-boot and linux images. All of the examples below assume that you are calling the Makefile from the top-level of the SDK.
If using an SD card, edit below variables in the Rules.make to point to the boot and root partitions. Else, point them to directories where you want to install the boot and root-filesystem images respectively.
BOOT_PART?=/path/to/sd-card/boot-partition ROOT_PART?=/path/to/sd-card/root-partition
Set the correct value for the SOC_TYPE variable in Rules.make according to the platform being used.
SOC_TYPE?=<gp/hs-fs/hs>
Now build u-boot, linux kernel images.
make u-boot make linux
Install to SD card (BOOT_PART & ROOT_PART).
make u-boot_install make linux_install
Now you can eject the SD card and boot the devices using the newly built images!
A Note about Out-of-tree Kernel Modules
Some drivers like the GPU drivers are delivered as modules outside of
the kernel tree. If you rebuild the kernel and install it using the
make linux_install
target you will also need to rebuild the out of
tree modules and install them as well. The modules_install command used
by the linux_install target will remove any existing drivers before
installing the new ones. This means those drivers are no longer
available until they have been rebuilt against the kernel and
re-installed.
A Note about the SOC_TYPE variable
The SOC_TYPE variable serves 2 purposes:
The U-Boot build generates the bootloader images for all 3 SOC types, namely, GP, HS-FS, and HS-SE. These are not compatible with one another. So the SOC_TYPE variable picks up the correct binary accordingly when installing u-boot. For example, below command will install the u-boot images for HS-FS device.
SOC_TYPE=hs-fs make u-boot SOC_TYPE=hs-fs make u-boot_install
HS-SE devices enforce fitImage based authentication when booting up. They will fail to boot if (u-boot.img + fitImage) authentication fails. To simplify fitImage generation and testing one can simply set SOC_TYPE=hs when building/installing linux for HS-SE devices.
SOC_TYPE=hs make linux SOC_TYPE=hs make linux_install