Skip to content

Commit 92874cc

Browse files
committed
Update Arm GNU Toolchain install guide
1 parent 015a36b commit 92874cc

1 file changed

Lines changed: 31 additions & 25 deletions

File tree

content/install-guides/gcc/arm-gnu.md

Lines changed: 31 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,8 @@ weight: 4
1919

2020
## Before you begin
2121

22-
Arm GNU Toolchain is a community supported, pre-built GNU compiler toolchain for Arm based CPUs.
22+
Arm GNU Toolchain is a community-supported, pre-built GNU compiler toolchain for Arm-based CPUs.
23+
2324
There are many versions of the [Arm GNU Toolchain](https://developer.arm.com/Tools%20and%20Software/GNU%20Toolchain) available. In general, the latest version is recommended for use, as this will contain the latest optimization improvements, as well as support for the latest Arm IP.
2425

2526
However there are reasons you may wish to use earlier compiler versions, so older versions are also available.
@@ -37,7 +38,7 @@ Windows
3738
* Available for bare-metal and Linux targets
3839

3940
macOS
40-
* Available for x86_64 and Apple silicon (beta) host architectures
41+
* Available for x86_64 and Apple silicon host architectures
4142
* Available for bare-metal targets only
4243

4344
Download the correct toolchain variant for your development needs from the [Arm Developer website](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads).
@@ -51,11 +52,12 @@ Many Linux distributions make the toolchain available with their package install
5152
sudo apt update
5253
sudo apt install gcc-arm-none-eabi
5354
```
54-
If the installed version does not meet your needs, install [manually](#manual).
55+
56+
If the installed version does not meet your needs, you can install another Arm GNU Toolchain version.
5557

5658
### Manual install {#manual}
5759

58-
Unpack the [downloaded](#download) file to the install directory. The exact file name will depend on the flavor selected.
60+
Unpack the downloaded file to the install directory. The exact file name will depend on the flavor selected.
5961

6062
```console
6163
tar xJf arm-gnu-toolchain-<version>-<host-arch>-<TRIPLE>.tar.xz -C /path/to/install/dir
@@ -69,9 +71,9 @@ export PATH=/path/to/install/dir/bin:$PATH
6971
Here is a specific example for an Arm Linux host and the AArch32 bare-metal target.
7072

7173
```bash { target="ubuntu:latest" }
72-
wget https://developer.arm.com/-/media/Files/downloads/gnu/14.2.rel1/binrel/arm-gnu-toolchain-14.2.rel1-aarch64-arm-none-eabi.tar.xz
73-
tar xJf arm-gnu-toolchain-14.2.rel1-aarch64-arm-none-eabi.tar.xz -C $HOME
74-
echo 'export PATH="$PATH:$HOME/arm-gnu-toolchain-14.2.rel1-aarch64-arm-none-eabi/bin"' >> ~/.bashrc
74+
wget https://developer.arm.com/-/media/Files/downloads/gnu/15.2.rel1/binrel/arm-gnu-toolchain-15.2.rel1-aarch64-arm-none-eabi.tar.xz
75+
tar xJf arm-gnu-toolchain-15.2.rel1-aarch64-arm-none-eabi.tar.xz -C $HOME
76+
echo 'export PATH="$PATH:$HOME/arm-gnu-toolchain-15.2.rel1-aarch64-arm-none-eabi/bin"' >> ~/.bashrc
7577
source ~/.bashrc
7678
```
7779

@@ -90,12 +92,12 @@ For `.pkg` files use the installer.
9092
```console
9193
sudo installer -pkg arm-gnu-toolchain-<version>-<host-arch>-<TRIPLE>.pkg -target /
9294
```
93-
### Update PATH
95+
96+
### Update the search path
97+
9498
Use a text editor to add the `bin` directory as a new line in `/etc/paths`.
95-
```console
96-
sudo nano /etc/paths
97-
```
98-
For example the path could be: `/Applications/ArmGNUToolchain/14.2.rel1/arm-none-eabi/bin`
99+
100+
For example the path could be: `/Applications/ArmGNUToolchain/15.2.rel1/arm-none-eabi/bin`
99101

100102
The `/etc/paths` file is a list of paths to search.
101103

@@ -106,50 +108,54 @@ The `/etc/paths` file is a list of paths to search.
106108
/bin
107109
/usr/sbin
108110
/sbin
109-
/Applications/ArmGNUToolchain/14.2.rel1/arm-none-eabi/bin
111+
/Applications/ArmGNUToolchain/15.2.rel1/arm-none-eabi/bin
110112
```
111113

112114
### Apple Silicon
113115

114116
Here is a specific example for macOS with Apple Silicon and the AArch32 bare-metal target.
115117

116118
```console
117-
wget https://developer.arm.com/-/media/Files/downloads/gnu/14.2.rel1/binrel/arm-gnu-toolchain-14.2.rel1-darwin-arm64-arm-none-eabi.pkg
118-
sudo installer -pkg arm-gnu-toolchain-14.2.rel1-darwin-arm64-arm-none-eabi.pkg -target /
119-
echo '/Applications/ArmGNUToolchain/14.2.rel1/arm-none-eabi/bin' | sudo tee -a /etc/paths
119+
wget https://developer.arm.com/-/media/Files/downloads/gnu/15.2.rel1/binrel/arm-gnu-toolchain-15.2.rel1-darwin-arm64-arm-none-eabi.pkg
120+
sudo installer -pkg arm-gnu-toolchain-15.2.rel1-darwin-arm64-arm-none-eabi.pkg -target /
121+
echo '/Applications/ArmGNUToolchain/15.2.rel1/arm-none-eabi/bin' | sudo tee -a /etc/paths
120122
```
121123

122124
## How do I install the Arm GNU Toolchain on Windows?
123125

124-
**Before release 15.2.Rel1**
126+
### Releases prior to 15.2.Rel1
125127

126-
Double-click on the installer (e.g. `gcc-arm-_version_--mingw-w64-i686-arm-none-eabi.exe`) and follow on-screen instructions.
128+
Double-click on the installer, such as `arm-gnu-toolchain-14.3.rel1-mingw-w64-i686-arm-none-eabi.exe`, and follow on-screen instructions.
127129

128130
The installer can also be run on the command line. When run on
129131
the command-line, the following options can be set:
130132
- `/S` Run in silent mode
131133
- `/P` Adds the installation `bin` directory to the system `PATH`
132134
- `/R` Adds Install Folder registry entry for the install.
133135

134-
For example, to install the tools silently, amend users `PATH` and add registry entry:
136+
For example, to install the tools silently, update the search path, and add the registry entry run:
137+
135138
```console
136-
gcc-arm-<version>--mingw-w64-i686-arm-none-eabi.exe /S /P /R
139+
arm-gnu-toolchain-<version>-mingw-w64-i686-arm-none-eabi.exe /S /P /R
137140
```
138-
The zip package is a backup to Windows installer for those who cannot run the installer. You can unzip the package and then invoke the tools directly.
139141

140-
**From release 15.2.Rel1**
142+
The zip package is a backup to Windows installer for those who cannot run the installer. You can unzip the package and then run the tools directly.
143+
144+
### Releases starting from 15.2.Rel1
141145

142-
Double-click on the installer (e.g. `arm-gnu-toolchain-_version_--mingw-w64-i686-arm-none-eabi.msi`) and follow on-screen instructions.
146+
Double-click on the installer, such as `arm-gnu-toolchain-15.2.rel1-mingw-w64-i686-arm-none-eabi.msi`, and follow on-screen instructions.
143147

144148
To install silently from the command line, use similar to the following:
149+
145150
```console
146151
msiexec /i arm-gnu-toolchain-<version>--mingw-w64-i686-arm-none-eabi.msi EULA=1 /quiet
147152
```
148-
The zip package is a backup to Windows installer for those who cannot run the installer. You can unzip the package and then invoke the tools directly.
153+
154+
The zip package is a backup to Windows installer for those who cannot run the installer. You can unzip the package and then run the tools directly.
149155

150156
## Setting up product license
151157

152-
Arm GNU Toolchain is open sourced and freely available for use. No licenses need to be set up for use.
158+
Arm GNU Toolchain is open source software. No licenses are required.
153159

154160
To use the Arm GNU Toolchain in conjunction with [Arm Development Studio](https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio) you must [register the toolchain](https://developer.arm.com/documentation/101469/2022-0/Installing-and-configuring-Arm-Development-Studio/Register-a-compiler-toolchain).
155161

0 commit comments

Comments
 (0)