doc/md/Installation_Instructions/VSCode-Installation-Instructions.md

   1 <a id="Top"></a>
   2
   3 # Visual Studio Code Installation Instructions
   4
   5 # Table of Contents
   6 - [Visual Studio Code Installation Instructions](#visual-studio-code-installation-instructions)
   7 - [Table of Contents](#table-of-contents)
   8 - [Visual Studio Code for debugging](#visual-studio-code-for-debugging)
   9   - [Debian / Ubuntu / Kali / ParrotOS / Raspbian](#debian--ubuntu--kali--parrotos--raspbian)
  10   - [Windows: WSL](#windows-wsl)
  11   - [Windows: ProxSpace](#windows-proxspace)
  12
  13
  14
  15 # Visual Studio Code for debugging
  16 ^[Top](#top)
  17
  18 Download and install [Visual Studio Code](https://code.visualstudio.com/)
  19
  20 Download and install [J-Link Software and Documentation pack](https://www.segger.com/downloads/jlink)
  21
  22
  23 ## Debian / Ubuntu / Kali / ParrotOS / Raspbian
  24 ^[Top](#top)
  25
  26 Install dependencies
  27
  28 ```sh
  29 sudo apt-get install --no-install-recommends binutils-arm-none-eabi gdb openocd gdb-multiarch
  30 ```
  31
  32 On some systems `arm-none-eabi-gdb` was replaced with `gdb-multiarch`. In order to use the J-Link debugger you need to link `arm-none-eabi-gdb` to `gdb-multiarch`:
  33 ```sh
  34 ln -s /usr/bin/gdb-multiarch /usr/bin/arm-none-eabi-gdb
  35 ```
  36
  37 Setup the Visual Studio Code configuration, by going into your project folder and run:
  38 ```sh
  39 ./.vscode/setup.sh
  40 ```
  41
  42 now launch Visual Studio Code and open your project folder
  43
  44
  45 ## Windows: WSL
  46 ^[Top](#top)
  47
  48 Enter WSL prompt (`wsl` or `start windows terminal`)
  49
  50 Install dependencies
  51 ```sh
  52 sudo apt-get install --no-install-recommends binutils-arm-none-eabi gdb openocd gdb-multiarch
  53 ```
  54
  55 The J-Link debugger requires `arm-none-eabi-gdb` which was replaced with `gdb-multiarch`. In order to use the J-Link debugger link `arm-none-eabi-gdb` to `gdb-multiarch`:
  56 ```sh
  57 sudo ln -s /usr/bin/gdb-multiarch /usr/bin/arm-none-eabi-gdb
  58 ```
  59
  60 Setup the Visual Studio Code configuration, by going into your project folder and run:
  61 ```sh
  62 ./.vscode/setup.sh
  63 ```
  64
  65 and launch Visual Studio Code
  66 ```sh
  67 code .
  68 ```
  69
  70
  71 ## Windows: ProxSpace
  72 ^[Top](#top)
  73
  74 Download and install [Visual Studio Code](https://code.visualstudio.com/)
  75
  76 Download and install [J-Link Software and Documentation pack for Windows](https://www.segger.com/downloads/jlink/JLink_Windows.exe)
  77
  78 Enter PorxSpace (`runme64.bat`)  and enter your project folder.
  79
  80 Setup the Visual Studio Code configuration, by running:
  81 ```sh
  82 ./.vscode/setup.sh
  83 ```
  84
  85 now launch Visual Studio Code and open your project folder
  86
  87
  88
  89 _note_
  90 Please install the recommended Visual Studio Code extensions in order for debugging to work.