From 9f95ff5b6ba01db09552b84a0ab79607060a2666 Mon Sep 17 00:00:00 2001 From: Ali Labbene Date: Wed, 11 Dec 2019 08:59:21 +0100 Subject: 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 --- docs/Core_A/html/templates_pg.html | 212 +++++++++++++++++++++++++++++++++++++ 1 file changed, 212 insertions(+) create mode 100644 docs/Core_A/html/templates_pg.html (limited to 'docs/Core_A/html/templates_pg.html') diff --git a/docs/Core_A/html/templates_pg.html b/docs/Core_A/html/templates_pg.html new file mode 100644 index 0000000..2978def --- /dev/null +++ b/docs/Core_A/html/templates_pg.html @@ -0,0 +1,212 @@ + + + + + +CMSIS-Core Device Templates +CMSIS-Core (Cortex-A): CMSIS-Core Device Templates + + + + + + + + + + + + + + +
+
+ + + + + + + +
+
CMSIS-Core (Cortex-A) +  Version 1.1.2 +
+
CMSIS-Core support for Cortex-A processor-based devices
+
+
+ +
+
    + +
+
+ + + +
+
+ +
+
+
+ +
+ + + + +
+ +
+ +
+
+
CMSIS-Core Device Templates
+
+
+

Arm supplies CMSIS-Core device template files for the all supported Cortex-A processors and various compiler vendors. Refer to the list of Tested and Verified Toolchains 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
    • +
  • Generic startup code and system configuration code.
    • +
+

The detailed file structure of the CMSIS-Core device templates is shown in the following picture.

+

+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 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 supportet Cortex-A processors
+

+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
+

+Template Files

+

To simplify the creation of CMSIS-Core device files, the following template files are provided that should be extended by the silicon vendor to reflect the actual device and device peripherals. Silicon vendors add to these template files the following information:

+
    +
  • Device Peripheral Access Layer that provides definitions for device-specific peripherals.
    • +
  • Access Functions for Peripherals (optional) that provides additional helper functions to access device-specific peripherals.
    • +
  • Interrupt vectors in the startup file that are device specific.
    • +
+ + + + + + + + + + + + + + + + + +
Template File Description
.\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.
.\Device\_Template_Vendor\Vendor\Device_A\Source\system_Device.c Generic system_Device.c file for system configuration (i.e. processor clock and memory bus system).
.\Device\_Template_Vendor\Vendor\Device_A\Source\mmu_Device.c Sample mmu_Device.c file with memory map description for Memory Management Unit (MMU) configuration.
.\Device\_Template_Vendor\Vendor\Device_A\Include\Device.h Generic device header file. Needs to be extended with the device-specific peripheral registers. Optionally functions that access the peripherals can be part of that file.
.\Device\_Template_Vendor\Vendor\Device_A\Include\system_Device.h Generic system device configuration include file.
.\Device\_Template_Vendor\Vendor\Device_A\Include\mem_Device.h Generic memory base address and size definitions used in scatter file. Settable via Configuration Wizard.
+

Adapt Template Files to a Device

+

The following steps describe how to adopt the template files to a specific device or device family. Copy the complete all files in the template directory and replace:

+
    +
  • directory name 'Vendor' with the abbreviation for the device vendor e.g.: NXP.
    • +
  • directory name 'Device' with the specific device name e.g.: LPC17xx.
    • +
  • in the file names 'Device' with the specific device name e.g.: LPC17xx.
    • +
+

Each template file contains comments that start with ToDo: that describe a required modification. The template files contain place holders:

+ + + + + + + + + + + +
Placeholder Replaced with
<Device> the specific device name or device family name; i.e. LPC17xx.
<DeviceInterrupt> a specific interrupt name of the device; i.e. TIM1 for Timer 1.
<DeviceAbbreviation> short name or abbreviation of the device family; i.e. LPC.
Cortex-M# the specific Cortex-M processor name; i.e. Cortex-M3.
+

The device configuration of the template files is described in detail on the following pages:

+ +
+
+ + + + -- cgit