The CPU section describes the processor included in the microcontroller device. This section is mandatory if the SVD file is used to generate the device header file.

Example

<device>
  ...
  <cpu>
    <name>CM7</name> 
    <revision>r0p0</revision>
    <endian>little</endian>
    <mpuPresent>true</mpuPresent>
    <!-- has double precision FPU -->
    <fpuPresent>true</fpuPresent>
    <fpuDP>true</fpuDP>
    <!-- has instruction and data cache -->
    <icachePresent>true</icachePresent>
    <dcachePresent>true</dcachePresent>
    <!-- has no instruction nor data tighly coupled memory -->
    <itcmPresent>false</itcmPresent>
    <dtcmPresent>false</dtcmPresent>
    <nvicPrioBits>4</nvicPrioBits>
    <vendorSystickConfig>false</vendorSystickConfig> 
  </cpu>
  ...
<device>

This example describes a device based on a Cortex-M7 core of HW revision r0p0, with fixed little endian memory scheme, including Memory Protection Unit and double precision hardware Floating Point Unit. It has a data cache and no instruction nor a tightly coupled memory. The Nested Vectored Interrupt Controller uses 4 bits to configure the priority of an interrupt. It is equipped with the standard System Tick Timer as defined by Arm.

/device/cpu

Parent Element	Element Chain
device	/device
Child Elements	Description	Type	Occurrence
name	The predefined tokens are: CM0: Arm Cortex-M0 CM0PLUS: Arm Cortex-M0+ CM0+: Arm Cortex-M0+ CM1: Arm Cortex-M1 SC000: Arm Secure Core SC000 CM23: Arm Cortex-M23 CM3: Arm Cortex-M3 CM33: Arm Cortex-M33 SC300: Arm Secure Core SC300 CM4: Arm Cortex-M4 CM7: Arm Cortex-M7 CA5: Arm Cortex-A5 CA7: Arm Cortex-A7 CA8: Arm Cortex-A8 CA9: Arm Cortex-A9 CA15: Arm Cortex-A15 CA17: Arm Cortex-A17 CA53: Arm Cortex-A53 CA57: Arm Cortex-A57 CA72: Arm Cortex-A72 other: other processor architectures	cpuNameType	1..1
revision	Define the HW revision of the processor. The version format is rNpM (N,M = [0 - 99]).	revisionType	1..1
endian	Define the endianness of the processor being one of: little: little endian memory (least significant byte gets allocated at the lowest address). big: byte invariant big endian data organization (most significant byte gets allocated at the lowest address). selectable: little and big endian are configurable for the device and become active after the next reset. other: the endianness is neither little nor big endian.	endianType	1..1
mpuPresent	Indicate whether the processor is equipped with a memory protection unit (MPU). This tag is either set to true or false, 1 or 0.	boolean	1..1
fpuPresent	Indicate whether the processor is equipped with a hardware floating point unit (FPU). Cortex-M4, Cortex-M7 and Cortex-M33 are the only available Cortex-M processor with an optional FPU. This tag is either set to true or false, 1 or 0.	boolean	1..1
fpuDP	Indicate whether the processor is equipped with a double precision floating point unit. This element is valid only when <fpuPresent> is set to true. Currently, only Cortex-M7 processors can have a double precision floating point unit.	boolean	0..1
icachePresent	Indicate whether the processor has an instruction cache. Note: only for Cortex-M7-based devices.	boolean	0..1
dcachePresent	Indicate whether the processor has a data cache. Note: only for Cortex-M7-based devices.	boolean	0..1
itcmPresent	Indicate whether the processor has an instruction tightly coupled memory. Note: only an option for Cortex-M7-based devices.	boolean	0..1
dtcmPresent	Indicate whether the processor has a data tightly coupled memory. Note: only for Cortex-M7-based devices.	boolean	0..1
vtorPresent	Indicate whether the Vector Table Offset Register (VTOR) is implemented in Cortex-M0+ based devices. This tag is either set to true or false, 1 or 0. If not specified, then VTOR is assumed to be present.	boolean	0..1
nvicPrioBits	Define the number of bits available in the Nested Vectored Interrupt Controller (NVIC) for configuring priority.	scaledNonNegativeInteger	1..1
vendorSystickConfig	Indicate whether the processor implements a vendor-specific System Tick Timer. If false, then the Arm-defined System Tick Timer is available. If true, then a vendor-specific System Tick Timer must be implemented. This tag is either set to true or false, 1 or 0.	boolean	1..1
deviceNumInterrupts	Add 1 to the highest interrupt number and specify this number in here. You can start to enumerate interrupts from 0. Gaps might exist between interrupts. For example, you have defined interrupts with the numbers 1, 2, and 8. Add 9 :(8+1) into this field.	scaledNonNegativeInteger	0..1
sauNumRegions	Indicate the amount of regions in the Security Attribution Unit (SAU). If the value is greater than zero, then the device has a SAU and the number indicates the maximum amount of available address regions.	scaledNonNegativeInteger	0..1
sauRegionsConfig	If the Secure Attribution Unit is preconfigured by HW or Firmware, then the settings are described here.	SauRegionsConfigType	0..1

