Document WSL bug workaround (#28696)

* Document WSL bug workaround

WSL developers may run into an issue while running GUIs, where GUIs will segfault or crash due to hardware rendering issues.

Use LIBGL_ALWAYS_SOFTWARE=1 if you see segfaults or other strange GUI failures even after setting up a fresh WSL.

History: https://github.com/commaai/openpilot/discussions/26091#discussioncomment-4258846 .

* make smaller

---------

Co-authored-by: Adeeb Shihadeh <adeebshihadeh@gmail.com>
pull/28490/head^2
Lucas Keller 2 years ago committed by GitHub
parent 36fe84ccdd
commit 0e34b87744
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 2
      tools/README.md

@ -42,6 +42,8 @@ Neither openpilot nor any of the tools are developed or tested on Windows, but t
Follow [these instructions](https://docs.microsoft.com/en-us/windows/wsl/install) to setup the WSL and install the `Ubuntu-20.04` distribution. Once your Ubuntu WSL environment is setup, follow the Linux setup instructions to finish setting up your environment. See [these instructions](https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps) for running GUI apps. Follow [these instructions](https://docs.microsoft.com/en-us/windows/wsl/install) to setup the WSL and install the `Ubuntu-20.04` distribution. Once your Ubuntu WSL environment is setup, follow the Linux setup instructions to finish setting up your environment. See [these instructions](https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps) for running GUI apps.
**NOTE**: If you are running WSL and any GUIs are failing (segfaulting or other strange issues) even after following the steps above, you may need to enable software rendering with `LIBGL_ALWAYS_SOFTWARE=1`, e.g. `LIBGL_ALWAYS_SOFTWARE=1 selfdrive/ui/ui`.
## CTF ## CTF
Learn about the openpilot ecosystem and tools by playing our [CTF](/tools/CTF.md). Learn about the openpilot ecosystem and tools by playing our [CTF](/tools/CTF.md).

Loading…
Cancel
Save