beslan/mbed-os
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0ef1717155b166380a191125767d705957b7cfa2
mbed-os/docs/adr/0001_cmsis_component_source_structure_recommendations.md
Beslan 0ef1717155
Some checks failed
Basic Checks / license-check (push) Has been cancelled
Details
Basic Checks / include-check (push) Has been cancelled
Details
Basic Checks / style-check (push) Has been cancelled
Details
Basic Checks / docs-check (push) Has been cancelled
Details
Basic Checks / python-tests (push) Has been cancelled
Details
Basic Checks / pin-validation (push) Has been cancelled
Details
Basic Checks / cmake-checks (push) Has been cancelled
Details
Basic Checks / frozen-tools-check (push) Has been cancelled
Details
Publish or Update docker image for head of branch / prepare-tags (push) Has been cancelled
Details
Release or update docker image for a released mbed-os version / prepare-tags (push) Has been cancelled
Details
Publish or Update docker image for head of branch / build-container (push) Has been cancelled
Details
Publish or Update docker image for head of branch / test-container (linux/amd64) (push) Has been cancelled
Details
Publish or Update docker image for head of branch / test-container (linux/arm64) (push) Has been cancelled
Details
Publish or Update docker image for head of branch / deploy-container (push) Has been cancelled
Details
Release or update docker image for a released mbed-os version / build-container (push) Has been cancelled
Details
Release or update docker image for a released mbed-os version / test-container (linux/amd64) (push) Has been cancelled
Details
Release or update docker image for a released mbed-os version / test-container (linux/arm64) (push) Has been cancelled
Details
Release or update docker image for a released mbed-os version / deploy-container (push) Has been cancelled
Details
Prune temporary docker images / prune-images (push) Has been cancelled
Details
Mirror mbed-os-6.15.0
2026-07-10 18:42:39 +03:00

1.6 KiB
Raw Blame History

CMSIS component source structure recommendations

Date: 2020-08-19

Status

Proposed

Context

ARM-software/CMSIS_5 has been ported to Mbed OS. However, it is split across multiple directories and it is not immediately obvious that it comes from that repository when imported with the importer script.

Decision

The current proposal is to create new directories within the existing cmsis/ directory:

  • CMSIS_5/: mirrors closely the structure used by ARM-software/CMSIS_5/ keeping only the directories and files needed by Mbed OS and renames some directories in order to work with Mbed OS build tools. See importer configuration file.
  • device: includes Mbed OS specific files to configure RTX.

This will result in the removal of the rtos/source/TARGET_CORTEX/ directory. Additionally, cmsis/TARGET_CORTEX_A/TOOLCHAIN_IAR/cmain.S to platform/source/TARGET_CORTEX_A/TOOLCHAIN_IAR/cmain.S so it can be accessible when building with the bare metal profile. Note that we already have the equivalent file for TARGET_CORTEX_M at platform/source/TARGET_CORTEX_M/TOOLCHAIN_IAR/cmain.S.

It will provide the following advantages:

  • Better maintenance of the CMSIS component
  • Easy creation of an independent CMake target that can be built as a library that can be optionally be linked against by end users
  • Easy source navigation that mirrors closely the upstream CMSIS_5 repository

Documentation

A README.md within the cmsis will contain a brief introduction of the component and will detail the Mbed specific files added.

Reference in New Issue View Git Blame Copy Permalink