Open-CMSIS-Pack  Version 1.7.25
Delivery Mechanism for Software Packs
/package/parts element

The element /package/parts describes a set of hardware parts (devices other than the MCUs) contained in a Part pack (like the element <components> is used to describe software components, the element <parts> here defined is used to describe hardware components).

A part must have a vendor (Hvendor=), a name (Hname=) and a class (Hclass=) which are used to identify the part. Optionally, a part may have a group (Hgroup=) and a sub-group (Hsub=) to add further categories, a revision (Hrevision=) in case different cuts of the same part exists, and a variant (Hvariant=).

A part is therefore identified by a name and a class together with the vendor specified by the pack. A part vendor must ensure that the combination of name, revision, class, variant, group and sub-group is unique and not used by multiple parts.

Example

<package>
...
<parts>
<part Hvendor="STMicroelectronics" Hname="STSAFE-A110" Hvariant="STSAFA110DFSPL02" Hclass="Secure MCUs" Hgroup="Authentication">
<feature type="Crypto" n="128.256" name="Authentication and security for peripherals and IoT devices from STMicroelectronics"/>
<environment name="SomeConfigTool">
<file>STSAFA110DFSPL02_ConfigFile.cfg</file>
</environment>
<book name="Images/STSAFA110DFSPL02_image.jpg" title="image" public="true"/>
</part>
<part Hvendor="STMicroelectronics" Hname="STSAFE-A110" Hvariant="STSAFA110S8SPL02" Hclass="Secure MCUs" Hgroup="Authentication">
<feature type="Crypto" n="128.256" name="Authentication and security for peripherals and IoT devices from STMicroelectronics"/>
<environment name="SomeConfigTool">
<file>Descriptors/pinout/STSAFA110S8SPL02_ConfigFile.cfg</file>
</environment>
<book name="Images/STSAFA110S8SPL02_image.jpg" title="image" public="true"/>
</part>
<part Hvendor="STMicroelectronics" Hname="STSAFE-A110" Hvariant="STSAFA110DFSPL03" Hclass="Secure MCUs" Hgroup="Authentication">
<feature type="Crypto" n="128.256" name="Authentication and security for peripherals and IoT devices from STMicroelectronics"/>
<environment name="SomeConfigTool">
<file>Descriptors/pinout/STSAFA110DFSPL03_ConfigFile.cfg</file>
</environment>
<book name="Images/STSAFA110DFSPL03_image.jpg" title="image" public="true"/>
</part>
</parts>
...
</package>

 


/package/parts

Grouping element for parts. No more than one such group can exist in a Part Pack.

Parent Chain
package /package
Child Elements Description Type Occurrence
part Description of the part PartType 1..*

 



/package/parts/part

This element specifies a part. At least one part element must be specified per parts.

Parent Chain
parts /package/parts
Attributes Description Type Use
Hvendor Defines the vendor this part is shipped by. It is a mandatory part of the part ID and will be inherited from the package vendor if not specified. xs:string optional
Hname The part name used by the part vendor to identify and group a specific set of parts xs:string required
Hclass Defines the part class to which the part belongs. HclassType optional
Hgroup Defines the part group to which the part belongs. HgroupType optional
Hsub Defines the part subgroup. HsubType optional
Hvariant Specifies the exact part name (e.g. the commercial/selling name) in case the one indicated in the Hname is not enough to uniquely identify the part. xs:string optional
Child Elements Description Type Occurrence
feature Describes the features of the part. DeviceFeatureType 0..*
book Specifies documents that are relevant for the part. BookType 0..*
environment Specifies tool specific settings. EnvironmentType 0..*

 

Part Subgroups

Part Subgroups are specified by the element Hsub and create subcategories within Part Classes (Hclass) and Part Groups (Hgroup). A Hsub name is of type HsubType, that is a xs:string with a length between 3 and 32 characters. No Hsub names have been predefined.

Part Subgroups can be used in element /package/parts/part

Example:

<... Hclass="MEMS and Sensors" Hgroup="Environmental" Hsub="Temperature" ...>

 


/package/parts/part/feature

See description at /package/devices/family/.../feature.

 



/package/parts/part/book

See description at /package/devices/family/.../book.

 



/package/parts/part/environment

See description at /package/devices/family/.../environment.