aboutsummaryrefslogtreecommitdiffstats
path: root/BUILD.md
diff options
context:
space:
mode:
authorWade Farnsworth <wfarnsworth@users.noreply.github.com>2019-09-16 07:25:21 -0700
committerGitHub <noreply@github.com>2019-09-16 07:25:21 -0700
commitc7d07d81f47f7038e843e57a478ebc62aa77501c (patch)
tree0e5d6eef90016f31bb05a1abe6f2182cdfb2e425 /BUILD.md
parent36446bc01651af86775f24b48b8233496a3edd93 (diff)
parenta341921e7cfc02758c71c7e055e86e7c51fbb88d (diff)
downloadmeta-amd-c7d07d81f47f7038e843e57a478ebc62aa77501c.tar.gz
meta-amd-c7d07d81f47f7038e843e57a478ebc62aa77501c.tar.bz2
meta-amd-c7d07d81f47f7038e843e57a478ebc62aa77501c.zip
Merge pull request #655 from ArsalanHAwan/warrior-docs
meta-amd/docs: add setup, build, deploy & customize instructions
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..0c9ce2e0
--- /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 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.