Skip to content

Commit c8f2ed2

Browse files
authored
Update NOTES.md with CMSIS solutions
Added solutions for handling CMSIS version issues and symbolic linking.
1 parent 9f10794 commit c8f2ed2

1 file changed

Lines changed: 17 additions & 2 deletions

File tree

NOTES.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,23 @@ CMSIS, or Cortex Microcontroller Software Interface Standard, consists of a vend
1111
Some of the example projects use legacy versions of CMSIS. When building a project requiring them, you might face a fatal error such as:
1212

1313
>Fatal Error[Pe1696]: cannot open source file “core_cm3.h”
14+
## Solution 1
15+
For the latest CMSIS, update the project settings to match your environment.
1416

15-
The recommended solution is to use `git` for fetching the required CMSIS headers:
17+
Clone `CMSIS_6`:
18+
```
19+
git clone https://github.com/ARM-software/CMSIS_6.git
20+
```
21+
Go to **Project Options > C/C++ Compiler > Preprocessor > Additional Include Directories** then add:
22+
```
23+
<path/to/CMSIS_6>/CMSIS/Core/Include
24+
```
25+
Note that some registers changed from `CMSIS_5` to `CMSIS_6`, so that migrating code might be required in some cases. In such cases, consider [Solution 2](#solution-2).
26+
27+
## Solution 2
28+
For a seamless experience, create a symbolic link for supplying the `CMSIS/` folder so that no project modification is required.
29+
30+
Use `git` for fetching the required CMSIS headers:
1631
* Linux (as root):
1732
```
1833
cd /opt/iar/
@@ -27,7 +42,7 @@ git clone https://github.com/arm-software/cmsis_5
2742
cd ewarm-10.xx.x/arm
2843
mklink /D ..\..\cmsis_5\CMSIS
2944
```
30-
Replace `ewarm-10.xx.x` by its actual version.
45+
Replace `ewarm-10.xx.x` by its actual version. The same `cmsis_5` folder can
3146

3247
### File names on Linux
3348
Many legacy projects were developed primarily on Windows, where file systems are case-insensitive. As a result, **you may encounter case-sensitivity issues when building these projects on Linux**.

0 commit comments

Comments
 (0)