stm32mp1: initial support

Build OP-TEE for STM32MP1 based platforms. Currently supports platforms
STM32MP157A-DK1, STM32MP157C-DK2 and STM32MP157C-EV1 using a SDcard as
boot media.

Default build targets board STM32MP157C-DK2:
# make

One can specify a target board with PLATFORM configuration switch:
# make PLATFORM=stm32mp1-157A_DK1
# make PLATFORM=stm32mp1-157C_DK2
# make PLATFORM=stm32mp1-157C_EV1

Refer to br-ext/board/stmicroelectronics/stm32mp1-tz/readme.txt for
mode information.

TF-A, OP-TEE OS, U-Boot and Linux kernel are built outside Builrdoot.
All other embedded components are built through Buildroot.
Buildroot generates the final SDcard binary image file to be loaded
raw in the target SD card. The image includes a GPT partition table.
See br-ext/board/stmicroelectronics/stm32mp1-tz/genimage-*.cfg
for more details.

Note on U-Boot defconfig: from v2019.10 up to v2020.07-rc2, one shall
use stm32mp15_optee_defconfig. From v2020-rc3 onward, one shall use
stm32mp15_trusted_defconfig. For flexibility, stm32mp1.mk supports both.

Signed-off-by: Etienne Carriere <etienne.carriere@linaro.org>
Reviewed-by: Joakim Bech <joakim.bech@linaro.org>

br-ext/board/stmicroelectronics/stm32mp1-tz/genimage-STM32MP157A-DK1.cfg

+image sdcard.img {
+	hdimage {
+		gpt = "true"
+	}
+
+	partition fsbl1 {
+		image = "tf-a-stm32mp157a-dk1.stm32"
+		size = 256K
+	}
+
+	partition fsbl2 {
+		image = "tf-a-stm32mp157a-dk1.stm32"
+		size = 256K
+	}
+
+	partition ssbl {
+		image = "u-boot.stm32"
+		size = 2M
+	}
+
+	partition teeh {
+		image = "tee-header_v2.stm32"
+		size = 32K
+	}
+
+	partition teed {
+		image = "tee-pageable_v2.stm32"
+		size = 512K
+	}
+
+	partition teex {
+		image = "tee-pager_v2.stm32"
+		size = 128K
+	}
+
+	partition bootfs {
+		image = "bootfs.ext2"
+		partition-type = 0x83
+		size = 32M
+		bootable = "yes"
+	}
+
+	partition rootfs {
+		image = "rootfs.ext2"
+		partition-type = 0x83
+		size = 128M
+	}
+}

br-ext/board/stmicroelectronics/stm32mp1-tz/genimage-STM32MP157C-DK2.cfg

+image sdcard.img {
+	hdimage {
+		gpt = "true"
+	}
+
+	partition fsbl1 {
+		image = "tf-a-stm32mp157c-dk2.stm32"
+		size = 256K
+	}
+
+	partition fsbl2 {
+		image = "tf-a-stm32mp157c-dk2.stm32"
+		size = 256K
+	}
+
+	partition ssbl {
+		image = "u-boot.stm32"
+		size = 2M
+	}
+
+	partition teeh {
+		image = "tee-header_v2.stm32"
+		size = 32K
+	}
+
+	partition teed {
+		image = "tee-pageable_v2.stm32"
+		size = 512K
+	}
+
+	partition teex {
+		image = "tee-pager_v2.stm32"
+		size = 128K
+	}
+
+	partition bootfs {
+		image = "bootfs.ext2"
+		partition-type = 0x83
+		size = 32M
+		bootable = "yes"
+	}
+
+	partition rootfs {
+		image = "rootfs.ext2"
+		partition-type = 0x83
+		size = 128M
+	}
+}

br-ext/board/stmicroelectronics/stm32mp1-tz/genimage-STM32MP157C-EV1.cfg

