npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@xpack-3rd-party/arm-cmsis-core

v5.4.0-6

Published

A source library xPack with Arm CMSIS Core

Downloads

14

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

ilgilg

Keywords

xpack

Readme

A source library xPack with Arm CMSIS Core

This project provides the CMSIS Core headers as an xPack dependency.

The project is hosted on GitHub as xpack-3rd-party/arm-cmsis-core-xpack.

Maintainer info

This page is addressed to developers who plan to include this source library into their own projects.

For maintainer info, please see the README-MAINTAINER-XPACK file.

Install

As a source library xPacks, the easiest way to add it to a project is via xpm, but it can also be used as any Git project, for example as a submodule.

Prerequisites

A recent xpm, which is a portable Node.js command line application.

For details please follow the instructions in the xPack install page.

xpm

This package is available from npmjs.com as @xpack-3rd-party/arm-cmsis-core from the npmjs.com registry:

cd my-project
xpm init # Unless a package.json is already present

xpm install @xpack-3rd-party/arm-cmsis-core@latest

ls -l xpacks/xpack-3rd-party-arm-cmsis-core

Git submodule

If, for any reason, xpm is not available, the next recommended solution is to link it as a Git submodule below an xpacks folder.

cd my-project
git init # Unless already a Git project
mkdir -p xpacks

git submodule add https://github.com/xpack-3rd-party/arm-cmsis-core-xpack.git \
  xpacks/micro-os-plus-micro-test-plus

Branches

There are three active branches:

  • master, follows the original Arm master
  • xpack, with the latest stable version (default)
  • xpack-develop, with the current development version

All development is done in the xpack-develop branch, and contributions via Pull Requests should be directed to this branch. (Only contributions related to the xPack integration are accepted, functional contributions should be addressed to the upstream project.)

When new releases are published, the xpack-develop branch is merged into xpack.

Developer info

This package provides the full CMSIS_5 code, but when installed via xpm the content is filtered and only the CMSIS Core files are used.

In addition to the source files, the configuration files required to integrate it into CMake and meson projects, via a CMake INTERFACE library, or a meson dependency.

Build & integration info

The headers are written in C, but can also be used in C++ projects.

Include folders

For Cortex-M, the following folders should be used during the build:

  • CMSIS/Core/Include

The header files can then be included in user projects with statements like:

#include <core_cm4.h>

Similarly for Cortex-A:

  • CMSIS/Core_A/Include
#include <core_ca.h>

Source folders

  • none

Preprocessor definitions

When including the core_cm*.h, the following definitions are expected:

  • __CM0_REV, __CM0PLUS_REV, __CM3_REV, __CM4_REV, __CM7_REV
  • __MPU_PRESENT
  • __NVIC_PRIO_BITS
  • __FPU_PRESENT
  • __Vendor_SysTickConfig

When including the core_ca.h, the following definitions are expected:

  • __CORTEX_A
  • __CA_REV
  • __FPU_PRESENT
  • __GIC_PRESENT
  • __TIM_PRESENT
  • __L2C_PRESENT

Note: the Cortex-A support seems to cover only a small number of 32-bit devices and the quality is debatable.

Example

The CMSIS Core headers are not intended for end-user consumption, but by vendor, to include them in their specific device headers.

Known problems

  • the headers, especially the Core_A, may trigger warnings.

CMake

To integrate the CMSIS Core headers into a CMake application, add this folder to the build:

