diff options
Diffstat (limited to 'BUILD.md')
-rw-r--r-- | BUILD.md | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/BUILD.md b/BUILD.md new file mode 100644 index 00000000..a2254ea7 --- /dev/null +++ b/BUILD.md @@ -0,0 +1,64 @@ +# 2. Setting up and starting a build + +After [setting up the build system](SETUP.md), we can build images or +recipes for a target machine (or BSP). +Running the commands in the instructions below will setup a build for +a selected AMD BSP, and start a build: + +### 2.1. Select a BSP + +Set the environment variable `MACHINE` to one of the +[supported AMD BSPs](meta-amd-bsp/README.md) (change the +`<machine-name>` in the following example accordingly): +```sh +MACHINE="<machine-name>" +``` + +### 2.2. Setup the build environment for selected BSP + +Source the *oe-init-build-env* script: +```sh +source ./oe-init-build-env build-${MACHINE}-warrior +``` + +Set the `MACHINE` and `DISTRO` bitbake environment variables in the +`conf/local.conf` (or `auto.conf`): +```sh +tee conf/auto.conf <<EOF +DL_DIR ?= "\${TOPDIR}/../downloads" +SSTATE_DIR ?= "\${TOPDIR}/../sstate-cache" + +MACHINE = "${MACHINE}" +DISTRO = "poky-amd" +EOF +``` + +Add the required layers to the build configuration: +```sh +bitbake-layers add-layer ../meta-openembedded/meta-oe +bitbake-layers add-layer ../meta-openembedded/meta-python +bitbake-layers add-layer ../meta-openembedded/meta-networking +bitbake-layers add-layer ../meta-dpdk +bitbake-layers add-layer ../meta-amd/meta-amd-distro +bitbake-layers add-layer ../meta-amd/meta-amd-bsp +``` + +### 2.3. Start the build + +Build one of the supported image recipes: +```sh +bitbake <image-name> -k +``` + +###### where `<image-name>` is to be replaced with one of the [supported images](FEATURES.md) for the selected AMD BSP. +###### (e.g. `core-image-sato` or `core-image-base`) + +--- +#### What's next + +Continue to "[section 3 - deploy](DEPLOY.md)" for instructions on +booting the target with the newly built image. + +You can also [customize the image](CUSTOMIZE.md) by enabling/disabling +certain configurable features. Make sure to re-build the image before +deploying the customized build. |