+image sdcard.img {
+	hdimage {
+		gpt = "true"
+	}
+
+	partition fsbl1 {
+		image = "tf-a-stm32mp157c-ev1.stm32"
+		size = 256K
+	}
+
+	partition fsbl2 {
+		image = "tf-a-stm32mp157c-ev1.stm32"
+		size = 256K
+	}
+
+	partition ssbl {
+		image = "u-boot.stm32"
+		size = 2M
+	}
+
+	partition teeh {
+		image = "tee-header_v2.stm32"
+		size = 32K
+	}
+
+	partition teed {
+		image = "tee-pageable_v2.stm32"
+		size = 512K
+	}
+
+	partition teex {
+		image = "tee-pager_v2.stm32"
+		size = 128K
+	}
+
+	partition bootfs {
+		image = "rootfs.ext2"
+		partition-type = 0x83
+		size = 32M
+		bootable = "yes"
+	}
+
+	partition rootfs {
+		image = "rootfs.ext2"
+		partition-type = 0x83
+		size = 100M
+	}
+}

br-ext/board/stmicroelectronics/stm32mp1-tz/overlay-STM32MP157A-DK1/boot/extlinux/extlinux.conf

+TIMEOUT 20
+DEFAULT stm32mp15-buildroot
+LABEL stm32mp15-buildroot
+  kernel /boot/uImage
+  devicetree /boot/stm32mp157a-dk1.dtb
+  append root=/dev/mmcblk0p8 rootwait rw console=ttySTM0,115200

br-ext/board/stmicroelectronics/stm32mp1-tz/overlay-STM32MP157C-DK2/boot/extlinux/extlinux.conf

+TIMEOUT 20
+DEFAULT stm32mp15-buildroot
+LABEL stm32mp15-buildroot
+  kernel /boot/uImage
+  devicetree /boot/stm32mp157c-dk2.dtb
+  append root=/dev/mmcblk0p8 rootwait rw console=ttySTM0,115200

br-ext/board/stmicroelectronics/stm32mp1-tz/overlay-STM32MP157C-EV1/boot/extlinux/extlinux.conf

+TIMEOUT 20
+DEFAULT stm32mp15-buildroot
+LABEL stm32mp15-buildroot
+  kernel /boot/uImage
+  devicetree /boot/stm32mp157c-ev1.dtb
+  append root=/dev/mmcblk0p8 rootwait rw console=ttySTM0,115200

br-ext/board/stmicroelectronics/stm32mp1-tz/post-image.sh

