1 files changed, 60 insertions, 0 deletions
diff --git a/SETUP.md b/SETUP.md
new file mode 100644
index 00000000..f3062412
--- /dev/null
+++ b/SETUP.md
@@ -0,0 +1,60 @@
+# 1. Setting up the build system
+
+Building images for AMD machines requires setting up the Yocto Project
+Build System. Please follow the guidelines on
+[Yocto Project Overview and Concepts Manual](https://docs.yoctoproject.org/4.0.5/overview-manual/index.html)
+and [Yocto Project Quick Build Guide](https://docs.yoctoproject.org/4.0.5/brief-yoctoprojectqs/index.html)
+if you are not familiar with the Yocto Project and it's Build System.
+
+Running the following commands will setup the build system and will
+enable us to build recipes & images for any of the supported AMD machines.
+
+### 1.1 Prerequisites
+
+Install the build system's dependencies:
+```sh
+sudo apt install -y gawk wget git diffstat unzip texinfo gcc \
+     build-essential chrpath socat cpio python3 python3-pip \
+     python3-pexpect xz-utils debianutils iputils-ping python3-git \
+     python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 xterm \
+     python3-subunit mesa-common-dev
+```
+
+### 1.2 Download the build system and the meta-data layers
+
+Select the Yocto Project branch:
+```sh
+YOCTO_BRANCH="kirkstone"
+```
+
+Clone the git repositories: 
+```sh
+git clone --single-branch --branch "${YOCTO_BRANCH}" \
+    "git://git.yoctoproject.org/poky" "poky-amd-${YOCTO_BRANCH}"
+cd poky-amd-${YOCTO_BRANCH}
+git clone --single-branch --branch "${YOCTO_BRANCH}" \
+    "git://git.openembedded.org/meta-openembedded"
+git clone --single-branch --branch "${YOCTO_BRANCH}" \
+    "git://git.yoctoproject.org/meta-dpdk"
+git clone --single-branch --branch "${YOCTO_BRANCH}" \
+    "git://git.yoctoproject.org/meta-amd"
+```
+
+Checkout commit hashes:
+```sh
+git checkout --quiet tags/yocto-4.0.5
+cd meta-openembedded
+git checkout --quiet 50d4a8d2a983a68383ef1ffec2c8e21adf0c1a79
+cd ../meta-dpdk
+git checkout --quiet 0e62d02f2755fbbf7dfa6e243381377c0a1cd97c
+cd ../meta-amd
+git checkout --quiet tags/kirkstone-e3000-ga-202301
+cd ..
+```
+
+---
+#### What's next
+
+Continue to "Section 2 - Setting up and starting a build"
+([BUILD.md](BUILD.md)) for instructions on how to setup and start a
+build for a particular AMD machine.