sphinx: toaster-manual: add figures

(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

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
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
across several build hosts. When Toaster is set up as a hosted service,
its components can be spread across several machines:
.. image:: figures/hosted-service.png
:align: center

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
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
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
@@ -463,9 +467,17 @@ Yocto Project:
- `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
them into your Toaster project, using the "Import layer" page.
.. image:: figures/import-layer.png
:align: center
:scale: 75%
.. _toaster-web-interface-preferred-version:
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
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.
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
@@ -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
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
"PREFERRED_VERSION_bash" in the "Variable" field, and "3.2.48" in the
"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
``PREFERRED_VERSION`` are added to the bottom of the BitBake variables
list. With these settings, the OpenEmbedded build system builds the
desired version of the recipe rather than the default version:
.. image:: figures/variable-added.png
:align: center
:scale: 75%