Open-CMSIS-Pack  Version 1.7.32
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"/>
<book name="Images/STSAFA110DFSPL02_UM.pdf" title="User Manual" public="true"/>
<book name="Images/STSAFA110DFSPL02_DS.pdf" title="Datasheet" public="true"/>
<image top="Images/STSAFA110DFSPL02_image.jpg" public="true">
<environment name="SomeConfigTool">
<file>STSAFA110DFSPL02_ConfigFile.cfg</file>
</environment>
</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"/>
<book name="Images/STSAFA110S8SPL02_UM.pdf" title="User Manual" public="true"/>
<book name="Images/STSAFA110S8SPL02_DS.pdf" title="Datasheet" public="true"/>
<image top="Images/STSAFA110S8SPL02_image.jpg" public="true">
<environment name="SomeConfigTool">
<file>Descriptors/pinout/STSAFA110S8SPL02_ConfigFile.cfg</file>
</environment>
</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..*
image Specifies the part pictures. ComplexType 0..1
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/image

This element specifies the part pictures. Maximum one image element can be specified. Three different picture types (top, bottom and perspective) can be specified for the same <image> element at the same time. Attribute top displays the 'top' side of the part (or the main part picture).

Example:

<image top="Images/part_image_1.png"
bottom="https://images.vendor.com/Images/part_image_2.png"
perspective="https://images.vendor.com/Images/part_image_3.png"
/>

 


Parent Chain
part /package/parts/part
Attributes Description Type Use
top Specifies the path to the top (or the main) part image. The path is relative to the pack base directory or a link to an image on an external web site. xs:string required
bottom Specifies the path to the bottom part image. The path is relative to the pack base directory or a link to an image on an external web site. xs:string optional
perspective Specifies the path to a perspective part image. The path is relative to the pack base directory or a link to an image on an external web site. xs:string optional
public Set publishing permissions for the image. If <public> is true, then the vendor gives permission to extract the image file from the Pack and publish it on a web-page. Links to web pages are assumed to be public. If no <public> tag is available, it is assumed that publishing is allowed (default value is true). xs:boolean optional

 



/package/parts/part/environment

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