You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/getting-started/toolchain-install.md
+21-19Lines changed: 21 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,32 +6,34 @@ This page explains how to set up ARM GCC and other tools on your computer so tha
6
6
7
7
Note: You can also watch this in video version - [Youtube guide](https://youtu.be/ubf6ODHOHEs)
8
8
9
-
1. Get CMake by downloading the installer from [here](https://cmake.org/download/). If you already have CMake installed, make sure it's at least version 3.16. Make sure to select "Add CMake to the system PATH for all users" in the installer!
10
-
2. Download the latest Ninja Build binary from [here](https://github.com/ninja-build/ninja/releases) (grab ninja-win.zip). Then, you need to extract the exe file to somewhere on your PATH. Note: It might be convenient to put it into the CMake bin folder (`C:\Program Files\CMake\bin`) since the CMake installer has already added that to your PATH.
11
-
3. Go to ARM's [toolchain download page](https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads) and download the exe installer under "Windows (mingw-w64-x86_64) hosted cross toolchains" > "AArch32 bare-metal target (arm-none-eabi)". Then, execute it and go through the installer, making sure to check the "Add path to environment variable" box!
4. If you don't already have it, install [Git](https://git-scm.com/). It is important for work with Github repos - creating, importing or cloning of projects and libraries.
9
+
1. Install CMake and Ninja. You can download these manually ([here](https://cmake.org/download/) for CMake and [here](https://github.com/ninja-build/ninja/releases) for Ninja), but the easiest way is to use WinGet. To install them with winget, open an administrator command prompt, then run
5. If you don't already have it, install [Python 3](https://www.python.org/downloads/) so that you can run python from the command line.
14
+
2. Go to ARM's [toolchain download page](https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads) and download the exe installer under "Windows (mingw-w64-x86_64) hosted cross toolchains" > "AArch32 bare-metal target (arm-none-eabi)". Then, execute it and go through the installer, making sure to check the "Add path to environment variable" box!
18
15
19
-
> **IMPORTANT!** - It is recommended not to install the latest Python release if it's less than a couple months old. This will help you to avoid potential incompatibility issues with some dependencies later as not every Python package publishes binaries right away for new releases.
> **WARNING!** - The Windows Store version of python is not recommended. To make sure Python gets installed correctly, follow the install process below:
3. If you don't already have it, install [Git](https://git-scm.com/). It is important for work with Github repos - creating, importing or cloning of projects and libraries.
25
21
26
-
Click Next on the second screen.
22
+
4. If you don't already have it, install Python 3 so that you can run python from the command line. The easiest way to do this is to use winget to install python install manager, via an administrator command prompt:
Then, in a *newly opened, non-administrator* terminal, you can install Python and make the new version the default. Example for 3.13:
27
+
```
28
+
> py install 3.13
29
+
> setx PYTHON_MANAGER_DEFAULT 3.13
30
+
```
31
+
32
+
**Important!** It is recommended not to install the latest Python release if it's less than a couple months old. This will help you to avoid potential incompatibility issues with some dependencies later, as not every Python package publishes binaries right away for new releases. As of this writing (Oct 2025), use of version 3.13 or older is recommended.
5. Add Python to your path. Search for "Edit environment variables for your account" in the start menu and click on the top result. Then find and edit "Path" in the top pane. Finally, add `C:\Users\<YourUsername>\AppData\Local\Python\bin` to the list of path entries. When done, it should look like:
29
35
30
-
On the third screen, check "Install for all users". Also, make sure "Add Python to environment variables" is checked.
0 commit comments