| CMSIS-Driver Version 2.02 Peripheral Interface for Middleware and Application Code

- CMSIS
- CORE
- Driver
- DSP
- RTOS API
- Pack
- SVD

- Main Page
- Usage and Description
- Reference

All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Overview

The CMSIS-Driver specification is a software API that describes peripheral driver interfaces for middleware stacks and user applications. The CMSIS-Driver API is designed to be generic and independent of a specific RTOS making it reusable across a wide range of supported microcontroller devices. The CMSIS-Driver API covers a wide range of use cases for the supported peripheral types, but can not take every potential use-case into account. Over time, it is indented to extend the CMSIS-Driver API with further groups to cover new use-cases.

The CMSIS Software Pack publishes the API Interface under the Component Class CMSIS Driver with header files and a documentation. These header files are the reference for the implementation of the standardized peripheral driver interfaces. These implementations are published typically in the Device Family Pack of a related microcontroller family under the Component Class CMSIS Driver. A Device Family Pack may contain additional interfaces in the Component Class Device to extend the standard Peripheral Drivers covered by this CMSIS-Driver specification with additional device specific interfaces for example for Memory BUS, GPIO, or DMA.

The standard peripheral driver interfaces connect microcontroller peripherals for example with middleware that implements communication stacks, file systems, or graphic user interfaces. Each peripheral driver interface may provide multiple instances reflecting the multiple physical interfaces of the same type in a device. For example the two physical SPI interfaces are reflected with a separate Access Struct for SPI1 and SPI2. The Access Struct is the interface of a driver to the middleware component or the user application.

Peripheral Driver Interfaces and Middleware

The following CMSIS-Driver API groups are defined:

- USART: Universal Synchronous and Asynchronous Receiver/Transmitter interface driver.
- SPI: Serial Peripheral Interface Bus driver.
- I2C: Multi-master Serial Single-Ended Bus interface driver.
- Flash: Flash Memory interface driver.
- NAND: NAND Flash Memory interface driver.
- MCI: Memory Card Interface for SD/MMC memory.
- Ethernet: Interface to Ethernet MAC and PHY peripheral.
- USB: Interface driver for USB Host and USB Device communication.

## CMSIS-Driver in ARM::CMSIS Pack

The following files relevant to CMSIS-Driver are present in the ARM::CMSIS Pack directories:

File/Folder | Content
--- | ---
CMSIS\Documentation\RTOS | This documentation
CMSIS\Driver\Include | Driver header files (Driver_interface.h, Driver_Common.h)

## Revision History

Version | Description
--- | ---
2.02 | Modifications compared to Version 2.00: Minor API changes, for exact details refer to the header file of each driver. Added: Flash Interface, NAND interface.
2.00 | API with non-blocking data transfer, independent of CMSIS-RTOS.
1.10 | Initial release