+#!/bin/sh
+
+die() {
+	cat <<EOF >&2
+Error: $@
+
+Usage: ${0} IMG_DIR GENIMAGE_CFG EXT_BIN_DIR [BOOTFS_OVERLAY]
+EOF
+	exit 1
+}
+
+echo "Creating bootfs image"
+echo "- image directory path: ${1}" # Generic argument set by Buildroot
+echo "- genimage config file: ${2}"
+echo "- external bins path:   ${3}"
+echo "- bootfs overlay path:  ${4}"
+
+[ ! -z "${2}" -a -e ${2} ] || die "Error: missing argument genimage config file"
+[ ! -z "${3}" -a -d ${3} ] || die "Error: missing argument external binaries dir"
+[ -z "${4}" -o -d ${4} ] || die "Error: invalid bootfs overlay directory path"
+
+GENIMAGE_TMP="${BUILD_DIR}/genimage.tmp"
+
+# Create target bootfs filesystem
+# - Copy uImage and DTBs from path provided in arg $3 into boot/
+# - Copy bootfs overlay filetree from path provided in optional arg $4
+
+BOOTFS_DIR=${BASE_DIR}/target-bootfs
+rm -f ${BINARIES_DIR}/bootfs.ext2 || exit 1
+rm -rf ${BOOTFS_DIR} && mkdir -p ${BOOTFS_DIR}/boot || exit 1
+cp ${3}/uImage ${BOOTFS_DIR}/boot || exit 1
+cp ${3}/*.dtb ${BOOTFS_DIR}/boot || exit 1
+[ -z "${4}" ] || { cp -ar ${4}/* ${BOOTFS_DIR} || exit 1; }
+
+mkfs.ext2 -L bootfs -d ${BOOTFS_DIR} ${BINARIES_DIR}/bootfs.ext2 32M || exit 1
+
+# Generate image from generated partition images and genimage config file
+
+rm -rf "${GENIMAGE_TMP}"
+
+genimage --rootpath "${ROOTPATH_TMP}" \
+         --tmppath "${GENIMAGE_TMP}" \
+         --inputpath "${BINARIES_DIR}" \
+         --outputpath "${BINARIES_DIR}" \
+         --config ${2}

br-ext/board/stmicroelectronics/stm32mp1-tz/readme.txt

+STM32MP1 Based platforms
+
+Intro
+=====
+
+This directory provides support for few STM32MP1 based development boards.
+
+  https://www.st.com/en/evaluation-tools/stm32mp157a-dk1.html
+  https://www.st.com/en/evaluation-tools/stm32mp157c-dk2.html
+  https://www.st.com/en/evaluation-tools/stm32mp157c-ev1.html
+
+How to build
+============
+
+From OP-TEE build repository:
+
+ $ make PLATFORM=stm32mp1-157A_DK1 all
+or
+ $ make PLATFORM=stm32mp1-157C_DK2 all
+or
+ $ make PLATFORM=stm32mp1-157C_EV1 all
+
+How to write the microSD card
+=============================
+
+Once the build process is finished you will have an image called
+"sdcard.img" in directory ../out-br/images/ (relative to build
+repository root path).
+
+Copy the bootable "sdcard.img" onto an microSD card with "dd":
+
+  $ sudo dd if=../out-br/images/sdcard.img of=/dev/sdX \
+	    conv=fdatasync status=progress
+
+Boot the board
+==============
+
+ (1) Insert the microSD card in connector CN15
+
+ (2) Plug a micro-USB cable in connector CN11 and run your serial
+     communication program on /dev/ttyACM0.
+
+ (3) Plug a USB-C cable in CN6 to power-up the board.
+
+ (4) The system will start, with the console on UART. Both secure
+     and non-secure console consoles are on the same UART bus.

kconfigs/stm32mp1.conf

+CONFIG_TEE=y
+CONFIG_OPTEE=y

stm32mp1.mk

+################################################################################
+# Following variables defines how the NS_USER (Non Secure User - Client
+# Application), NS_KERNEL (Non Secure Kernel), S_KERNEL (Secure Kernel) and
+# S_USER (Secure User - TA) are compiled
+################################################################################
+override COMPILE_NS_USER   := 32
+override COMPILE_NS_KERNEL := 32
+override COMPILE_S_USER    := 32
+override COMPILE_S_KERNEL  := 32
+
+PLATFORM ?= stm32mp1-157C_DK2
+OPTEE_OS_PLATFORM := $(PLATFORM)
+
+include common.mk
+
+ifeq ($(PLATFORM),stm32mp1-157A_DK1)
+BREXT_FLAVOR		= STM32MP157A-DK1
+STM32MP1_DTS_BASENAME	= stm32mp157a-dk1
+else ifeq ($(PLATFORM),stm32mp1-157C_DK2)
+BREXT_FLAVOR		= STM32MP157C-DK2
+STM32MP1_DTS_BASENAME	= stm32mp157c-dk2
+else ifeq ($(PLATFORM),stm32mp1-157C_EV1)
+BREXT_FLAVOR		= STM32MP157C-EV1
+STM32MP1_DTS_BASENAME	= stm32mp157c-ev1
+else
+$(error Unknown PLATFORM $(PLATFORM))
+endif
+
+################################################################################
+# Binary images names
+################################################################################
+
+TFA_BIN			:= tf-a-$(STM32MP1_DTS_BASENAME).stm32
+OPTEE_HEADER_BIN	:= tee-header_v2.stm32
+OPTEE_PAGER_BIN		:= tee-pager_v2.stm32
+OPTEE_PAGEABLE_BIN  	:= tee-pageable_v2.stm32
+U_BOOT_BIN		:= u-boot.stm32
+LINUX_KERNEL_BIN 	:= uImage
+LINUX_DTB_BIN		:= $(STM32MP1_DTS_BASENAME).dtb
+
+################################################################################
+# Paths to git projects and various binaries
+################################################################################
+BINARIES_PATH		?= $(ROOT)/out/bin
+TFA_PATH		?= $(ROOT)/trusted-firmware-a
+U_BOOT_PATH		?= $(ROOT)/u-boot
+
+define install_in_binaries
+	echo "  INSTALL $(shell basename $1) to $(BINARIES_PATH)" && \
+	mkdir -p $(BINARIES_PATH) && \
+	ln -sf $1 $(BINARIES_PATH)
+endef
+
+################################################################################
+# Main targets
+################################################################################
+all: tfa optee-os u-boot linux buildroot
+	@$(call install_in_binaries,$(ROOT)/out-br/images/sdcard.img)
+	@echo Build for platform $(PLATFORM) completed
+
+clean: tfa-clean optee-os-clean u-boot-clean linux-clean buildroot-clean \
+       check-clean
+
+include toolchain.mk
+
+################################################################################
+# OP-TEE OS
+################################################################################
+optee-os: optee-os-common
+	@$(call install_in_binaries,$(OPTEE_OS_PATH)/out/arm/core/$(OPTEE_HEADER_BIN))
+	@$(call install_in_binaries,$(OPTEE_OS_PATH)/out/arm/core/$(OPTEE_PAGER_BIN))
+	@$(call install_in_binaries,$(OPTEE_OS_PATH)/out/arm/core/$(OPTEE_PAGEABLE_BIN))
+
+optee-os-clean: optee-os-clean-common
+
+################################################################################
+# TrustedFirmware-A
+################################################################################
+TFA_EXPORTS ?= CROSS_COMPILE="$(CCACHE)$(AARCH32_CROSS_COMPILE)"
+
+TFA_DEBUG ?= $(DEBUG)
+ifeq ($(TFA_DEBUG),0)
+TFA_LOGLVL ?= 30
+TFA_OUT = $(TFA_PATH)/build/stm32mp1/release
+else
+TFA_LOGLVL ?= 50
+TFA_OUT = $(TFA_PATH)/build/stm32mp1/debug
+endif
+
+TFA_FLAGS ?= \
+	BL32=$(BINARIES_PATH)/$(OPTEE_HEADER_BIN) \
+	BL32_EXTRA1=$(BINARIES_PATH)/$(OPTEE_PAGER_BIN) \
+	BL32_EXTRA2=$(BINARIES_PATH)/$(OPTEE_PAGEABLE_BIN) \
+	BL33=$(BINARIES_PATH)/$(U_BOOT_BIN) \
+	ARM_ARCH_MAJOR=7 \
+	ARCH=aarch32 \
+	PLAT=stm32mp1 \
+	DTB_FILE_NAME=$(STM32MP1_DTS_BASENAME).dtb \
+	AARCH32_SP=optee \
+	DEBUG=$(TFA_DEBUG) \
+	LOG_LEVEL=$(TFA_LOGLVL) \
+	STM32MP_EMMC=1 STM32MP_SDMMC=1 \
+	STM32MP_RAW_NAND=0 STM32MP_SPI_NAND=0 STM32MP_SPI_NOR=0
+
+tfa: optee-os u-boot
+	$(TFA_EXPORTS) $(MAKE) -C $(TFA_PATH) $(TFA_FLAGS) all
+	@$(call install_in_binaries,$(TFA_OUT)/$(TFA_BIN))
+
+tfa-clean:
+	$(TFA_EXPORTS) $(MAKE) -C $(TFA_PATH) $(TFA_FLAGS) clean
+
+################################################################################
+# U-Boot
+################################################################################
+U_BOOT_EXPORTS ?= CROSS_COMPILE="$(CCACHE)$(AARCH32_CROSS_COMPILE)"
+
+# Use stm32mp15_optee_defconfig up to U-Boot v2020.07-rc2.
+# Use stm32mp15_trusted_defconfig from v2020.07-rc3 onward.
+u-boot:
+ifneq ($(wildcard $(U_BOOT_PATH)/configs/stm32mp15_optee_defconfig),)
+	$(U_BOOT_EXPORTS) $(MAKE) -C $(U_BOOT_PATH) stm32mp15_optee_defconfig
+else
+	$(U_BOOT_EXPORTS) $(MAKE) -C $(U_BOOT_PATH) stm32mp15_trusted_defconfig
+endif
+	$(U_BOOT_EXPORTS) $(MAKE) -C $(U_BOOT_PATH) DEVICE_TREE=$(STM32MP1_DTS_BASENAME) all
+	@$(call install_in_binaries,$(U_BOOT_PATH)/$(U_BOOT_BIN))
+
+u-boot-clean:
+	$(U_BOOT_EXPORTS) $(MAKE) -C $(U_BOOT_PATH) clean
+
+################################################################################
+# Linux kernel
+################################################################################
+LINUX_DEFCONFIG_COMMON_ARCH := arm
+LINUX_DEFCONFIG_COMMON_FILES := \
+		$(LINUX_PATH)/arch/arm/configs/multi_v7_defconfig \
+		$(CURDIR)/kconfigs/stm32mp1.conf
+
+linux-defconfig: $(LINUX_PATH)/.config
+
+LINUX_COMMON_FLAGS += ARCH=arm uImage LOADADDR=0xc2000000 \
+		      CROSS_COMPILE=$(CROSS_COMPILE_NS_KERNEL) \
+		      $(STM32MP1_DTS_BASENAME).dtb \
+		      PATH=$$PATH:$(U_BOOT_PATH)/tools
+
+linux: linux-common
+	@$(call install_in_binaries,$(LINUX_PATH)/arch/arm/boot/$(LINUX_KERNEL_BIN))
+	@$(call install_in_binaries,$(LINUX_PATH)/arch/arm/boot/dts/$(LINUX_DTB_BIN))
+
+linux-defconfig-clean: linux-defconfig-clean-common
+
+LINUX_CLEAN_COMMON_FLAGS += ARCH=arm
+
+linux-clean: linux-clean-common
+
+LINUX_CLEANER_COMMON_FLAGS += ARCH=arm
+
+linux-cleaner: linux-cleaner-common
+
+################################################################################
+# Buildroot
+################################################################################
+
+BR2_TARGET_GENERIC_ISSUE="OP-TEE embedded distrib for $(PLATFORM)"
+BR2_TARGET_GENERIC_GETTY_PORT=ttySTM0
+BR2_TARGET_ROOTFS_EXT2=y
+BR2_PACKAGE_BUSYBOX_WATCHDOG=y
+
+BREXT_BOARD_PATH=$(ROOT)/build/br-ext/board/stmicroelectronics/stm32mp1-tz
+BREXT_GENIMAGE_CONFIG=$(BREXT_BOARD_PATH)/genimage-$(BREXT_FLAVOR).cfg
+BREXT_BOOTFS_OVERLAY=$(BREXT_BOARD_PATH)/overlay-$(BREXT_FLAVOR)
+
+BR2_PACKAGE_HOST_GENIMAGE=y
+BR2_ROOTFS_POST_SCRIPT_ARGS="$(BREXT_GENIMAGE_CONFIG) $(BINARIES_PATH) $(BREXT_BOOTFS_OVERLAY)"
+BR2_ROOTFS_POST_IMAGE_SCRIPT=$(BREXT_BOARD_PATH)/post-image.sh
+
+# TF-A, Linux kernel, U-Boot and OP-TEE OS/Client/... are not built from their
+# related Buildroot native package.
+BR2_TARGET_ARM_TRUSTED_FIRMWARE=n
+BR2_LINUX_KERNEL=n
+BR2_TARGET_OPTEE_OS=n
+BR2_TARGET_UBOOT=n
+BR2_PACKAGE_OPTEE_CLIENT=n
+BR2_PACKAGE_OPTEE_TEST=n
+BR2_PACKAGE_OPTEE_EXAMPLES=n
+BR2_PACKAGE_OPTEE_BENCHMARK=n
+
+################################################################################
+# We build the SD card image from Builroot but TF-A, OP-TEE OS, U-Boot and
+# Linux kernel are build outside Buildroot. The get a clear picture of built
+# images, images built outside Buildroot are installed (ln -s) in BINARIES_PATH
+# and copied (cp -f) to Buildroot output images/ directory before make taget
+# buildroot is processed.
+################################################################################
+define install_in_br_images
+	cp -f $(BINARIES_PATH)/$1 $(ROOT)/out-br/images
+endef
+
+.PHONY: optee-os optee-os-clean
+.PHONY: u-boot u-boot-clean
+.PHONY: copy_images_to_br
+
+buildroot: copy_images_to_br
+copy_images_to_br: tfa optee-os u-boot linux
+	@mkdir -p $(ROOT)/out-br/images
+	$(call install_in_br_images,$(TFA_BIN))
+	$(call install_in_br_images,$(U_BOOT_BIN))
+	$(call install_in_br_images,$(LINUX_KERNEL_BIN))
+	$(call install_in_br_images,$(LINUX_DTB_BIN))
+	$(call install_in_br_images,$(OPTEE_HEADER_BIN))
+	$(call install_in_br_images,$(OPTEE_PAGER_BIN))
+	$(call install_in_br_images,$(OPTEE_PAGEABLE_BIN))