m5/LLM_buildroot-external-m5stack
0
0
Fork 0
mirror of https://github.com/m5stack/LLM_buildroot-external-m5stack.git synced 2026-05-20 11:34:12 -07:00
Code Issues Packages Projects Releases Wiki Activity
Files
81cab478f8d5aed10c5933d50489bf014f413caf
LLM_buildroot-external-m5stack/docs/stm32cubemx.md
T
dianjixz 71e5dd7589 [init]
2024-12-04 17:51:27 +08:00

8.0 KiB
Raw Blame History

Use devicetree generated by STM32CubeMX

Applicable platforms: STM32MP157-DK1, STM32MP157-DK2, STM32MP135-DK

The STM32CubeMX tool allows you to automatize the generation of devicetrees with an easy to use interface. You can configure the state of each pin of the STM32MP1 component from the pinout view. The tool generates Device Tree files for Linux, U-Boot, Arm-Trusted-Firmware (TF-A) and OPTEE-OS.

All our demo configurations in buildroot-external-st use Device Tree files generated by STM32CubeMX.

For the example in STM32CubeMX, create a test project, select the STM32MP157C DK2 board and click on "generate code". Then you will find in the test project directory the generated Device Tree for the Linux kernel, TF-A and U-Boot:

CA7/DeviceTree/test/kernel:
stm32mp157c-mx.dts

CA7/DeviceTree/test/tf-a:
stm32mp157c-mx.dts  stm32mp157c-mx-fw-config.dts  stm32mp15-mx.dtsi

CA7/DeviceTree/test/u-boot:
stm32mp157c-mx.dts  stm32mp157c-mx-u-boot.dtsi  stm32mp15-mx.dtsi

CA7/DeviceTree/test/optee-os:
stm32mp157c-mx.dts

The generated Device Tree files can then be copied in the BR2_EXTERNAL tree. Here we have chosen to create three folders named kernel-dts, uboot-dts and tfa-dts where we put the dedicated Device Tree files:

$ cp -a ${STM32CubeMX_output}/CA7/DeviceTree/test/kernel/* ${buildroot_external}/board/stmicroelectronics/stm32mp1/kernel-dts
$ cp -a ${STM32CubeMX_output}/CA7/DeviceTree/test/u-boot/* ${buildroot_external}/board/stmicroelectronics/stm32mp1/uboot-dts
$ cp -a ${STM32CubeMX_output}/CA7/DeviceTree/test/tf-a/* ${buildroot_external}/board/stmicroelectronics/stm32mp1/tfa-dts
$ cp -a ${STM32CubeMX_output}/CA7/DeviceTree/test/optee-os/* ${buildroot_external}/board/stmicroelectronics/stm32mp1/optee-dts

The same has been done for all STM32MP1 platforms to generate the different Device Tree files.

To use these Device Tree files in Buildroot you need to change the Buildroot configuration by updating the Device Tree name and the BR2_*_CUSTOM_DTS_PATH configurations (following the paths chosen), for the Linux kernel, U-Boot and TF-A. For example:

BR2_LINUX_KERNEL_INTREE_DTS_NAME="stm32mp157c-dk2-mx"
BR2_LINUX_KERNEL_CUSTOM_DTS_PATH="$(BR2_EXTERNAL_ST_PATH)/board/stmicroelectronics/stm32mp1/linux-dts/*"
BR2_TARGET_ARM_TRUSTED_FIRMWARE_CUSTOM_DTS_PATH="$(BR2_EXTERNAL_ST_PATH)/board/stmicroelectronics/stm32mp1/tfa-dts/*
BR2_TARGET_ARM_TRUSTED_FIRMWARE_ADDITIONAL_VARIABLES="STM32MP_SDMMC=1 AARCH32_SP=optee DTB_FILE_NAME=stm32mp157c-dk2-mx.dtb BL33_CFG=$(BINARIES_DIR)/u-boot.dtb"
BR2_TARGET_UBOOT_CUSTOM_DTS_PATH="$(BR2_EXTERNAL_ST_PATH)/board/stmicroelectronics/stm32mp1/uboot-dts/*"
BR2_TARGET_UBOOT_CUSTOM_MAKEOPTS="dtb-y=stm32mp157c-dk2-mx.dtb DEVICE_TREE=stm32mp157c-dk2-mx"
BR2_TARGET_OPTEE_OS_CUSTOM_DTS_PATH="$(BR2_EXTERNAL_ST_PATH)/board/stmicroelectronics/stm32mp1/optee-dts/*"
BR2_TARGET_OPTEE_OS_ADDITIONAL_VARIABLES="CFG_EMBED_DTB_SOURCE_FILE=stm32mp157c-dk2-mx.dts CFG_STM32MP15=y"

The option dtb-y=stm32mp157c-dk2-mx.dtb has been added to U-Boot make options to build the external Device Tree file. Same goes with CFG_EMBED_DTB_SOURCE_FILE=stm32mp157c-dk2-mx.dts CFG_STM32MP15=y for OPTEE-OS.

You might need to modify the post-image.sh script to use a different naming of the TF-A binary.

If Cube MX does not generated the devicetree as expected you can manually verify the content of them with the help of the Wiki from ST.

Note: the default Device Tree generated by STM32MPCubeMX for the DK2 has a known issue on the display pin muxing configuration. You need to add the pintcrl of the ltdc node in the devicetree. Here is the change to add to the stm32mp157c-dk2-mx.dts Device Tree to address this issue:

diff --git a/board/stmicroelectronics/stm32mp1/linux-dts/stm32mp157c-dk2-mx.dts b/board/stmicroelectronics/stm32mp1/linux-dts/stm32mp157c-dk2-mx.dts
index 0c3c6ac..eb54799 100644
--- a/board/stmicroelectronics/stm32mp1/linux-dts/stm32mp157c-dk2-mx.dts
+++ b/board/stmicroelectronics/stm32mp1/linux-dts/stm32mp157c-dk2-mx.dts
@@ -503,6 +503,74 @@
 	};
 
 	/* USER CODE BEGIN pinctrl */
