Official ARM version: v5.4.0

    Add CMSIS V5.4.0, please refer to index.html available under \docs folder.

    Note: content of \CMSIS\Core\Include has been copied under \Include to keep the same structure
         used in existing projects, and thus avoid projects mass update
    Note: the following components have been removed from ARM original delivery (as not used in ST packages)
        - CMSIS_EW2018.pdf
        - .gitattributes
        - .gitignore
        - \Device
        - \CMSIS
           - \CoreValidation
		   - \DAP
           - \Documentation
           - \DoxyGen
           - \Driver
           - \Pack
           - \RTOS\CMSIS_RTOS_Tutorial.pdf
           - \RTOS\RTX
           - \RTOS\Template
           - \RTOS2\RTX
           - \Utilities
           - All ARM/GCC projects files are deleted from \DSP, \RTOS and \RTOS2

Change-Id: Ia026c3f0f0d016627a4fb5a9032852c33d24b4d3

1 files changed, 103 insertions, 2 deletions

diff --git a/README.md b/README.md
index d1e9549..c90c9a6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,104 @@
-# CMSIS Version 4 (legacy repository)
+# CMSIS Version 5
+
+The branch *master* of this GitHub repository contains the CMSIS Version 5.4.0.  The [documentation](http://arm-software.github.io/CMSIS_5/General/html/index.html) is available under http://arm-software.github.io/CMSIS_5/General/html/index.html
+
+Use [Issues](https://github.com/ARM-software/CMSIS_5#issues-and-labels) to provide feedback and report problems for CMSIS Version 5. 
+
+**Note:** The branch *develop* of this GitHub repository reflects our current state of development and is constantly updated. It 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.
+
+A [pre-built documentation](http://www.keil.com/pack/doc/CMSIS_Dev/index.html) is updated from time to time, but may be also generated using the instructions under [Generate CMSIS Pack for Release](https://github.com/ARM-software/CMSIS_5#generate-cmsis-pack-for-release).
+
+## Implemented Enhancements
+ - CMSIS-Core-A, RTX5: implementation for Cortex-A5/A7/A9
+ - Support for Armv8-M Architecture (Mainline and Baseline) as well as devices Cortex-M23 and Cortex-M33
+ - CMSIS-RTOS2: RTX 5 is now available for IAR, GCC, Arm Compiler 5, Arm Compiler 6
+ - CMSIS-RTOS2: FreeRTOS adoption (release) is available https://github.com/ARM-software/CMSIS-FreeRTOS
+ - CMSIS-NN: Bare metal Neural Network function library.
+ - CMSIS-DAP v2: with WinUSB for faster communication and separate pipe for SWO support
+ - Config Wizard extension: access enum’s for configuration information 
+
+## Further Planned Enhancements
+ - CMSIS-Zone: management of complex system
+ - CMSIS-Pack:
+   - System Description SDF Format: describe more complex debug topologies than with a Debug Description in a tool agnostic way
+   - Github based workflow: allows to develop software packs using github infra-structure
+   - Flash algorithm via debugger: Some TurstZone enable devices cannot execute RAM. Commands that allow flash programming will be added to Debug Description.
+   - CPDSC project file format: allows project templates that are agnostic of an IDE
+   - Minimize need for IDE specific settings: CMSIS-Pack supports IDE specific parameters. Analyze and minimize 
+
+For further details see also the [Slides of the Embedded World CMSIS Partner Meeting](https://github.com/ARM-software/CMSIS_5/blob/develop/CMSIS_EW2018.pdf).
+
+## Directory Structure
+
+| Directory       | Content                                        |                
+| --------------- | ---------------------------------------------- |
+| CMSIS/Core      | CMSIS-Core related files (for release)         |
+| CMSIS/DAP       | CMSIS-DAP related files and examples           |
+| CMSIS/Driver    | CMSIS-Driver API headers and template files    |
+| CMSIS/DSP       | CMSIS-DSP related files                        |
+| CMSIS/NN        | CMSIS-NN related files                         |
+| CMSIS/RTOS      | RTOS v1 related files (for Cortex-M)           |
+| CMSIS/RTOS2     | RTOS v2 related files (for Cortex-M & Armv8-M) |
+| CMSIS/Pack      | CMSIS-Pack examples and tutorials              |
+| CMSIS/DoxyGen   | Source of the documentation                    |
+| CMSIS/Utilities | Utility programs                               |
+
+## Generate CMSIS Pack for Release
+
+This GitHub development repository contains already pre-built libraries of various software components (DSP, RTOS, RTOS2).
+These libraries are validated for release.
+
+To build a complete CMSIS pack for installation the following additional tools are required:
+ - **doxygen.exe**    Version: 1.8.6 (Documentation Generator)
+ - **mscgen.exe**     Version: 0.20  (Message Sequence Chart Converter)
+ - **7z.exe (7-Zip)** Version: 16.02 (File Archiver)
+  
+Using these tools, you can generate on a Windows PC:
+ - **CMSIS Software Pack** using the batch file **gen_pack.bat** (located in ./CMSIS/Utilities). This batch file also generates the documentation.
+  
+ - **CMSIS Documentation** using the batch file **genDoc.bat** (located in ./CMSIS/Doxygen). 
+
+The file ./CMSIS/DoxyGen/How2Doc.txt describes the rules for creating API documentation.
+
+## License
+
+Arm CMSIS is licensed under Apache-2.0.
+
+## Contributions and Pull Requests
+
+Contributions are accepted under Apache-2.0. Only submit contributions where you have authored all of the code.
+
+### Issues and Labels
+
+Please feel free to raise an [issue on GitHub](https://github.com/ARM-software/CMSIS_5/issues)
+to report misbehavior (i.e. bugs) or start discussions about enhancements. This
+is your best way to interact directly with the maintenance team and the community.
+We encourage you to append implementation suggestions as this helps to decrease the
+workload of the very limited maintenance team. 
+
+We will be monitoring and responding to issues as best we can.
+Please attempt to avoid filing duplicates of open or closed items when possible.
+In the spirit of openness we will be tagging issues with the following:
+
+- **bug** – We consider this issue to be a bug that will be investigated.
+
+- **wontfix** - We appreciate this issue but decided not to change the current behavior.
+	
+- **enhancement** – Denotes something that will be implemented soon. 
+
+- **future** - Denotes something not yet schedule for implementation.
+
+- **out-of-scope** - We consider this issue loosely related to CMSIS. It might by implemented outside of CMSIS. Let us know about your work.
+	
+- **question** – We have further questions to this issue. Please review and provide feedback.
+
+- **documentation** - This issue is a documentation flaw that will be improved in future.
+
+- **review** - This issue is under review. Please be patient.
+	
+- **DONE** - We consider this issue as resolved - please review and close it. In case of no further activity this issues will be closed after a week.
+
+- **duplicate** - This issue is already addressed elsewhere, see comment with provided references.
+
+- **Important Information** - We provide essential informations regarding planned or resolved major enhancements.
 
-This is not the current version of CMSIS and is just provided to allow access to the legacy CMSIS Version 4.