From 6a9fd9bd72103a6ea1b0fe819630e252e8350cf7 Mon Sep 17 00:00:00 2001 From: Nicolas Dechesne Date: Wed, 29 Jul 2020 11:56:18 +0200 Subject: sphinx: toaster-manual: add figures (From yocto-docs rev: 3b976f4b9a4fdcd8116b557a09fd18b69b684582) Signed-off-by: Nicolas Dechesne Signed-off-by: Richard Purdie --- .../toaster-manual/toaster-manual-intro.rst | 6 +++++ .../toaster-manual-setup-and-use.rst | 28 ++++++++++++++++++++++ 2 files changed, 34 insertions(+) (limited to 'documentation') diff --git a/documentation/toaster-manual/toaster-manual-intro.rst b/documentation/toaster-manual/toaster-manual-intro.rst index bc4298dfce..c9d2617394 100644 --- a/documentation/toaster-manual/toaster-manual-intro.rst +++ b/documentation/toaster-manual/toaster-manual-intro.rst @@ -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 diff --git a/documentation/toaster-manual/toaster-manual-setup-and-use.rst b/documentation/toaster-manual/toaster-manual-setup-and-use.rst index 360270afbf..1ff28395f3 100644 --- a/documentation/toaster-manual/toaster-manual-setup-and-use.rst +++ b/documentation/toaster-manual/toaster-manual-setup-and-use.rst @@ -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 `__ +.. 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% -- cgit v1.2.3-54-g00ecf