From 9f95ff5b6ba01db09552b84a0ab79607060a2666 Mon Sep 17 00:00:00 2001 From: Ali Labbene Date: Wed, 11 Dec 2019 08:59:21 +0100 Subject: Official ARM version: v5.4.0 Add CMSIS V5.4.0, please refer to index.html available under \docs folder. Note: content of \CMSIS\Core\Include has been copied under \Include to keep the same structure used in existing projects, and thus avoid projects mass update Note: the following components have been removed from ARM original delivery (as not used in ST packages) - CMSIS_EW2018.pdf - .gitattributes - .gitignore - \Device - \CMSIS - \CoreValidation - \DAP - \Documentation - \DoxyGen - \Driver - \Pack - \RTOS\CMSIS_RTOS_Tutorial.pdf - \RTOS\RTX - \RTOS\Template - \RTOS2\RTX - \Utilities - All ARM/GCC projects files are deleted from \DSP, \RTOS and \RTOS2 Change-Id: Ia026c3f0f0d016627a4fb5a9032852c33d24b4d3 --- docs/Pack/html/pdsc_apis_pg.html | 200 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 200 insertions(+) create mode 100644 docs/Pack/html/pdsc_apis_pg.html (limited to 'docs/Pack/html/pdsc_apis_pg.html') diff --git a/docs/Pack/html/pdsc_apis_pg.html b/docs/Pack/html/pdsc_apis_pg.html new file mode 100644 index 0000000..900631f --- /dev/null +++ b/docs/Pack/html/pdsc_apis_pg.html @@ -0,0 +1,200 @@ + + + + + +/package/apis element +CMSIS-Pack: /package/apis element + + + + + + + + + + + + + + +
+
+ + + + + + + +
+
CMSIS-Pack +  Version 1.5.0 +
+
Delivery Mechanism for Software Packs
+
+
+ +
+
    + +
+
+ + + +
+
+ +
+
+
+ +
+ + + + +
+ +
+ +
+
+
/package/apis element
+
+
+

Application Programming Interfaces (apis) are C/C++ interface specifications that allow software to be divided into largely independent modules. Such modules can then be developed, tested, and maintained independently, and reused by different projects. One example is the use of device drivers. If device drivers are developed for different devices implementing the same API, the application software itself can be written independent from the device it is build for.

+

The apis allow to distribute the Application Programming Interface Specifications decoupled from actual implementation. One example is the CMSIS-RTOS API, which is specified as part of CMSIS, however, the actual RTOS implementation is provided by different vendors.

+

Unlike a software component, an API is not selectable. An API consists of a name, a brief description as well as one or more header files, and a document containing a detailed specification of the API.

+

 

+
+

+/package/apis

+

This element is a grouping element for all application programming interfaces included in the Software Pack. The element itself is optional. Only one such section can exist in a package.

+

Example:

+
<package>
+
<apis>
+
...
+
</apis>
+
</package>
+

 

+ + + + + + + + + +
Parents Element Chain    
package /package    
Child Elements Description Type Occurrence
api Named specification of an API containing a brief description, C/C++ header files and documentation ApiType 1..*
+

 

+
+

+/package/apis/api

+

Application Programming Interfaces (apis) are C/C++ interface specifications that allow components to interwork by either implementing or using a set of functions, data types, and definitions. This element is mandatory and can exist multiple times.

+

Example:

+
<apis>
+
<api Cclass="Device" Cgroup="Driver UART" exclusive="0">
+
<description>UART Driver API for the Cortex-M processor based devices</description>
+
<files>
+
<file category="doc" name="Driver/Doc/UART/html/index.html"/>
+
<file category="header" name="Driver/Include/Driver_UART.h"/>
+
</files>
+
</api>
+
<api Cclass="Device" Cgroup="Driver SPI" exclusive="0">
+
<description>SPI Driver API for the Cortex-M processor based devices</description>
+
<files>
+
<file category="doc" name="Driver/Doc/SPI/html/index.html"/>
+
<file category="header" name="Driver/Include/Driver_SPI.h"/>
+
</files>
+
</api>
+
...
+
</apis>
+

 

+ + + + + + + + + + + + + + + + + + + + + +
Parent Element Element Chain
apis /package/apis
Attributes Description Type Use
Cclass Defines the component class to which this component belongs. This is a mandatory part of the component ID. Predefined values can be used as listed in the table Component Classes. CclassType required
Cgroup Defines the component group to which this component belongs. This is a mandatory part of the component ID. Predefined values can be used as listed in the table Component Groups. CgroupType required
exclusive Makes the selection of a component implementing the API exclusive. If set to 0, then multiple components implementing the API can be selected. Default is 1. xs:boolean optional
Capiversion Version of this component. Is a mandatory part of the component ID. The version format is described in Version Type. VersionType optional
Child Elements Description Type Occurrence
description Brief summary about the purpose and scope of an API. xs:string 0..1
files Grouping element for all file descriptions that are part of this component.. group 0..1
+

 

+
+
+ + + + -- cgit