mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-09-20 03:49:32 +02:00
Code Issues Packages Projects Releases Wiki Activity

sphinx: toaster-manual: add figures

Browse Source 
(From yocto-docs rev: 3b976f4b9a4fdcd8116b557a09fd18b69b684582)

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Nicolas Dechesne
2020-07-29 11:56:18 +02:00
committed by Richard Purdie
parent 6dec8aab0e
commit 6a9fd9bd72
2 changed files with 34 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
documentation/toaster-manual/toaster-manual-intro.rst
View File

@@ -94,6 +94,12 @@ When Toaster is set up as a local instance, all the components reside on
a single build host. Fundamentally, a local instance of Toaster is a single build host. Fundamentally, a local instance of Toaster is
suited for a single user developing on a single build host. suited for a single user developing on a single build host.
.. image:: figures/simple-configuration.png
:align: center
Toaster as a hosted service is suited for multiple users developing Toaster as a hosted service is suited for multiple users developing
across several build hosts. When Toaster is set up as a hosted service, across several build hosts. When Toaster is set up as a hosted service,
its components can be spread across several machines: its components can be spread across several machines:
.. image:: figures/hosted-service.png
:align: center

28
documentation/toaster-manual/toaster-manual-setup-and-use.rst
View File

@@ -439,6 +439,10 @@ When you create a project in Toaster, you will be asked to provide a
name and to select a Yocto Project release. One of the release options name and to select a Yocto Project release. One of the release options
you will find is called "Local Yocto Project". you will find is called "Local Yocto Project".
.. image:: figures/new-project.png
:align: center
:scale: 75%
When you select the "Local Yocto Project" release, Toaster will run your When you select the "Local Yocto Project" release, Toaster will run your
builds using the local Yocto Project clone you have in your computer: builds using the local Yocto Project clone you have in your computer:
the same clone you are using to run Toaster. Unless you manually update the same clone you are using to run Toaster. Unless you manually update
@@ -463,9 +467,17 @@ Yocto Project:
- `meta-yocto-bsp <http://layers.openembedded.org/layerindex/branch/master/layer/meta-yocto-bsp/>`__ - `meta-yocto-bsp <http://layers.openembedded.org/layerindex/branch/master/layer/meta-yocto-bsp/>`__
.. image:: figures/compatible-layers.png
:align: center
:scale: 75%
If you want to build any other layers, you will need to manually import If you want to build any other layers, you will need to manually import
them into your Toaster project, using the "Import layer" page. them into your Toaster project, using the "Import layer" page.
.. image:: figures/import-layer.png
:align: center
:scale: 75%
.. _toaster-web-interface-preferred-version: .. _toaster-web-interface-preferred-version:
Building a Specific Recipe Given Multiple Versions Building a Specific Recipe Given Multiple Versions
@@ -477,6 +489,10 @@ versions of the ``bash`` recipe (i.e. 3.2.48 and 4.3.30-r0) and two
versions of the ``which`` recipe (i.e. 2.21 and 2.18). The following versions of the ``which`` recipe (i.e. 2.21 and 2.18). The following
figure shows this exact scenario: figure shows this exact scenario:
.. image:: figures/bash-oecore.png
:align: center
:scale: 75%
By default, the OpenEmbedded build system builds one of the two recipes. By default, the OpenEmbedded build system builds one of the two recipes.
For the ``bash`` case, version 4.3.30-r0 is built by default. For the ``bash`` case, version 4.3.30-r0 is built by default.
Unfortunately, Toaster as it exists, is not able to override the default Unfortunately, Toaster as it exists, is not able to override the default
@@ -487,11 +503,23 @@ variable. You can do so from Toaster, using the "Add variable" form,
which is available in the "BitBake variables" page of the project which is available in the "BitBake variables" page of the project
configuration section as shown in the following screen: configuration section as shown in the following screen:
.. image:: figures/add-variable.png
:align: center
:scale: 75%
To specify ``bash`` 3.2.48 as the version to build, enter To specify ``bash`` 3.2.48 as the version to build, enter
"PREFERRED_VERSION_bash" in the "Variable" field, and "3.2.48" in the "PREFERRED_VERSION_bash" in the "Variable" field, and "3.2.48" in the
"Value" field. Next, click the "Add variable" button: "Value" field. Next, click the "Add variable" button:
.. image:: figures/set-variable.png
:align: center
:scale: 75%
After clicking the "Add variable" button, the settings for After clicking the "Add variable" button, the settings for
``PREFERRED_VERSION`` are added to the bottom of the BitBake variables ``PREFERRED_VERSION`` are added to the bottom of the BitBake variables
list. With these settings, the OpenEmbedded build system builds the list. With these settings, the OpenEmbedded build system builds the
desired version of the recipe rather than the default version: desired version of the recipe rather than the default version:
.. image:: figures/variable-added.png
:align: center
:scale: 75%