Přeskočit na hlavní obsah

RAL CMSIS

Zrcadlo oficiálního repozitáře CMSIS (Cortex Microcontroller Software Interface Standard) od ARM. Používá se jako git submodul repozitáře Bsp-Ral a dodává hlavičkové soubory jádra Cortex-M a DSP, vůči nimž se sestavují Register Abstraction Layer (RAL_ST) a surové ovladače HAL/LL od ST.

Přehled​

Upstream projektARM-software/CMSIS_5
Role v Bsp-RalZávislost pouze na hlavičkových souborech — poskytuje include cesty pro jádro Cortex-M (CMSIS/Core) a DSP (CMSIS/DSP)
LicenceApache License 2.0 — viz LICENSE.txt, beze změn oproti upstreamu
Model údržbyZrcadleno z upstreamu; lokálně se neupravuje

⚠️ Tento repozitář doslovně sleduje oficiální zdrojové kódy CMSIS od ARM. Jeho obsah přímo neupravujte — změny patří do upstreamu nebo místo toho do vrstvy rozhraní RAL_ST/Port.

Struktura větví​

VětevÚčel
CMSISZákladní větev, udržovaná v synchronizaci s upstream repozitářem ARM CMSIS
CMSIS_<major>.<minor>.xRelease větev odrážející jedno konkrétní oficiální vydání ARM CMSIS (např. CMSIS_5.9.x)

Struktura repozitáře​

CMSIS
├── CMSIS
│   ├── Core            # Cortex-M core peripheral access layer
│   ├── Core_A          # Cortex-A core peripheral access layer
│   ├── CoreValidation  # Core header validation suite
│   ├── DAP             # CoreSight Debug Access Port firmware
│   ├── DoxyGen         # Documentation sources
│   ├── Driver          # Generic peripheral driver interfaces for middleware
│   ├── DSP             # DSP function library (fixed-point and floating-point)
│   ├── Lib             # Prebuilt libraries
│   ├── NN              # Neural network kernels
│   ├── Pack            # CMSIS-Pack delivery format
│   ├── RTOS            # CMSIS-RTOS v1 API + RTX reference implementation
│   ├── RTOS2           # CMSIS-RTOS v2 API
│   └── Utilities       # Pack generation utilities
├── Device
│   └── ARM              # ARM reference device templates
└── LICENSE.txt

Použití​

Při použití jako submodul Bsp-Ral se tento repozitář nesestavuje jako samostatný projekt CMake — dodává pouze hlavičkové soubory. CMakeLists.txt repozitáře Bsp-Ral přidává následující cesty do obou svých knihovních targetů (HAL_LL_Lib a Ral_Lib):

target_include_directories(Ral_Lib
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/CMSIS/CMSIS/Core/Include  # Cortex core functionality
        ${CMAKE_CURRENT_SOURCE_DIR}/CMSIS/CMSIS/DSP/Include   # DSP functionality
        ...
)

V navazujících projektech nejsou nutné žádné změny — použití Ral_Lib nebo HAL_LL_Lib z nadřazeného repozitáře Bsp-Ral již tranzitivně zpřístupňuje hlavičkové soubory jádra Cortex-M.

Licence​

Distribuováno pod licencí Apache License 2.0, shodnou s upstream licencí ARM CMSIS. Viz LICENSE.txt.