Skip to content

Improve Windows installation instructions #69

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 13, 2024
Merged

Improve Windows installation instructions #69

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
49fbbdf
Improve Windows installation instructions
sharkwouter Oct 13, 2024
b310df2
Fix installation step numbering
sharkwouter Oct 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions installation/windows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,10 +18,14 @@ To set up WSL with Ubuntu in it run the following commands in a Powershell windo
wsl --install
```

After this is done, Ubuntu can be selected from the start menu to open a terminal. This will be used for all commands going forward.
When this is done, restart your computer. Afterwards Ubuntu can be selected from the start menu to open a terminal, do this once to set up your user.

From now on the Ubuntu shell will be used when running commands going forward.

Files in Ubuntu can be accessed through a network share. In `This Computer` right click on the background and select `Map network drive`. Set the folder to `\\wsl$` to make it easily accessible.

Alternatively, you can open an Ubuntu terminal in a specific directory by holding shift and clicking the right mouse button on the background in the file browser and selecting `Open Linux shell here`.

## Dependencies
{: .fs-6 .fw-700 }

Expand All @@ -32,16 +36,22 @@ sudo apt-get update
```

```shell
sudo apt-get install build-essential cmake pkgconf libreadline8 libusb-0.1 libgpgme11 libarchive-tools fakeroot curl
sudo apt-get install build-essential cmake pkgconf libreadline8 libusb-0.1 libgpgme11 libarchive-tools fakeroot wget
```

## Toolchain
{: .fs-6 .fw-700 }

Installing the PSPDEV toolchain itself can be done with the following steps:

1. In a fresh WSL Session download the Toolchain Archive using curl `curl -O https://github.com/pspdev/pspdev/releases/latest/download/pspdev-ubuntu-latest-x86_64.tar.gz`
2. Extract the archive using `tar -xvf pspdev-ubuntu-latest-x86_64.tar.gz`
1. In a fresh WSL Session download the Toolchain Archive using the following command:
```shell
wget https://github.com/pspdev/pspdev/releases/latest/download/pspdev-ubuntu-latest-x86_64.tar.gz
```
2. Extract the archive using:
```shell
tar -xvf pspdev-ubuntu-latest-x86_64.tar.gz
```
3. To make the toolchain usable, some environment variables need to be set. The first step in doing so it to open the `~/.bashrc` file with the `nano` text editor using the following command from an Ubuntu terminal:
```shell
nano ~/.bashrc
Expand All @@ -57,5 +67,6 @@ Installing the PSPDEV toolchain itself can be done with the following steps:
```shell
psp-config --pspdev-path
```
If everything is set up correctly, the path of the PSPDEV toolchain installation will be shown.

That's it, now the PSPDEV toolchain can be used to build PSP software. Check out the [Basic Programs](../basic_programs.html) page to for examples on what you can do with it.