begriffs open source - cmsis/blob - CMSIS/Documentation/Doxygen/Core/src/mainpage.md

   1 # Overview {#mainpage}
   2
   3 The **CMSIS-Core (Cortex-M)** component implements the basic run-time system for Arm Cortex-M devices and gives the user access to the processor core and the device peripherals.
   4
   5 In detail it defines:
   6
   7  - **Hardware Abstraction Layer (HAL)** for Cortex-M processor registers with standardized  definitions for the SysTick, NVIC, System Control Block registers, MPU registers, FPU registers, and core access functions.
   8  - **System exception names** to interface to system exceptions without having compatibility issues.
   9  - **Methods to organize header files** that makes it easy to learn new Cortex-M microcontroller products and improve software portability. This includes naming conventions for device-specific interrupts.
  10  - **Methods for system initialization** to be used by each MCU vendor. For example, the standardized `SystemInit()` function is essential for configuring the clock system of the device.
  11  - **Intrinsic functions** used to generate CPU instructions that are not supported by standard C functions.
  12  - A variable to determine the **system clock frequency** which simplifies the setup the SysTick timer.
  13
  14
  15 The following sections provide details about the CMSIS-Core (Cortex-M):
  16
  17  - \ref using_pg explains the project setup and shows a simple program example.
  18 \if ARMv8M
  19  - \ref using_TrustZone_pg "Using TrustZone&reg; for Armv8-M" describes how to use the security extensions available in the Armv8-M architecture.
  20 \endif
  21  - \ref cmsis_core_files describes the files of the CMSIS-Core (Cortex-M) in detail and explains how to adapt template files provided by Arm to silicon vendor devices.
  22  - \ref coreMISRA_Exceptions_pg describes the violations to the MISRA standard.
  23  - [**API Reference**](modules.html) describes the features and functions of the \ref device_h_pg in detail.
  24  - [**Data Structures**](annotated.html) describe the data structures of the \ref device_h_pg in detail.
  25
  26 ## Access to CMSIS-Core (Cortex-M)
  27
  28 CMSIS-Core is actively maintained in the [**CMSIS 6 GitHub repository**](https://github.com/ARM-software/CMSIS_6) and released as part of the [**CMSIS Software Pack**](../General/cmsis_pack.html).
  29
  30 The following directories and files relevant to CMSIS-Core (Cortex-M) are present in the **ARM::CMSIS** Pack:
  31
  32 Directory                         | Content
  33 :---------------------------------|:------------------------------------------------------------------------
  34 📂 CMSIS                          | CMSIS Base software components folder
  35  ┣ 📂 Documentation/html/Core     | A local copy of this CMSIS-Core (M) documentation
  36  ┗ 📂 Core                        | CMSIS-Core files
  37  &emsp;&nbsp; ┣ 📂 Include        | \ref cmsis_processor_files.
  38  &emsp;&emsp;&nbsp; ┗ 📂 m-profile| Header files specific for Arm M-Profile.<br/> See \ref cmsis_compiler_files and \ref cmsis_feature_files.
  39  &emsp;&nbsp; ┗ 📂 Template       | \ref cmsis_template_files
  40
  41 ## Processor Support {#ref_v6-v8M}
  42
  43 CMSIS-Core supports the complete range of [Cortex-M processors](https://www.arm.com/products/silicon-ip-cpu?families=cortex-m&showall=true).
  44
  45 \anchor ref_man_sec
  46 **Cortex-M Generic User Guides**
  47
  48 Following Cortex-M Device Generic User Guides contain the programmers model and detailed information about the core peripherals:
  49
  50  - [Cortex-M0 Devices Generic User Guide (Armv6-M architecture)](https://developer.arm.com/documentation/dui0497/latest/)
  51  - [Cortex-M0+ Devices Generic User Guide (Armv6-M architecture)](https://developer.arm.com/documentation/dui0662/latest/)
  52  - [Cortex-M3 Devices Generic User Guide (Armv7-M architecture)](https://developer.arm.com/documentation/dui0552/latest/)
  53  - [Cortex-M4 Devices Generic User Guide (Armv7-M architecture)](https://developer.arm.com/documentation/dui0553/latest/)
  54  - [Cortex-M7 Devices Generic User Guide (Armv7-M architecture)](https://developer.arm.com/documentation/dui0646/latest/)
  55  - [Cortex-M23 Devices Generic User Guide (Armv8-M architecture)](https://developer.arm.com/documentation/dui1095/latest/)
  56  - [Cortex-M33 Devices Generic User Guide (Armv8-M architecture)](https://developer.arm.com/documentation/100235/latest/)
  57  - [Cortex-M52 Devices Generic User Guide (Armv8.1-M architecture)](https://developer.arm.com/documentation/102776/latest/)
  58  - [Cortex-M55 Devices Generic User Guide (Armv8.1-M architecture)](https://developer.arm.com/documentation/101273/latest/)
  59  - [Cortex-M85 Devices Generic User Guide (Armv8.1-M architecture)](https://developer.arm.com/documentation/101928/latest/)
  60
  61 CMSIS-Core also supports the following Cortex-M processor variants:
  62
  63  - [Cortex-M1](https://developer.arm.com/Processors/Cortex-M1) is a processor designed specifically for implementation in FPGAs (Armv6-M architecture).
  64  - [SecurCore SC000](https://developer.arm.com/Processors/SecurCore%20SC000) is designed specifically for smartcard and security applications (Armv6-M architecture).
  65  - [SecurCore SC300](https://developer.arm.com/Processors/SecurCore%20SC300) is designed specifically for smartcard and security applications (Armv7-M architecture).
  66  - [Cortex-M35P](https://developer.arm.com/Processors/Cortex-M35P) is a tamper resistant Cortex-M processor with optional software isolation using TrustZone for Armv8-M.
  67  - [STAR-MC1](https://www.armchina.com/mountain?infoId=160) is a variant of Armv8-M with TrustZone designed by Arm China.
  68
  69 \anchor ARMv8M
  70 **Armv8-M and Armv8.1-M Architecture**
  71
  72 Armv8-M introduces two profiles **baseline** (for power and area constrained applications) and **mainline** (full-featured with optional SIMD, floating-point, and co-processor extensions). Both Armv8-M profiles and Armv8.1-M are supported by CMSIS.
  73
  74 The Armv8-M architecture is described in the [Armv8-M Architecture Reference Manual](https://developer.arm.com/documentation/ddi0553/latest/).
  75
  76 The Armv8.1-M architecture further extends Armv8-M with Helium (the so called M-Profile Vector Extension (MVE)), as well as further instruction set and debug extensions.
  77
  78 More information about Armv8.1-M architecture is available under [Arm Helium technology](https://developer.arm.com/Architectures/Helium).
  79
  80 ##  Tested and Verified Toolchains {#tested_tools_sec}
  81
  82 The \ref cmsis_core_files delivered with this CMSIS-Core release have been tested and verified with the following toolchains:
  83
  84  - Arm Compiler for Embedded 6.22
  85  - IAR C/C++ Compiler for Arm 9.40
  86  - GNU Arm Embedded Toolchain 13.2.1
  87  - LLVM/Clang 18.3.1