diff --git a/src/ch2_02_windows_installation.md b/src/ch2_02_windows_installation.md index a37ae95fe20ab7c6b587993041dc8eb5db6dc61b..7d46ad3b558ac7ed25bc3ca99074d4feb54d4bed 100644 --- a/src/ch2_02_windows_installation.md +++ b/src/ch2_02_windows_installation.md @@ -14,28 +14,28 @@ In the MinGW Installation Manager select ```All Packages``` then mark for instal - mingw32-gdb (lic) - mingw32-gdb (man) -then in the Installation menu choose `Apply Changes`, +then in the Installation menu choose **Apply Changes**, you should see at the bottom of the window that there is going to be several packages in `new/upgraded packages will be installed` -if so then click `Apply`. +if so then click **Apply**. If everything went as expected then you should have the `gdb.exe` file is your MinGW install folder under `/bin`. However to effectively use gdb you need to set the environment variable. -Go to the Control panel -> System and Security -> System -> Advanced system settings, -click the `Environment Variables...` button. +Go to the **Control panel -> System and Security -> System -> Advanced system settings**, +click the **Environment Variables...** button. -In this window in the System variables view click `Edit...` then `New` +In this window in the **System variables** view click **Edit...** then **New** and type in the path to the `gdb.exe` file (should be something like ```C:\MinGW\bin```). -Then click OK in all the windows. +Then click **OK** in all the windows. To check that everything went as expected open a new terminal with -`CTRL+r` and type cmd then `ENTER`. +`CTRL+r` and type `cmd` followed by pressing the **enter**-key. If you now type `gdb` you should be prompted with a text saying something like -"GNU gdb (GDB) 7.6.1". +`GNU gdb (GDB) 7.6.1`. GDB is now installed! @@ -57,16 +57,16 @@ We recommend the Ubuntu distro. To open a distro terminal: Ctrl+r and write `cmd` and run. In the terminal type `bash`, this will spawn a ubuntu terminal. -Using the terminal, update the distro: +Using the terminal, update the distro and install build-essential and gdb: ```shell sudo apt update +sudo apt upgrade + sudo apt install build-essential sudo apt install gdb - -sudo apt upgrade ``` The ordinary `C:` drive will be found under `/mnt/c` @@ -114,7 +114,7 @@ I would create a shortcut with the target: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe .\openocd.exe -f ../share/openocd/scripts/interface/stlink.cfg -f ../share/openocd/scripts/target/stm32f4x.cfg ``` -and make it start in the openocd/bin folder i.e `C:\OpenOCD\bin`. +and make it start in the `openocd/bin` folder i.e `C:\OpenOCD\bin`. If you want it to be really fancy then under layout you can change where the window should spawn as well as how it should look like.