+	ltdc_pins_a: ltdc-0 {
+		pins {
+			pinmux = <STM32_PINMUX('G',  7, AF14)>, /* LCD_CLK */
+				 <STM32_PINMUX('I', 10, AF14)>, /* LCD_HSYNC */
+				 <STM32_PINMUX('I',  9, AF14)>, /* LCD_VSYNC */
+				 <STM32_PINMUX('F', 10, AF14)>, /* LCD_DE */
+				 <STM32_PINMUX('H',  2, AF14)>, /* LCD_R0 */
+				 <STM32_PINMUX('H',  3, AF14)>, /* LCD_R1 */
+				 <STM32_PINMUX('H',  8, AF14)>, /* LCD_R2 */
+				 <STM32_PINMUX('H',  9, AF14)>, /* LCD_R3 */
+				 <STM32_PINMUX('H', 10, AF14)>, /* LCD_R4 */
+				 <STM32_PINMUX('C',  0, AF14)>, /* LCD_R5 */
+				 <STM32_PINMUX('H', 12, AF14)>, /* LCD_R6 */
+				 <STM32_PINMUX('E', 15, AF14)>, /* LCD_R7 */
+				 <STM32_PINMUX('E',  5, AF14)>, /* LCD_G0 */
+				 <STM32_PINMUX('E',  6, AF14)>, /* LCD_G1 */
+				 <STM32_PINMUX('H', 13, AF14)>, /* LCD_G2 */
+				 <STM32_PINMUX('H', 14, AF14)>, /* LCD_G3 */
+				 <STM32_PINMUX('H', 15, AF14)>, /* LCD_G4 */
+				 <STM32_PINMUX('I',  0, AF14)>, /* LCD_G5 */
+				 <STM32_PINMUX('I',  1, AF14)>, /* LCD_G6 */
+				 <STM32_PINMUX('I',  2, AF14)>, /* LCD_G7 */
+				 <STM32_PINMUX('D',  9, AF14)>, /* LCD_B0 */
+				 <STM32_PINMUX('G', 12, AF14)>, /* LCD_B1 */
+				 <STM32_PINMUX('G', 10, AF14)>, /* LCD_B2 */
+				 <STM32_PINMUX('D', 10, AF14)>, /* LCD_B3 */
+				 <STM32_PINMUX('I',  4, AF14)>, /* LCD_B4 */
+				 <STM32_PINMUX('A',  3, AF14)>, /* LCD_B5 */
+				 <STM32_PINMUX('B',  8, AF14)>, /* LCD_B6 */
+				 <STM32_PINMUX('D',  8, AF14)>; /* LCD_B7 */
+			bias-disable;
+			drive-push-pull;
+			slew-rate = <1>;
+		};
+	};
+
+	ltdc_sleep_pins_a: ltdc-sleep-0 {
+		pins {
+			pinmux = <STM32_PINMUX('G',  7, ANALOG)>, /* LCD_CLK */
+				 <STM32_PINMUX('I', 10, ANALOG)>, /* LCD_HSYNC */
+				 <STM32_PINMUX('I',  9, ANALOG)>, /* LCD_VSYNC */
+				 <STM32_PINMUX('F', 10, ANALOG)>, /* LCD_DE */
+				 <STM32_PINMUX('H',  2, ANALOG)>, /* LCD_R0 */
+				 <STM32_PINMUX('H',  3, ANALOG)>, /* LCD_R1 */
+				 <STM32_PINMUX('H',  8, ANALOG)>, /* LCD_R2 */
+				 <STM32_PINMUX('H',  9, ANALOG)>, /* LCD_R3 */
+				 <STM32_PINMUX('H', 10, ANALOG)>, /* LCD_R4 */
+				 <STM32_PINMUX('C',  0, ANALOG)>, /* LCD_R5 */
+				 <STM32_PINMUX('H', 12, ANALOG)>, /* LCD_R6 */
+				 <STM32_PINMUX('E', 15, ANALOG)>, /* LCD_R7 */
+				 <STM32_PINMUX('E',  5, ANALOG)>, /* LCD_G0 */
+				 <STM32_PINMUX('E',  6, ANALOG)>, /* LCD_G1 */
+				 <STM32_PINMUX('H', 13, ANALOG)>, /* LCD_G2 */
+				 <STM32_PINMUX('H', 14, ANALOG)>, /* LCD_G3 */
+				 <STM32_PINMUX('H', 15, ANALOG)>, /* LCD_G4 */
+				 <STM32_PINMUX('I',  0, ANALOG)>, /* LCD_G5 */
+				 <STM32_PINMUX('I',  1, ANALOG)>, /* LCD_G6 */
+				 <STM32_PINMUX('I',  2, ANALOG)>, /* LCD_G7 */
+				 <STM32_PINMUX('D',  9, ANALOG)>, /* LCD_B0 */
+				 <STM32_PINMUX('G', 12, ANALOG)>, /* LCD_B1 */
+				 <STM32_PINMUX('G', 10, ANALOG)>, /* LCD_B2 */
+				 <STM32_PINMUX('D', 10, ANALOG)>, /* LCD_B3 */
+				 <STM32_PINMUX('I',  4, ANALOG)>, /* LCD_B4 */
+				 <STM32_PINMUX('A',  3, ANALOG)>, /* LCD_B5 */
+				 <STM32_PINMUX('B',  8, ANALOG)>, /* LCD_B6 */
+				 <STM32_PINMUX('D',  8, ANALOG)>; /* LCD_B7 */
+		};
+	};
 	/* USER CODE END pinctrl */
 };
 
@@ -1060,6 +1128,9 @@
 	status = "okay";
 
 	/* USER CODE BEGIN ltdc */
+	pinctrl-names = "default", "sleep";
+	pinctrl-0 = <&ltdc_pins_a>;
+	pinctrl-1 = <&ltdc_sleep_pins_a>;
 
 	port{

Note: the default Device Tree generated by STM32MPCubeMX for the DK has two issues.

  • The rcc node configuration. You need to fix it by copying the rcc node from TF-A. See commit 8c8fe33 to view the change needed on the devicetree.

  • In the sdmmc1/2 nodes the vddsd1/2-supply parameters are missing. You need to fix by adding these parameters. See commit d0bdfba to view the change needed on the devicetree.

Reference in New Issue View Git Blame Copy Permalink