Difference between revisions of "TAMP internal peripheral"

[quality revision] [checked revision]
m (Peripheral overview)
 

1 Article purpose[edit]

The purpose of this article is to:

  • briefly introduce the TAMP peripheral and its main features
  • indicate the level of security supported by this hardware block
  • explain how it can be allocated to the three runtime contexts and linked to the corresponding software components
  • explain, when necessary, how to configure the TAMP peripheral.

2 Peripheral overview[edit]

The TAMP peripheral is used to prevent any attempt by an attacker to perform an unauthorized physical or electronic action against the device. It also includes the backup registers that remain powered-on when the platform is switched off.

Warning.png
Info.png It is important to notice that the backup registers
are
and the BKPSRAM internal memory can be erased when a tamper detection occurs in TAMP internal peripheral

2.1 Features[edit]

Refer to the STM32MP15 reference manuals for the complete list of features, and to the software components, introduced below, to see which features are implemented.

2.2 Security support[edit]

The TAMP is a secure peripheral. The access to some backup registers can be opened to the non-secure world via a direct configuration in TAMP, in secure mode.

3 Peripheral usage and associated software[edit]

3.1 Boot time[edit]

The TAMP is used at boot time to share data between the ROM code, FSBL and SSBL: see backup registers for further information.

3.2 Runtime[edit]

3.2.1 Overview[edit]

TAMP is seen as a system peripheral, that can be used by the Arm® Cortex®-A7 secure context with OP-TEE or the Arm® Cortex®-A7 non-secure context with Linux.

3.2.2 Software frameworks[edit]

Domain Peripheral Software frameworks Comment
Cortex-A7
secure
(OP-TEE)
Cortex-A7
non-secure
(Linux)
Cortex-M4

(STM32Cube)
Security TAMP OP-TEE Linux syscon framework[1]


For the Linux kernel configuration, sysconf part, please refer to TAMP device tree configuration.
For the secure configuration, please refer to TAMP device tree configuration and Tamper configuration.

3.2.3 Peripheral configuration[edit]

The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration can be done alone via the STM32CubeMX tool for all internal peripherals, and then manually completed (particularly for external peripherals), according to the information given in the corresponding software framework article.

3.2.4 Peripheral assignment[edit]

Internal peripherals

Check boxes illustrate the possible peripheral allocations supported by STM32 MPU Embedded Software:

  • means that the peripheral can be assigned () to the given runtime context.
  • is used for system peripherals that cannot be unchecked because they are statically connected in the device.

Refer to How to assign an internal peripheral to a runtime context for more information on how to assign peripherals manually or via STM32CubeMX.
The present chapter describes STMicroelectronics recommendations or choice of implementation. Additional possiblities might be described in STM32MP15 reference manuals.

Domain Peripheral Runtime allocation Comment
Instance Cortex-A7
secure
(OP-TEE)
Cortex-A7
non-secure
(Linux)
Cortex-M4

(STM32Cube)
Security TAMP TAMP

4 How to go further[edit]

5 References[edit]


==Article purpose==
The purpose of this article is to:
* briefly introduce the TAMP peripheral and its main features
* indicate the level of security supported by this hardware block
* explain how it can be allocated to the three runtime contexts and linked to the corresponding software components
* explain, when necessary, how to configure the TAMP peripheral.

==Peripheral overview==
The '''TAMP''' peripheral is used to prevent any attempt by an attacker to perform an unauthorized physical or electronic action against the device. It also includes the [[STM32MP15 backup registers|backup registers]] that remain powered-on when the platform is switched off.<br />

{{WarningInfo|It is important to notice that the [[STM32MP15 backup registers|backup registers]] are and the [[BKPSRAM internal memory]] can be erased when a tamper detection occurs in [[TAMP internal peripheral]]}}

===Features===
Refer to the [[STM32MP15 resources#Reference manuals|STM32MP15 reference manuals]] for the complete list of features, and to the software components, introduced below, to see which features are implemented.

===Security support===
The TAMP is a '''secure''' peripheral. The access to some [[STM32MP15 backup registers|backup registers]] can be opened to the '''non-secure''' world via a direct configuration in TAMP, in '''secure''' mode.

==Peripheral usage and associated software==
===Boot time===
The TAMP is used at boot time to share data between the ROM code, FSBL and SSBL: see [[STM32MP15 backup registers|backup registers]] for further information.

===Runtime===

====Overview====
TAMP is seen as a system peripheral, that can be used by the Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A7 secure context with [[OP-TEE_overview|OP-TEE]] or the Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A7 non-secure context with Linux.

====Software frameworks====
{{:Internal_peripherals_software_table_template}}
 | Security
 | [[TAMP internal peripheral|TAMP]]
 | [[OP-TEE_overview|OP-TEE]]
 | Linux syscon framework<ref name="syscon">{{CodeSource | Linux kernel | Documentation/devicetree/bindings/mfd/syscon.txt}}</ref>

 |
 |
 |-
 |}
<br>

For the Linux kernel configuration, sysconf part, please refer to [[TAMP device tree configuration]].<br>

For the secure configuration, please refer to [[TAMP device tree configuration]] and [[Security_overview#Tamper_event_detection|Tamper configuration]]. 
====Peripheral configuration====
The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration can be done alone via the [[STM32CubeMX]] tool for all internal peripherals, and then manually completed (particularly for external peripherals), according to the information given in the corresponding software framework article.

====Peripheral assignment====
{{:Internal_peripherals_assignment_table_template}}<onlyinclude>

 | rowspan="1" | Security
 | rowspan="1" | [[TAMP internal peripheral|TAMP]]
 | TAMP
 | <span title="system peripheral" style="font-size:21px"></span>

 | <span title="system peripheral" style="font-size:21px"></span>

 |
 |
 |-</onlyinclude>

 |}

==How to go further==

==References==<references/>

<noinclude>

[[Category:Security peripherals]]
{{ArticleBasedOnModel | Internal peripheral article model}}
{{PublicationRequestId | 8792 | 2018-10-01}}</noinclude>
(5 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
==Peripheral overview==
 
==Peripheral overview==
 
The '''TAMP''' peripheral is used to prevent any attempt by an attacker to perform an unauthorized physical or electronic action against the device. It also includes the [[STM32MP15 backup registers|backup registers]] that remain powered-on when the platform is switched off.<br />
 
The '''TAMP''' peripheral is used to prevent any attempt by an attacker to perform an unauthorized physical or electronic action against the device. It also includes the [[STM32MP15 backup registers|backup registers]] that remain powered-on when the platform is switched off.<br />
{{Warning|It is important to notice that the [[STM32MP15 backup registers|backup registers]] are erased when a tamper detection occurs in [[TAMP internal peripheral]]}}
+
{{Info|It is important to notice that the [[STM32MP15 backup registers|backup registers]] and the [[BKPSRAM internal memory]] can be erased when a tamper detection occurs in [[TAMP internal peripheral]]}}
   
 
===Features===
 
===Features===
Line 35: Line 35:
 
  |-
 
  |-
 
  |}
 
  |}
  +
<br>
  +
For the Linux kernel configuration, sysconf part, please refer to [[TAMP device tree configuration]].<br>
  +
For the secure configuration, please refer to [[TAMP device tree configuration]] and [[Security_overview#Tamper_event_detection|Tamper configuration]].
   
 
====Peripheral configuration====
 
====Peripheral configuration====