diff --git a/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.xml b/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.xml index 1241662df6..75dcd34128 100644 --- a/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.xml +++ b/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.xml @@ -33,8 +33,8 @@ Welcome! This short document steps you through the process for a typical image build using the Yocto Project. - The document also introduces how to add a machine layer and a - general layer to your Yocto Project development environment. + The document also introduces how to configure a build for specific + hardware. You will use Yocto Project to build a reference embedded OS called Poky. @@ -62,7 +62,9 @@ Compatible Linux Distribution - Make sure your build system meets the following requirements: + Make sure your + build host + meets the following requirements: 50 Gbytes of free disk space @@ -98,11 +100,11 @@
- Build System Packages + Build Host Packages You must install essential host packages on your - development host. + build host. The following command installs the host packages based on an Ubuntu distribution: @@ -123,7 +125,7 @@ Once you complete the setup instructions for your machine, you need to get a copy of the Poky repository on your build - system. + host. Use the following commands to clone the Poky repository and then checkout the &DISTRO_REL_TAG; release: @@ -274,27 +276,26 @@
-
- Adding a Hardware Layer +
+ Customizing Your Build for Specific Hardware So far, all you have done is quickly built an image suitable for emulation only. - This section shows you how you can add a hardware layer into - the Yocto Project development environment. + This section shows you how to customize your build for specific + hardware by adding a hardware layer into the Yocto Project + development environment. - A hardware layer provides the metadata to support specific - hardware. - In general, layers are repositories that contain related sets - of instructions and configurations that tell the OpenEmbedded - build system what to do. - Isolating related metadata into layers facilitates modular - development. + In general, layers are repositories that contain related sets of + instructions and configurations that tell the OpenEmbedded build + system what to do. + Isolating related metadata into functionally specific layers + facilitates modular development and makes it easier to reuse the + layer metadata. - By convention, hardware layers (i.e. Board Support Packages) - start with the string "meta-". + By convention, layer names start with the string "meta-". @@ -327,7 +328,8 @@ Resolving deltas: 100% (13385/13385), done. Checking connectivity... done. - The hardware layer now exists inside as + The hardware layer now exists with other layers inside + the Poky reference repository on your build host as meta-altera and contains all the metadata needed to support hardware from Altera, which is owned by Intel. @@ -340,7 +342,8 @@ specifies the machine for the build. For this example, set the MACHINE variable to "cyclone5". - The build system will use the machine configurations here: + The OpenEmbedded build system uses the machine + configurations here: . See the @@ -358,7 +361,7 @@ conf directory. Use the bitbake-layers add-layer - command: + command to add the layer to the configuration file: $ cd ~/poky/build $ bitbake-layers add-layer ../meta-altera @@ -374,7 +377,7 @@ Completing these steps has added the meta-altera layer to your Yocto Project development environment and configured it to build for the - "imx6sxsabresd" machine. + "cyclone5" machine. The previous steps are for demonstration purposes only. If you were to attempt to build an image for the @@ -384,13 +387,13 @@
-
- Adding Your Own Layer +
+ Creating Your Own General Layer Maybe you have an application or specific set of behaviors you need to isolate. - You can create your own layer using the + You can create your own general layer using the bitbake-layers create-layer command. The tool automates layer creation by setting up a subdirectory with a layer.conf