TF-A移植第1步就是创建新的设备树，并命名为“stm32mp157d-atk”。
和“TF-A移植”有关的知识点：
1)设备树英文名字叫做Device tree，用来描述板子硬件信息的，比如开发板上的 CPU有几个核 、每个CPU核主频是多少，IIC、SPI这些外设的寄存器范围是多少，IIC接口下都挂了哪些设备等等。
2)、TF-A移植主要是修改“设备树”。
3)、DTC是设备树的编译器。“.dts”的设备树文件经过编译后，会生成“.dtb”文件，有点类似C语言中的“.bin文件”。
4)、设备树文件是一种文本格式的文件。
设备树文件后缀为“.dts”，类似于C语言中的“.c文件”；
设备树头文件后缀为“.dtsi”，类似于C语言中的“.h文件”；
因此“.dts”的设备树文件可以引用“.dtsi”的设备树头文件。
5)、设备树文件的位置：
linux/atk-mp1/atk-mp1/my-tfa/tf-a-stm32mp-2.2.r1\fdts
一、查看设备树文件
1、打开终端
输入“ls回车”，列出当前目录下所有的文件和文件夹
输入“cd linux回车”，切换“linux”目录下
输入“ls回车”，列出当前目录下所有的文件和文件夹
输入“cd my-tfa回车”，切换到“my-tfa”目录下
输入“ls回车”，列出“my-tfa”目录下所有的文件和文件夹
输入“cd tf-a-stm32mp-2.2.r1/回车”，进入到“tf-a-stm32mp-2.2.r1”目录下；
输入“ls回车”，列出“tf-a-stm32mp-2.2.r1”目录下所有的文件和文件夹；
输入“cd fdts/回车”，进入到“fdts”目录下；
2、输入“ls回车”，列出“fdts”目录下的所有设备树文件；
3、使用VSCode打开my-tfa目录下tf-a.code-workspace”；
找到“tf-a-stm32mp-2.2.r1/fdts”目录，就是设备树文件所在的目录。
见下图：
4、点击“stm32mpl57d-ev1.dts”，打开该文件，见下图：
5、“stm32mpl57d-ev1.dts”的文件内容见下图：
6、为正点原子STM32MP157开发板要准备的设备树
“stm32mp157d-ev1.dts”文件很简洁,主要原因是它引用了“stm32mp157d-ed1.dts”文件,主要工作是由“stm32mp157d-ed1.dts”文件来完成的。因此，我们要以“stm32mp157d-ed1.dts”为蓝本，复制一份，并命名为 “stm32mp157d-atk.dts”，这就是我们为正点原子STM32MP157开发板要准备的设备树。
输入“cp stm32mp157d-ed1.dts stm32mp157d-atk.dts回车”，复制文件；
输入“ls回车”，列出“fdts”目录下的所有设备树文件；
发现了“stm32mp157d-atk.dts”文件，这就是我们为正点原子STM32MP157开发板准备的“设备树文件”。
见下图：
7、回到VSCode，打开设备树文件“stm32mp157d-atk.dts”，见下图：
设备树文件“stm32mp157d-atk.dts”文件内容如下：
// SPDX-License-Identifier: (GPL-2.0+ OR BSD-3-Clause)
/*
* Copyright (C) STMicroelectronics 2019 - All Rights Reserved
* Author: Alexandre Torgue <alexandre.torgue@st.com> for STMicroelectronics.
*/
/dts-v1/;
#include "stm32mp157.dtsi"
#include "stm32mp15xd.dtsi"
#include "stm32mp15-pinctrl.dtsi"
#include "stm32mp15xxaa-pinctrl.dtsi"
#include "stm32mp15xx-edx.dtsi"
#include <dt-bindings/soc/st,stm32-etzpc.h>
/ {
model = "STMicroelectronics STM32MP157D eval daughter";
compatible = "st,stm32mp157d-ed1", "st,stm32mp157";
chosen {
stdout-path = "serial0:115200n8";
};
aliases {
serial0 = &uart4;
};
};
&cpu1 {
cpu-supply = <&vddcore>;
};
&etzpc {
st,decprot = <
DECPROT(STM32MP1_ETZPC_USART1_ID, DECPROT_NS_RW, DECPROT_UNLOCK)
DECPROT(STM32MP1_ETZPC_SPI6_ID, DECPROT_NS_RW, DECPROT_UNLOCK)
DECPROT(STM32MP1_ETZPC_I2C4_ID, DECPROT_NS_RW, DECPROT_UNLOCK)
DECPROT(STM32MP1_ETZPC_I2C6_ID, DECPROT_NS_RW, DECPROT_UNLOCK)
DECPROT(STM32MP1_ETZPC_RNG1_ID, DECPROT_NS_RW, DECPROT_UNLOCK)
DECPROT(STM32MP1_ETZPC_HASH1_ID, DECPROT_NS_RW, DECPROT_UNLOCK)
DECPROT(STM32MP1_ETZPC_DDRCTRL_ID, DECPROT_S_RW, DECPROT_LOCK)
DECPROT(STM32MP1_ETZPC_DDRPHYC_ID, DECPROT_S_RW, DECPROT_LOCK)
DECPROT(STM32MP1_ETZPC_STGENC_ID, DECPROT_S_RW, DECPROT_LOCK)
DECPROT(STM32MP1_ETZPC_BKPSRAM_ID, DECPROT_S_RW, DECPROT_LOCK)
DECPROT(STM32MP1_ETZPC_IWDG1_ID, DECPROT_S_RW, DECPROT_LOCK)
>;
};
8、“stm32mp15xx-edx.dtsi”是edx系列开发板的设备树通用头文件。因此，
我们要以stm32mp15xx-edx.dtsi为蓝本，创建正点原子STM32MP157开发板的“设备树文件的头文件”。
输入“cp stm32mp15xx-edx.dtsi stm32mp157d-atk.dtsi回车”，复制文件；
输入“ls回车”，列出“fdts”目录下的所有设备树文件；
发现了“stm32mp157d-atk.dtsi”文件，这就是我们为正点原子STM32MP157开发板准备的“设备树头文件”。
见下图：
9、回到VSCode，打开设备树头文件“stm32mp157d-atk.dtsi”，见下图：
设备树头文件“stm32mp157d-atk.dtsi”文件内容如下：
// SPDX-License-Identifier: (GPL-2.0+ OR BSD-3-Clause)
/*
* Copyright (C) STMicroelectronics 2017 - All Rights Reserved
* Author: Ludovic Barre <ludovic.barre@st.com> for STMicroelectronics.
*/
#include <dt-bindings/clock/stm32mp1-clksrc.h>
#include <dt-bindings/power/stm32mp1-power.h>
#include "stm32mp15-ddr3-2x4Gb-1066-binG.dtsi"
/ {
memory@c0000000 {
device_type = "memory";
reg = <0xC0000000 0x40000000>;
};
vin: vin {
compatible = "regulator-fixed";
regulator-name = "vin";
regulator-min-microvolt = <5000000>;
regulator-max-microvolt = <5000000>;
regulator-always-on;
};
};
&bsec {
board_id: board_id@ec {
reg = <0xec 0x4>;
st,non-secure-otp;
};
};
&clk_hse {
st,digbypass;
};
&cpu0{
cpu-supply = <&vddcore>;
};
&hash1 {
status = "okay";
};
&i2c4 {
pinctrl-names = "default";
pinctrl-0 = <&i2c4_pins_a>;
i2c-scl-rising-time-ns = <185>;
i2c-scl-falling-time-ns = <20>;
clock-frequency = <400000>;
status = "okay";
secure-status = "okay";
pmic: stpmic@33 {
compatible = "st,stpmic1";
reg = <0x33>;
interrupts-extended = <&exti_pwr 55 IRQ_TYPE_EDGE_FALLING>;
interrupt-controller;
#interrupt-cells = <2>;
status = "okay";
secure-status = "okay";
regulators {
compatible = "st,stpmic1-regulators";
buck1-supply = <&vin>;
buck2-supply = <&vin>;
buck3-supply = <&vin>;
buck4-supply = <&vin>;
ldo1-supply = <&v3v3>;
ldo2-supply = <&v3v3>;
ldo3-supply = <&vdd_ddr>;
ldo4-supply = <&vin>;
ldo5-supply = <&v3v3>;
ldo6-supply = <&v3v3>;
vref_ddr-supply = <&vin>;
boost-supply = <&vin>;
pwr_sw1-supply = <&bst_out>;
pwr_sw2-supply = <&bst_out>;
vddcore: buck1 {
regulator-name = "vddcore";
regulator-min-microvolt = <1200000>;
regulator-max-microvolt = <1350000>;
regulator-always-on;
regulator-initial-mode = <0>;
regulator-over-current-protection;
lp-stop {
regulator-on-in-suspend;
regulator-suspend-microvolt = <1200000>;
};
lplv-stop {
regulator-on-in-suspend;
regulator-suspend-microvolt = <900000>;
};
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vdd_ddr: buck2 {
regulator-name = "vdd_ddr";
regulator-min-microvolt = <1350000>;
regulator-max-microvolt = <1350000>;
regulator-always-on;
regulator-initial-mode = <0>;
regulator-over-current-protection;
lp-stop {
regulator-suspend-microvolt = <1350000>;
regulator-on-in-suspend;
};
lplv-stop {
regulator-suspend-microvolt = <1350000>;
regulator-on-in-suspend;
};
standby-ddr-sr {
regulator-suspend-microvolt = <1350000>;
regulator-on-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vdd: buck3 {
regulator-name = "vdd";
regulator-min-microvolt = <3300000>;
regulator-max-microvolt = <3300000>;
regulator-always-on;
st,mask-reset;
regulator-initial-mode = <0>;
regulator-over-current-protection;
lp-stop {
regulator-suspend-microvolt = <3300000>;
regulator-on-in-suspend;
};
lplv-stop {
regulator-suspend-microvolt = <3300000>;
regulator-on-in-suspend;
};
standby-ddr-sr {
regulator-suspend-microvolt = <3300000>;
regulator-on-in-suspend;
};
standby-ddr-off {
regulator-suspend-microvolt = <3300000>;
regulator-on-in-suspend;
};
};
v3v3: buck4 {
regulator-name = "v3v3";
regulator-min-microvolt = <3300000>;
regulator-max-microvolt = <3300000>;
regulator-always-on;
regulator-over-current-protection;
regulator-initial-mode = <0>;
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vdda: ldo1 {
regulator-name = "vdda";
regulator-min-microvolt = <2900000>;
regulator-max-microvolt = <2900000>;
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
v2v8: ldo2 {
regulator-name = "v2v8";
regulator-min-microvolt = <2800000>;
regulator-max-microvolt = <2800000>;
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vtt_ddr: ldo3 {
regulator-name = "vtt_ddr";
regulator-min-microvolt = <500000>;
regulator-max-microvolt = <750000>;
regulator-always-on;
regulator-over-current-protection;
lp-stop {
regulator-off-in-suspend;
};
lplv-stop {
regulator-off-in-suspend;
};
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vdd_usb: ldo4 {
regulator-name = "vdd_usb";
regulator-min-microvolt = <3300000>;
regulator-max-microvolt = <3300000>;
regulator-always-on;
standby-ddr-sr {
regulator-on-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vdd_sd: ldo5 {
regulator-name = "vdd_sd";
regulator-min-microvolt = <2900000>;
regulator-max-microvolt = <2900000>;
regulator-boot-on;
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
v1v8: ldo6 {
regulator-name = "v1v8";
regulator-min-microvolt = <1800000>;
regulator-max-microvolt = <1800000>;
standby-ddr-sr {
regulator-off-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
vref_ddr: vref_ddr {
regulator-name = "vref_ddr";
regulator-always-on;
regulator-over-current-protection;
lp-stop {
regulator-on-in-suspend;
};
lplv-stop {
regulator-on-in-suspend;
};
standby-ddr-sr {
regulator-on-in-suspend;
};
standby-ddr-off {
regulator-off-in-suspend;
};
};
bst_out: boost {
regulator-name = "bst_out";
};
vbus_otg: pwr_sw1 {
regulator-name = "vbus_otg";
};
vbus_sw: pwr_sw2 {
regulator-name = "vbus_sw";
regulator-active-discharge = <1>;
};
};
};
};
&iwdg2 {
timeout-sec = <32>;
status = "okay";
secure-status = "okay";
};
&nvmem_layout {
nvmem-cells = <&cfg0_otp>,
<&part_number_otp>,
<&monotonic_otp>,
<&nand_otp>,
<&uid_otp>,
<&package_otp>,
<&hw2_otp>,
<&pkh_otp>,
<&board_id>;
nvmem-cell-names = "cfg0_otp",
"part_number_otp",
"monotonic_otp",
"nand_otp",
"uid_otp",
"package_otp",
"hw2_otp",
"pkh_otp",
"board_id";
};
&pwr_regulators {
system_suspend_supported_soc_modes = <
STM32_PM_CSLEEP_RUN
STM32_PM_CSTOP_ALLOW_LP_STOP
STM32_PM_CSTOP_ALLOW_LPLV_STOP
STM32_PM_CSTOP_ALLOW_STANDBY_DDR_SR
>;
system_off_soc_mode = <STM32_PM_CSTOP_ALLOW_STANDBY_DDR_OFF>;
vdd-supply = <&vdd>;
vdd_3v3_usbfs-supply = <&vdd_usb>;
};
&rcc {
st,hsi-cal;
st,csi-cal;
st,cal-sec = <60>;
st,clksrc = <
CLK_MPU_PLL1P
CLK_AXI_PLL2P
CLK_MCU_PLL3P
CLK_PLL12_HSE
CLK_PLL3_HSE
CLK_PLL4_HSE
CLK_RTC_LSE
CLK_MCO1_DISABLED
CLK_MCO2_DISABLED
>;
st,clkdiv = <
1 /*MPU*/
0 /*AXI*/
0 /*MCU*/
1 /*APB1*/
1 /*APB2*/
1 /*APB3*/
1 /*APB4*/
2 /*APB5*/
23 /*RTC*/
0 /*MCO1*/
0 /*MCO2*/
>;
st,pkcs = <
CLK_CKPER_HSE
CLK_FMC_ACLK
CLK_QSPI_ACLK
CLK_ETH_DISABLED
CLK_SDMMC12_PLL4P
CLK_DSI_DSIPLL
CLK_STGEN_HSE
CLK_USBPHY_HSE
CLK_SPI2S1_PLL3Q
CLK_SPI2S23_PLL3Q
CLK_SPI45_HSI
CLK_SPI6_HSI
CLK_I2C46_HSI
CLK_SDMMC3_PLL4P
CLK_USBO_USBPHY
CLK_ADC_CKPER
CLK_CEC_LSE
CLK_I2C12_HSI
CLK_I2C35_HSI
CLK_UART1_HSI
CLK_UART24_HSI
CLK_UART35_HSI
CLK_UART6_HSI
CLK_UART78_HSI
CLK_SPDIF_PLL4P
CLK_FDCAN_PLL4R
CLK_SAI1_PLL3Q
CLK_SAI2_PLL3Q
CLK_SAI3_PLL3Q
CLK_SAI4_PLL3Q
CLK_RNG1_LSI
CLK_RNG2_LSI
CLK_LPTIM1_PCLK1
CLK_LPTIM23_PCLK3
CLK_LPTIM45_LSE
>;
/* VCO = 1066.0 MHz => P = 266 (AXI), Q = 533 (GPU), R = 533 (DDR) */
pll2: st,pll@1 {
compatible = "st,stm32mp1-pll";
reg = <1>;
cfg = <2 65 1 0 0 PQR(1,1,1)>;
frac = <0x1400>;
};
/* VCO = 417.8 MHz => P = 209, Q = 24, R = 11 */
pll3: st,pll@2 {
compatible = "st,stm32mp1-pll";
reg = <2>;
cfg = <1 33 1 16 36 PQR(1,1,1)>;
frac = <0x1a04>;
};
/* VCO = 594.0 MHz => P = 99, Q = 74, R = 74 */
pll4: st,pll@3 {
compatible = "st,stm32mp1-pll";
reg = <3>;
cfg = <3 98 5 7 7 PQR(1,1,1)>;
};
};
&rng1 {
status = "okay";
secure-status = "okay";
};
&rtc {
status = "okay";
secure-status = "okay";
};
&sdmmc1 {
pinctrl-names = "default";
pinctrl-0 = <&sdmmc1_b4_pins_a &sdmmc1_dir_pins_a>;
disable-wp;
st,sig-dir;
st,neg-edge;
st,use-ckin;
bus-width = <4>;
vmmc-supply = <&vdd_sd>;
sd-uhs-sdr12;
sd-uhs-sdr25;
sd-uhs-sdr50;
sd-uhs-ddr50;
sd-uhs-sdr104;
status = "okay";
};
&sdmmc2 {
pinctrl-names = "default";
pinctrl-0 = <&sdmmc2_b4_pins_a &sdmmc2_d47_pins_a>;
non-removable;
no-sd;
no-sdio;
st,neg-edge;
bus-width = <8>;
vmmc-supply = <&v3v3>;
vqmmc-supply = <&vdd>;
mmc-ddr-3_3v;
status = "okay";
};
&timers15 {
secure-status = "okay";
st,hsi-cal-input = <7>;
st,csi-cal-input = <8>;
};
&uart4 {
pinctrl-names = "default";
pinctrl-0 = <&uart4_pins_a>;
status = "okay";
};
&usbotg_hs {
vbus-supply = <&vbus_otg>;
};
&usbphyc_port0 {
phy-supply = <&vdd_usb>;
};
&usbphyc_port1 {
phy-supply = <&vdd_usb>;
};
10、在VSCode中，打开设备树文件“stm32mp157d-atk.dts”将第12行的“stm32mp15xx-edx.dtsi”修改为“stm32mp157d-atk.dtsi”；
点击“文件”，再点击“保存(S)”；
见下图：
11、回到终端，
输入“cd ..回车”，退回到“tf-a-stm32mp-2.2.r1”目录；
输入“ls回车”，列出“tf-a-stm32mp-2.2.r1”目录下所有的文件和文件夹；
输入“cd ..回车”，退回到“my-tfa”目录
输入“ls回车”，列出“my-tfa”目录下所有的文件和文件夹；
输入“vim Makefile.sdk回车”，使用vim命令打开已有的“Makefile.sdk”文件，见下图：
“Makefile.sdk”文件见下图：
12、创建新的设备树名字“stm32mp157d-atk”
将“stm32mp157d-atk”添加到TFA DEVICETREE 配置项中；
见下图：
13、按“ESC键”+“:wq键”，保存退出。
14、输入“cd tf-a-stm32mp-2.2.r1/回车”，进入到“tf-a-stm32mp-2.2.r1”目录下；
输入“ls回车”，列出“tf-a-stm32mp-2.2.r1”目录下所有的文件和文件夹；
输入“make -f ../Makefile.sdk all回车”, 执行编译， '-f'的意思是重新指定Makefile。
如果需要加快编译速度，可是使用多线程编译，线程数量最好和自己给虚拟机分配的物理核心保持一致，使用-j来指定线程数，命令如下：
make -f ../Makefile.sdk -j8 all //使用8线程编译
见下图：
14、输入“cd ..回车”返回到“my-tfa”目录
输入“ls回车”，列出“my-tfa”目录下所有的文件和文件夹；
输入“cd build/回车”，切换到“build”目录下；
输入“ls回车”，列出“build”目录下所有的文件和文件夹
输入“cd trusted/回车”，切换到“trusted”目录下；
输入“ls 回车”，列出当前目录下所有的文件和文件夹
编译成功,在“/linux/atk-mp1/my-tfa/build/trusted/”目录下,发现有以“tf-a-stm32mp157d-atk”开头的6个文件文件。
见下图：
至此，我们完成了TF-A移植第1步，新的设备树“stm32mp157d-atk”创建好了，接下来，我们要修改设备树，在下一节再讲，文章太长了，吃多了会无法消化。
