diff --git a/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.html b/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.html deleted file mode 100644 index 8c259aa5a6..0000000000 --- a/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.html +++ /dev/null @@ -1,240 +0,0 @@ - -My First Yocto Project Build

My First Yocto Project Build

Copyright © 2010-2018 Linux Foundation

- Permission is granted to copy, distribute and/or modify this document under - the terms of the Creative Commons Attribution-Share Alike 2.0 UK: England & Wales as published by Creative Commons. -

Manual Notes

  • - For the latest version of this document associated with - this Yocto Project release - (version 2.5), see the "My First - Yocto Project Build" from the - Yocto Project documentation page. -

  • - This version of the manual is version - 2.5. - For later releases of the Yocto Project (if they exist), - go to the - Yocto Project documentation page - and use the drop-down "Active Releases" button - and choose the Yocto Project version for which you want - the manual. -

1. Welcome!

- Welcome! - This short document steps you through the process for a typical - image build using the Yocto Project. - The build uses Poky, which is the reference embedded OS that is - completely specified. -

Note

- The examples in this paper assume you are using a native Linux - system running a recent Ubuntu Linux distribution. - If the machine you want to use - Yocto Project on to build an image is not a native Linux - system, you can still perform these steps by using CROss - PlatformS (CROPS) and setting up a Poky container. - See the - Setting Up to Use CROss PlatformS (CROPS)" - section in the Yocto Project Development Tasks Manual for more - information. -

-

- If you want more conceptual or background information on the - Yocto Project, see the - Getting Started With Yocto Project Manual. -

2. Compatible Linux Distribution

- Make sure your build system meets the following requirements: -

  • - 50 Gbytes of free disk space -

  • - Runs a supported Linux distribution (i.e. recent releases of - Fedora, openSUSE, CentOS, Debian, or Ubuntu). For a list of - Linux distributions that support the Yocto Project, see the - "Supported Linux Distributions" - section in the Yocto Project Reference Manual. -

  • -

    • - Git 1.8.3.1 or greater -

    • - tar 1.27 or greater -

    • - Python 3.4.0 or greater. -

    - If your build host does not meet any of these three listed - version requirements, you can take steps to prepare the - system so that you can still use the Yocto Project. - See the - "Required Git, tar, and Python Versions" - section in the Yocto Project Reference Manual for information. -

-

3. Build System Packages

- You must install essential host packages on your - development host. - The following command installs the host packages based on an - Ubuntu distribution: -

Note

- For host package requirements on all supported Linux - distributions, see the - "Required Packages for the Host Development System" - section in the Yocto Project Reference Manual. -

- 

-     $ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \
-     build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \
-     xz-utils debianutils iputils-ping libsdl1.2-dev xterm
-

-

4. Use Git to Clone Poky

- Once you complete the setup instructions for your machine, - you need to get a copy of the Poky repository on your build - system. - Use the following commands to clone the Poky - repository and then checkout the yocto-2.5 release: - 

-     $ git clone git://git.yoctoproject.org/poky
-     Cloning into 'poky'...
-     remote: Counting objects: 361782, done.
-     remote: Compressing objects: 100% (87100/87100), done.
-     remote: Total 361782 (delta 268619), reused 361439 (delta 268277)
-     Receiving objects: 100% (361782/361782), 131.94 MiB | 6.88 MiB/s, done.
-     Resolving deltas: 100% (268619/268619), done.
-     Checking connectivity... done.
-     $ git checkout tags/yocto-2.5 -b my-yocto-2.5
-

- The previous Git checkout command creates a local branch - named my-yocto-2.5. The files available to you in that - branch exactly match the repository's files in the - "sumo" development branch at the time of the - Yocto Project 2.5 release. -

- For more options and information about accessing Yocto - Project related repositories, see the - "Working With Yocto Project Source Files" - section in the Yocto Project Development Tasks Manual. -

5. Building Your Image

- Use the following steps to build your image. - The OpenEmbedded build system creates an entire Linux - distribution, including the toolchain, from source. -

Note

  • - If you are working behind a firewall and your build - host is not set up for proxies, you could encounter - problems with the build process when fetching source - code (e.g. fetcher failures or Git failures). -

  • - If you do not know your proxy settings, consult your - local network infrastructure resources and get that - information. - A good starting point could also be to check your - web browser settings. - Finally, you can find more information on the - "Working Behind a Network Proxy" - wiki page. -

-

-

  1. - Initialize the Build Environment: - Run the - oe-init-build-env - environment setup script to define the OpenEmbedded - build environment on your build host. - 

    -     $ source oe-init-build-env
-

    - Among other things, the script creates the - Build Directory, - which is build in this case - and is located in the - Source Directory. - After the script runs, your current working directory - is set to the Build Directory. - Later, when the build completes, the Build Directory - contains all the files created during the build. -

  2. - Examine Your Local Configuration File: - When you set up the build environment, a local - configuration file named - local.conf becomes available in - a conf subdirectory of the - Build Directory. - For this quick start, the defaults are set to build - for a qemux86 target, which is - suitable for emulation. - The package manager used is set to the RPM package - manager. -

  3. - Start the Build: - Continue with the following command to build an OS image - for the target, which is - core-image-sato in this example: - 

    -     $ bitbake core-image-sato
-

    - For information on using the - bitbake command, see the - "BitBake" - section in the Yocto Project Overview Manual, or - see the - "BitBake Command" - section in the BitBake User Manual. -

  4. - Simulate Your Image Using QEMU: - Once this particular image is built, you can start - QEMU, which is a Quick EMUlator that ships with - the Yocto Project: - 

    -     $ runqemu qemux86
-

    - If you want to learn more about running QEMU, see the - "Using the Quick EMUlator (QEMU)" - chapter in the Yocto Project Development Tasks Manual. -

  5. - Exit QEMU: - Exit QEMU by either clicking on the shutdown icon or by - typing Ctrl-C in the QEMU - transcript window from which you evoked QEMU. -

-

6. Where To Go Next

- Now that you have experienced using the Yocto Project, you might - be asking yourself "What now?" - The Yocto Project has many sources of information including - the website, wiki pages, and user manuals: -

  • - Website: - The - Yocto Project Website - provides background information, the latest builds, - breaking news, full development documentation, and - access to a rich Yocto Project Development Community - into which you can tap. -

  • - Developer Screencast: - The - Getting Started with the Yocto Project - New Developer Screencast Tutorial - provides a 30-minute video created for users unfamiliar - with the Yocto Project but familiar with Linux build - hosts. - While this screencast is somewhat dated, the - introductory and fundamental concepts are useful for - the beginner. -

  • - Yocto Project Wiki: - The - Yocto Project Wiki - provides additional information on where to go next - when ramping up with the Yocto Project, release - information, project planning, and QA information. -

  • - Yocto Project Mailing Lists: - Related mailing lists provide a forum for discussion, - patch submission and announcements. - Several mailing lists exist and are grouped according - to areas of concern. - See the - "Mailing lists" - section in the Yocto Project Reference Manual for a - complete list of Yocto Project mailing lists. -

  • - Comprehensive List of Links and Other Documentation: - The - "Links and Related Documentation" - section in the Yocto Project Reference Manual provides a - comprehensive list of all related links and other - user documentation. -

-

\ No newline at end of file diff --git a/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.tgz b/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.tgz deleted file mode 100644 index 4bbcb288eb..0000000000 Binary files a/documentation/brief-yoctoprojectqs/brief-yoctoprojectqs.tgz and /dev/null differ