/device/cpu/sauRegionsConfig element

Set the configuration for the Secure Attribution Unit (SAU) when they are preconfigured by HW or Firmware.

Example

<device>
  ...
  <sauRegionsConfig protectionWhenDisabled="n">
    <region>
      ...
    </region>
    ...
    <region>
      ...
    </region>
  </sauRegionsConfig>
  ...
</device>

The example defines two Secure Attribution Units, which are enabled by default. When the SAU regions are disabled, the protection level is non-secure (n).

/device/cpu/sauRegionsConfig

Parent Element	Element Chain
cpu	/device/cpu element
Attributes	Description	Type	Use
enabled	Specify whether the Secure Attribution Units are enabled. The following values can be used: true,false,1, and 0.	xs:boolean	optional
protectionWhenDisabled	Set the protection mode for disabled regions. When the complete SAU is disabled, the whole memory is treated either "s"=secure or "n"=non-secure. This value is inherited by the <region> element. Refer to element protection for details and predefined values.	xs:string	optional
Child Elements	Description	Type	Occurrence
region	Group to configure SAU regions.	xs:string	0..*

/device/cpu/sauRegionsConfig/region element

Define the regions of the Secure Attribution Unit (SAU). The protection level is inherited from the attribute <protectionWhenDisabled> of the enclosing element sauRegionsConfig.

Example:

<sauRegionsConfig>
  <region name="SAU1">
    <base>0x10001000</base>
    <limit>0x10005000</limit>
    <access>n</access>
  </region>
  <region enabled="false" name="SAU2">
    <base>0x10006000</base>
    <limit>0x10008000</limit>
    <access>c</access>
  </region>
</sauRegionsConfig>

The example defines two secure regions with the names SAU1 and SAU2. SAU1 has the address boundries 0x10001000 and 0x10005000. The region has non-secure access rights. SAU2 has the address boundries 0x10006000 and 0x10008000. The region has secure callable access rights.

/device/cpu/sauRegionsConfig/region

Parent Element	Element Chain
sauRegionsConfig	/device/cpu/sauRegionsConfig element
Attributes	Description	Type	Use
enabled	Specify whether the Secure Attribution Units are enabled. The following values can be used: true and false, or 1 and 0. Default value is true.	xs:boolean	optional
name	Identifiy the region with a name.	xs:string	optional
Child Elements	Description	Type	Occurrence
base	Base address of the region.	scaledNonNegativeInteger	1..1
limit	Limit address of the region.	scaledNonNegativeInteger	1..1
access	Use one of the following predefined values to define the acces type of a region: - n : non-secure - c : secure callable	xs:string	1..1