add_subdirectory("xpacks/xpack-3rd-party-arm-cmsis-core")`

The result is an INTERFACE library that can be added as a dependency with:

target_link_libraries(your-target PRIVATE
  ...
  xpack-3rd-party::arm-cmsis-core
)

meson

To integrate the CMSIS Core headers into a meson application, add this folder to the build:

subdir('xpacks/xpack-3rd-party-arm-cmsis-core')

The result is an object that can be added as a dependency with:

exe = executable(
  your-target,

  dependencies: [
    xpack_3rd_party_arm_cmsis_core_dependency,
  ],
)

Tests

TBD

Documentation

Tho original documentation is available on-line:

License

The original content is released under the MIT License, with all rights reserved to Liviu Ionescu.

The Arm content is provided under the terms of the Apache 2.0 License.

The original Arm README content follows.

CMSIS Version 5

The branch master of this GitHub repository contains the CMSIS Version 5.8.0. The documentation is available under http://arm-software.github.io/CMSIS_5/General/html/index.html

Use Issues to provide feedback and report problems for CMSIS Version 5.

Note: The branch develop of this GitHub repository reflects our current state of development and is constantly updated. It gives our users and partners contiguous access to the CMSIS development. It allows you to review the work and provide feedback or create pull requests for contributions.

A pre-built documentation is updated from time to time, but may be also generated using the instructions under Generate CMSIS Pack for Release.

Overview of CMSIS Components

The following is an list of all CMSIS components that are available.

| CMSIS-... | Target Processors | Description | |:----------|:--------------------|:-------------| |Core(M) | All Cortex-M, SecurCore | Standardized API for the Cortex-M processor core and peripherals. Includes intrinsic functions for Cortex-M4/M7/M33/M35P SIMD instructions.| |Core(A)| Cortex-A5/A7/A9 | API and basic run-time system for the Cortex-A5/A7/A9 processor core and peripherals.| |Driver | All Cortex-M, SecurCore | Generic peripheral driver interfaces for middleware. Connects microcontroller peripherals with middleware that implements for example communication stacks, file systems, or graphic user interfaces.| |DSP | All Cortex-M | DSP library collection with over 60 Functions for various data types: fixed-point (fractional q7, q15, q31) and single precision floating-point (32-bit). Implementations optimized for the SIMD instruction set are available for Cortex-M4/M7/M33/M35P.| |NN | All Cortex-M | Collection of efficient neural network kernels developed to maximize the performance and minimize the memory footprint on Cortex-M processor cores.| |RTOS v1 | Cortex-M0/M0+/M3/M4/M7 | Common API for real-time operating systems along with a reference implementation based on RTX. It enables software components that can work across multiple RTOS systems.| |RTOS v2| All Cortex-M, Cortex-A5/A7/A9 | Extends CMSIS-RTOS v1 with Armv8-M support, dynamic object creation, provisions for multi-core systems, binary compatible interface. | |Pack | All Cortex-M, SecurCore, Cortex-A5/A7/A9 | Describes a delivery mechanism for software components, device parameters, and evaluation board support. It simplifies software re-use and product life-cycle management (PLM). | |SVD | All Cortex-M, SecurCore | Peripheral description of a device that can be used to create peripheral awareness in debuggers or CMSIS-Core header files.| |DAP | All Cortex | Firmware for a debug unit that interfaces to the CoreSight Debug Access Port. | |Zone | All Cortex-M | Defines methods to describe system resources and to partition these resources into multiple projects and execution areas. |

Implemented Enhancements

  • CMSIS-Pack generation with shell script template for Windows and Linux
  • CMSIS-Pack: Git workflow via Eclipse menu Window - Preferences - CMSIS Packs - Manage Local Repositories and MDK
  • CMSIS-Zone release 1.0 with support for multi-processor, TrustZone, and MPU configuration
  • Support for Armv8.1M Architecture and Cortex-M55 (release in March 2020)
  • CMSIS-DSP is fully ported to SIMD for Cortex-M family (Armv8.1-M) and Cortex-A & Cortex-R with NEON, using the same APIs.

Further Planned Enhancements

  • CMSIS-Pack:
    • System Description SDF Format: describe more complex debug topologies than with a Debug Description in a tool agnostic way
    • CPDSC project file format: allows project templates that are agnostic of an IDE
    • Minimize need for IDE specific settings: CMSIS-Pack supports IDE specific parameters. Analyze and minimize
  • CMSIS-Build: command-line driven make system for CMSIS-Pack based projects (to support CI tests)

For further details see also the Slides of the Embedded World CMSIS Partner Meeting.

Other related GitHub repositories

| Repository | Description | |:--------------------------- |:--------------------------------------------------------- | | cmsis-pack-eclipse | CMSIS-Pack Management for Eclipse reference implementation Pack support | | CMSIS-FreeRTOS | CMSIS-RTOS adoption of FreeRTOS | | CMSIS-Driver | Generic MCU driver implementations and templates for Ethernet MAC/PHY and Flash. | | CMSIS-Driver_Validation | CMSIS-Driver Validation can be used to verify CMSIS-Driver in a user system | | CMSIS-Zone | CMSIS-Zone Utility along with example projects and FreeMarker templates | | NXP_LPC | CMSIS Driver Implementations for the NXP LPC Microcontroller Series | | mdk-packs | IoT cloud connectors as trail implementations for MDK (help us to make it generic)| | trustedfirmware.org | Arm Trusted Firmware provides a reference implementation of secure world software for Armv8-A and Armv8-M.|

Directory Structure

| Directory | Content | |:-------------------- |:--------------------------------------------------------- | | CMSIS/Core | CMSIS-Core(M) related files (for release) | | CMSIS/Core_A | CMSIS-Core(A) related files (for release) | | CMSIS/CoreValidation | Validation for Core(M) and Core(A) (NOT part of release) | | CMSIS/DAP | CMSIS-DAP related files and examples | | CMSIS/Driver | CMSIS-Driver API headers and template files | | CMSIS/DSP | CMSIS-DSP related files | | CMSIS/NN | CMSIS-NN related files | | CMSIS/RTOS | RTOS v1 related files (for Cortex-M) | | CMSIS/RTOS2 | RTOS v2 related files (for Cortex-M & Armv8-M) | | CMSIS/Pack | CMSIS-Pack examples and tutorials | | CMSIS/DoxyGen | Source of the documentation | | CMSIS/Utilities | Utility programs |

Generate CMSIS Pack for Release

This GitHub development repository contains already pre-built libraries (stored in Git-LFS) of various software components (DSP, RTOS, RTOS2). These libraries are validated for release. Git-LFS needs to be installed to retrieve the actual binary files, please see https://git-lfs.github.com/.

To build a complete CMSIS pack for installation the following additional tools are required:

  • doxygen.exe Version: 1.8.6 (Documentation Generator)
  • mscgen.exe Version: 0.20 (Message Sequence Chart Converter)
  • 7z.exe (7-Zip) Version: 16.02 (File Archiver)

Using these tools, you can generate on a Windows PC:

  • CMSIS Documentation using the batch file gen_doc.sh (located in ./CMSIS/Doxygen).
  • CMSIS Software Pack using the batch file gen_pack.sh (located in ./CMSIS/Utilities). The bash script does not generate the documentation. The pre-built libraries for RTX4 and RTX5 are not included within this repository.

The file ./CMSIS/DoxyGen/How2Doc.txt describes the rules for creating API documentation.

License

Arm CMSIS is licensed under Apache 2.0.

Contributions and Pull Requests

Contributions are accepted under Apache 2.0. Only submit contributions where you have authored all of the code.

Issues and Labels

Please feel free to raise an issue on GitHub to report misbehavior (i.e. bugs) or start discussions about enhancements. This is your best way to interact directly with the maintenance team and the community. We encourage you to append implementation suggestions as this helps to decrease the workload of the very limited maintenance team.

We will be monitoring and responding to issues as best we can. Please attempt to avoid filing duplicates of open or closed items when possible. In the spirit of openness we will be tagging issues with the following:

  • bug – We consider this issue to be a bug that will be investigated.

  • wontfix - We appreciate this issue but decided not to change the current behavior.

  • enhancement – Denotes something that will be implemented soon.

  • future - Denotes something not yet schedule for implementation.

  • out-of-scope - We consider this issue loosely related to CMSIS. It might by implemented outside of CMSIS. Let us know about your work.

  • question – We have further questions to this issue. Please review and provide feedback.

  • documentation - This issue is a documentation flaw that will be improved in future.

  • review - This issue is under review. Please be patient.

  • DONE - We consider this issue as resolved - please review and close it. In case of no further activity this issues will be closed after a week.

  • duplicate - This issue is already addressed elsewhere, see comment with provided references.

  • Important Information - We provide essential informations regarding planned or resolved major enhancements.