@@ -27,7 +23,7 @@ There is no requirement on what editor you should use, but if you are undecided
...
@@ -27,7 +23,7 @@ There is no requirement on what editor you should use, but if you are undecided
When installed, go to the extensions tab and install ```Rust (rls)``` and ```Better TOML```.
When installed, go to the extensions tab and install ```Rust (rls)``` and ```Better TOML```.
# Linux
## Linux
In general use your package manager for whatever distribution you are using.
In general use your package manager for whatever distribution you are using.
...
@@ -70,11 +66,11 @@ sudo pacman -S openocd
...
@@ -70,11 +66,11 @@ sudo pacman -S openocd
```
```
# Windows
## Windows
## Native
### Native
### GDB
#### GDB
Go to http://www.mingw.org/, download and install MinGW. In the MinGW Installation Manager select ```All Packages``` then mark for installation:
Go to http://www.mingw.org/, download and install MinGW. In the MinGW Installation Manager select ```All Packages``` then mark for installation:
- mingw32-gcc-g++
- mingw32-gcc-g++
...
@@ -92,7 +88,7 @@ Go to the Control panel -> System and Security -> System -> Advanced system sett
...
@@ -92,7 +88,7 @@ Go to the Control panel -> System and Security -> System -> Advanced system sett
To check that everything went as expected open a new terminal with ```CTRL+r``` and type cmd then ```ENTER```.
To check that everything went as expected open a new terminal with ```CTRL+r``` and type cmd then ```ENTER```.
If you now type ```gdb`` you should be prompted with a text saying something like "GNU gdb (GDB) 7.6.1", gdb is now installed!
If you now type ```gdb`` you should be prompted with a text saying something like "GNU gdb (GDB) 7.6.1", gdb is now installed!
### OpenOCD
#### OpenOCD
Go to http://gnutoolchains.com/arm-eabi/openocd/ and download the latest OpenOCD package.
Go to http://gnutoolchains.com/arm-eabi/openocd/ and download the latest OpenOCD package.
Extract the package somewhere where it is easy to find (i.e C:).
Extract the package somewhere where it is easy to find (i.e C:).
...
@@ -100,7 +96,7 @@ Extract the package somewhere where it is easy to find (i.e C:).
...
@@ -100,7 +96,7 @@ Extract the package somewhere where it is easy to find (i.e C:).
/// TODO ///
/// TODO ///
## Windows Subsystem for Linux (WSL) - Windows 10 ONLY
### Windows Subsystem for Linux (WSL) - Windows 10 ONLY
To install WSL check out: https://docs.microsoft.com/en-us/windows/wsl/install-win10. We recommend the Ubuntu distro.
To install WSL check out: https://docs.microsoft.com/en-us/windows/wsl/install-win10. We recommend the Ubuntu distro.
...
@@ -118,23 +114,23 @@ Using the terminal, update the distro:
...
@@ -118,23 +114,23 @@ Using the terminal, update the distro:
The ordinary C: drive will be found under /mnt/c
The ordinary C: drive will be found under /mnt/c
### Rust
#### Rust
Continue in the terminal and write:
Continue in the terminal and write:
```curl https://sh.rustup.rs -sSf | sh```
```curl https://sh.rustup.rs -sSf | sh```
### GDB
#### GDB
/// TODO ///
/// TODO ///
### OpenOCD
#### OpenOCD
Is the same as for native Windows as OpenOCD doesn't (currently) work under WSL.
Is the same as for native Windows as OpenOCD doesn't (currently) work under WSL.
### Quality of life
#### Quality of life
#### Shortcuts
##### Shortcuts
To be able to quickly get up and running I usually create a shortcut on the desktop with all flags I need for a certain project and with the configurations that I need. For example, if I have a project that uses OpenOCD, the STLink programmer and the target MCU is an STM32f4xx, I create a shortcut with the target:
To be able to quickly get up and running I usually create a shortcut on the desktop with all flags I need for a certain project and with the configurations that I need. For example, if I have a project that uses OpenOCD, the STLink programmer and the target MCU is an STM32f4xx, I create a shortcut with the target:
