Initially taken over the overview documentation from Core-M to Core-A.
/** \mainpage Overview
-Placeholder Core-A
+CMSIS-Core-A implements the basic run-time system for a Cortex-A device and gives the user access to the processor core and the device peripherals.
+In detail it defines:
+ - <b>Hardware Abstraction Layer (HAL)</b> for Cortex-A processor registers with standardized definitions for the GIC, FPU, MMU, Cache, and core access functions.
+ - <b>System exception names</b> to interface to system exceptions without having compatibility issues.
+ - <b>Methods to organize header files</b> that makes it easy to learn new Cortex-A microcontroller products and improve software portability. This includes naming conventions for device-specific interrupts.
+ - <b>Methods for system initialization</b> to be used by each MCU vendor. For example, the standardized SystemInit() function is essential for configuring the clock system of the device.
+ - <b>Intrinsic functions</b> used to generate CPU instructions that are not supported by standard C functions.
+ - A variable to determine the <b>system clock frequency</b> which simplifies the setup the SysTick timer.
+
+
+The following sections provide details about the CMSIS-Core-A:
+ - \ref using_pg describes the project setup and shows a simple program example.
+ - \ref templates_pg describes the files of the CMSIS-Core-A in detail and explains how to adapt template files provided by ARM to silicon vendor devices.
+ - \ref coreMISRA_Exceptions_pg describes the violations to the MISRA standard.
+ - <a href="Modules.html">\b Reference </a> describe the features and functions of the \ref device_h_pg in detail.
+ - <a href="Annotated.html">\b Data \b Structures </a> describe the data structures of the \ref device_h_pg in detail.
+
+<hr>
+
+CMSIS-Core-A in ARM::CMSIS Pack
+-----------------------------
+
+Files relevant to CMSIS-Core-A are present in the following <b>ARM::CMSIS</b> directories:
+|File/Folder |Content |
+|--------------------------------|------------------------------------------------------------------------|
+|\b CMSIS\\Documentation\\Core_A | This documentation |
+|\b CMSIS\\Core_A\\Include | CMSIS-Core-A header files (for example core_ca.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 |
+
+<hr>
+
+\section ref_v7A Processor Support
+
+CMSIS supports a selected subset of <a href="http://www.arm.com/products/processors/cortex-a/index.php" target="_blank"><b>Cortex-A processors</b></a>.
+
+\subsection ref_man_ca_sec Cortex-A Reference Manuals
+
+The Cortex-A Reference Manuals are generic user guides for devices that implement the various ARM Cortex-A processors.
+These manuals contain the programmers model and detailed information about the core peripherals.
+
+- <a nohref target="_blank"><b>Cortex-A7</b></a> (ARMv7-A architecture)
+- <a nohref target="_blank"><b>Cortex-A9</b></a> (ARMv7-A architecture)
+
+<hr>
+
+\section tested_tools_sec Tested and Verified Toolchains
+
+The \ref templates_pg supplied by ARM have been tested and verified with the following toolchains:
+ - ARM: ARM Compiler V5.6
+ - ARM: ARM Compiler V6.6
+ - GNU: GNU Tools ARM Embedded 5.4 2016q3
+ - IAR: IAR Embedded Workbench Kickstart Edition V6.10
+
+<hr>
*/
/**
-\page device_h_pg Devie Header File \<device.h>
+\page device_h_pg Device Header File \<device.h>
The \ref device_h_pg contains the following sections that are device specific:
- \ref irqn_defs provides interrupt numbers (IRQn) for all exceptions and interrupts of the device.
