diff options
| -rw-r--r-- | documentation/brief-yoctoprojectqs/index.rst | 17 | ||||
| -rw-r--r-- | documentation/dev-manual/start.rst | 70 | ||||
| -rw-r--r-- | documentation/overview-manual/yp-intro.rst | 17 | ||||
| -rw-r--r-- | documentation/ref-manual/system-requirements.rst | 10 |
4 files changed, 50 insertions, 64 deletions
diff --git a/documentation/brief-yoctoprojectqs/index.rst b/documentation/brief-yoctoprojectqs/index.rst index 7ae0ddc349..100022ceba 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 6816ce5846..23d5643d12 100644 --- a/documentation/dev-manual/start.rst +++ b/documentation/dev-manual/start.rst | |||
| @@ -267,16 +267,16 @@ development using the Yocto Project. Your build host can be a native | |||
| 267 | Linux machine (recommended), it can be a machine (Linux, Mac, or | 267 | Linux machine (recommended), it can be a machine (Linux, Mac, or |
| 268 | Windows) that uses `CROPS <https://github.com/crops/poky-container>`__, | 268 | Windows) that uses `CROPS <https://github.com/crops/poky-container>`__, |
| 269 | which leverages `Docker Containers <https://www.docker.com/>`__ or it | 269 | which leverages `Docker Containers <https://www.docker.com/>`__ or it |
| 270 | can be a Windows machine capable of running Windows Subsystem For Linux | 270 | can be a Windows machine capable of running version 2 of Windows Subsystem |
| 271 | v2 (WSL). | 271 | For Linux (WSL 2). |
| 272 | 272 | ||
| 273 | .. note:: | 273 | .. note:: |
| 274 | 274 | ||
| 275 | The Yocto Project is not compatible with | 275 | The Yocto Project is not compatible with version 1 of |
| 276 | `Windows Subsystem for Linux v1 <https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux>`__. | 276 | `Windows Subsystem for Linux <https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux>`__. |
| 277 | It is compatible but not officially supported nor validated with | 277 | It is compatible but neither officially supported nor validated with |
| 278 | WSLv2. If you still decide to use WSL please upgrade to | 278 | WSL 2. If you still decide to use WSL please upgrade to |
| 279 | `WSLv2 <https://docs.microsoft.com/en-us/windows/wsl/install-win10>`__. | 279 | `WSL 2 <https://learn.microsoft.com/en-us/windows/wsl/install>`__. |
| 280 | 280 | ||
| 281 | Once your build host is set up to use the Yocto Project, further steps | 281 | Once your build host is set up to use the Yocto Project, further steps |
| 282 | are necessary depending on what you want to accomplish. See the | 282 | are necessary depending on what you want to accomplish. See the |
| @@ -441,35 +441,36 @@ Kit (eSDK) manual. If you are going to use the Toaster container, see | |||
| 441 | the ":doc:`/toaster-manual/setup-and-use`" | 441 | the ":doc:`/toaster-manual/setup-and-use`" |
| 442 | section in the Toaster User Manual. | 442 | section in the Toaster User Manual. |
| 443 | 443 | ||
| 444 | Setting Up to Use Windows Subsystem For Linux (WSLv2) | 444 | Setting Up to Use Windows Subsystem For Linux (WSL 2) |
| 445 | ----------------------------------------------------- | 445 | ----------------------------------------------------- |
| 446 | 446 | ||
| 447 | With `Windows Subsystem for Linux | 447 | With `Windows Subsystem for Linux (WSL 2) |
| 448 | (WSLv2) <https://docs.microsoft.com/en-us/windows/wsl/wsl2-about>`__, | 448 | <https://learn.microsoft.com/en-us/windows/wsl/>`__, |
| 449 | you can create a Yocto Project development environment that allows you | 449 | you can create a Yocto Project development environment that allows you |
| 450 | to build on Windows. You can set up a Linux distribution inside Windows | 450 | to build on Windows. You can set up a Linux distribution inside Windows |
| 451 | in which you can develop using the Yocto Project. | 451 | in which you can develop using the Yocto Project. |
| 452 | 452 | ||
| 453 | Follow these general steps to prepare a Windows machine using WSLv2 as | 453 | Follow these general steps to prepare a Windows machine using WSL 2 as |
| 454 | your Yocto Project build host: | 454 | your Yocto Project build host: |
| 455 | 455 | ||
| 456 | 1. *Make sure your Windows 10 machine is capable of running WSLv2:* | 456 | 1. *Make sure your Windows machine is capable of running WSL 2:* |
| 457 | WSLv2 is only available for Windows 10 builds > 18917. To check which | 457 | |
| 458 | build version you are running, you may open a command prompt on | 458 | While all Windows 11 and Windows Server 2022 builds support WSL 2, |
| 459 | Windows and execute the command "ver". | 459 | the first versions of Windows 10 and Windows Server 2019 didn't. |
| 460 | :: | 460 | Check the minimum build numbers for `Windows 10 |
| 461 | <https://learn.microsoft.com/en-us/windows/wsl/install-manual#step-2---check-requirements-for-running-wsl-2>`__ | ||
| 462 | and for `Windows Server 2019 | ||
| 463 | <https://learn.microsoft.com/en-us/windows/wsl/install-on-server>`__. | ||
| 464 | |||
| 465 | To check which build version you are running, you may open a command | ||
| 466 | prompt on Windows and execute the command "ver":: | ||
| 461 | 467 | ||
| 462 | C:\Users\myuser> ver | 468 | C:\Users\myuser> ver |
| 463 | 469 | ||
| 464 | Microsoft Windows [Version 10.0.19041.153] | 470 | Microsoft Windows [Version 10.0.19041.153] |
| 465 | 471 | ||
| 466 | If your build is capable of running | 472 | 2. *Install the Linux distribution of your choice inside WSL 2:* |
| 467 | WSLv2 you may continue, for more information on this subject or | 473 | Once you know your version of Windows supports WSL 2, you can |
| 468 | instructions on how to upgrade to WSLv2 visit `Windows 10 | ||
| 469 | WSLv2 <https://docs.microsoft.com/en-us/windows/wsl/wsl2-install>`__ | ||
| 470 | |||
| 471 | 2. *Install the Linux distribution of your choice inside Windows 10:* | ||
| 472 | Once you know your version of Windows 10 supports WSLv2, you can | ||
| 473 | install the distribution of your choice from the Microsoft Store. | 474 | install the distribution of your choice from the Microsoft Store. |
| 474 | Open the Microsoft Store and search for Linux. While there are | 475 | Open the Microsoft Store and search for Linux. While there are |
| 475 | several Linux distributions available, the assumption is that your | 476 | several Linux distributions available, the assumption is that your |
| @@ -478,31 +479,28 @@ your Yocto Project build host: | |||
| 478 | making your selection, simply click "Get" to download and install the | 479 | making your selection, simply click "Get" to download and install the |
| 479 | distribution. | 480 | distribution. |
| 480 | 481 | ||
| 481 | 3. *Check your Linux distribution is using WSLv2:* Open a Windows | 482 | 3. *Check which Linux distribution WSL 2 is using:* Open a Windows |
| 482 | PowerShell and run:: | 483 | PowerShell and run:: |
| 483 | 484 | ||
| 484 | C:\WINDOWS\system32> wsl -l -v | 485 | C:\WINDOWS\system32> wsl -l -v |
| 485 | NAME STATE VERSION | 486 | NAME STATE VERSION |
| 486 | *Ubuntu Running 2 | 487 | *Ubuntu Running 2 |
| 487 | 488 | ||
| 488 | Note the version column which says the WSL version | 489 | Note that WSL 2 supports running as many different Linux distributions |
| 489 | being used by your distribution, on compatible systems, this can be | 490 | as you want to install. |
| 490 | changed back at any point in time. | ||
| 491 | 491 | ||
| 492 | 4. *Optionally Orient Yourself on WSL:* If you are unfamiliar with WSL, | 492 | 4. *Optionally Get Familiar with WSL:* You can learn more on |
| 493 | you can learn more here - | ||
| 494 | https://docs.microsoft.com/en-us/windows/wsl/wsl2-about. | 493 | https://docs.microsoft.com/en-us/windows/wsl/wsl2-about. |
| 495 | 494 | ||
| 496 | 5. *Launch your WSL Distibution:* From the Windows start menu simply | 495 | 5. *Launch your WSL Distibution:* From the Windows start menu simply |
| 497 | launch your WSL distribution just like any other application. | 496 | launch your WSL distribution just like any other application. |
| 498 | 497 | ||
| 499 | 6. *Optimize your WSLv2 storage often:* Due to the way storage is | 498 | 6. *Optimize your WSL 2 storage often:* Due to the way storage is |
| 500 | handled on WSLv2, the storage space used by the underlying Linux | 499 | handled on WSL 2, the storage space used by the underlying Linux |
| 501 | distribution is not reflected immediately, and since BitBake heavily | 500 | distribution is not reflected immediately, and since BitBake heavily |
| 502 | uses storage, after several builds, you may be unaware you are | 501 | uses storage, after several builds, you may be unaware you are |
| 503 | running out of space. WSLv2 uses a VHDX file for storage, this issue | 502 | running out of space. As WSL 2 uses a VHDX file for storage, this issue |
| 504 | can be easily avoided by manually optimizing this file often, this | 503 | can be easily avoided by regularly optimizing this file in a manual way: |
| 505 | can be done in the following way: | ||
| 506 | 504 | ||
| 507 | 1. *Find the location of your VHDX file:* | 505 | 1. *Find the location of your VHDX file:* |
| 508 | 506 | ||
| @@ -556,14 +554,14 @@ your Yocto Project build host: | |||
| 556 | 554 | ||
| 557 | .. note:: | 555 | .. note:: |
| 558 | 556 | ||
| 559 | The current implementation of WSLv2 does not have out-of-the-box | 557 | The current implementation of WSL 2 does not have out-of-the-box |
| 560 | access to external devices such as those connected through a USB | 558 | access to external devices such as those connected through a USB |
| 561 | port, but it automatically mounts your ``C:`` drive on ``/mnt/c/`` | 559 | port, but it automatically mounts your ``C:`` drive on ``/mnt/c/`` |
| 562 | (and others), which you can use to share deploy artifacts to be later | 560 | (and others), which you can use to share deploy artifacts to be later |
| 563 | flashed on hardware through Windows, but your build directory should | 561 | flashed on hardware through Windows, but your build directory should |
| 564 | not reside inside this mountpoint. | 562 | not reside inside this mountpoint. |
| 565 | 563 | ||
| 566 | Once you have WSLv2 set up, everything is in place to develop just as if | 564 | Once you have WSL 2 set up, everything is in place to develop just as if |
| 567 | you were running on a native Linux machine. If you are going to use the | 565 | you were running on a native Linux machine. If you are going to use the |
| 568 | Extensible SDK container, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto | 566 | Extensible SDK container, see the ":doc:`/sdk-manual/extensible`" Chapter in the Yocto |
| 569 | Project Application Development and the Extensible Software Development | 567 | 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 4e3b7c3250..8b476f43c4 100644 --- a/documentation/overview-manual/yp-intro.rst +++ b/documentation/overview-manual/yp-intro.rst | |||
| @@ -584,20 +584,15 @@ Build Host runs, you have several choices. | |||
| 584 | ":ref:`dev-manual/start:setting up to use cross platforms (crops)`" | 584 | ":ref:`dev-manual/start:setting up to use cross platforms (crops)`" |
| 585 | section in the Yocto Project Development Tasks Manual. | 585 | section in the Yocto Project Development Tasks Manual. |
| 586 | 586 | ||
| 587 | - *Windows Subsystem For Linux (WSLv2):* You may use Windows Subsystem | 587 | - *Windows Subsystem For Linux (WSL 2):* You may use Windows Subsystem |
| 588 | For Linux v2 to set up a Build Host using Windows 10. | 588 | For Linux version 2 to set up a Build Host using Windows 10 or later, |
| 589 | or Windows Server 2019 or later. | ||
| 589 | 590 | ||
| 590 | .. note:: | 591 | The Windows Subsystem For Linux allows Windows to run a real Linux |
| 591 | |||
| 592 | The Yocto Project is not compatible with WSLv1, it is compatible | ||
| 593 | but not officially supported nor validated with WSLv2, if you | ||
| 594 | still decide to use WSL please upgrade to WSLv2. | ||
| 595 | |||
| 596 | The Windows Subsystem For Linux allows Windows 10 to run a real Linux | ||
| 597 | kernel inside of a lightweight virtual machine (VM). | 592 | kernel inside of a lightweight virtual machine (VM). |
| 598 | 593 | ||
| 599 | For information on how to set up a Build Host with WSLv2, see the | 594 | For information on how to set up a Build Host with WSL 2, see the |
| 600 | ":ref:`dev-manual/start:setting up to use windows subsystem for linux (wslv2)`" | 595 | ":ref:`dev-manual/start:setting up to use windows subsystem for linux (wsl 2)`" |
| 601 | section in the Yocto Project Development Tasks Manual. | 596 | section in the Yocto Project Development Tasks Manual. |
| 602 | 597 | ||
| 603 | - *Toaster:* Regardless of what your Build Host is running, you can use | 598 | - *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 acc97c9d08..2a6d444040 100644 --- a/documentation/ref-manual/system-requirements.rst +++ b/documentation/ref-manual/system-requirements.rst | |||
| @@ -74,12 +74,12 @@ distributions: | |||
| 74 | the supported platforms listed below. | 74 | the supported platforms listed below. |
| 75 | 75 | ||
| 76 | - You may use Windows Subsystem For Linux v2 to set up a build host | 76 | - You may use Windows Subsystem For Linux v2 to set up a build host |
| 77 | using Windows 10, but validation is not performed against build | 77 | using Windows 10 or later, or Windows Server 2019 or later, but validation |
| 78 | hosts using WSLv2. | 78 | is not performed against build hosts using WSL 2. |
| 79 | 79 | ||
| 80 | - The Yocto Project is not compatible with WSLv1, it is | 80 | See the |
| 81 | compatible but not officially supported nor validated with | 81 | :ref:`dev-manual/start:setting up to use windows subsystem for linux (wsl 2)` |
| 82 | WSLv2, if you still decide to use WSL please upgrade to WSLv2. | 82 | section in the Yocto Project Development Tasks Manual for more information. |
| 83 | 83 | ||
| 84 | - If you encounter problems, please go to :yocto_bugs:`Yocto Project | 84 | - If you encounter problems, please go to :yocto_bugs:`Yocto Project |
| 85 | Bugzilla <>` and submit a bug. We are | 85 | Bugzilla <>` and submit a bug. We are |
