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.