diff options
| -rw-r--r-- | documentation/brief-yoctoprojectqs/index.rst | 17 | ||||
| -rw-r--r-- | documentation/dev-manual/start.rst | 72 | ||||
| -rw-r--r-- | documentation/overview-manual/yp-intro.rst | 17 | ||||
| -rw-r--r-- | documentation/ref-manual/system-requirements.rst | 10 |
4 files changed, 51 insertions, 65 deletions
diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index 9eff13f583..f52b7fa0e0 100644 --- a/documentation/brief-yoctoprojectqs/index.rst +++ b/documentation/brief-yoctoprojectqs/index.rst | |||
| @@ -25,18 +25,11 @@ build a reference embedded OS called Poky. | |||
| 25 | in the Yocto Project Development Tasks Manual for more | 25 | in the Yocto Project Development Tasks Manual for more |
| 26 | information. | 26 | information. |
| 27 | 27 | ||
| 28 | - You may use Windows Subsystem For Linux v2 to set up a build host | 28 | - You may use version 2 of Windows Subsystem For Linux (WSL 2) to set |
| 29 | using Windows 10. | 29 | up a build host using Windows 10 or later, Windows Server 2019 or later. |
| 30 | 30 | See the :ref:`dev-manual/start:setting up to use windows subsystem for | |
| 31 | .. note:: | 31 | linux (wsl 2)` section in the Yocto Project Development Tasks Manual |
| 32 | 32 | for more information. | |
| 33 | The Yocto Project is not compatible with WSLv1, it is | ||
| 34 | compatible but not officially supported nor validated with | ||
| 35 | WSLv2, if you still decide to use WSL please upgrade to WSLv2. | ||
| 36 | |||
| 37 | See the :ref:`dev-manual/start:setting up to use windows | ||
| 38 | subsystem for linux (wslv2)` section in the Yocto Project Development | ||
| 39 | Tasks Manual for more information. | ||
| 40 | 33 | ||
| 41 | If you want more conceptual or background information on the Yocto | 34 | If you want more conceptual or background information on the Yocto |
| 42 | Project, see the :doc:`/overview-manual/index`. | 35 | Project, see the :doc:`/overview-manual/index`. |
diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst index 7d3a25b1f9..7b6026cf42 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst | |||
| @@ -254,16 +254,16 @@ development using the Yocto Project. Your build host can be a native | |||
| 254 | Linux machine (recommended), it can be a machine (Linux, Mac, or | 254 | Linux machine (recommended), it can be a machine (Linux, Mac, or |
| 255 | Windows) that uses `CROPS <https://github.com/crops/poky-container>`__, | 255 | Windows) that uses `CROPS <https://github.com/crops/poky-container>`__, |
| 256 | which leverages `Docker Containers <https://www.docker.com/>`__ or it | 256 | which leverages `Docker Containers <https://www.docker.com/>`__ or it |
| 257 | can be a Windows machine capable of running Windows Subsystem For Linux | 257 | can be a Windows machine capable of running version 2 of Windows Subsystem |
| 258 | v2 (WSL). | 258 | For Linux (WSL 2). |
| 259 | 259 | ||
| 260 | .. note:: | 260 | .. note:: |
| 261 | 261 | ||
| 262 | The Yocto Project is not compatible with | 262 | The Yocto Project is not compatible with version 1 of |
| 263 | `Windows Subsystem for Linux v1 <https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux>`__. | 263 | `Windows Subsystem for Linux <https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux>`__. |
| 264 | It is compatible but not officially supported nor validated with | 264 | It is compatible but neither officially supported nor validated with |
| 265 | WSLv2. If you still decide to use WSL please upgrade to | 265 | WSL 2. If you still decide to use WSL please upgrade to |
| 266 | `WSLv2 <https://docs.microsoft.com/en-us/windows/wsl/install-win10>`__. | 266 | `WSL 2 <https://learn.microsoft.com/en-us/windows/wsl/install>`__. |
| 267 | 267 | ||
| 268 | Once your build host is set up to use the Yocto Project, further steps | 268 | Once your build host is set up to use the Yocto Project, further steps |
| 269 | are necessary depending on what you want to accomplish. See the | 269 | are necessary depending on what you want to accomplish. See the |
| @@ -434,35 +434,36 @@ the `Yocto Project BitBake | |||
| 434 | <https://marketplace.visualstudio.com/items?itemName=yocto-project.yocto-bitbake>`__ | 434 | <https://marketplace.visualstudio.com/items?itemName=yocto-project.yocto-bitbake>`__ |
| 435 | extension accordingly. | 435 | extension accordingly. |
| 436 | 436 | ||
| 437 | Setting Up to Use Windows Subsystem For Linux (WSLv2) | 437 | Setting Up to Use Windows Subsystem For Linux (WSL 2) |
| 438 | ----------------------------------------------------- | 438 | ----------------------------------------------------- |
| 439 | 439 | ||
| 440 | With `Windows Subsystem for Linux | 440 | With `Windows Subsystem for Linux (WSL 2) |
| 441 | (WSLv2) <https://docs.microsoft.com/en-us/windows/wsl/wsl2-about>`__, | 441 | <https://learn.microsoft.com/en-us/windows/wsl/>`__, |
| 442 | you can create a Yocto Project development environment that allows you | 442 | you can create a Yocto Project development environment that allows you |
| 443 | to build on Windows. You can set up a Linux distribution inside Windows | 443 | to build on Windows. You can set up a Linux distribution inside Windows |
| 444 | in which you can develop using the Yocto Project. | 444 | in which you can develop using the Yocto Project. |
| 445 | 445 | ||
| 446 | Follow these general steps to prepare a Windows machine using WSLv2 as | 446 | Follow these general steps to prepare a Windows machine using WSL 2 as |
| 447 | your Yocto Project build host: | 447 | your Yocto Project build host: |
| 448 | 448 | ||
| 449 | 1. *Make sure your Windows 10 machine is capable of running WSLv2:* | 449 | 1. *Make sure your Windows machine is capable of running WSL 2:* |
| 450 | WSLv2 is only available for Windows 10 builds > 18917. To check which | 450 | |
| 451 | build version you are running, you may open a command prompt on | 451 | While all Windows 11 and Windows Server 2022 builds support WSL 2, |
| 452 | Windows and execute the command "ver". | 452 | the first versions of Windows 10 and Windows Server 2019 didn't. |
| 453 | :: | 453 | Check the minimum build numbers for `Windows 10 |
| 454 | <https://learn.microsoft.com/en-us/windows/wsl/install-manual#step-2---check-requirements-for-running-wsl-2>`__ | ||
| 455 | and for `Windows Server 2019 | ||
| 456 | <https://learn.microsoft.com/en-us/windows/wsl/install-on-server>`__. | ||
| 457 | |||
| 458 | To check which build version you are running, you may open a command | ||
| 459 | prompt on Windows and execute the command "ver":: | ||
| 454 | 460 | ||
| 455 | C:\Users\myuser> ver | 461 | C:\Users\myuser> ver |
| 456 | 462 | ||
| 457 | Microsoft Windows [Version 10.0.19041.153] | 463 | Microsoft Windows [Version 10.0.19041.153] |
| 458 | 464 | ||
| 459 | If your build is capable of running | 465 | 2. *Install the Linux distribution of your choice inside WSL 2:* |
| 460 | WSLv2 you may continue, for more information on this subject or | 466 | Once you know your version of Windows supports WSL 2, you can |
| 461 | instructions on how to upgrade to WSLv2 visit `Windows 10 | ||
| 462 | WSLv2 <https://docs.microsoft.com/en-us/windows/wsl/wsl2-install>`__ | ||
| 463 | |||
| 464 | 2. *Install the Linux distribution of your choice inside Windows 10:* | ||
| 465 | Once you know your version of Windows 10 supports WSLv2, you can | ||
| 466 | install the distribution of your choice from the Microsoft Store. | 467 | install the distribution of your choice from the Microsoft Store. |
| 467 | Open the Microsoft Store and search for Linux. While there are | 468 | Open the Microsoft Store and search for Linux. While there are |
| 468 | several Linux distributions available, the assumption is that your | 469 | several Linux distributions available, the assumption is that your |
| @@ -471,31 +472,28 @@ your Yocto Project build host: | |||
| 471 | making your selection, simply click "Get" to download and install the | 472 | making your selection, simply click "Get" to download and install the |
| 472 | distribution. | 473 | distribution. |
| 473 | 474 | ||
| 474 | 3. *Check your Linux distribution is using WSLv2:* Open a Windows | 475 | 3. *Check which Linux distribution WSL 2 is using:* Open a Windows |
| 475 | PowerShell and run:: | 476 | PowerShell and run:: |
| 476 | 477 | ||
| 477 | C:\WINDOWS\system32> wsl -l -v | 478 | C:\WINDOWS\system32> wsl -l -v |
| 478 | NAME STATE VERSION | 479 | NAME STATE VERSION |
| 479 | *Ubuntu Running 2 | 480 | *Ubuntu Running 2 |
| 480 | 481 | ||
| 481 | Note the version column which says the WSL version | 482 | Note that WSL 2 supports running as many different Linux distributions |
| 482 | being used by your distribution, on compatible systems, this can be | 483 | as you want to install. |
| 483 | changed back at any point in time. | ||
| 484 | 484 | ||
| 485 | 4. *Optionally Orient Yourself on WSL:* If you are unfamiliar with WSL, | 485 | 4. *Optionally Get Familiar with WSL:* You can learn more on |
| 486 | you can learn more here - | ||
| 487 | https://docs.microsoft.com/en-us/windows/wsl/wsl2-about. | 486 | https://docs.microsoft.com/en-us/windows/wsl/wsl2-about. |
| 488 | 487 | ||
| 489 | 5. *Launch your WSL Distibution:* From the Windows start menu simply | 488 | 5. *Launch your WSL Distibution:* From the Windows start menu simply |
| 490 | launch your WSL distribution just like any other application. | 489 | launch your WSL distribution just like any other application. |
| 491 | 490 | ||
| 492 | 6. *Optimize your WSLv2 storage often:* Due to the way storage is | 491 | 6. *Optimize your WSL 2 storage often:* Due to the way storage is |
| 493 | handled on WSLv2, the storage space used by the undelying Linux | 492 | handled on WSL 2, the storage space used by the underlying Linux |
| 494 | distribution is not reflected immedately, and since bitbake heavily | 493 | distribution is not reflected immediately, and since BitBake heavily |
| 495 | uses storage, after several builds, you may be unaware you are | 494 | uses storage, after several builds, you may be unaware you are |
| 496 | running out of space. WSLv2 uses a VHDX file for storage, this issue | 495 | running out of space. As WSL 2 uses a VHDX file for storage, this issue |
| 497 | can be easily avoided by manually optimizing this file often, this | 496 | can be easily avoided by regularly optimizing this file in a manual way: |
| 498 | can be done in the following way: | ||
| 499 | 497 | ||
| 500 | 1. *Find the location of your VHDX file:* | 498 | 1. *Find the location of your VHDX file:* |
| 501 | 499 | ||
| @@ -549,14 +547,14 @@ your Yocto Project build host: | |||
| 549 | 547 | ||
| 550 | .. note:: | 548 | .. note:: |
| 551 | 549 | ||
| 552 | The current implementation of WSLv2 does not have out-of-the-box | 550 | The current implementation of WSL 2 does not have out-of-the-box |
| 553 | access to external devices such as those connected through a USB | 551 | access to external devices such as those connected through a USB |
| 554 | port, but it automatically mounts your ``C:`` drive on ``/mnt/c/`` | 552 | port, but it automatically mounts your ``C:`` drive on ``/mnt/c/`` |
| 555 | (and others), which you can use to share deploy artifacts to be later | 553 | (and others), which you can use to share deploy artifacts to be later |
| 556 | flashed on hardware through Windows, but your build directory should | 554 | flashed on hardware through Windows, but your build directory should |
| 557 | not reside inside this mountpoint. | 555 | not reside inside this mountpoint. |
| 558 | 556 | ||
| 559 | Once you have WSLv2 set up, everything is in place to develop just as if | 557 | Once you have WSL 2 set up, everything is in place to develop just as if |
| 560 | you were running on a native Linux machine. If you are going to use the | 558 | you were running on a native Linux machine. If you are going to use the |
| 561 | Extensible SDK container, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto | 559 | Extensible SDK container, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto |
| 562 | Project Application Development and the Extensible Software Development | 560 | Project Application Development and the Extensible Software Development |
diff --git a/documentation/overview-manual/yp-intro.rst b/documentation/overview-manual/yp-intro.rst index 3dc8ae5519..8683fb9ebd 100644 --- a/documentation/overview-manual/yp-intro.rst +++ b/documentation/overview-manual/yp-intro.rst | |||
| @@ -596,20 +596,15 @@ Build Host runs, you have several choices. | |||
| 596 | ":ref:`dev-manual/start:setting up to use cross platforms (crops)`" | 596 | ":ref:`dev-manual/start:setting up to use cross platforms (crops)`" |
| 597 | section in the Yocto Project Development Tasks Manual. | 597 | section in the Yocto Project Development Tasks Manual. |
| 598 | 598 | ||
| 599 | - *Windows Subsystem For Linux (WSLv2):* You may use Windows Subsystem | 599 | - *Windows Subsystem For Linux (WSL 2):* You may use Windows Subsystem |
| 600 | For Linux v2 to set up a Build Host using Windows 10. | 600 | For Linux version 2 to set up a Build Host using Windows 10 or later, |
| 601 | or Windows Server 2019 or later. | ||
| 601 | 602 | ||
| 602 | .. note:: | 603 | The Windows Subsystem For Linux allows Windows to run a real Linux |
| 603 | |||
| 604 | The Yocto Project is not compatible with WSLv1, it is compatible | ||
| 605 | but not officially supported nor validated with WSLv2, if you | ||
| 606 | still decide to use WSL please upgrade to WSLv2. | ||
| 607 | |||
| 608 | The Windows Subsystem For Linux allows Windows 10 to run a real Linux | ||
| 609 | kernel inside of a lightweight virtual machine (VM). | 604 | kernel inside of a lightweight virtual machine (VM). |
| 610 | 605 | ||
| 611 | For information on how to set up a Build Host with WSLv2, see the | 606 | For information on how to set up a Build Host with WSL 2, see the |
| 612 | ":ref:`dev-manual/start:setting up to use windows subsystem for linux (wslv2)`" | 607 | ":ref:`dev-manual/start:setting up to use windows subsystem for linux (wsl 2)`" |
| 613 | section in the Yocto Project Development Tasks Manual. | 608 | section in the Yocto Project Development Tasks Manual. |
| 614 | 609 | ||
| 615 | - *Toaster:* Regardless of what your Build Host is running, you can use | 610 | - *Toaster:* Regardless of what your Build Host is running, you can use |
diff --git a/documentation/ref-manual/system-requirements.rst b/documentation/ref-manual/system-requirements.rst index 79c40046b4..8499c1b1e8 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst | |||
| @@ -127,12 +127,12 @@ tested on former revisions of "&DISTRO_NAME;", but no longer are: | |||
| 127 | the ":ref:`system-requirements-buildtools`" section. | 127 | the ":ref:`system-requirements-buildtools`" section. |
| 128 | 128 | ||
| 129 | - You may use Windows Subsystem For Linux v2 to set up a build host | 129 | - You may use Windows Subsystem For Linux v2 to set up a build host |
| 130 | using Windows 10, but validation is not performed against build | 130 | using Windows 10 or later, or Windows Server 2019 or later, but validation |
| 131 | hosts using WSLv2. | 131 | is not performed against build hosts using WSL 2. |
| 132 | 132 | ||
| 133 | - The Yocto Project is not compatible with WSLv1, it is | 133 | See the |
| 134 | compatible but not officially supported nor validated with | 134 | :ref:`dev-manual/start:setting up to use windows subsystem for linux (wsl 2)` |
| 135 | WSLv2, if you still decide to use WSL please upgrade to WSLv2. | 135 | section in the Yocto Project Development Tasks Manual for more information. |
| 136 | 136 | ||
| 137 | - If you encounter problems, please go to :yocto_bugs:`Yocto Project | 137 | - If you encounter problems, please go to :yocto_bugs:`Yocto Project |
| 138 | Bugzilla <>` and submit a bug. We are | 138 | Bugzilla <>` and submit a bug. We are |
