Is there any documentation about the different OpenSt-Linux FlashLayouts?

[A.M.]

Hello,

Whenever I build OpenSt-Linux with Yocto, or download the starter kit, I get several flashlayouts:

In images/stm32mp2/flashlayout_st-image-weston:

* extensible

* fastboot

* fastboot-opteemin

* optee

* opteemin

I can make some supposition about: optee, opteemin being a simplified or lighter version of optee, etc.

Is there any documentation about:

* What are the purpose of each layout
* What are the differences between them
* Links to documentation about related technologies
* ...

[Olivier GALLIEN]

Hi @A.M. ,

Sorry, I agree information is not written in a single place in our wiki. 

Some information can be found here

STM32MP25 Evaluation boards - Starter Package - stm32mpu

flashlayout_st-image-weston                          Flash layout files (description of the partitions) for the supported boot chains on supported boot devices and boards
│   ├── [...]
│   ├── extensible                                       Flash layout files for microSD card boot device with no userfs partition but a rootfs partition extended to microSD card size
│   │   ├── FlashLayout_sdcard_stm32mp235f-dk-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP235F-DK → STM32MP23 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp257f-dk-extensible.tsv   (recommended setup for package repository service) microSD card boot device with rootfs partition extended to microSD card size for STM32MP257F-DK → STM32MP25 Discovery kits
│   │   └── [...]
│   ├── fastboot                                         Flash layout files for flashing via fastboot
│   │   ├── FlashLayout_emmc_stm32mp235f-dk-fastboot.tsv                                      eMMC boot device for STM32MP235F-DK → STM32MP23 Discovery kits
│   │   ├── FlashLayout_sdcard-EFI_stm32mp235f-dk-fastboot.tsv                                microSD card boot device with EFI for STM32MP235F-DK → STM32MP23 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp235f-dk-fastboot.tsv                                    microSD card boot device for STM32MP235F-DK → STM32MP23 Discovery kits
│   │   ├── FlashLayout_emmc_stm32mp257f-dk-ca35tdcid-ostl-fastboot.tsv                       eMMC boot device for STM32MP257F-DK OSTL → STM32MP25 Discovery kits
│   │   ├── FlashLayout_emmc_stm32mp257f-dk-fastboot.tsv                                      eMMC boot device for STM32MP257F-DK → STM32MP25 Discovery kits
│   │   ├── FlashLayout_emmc_stm32mp257f-ev1-ca35tdcid-ostl-fastboot.tsv                      eMMC boot device for STM32MP257F-EV1 → STM32MP25 Evaluation kits
│   │   ├── FlashLayout_emmc_stm32mp257f-ev1-fastboot.tsv                                     eMMC boot device for STM32MP257F-EV1 → STM32MP25 Evaluation kits
│   │   ├── FlashLayout_sdcard-EFI_stm32mp257f-dk-ca35tdcid-ostl-fastboot.tsv                 microSD card boot device with EFI for STM32MP257F-DK OSLT → STM32MP25 Discovery kits
│   │   ├── FlashLayout_sdcard-EFI_stm32mp257f-dk-fastboot.tsv                                microSD card boot device with EFI for STM32MP257F-DK → STM32MP25 Discovery kits
│   │   ├── FlashLayout_sdcard-EFI_stm32mp257f-ev1-ca35tdcid-ostl-fastboot.tsv                microSD card boot device with EFI for STM32MP257F-EV1 OSLT → STM32MP25 Evaluation kits
│   │   ├── FlashLayout_sdcard-EFI_stm32mp257f-ev1-fastboot.tsv                               microSD card boot device with EFI for STM32MP257F-EV1 → STM32MP25 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp257f-dk-ca35tdcid-ostl-fastboot.tsv                     microSD card boot device for STM32MP257F-DK OSLT → STM32MP25 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp257f-dk-fastboot.tsv                                    microSD card boot device for STM32MP257F-DK → STM32MP25 Discovery kits
│   │   ├── FlashLayout_sdcard_stm32mp257f-ev1-ca35tdcid-ostl-fastboot.tsv                    microSD card boot device for STM32MP257F-EV1 OSLT → STM32MP25 Evaluation kits
│   │   ├── FlashLayout_sdcard_stm32mp257f-ev1-fastboot.tsv                                   microSD card boot device for STM32MP257F-EV1→ → STM32MP25 Evaluation kits
│   │   └── [...]
│   └── optee                                                   Flash layout files for optee boot chain
│       ├── FlashLayout_emmc_stm32mp235f-dk-optee.tsv           eMMC boot device for STM32MP235F-DK → STM32MP23 Discovery kits
│       ├── FlashLayout_sdcard_stm32mp235f-dk-optee.tsv         microSD card boot device for STM32MP235F-DK → STM32MP23 Discovery kits
│       ├── FlashLayout_emmc_stm32mp257f-ev1-optee.tsv          eMMC boot device for STM32MP257F-EV1 → STM32MP25 Evaluation boards
│       ├── FlashLayout_nor-sdcard_stm32mp257f-ev1-optee.tsv    NOR boot device and microSD card device for STM32MP257F-EV1 → STM32MP25 Evaluation boards
│       ├── FlashLayout_sdcard_stm32mp257f-ev1-optee.tsv        microSD card boot device for STM32MP257F-EV1 → STM32MP25 Evaluation boards
│       └── [...]

 But likely require further details.

In short : 

* extensible

As written above. Rootfs size is defined to maximum size available, allowing to install huge software packet through apt-get. 

* fastboot

Image support U-Boot Fastboot feature allowing experimentation of PRG-TOOLBOX open-source programmer tool. 

* optee / opteemin

Related to secure profile see :

https://wiki.st.com/stm32mpu/wiki/STM32MPU_OP-TEE_profiles

Hope it help waiting for Wiki enhancement 

Olivier 

[A.M.]

1) Fastboot: we refer to the Android Fastboot (https://docs.u-boot.org/en/latest/android/fastboot-protocol.html) and (https://github.com/STMicroelectronics/STM32PRG-TOOLBOX-DFU)

2) And for the ***min versions: I suppose that it's a smaller image with less linux packages installed, but that does not limit or reduce the Optee possibilities.

3) Does sdcard versions work for USB bootable device?

4) What is the difference between :
*opteemin.sv
*ca35tdcid-ostl-opteemin.tsv
*ca35tdcid-ostl-m33-examples-opteemin.tsv
*ca35tdcid-ostl-m33-examples-sram-opteemin.tsv

Are them just the same image with a different set of examples on it?

6) Why are there no optee / opteemin / fastboot version of the extensible? And why is only present the -dk- and not the ev1 board?