Skip to content

Commit 58b852d

Browse files
author
Amanda Butler
authored
Update tools_intro.md
Apply changes from comments.
1 parent 33ea6b3 commit 58b852d

File tree

1 file changed

+6
-14
lines changed

1 file changed

+6
-14
lines changed

docs/tools/tools_intro.md

Lines changed: 6 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -45,31 +45,24 @@ For more information, please see the [Online Compiler page](developing-mbed-onli
4545

4646
You can export your project from any of our tools to third party tools. For instructions, as well as tool-specific information, see [the Exporting to third party toolchains page](exporting.html).
4747

48-
#### Forcing compilation with ARM Compiler 5 for targets already supporting ARM Compiler 6
48+
<div style="background-color:#F3F3F3; text-align:left; vertical-align: middle; padding:15px 30px;"> **Note:** We encourage you to switch to Arm Compiler 6 soon because we will deprecate Arm Compiler 5 support in the future. However, if you need to update to Mbed OS 5.12 but still require compiling with Arm Compiler 5 until you are in possession of Arm Compiler 6, we provide methods to override the Arm toolchain version. If you do this, your target may not be able to compile with Arm Compiler 5, or you may see undefined behaviors.
4949

50-
It's possible that some developers may need to update to Mbed 5.12 release but still requires compiling with ARM Compiler 5 until they are in possession of ARM Compiler 6.
51-
In those cases, you may still be able to use ARM Compiler 5 depending on the target. If your target uses any ARM Compiler 6 specific binaries or code, then it may not
52-
be able to compile with ARM Compiler 5 or you may see undefined behaviors. In other cases, if you want to try force ARM Compiler 5 you can do so with the following options:
50+
To force Arm Compiler 5, you can use the following options:
5351

54-
##### By creating a mbed_app.json to override `supported_toolchains`
55-
56-
In this method, you can create or update your `mbed_app.json` with the following content. Override `supported_toolchains` as below.
52+
- Create or update your `mbed_app.json` with:
5753

5854
```
5955
{
6056
"target_overrides": {
6157
"*": {
62-
"target.supported_toolchains": ["ARMC5"]
58+
"target.supported_toolchains": ["ARMC5", "GCC_ARM", "IAR"]
6359
}
6460
}
6561
}
6662
```
6763

68-
##### By local modifications to `targets.json`
69-
70-
In this method, you have to modify the `supported_toolchains` entry for your target in targets.json to remove all `ARM`, `ARMC6` entries and replace it with `ARMC5`. Note that you can still keep other entries such as `GCC_ARM` or `IAR`.
64+
- Modify the `supported_toolchains` entry in targets.json to replace all `ARM`, `ARMC6` entries with `ARMC5`:
7165

72-
See below for example:
7366
```
7467
"MY_TARGET_NAME": {
7568
"supported_form_factors": [...],
@@ -78,5 +71,4 @@ See below for example:
7871
...
7972
}
8073
```
81-
82-
<span class="note"> **Note:** The above methods to override ARM toolchain version is made available only to enable developers migrating from ARM Compiler 5 to ARM Compiler 6. We encourage developers to make plans to switch to ARM Compiler 6 soon, as we plan to deprecate ARM Compiler 5 support in the future and this migration would ensure that your software is compatible with it. </span>
74+
</div>

0 commit comments

Comments
 (0)