123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750 |
- .. SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause
- .. sectionauthor:: Patrick Delaunay <patrick.delaunay@foss.st.com>
- STM32MP15x boards
- =================
- This is a quick instruction for setup STM32MP15x boards.
- Futher information can be found in STMicrolectronics STM32 WIKI_.
- Supported devices
- -----------------
- U-Boot supports STMP32MP15x SoCs:
- - STM32MP157
- - STM32MP153
- - STM32MP151
- The STM32MP15x is a Cortex-A MPU aimed at various applications.
- It features:
- - Dual core Cortex-A7 application core (Single on STM32MP151)
- - 2D/3D image composition with GPU (only on STM32MP157)
- - Standard memories interface support
- - Standard connectivity, widely inherited from the STM32 MCU family
- - Comprehensive security support
- Each line comes with a security option (cryptography & secure boot) and
- a Cortex-A frequency option:
- - A : Cortex-A7 @ 650 MHz
- - C : Secure Boot + HW Crypto + Cortex-A7 @ 650 MHz
- - D : Cortex-A7 @ 800 MHz
- - F : Secure Boot + HW Crypto + Cortex-A7 @ 800 MHz
- Everything is supported in Linux but U-Boot is limited to:
- 1. UART
- 2. SD card/MMC controller (SDMMC)
- 3. NAND controller (FMC)
- 4. NOR controller (QSPI)
- 5. USB controller (OTG DWC2)
- 6. Ethernet controller
- And the necessary drivers
- 1. I2C
- 2. STPMIC1 (PMIC and regulator)
- 3. Clock, Reset, Sysreset
- 4. Fuse
- Currently the following boards are supported:
- + stm32mp157a-dk1.dts
- + stm32mp157c-dk2.dts
- + stm32mp157c-ed1.dts
- + stm32mp157c-ev1.dts
- + stm32mp15xx-dhcor-avenger96.dts
- Boot Sequences
- --------------
- 2 boot configurations are supported with:
- +----------+------------------------+-------------------------+--------------+
- | **ROM** | **FSBL** | **SSBL** | **OS** |
- + **code** +------------------------+-------------------------+--------------+
- | | First Stage Bootloader | Second Stage Bootloader | Linux Kernel |
- + +------------------------+-------------------------+--------------+
- | | embedded RAM | DDR |
- +----------+------------------------+-------------------------+--------------+
- The **Trusted** boot chain with TF-A_
- `````````````````````````````````````
- defconfig_file :
- + **stm32mp15_defconfig** (for TF-A_ with FIP support)
- + **stm32mp15_trusted_defconfig** (for TF-A_ without FIP support)
- +-------------+--------------------------+------------+-------+
- | ROM code | FSBL | SSBL | OS |
- + +--------------------------+------------+-------+
- | |Trusted Firmware-A (TF-A_)| U-Boot | Linux |
- +-------------+--------------------------+------------+-------+
- | TrustZone |secure monitor = SPMin or OP-TEE_ |
- +-------------+--------------------------+------------+-------+
- TF-A_ and OP-TEE_ are 2 separate projects, with their git repository;
- they are compiled separately.
- TF-A_ (BL2) initialize the DDR and loads the next stage binaries from a FIP file:
- + BL32: a secure monitor BL32 = SPMin provided by TF-A_ or OP-TEE_ :
- performs a full initialization of Secure peripherals and provides service
- to normal world
- + BL33: a non-trusted firmware = U-Boot, running in normal world and uses
- the secure monitor to access to secure resources.
- + HW_CONFIG: The hardware configuration file = the U-Boot device tree
- The **Basic** boot chain with SPL
- `````````````````````````````````
- defconfig_file :
- + **stm32mp15_basic_defconfig**
- +-------------+------------+------------+-------+
- | ROM code | FSBL | SSBL | OS |
- + +------------+------------+-------+
- | |U-Boot SPL | U-Boot | Linux |
- +-------------+------------+------------+-------+
- | TrustZone | | PSCI from U-Boot |
- +-------------+------------+------------+-------+
- SPL has limited security initialization.
- U-Boot is running in secure mode and provide a secure monitor to the kernel
- with only PSCI support (Power State Coordination Interface defined by ARM).
- All the STM32MP15x boards supported by U-Boot use the same generic board
- stm32mp1 which support all the bootable devices.
- Each board is configured only with the associated device tree.
- Device Tree Selection
- ---------------------
- You need to select the appropriate device tree for your board,
- the supported device trees for STM32MP15x are:
- + ev1: eval board with pmic stpmic1 (ev1 = mother board + daughter ed1)
- + stm32mp157c-ev1
- + ed1: daughter board with pmic stpmic1
- + stm32mp157c-ed1
- + dk1: Discovery board
- + stm32mp157a-dk1
- + dk2: Discovery board = dk1 with a BT/WiFI combo and a DSI panel
- + stm32mp157c-dk2
- + avenger96: Avenger96 board from Arrow Electronics based on DH Elec. DHCOR SoM
- + stm32mp15xx-dhcor-avenger96
- Build Procedure
- ---------------
- 1. Install the required tools for U-Boot
- * install package needed in U-Boot makefile
- (libssl-dev, swig, libpython-dev...)
- * install ARMv7 toolchain for 32bit Cortex-A (from Linaro,
- from SDK for STM32MP15x, or any crosstoolchains from your distribution)
- (you can use any gcc cross compiler compatible with U-Boot)
- 2. Set the cross compiler::
- # export CROSS_COMPILE=/path/to/toolchain/arm-linux-gnueabi-
- 3. Select the output directory (optional)::
- # export KBUILD_OUTPUT=/path/to/output
- for example: use one output directory for each configuration::
- # export KBUILD_OUTPUT=stm32mp15
- # export KBUILD_OUTPUT=stm32mp15_trusted
- # export KBUILD_OUTPUT=stm32mp15_basic
- you can build outside of code directory::
- # export KBUILD_OUTPUT=../build/stm32mp15
- 4. Configure U-Boot::
- # make <defconfig_file>
- with <defconfig_file>:
- - For **trusted** boot mode : **stm32mp15_defconfig** or
- stm32mp15_trusted_defconfig
- - For basic boot mode: stm32mp15_basic_defconfig
- 5. Configure the device-tree and build the U-Boot image::
- # make DEVICE_TREE=<name> all
- Examples:
- a) trusted boot with FIP on ev1::
- # export KBUILD_OUTPUT=stm32mp15
- # make stm32mp15_defconfig
- # make DEVICE_TREE=stm32mp157c-ev1 all
- b) trusted boot without FIP on dk2::
- # export KBUILD_OUTPUT=stm32mp15_trusted
- # make stm32mp15_trusted_defconfig
- # make DEVICE_TREE=stm32mp157c-dk2 all
- c) basic boot on ev1::
- # export KBUILD_OUTPUT=stm32mp15_basic
- # make stm32mp15_basic_defconfig
- # make DEVICE_TREE=stm32mp157c-ev1 all
- d) basic boot on ed1::
- # export KBUILD_OUTPUT=stm32mp15_basic
- # make stm32mp15_basic_defconfig
- # make DEVICE_TREE=stm32mp157c-ed1 all
- e) basic boot on dk1::
- # export KBUILD_OUTPUT=stm32mp15_basic
- # make stm32mp15_basic_defconfig
- # make DEVICE_TREE=stm32mp157a-dk1 all
- f) basic boot on avenger96::
- # export KBUILD_OUTPUT=stm32mp15_basic
- # make stm32mp15_basic_defconfig
- # make DEVICE_TREE=stm32mp15xx-dhcor-avenger96 all
- 6. U-Boot Output files
- So in the output directory (selected by KBUILD_OUTPUT),
- you can found the needed U-Boot files:
- - stm32mp15_defconfig = **u-boot-nodtb.bin** and **u-boot.dtb**
- - stm32mp15_trusted_defconfig = u-boot.stm32
- - stm32mp15_basic_defconfig
- - FSBL = spl/u-boot-spl.stm32
- - SSBL = u-boot.img (without CONFIG_SPL_LOAD_FIT) or
- u-boot.itb (with CONFIG_SPL_LOAD_FIT=y)
- 7. TF-A_ compilation
- This step is required only for **Trusted** boot (stm32mp15_defconfig and
- stm32mp15_trusted_defconfig); see OP-TEE_ and TF-A_ documentation for build
- commands.
- - For TF-A_ with FIP support: **stm32mp15_defconfig**
- - with OP-TEE_ support, compile the OP-TEE to generate the binary included
- in FIP
- - after TF-A compilation, the used files are:
- - TF-A_ BL2 => FSBL = **tf-a.stm32**
- - FIP => **fip.bin**
- FIP file includes the 2 files given in arguments of TF-A_ compilation:
- - BL33=u-boot-nodtb.bin
- - BL33_CFG=u-boot.dtb
- You can also update a existing FIP after U-boot compilation with fiptool,
- a tool provided by TF-A_::
- # fiptool update --nt-fw u-boot-nodtb.bin --hw-config u-boot.dtb fip-stm32mp157c-ev1.bin
- - For TF-A_ without FIP support : **stm32mp15_trusted_defconfig**
- SPMin is used and the used files are:
- - FSBL = **tf-a.stm32** (provided by TF-A_ compilation, contening BL2 and
- BL32 = SPMin)
- - SSBL = **u-boot.stm32** used instead of fip.bin in next chapters
- 8. The bootloaders files
- + The **ROM code** expects FSBL binaries with STM32 image header =
- tf-a.stm32 or u-boot-spl.stm32
- According the FSBL / the boot mode:
- + **TF-A** expect a FIP binary = fip.bin, including the OS monitor (SPMin or
- OP-TEE_) and the U-Boot binary + device tree
- or, without FIP support, binaries with STM32 image header: U-Boot
- = u-boot.stm32 and eventually OP-TEE files (tee-header.stm32, tee-pageable.stm32,
- tee-pager.stm32)
- + **SPL** expects SSBL = U-Boot with uImage header = u-boot.img
- or FIT = u-boot.itb.
- Switch Setting for Boot Mode
- ----------------------------
- You can select the boot mode, on the board with one switch, to select
- the boot pin values = BOOT0, BOOT1, BOOT2
- +-------------+---------+---------+---------+
- |*Boot Mode* | *BOOT2* | *BOOT1* | *BOOT0* |
- +=============+=========+=========+=========+
- | Recovery | 0 | 0 | 0 |
- +-------------+---------+---------+---------+
- | NOR | 0 | 0 | 1 |
- +-------------+---------+---------+---------+
- | eMMC | 0 | 1 | 0 |
- +-------------+---------+---------+---------+
- | NAND | 0 | 1 | 1 |
- +-------------+---------+---------+---------+
- | Reserved | 1 | 0 | 0 |
- +-------------+---------+---------+---------+
- | SD-Card | 1 | 0 | 1 |
- +-------------+---------+---------+---------+
- | Recovery | 1 | 1 | 0 |
- +-------------+---------+---------+---------+
- | SPI-NAND | 1 | 1 | 1 |
- +-------------+---------+---------+---------+
- - on the **daugther board ed1 = MB1263** with the switch SW1
- - on **Avenger96** with switch S3 (NOR and SPI-NAND are not applicable)
- - on board **DK1/DK2** with the switch SW1 = BOOT0, BOOT2
- with only 2 pins available (BOOT1 is forced to 0 and NOR not supported),
- the possible value becomes:
- +-------------+---------+---------+
- |*Boot Mode* | *BOOT2* | *BOOT0* |
- +=============+=========+=========+
- | Recovery | 0 | 0 |
- +-------------+---------+---------+
- | NOR (NA)| 0 | 1 |
- +-------------+---------+---------+
- | Reserved | 1 | 0 |
- +-------------+---------+---------+
- | SD-Card | 1 | 1 |
- +-------------+---------+---------+
- Recovery is a boot from serial link (UART/USB) and it is used with
- STM32CubeProgrammer tool to load executable in RAM and to update the flash
- devices available on the board (NOR/NAND/eMMC/SD card).
- The communication between HOST and board is based on
- - for UARTs : the uart protocol used with all MCU STM32
- - for USB : based on USB DFU 1.1 (without the ST extensions used on MCU STM32)
- Prepare an SD card
- ------------------
- The minimal requirements for STMP32MP15x boot up to U-Boot are:
- - GPT partitioning (with gdisk or with sgdisk)
- - 2 fsbl partitions, named "fsbl1" and "fsbl2", size at least 256KiB
- - one partition named "fip" for FIP or U-Boot (TF-A_ search the "fip"
- partition and SPL search the 3th partition, because
- CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION=3)
- The 2 fsbl partitions have the same content and are present to guarantee a
- fail-safe update of FSBL; fsbl2 can be omitted if this ROM code feature is
- not required.
- Without FIP support in TF-A_, the 3rd partition "fip" for u-boot.stm32 must
- be named "ssbl".
- Then the minimal GPT partition is:
- For TF-A_ with FIP support:
- +-------+--------+---------+------------------------+
- | *Num* | *Name* | *Size* | *Content* |
- +=======+========+=========+========================+
- | 1 | fsbl1 | 256 KiB | TF-A_ BL2 (tf-a.stm32) |
- +-------+--------+---------+------------------------+
- | 2 | fsbl2 | 256 KiB | TF-A_ BL2 (tf-a.stm32) |
- +-------+--------+---------+------------------------+
- | 3 | fip | 4MB | fip.bin |
- +-------+--------+---------+------------------------+
- | 4 | <any> | <any> | Rootfs |
- +-------+--------+---------+------------------------+
- or:
- +-------+--------+---------+------------------------+------------------------+
- | *Num* | *Name* | *Size* | *Trusted boot content* | *Basic boot content* |
- +=======+========+=========+========================+========================+
- | 1 | fsbl1 | 256 KiB | TF-A_ BL2 (tf-a.stm32) | SPL (u-boot-spl.stm32) |
- +-------+--------+---------+------------------------+------------------------+
- | 2 | fsbl2 | 256 KiB | TF-A_ BL2 (tf-a.stm32) | SPL (u-boot-spl.stm32) |
- +-------+--------+---------+------------------------+------------------------+
- | 3 | ssbl | 2MB | U-Boot (u-boot.stm32) | U-Boot (u-boot.img) |
- +-------+--------+---------+------------------------+------------------------+
- | 4 | <any> | <any> | Rootfs |
- +-------+--------+---------+------------------------+------------------------+
- And the 4th partition (Rootfs) is marked bootable with a file extlinux.conf
- following the Generic Distribution feature (doc/README.distro for use).
- The size of fip or ssbl partition must be enough for the associated binary file,
- 4MB and 2MB are default values.
- According the used card reader select the correct block device
- (for example /dev/sdx or /dev/mmcblk0), in the next example, it is /dev/mmcblk0
- For example:
- a) remove previous formatting::
- # sgdisk -o /dev/<SD card dev>
- b) create minimal image for FIP
- For FIP support in TF-A_::
- # sgdisk --resize-table=128 -a 1 \
- -n 1:34:545 -c 1:fsbl1 \
- -n 2:546:1057 -c 2:fsbl2 \
- -n 3:1058:9249 -c 3:fip \
- -n 4:9250: -c 4:rootfs -A 4:set:2 \
- -p /dev/<SD card dev>
- With gpt table with 128 entries an the partition 4 marked bootable (bit 2).
- For basic boot mode or without FIP support in TF-A_::
- # sgdisk --resize-table=128 -a 1 \
- -n 1:34:545 -c 1:fsbl1 \
- -n 2:546:1057 -c 2:fsbl2 \
- -n 3:1058:5153 -c 3:ssbl \
- -n 4:5154: -c 4:rootfs -A 4:set:2 \
- -p /dev/<SD card dev>
- c) copy the FSBL (2 times) and SSBL file on the correct partition.
- in this example in partition 1 to 3
- for trusted boot: ::
- # dd if=tf-a.stm32 of=/dev/mmcblk0p1
- # dd if=tf-a.stm32 of=/dev/mmcblk0p2
- # dd if=fip.bin of=/dev/mmcblk0p3
- OR
- dd if=u-boot.stm32 of=/dev/mmcblk0p3 # Without FIT support
- for basic boot mode : <SD card dev> = /dev/mmcblk0::
- # dd if=u-boot-spl.stm32 of=/dev/mmcblk0p1
- # dd if=u-boot-spl.stm32 of=/dev/mmcblk0p2
- # dd if=u-boot.img of=/dev/mmcblk0p3 # Without CONFIG_SPL_LOAD_FIT
- OR
- dd if=u-boot.itb of=/dev/mmcblk0p3 # With CONFIG_SPL_LOAD_FIT=y
- To boot from SD card, select BootPinMode = 1 0 1 and reset.
- Prepare eMMC
- ------------
- You can use U-Boot to copy binary in eMMC.
- In the next example, you need to boot from SD card and the images
- (tf-a.stm32, fip.bin / u-boot-spl.stm32, u-boot.img for systems without
- CONFIG_SPL_LOAD_FIT or u-boot.itb for systems with CONFIG_SPL_LOAD_FIT=y) are
- presents on SD card (mmc 0) in ext4 partition 4 (bootfs)
- To boot from SD card, select BootPinMode = 1 0 1 and reset.
- Then you update the eMMC with the next U-Boot command :
- a) prepare GPT on eMMC,
- example with 3 partitions, fip, bootfs and roots::
- # setenv emmc_part "name=fip,size=4MiB;name=bootfs,type=linux,bootable,size=64MiB;name=rootfs,type=linux,size=512"
- # gpt write mmc 1 ${emmc_part}
- b) copy FSBL, TF-A_ or SPL, on first eMMC boot partition
- (SPL max size is 256kB, with LBA 512, 0x200)::
- # ext4load mmc 0:4 0xC0000000 tf-a.stm32
- or
- # ext4load mmc 0:4 0xC0000000 u-boot-spl.stm32
- # mmc dev 1
- # mmc partconf 1 1 1 1
- # mmc write ${fileaddr} 0 200
- # mmc partconf 1 1 1 0
- c) copy SSBL, FIP or U-Boot binary, in first GPT partition of eMMC::
- # ext4load mmc 0:4 0xC0000000 fip.bin
- or
- # ext4load mmc 0:4 0xC0000000 u-boot.img # Without CONFIG_SPL_LOAD_FIT
- or
- # ext4load mmc 0:4 0xC0000000 u-boot.itb # With CONFIG_SPL_LOAD_FIT=y
- # mmc dev 1
- # part start mmc 1 1 partstart
- # mmc write ${fileaddr} ${partstart} ${filesize}
- To boot from eMMC, select BootPinMode = 0 1 0 and reset.
- MAC Address
- -----------
- Please read doc/README.enetaddr for the implementation guidelines for mac id
- usage. Basically, environment has precedence over board specific storage.
- For STMicroelectonics board, it is retrieved in STM32MP15x OTP :
- - OTP_57[31:0] = MAC_ADDR[31:0]
- - OTP_58[15:0] = MAC_ADDR[47:32]
- To program a MAC address on virgin OTP words above, you can use the fuse command
- on bank 0 to access to internal OTP and lock them:
- Prerequisite: check if a MAC address isn't yet programmed in OTP
- 1) check OTP: their value must be equal to 0::
- STM32MP> fuse sense 0 57 2
- Sensing bank 0:
- Word 0x00000039: 00000000 00000000
- 2) check environment variable::
- STM32MP> env print ethaddr
- ## Error: "ethaddr" not defined
- 3) check lock status of fuse 57 & 58 (at 0x39, 0=unlocked, 1=locked)::
- STM32MP> fuse sense 0 0x10000039 2
- Sensing bank 0:
- Word 0x10000039: 00000000 00000000
- Example to set mac address "12:34:56:78:9a:bc"
- 1) Write OTP::
- STM32MP> fuse prog -y 0 57 0x78563412 0x0000bc9a
- 2) Read OTP::
- STM32MP> fuse sense 0 57 2
- Sensing bank 0:
- Word 0x00000039: 78563412 0000bc9a
- 3) Lock OTP::
- STM32MP> fuse prog 0 0x10000039 1 1
- STM32MP> fuse sense 0 0x10000039 2
- Sensing bank 0:
- Word 0x10000039: 00000001 00000001
- 4) next REBOOT, in the trace::
- ### Setting environment from OTP MAC address = "12:34:56:78:9a:bc"
- 5) check env update::
- STM32MP> env print ethaddr
- ethaddr=12:34:56:78:9a:bc
- .. warning:: This command can't be executed twice on the same board as
- OTP are protected. It is already done for the board
- provided by STMicroelectronics.
- Coprocessor firmware
- --------------------
- U-Boot can boot the coprocessor before the kernel (coprocessor early boot).
- a) Manuallly by using rproc commands (update the bootcmd)
- Configurations::
- # env set name_copro "rproc-m4-fw.elf"
- # env set dev_copro 0
- # env set loadaddr_copro 0xC1000000
- Load binary from bootfs partition (number 4) on SD card (mmc 0)::
- # ext4load mmc 0:4 ${loadaddr_copro} ${name_copro}
- => ${filesize} variable is updated with the size of the loaded file.
- Start M4 firmware with remote proc command::
- # rproc init
- # rproc load ${dev_copro} ${loadaddr_copro} ${filesize}
- # rproc start ${dev_copro}"00270033
- b) Automatically by using FIT feature and generic DISTRO bootcmd
- see examples in the board stm32mp1 directory: fit_copro_kernel_dtb.its
- Generate FIT including kernel + device tree + M4 firmware with cfg with M4
- boot::
- $> mkimage -f fit_copro_kernel_dtb.its fit_copro_kernel_dtb.itb
- Then using DISTRO configuration file: see extlinux.conf to select the correct
- configuration:
- - stm32mp157c-ev1-m4
- - stm32mp157c-dk2-m4
- DFU support
- -----------
- The DFU is supported on ST board.
- The env variable dfu_alt_info is automatically build, and all
- the memory present on the ST boards are exported.
- The dfu mode is started by the command::
- STM32MP> dfu 0
- On EV1 board, booting from SD card, without OP-TEE_::
- STM32MP> dfu 0 list
- DFU alt settings list:
- dev: RAM alt: 0 name: uImage layout: RAM_ADDR
- dev: RAM alt: 1 name: devicetree.dtb layout: RAM_ADDR
- dev: RAM alt: 2 name: uramdisk.image.gz layout: RAM_ADDR
- dev: eMMC alt: 3 name: mmc0_fsbl1 layout: RAW_ADDR
- dev: eMMC alt: 4 name: mmc0_fsbl2 layout: RAW_ADDR
- dev: eMMC alt: 5 name: mmc0_fip layout: RAW_ADDR
- dev: eMMC alt: 6 name: mmc0_bootfs layout: RAW_ADDR
- dev: eMMC alt: 7 name: mmc0_vendorfs layout: RAW_ADDR
- dev: eMMC alt: 8 name: mmc0_rootfs layout: RAW_ADDR
- dev: eMMC alt: 9 name: mmc0_userfs layout: RAW_ADDR
- dev: eMMC alt: 10 name: mmc1_boot1 layout: RAW_ADDR
- dev: eMMC alt: 11 name: mmc1_boot2 layout: RAW_ADDR
- dev: eMMC alt: 12 name: mmc1_fip layout: RAW_ADDR
- dev: eMMC alt: 13 name: mmc1_bootfs layout: RAW_ADDR
- dev: eMMC alt: 14 name: mmc1_vendorfs layout: RAW_ADDR
- dev: eMMC alt: 15 name: mmc1_rootfs layout: RAW_ADDR
- dev: eMMC alt: 16 name: mmc1_userfs layout: RAW_ADDR
- dev: MTD alt: 17 name: nor0 layout: RAW_ADDR
- dev: MTD alt: 18 name: nand0 layout: RAW_ADDR
- dev: VIRT alt: 19 name: OTP layout: RAW_ADDR
- dev: VIRT alt: 20 name: PMIC layout: RAW_ADDR
- All the supported device are exported for dfu-util tool::
- $> dfu-util -l
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=20, name="PMIC", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=19, name="OTP", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=18, name="nand0", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=17, name="nor0", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=16, name="mmc1_userfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=15, name="mmc1_rootfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=14, name="mmc1_vendorfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=13, name="mmc1_bootfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=12, name="mmc1_fip", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=11, name="mmc1_boot2", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=10, name="mmc1_boot1", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=9, name="mmc0_userfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=8, name="mmc0_rootfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=7, name="mmc0_vendorfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=6, name="mmc0_bootfs", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=5, name="mmc0_fip", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=4, name="mmc0_fsbl2", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=3, name="mmc0_fsbl1", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=2, name="uramdisk.image.gz", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=1, name="devicetree.dtb", serial="002700333338511934383330"
- Found DFU: [0483:df11] ver=9999, devnum=99, cfg=1, intf=0, alt=0, name="uImage", serial="002700333338511934383330"
- You can update the boot device:
- - SD card (mmc0) ::
- $> dfu-util -d 0483:5720 -a 3 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 4 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 5 -D fip-stm32mp157c-ev1.bin
- $> dfu-util -d 0483:5720 -a 6 -D st-image-bootfs-openstlinux-weston-stm32mp1.ext4
- $> dfu-util -d 0483:5720 -a 7 -D st-image-vendorfs-openstlinux-weston-stm32mp1.ext4
- $> dfu-util -d 0483:5720 -a 8 -D st-image-weston-openstlinux-weston-stm32mp1.ext4
- $> dfu-util -d 0483:5720 -a 9 -D st-image-userfs-openstlinux-weston-stm32mp1.ext4
- - EMMC (mmc1)::
- $> dfu-util -d 0483:5720 -a 10 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 11 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 12 -D fip-stm32mp157c-ev1.bin
- $> dfu-util -d 0483:5720 -a 13 -D st-image-bootfs-openstlinux-weston-stm32mp1.ext4
- $> dfu-util -d 0483:5720 -a 14 -D st-image-vendorfs-openstlinux-weston-stm32mp1.ext4
- $> dfu-util -d 0483:5720 -a 15 -D st-image-weston-openstlinux-weston-stm32mp1.ext4
- $> dfu-util -d 0483:5720 -a 16 -D st-image-userfs-openstlinux-weston-stm32mp1.ext4
- - you can also dump the OTP and the PMIC NVM with::
- $> dfu-util -d 0483:5720 -a 19 -U otp.bin
- $> dfu-util -d 0483:5720 -a 20 -U pmic.bin
- When the board is booting for nor0 or nand0,
- only the MTD partition on the boot devices are available, for example:
- - NOR (nor0 = alt 20) & NAND (nand0 = alt 26) ::
- $> dfu-util -d 0483:5720 -a 21 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 22 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 23 -D fip-stm32mp157c-ev1.bin
- $> dfu-util -d 0483:5720 -a 27 -D st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
- - NAND (nand0 = alt 21)::
- $> dfu-util -d 0483:5720 -a 22 -D tf-a-stm32mp157c-ev1.stm32
- $> dfu-util -d 0483:5720 -a 23 -D fip-stm32mp157c-ev1.bin
- $> dfu-util -d 0483:5720 -a 24 -D fip-stm32mp157c-ev1.bin
- $> dfu-util -d 0483:5720 -a 25 -D st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
- References
- ----------
- .. _WIKI:
- STM32 Arm® Cortex®-based MPUs user guide
- + https://wiki.st.com/
- + https://wiki.st.com/stm32mpu/wiki/Main_Page
- .. _TF-A:
- TF-A = The Trusted Firmware-A project provides a reference implementation of
- secure world software for Armv7-A and Armv8-A class processors
- + https://www.trustedfirmware.org/projects/tf-a/
- + https://trustedfirmware-a.readthedocs.io/en/latest/
- + https://trustedfirmware-a.readthedocs.io/en/latest/plat/stm32mp1.html
- + https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/
- .. _OP-TEE:
- OP-TEE = an open source Trusted Execution Environment (TEE) implementing the
- Arm TrustZone technology
- + https://www.op-tee.org/
- + https://optee.readthedocs.io/en/latest/
- + https://optee.readthedocs.io/en/latest/building/devices/stm32mp1.html
- + https://github.com/OP-TEE/optee_os
|