1. Article purpose[edit source]
This article explains how to configure TAMP internal peripheral.
This article describes the TAMP configuration performed using the device tree mechanism, which provides an hardware description of the TAMP peripheral.
2. DT bindings documentation[edit source]
The following binding-related documentation explains how to write device tree files for TAMP:
- TF-A: Tamper related part: tf-a/docs/devicetree/bindings/soc/st,stm32-tamp.txt"[1]
- OP-TEE: there is no specific documentation in the source code.
- Linux Kernel: Backup register management: Documentation/devicetree/bindings/power/reset/syscon-reboot-mode.yaml'[2]
3. DT configuration[edit source]
This hardware description is a combination of the STM32 microprocessor device tree files (.dtsi extension) and board device tree files (.dts extension). See the Device tree for an explanation of the device-tree file split.
STM32CubeMX can be used to generate the board device tree. Refer to How to configure the DT using STM32CubeMX for more details.
3.1. DT configuration (STM32 level)[edit source]
3.1.1. STM32 TAMP node in Linux[edit source]
- for STM32MP13x lines
in stm32mp131.dtsi[3]
tamp: tamp@5c00a000 {
reg = <0x5c00a000 0x400>;
};
- for STM32MP15x lines in stm32mp151.dtsi[4]
tamp: tamp@5c00a000 {
compatible = "simple-bus", "syscon", "simple-mfd";
reg = <0x5c00a000 0x400>;
reboot-mode {
compatible = "syscon-reboot-mode";
offset = <0x150>; /* reg20 */
mask = <0xff>;
mode-normal = <0>;
mode-fastboot = <0x1>;
mode-recovery = <0x2>;
mode-stm32cubeprogrammer = <0x3>;
mode-ums_mmc0 = <0x10>;
mode-ums_mmc1 = <0x11>;
mode-ums_mmc2 = <0x12>;
};
};
3.1.2. STM32 TAMP node in OP-TEE[edit source]
- for STM32MP13x lines in stm32mp131.dtsi[5]
tamp: tamp@5c00a000 {
compatible = "st,stm32mp13-tamp", "syscon", "simple-mfd";
reg = <0x5c00a000 0x400>;
secure-interrupts = <GIC_SPI 128 IRQ_TYPE_LEVEL_HIGH>;
clocks = <&rcc RTCAPB>;
st,tamp_passive_precharge = <0>;
st,tamp_passive_nb_sample = <0>;
st,tamp_passive_sample_clk_div = <32768>;
st,tamp_active_clk_div = <1>;
};
- for STM32MP15x lines in stm32mp151.dtsi[6]
tamp: tamp@5c00a000 {
compatible = "st,stm32-tamp", "syscon", "simple-mfd";
reg = <0x5c00a000 0x400>;
secure-interrupts = <GIC_SPI 197 IRQ_TYPE_LEVEL_HIGH>;
clocks = <&rcc RTCAPB>;
};
3.2. DT configuration (board level)[edit source]
3.2.1. STM32MP1 TAMP node append[edit source]
The board definition in the device tree may include some additional board-specific pin control management.
&tamp {
pinctrl-0 = <&tamp1_pins_a>; // Must be defined in the pinctrl corresponding to the board
wakeup-source; // Enable the tamper as wake up source
};
3.2.2. STM32MP1 TAMP node append (OP-TEE specific)[edit source]
The board definition in the device tree may include some additional board-specific pin control management, and some global configuration for the external tamper.
Per example for STM32MP13x lines in stm32mp135f-dk.dts[7]
&tamp {
st,tamp_passive_nb_sample = <4>;
st,tamp_passive_sample_clk_div = <16384>;
tamp_passive@2 {
pinctrl-0 = <&tamp0_in2_pin_a>;
status = "okay";
};
/* Connect pin24 and pin28 from CN8 */
tamp_active@1 {
pinctrl-0 = <&tamp0_in1_pin_a &tamp0_out1_pin_a>;
status = "disabled";
};
};
Some system configuration can be overrided in the board tamp node, as these depend of the board. These global configuration are defined for all external tampers.
- st,tamp_passive_precharge can be 0, 1, 2, 4, 8.
- 0 is no precharge, so the pull-up is disabled for all external passive tamper.
- 1, 2, 3, 4, 8 define the number of cycle the STM32 precharge the pin before checking the value (low/high) for all external tamper.
- st,tamp_passive_nb_sample: the number of sample to read in a row to raise a passive tamper. Can be 0 (activation on edge), 2, 4, 8.
- st,tamp_passive_sample_clk_div: clock divider to define frequency to read a sample for a passive tamper.
- st,tamp_active_filter:
- 0: Active tamper filtering disable
- 1: Active tamper filtering enable: a tamper event is detected when 2 comparison mismatches occur out of 4 consecutive samples.
- st,tamp_active_clk_div: clock divider to define the frequency of read/write cycle for all active tampers.
- wakeup-source: not yet implemented. TAMP event will exit from low power mode.
Each sub-node define an external tamper, and within this node:
- pinctrl-0 entry defines which pin for which tamper id (see stm32mp13-pinctrl.dtsi [8] for possible values). If only one pin is defined, the external tamper is a passive one, otherwise the external tamper is an active one (first entry is the input pin, second the output pin)
- st,trig_on defines the active level to activate this passive tamper (not used if pintctrl-0 as 2 entries). It depends also of st,tamp_passive_precharge value.
- if st,tamp_passive_precharge=0 this passive tamper activate at edge.
- if st,tamp_passive_precharge != 0, with st,trig_on defined, this passive tamper will activate if st,tamp_passive_nb_sample in a row are high. If not defined the passive tamper event is raised if st,tamp_passive_nb_sample in a row are low.
4. How to configure the DT using STM32CubeMX[edit source]
The STM32CubeMX tool can be used to configure the STM32MPU device and get the corresponding platform configuration device tree files.
STM32CubeMX may not support all the properties described in the documents listed in DT bindings documentation above. If so, the tool inserts user sections in the generated device tree. These sections can then be edited to add some properties that are preserved from one generation to another. Refer to the STM32CubeMX user manual for further information.
5. References[edit source]
Please refer to the following links for additional information:
- ↑ docs/devicetree/bindings/soc/st,stm32-tamp.txt TF-A TAMP binding information file
- ↑ Documentation/devicetree/bindings/power/reset/syscon-reboot-mode.yaml
- ↑ arch/arm/boot/dts/stm32mp131.dtsi
- ↑ arch/arm/boot/dts/stm32mp151.dtsi
- ↑ core/arch/arm/dts/stm32mp131.dtsi
- ↑ core/arch/arm/dts/stm32mp151.dtsi
- ↑ core/arch/arm/dts/stm32mp135f-dk.dts
- ↑ core/arch/arm/dts/stm32mp13-pinctrl.dtsi