src/doc/embedded-book/src/intro/install/windows.md

   1 # Windows
   2
   3 ## `arm-none-eabi-gdb`
   4
   5 ARM provides `.exe` installers for Windows. Grab one from [here][gcc], and follow the instructions.
   6 Just before the installation process finishes tick/select the "Add path to environment variable"
   7 option. Then verify that the tools are in your `%PATH%`:
   8
   9 ``` text
  10 $ arm-none-eabi-gdb -v
  11 GNU gdb (GNU Tools for Arm Embedded Processors 7-2018-q2-update) 8.1.0.20180315-git
  12 (..)
  13 ```
  14
  15 [gcc]: https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads
  16
  17 ## OpenOCD
  18
  19 There's no official binary release of OpenOCD for Windows but if you're not in the mood to compile
  20 it yourself, the xPack project provides a binary distribution, [here][openocd]. Follow the
  21 provided installation instructions. Then update your `%PATH%` environment variable to
  22 include the path where the binaries were installed. (`C:\Users\USERNAME\AppData\Roaming\xPacks\@xpack-dev-tools\openocd\0.10.0-13.1\.content\bin\`,
  23 if you've been using the easy install)
  24
  25 [openocd]: https://xpack.github.io/openocd/
  26
  27 Verify that OpenOCD is in your `%PATH%` with:
  28
  29 ``` text
  30 $ openocd -v
  31 Open On-Chip Debugger 0.10.0
  32 (..)
  33 ```
  34
  35 ## QEMU
  36
  37 Grab QEMU from [the official website][qemu].
  38
  39 [qemu]: https://www.qemu.org/download/#windows
  40
  41 ## ST-LINK USB driver
  42
  43 You'll also need to install [this USB driver] or OpenOCD won't work. Follow the installer
  44 instructions and make sure you install the right version (32-bit or 64-bit) of the driver.
  45
  46 [this USB driver]: http://www.st.com/en/embedded-software/stsw-link009.html
  47
  48 That's all! Go to the [next section].
  49
  50 [next section]: verify.md