]> begriffs open source - cmsis/blob - README.md
Update README.md
[cmsis] / README.md
1 # CMSIS Version 5
2
3 CMSIS Version 5.0.0 is scheduled for release in June 2016. Once completed it will be released in this GitHub project.
4
5
6 Use *Issues* to provide feedback and report problems for CMSIS Version 5. Note that this repository gives our users and partners contiguous access to the CMSIS development. It allows you to review the work and provide feedback or create pull requests for contributions.
7
8
9 ## Planned Enhancements
10  - Add support for ARMv8-M Architecture (Mainline and Baseline)
11
12  - Improvements for Cortex-A / M hybrid devices (focus on Cortex-M interaction)
13
14  - CMSIS-RTOS API and RTX reference implementation with several enhancements:
15      - Dynamic object creation, Flag events, C and C++ API, additional thread and timer functions
16      - Secure and Non-Secure support, multi-processor support
17
18  - CMSIS-Pack 
19      - Additions for generic example, project templates, multiple download portals
20      - Adoption of IAR Flash Loader technology
21
22 For further details see also the [Slides of the Embedded World CMSIS Partner Meeting](https://github.com/ARM-software/CMSIS_5/blob/master/CMSIS_EW2016.pdf).
23
24 ## Directory Structure
25
26 *All CMSIS components will be available by end of March 2016*
27
28 | Directory       | Content                                        |                
29 | --------------- | ---------------------------------------------- |
30 | CMSIS/Core      | CMSIS-Core related files (for release)         |
31 | CMSIS/DAP       | CMSIS-DAP related files and examples           |
32 | CMSIS/Driver    | CMSIS-Driver API headers and template files    |
33 | CMSIS/DSP       | CMSIS-DSP related files                        |
34 | CMSIS/RTOS      | RTOS v1 related files (for Cortex-M)           |
35 | CMSIS/RTOS2     | RTOS v2 related files (for Cortex-M & ARMv8-M) |
36 | CMSIS/DoxyGen   | Source of the documentation                    |
37 | CMSIS/Utilities | Utility programs                               |
38
39 ## Generate CMSIS Pack for Release
40
41 This GitHub development repository contains already pre-build libraries of various libraries (DSP, RTOS, RTOS2).
42 These libraries are validated for release.
43
44 To build a complete CMSIS pack for installation the following additional tools are required:
45  - **doxygen.exe**    Version: 1.8.2 (Documentation Generator)
46  - **mscgen.exe**     Version: 0.20  (Message Sequence Chart Converter)
47  - **7z.exe (7-Zip)** Version: 16.02 (File Archiver)
48   
49 Using these tools, you can generate on a Windows PC:
50  - **CMSIS Software Pack** using the batch file **gen_pack.bat** (located in ./CMSIS/Utilities). This batch file also generates the documentation.
51   
52  - **CMSIS Documentation** using the batch file **genDoc.bat** (located in ./CMSIS/Doxygen). 
53
54 The file ./CMSIS/DoxyGen/How2Doc.txt describes the rules for creating API documentation.
55
56 ## License
57
58 ARM CMSIS is licensed under Apache-2.0.
59
60 ## Contributions and Pull Requests
61
62 Contributions are accepted under Apache-2.0. Only submit contributions where you have authored all of the code.