ARM::CMS
|File/Folder |Content |
|--------------------------------|------------------------------------------------------------------------|
|\b CMSIS\\Documentation\\Core_A | This documentation |
-|\b CMSIS\\Core_A\\Include | CMSIS-Core (Cortex-A) header files (for example core_ca.h, etc.) |
+|\b CMSIS\\Core\\Include | CMSIS-Core (Cortex-A) header files (for example core_ca5.h, etc.) |
|\b Device | \ref using_ARM_pg "Arm reference implementations" of Cortex-A devices |
|\b Device\\\_Template_Vendor | \ref templates_pg for extension by silicon vendors |
diff --git a/CMSIS/DoxyGen/Core_A/src/Template.txt b/CMSIS/DoxyGen/Core_A/src/Template.txt
index 7c784cfe9..c4669ccc6 100644
--- a/CMSIS/DoxyGen/Core_A/src/Template.txt
+++ b/CMSIS/DoxyGen/Core_A/src/Template.txt
@@ -6,6 +6,7 @@
Arm supplies CMSIS-Core device template files for the all supported Cortex-A processors and various compiler vendors.
Refer to the list of \ref tested_tools_sec for compliance.
+
These CMSIS-Core device template files include the following:
- Register names of the Core Peripherals and names of the Core Exception Vectors.
- Functions to access core peripherals, cache, MMU and special CPU instructions
@@ -15,26 +16,32 @@ The detailed file structure of the CMSIS-Core device templates is shown in the f
-\section CMSIS_Processor_files CMSIS-Core Processor Files
+\section CMSIS_Processor_files CMSIS-Core Processor Files
-The CMSIS-Core processor files provided by Arm are in the directory .\\CMSIS\\Core_A\\Include. These header files define all processor specific attributes do not need any modifications.
+The CMSIS-Core processor files provided by Arm are in the directory .\\CMSIS\\Core\\Include. These header files define all processor specific attributes do not need any modifications.
The core_<cpu>.h defines the core peripherals and provides helper functions that access the core registers. One file is available for each supported Cortex-A processor:
Header File | Processor
:----------------|:------------------------------
-core_ca.h | generics for all supported Cortex-A processors
-
+core_ca5.h | for the Cortex-A5 processor
+core_ca7.h | for the Cortex-A7 processor
+core_ca9.h | for the Cortex-A9 processor
+core_ca35.h | for the Cortex-A35 processor
+core_ca53.h | for the Cortex-A53 processor
+core_ca57.h | for the Cortex-A57 processor
\section device_examples Device Examples
The CMSIS Software Pack defines several devices that are based on the various processors. The device related CMSIS-Core files are in the directory .\\Device\\ARM
and include CMSIS-Core processor file explained before. The following sample devices are defined in the CMSIS-Pack description file ARM.CMSIS.pdsc:
-Family | Device | Description
-:------------------|:------------------|:---------------------------------
-ARM Cortex-A5 | ARMCA5 | Cortex-A5 based device
-ARM Cortex-A7 | ARMCA7 | Cortex-A7 based device
-ARM Cortex-A9 | ARMCA9 | Cortex-A9 based device
-
+Family | Device | Description
+:-----------------|:------------------|:---------------------------------
+ARM Cortex-A5 | ARMCA5 | Cortex-A5 based device
+ARM Cortex-A7 | ARMCA7 | Cortex-A7 based device
+ARM Cortex-A9 | ARMCA9 | Cortex-A9 based device
+ARM Cortex-A35 | ARMCA35 | Cortex-A35 based device
+ARM Cortex-A53 | ARMCA53 | Cortex-A53 based device
+ARM Cortex-A57 | ARMCA57 | Cortex-A57 based device
\section template_files_sec Template Files
@@ -53,7 +60,7 @@ Silicon vendors add to these template files the following information:
.\\Device\\\_Template_Vendor\\Vendor\\Device_A\\Source\\ARM\\startup_Device.c |
Startup file template for Arm C/C++ Compiler. |
-
+
.\\Device\\\_Template_Vendor\\Vendor\\Device_A\\Source\\ARM\\Device.sct |
Linker scatter file template for Arm C/C++ Compiler. |
@@ -129,9 +136,10 @@ The device configuration of the template files is described in detail on the fol
\page startup_c_pg Startup File startup_.c
The \ref startup_c_pg contains:
- - Exception vectors of the Cortex-A Processor with weak functions that implement default routines.
- The reset handler which is executed after CPU reset and typically calls the \ref SystemInit function.
- The setup values for the various stack pointers, i.e. per exceptional mode and main stack.
+ - Exception vectors of the Cortex-A Processor with weak functions that implement default routines.
+ - Interrupt vectors that are device specific with weak functions that implement default routines.
The file exists for each supported toolchain and is the only tool-chain specific CMSIS file.
@@ -238,7 +246,7 @@ If these \#defines are missing default values are used.
Description |
- __CM0_REV |
+ __CA5_REV |
0x0000 |
0x0000 |
Core revision number ([15:8] revision number, [7:0] patch number) |
@@ -286,9 +294,9 @@ The following code exemplifies the configuration of the Cortex-A9 Processor and
#define __GIC_PRESENT 1U /*!< GIC present */
#define __TIM_PRESENT 0U /*!< TIM not present */
#define __L2C_PRESENT 0U /*!< L2C not present */
-:
-:
-#include "core_ca.h" /* Cortex-A processor and core peripherals */
+.
+.
+#include "core_ca9.h" /* Cortex-A processor and core peripherals */
\endcode
diff --git a/CMSIS/DoxyGen/Core_A/src/core_ca.txt b/CMSIS/DoxyGen/Core_A/src/arm7a.txt
similarity index 99%
rename from CMSIS/DoxyGen/Core_A/src/core_ca.txt
rename to CMSIS/DoxyGen/Core_A/src/arm7a.txt
index c4cbf51d4..95369cb8f 100644
--- a/CMSIS/DoxyGen/Core_A/src/core_ca.txt
+++ b/CMSIS/DoxyGen/Core_A/src/arm7a.txt
@@ -1,5 +1,5 @@
/**************************************************************************//**
- * @file core_ca.txt
+ * @file arm7a.txt
* @brief CMSIS Cortex-A Core Peripheral Access Layer Header File
******************************************************************************/
@@ -79,7 +79,7 @@ The registers in the various UARTs can now be referred in the user code as shown
\section core_cmsis_pal_min_reqs Minimal Requirements
\details
- To access the peripheral registers and related function in a device, the files device.h and core_ca.h define as a minimum:
+ To access the peripheral registers and related function in a device, the files device.h and armv7a.h define as a minimum:
\n\n
- The Register Layout Typedef for each peripheral that defines all register names.
RESERVED is used to introduce space into the structure for adjusting the addresses of
diff --git a/README.md b/README.md
index 24f4cec11..973b114c8 100644
--- a/README.md
+++ b/README.md
@@ -31,8 +31,7 @@ For a list of all CMSIS components refer to [**Introduction - CMSIS Components**
Directory | Content
:------------------- |:---------------------------------------------------------
-CMSIS/Core | CMSIS-Core(M) related files (for release)
-CMSIS/Core_A | CMSIS-Core(A) related files (for release)
+CMSIS/Core | CMSIS-Core(A/R/M) related files (for release)
CMSIS/CoreValidation | Validation for Core(M) and Core(A) (NOT part of release)
CMSIS/Driver | CMSIS-Driver API headers and template files
CMSIS/RTOS2 | RTOS v2 related files (for Cortex-M & Armv8-M)