aboutsummaryrefslogtreecommitdiffstats
path: root/BUILD.md
diff options
context:
space:
mode:
authorWade Farnsworth <wfarnsworth@users.noreply.github.com>2019-10-22 08:08:07 -0700
committerGitHub <noreply@github.com>2019-10-22 08:08:07 -0700
commit8e0cf9ee43840bd7ee004412129ba4aa055f5fc8 (patch)
treeb13804093e413307097cd6788ccdc8b062084013 /BUILD.md
parent9e1e1da00d8ef569d83a7a742a734dbbf5e0bd13 (diff)
parent3f8062a03dc1d1d5fa386e1f1ca59d56b86a85d1 (diff)
downloadmeta-amd-8e0cf9ee43840bd7ee004412129ba4aa055f5fc8.tar.gz
meta-amd-8e0cf9ee43840bd7ee004412129ba4aa055f5fc8.tar.bz2
meta-amd-8e0cf9ee43840bd7ee004412129ba4aa055f5fc8.zip
Merge pull request #661 from ArsalanHAwan/master-merge-warriorHEADmaster
master: merge warrior
Diffstat (limited to 'BUILD.md')
-rw-r--r--BUILD.md64
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.