Skip to content

Commit 3ae82c1

Browse files
Amanda ButlerSenRamakri
authored andcommitted
Edit mbed_targets.md
Make initial edits on PR.
1 parent c2d89fd commit 3ae82c1

File tree

1 file changed

+8
-11
lines changed

1 file changed

+8
-11
lines changed

docs/reference/configuration/mbed_targets.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -194,22 +194,19 @@ Enabling `is_disk_virtual` adds delay after flashing firmware binary to make sur
194194

195195
The `supported_toolchains` property is the list of toolchains that support a target. The allowed values for `supported_toolchains` are `ARM`, `uARM`, `ARMC5`, `ARMC6`, `GCC_ARM` and `IAR`.
196196

197-
There are few rules and tools behavior you should be aware of when using `ARM`, `ARMC5`, `ARMC6` for `supported_toolchains` as follows.
198-
* If you specify `ARMC5` in `supported_toolchains`, it means the target supports `Arm Compiler 5 (version 5.06 update 6)` only and the build system will use `Arm Compiler 5` when you specify `-t ARM` or `-t ARMC5` with `mbed compile` command.
197+
When using `ARM`, `ARMC5`, `ARMC6` for `supported_toolchains`, please note:
199198

200-
* If you specify `ARMC6` in `supported_toolchains`, it means the target supports `Arm Compiler 6 (version 6.11)` only and the build system will use `Arm Compiler 6` when you specify `-t ARM` or `-t ARMC6` with `mbed compile` command.
199+
- If you specify `ARMC5` in `supported_toolchains`, it means the target supports Arm Compiler 5 (version 5.06 update 6) only, and the build system uses Arm Compiler 5 when you specify `-t ARM` or `-t ARMC5` with `mbed compile` command.
201200

202-
* If a target specify `ARM` in `supported_toolchains`, it means the target supports compiling with both `Arm Compiler 5` and `Arm Compiler 6`. Note that starting with `MbedOS 5.12 release`, `Arm Compiler 6` will
203-
be the default ARM Compiler for MbedOS. So, for a target which specifies `ARM` in `supported_toolchains`, the system will default to using `Arm Compiler 6` when you specify `-t ARM` with `mbed compile` command. If the build system
204-
fails to detect a valid configuration for `Arm Compiler 6`, it will automatically(without any manual intervention) try to detect if a valid confguration for `ARM Compiler 5` exists, and will continue using `ARM Compiler 5` if it successfully detects `ARM Compiler 5`. You may see a warning message in your standard output from build system indicating this behavior.
201+
- If you specify `ARMC6` in `supported_toolchains`, it means the target supports Arm Compiler 6 (version 6.11) only, and the build system uses Arm Compiler 6 when you specify `-t ARM` or `-t ARMC6` with `mbed compile` command.
205202

206-
* You can only specify one of `ARM`, `ARMC5` or `ARMC6` for `supported_toolchains` for a target in `targets/targets.json` or `custom_targets.json`.
203+
- If you specify `ARM` in `supported_toolchains`, it means the target supports compiling with both Arm Compiler 5 and Arm Compiler 6. Arm Compiler 6 is the default Arm Compiler for Mbed OS. If a target specifies `ARM` in `supported_toolchains`, the system defaults to using Arm Compiler 6 when you specify `-t ARM` with `mbed compile` command. If the build system fails to detect a valid configuration for Arm Compiler 6, it automatically (without any manual intervention) tries to detect if a valid confguration for Arm Compiler 5 exists and continues using Arm Compiler 5 if it successfully detects Arm Compiler 5. You may see a warning message in your standard output from the build system indicating this behavior.
207204

208-
* It's invalid to specify `-t ARMC5` with `mbed compile` command for a target that specifies `ARMC6` for `supported_toolchains` or vice-versa.
205+
- You can only specify one of `ARM`, `ARMC5` or `ARMC6` for `supported_toolchains` for a target in `targets/targets.json` or `custom_targets.json`.
209206

210-
<div style="background-color:#F3F3F3; text-align:left; vertical-align: middle; padding:15px 30px;">
211-
Note: Please note that Arm Compiler 6 is the default Arm Compiler for Mbed OS development. Most Mbed OS platforms are already compatible with Arm Compiler 6. Some existing targets still supporting Arm Compiler 5 will be migrated to Arm Compiler 6 in the future. Please be aware that you must use Arm Compiler 6 for future development as Arm Compiler 5 support will be deprecated in future.
212-
</div>
207+
- It's invalid to specify `-t ARMC5` with the `mbed compile` command for a target that specifies `ARMC6` for `supported_toolchains` or vice-versa.
208+
209+
<span class="notes">**Note:** Arm Compiler 6 is the default Arm Compiler for Mbed OS development. Most Mbed OS platforms are already compatible with Arm Compiler 6. Some existing targets still supporting Arm Compiler 5 will be migrated to Arm Compiler 6 in the future. Please be aware that you must use Arm Compiler 6 for future development because Arm Compiler 5 support will be deprecated in September 2019.</span>
213210

214211
#### default_toolchain
215212

0 commit comments

Comments
 (0)