Difference between revisions of "Example of directory structure for Packages"

[quality revision] [quality revision]
m
 
(Appendix B: directory structure after build (Distribution Package))

Template:ArticleMainWriter Template:ReviewersList Template:ArticleApprovedVersion

1 Article purpose[edit]

This article aims at proposing a way to organize, on the host PC, the software packages of the different Packages (Starter, Developer and Distribution) for a given release of the STM32MPU Embedded Software distribution.

The main objective of the proposed organization is to keep together the software packages corresponding to a given release because there are links between them. For example:

  • Flashing the image from the Starter Package on the board is mandatory before modifying the source code from the Developer Package. Both the image and the source code must belong to the same software release.
  • The SDK (Developer Package) and the image (Starter Package) have both been generated from the Distribution Package. A software release thus guarantees that there is no misalignment between the different software packages.

An example of organization for tools is proposed here.

Info.png The objective of this article is to describe one organization among all the possible organizations. Feel free to organize the delivered Packages in any other way that would better match your way of working.
Info.png In practice, this article uses the release STM32MP15-Ecosystem-v1.2.0 for the STM32MPU Embedded Software distribution release issued on 03-July-2018 as an example to illustrate the proposed organization. If you are using a different release, the names of the directories and files might differ.


The directories are shown in green, while the files are in black.

2 Creating the structure[edit]

  • Create your <working directory> and assign a unique name to it (for example by including the release datename):
PC $> mkdir STM32MPUSTM32MP15-Release-18-07-03Ecosystem-v1.2.0
PC $> cd STM32MPUSTM32MP15-Release-18-07-03Ecosystem-v1.2.0

  • Create the first-level directories that will host the software packages delivered through the STM32MPU Embedded Software distribution release note:
PC $> mkdir Starter-Package
PC $> mkdir Developer-Package
PC $> mkdir Distribution-Package
  • The resulting directory structure looks as follows:
STM32MPUSTM32MP15-Release-18-07-03Ecosystem-v1.2.0  STM32MPU Embedded Software release
├── Developer-Package          Developer Package installation directory
├── Distribution-Package       Distribution Package installation directory
└── Starter-Package            Starter Package installation directory

Once all software packages have been installed according to the instructions given in the STM32MPU Embedded Software distribution release note, the resulting directory structure looks as follows:

STM32MPUSTM32MP15-Release-18-07-03Ecosystem-v1.2.0                           STM32MPU Embedded Software release
├── Developer-Package                                Developer Package installation directory
│   ├── openstlinux-4.14-rocko-mp1-18-07-03SDK  Linux kernel, U-Boot and TF-A source code (OpenSTLinux distribution)    ├── SDK                                  SDK for OpenSTLinux distribution└──├── STM32Cube_FW_MP1_V0V1.42.0              STM32Cube MPU Package
       STM32CubeMP1 Package
│   └── stm32mp1-openstlinux-20-02-19  Linux kernel, U-Boot, TF-A and OP-TEE OS source code (OpenSTLinux distribution)
├── Distribution-Package                             Distribution Package installation directory
│   └── stm32mp1-openstlinux-4.1420-rocko-mp1-18-07-0302-19  OpenSTLinux distribution (full source code and OpenEmbedded-based build framework)
└── Starter-Package                                  Starter Package installation directory
    └── stm32mp1-openstlinux-4.1420-rocko-mp1-18-07-0302-19  Software image (binaries)

3 Focus on the Starter Package directory[edit]

The Starter-Package directory contains the software image for the STM32MPU Embedded Software distribution.

The trusted boot chain is the default solution delivered by STMicroelectronics. It includes the superset of features (for example, all Flash memory devices are supported). The basic boot chain is also upstreamed by STMicroelectronics, with a limited number of features (for example microSD card memory boot only). Refer to the Boot chains overview article for details.

Flash memory partitions (e.g. rootfs, bootfs...) are explained in the STM32MP15 Flash mapping article.


Starter-Package
└── stm32mp1-openstlinux-4.1420-rocko-mp1-18-07-0302-19
    └── images
        └── stm32mp1
            ├── flashlayout_st-image-weston                                 Flash layout files (description of the partitions) for the supported Flash devices and boards
            │   ├── FlashLayout_emmc_stm32mp157c-ev1-optee.tsv              Flash layout file for eMMC and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1
            │   ├── FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv            Flash layout file for eMMC and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards              ├── FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv        Flash layout file for NAND Flash and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1
            │   ├── FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv      Flash layout file for NAND Flash and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards              ├── FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv          Flash layout file for NOR Flash (and eMMC) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1
            │   ├── FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv        Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards              ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv    Flash layout file for NOR Flash (and NAND Flash) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1
            │   ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv  Flash layout file for NOR Flash (and NAND FlasdhFlash) and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards              ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv        Flash layout file for NOR Flash (and microSD card) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1
            │   ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv      Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards             │   ├── FlashLayout_sdcard_stm32mp157cstm32mp157a-dk2dk1-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP15STM32MP157A-DK1
Discovery kits              ├── FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv            Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157A-DK1
            │   ├── FlashLayout_sdcard_stm32mp157cstm32mp157a-dk2dk1-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15STM32MP157A-DK1
Discovery kits              ├── FlashLayout_sdcard_stm32mp157a-dk1-extensible.tsv       Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for package repository service) → STM32MP157A-DK1
            │   ├── FlashLayout_sdcard_stm32mp157c-ev1dk2-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP15STM32MP157C-DK2
Evaluation boards              ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv            Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-DK2
            └──├── FlashLayout_sdcard_stm32mp157c-ev1dk2-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15STM32MP157C-DK2
Evaluation boards              ├── scriptsFlashLayout_sdcard_stm32mp157c-dk2-extensible.tsv       Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for package repository service) → STM32MP157C-DK2
            └──├── createFlashLayout_sdcard_from_flashlayout.shstm32mp157c-ev1-basic.tsv            Flash ├── splash.binlayout file for microSD card and basic boot chain → STM32MP157C-EV1
            │   ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv            Flash layout file for microSD card and trusted boot chain, with OP-TEE OS  STM32MP157C-EV1
               └── FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv       U-Boot splash screen pictureFlash (layout file infor BMPmicroSD formatcard withand atrusted .bin extensionboot chain (recommended setup) for NORSTM32MP157C-EV1
Flash            ├── scripts
            │   └── create_sdcard_from_flashlayout.sh
            ├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4            Binary for bootfs partition
            ├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
            ├── st-image-userfs-openstlinux-weston-stm32mp1.ext4            Binary for userfs partition
            ├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
            ├── st-image-vendorfs-openstlinux-weston-stm32mp1.ext4          Binary for vendorfs partition
            ├── st-image-weston-openstlinux-weston-stm32mp1.ext4            Binary for rootfs partition
            ├── st-image-weston-openstlinux-weston-stm32mp1.license
            ├── st-image-weston-openstlinux-weston-stm32mp1-license_content.html
            ├── st-image-weston-openstlinux-weston-stm32mp1.manifest
            ├── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
            ├── tf-a-stm32mp157c-dk2-trustedtee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1
            ├── tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2
            ├── tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain)  STM32MP157C-EV1
            ├── tf-a-stm32mp157a-dk1-optee.stm32                            TF-A binary for FSBL partition (trusted boot chain), with STM32MP15OP-TEE DiscoveryOS kits STM32MP157A-DK1
            ├── tf-a-stm32mp157cstm32mp157a-ev1dk1-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15STM32MP157A-DK1
Evaluation boards             ├── utf-boota-spl.stm32-stm32mp157c-dk2-basicoptee.stm32                      U-Boot      TF-A binary for FSBL partition (basictrusted boot chain), with STM32MP15OP-TEE DiscoveryOS kits STM32MP157C-DK2
            ├── utf-boota-spl.stm32-stm32mp157c-ev1dk2-basictrusted.stm32                      U-Boot    TF-A binary for FSBL partition (basictrusted boot chain) → STM32MP15STM32MP157C-DK2
Evaluation boards             ├── utf-boota-stm32mp157c-dk2ev1-basicoptee.imgstm32                            UTF-BootA binary for SSBLFSBL partition (basictrusted boot chain), with STM32MP15OP-TEE DiscoveryOS kits STM32MP157C-EV1
            ├── utf-boota-stm32mp157c-dk2ev1-trusted.stm32                        U  TF-BootA binary for SSBLFSBL partition (trusted boot chain) → STM32MP15STM32MP157C-EV1
Discovery kits             ├── u-boot-stm32mp157cspl.stm32-ev1stm32mp157a-dk1-basic.img                      U-Boot binary for FSBL partition (basic boot chain) → STM32MP157A-DK1
            ├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      U-Boot binary for SSBLFSBL partition (basic boot chain) → STM32MP15STM32MP157C-DK2
Evaluation boards           ├──  └── u-boot-spl.stm32-stm32mp157c-ev1-trusted.stm32basic                        U-Boot binary for SSBLFSBL partition (trustedbasic boot chain) → STM32MP15STM32MP157C-EV1
Evaluation boards

4 Focus on the Developer Package directory[edit]

The Developer-Package directory contains:

  • The source code for the following OpenSTLinux software packages (development for Arm® Cortex®-A processor):
    • TF-A
    • Linux kernel
    • U-Boot
  • The debug symbol files for Linux kernel, U-Boot and TF-A
  • The SDK (for cross-development on an host PC)
  • The STM32Cube MPU Package (developed for Arm® Cortex®-M processor)
Developer-Package
├── openstlinux-4.14-rocko-mp1-18-07-03  Source code for OpenSTLinux distribution
│   ├── images
│   │   └── stm32mp1           ├── u-boot-stm32mp157a-dk1-basic.img                            U-Boot binary for SSBL partition (basic boot chain) → STM32MP157A-DK1
            ├── u-boot-stm32mp157a-dk1-optee.stm32                          U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE OS Debug symbolSTM32MP157A-DK1
files installation directory           ├── tfu-aboot-bl2stm32mp157a-dk1-trusted.elfstm32                Debug symbol file for TF-A →     U-Boot binary for SSBL partition (trusted boot firmwarechain) stage STM32MP157A-DK1
            ├── tfu-aboot-bl32stm32mp157c-trusteddk2-basic.elfimg               Debug symbol file for TF-A → runtime software stage
│   │          U-Boot binary for SSBL partition (basic boot chain) → STM32MP157C-DK2
            ├── u-boot-stm32mp157c-dk2-trustedoptee.elfstm32  Debug symbol file for                      U-Boot → STM32MP15 Discovery kitsbinary for SSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2
            ├── u-boot-stm32mp157c-ev1dk2-trusted.elfstm32  Debug symbol file for                    U-Boot binary STM32MP15for EvaluationSSBL boardspartition (trusted boot chain)  STM32MP157C-DK2
     └── vmlinux      ├── u-boot-stm32mp157c-ev1-basic.img                      Debug symbol file     U-Boot binary for LinuxSSBL kernelpartition (basic boot chain) └── sourcesSTM32MP157C-EV1
       └── arm-openstlinux_weston-linux-gnueabi     ├── u-boot-stm32mp157c-ev1-optee.stm32            ├── linux-stm32mp-4.14-48     Linux kernel installation directory              U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1
          ├── [*].patch  └── u-boot-stm32mp157c-ev1-trusted.stm32             ST patches for Linux kernel       U-Boot binary for SSBL partition (trusted boot chain) ├── fragment-[*].config   ST configuration fragments for Linux kernelSTM32MP157C-EV1

4 Focus on the Developer Package directory[edit]

The Developer-Package directory contains:

  • The source code for the following OpenSTLinux software packages (development for Arm® Cortex®-A processor):
    • Linux® kernel
    • U-Boot
    • TF-A
    • OP-TEE OS
  • The debug symbol files for Linux kernel, U-Boot, TF-A and OP-TEE OS
  • The SDK (for cross-development on an host PC)
  • The STM32Cube MPU Package (developed for Arm® Cortex®-M processor)


Developer-Package
├── SDK                     ├── linux-4.14.48         Linux kernel source code directory               ├── linux-4.14.48.tar.xz               ├── README.HOW_TO.txt     Helper file    SDK for LinuxOpenSTLinux kernel managementdistribution: referencedetails forin LinuxStandard kernelSDK builddirectory structure article
├── environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi  Environment setup script for Developer Package
└── series
├── site-config-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi
├── sysroots
      ├── tfcortexa7t2hf-aneon-stm32mpvfpv4-1.5-release.AUTOINC+ed8112606costl-linux-gnueabi             TF-A installation directory Target sysroot (libraries, headers, and symbols)
      ├──└── [*...].patch
      └── x86_64-ostl_sdk-linux                                   ST patches forNative TF-A
sysroot (libraries, headers, and symbols)
       └── [...]
├── git└── version-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi

├── STM32Cube_FW_MP1_VX.Y.Z             STM32CubeMP1 Package: details in STM32CubeMP1 Package content article
   ├── Drivers
      ├── BSP                TF-A source code directory      BSP drivers for the supported STM32MPU boards
├── Makefile.sdk     └── [...]
      ├── CMSIS
         └── [...]
      └── STM32MP1xx_HAL_Driver       MakefileHAL drivers for the TF-Asupported compilationSTM32MPU devices
       └── [...]
│   ├── README.HOW_TO.txt _htmresc      └── [...]
   ├── License.md                      HelperLicense filetypes for TF-A management: reference for TF-A buildthe components
│   ├── Middlewares              ├── series      Middlewares used by the examples and applications
└── tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c.tar.gz
[...]
│   ├── package.xml
├── Projects
      └── u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e             U-Boot installation directory├── STM32CubeProjectsList.html  List of examples and applications for STM32CubeMP1 Package
│   │   ├── STM32MP157C-DK2             Set of examples and applications ├── [*].patch → STM32MP157C-DK2
│   │   │   └── [...]
│      └── STM32MP157C-EV1             Set of examples and applications  STM32MP157C-EV1
          └── [...]
   ├── Readme.md
   ├── Release_Notes.html        ST patches for U-Boot   Release note for STM32CubeMP1 Package
   └── Utilities
   ├── git   └── [...]

└── stm32mp1-openstlinux-20-02-19     Source code for OpenSTLinux distribution
    ├── images
       └── stm32mp1                                Debug U-Bootsymbol sourcefiles codeinstallation directory
    ├── tf-a-bl2-optee.elf       ├── Makefile.sdk          Debug symbol file for TF-A, with OP-TEE OS  trusted boot firmware stage
           ├── tf-a-bl2-trusted.elf                Debug symbol file Makefile for the UTF-BootA compilation trusted boot firmware stage
           ├── README.HOW_TO.txttf-a-bl32-trusted.elf               Debug symbol file for TF-A  runtime software stage
           ├── u-boot-stm32mp157a-dk1-optee.elf    Debug symbol file for U-Boot, with OP-TEE OS  Helper STM32MP157A-DK1
    │       ├── u-boot-stm32mp157a-dk1-trusted.elf  Debug symbol file for U-Boot management: reference → STM32MP157A-DK1
    │       ├── u-boot-stm32mp157c-dk2-optee.elf    Debug symbol file for U-Boot, buildwith OP-TEE OS  STM32MP157C-DK2
           ├── series
│       u-boot-stm32mp157c-dk2-trusted.elf  Debug symbol file for U-Boot → STM32MP157C-DK2
       └──    ├── u-boot-trustedstm32mp157c-stm32mpev1-2018.03-release.AUTOINC+f95ab1fb6e.tar.gz
├── SDK           optee.elf    Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1
           ├── u-boot-stm32mp157c-ev1-trusted.elf  Debug symbol file for U-Boot  STM32MP157C-EV1
           └── vmlinux                             Debug SDKsymbol file for OpenSTLinuxLinux distribution:kernel
details
 in Standard SDK directory└── structuresources
article    ├── environment-setup-cortexa7hf-neon-vfpv4-    └── arm-openstlinux_weston-linux-gnueabi
 Environment setup script for Developer Package      ├── sitelinux-configstm32mp-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi
│X.Y-rR    ├──Linux sysrootskernel installation directory
            │   ├── cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi[*].patch            ST patches for Linux Targetkernel
sysroot (libraries, headers, and symbols)        └──├── fragment-[*]...]config  ST configuration fragments for Linux └── x86_64-openstlinux_weston_sdk-linuxkernel
               ├── linux-X.Y.Z         Linux kernel source code directory
     Native sysroot (libraries, headers, and symbols)  ├── linux-X.Y.Z.tar.xz
     └── [...]
       │   ├── README.HOW_TO.txt    Helper file for Linux kernel management: reference for Linux kernel build
            │   └── version-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi
└── STM32Cube_FW_MP1_V0.4.0 series

            ├── optee-os-stm32mp-X.Y.Z-rR  OP-TEE OS installation directory
               ├── [*].patch           STM32Cube MPU Package: detailsST inpatches STM32Cubefor MPUOP-TEE PackageOS
content article     ├── COPYING     ├── COPYING.BSD-3X.Y.Z.tar.gz
    ├── Drivers       │   ├── BSPMakefile.sdk           Makefile for the OP-TEE OS compilation
               ├── optee_os-X.Y.Z        BSP driversOP-TEE forOS thesource supportedcode STM32MPUdirectory
boards            └──├── [README.HOW_TO..]txt      Helper file ├──for CMSISOP-TEE OS management: reference for OP-TEE OS build
   └── [...]        │   └── STM32MP1xx_HAL_Driverseries

            
├── tf-a-stm32mp-X.Y-rR         HAL drivers forTF-A theinstallation supporteddirectory
STM32MPU devices            └──  ├── [*]...]patch     ├── _htmresc        └── [...]  ST patches  ├── LLA_evaluation_for_STM32MPU_17-12-06_plain.txtfor TF-A
    ├── Middlewares       └── [...]
    ├── package.xml├── arm-trusted-firmware-X.Y  TF-A source code directory
     ├── Projects      │   ├── STM32CubeProjectsListMakefile.htmlsdk              Makefile for the TF-A Listcompilation
of examples and applications for STM32Cube MP1 Package     │   ├── STM32MP15_DISCOREADME.HOW_TO.txt         Helper file for TF-A management: reference for TF-A build
           Set of examples and applications├── series
STM32MP15 Discovery kits          │   └── [vX.Y.tar.]gz

    
   └── STM32MP15_EVAL         └── u-boot-stm32mp-YYYY.MM-rR  U-Boot installation directory
                ├── [*].patch        Set of examples and applications  STM32MP15ST Evaluationpatches boardsfor U-Boot
          └── [...]      ├── Makefile.sdk     ├── Release_Notes.html      Makefile for the U-Boot compilation
                ├── README.HOW_TO.txt      Helper file for U-Boot management: reference for U-Boot build
               Release note├── forseries
STM32Cube MP1 Package     └── Utilities        ├── └── [...]u-boot-YYYY.MM-rR         U-Boot source code directory
                └── vYYYY.MM.tar.gz

Appendix A shows the structure of the Linux kernel, U-Boot and , TF-A and OP-TEE OS installation directories after these software packages have been built.

5 Focus on the Distribution Package directory[edit]

The Distribution-Package directory contains all the OpenEmbedded layers required to get the source code of any STM32MPU Embedded Software component, as well as a build framework based on OpenEmbedded.


Distribution-Package
└── openstlinux-4.1420-rocko-mp1-18-07-0302-19  OpenSTLinux distribution
    └── layers
        ├── meta-openembedded  Collection of layers for the OpenEmbedded-Core universe (OpenEmbedded standard)
        │   └── [...]
        ├── meta-qt5           QT5 layer for OpenEmbedded (standard)
        │   └── [...]
    
    ├── meta-st
        │   ├── meta-st-openstlinux                   STMicroelectronics layer that contains the settings of the frameworks and images for the OpenSTLinux distribution
        │   │   ├── recipes-samples
        │   │   │   └──├── images
        │   │   │   |    ├── st-example-image-qt.bb    ST example of image based on QT framework
        │   │   │   |    ├── st-example-image-x11.bb   ST example of image based on X11
        │   │   │   |   ├── └── st-example-image-xfce.bb  ST example of image based on XFCE framework
        │   │   │   |   └── st-image-userfs.bbappend  Additional packages (application launcher, demo...) for ST Weston image
        │   │   │   └── [...]
        │   │   ├── recipes-st
        │   │   │   ├── images
        │   │   │   │   ├── st-image-core.bb          Core image for OpenSTLinux distribution
        │   │   │   │   ├── st-image.inc
        │   │   │   │   └── st-image-weston.bb        Weston image with basic Wayland support for OpenSTLinux distribution: recommended setupsetup
        │   │   │   └── packagegroups
        │   │   │       └── [...]
        │   │   └── [...]
    
    │   ├── meta-st-stm32mp                   STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices
        │   │   ├── recipes-bsp
        │   │   │   ├── alsa                      Recipes for ALSA control configuration
        │   │   │   │   └── [...]
        │   │   │   ├── drivers                   Recipes for Vivante GCNANO GPU kernel drivers
        │   │   │   │   └── [...]
        │   │   │   ├── trusted-firmware-a        Recipes for TF-A
        │   │   │   │   └── [...]
        │   │   │   └── u-boot                    Recipes for U-Boot
        │   │   │       └── [...]
        │   │   ├── recipes-extended
        │   │   │   ├── m4projects                Recipes for STM32Cube MPU Package within the OpenSTLinux distribution
        │   │   │   │   └── [...]
          ├── openocd                 Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M
    │   │   │   │   └── [...]
          └── stlink                  Recipes for STLink
    ├── recipes-graphics
        └── [...]
    │   │   ├── recipes-graphics
    │   │   ├── gcnano-userland           Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)
        │   │   │   │   └── [...]
        │   │   │   └── [...]
        │   │   ├── recipes-kernel
        │   │   │   └── linux                     Recipes for Linux kernel
        │   │   │       └── [...]
        │   │   │   └── linux-firmware            Recipes for Linux firmwares (example, Bluetooth firmware)
        │   │   │       └── [...]
        │   │   ├── recipes-st
        │   │   │   └── images
        │   │   │       ├── st-image-bootfs.bb    Recipes for the bootfs partition binary
        │   │   │       └──├── st-image-userfs.bb    Recipes for the userfs partition binary
        │   │   └── st-image-vendorfs.bb  Recipes for the vendorfs partition binary
        │   │   └── [...]
    
    │   ├── meta-st-stm32mp-addons  STMicroelectronics layer that helps managing the STM32CubeMX integration
        │       └── [...]
        │   └── scripts
        │       ├── envsetup.sh         Environment setup script for Distribution Package
        │       └── [...]

    
    ├── meta-timesys       Timesys layer for OpenEmbedded (standard)└── [...]
        └── openembedded-core  Core metadata for current versions of OpenEmbedded (standard)
            └── [...]

Appendix B shows the structure of the build directory.

6 Appendix A: directory structure after build (Developer Package)[edit]

Provided you have followed the recommendations of the README.HOW_TO.txt helper files to build the Linux kernel, the U-Boot and the TF-A, then the following new directories and files contain the build outputs.


Developer-Package
├── stm32mp1-openstlinux-4.1420-rocko-mp1-18-07-03 02-19  Source code for OpenSTLinux distribution
│   └── sources
│       └── arm-openstlinux_weston-linux-gnueabi
│           ├── linux-stm32mp-4X.14Y-48rR                   Linux kernel installation directory
│           │   ├── build                               Linux kernel build directory
│           │   │   ├── install_artifact
│           │   │   │   ├── lib
│           │   │   │   │   └── modules
│           │   │   │   │       └── 4X.14Y.48Z
│           │   │   │   │           └── [...]           Kernel modules hierarchy (*.ko files)
│           │   │   │   └── boot
│           │   │   │       ├── stm32mp157cstm32mp157a-ddk1[*].dtb  Linux kernel device tree blob files for bootfs partition → STM32MP15 Discovery kits
STM32MP157A-DK1
│           │   │   │       ├── stm32mp157c-edk2[*].dtb  Linux kernel device tree blob files for bootfs partition → STM32MP15STM32MP157C-DK2
Evaluation boards
                    ├── stm32mp157c-ev1[*].dtb  Linux kernel device tree blob files for bootfs partition → STM32MP157C-EV1
        │   │          ├── uImage                  Linux kernel binary image file (with U-Boot wrapper) for bootfs partition
│           │   │   │       └── [...]
│           │   │   ├── vmlinux                         Debug symbol file for Linux kernel
│           │   │   └── [...]
│           │   └── [...]
│           ├── optee-os-stm32mp-X.Y.Z-rR                                           OP-TEE OS installation directory
│           │   ├── build                                                           OP-TEE OS build directory
│           │   │   ├── tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1
│           │   │   ├── tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2
│           │   │   ├── tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1
│           │   │   └── [...]
│           │   └── [...]

│           ├── tf-a-stm32mp-1X.5-release.AUTOINC+ed8112606c Y-rR                             TF-A installation directory
│           │   ├── build                                       TF-A build directory
│           │   │   ├── optee                                   TF-A, with OP-TEE OS
│           │   │   │   ├── tf-a-bl2-optee.elf                  Debug symbol file for TF-A, with OP-TEE OS → trusted boot firmware stage
│           │   │   │   ├── tf-a-stm32mp157a-dk1-optee.stm32    TF-A binary for FSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1
│           │   │   │   ├── tf-a-stm32mp157c-dk2-optee.stm32    TF-A binary for FSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2
│           │   │   │   ├── tf-a-stm32mp157c-ev1-optee.stm32    TF-A binary for FSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1
│           │   │   │   └── [...]
│           │   │   └── trusted                                 TF-A, without OP-TEE OS
│           │   │       ├── tf-a-bl2-trusted.elf                Debug symbol file for TF-A → trusted boot firmware stage
│           │   │       ├── tf-a-bl32-trusted.elf               Debug symbol file for TF-A → trusted boot firmware stage
│           │   │       ├── tf-a-stm32mp157cstm32mp157a-dk2dk1-trusted.stm32  TF-A binary for FSBL partition (trusted boot chain) → STM32MP15STM32MP157A-DK1
Discovery kits
                 ├── tf-a-stm32mp157c-dk2-trusted.stm32  TF-A binary for FSBL partition (trusted boot chain) → STM32MP157C-DK2
        ├── tf-a-stm32mp157c-ev1-trusted.stm32  TF-A binary for FSBL partition (trusted boot chain) → STM32MP15 Evaluation boards
STM32MP157C-EV1
│           │   │       └── [...]
│           │   └── [...]
│           └── u-boot-trusted-stm32mp-2018YYYY.03-release.AUTOINC+f95ab1fb6e MM-rR                       U-Boot installation directory
│               ├── build-stm32mp15_trusted_defconfigbasic                                 U-Boot build directory for basic boot chain
│               │   ├── u-boot-stm32mp157c-dk2-trusted.elf                spl.stm32-stm32mp157a-dk1-basic  U-Boot binary for FSBL partition (basic boot chain) → STM32MP157A-DK1
│               │   ├── u-boot-spl.stm32-stm32mp157c-dk2-basic  U-Boot binary for FSBL partition (basic boot chain) → STM32MP157C-DK2
│               │   ├── u-boot-spl.stm32-stm32mp157c-ev1-basic  U-Boot binary for FSBL partition (basic boot chain) → STM32MP157C-EV1
│               │   ├── u-boot-stm32mp157a-dk1-basic.img        U-Boot binary for SSBL partition (basic boot chain) → STM32MP157A-DK1
│               │   ├── u-boot-stm32mp157c-dk2-basic.img        U-Boot binary for SSBL partition (basic boot chain) → STM32MP157C-DK2
│               │   ├── u-boot-stm32mp157c-ev1-basic.img        U-Boot binary for SSBL partition (basic boot chain) → STM32MP157C-EV1
│               ├── build-optee                                 U-Boot build directory for trusted boot chain, with OP-TEE OS
│               │   ├── u-boot-stm32mp157a-dk1-optee.elf        Debug symbol file for U-Boot, with OP-TEE OS STM32MP15STM32MP157A-DK1
Discovery kits
              ├── u-boot-stm32mp157a-dk1-optee.stm32      U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1
├── u-boot-stm32mp157c-dk2-trustedoptee.stm32elf        Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2
│               │   ├── u-boot-stm32mp157c-dk2-optee.stm32      U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE OS STM32MP15STM32MP157C-DK2
Discovery kits
              ├── u-boot-stm32mp157c-ev1-optee.elf        Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1
├── u-boot-stm32mp157c-ev1-optee.stm32      U-Boot binary for SSBL partition (trusted.elf  boot chain), with OP-TEE OS → STM32MP157C-EV1
│               │   └── [...]               ├── build-trusted                               U-Boot build directory for trusted boot chain
│               │   ├── u-boot-stm32mp157a-dk1-trusted.elf      Debug symbol file for U-Boot → STM32MP15STM32MP157A-DK1
Evaluation boards
              ├── u-boot-stm32mp157a-dk1-trusted.stm32    U-Boot binary for SSBL partition (trusted boot chain) → STM32MP157A-DK1
├── u-boot-stm32mp157c-ev1dk2-trusted.stm32elf      Debug symbol file for U-Boot  STM32MP157C-DK2
               │   ├── u-boot-stm32mp157c-dk2-trusted.stm32    U-Boot binary for SSBL partition (trusted boot chain) → STM32MP15STM32MP157C-DK2
Evaluation boards
              ├── u-boot-stm32mp157c-ev1-trusted.elf      Debug symbol file for U-Boot → STM32MP157C-EV1
            │   ├── u-boot-stm32mp157c-ev1-trusted.stm32    U-Boot binary for SSBL partition (trusted boot chain) → STM32MP157C-EV1
│               │   └── [...]
│               └── [...]

7 Appendix B: directory structure after build (Distribution Package)[edit]

Provided you have followed the build method explained in OpenSTLinux distribution, then the following new directories contain the build outputs.

As long as you did not modify the source code:

  • the Template:Purple files in STPurple are the same as the ones available in the Starter Package: flash layout, binaries for bootfs, rootfs, userfs and rootfs vendorfs partitions
  • the files in grey are the same as the ones available in the Starter and Developer Packages: binaries for FSBL and SSBL partitions, and for OP-TEE OS runtime services
  • the files in orange are the same as the ones available in the Developer Package: Linux kernel image and device tree blobsthe Template:Rose are only available in the Distribution Package: they concern the OP-TEE (see How to populate and boot a board with OP-TEE), and debug symbol files


Distribution-Package/openstlinux-4.1420-rocko-mp1-18-07-0302-19 /build-openstlinuxweston-stm32mp1stm32mp/tmp-glibc/deploy
└──├── images
|   └── stm32mp1
|       ├── Template:Purpleflashlayout_st-image-weston                                 Flash layout files (description of the partitions) for the supported flash devices
|       │   ├── Template:RoseFlashLayout_emmc_stm32mp157c-ev1-optee.tsv              Flash layout file for eMMC and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:PurpleFlashLayout_emmc_stm32mp157c-ev1-trusted.tsv            Flash layout file for eMMC and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:RoseFlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv        Flash layout file for NAND Flash and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:PurpleFlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv      Flash layout file for NAND Flash and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:RoseFlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv          Flash layout file for NOR Flash (and eMMC) and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:PurpleFlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv        Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:RoseFlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv    Flash layout file for NOR Flash (and NAND FlasdhFlash) and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:PurpleFlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv  Flash layout file for NOR Flash (and NAND FlasdhFlash) and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:RoseFlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv        Flash layout file for NOR Flash (and microSD card) and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:PurpleFlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv      Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15STM32MP157C-EV1
Evaluation boards |       │   ├── Template:PurpleFlashLayout_sdcard_stm32mp157a-dk1-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP15STM32MP157A-DK1
Discovery kits |       │   ├── Template:RoseFlashLayout_sdcard_stm32mp157a-dk1-optee.tsv            Flash layout file for microSD card and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157A-DK1
Discovery kits |       │   ├── Template:PurpleFlashLayout_sdcard_stm32mp157a-dk1-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15STM32MP157A-DK1
Discovery kits |        ├── FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP157C-DK2
├── Template:Purple    │   ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv            Flash layout file for microSD card and basictrusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-DK2
Evaluation boards |        ├── FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP157C-DK2
├── Template:Rose    │   ├── FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv            Flash layout file for microSD card and basic boot chain → STM32MP157C-EV1
│       │   ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv            Flash layout file for microSD card and trusted boot chain, with OP-TEE OS STM32MP15STM32MP157C-EV1
Evaluation boards |       │   └── Template:PurpleFlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv          Flash layout file for microSD card and trusted boot chain (recommended setup) → STM32MP15STM32MP157C-EV1
Evaluation boards |       │   └── [...]
|       ├── Template:Purplescripts
|       │   └── Template:Purple
|create_sdcard_from_flashlayout.sh

       ├── Template:Purplest-image-bootfs-openstlinux-weston-stm32mp1.ext4            Binary for bootfs partition
       ├── st-image-userfs-openstlinux-weston-stm32mp1.ext4            Binary for userfs partition
       ├──   U-Boot splash screen picture (file in BMP format with a .bin extension) for NOR Flash
|st-image-vendorfs-openstlinux-weston-stm32mp1.ext4          Binary for vendorfs partition       ├── Template:Purplest-image-weston-openstlinux-weston-stm32mp1.ext4            Binary for bootfsrootfs partition
|       ├── Template:Purplestm32mp157a-dk1[*].dtb            Binary for userfs partition |       ├── Template:Purple            Binary   Linux kernel device tree blob files for rootfsbootfs partition | STM32MP157A-DK1
       ├── stm32mp157c-ddk2[*].dtb                                        Linux kernel device tree blob files for bootfs partition → STM32MP15STM32MP157C-DK2
Discovery kits |       ├── stm32mp157c-e[*].dtb                                        Linux kernel device tree blob files for bootfs partition → STM32MP15STM32MP157C-EV1
Evaluation boards |     ├── tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32 ├── Template:Rose              Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1
│       ├── tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2       ├── tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32  Binaries for OP-TEE OS runtime services (trusted boot chain)  STM32MP157C-EV1
       ├── tf-a-bl2-optee.elf                                          Debug symbol file for TF-A, andwith OP-TEE OS → trusted boot firmware stage
|       ├── tf-a-bl2-trusted.elf                                        Debug symbol file for TF-A → trusted boot firmware stage
|       ├── tf-a-bl32-trusted.elf                                       Debug symbol file for TF-A → trustedruntime bootsoftware firmware stage
|       ├── Template:Rosetf-a-stm32mp157a-dk1-optee.stm32                            TF-A binary for FSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1
│       ├── tf-a-stm32mp157a-dk1-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15STM32MP157A-DK1
Discovery kits |     ├── tf-a-stm32mp157c-dk2-optee.stm32                            TF-A binary for FSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2├── tf-a-stm32mp157c-dk2-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15STM32MP157C-DK2
Discovery kits |       ├── Template:Rosetf-a-stm32mp157c-ev1-optee.stm32                            TF-A binary for FSBL partition (trusted boot chain), with OP-TEE) OS STM32MP15STM32MP157C-EV1
Evaluation boards |       ├── tf-a-stm32mp157c-ev1-trusted.stm32                          TF-A binary for FSBL partition (trusted boot chain) → STM32MP15STM32MP157C-EV1
Evaluation boards |     ├── u-boot-spl.stm32-stm32mp157a-dk1-basic ├── Template:Purple                     U-Boot binary for FSBL partition (basic boot chain) → STM32MP157A-DK1
│       ├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      U-Boot binary for FSBL partition (basic boot chain) → STM32MP15STM32MP157C-DK2
Discovery kits |     ├── u-boot-spl.stm32-stm32mp157c-ev1-basic ├── Template:Purple                     U-Boot binary for FSBL partition (basic boot chain) → STM32MP157C-EV1
│       ├── u-boot-stm32mp157a-dk1-basic.img                            U-Boot binary for FSBLSSBL partition (basic boot chain) → STM32MP15STM32MP157A-DK1
Evaluation boards |     ├── u-boot-stm32mp157a-dk1-optee.elf ├── Template:Purple                           Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157A-DK1
│       ├── u-boot-stm32mp157a-dk1-optee.stm32                          U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1
│       ├── u-boot-stm32mp157a-dk1-trusted.elf                          Debug symbol file for U-Boot → STM32MP157A-DK1
│       ├── u-boot-stm32mp157a-dk1-trusted.stm32                        U-Boot binary for SSBL partition (trusted boot chain) → STM32MP157A-DK1
│       ├── u-boot-stm32mp157c-dk2-basic.img                            U-Boot binary for SSBL partition (basic boot chain) → STM32MP15STM32MP157C-DK2
Discovery kits |     ├── u-boot-stm32mp157c-dk2-optee.elf ├── Template:Rose                           Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2
│       ├── u-boot-stm32mp157c-dk2-optee.stm32                          U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE) OS STM32MP15STM32MP157C-DK2
Discovery kits |     ├── u-boot-stm32mp157c-dk2-trusted.elf                          Debug symbol file for U-Boot → STM32MP157C-DK2├── u-boot-stm32mp157c-dk2-trusted.stm32                        U-Boot binary for SSBL partition (trusted boot chain) → STM32MP15STM32MP157C-DK2
Discovery kits |       ├── Template:Purpleu-boot-stm32mp157c-ev1-basic.img                            U-Boot binary for SSBL partition (basic boot chain) → STM32MP15STM32MP157C-EV1
Evaluation boards |     ├── u-boot-stm32mp157c-ev1-optee.elf ├── Template:Rose                           Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1
│       ├── u-boot-stm32mp157c-ev1-optee.stm32                          U-Boot binary for SSBL partition (trusted boot chain), with OP-TEE) OS STM32MP15STM32MP157C-EV1
Evaluation boards |     ├── u-boot-stm32mp157c-ev1-trusted.elf                          Debug symbol file for U-Boot → STM32MP157C-EV1├── u-boot-stm32mp157c-ev1-trusted.stm32                        U-Boot binary for SSBL partition (trusted boot chain) → STM32MP15STM32MP157C-EV1
Evaluation boards |       ├── uImage                                                      Linux kernel binary image file (with U-Boot wrapper) for bootfs partition
|       ├── vmlinux                                                     Debug symbol file for Linux kernel
|       └── [...]
└── [...]



<noinclude>

{{ArticleMainWriter | Jean-ChristopheT}}
{{ReviewersList | NathalieS, BernardP, RomualdJ, DenisH, FrancoisC}}
{{ArticleApprovedVersion | Jean-ChristopheT | NathalieS | Jean-ChristopheT - 20Jun'18 | AnneJ - 11Jun'18 - 7649 | 21Sep'18}} 

[[Category:STM32MPU Embedded Software distribution]]</noinclude>

==Article purpose==
This article aims at proposing a way to organize, on the host PC, the software packages of the different Packages (Starter, Developer and Distribution) for a given release of the STM32MPU Embedded Software distribution.

The main objective of the proposed organization is to keep together the software packages corresponding to a given release because there are links between them. For example:
* Flashing the image from the Starter Package on the board is mandatory before modifying the source code from the Developer Package. Both the image and the source code must belong to the same software release.
* The SDK (Developer Package) and the image (Starter Package) have both been generated from the Distribution Package. A software release thus guarantees that there is no misalignment between the different software packages.
An example of organization for tools is proposed [[Example of directory structure for tools|here]].
{{info|The objective of this article is to describe one organization among all the possible organizations. Feel free to organize the delivered Packages in any other way that would better match your way of working.}}
{{info|In practice, this article uses the release '''STM32MP15-Ecosystem-v1.2.0''' for the STM32MPU Embedded Software distribution release issued on 03-July-2018 as an example to illustrate the proposed organization. If you are using a different release, the names of the directories and files might differ.}}{{UpdateNeededForNewRelease|The trees below shall be updated periodically, even if the information banner specifies that they might not be up-to-date}}

The directories are shown in {{Green|green}}, while the files are in black.

==Creating the structure==
* Create your <working directory> and assign a unique name to it (for example by including the release datename):
 {{PC$}} mkdir STM32MPU-Release-18-07-03
 {{PC$}} cd STM32MPU-Release-18-07-03STM32MP15-Ecosystem-v1.2.0
 {{PC$}} cd STM32MP15-Ecosystem-v1.2.0

* Create the first-level directories that will host the software packages delivered through the STM32MPU Embedded Software distribution release note:
 {{PC$}} mkdir Starter-Package
 {{PC$}} mkdir Developer-Package
 {{PC$}} mkdir Distribution-Package
* The resulting directory structure looks as follows:
 {{Green|STM32MPU-Release-18-07-03STM32MP15-Ecosystem-v1.2.0}}  {{Highlight|STM32MPU Embedded Software release}}
 ├── {{Green|Developer-Package}}          {{Highlight|Developer Package installation directory}}
 ├── {{Green|Distribution-Package}}       {{Highlight|Distribution Package installation directory}}
 └── {{Green|Starter-Package}}            {{Highlight|Starter Package installation directory}}

Once all software packages have been installed according to the instructions given in the STM32MPU Embedded Software distribution release note, the resulting directory structure looks as follows:
 {{Green|STM32MPU-Release-18-07-03}}                    STM32MP15-Ecosystem-v1.2.0}}                           {{Highlight|STM32MPU Embedded Software release}}
 ├── {{Green|Developer-Package}}                                {{Highlight|Developer Package installation directory}}
 │   ├── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|Linux kernel, U-Boot and TF-A source code (OpenSTLinux distribution)}}
 │   ├── {{Green|SDK}}                                  SDK}}                                          {{Highlight|SDK for OpenSTLinux distribution}}
 │   └──├── {{Green|STM32Cube_FW_MP1_V0.4V1.2.0}}              {{Highlight|STM32Cube MPU Package}}        {{Highlight|STM32CubeMP1 Package}}
 │   └── {{Green|stm32mp1-openstlinux-20-02-19}}  {{Highlight|Linux kernel, U-Boot, TF-A and OP-TEE OS source code (OpenSTLinux distribution)}}├── {{Green|Distribution-Package}}                             {{Highlight|Distribution Package installation directory}}
 │   └── {{Green|stm32mp1-openstlinux-4.14-rocko-mp1-18-07-0320-02-19}}  {{Highlight|OpenSTLinux distribution (full source code and OpenEmbedded-based build framework)}}
 └── {{Green|Starter-Package}}                                  {{Highlight|Starter Package installation directory}}
     └── {{Green|stm32mp1-openstlinux-4.14-rocko-mp1-18-07-0320-02-19}}  {{Highlight|Software image (binaries)}}

==Focus on the Starter Package directory==
The ''Starter-Package'' directory contains the software image for the STM32MPU Embedded Software distribution.

The trusted boot chain is the default solution delivered by STMicroelectronics. It includes the superset of features (for example, all Flash memory devices are supported). The basic boot chain is also upstreamed by STMicroelectronics, with a limited number of features (for example microSD card memory boot only). Refer to the [[Boot chains overview]] article for details.

Flash memory partitions (e.g. rootfs, bootfs...) are explained in the [[STM32MP15 Flash mapping]] article.

 {{Green|Starter-Package}}
 └── {{Green|stm32mp1-openstlinux-4.14-rocko-mp1-18-07-0320-02-19}}
     └── {{Green|images}}
         └── {{Green|stm32mp1}}
             ├── {{Green|flashlayout_st-image-weston}}                                 {{Highlight|Flash layout files (description of the partitions) for the supported Flash devices and boards}}
             │   ├── FlashLayout_emmc_stm32mp157c-ev1-trustedoptee.tsv              {{Highlight|Flash layout file for eMMC and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │   ├── FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv            {{Highlight|Flash layout file for eMMC and trusted boot chain → STM32MP15 Evaluation boardsSTM32MP157C-EV1}}
             │   ├── FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv        {{Highlight|Flash layout file for NAND Flash and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │   ├── FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv      {{Highlight|Flash layout file for NAND Flash and trusted boot chain → STM32MP15 Evaluation boardsSTM32MP157C-EV1}}
             │   ├── FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv          {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │   ├── FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv        {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15 Evaluation boardsSTM32MP157C-EV1}}
             │   ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv    {{Highlight|Flash layout file for NOR Flash (and NAND Flash) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │   ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv  {{Highlight|Flash layout file for NOR Flash (and NAND FlasdhFlash) and trusted boot chain → STM32MP15 Evaluation boardsSTM32MP157C-EV1}}
             │   ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv        {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │   ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv      {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15 Evaluation boardsSTM32MP157C-EV1}}
             │   ├── FlashLayout_sdcard_stm32mp157c-dk2stm32mp157a-dk1-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Discovery kitsSTM32MP157A-DK1}}
             │   ├── FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157A-DK1}}
             │   ├── FlashLayout_sdcard_stm32mp157c-dk2stm32mp157a-dk1-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Discovery kitsSTM32MP157A-DK1}}
             │   ├── FlashLayout_sdcard_stm32mp157a-dk1-extensible.tsv       {{Highlight|Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for [[Package_repository_for_OpenSTLinux_distribution|package repository]] service) → STM32MP157A-DK1}}
             │   ├── FlashLayout_sdcard_stm32mp157c-ev1dk2-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Evaluation boards}}
             │   └── FlashLayout_sdcard_stm32mp157c-ev1STM32MP157C-DK2}}
             │   ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-DK2}}
             │   ├── FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Evaluation boards}}
             ├── {{Green|scripts}}
             │   └── create_sdcard_from_flashlayout.sh
             ├── splash.bin                                                  {{Highlight|U-Boot splash screen picture (file in BMP format with a ''.bin'' extension) for NOR Flash}}STM32MP157C-DK2}}
             │   ├── FlashLayout_sdcard_stm32mp157c-dk2-extensible.tsv       {{Highlight|Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for [[Package_repository_for_OpenSTLinux_distribution|package repository]] service) → STM32MP157C-DK2}}
             │   ├── FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157C-EV1}}
             │   ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │   └── FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157C-EV1}}
             ├── {{Green|scripts}}
             │   └── create_sdcard_from_flashlayout.sh├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''bootfs'' partition}}
             ├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
             ├── st-image-userfs-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''userfs'' partition}}
             ├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
             ├── st-image-vendorfs-openstlinux-weston-stm32mp1.ext4          {{Highlight|Binary for ''vendorfs'' partition}}
             ├── st-image-weston-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''rootfs'' partition}}
             ├── st-image-weston-openstlinux-weston-stm32mp1.license
             ├── st-image-weston-openstlinux-weston-stm32mp1-license_content.html
             ├── st-image-weston-openstlinux-weston-stm32mp1.manifest
             ├── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
             ├── tf-a-stm32mp157c-dk2-trusted.stm32                          tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1}}
             ├── tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2}}
             ├── tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1}}
             ├── tf-a-stm32mp157a-dk1-optee.stm32                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
             ├── tf-a-stm32mp157c-ev1, with OP-TEE OS → STM32MP157A-DK1}}
             ├── tf-a-stm32mp157a-dk1-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boardsSTM32MP157A-DK1}}
             ├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      {{Highlight|U-Boottf-a-stm32mp157c-dk2-optee.stm32                            {{Highlight|TF-A binary for ''FSBL'' partition (basictrusted boot chain) → STM32MP15 Discovery kits}}
             ├── u-boot-spl.stm32-stm32mp157c-ev1-basic                      {{Highlight|U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
             ├── tf-a-stm32mp157c-dk2-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (basictrusted boot chain) → STM32MP15 Evaluation boardsSTM32MP157C-DK2}}
             ├── u-boottf-a-stm32mp157c-dk2-basic.imgev1-optee.stm32                            {{Highlight|U-BootTF-A binary for ''SSBLFSBL'' partition (basictrusted boot chain) → STM32MP15 Discovery kits}}
             ├── u-boot-stm32mp157c-dk2-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL, with OP-TEE OS → STM32MP157C-EV1}}
             ├── tf-a-stm32mp157c-ev1-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kitsSTM32MP157C-EV1}}
             ├── u-boot-stm32mp157c-ev1-basic.img                            spl.stm32-stm32mp157a-dk1-basic                      {{Highlight|U-Boot binary for ''SSBLFSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
             └── u-boot-stm32mp157c-ev1-trusted.stm32                        STM32MP157A-DK1}}
             ├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      {{Highlight|U-Boot binary for ''SSBLFSBL'' partition (trustedbasic boot chain) → STM32MP15 Evaluation boards}}

==Focus on the Developer Package directory==
The ''Developer-Package'' directory contains:
* The source code for the following OpenSTLinux software packages (development for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A processor):
** TF-A
** Linux kernel
** U-Boot
* The debug symbol files for Linux kernel, U-Boot and TF-A
* The SDK (for cross-development on an host PC)
* The STM32Cube MPU Package (developed for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-M processor)

 {{Green|Developer-Package}}
 ├── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|Source code for OpenSTLinux distribution}}
 │   ├── {{Green|images}}
 │   │   └── {{Green|stm32mp1}}                                {{Highlight|'''Debug symbol files installation directory'''}}
 │   │       ├── tf-a-bl2-trusted.elf                {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
 │   │       ├── tf-a-bl32-trusted.elf               {{Highlight|Debug symbol file for TF-A → runtime software stage}}
 │   │       STM32MP157C-DK2}}
             ├── u-boot-spl.stm32-stm32mp157c-ev1-basic                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
             ├── u-boot-stm32mp157a-dk1-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
             ├── u-boot-stm32mp157a-dk1-optee.stm32                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
             ├── u-boot-stm32mp157a-dk1-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
             ├── u-boot-stm32mp157c-dk2-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
             ├── u-boot-stm32mp157c-dk2-optee.stm32                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}├── u-boot-stm32mp157c-dk2-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP15 Discovery kits}}
 │   │       stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}├── u-boot-stm32mp157c-ev1-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP15 Evaluation boards}}
 │   │       └── vmlinux                             {{Highlight|Debug symbol file for Linux kernel}}

 │   └── {{Green|sources}}
 │       └── {{Green|arm-openstlinux_weston-linux-gnueabi}}
 │           ├── {{Green|linux-stm32mp-4.14-48}}     {{Highlight|'''Linux kernel installation directory'''}}
 │           │   ├── [*].patch             {{Highlight|ST patches for Linux kernel}}
 │           │   ├── fragment-[*].config   {{Highlight|ST configuration fragments for Linux kernel}}
 │           │   ├── {{Green|linux-4.14.48}}         {{Highlight|'''Linux kernel source code directory'''}}
 │           │   ├── linux-4.14.48.tar.xz
 │           │   ├── README.HOW_TO.txt     {{Highlight|Helper file for Linux kernel management: '''reference''' for Linux kernel build}}
 │           │   └── series

 │           ├── {{Green|tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c}}             {{Highlight|'''TF-A installation directory'''}}
 │           │   ├── [*].patch                                           {{Highlight|ST patches for TF-A}}
 │           │   ├── {{Green|git}}                                                 {{Highlight|'''TF-A source code directory'''}}
 │           │   ├── Makefile.sdk                                        {{Highlight|Makefile for the TF-A compilation}}
 │           │   ├── README.HOW_TO.txt                                   {{Highlight|Helper file for TF-A management: '''reference''' for TF-A build}}
 │           │   ├── series
 │           │   └── tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c.tar.gz

 │           └── {{Green|u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e}}             {{Highlight|'''U-Boot installation directory'''}}
 │               ├── [*].patch                                                         {{Highlight|ST patches for U-Boot}}
 │               ├── {{Green|git}}                                                               {{Highlight|'''U-Boot source code directory'''}}
 │               ├── Makefile.sdk                                                      {{Highlight|Makefile for the U-Boot compilation}}
 │               ├── README.HOW_TO.txt                                                 {{Highlight|Helper basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
             ├── u-boot-stm32mp157c-ev1-optee.stm32                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
             └── u-boot-stm32mp157c-ev1-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}

==Focus on the Developer Package directory==
The ''Developer-Package'' directory contains:
* The source code for the following OpenSTLinux software packages (development for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A processor):
** Linux<sup>&reg;</sup> kernel
** U-Boot
** TF-A
** OP-TEE OS
* The debug symbol files for Linux kernel, U-Boot, TF-A and OP-TEE OS
* The SDK (for cross-development on an host PC)
* The STM32Cube MPU Package (developed for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-M processor)

 {{Green|Developer-Package}}
 ├── {{Green|SDK}}                                                                             {{Highlight|'''SDK for OpenSTLinux distribution''': details in [[Standard SDK directory structure]] article}}
 │   ├── environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi  {{Highlight|'''Environment setup script''' for Developer Package}}
 │   ├── site-config-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi
 │   ├── {{Green|sysroots}}
 │   │   ├── {{Green|cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi}}                {{Highlight|Target sysroot (libraries, headers, and symbols)}}
 │   │   │   └── [...]
 │   │   └── {{Green|x86_64-ostl_sdk-linux}}                                     {{Highlight|Native sysroot (libraries, headers, and symbols)}}
 │   │       └── [...]
 │   └── version-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi

 ├── {{Green|STM32Cube_FW_MP1_V''X.Y.Z''}}             {{Highlight|'''STM32CubeMP1 Package''': details in [[STM32CubeMP1 Package#STM32CubeMP1 Package Content|STM32CubeMP1 Package content]] article}}
 │   ├── {{Green|Drivers}}
 │   │   ├── {{Green|BSP}}                         {{Highlight|BSP drivers for the supported STM32MPU boards}}
 │   │   │   └── [...]
 │   │   ├── {{Green|CMSIS}}
 │   │   │   └── [...]
 │   │   └── {{Green|STM32MP1xx_HAL_Driver}}       {{Highlight|HAL drivers for the supported STM32MPU devices}}
 │   │       └── [...]
 │   ├── {{Green|_htmresc}}
 │   │   └── [...]
 │   ├── License.md                      {{Highlight|License types for the components}}
 │   ├── {{Green|Middlewares}}                     {{Highlight|Middlewares used by the examples and applications}}
 │   │   └── [...]
 │   ├── package.xml
 │   ├── {{Green|Projects}}
 │   │   ├── STM32CubeProjectsList.html  {{Highlight|List of examples and applications for STM32CubeMP1 Package}}
 │   │   ├── {{Green|STM32MP157C-DK2}}             {{Highlight|Set of examples and applications → STM32MP157C-DK2}}
 │   │   │   └── [...]
 │   │   └── {{Green|STM32MP157C-EV1}}             {{Highlight|Set of examples and applications → STM32MP157C-EV1}}
 │   │       └── [...]
 │   ├── Readme.md
 │   ├── Release_Notes.html              {{Highlight|Release note for STM32CubeMP1 Package}}
 │   └── {{Green|Utilities}}
 │       └── [...]

 └── {{Green|stm32mp1-openstlinux-20-02-19}}     {{Highlight|Source code for OpenSTLinux distribution}}
     ├── {{Green|images}}
     │   └── {{Green|stm32mp1}}                                {{Highlight|'''Debug symbol files installation directory'''}}
     │       ├── tf-a-bl2-optee.elf                  {{Highlight|Debug symbol file for TF-A, with OP-TEE OS → trusted boot firmware stage}}
     │       ├── tf-a-bl2-trusted.elf                {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
     │       ├── tf-a-bl32-trusted.elf               {{Highlight|Debug symbol file for TF-A → runtime software stage}}
     │       ├── u-boot-stm32mp157a-dk1-optee.elf    {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157A-DK1}}
     │       ├── u-boot-stm32mp157a-dk1-trusted.elf  {{Highlight|Debug symbol file for U-Boot management: '''reference''' for U-Boot build}}
 │               ├── series
 │               └── u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e.tar.gz

 ├── {{Green|SDK}}                                                                           {{Highlight|'''SDK for OpenSTLinux distribution''': details in [[Standard SDK directory structure]] article}}
 │   ├── environment-setup-cortexa7hf-neon-vfpv4-→ STM32MP157A-DK1}}
     │       ├── u-boot-stm32mp157c-dk2-optee.elf    {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
     │       ├── u-boot-stm32mp157c-dk2-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP157C-DK2}}
     │       ├── u-boot-stm32mp157c-ev1-optee.elf    {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1}}
     │       ├── u-boot-stm32mp157c-ev1-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP157C-EV1}}
     │       └── vmlinux                             {{Highlight|Debug symbol file for Linux kernel}}

     └── {{Green|sources}}
         └── {{Green|arm-openstlinux_weston-linux-gnueabi  {{Highlight|'''Environment setup script''' for Developer Package}}
 │   ├── site-config-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi
 │   ├── {{Green|sysroots}}
 │   │   ├── {{Green|cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi}}                {{Highlight|Target sysroot (libraries, headers, and symbols)}}
 │   │   │   └── [...]
 │   │   └── {{Green|x86_64-openstlinux_weston_sdk-linux}}                                   {{Highlight|Native sysroot (libraries, headers, and symbols)}}
 │   │       └── [...]
 │   └── version-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi

 └── {{Green|STM32Cube_FW_MP1_V0.4.0}}                             {{Highlight|'''STM32Cube MPU Package''': details in [[STM32CubeMP1 Package#STM32CubeMP1 Package Content|STM32Cube MPU Package content]] article}}
     ├── COPYING
     ├── COPYING.BSD-3
     ├── {{Green|Drivers}}
     │   ├── {{Green|BSP}}                                         {{Highlight|BSP drivers for the supported STM32MPU boards}}
     │   │   └── [...]
     │   ├── {{Green|CMSIS}}
     │   │   └── [...]
     │   └── {{Green|STM32MP1xx_HAL_Driver}}                       {{Highlight|HAL drivers for the supported STM32MPU devices}}
     │       └── [...]
     ├── {{Green|_htmresc}}
     │   └── [...]
     ├── LLA_evaluation_for_STM32MPU_17-12-06_plain.txt
     ├── {{Green|Middlewares}}
     │   └── [...]
     ├── package.xml
     ├── {{Green|Projects}}
     │   ├── STM32CubeProjectsList.html                  {{Highlight|List of examples and applications for STM32Cube MP1 Package}}
     │   ├── {{Green|STM32MP15_DISCO}}                             {{Highlight|Set of examples and applications → STM32MP15 Discovery kits}}
     │   │   └── [...]
     │   └── {{Green|STM32MP15_EVAL}}                              {{Highlight|Set of examples and applications → STM32MP15 Evaluation boards}}
     │       └── [...]
     ├── Release_Notes.html                              {{Highlight|Release note for STM32Cube MP1 Package}}
     └── {{Green|Utilities}}
         └── [...]}}
             ├── {{Green|linux-stm32mp-''X.Y-rR''}}    {{Highlight|'''Linux kernel installation directory'''}}
             │   ├── [*].patch            {{Highlight|ST patches for Linux kernel}}
             │   ├── fragment-[*].config  {{Highlight|ST configuration fragments for Linux kernel}}
             │   ├── {{Green|linux-''X.Y.Z''}}         {{Highlight|'''Linux kernel source code directory'''}}
             │   ├── linux-''X.Y.Z''.tar.xz
             │   ├── README.HOW_TO.txt    {{Highlight|Helper file for Linux kernel management: '''reference''' for Linux kernel build}}
             │   └── series

             ├── {{Green|optee-os-stm32mp-''X.Y.Z-rR''}}  {{Highlight|'''OP-TEE OS installation directory'''}}
             │   ├── [*].patch              {{Highlight|ST patches for OP-TEE OS}}
             │   ├── ''X.Y.Z''.tar.gz
             │   ├── Makefile.sdk           {{Highlight|Makefile for the OP-TEE OS compilation}}
             │   ├── {{Green|optee_os-''X.Y.Z''}}         {{Highlight|'''OP-TEE OS source code directory'''}}
             │   ├── README.HOW_TO.txt      {{Highlight|Helper file for OP-TEE OS management: '''reference''' for OP-TEE OS build}}
             │   └── series

             ├── {{Green|tf-a-stm32mp-''X.Y-rR''}}           {{Highlight|'''TF-A installation directory'''}}
             │   ├── [*].patch                 {{Highlight|ST patches for TF-A}}
             │   ├── {{Green|arm-trusted-firmware-''X.Y''}}  {{Highlight|'''TF-A source code directory'''}}
             │   ├── Makefile.sdk              {{Highlight|Makefile for the TF-A compilation}}
             │   ├── README.HOW_TO.txt         {{Highlight|Helper file for TF-A management: '''reference''' for TF-A build}}
             │   ├── series
             │   └── v''X.Y''.tar.gz

             └── {{Green|u-boot-stm32mp-''YYYY.MM-rR''}}  {{Highlight|'''U-Boot installation directory'''}}
                 ├── [*].patch              {{Highlight|ST patches for U-Boot}}
                 ├── Makefile.sdk           {{Highlight|Makefile for the U-Boot compilation}}
                 ├── README.HOW_TO.txt      {{Highlight|Helper file for U-Boot management: '''reference''' for U-Boot build}}
                 ├── series
                 ├── {{Green|u-boot-''YYYY.MM-rR''}}         {{Highlight|'''U-Boot source code directory'''}}
                 └── v''YYYY.MM''.tar.gz


[[#Appendix A: directory structure after build (Developer Package)|Appendix A]] shows the structure of the Linux kernel, U-Boot and , TF-A and OP-TEE OS installation directories after these software packages have been built.

==Focus on the Distribution Package directory==
The ''Distribution-Package'' directory contains all the OpenEmbedded layers required to get the source code of any STM32MPU Embedded Software component, as well as a build framework based on OpenEmbedded.

 {{Green|Distribution-Package}}
 └── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|OpenSTLinux distribution}}20-02-19}}  {{Highlight|'''OpenSTLinux distribution'''}}
     └── {{Green|layers}}├── {{Green|meta-openembedded}}  {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}    │   └── [...]    ├── {{Green|meta-qt5}}           {{Highlight|QT5 layer for OpenEmbedded (standard)}}    │   └── [...]
    ├── {{Green|meta-st}}    │   ├── {{Green|meta-st-openstlinux}}                   {{Highlight|STMicroelectronics layer that contains the settings of the frameworks and images for the OpenSTLinux distribution}}    │   │   ├── {{Green|recipes-samples}}    │   │   │   └──├── {{Green|images}}    │   │   │       |   ├── st-example-image-qt.bb    {{Highlight|ST example of image based on QT framework}}    │   │   │       |   ├── st-example-image-x11.bb   {{Highlight|ST example of image based on X11}}    │   │   │       └── |   ├── st-example-image-xfce.bb  {{Highlight|ST example of image based on XFCE framework}}    │   │   │   |   └── st-image-userfs.bbappend  {{Highlight|Additional packages (application launcher, demo...) for ST Weston image}}
         │   │   │   └── [...]
         │   │   ├── {{Green|recipes-st}}    │   │   │   ├── {{Green|images}}    │   │   │   │   ├── st-image-core.bb          {{Highlight|Core image for OpenSTLinux distribution}}    │   │   │   │   ├── st-image.inc    │   │   │   │   └── st-image-weston.bb        {{Highlight|Weston image with basic Wayland support for OpenSTLinux distribution: '''recommended setup'''setup}}}}│   │   │   └── {{Green|packagegroups}}    │   │   │       └── [...]    │   │   └── [...]
    │   ├── {{Green|meta-st-stm32mp}}                   {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}    │   │   ├── {{Green|recipes-bsp}}    │   │   │   ├── {{Green|alsa}}                      {{Highlight|Recipes for ALSA control configuration}}    │   │   │   │   └── [...]    │   │   │   ├── {{Green|drivers}}                   {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}    │   │   │   │   └── [...]    │   │   │   ├── {{Green|trusted-firmware-a}}        {{Highlight|Recipes for TF-A}}    │   │   │   │   └── [...]    │   │   │   └── {{Green|u-boot}}                    {{Highlight|Recipes for U-Boot}}    │   │   │       └── [...]    │   │   ├── {{Green|recipes-extended}}    │   │   │   ├── {{Green|m4projects}}                {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}    │   │   │   │   └── [...]│   │   │   ├── {{Green|openocd}}                 {{Highlight|Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M}}
     │   │   │   │   └── [...]
     │   │   │   └── {{Green|stlink}}                  {{Highlight|Recipes for STLink}}
     │   │   │       └── [...]
     │   │       │   │   │   └── [...]
         │   │   ├── {{Green|recipes-graphics}}    │   │   │   ├── {{Green|gcnano-userland}}           {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}    │   │   │   │   └── [...]    │   │   │   └── [...]    │   │   ├── {{Green|recipes-kernel}}    │   │   │   └── {{Green|linux}}                     {{Highlight|Recipes for Linux kernel}}    │   │   │       └── [...]    │   │   │   └── {{Green|linux-firmware}}            {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}    │   │   │       └── [...]    │   │   ├── {{Green|recipes-st}}    │   │   │   └── {{Green|images}}    │   │   │       ├── st-image-bootfs.bb    {{Highlight|Recipes for the ''bootfs'' partition binary}}    │   │   │       └──├── st-image-userfs.bb    {{Highlight|Recipes for the ''userfs'' partition binary}}    │   │   └── [...]
│       └── st-image-vendorfs.bb  {{Highlight|Recipes for the ''vendorfs'' partition binary}}
         │   │   └── [...]
│   ├── {{Green|meta-st-stm32mp-addons}}  {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}    │       └── [...]    │   └── {{Green|scripts}}    │       ├── envsetup.sh         {{Highlight|'''Environment setup script''' for Distribution Package}}    │       └── [...]
└── {{Green|openembedded-core}}  {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
         └── [...]

{{InternalInfo| Additional layer for internal usage
└── {{Green|st-hands-on}}  {{Highlight|STMicroelectronics layer that contains the reference source code for the hands-on}}
}}

[[     ├── {{Green|meta-timesys}}       {{Highlight|Timesys layer for OpenEmbedded (standard)}}
         │   └── [...]
         └── {{Green|openembedded-core}}  {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
             └── [...]

[[#Appendix B: directory structure after build (Distribution Package)|Appendix B]] shows the structure of the build directory.

==Appendix A: directory structure after build (Developer Package)==
Provided you have followed the recommendations of the ''README.HOW_TO.txt'' helper files to build the Linux kernel, the U-Boot and the TF-A, then the following {{Green|new directories and files}} contain the build outputs.

 Developer-Package
 ├── stm32mp1-openstlinux-4.14-rocko-mp1-18-07-03 20-02-19  {{Highlight|Source code for OpenSTLinux distribution}}
 │   └── sources
 │       └── arm-openstlinux_weston-linux-gnueabi
 │           ├── linux-stm32mp-4.14-48                 ''X.Y-rR''                   {{Highlight|'''Linux kernel installation directory'''}}
 │           │   ├── {{Green|build}}                               {{Highlight|'''Linux kernel build directory'''}}
 │           │   │   ├── {{Green|install_artifact}}
 │           │   │   │   ├── {{Green|lib}}
 │           │   │   │   │   └── {{Green|modules}}
 │           │   │   │   │       └── {{Green|4.14.48''X.Y.Z''}}
 │           │   │   │   │           └── {{Green|[...]}}           {{Highlight|Kernel modules hierarchy (''*.ko'' files)}}
 │           │   │   │   └── {{Green|boot}}
 │           │   │   │       ├── {{Green|stm32mp157c-dstm32mp157a-dk1[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Discovery kitsSTM32MP157A-DK1}}
 │           │   │   │       ├── {{Green|stm32mp157c-edk2[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Evaluation boards}}STM32MP157C-DK2}}
 │           │   │   │       ├── {{Green|stm32mp157c-ev1[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157C-EV1}}│           │   │   │       ├── {{Green|uImage}}                  {{Highlight|Linux kernel binary image file (with U-Boot wrapper) for ''bootfs'' partition}}
 │           │   │   │       └── {{Green|[...]}}
 │           │   │   ├── {{Green|vmlinux}}                         {{Highlight|Debug symbol file for Linux kernel}}
 │           │   │   └── {{Green|[...]}}
 │           │   └── [...]

 │           ├── tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c optee-os-stm32mp-''X.Y.Z-rR''                                           {{Highlight|'''OP-TEE OS installation directory'''}}
 │           │   ├── {{Green|build}}                                                           {{Highlight|'''OP-TEE OS build directory'''}}
 │           │   │   ├── {{Green|tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1}}
 │           │   │   ├── {{Green|tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2}}
 │           │   │   ├── {{Green|tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1}}
 │           │   │   └── {{Green|[...]}}
 │           │   └── [...]

 │           ├── tf-a-stm32mp-''X.Y-rR''                             {{Highlight|'''TF-A installation directory'''}}
 │           │   ├── {{Green|build}}                                       {{Highlight|'''TF-A build directory'''}}
 │           │   │   ├── {{Green|tf-a-bl2-trusted.optee}}                                   {{Highlight|TF-A, with OP-TEE OS}}
 │           │   │   │   ├── {{Green|tf-a-bl2-optee.elf}}                  {{Highlight|Debug symbol file for TF-A, with OP-TEE OS → trusted boot firmware stage}}
 │           │   │   │   ├── {{Green|tf-a-stm32mp157a-dk1-optee.stm32}}    {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
 │           │   │   │   ├── {{Green|tf-a-stm32mp157c-dk2-optee.stm32}}    {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
 │           │   │   │   ├── {{Green|tf-a-stm32mp157c-ev1-optee.stm32}}    {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
 │           │   │   │   └── {{Green|[...]}}
 │           │   │   └── {{Green|trusted}}                                 {{Highlight|TF-A, without OP-TEE OS}}
 │           │   │       ├── {{Green|tf-a-bl2-trusted.elf}}                {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
 │           │   │       ├── {{Green|tf-a-bl32-trusted.elf}}               {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
 │           │   │       ├── {{Green|tf-a-stm32mp157c-dk2stm32mp157a-dk1-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
 │           │   │   STM32MP157A-DK1}}
 │           │   │       ├── {{Green|tf-a-stm32mp157c-dk2-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
 │           │   │       ├── {{Green|tf-a-stm32mp157c-ev1-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boardsSTM32MP157C-EV1}}
 │           │   │       └── {{Green|[...]}}
 │           │   └── [...]

 │           └── u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e ''YYYY.MM-rR''                       {{Highlight|'''U-Boot installation directory'''}}
 │               ├── {{Green|build-stm32mp15_trusted_defconfig}}                     basic}}                                 {{Highlight|'''U-Boot build directory for basic boot chain'''}}
 │               │   ├── {{Green|u-boot-stm32mp157c-dk2-trusted.elf}}                {{Highlight|spl.stm32-stm32mp157a-dk1-basic}}  {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
 │               │   ├── {{Green|u-boot-spl.stm32-stm32mp157c-dk2-basic}}  {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
 │               │   ├── {{Green|u-boot-spl.stm32-stm32mp157c-ev1-basic}}  {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
 │               │   ├── {{Green|u-boot-stm32mp157a-dk1-basic.img}}        {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
 │               │   ├── {{Green|u-boot-stm32mp157c-dk2-basic.img}}        {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
 │               │   ├── {{Green|u-boot-stm32mp157c-ev1-basic.img}}        {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
 │               ├── {{Green|build-optee}}                                 {{Highlight|'''U-Boot build directory for trusted boot chain, with OP-TEE OS'''}}
 │               │   ├── {{Green|u-boot-stm32mp157a-dk1-optee.elf}}        {{Highlight|Debug symbol file for U-Boot → STM32MP15 Discovery kits}}, with OP-TEE OS → STM32MP157A-DK1}}
 │               │   ├── {{Green|u-boot-stm32mp157a-dk1-optee.stm32}}      {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}│               │   ├── {{Green|u-boot-stm32mp157c-dk2-trusted.stm32}}              {{optee.elf}}        {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
 │               │   ├── {{Green|u-boot-stm32mp157c-dk2-optee.stm32}}      {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}, with OP-TEE OS → STM32MP157C-DK2}}
 │               │   ├── {{Green|u-boot-stm32mp157c-ev1-optee.elf}}        {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1}}│               │   ├── {{Green|u-boot-stm32mp157c-ev1-trusted.elf}}                {{Highlight|optee.stm32}}      {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
 │               │   └── {{Green|[...]}}
 │               ├── {{Green|build-trusted}}                               {{Highlight|'''U-Boot build directory for trusted boot chain'''}}
 │               │   ├── {{Green|u-boot-stm32mp157a-dk1-trusted.elf}}      {{Highlight|Debug symbol file for U-Boot → STM32MP15 Evaluation boards}}STM32MP157A-DK1}}
 │               │   ├── {{Green|u-boot-stm32mp157a-dk1-trusted.stm32}}    {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}│               │   ├── {{Green|u-boot-stm32mp157c-ev1dk2-trusted.stm32}}              {{elf}}      {{Highlight|Debug symbol file for U-Boot → STM32MP157C-DK2}}
 │               │   ├── {{Green|u-boot-stm32mp157c-dk2-trusted.stm32}}    {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
 │               │   STM32MP157C-DK2}}
 │               │   ├── {{Green|u-boot-stm32mp157c-ev1-trusted.elf}}      {{Highlight|Debug symbol file for U-Boot → STM32MP157C-EV1}}
 │               │   ├── {{Green|u-boot-stm32mp157c-ev1-trusted.stm32}}    {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
 │               │   └── {{Green|[...]}}
 │               └── [...]

==Appendix B: directory structure after build (Distribution Package)==
Provided you have followed the build method explained in [[OpenSTLinux distribution]], then the following {{Green|new directories}} contain the build outputs.

As long as you did not modify the source code:
* the {{PurpleSTPurple|files in purpleSTPurple}} are the same as the ones available in the '''Starter Package''': flash layout, binaries for ''bootfs'', ''userfs'' and ''rootfsrootfs'', ''userfs'' and ''vendorfs'' partitions
* the {{Grey|files in grey}} are the same as the ones available in the '''Starter and Developer Packages''': binaries for ''FSBL'' and ''SSBL'' partitions
, and for OP-TEE OS runtime services* the {{Orange|files in orange}} are the same as the ones available in the '''Developer Package''': Linux kernel image and device tree blobs

* the {{Rose|files in pink}} are only available in the '''Distribution Package''': they concern the OP-TEE (see [[How to populate and boot a board with OP-TEE]])

 Distribution-Package/openstlinux-4.14-rocko-mp1-18-07-03/build-openstlinuxweston-stm32mp1, and debug symbol files

 Distribution-Package/openstlinux-20-02-19 /build-openstlinuxweston-stm32mp/{{Green|tmp-glibc/deploy}}└──├── {{Green|images}}|   └── {{Green|stm32mp1}}|       ├── {{PurpleSTPurple|flashlayout_st-image-weston}}                                 {{Highlight|Flash layout files (description of the partitions) for the supported flash devices}}|       │   ├── {{RoseSTPurple|FlashLayout_emmc_stm32mp157c-ev1-optee.tsv}}              {{Highlight|Flash layout file for eMMC and OP-TEE → STM32MP15 Evaluation boards}}
 |       │   ├── {{Purpletrusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv}}            {{Highlight|Flash layout file for eMMC and trusted boot chain → STM32MP15 Evaluation boards}}
 |       │   ├── {{RoseSTM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv}}        {{Highlight|Flash layout file for NAND Flash and OP-TEE → STM32MP15 Evaluation boards}}
 |       │   ├── {{Purpletrusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv}}      {{Highlight|Flash layout file for NAND Flash and trusted boot chain → STM32MP15 Evaluation boards}}
 |       │   ├── {{RoseSTM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv}}          {{Highlight|Flash layout file for NOR Flash (and eMMC) and OP-TEE → STM32MP15 Evaluation boards}}
 |       │   ├── {{Purpletrusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv}}        {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15 Evaluation boards}}
 |       │   ├── {{RoseSTM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv}}    {{Highlight|Flash layout file for NOR Flash (and NAND FlasdhFlash) and OP-TEE → STM32MP15 Evaluation boards}}
 |       │   ├── {{Purpletrusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv}}  {{Highlight|Flash layout file for NOR Flash (and NAND FlasdhFlash) and trusted boot chain → STM32MP15 Evaluation boards}}
 |       │   ├── {{RoseSTM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv}}        {{Highlight|Flash layout file for NOR Flash (and microSD card) and OP-TEE → STM32MP15 Evaluation boards}}
 |       │   ├── {{Purpletrusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv}}      {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15 Evaluation boards}}
 |       │   ├── {{Purple|FlashLayout_sdcard_stm32mp157c-dk2STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157a-dk1-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Discovery kits}}
 |       │   ├── {{Rose|FlashLayout_sdcard_stm32mp157c-dk2STM32MP157A-DK1}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv}}            {{Highlight|Flash layout file for microSD card and OP-TEE → STM32MP15 Discovery kits}}
 |       │   ├── {{Purple|FlashLayout_sdcard_stm32mp157c-dk2trusted boot chain, with OP-TEE OS → STM32MP157A-DK1}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157a-dk1-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Discovery kits}}
 |       │   ├── {{Purple|FlashLayout_sdcard_stm32mp157c-ev1STM32MP157A-DK1}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Evaluation boards}}

 |       │   ├── {{Rose|FlashLayout_sdcard_stm32mp157c-ev1STM32MP157C-DK2}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv}}            {{Highlight|Flash layout file for microSD card and OP-TEE → STM32MP15 Evaluation boards}}
 |       │   └── {{Purple|FlashLayout_sdcard_stm32mp157c-ev1trusted boot chain, with OP-TEE OS → STM32MP157C-DK2}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Evaluation boards}}
 |       │   └── [...]
 |       ├── {{Purple|scripts}}
 |       │   └── {{Purple|create_sdcard_from_flashlayout.sh}}
 |       ├── {{Purple|splash.bin}}                                                  {{Highlight|U-Boot splash screen picture (file in BMP format with a ''.bin'' extension) for NOR Flash}}
 |       ├── {{PurpleSTM32MP157C-DK2}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157C-EV1}}
 │       │   ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv}}            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
 │       │   └── {{STPurple|FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157C-EV1}}
 │       │   └── [...]
 │       ├── {{STPurple|scripts}}
 │       │   └── {{STPurple|create_sdcard_from_flashlayout.sh}}

 │       ├── {{STPurple|st-image-bootfs-openstlinux-weston-stm32mp1.ext4}}            {{Highlight|Binary for ''bootfs'' partition}}|       ├── {{PurpleSTPurple|st-image-userfs-openstlinux-weston-stm32mp1.ext4}}            {{Highlight|Binary for ''userfs'' partition}}|       ├── {{Purple│       ├── {{STPurple|st-image-vendorfs-openstlinux-weston-stm32mp1.ext4}}          {{Highlight|Binary for ''vendorfs'' partition}}
 │       ├── {{STPurple|st-image-weston-openstlinux-weston-stm32mp1.ext4}}            {{Highlight|Binary for ''rootfs'' partition}}|       ├── {{Orange|stm32mp157c-dstm32mp157a-dk1[*].dtb}}                                        {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Discovery kits}}
 |       STM32MP157A-DK1}}
 │       ├── {{Orange|stm32mp157c-dk2[*].dtb}}                                      {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157C-DK2}}
 │       ├── {{Orange|stm32mp157c-e[*].dtb}}                                        {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Evaluation boards}}
 |       ├── {{Rose|STM32MP157C-EV1}}
 │       ├── {{Grey|tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1}}
 │       ├── {{Grey|tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2}}
 │       ├── {{Grey|tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1}}
 │       ├── {{Orange|tf-a-bl2-optee.elf}}                                          {{Highlight|Debug symbol file for TF-A and, with OP-TEE OS → trusted boot firmware stage}}|       ├── {{Orange|tf-a-bl2-trusted.elf}}                                        {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}|       ├── {{Orange|tf-a-bl32-trusted.elf}}                                       {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
 |       ├── {{Rose|tf-a-stm32mp157c-dk2runtime software stage}}
 │       ├── {{Grey|tf-a-stm32mp157a-dk1-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (OP-TEE) → STM32MP15 Discovery kits}}
 |       trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
 │       ├── {{Grey|tf-a-stm32mp157a-dk1-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
 │       ├── {{Grey|tf-a-stm32mp157c-dk2-trustedoptee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
 |       ├── {{Rose, with OP-TEE OS → STM32MP157C-DK2}}
 │       ├── {{Grey|tf-a-stm32mp157c-dk2-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
 │       ├── {{Grey|tf-a-stm32mp157c-ev1-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (OP-TEE) → STM32MP15 Evaluation boards}}
 |trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
 │       ├── {{Grey|tf-a-stm32mp157c-ev1-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}

 |       ├── {{PurpleSTM32MP157C-EV1}}
 │       ├── {{Grey|u-boot-spl.stm32-stm32mp157a-dk1-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
 │       ├── {{Grey|u-boot-spl.stm32-stm32mp157c-dk2-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP15 Discovery kits}}
 |       ├── {{PurpleSTM32MP157C-DK2}}
 │       ├── {{Grey|u-boot-spl.stm32-stm32mp157c-ev1-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
 |       ├── {{Purple|u-boot-STM32MP157C-EV1}}
 │       ├── {{Grey|u-boot-stm32mp157a-dk1-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
 │       ├── {{Orange|u-boot-stm32mp157a-dk1-optee.elf}}                            {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157A-DK1}}
 │       ├── {{Grey|u-boot-stm32mp157a-dk1-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
 │       ├── {{Orange|u-boot-stm32mp157a-dk1-trusted.elf}}                          {{Highlight|Debug symbol file for U-Boot → STM32MP157A-DK1}}
 │       ├── {{Grey|u-boot-stm32mp157a-dk1-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
 │       ├── {{Grey|u-boot-stm32mp157c-dk2-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP15 Discovery kits}}
 |       ├── {{RoseSTM32MP157C-DK2}}
 │       ├── {{Orange|u-boot-stm32mp157c-dk2-optee.elf}}                            {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
 │       ├── {{Grey|u-boot-stm32mp157c-dk2-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (OP-TEE) → STM32MP15 Discovery kits}}
 |       trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
 │       ├── {{Orange|u-boot-stm32mp157c-dk2-trusted.elf}}                          {{Highlight|Debug symbol file for U-Boot → STM32MP157C-DK2}}
 │       ├── {{Grey|u-boot-stm32mp157c-dk2-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
 |       ├── {{PurpleSTM32MP157C-DK2}}
 │       ├── {{Grey|u-boot-stm32mp157c-ev1-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
 |       ├── {{RoseSTM32MP157C-EV1}}
 │       ├── {{Orange|u-boot-stm32mp157c-ev1-optee.elf}}                            {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1}}
 │       ├── {{Grey|u-boot-stm32mp157c-ev1-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (OP-TEE) → STM32MP15 Evaluation boards}}
 |       trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
 │       ├── {{Orange|u-boot-stm32mp157c-ev1-trusted.elf}}                          {{Highlight|Debug symbol file for U-Boot → STM32MP157C-EV1}}
 │       ├── {{Grey|u-boot-stm32mp157c-ev1-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
 |STM32MP157C-EV1}}
 │       ├── {{Orange|uImage}}                                                      {{Highlight|Linux kernel binary image file (with U-Boot wrapper) for ''bootfs'' partition}}|       ├── {{Orange|vmlinux}}                                                     {{Highlight|Debug symbol file for Linux kernel}}|       └── [...]
 └── [...]

<noinclude>

{{PublicationRequestId | 7649  | 2018-06-11 | AnneJ}}
[[Category:STM32MPU Embedded Software distribution]]</noinclude>
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>
 
{{ArticleMainWriter | Jean-ChristopheT}}
 
{{ReviewersList | NathalieS, BernardP, RomualdJ, DenisH, FrancoisC}}
 
{{ArticleApprovedVersion | Jean-ChristopheT | NathalieS | Jean-ChristopheT - 20Jun'18 | AnneJ - 11Jun'18 - 7649 | 21Sep'18}}
 
 
[[Category:STM32MPU Embedded Software distribution]]
 
</noinclude>
 
 
 
==Article purpose==
 
==Article purpose==
 
This article aims at proposing a way to organize, on the host PC, the software packages of the different Packages (Starter, Developer and Distribution) for a given release of the STM32MPU Embedded Software distribution.
 
This article aims at proposing a way to organize, on the host PC, the software packages of the different Packages (Starter, Developer and Distribution) for a given release of the STM32MPU Embedded Software distribution.
Line 14: Line 6:
 
* The SDK (Developer Package) and the image (Starter Package) have both been generated from the Distribution Package. A software release thus guarantees that there is no misalignment between the different software packages.
 
* The SDK (Developer Package) and the image (Starter Package) have both been generated from the Distribution Package. A software release thus guarantees that there is no misalignment between the different software packages.
   
An example of organization for tools is proposed [[Example of directory structure for tools|here]].
+
{{info|The objective of this article is to describe one organization among all the possible organizations. Feel free to organize the delivered Packages in any other way that would better match your way of working.}}
   
{{info|The objective of this article is to describe one organization among all the possible organizations. Feel free to organize the delivered Packages in any other way that would better match your way of working.}}
+
{{info|In practice, this article uses the release '''STM32MP15-Ecosystem-v1.2.0''' for the STM32MPU Embedded Software distribution as an example to illustrate the proposed organization. If you are using a different release, the names of the directories and files might differ.}}{{UpdateNeededForNewRelease|The trees below shall be updated periodically, even if the information banner specifies that they might not be up-to-date}}
{{info|In practice, this article uses the STM32MPU Embedded Software distribution release issued on 03-July-2018 as an example to illustrate the proposed organization. If you are using a different release, the names of the directories and files might differ.}}{{UpdateNeededForNewRelease|The trees below shall be updated periodically, even if the information banner specifies that they might not be up-to-date}}
 
   
   
Line 23: Line 14:
   
 
==Creating the structure==
 
==Creating the structure==
* Create your <working directory> and assign a unique name to it (for example by including the release date):
+
* Create your <working directory> and assign a unique name to it (for example by including the release name):
  {{PC$}} mkdir STM32MPU-Release-18-07-03
+
  {{PC$}} mkdir STM32MP15-Ecosystem-v1.2.0
  {{PC$}} cd STM32MPU-Release-18-07-03
+
  {{PC$}} cd STM32MP15-Ecosystem-v1.2.0
 
* Create the first-level directories that will host the software packages delivered through the STM32MPU Embedded Software distribution release note:
 
* Create the first-level directories that will host the software packages delivered through the STM32MPU Embedded Software distribution release note:
 
  {{PC$}} mkdir Starter-Package
 
  {{PC$}} mkdir Starter-Package
Line 31: Line 22:
 
  {{PC$}} mkdir Distribution-Package
 
  {{PC$}} mkdir Distribution-Package
 
* The resulting directory structure looks as follows:
 
* The resulting directory structure looks as follows:
  {{Green|STM32MPU-Release-18-07-03}}  {{Highlight|STM32MPU Embedded Software release}}
+
  {{Green|STM32MP15-Ecosystem-v1.2.0}}  {{Highlight|STM32MPU Embedded Software release}}
  ├── {{Green|Developer-Package}}         {{Highlight|Developer Package installation directory}}
+
  ├── {{Green|Developer-Package}}       {{Highlight|Developer Package installation directory}}
  ├── {{Green|Distribution-Package}}       {{Highlight|Distribution Package installation directory}}
+
  ├── {{Green|Distribution-Package}}   {{Highlight|Distribution Package installation directory}}
  └── {{Green|Starter-Package}}           {{Highlight|Starter Package installation directory}}
+
  └── {{Green|Starter-Package}}         {{Highlight|Starter Package installation directory}}
   
 
Once all software packages have been installed according to the instructions given in the STM32MPU Embedded Software distribution release note, the resulting directory structure looks as follows:
 
Once all software packages have been installed according to the instructions given in the STM32MPU Embedded Software distribution release note, the resulting directory structure looks as follows:
  {{Green|STM32MPU-Release-18-07-03}}                   {{Highlight|STM32MPU Embedded Software release}}
+
  {{Green|STM32MP15-Ecosystem-v1.2.0}}                           {{Highlight|STM32MPU Embedded Software release}}
  ├── {{Green|Developer-Package}}                           {{Highlight|Developer Package installation directory}}
+
  ├── {{Green|Developer-Package}}                               {{Highlight|Developer Package installation directory}}
  │  ├── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}} {{Highlight|Linux kernel, U-Boot and TF-A source code (OpenSTLinux distribution)}}
+
  │  ├── {{Green|SDK}}                                         {{Highlight|SDK for OpenSTLinux distribution}}
  │  ├── {{Green|SDK}}                                 {{Highlight|SDK for OpenSTLinux distribution}}
+
  │  ├── {{Green|STM32Cube_FW_MP1_V1.2.0}}                     {{Highlight|STM32CubeMP1 Package}}
  │  └── {{Green|STM32Cube_FW_MP1_V0.4.0}}             {{Highlight|STM32Cube MPU Package}}
+
  │  └── {{Green|stm32mp1-openstlinux-20-02-19}} {{Highlight|Linux kernel, U-Boot, TF-A and OP-TEE OS source code (OpenSTLinux distribution)}}
  ├── {{Green|Distribution-Package}}                         {{Highlight|Distribution Package installation directory}}
+
  ├── {{Green|Distribution-Package}}                             {{Highlight|Distribution Package installation directory}}
  │  └── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|OpenSTLinux distribution (full source code and OpenEmbedded-based build framework)}}
+
  │  └── {{Green|stm32mp1-openstlinux-20-02-19}}  {{Highlight|OpenSTLinux distribution (full source code and OpenEmbedded-based build framework)}}
  └── {{Green|Starter-Package}}                             {{Highlight|Starter Package installation directory}}
+
  └── {{Green|Starter-Package}}                                 {{Highlight|Starter Package installation directory}}
     └── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|Software image (binaries)}}
+
     └── {{Green|stm32mp1-openstlinux-20-02-19}}  {{Highlight|Software image (binaries)}}
   
 
==Focus on the Starter Package directory==
 
==Focus on the Starter Package directory==
Line 56: Line 47:
   
 
  {{Green|Starter-Package}}
 
  {{Green|Starter-Package}}
  └── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}
+
  └── {{Green|stm32mp1-openstlinux-20-02-19}}
 
     └── {{Green|images}}
 
     └── {{Green|images}}
 
         └── {{Green|stm32mp1}}
 
         └── {{Green|stm32mp1}}
 
             ├── {{Green|flashlayout_st-image-weston}}                                {{Highlight|Flash layout files (description of the partitions) for the supported Flash devices and boards}}
 
             ├── {{Green|flashlayout_st-image-weston}}                                {{Highlight|Flash layout files (description of the partitions) for the supported Flash devices and boards}}
             │  ├── FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv            {{Highlight|Flash layout file for eMMC and trusted boot chain → STM32MP15 Evaluation boards}}
+
            │  ├── FlashLayout_emmc_stm32mp157c-ev1-optee.tsv              {{Highlight|Flash layout file for eMMC and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │  ├── FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv      {{Highlight|Flash layout file for NAND Flash and trusted boot chain → STM32MP15 Evaluation boards}}
+
             │  ├── FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv            {{Highlight|Flash layout file for eMMC and trusted boot chain → STM32MP157C-EV1}}
             │  ├── FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv        {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15 Evaluation boards}}
+
            │  ├── FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv        {{Highlight|Flash layout file for NAND Flash and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │  ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv  {{Highlight|Flash layout file for NOR Flash (and NAND Flasdh) and trusted boot chain → STM32MP15 Evaluation boards}}
+
             │  ├── FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv      {{Highlight|Flash layout file for NAND Flash and trusted boot chain → STM32MP157C-EV1}}
             │  ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv      {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15 Evaluation boards}}
+
            │  ├── FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv          {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │  ├── FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Discovery kits}}
+
             │  ├── FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv        {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP157C-EV1}}
             │  ├── FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Discovery kits}}
+
            │  ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv    {{Highlight|Flash layout file for NOR Flash (and NAND Flash) and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
             │  ├── FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Evaluation boards}}
+
             │  ├── FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv  {{Highlight|Flash layout file for NOR Flash (and NAND Flash) and trusted boot chain → STM32MP157C-EV1}}
             │  └── FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Evaluation boards}}
+
            │  ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv        {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain, with OP-TEE OS STM32MP157C-EV1}}
  +
             │  ├── FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv      {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP157C-EV1}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157a-dk1-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157A-DK1}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157A-DK1}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157a-dk1-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157A-DK1}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157a-dk1-extensible.tsv      {{Highlight|Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for [[Package_repository_for_OpenSTLinux_distribution|package repository]] service) → STM32MP157A-DK1}}
  +
             │  ├── FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157C-DK2}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-DK2}}
  +
             │  ├── FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157C-DK2}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157c-dk2-extensible.tsv      {{Highlight|Flash layout file for microSD card with no userfs partition but a rootfs partition extended to sdcard size (recommended setup for [[Package_repository_for_OpenSTLinux_distribution|package repository]] service) → STM32MP157C-DK2}}
  +
             │  ├── FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157C-EV1}}
  +
            │  ├── FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
  +
             │  └── FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157C-EV1}}
 
             ├── {{Green|scripts}}
 
             ├── {{Green|scripts}}
 
             │  └── create_sdcard_from_flashlayout.sh
 
             │  └── create_sdcard_from_flashlayout.sh
            ├── splash.bin                                                  {{Highlight|U-Boot splash screen picture (file in BMP format with a ''.bin'' extension) for NOR Flash}}
 
 
             ├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''bootfs'' partition}}
 
             ├── st-image-bootfs-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''bootfs'' partition}}
 
             ├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
 
             ├── st-image-bootfs-openstlinux-weston-stm32mp1.manifest
 
             ├── st-image-userfs-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''userfs'' partition}}
 
             ├── st-image-userfs-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''userfs'' partition}}
 
             ├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
 
             ├── st-image-userfs-openstlinux-weston-stm32mp1.manifest
  +
            ├── st-image-vendorfs-openstlinux-weston-stm32mp1.ext4          {{Highlight|Binary for ''vendorfs'' partition}}
 
             ├── st-image-weston-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''rootfs'' partition}}
 
             ├── st-image-weston-openstlinux-weston-stm32mp1.ext4            {{Highlight|Binary for ''rootfs'' partition}}
 
             ├── st-image-weston-openstlinux-weston-stm32mp1.license
 
             ├── st-image-weston-openstlinux-weston-stm32mp1.license
Line 81: Line 84:
 
             ├── st-image-weston-openstlinux-weston-stm32mp1.manifest
 
             ├── st-image-weston-openstlinux-weston-stm32mp1.manifest
 
             ├── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
 
             ├── st-image-weston-openstlinux-weston-stm32mp1_nand_4_256_multivolume.ubi
             ├── tf-a-stm32mp157c-dk2-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
+
            ├── tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1}}
             ├── tf-a-stm32mp157c-ev1-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
+
            ├── tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2}}
             ├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP15 Discovery kits}}
+
            ├── tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1}}
             ├── u-boot-spl.stm32-stm32mp157c-ev1-basic                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
+
            ├── tf-a-stm32mp157a-dk1-optee.stm32                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
             ├── u-boot-stm32mp157c-dk2-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP15 Discovery kits}}
+
            ├── tf-a-stm32mp157a-dk1-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
             ├── u-boot-stm32mp157c-dk2-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
+
            ├── tf-a-stm32mp157c-dk2-optee.stm32                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
             ├── u-boot-stm32mp157c-ev1-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
+
             ├── tf-a-stm32mp157c-dk2-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
             └── u-boot-stm32mp157c-ev1-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
+
            ├── tf-a-stm32mp157c-ev1-optee.stm32                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
  +
             ├── tf-a-stm32mp157c-ev1-trusted.stm32                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
  +
            ├── u-boot-spl.stm32-stm32mp157a-dk1-basic                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
  +
             ├── u-boot-spl.stm32-stm32mp157c-dk2-basic                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
  +
             ├── u-boot-spl.stm32-stm32mp157c-ev1-basic                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
  +
            ├── u-boot-stm32mp157a-dk1-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
  +
            ├── u-boot-stm32mp157a-dk1-optee.stm32                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
  +
            ├── u-boot-stm32mp157a-dk1-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
  +
             ├── u-boot-stm32mp157c-dk2-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
  +
            ├── u-boot-stm32mp157c-dk2-optee.stm32                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
  +
             ├── u-boot-stm32mp157c-dk2-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
  +
             ├── u-boot-stm32mp157c-ev1-basic.img                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
  +
            ├── u-boot-stm32mp157c-ev1-optee.stm32                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
  +
             └── u-boot-stm32mp157c-ev1-trusted.stm32                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
   
 
==Focus on the Developer Package directory==
 
==Focus on the Developer Package directory==
 
The ''Developer-Package'' directory contains:
 
The ''Developer-Package'' directory contains:
 
* The source code for the following OpenSTLinux software packages (development for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A processor):
 
* The source code for the following OpenSTLinux software packages (development for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A processor):
  +
** Linux<sup>&reg;</sup> kernel
  +
** U-Boot
 
** TF-A
 
** TF-A
** Linux kernel
+
** OP-TEE OS
** U-Boot
+
* The debug symbol files for Linux kernel, U-Boot, TF-A and OP-TEE OS
* The debug symbol files for Linux kernel, U-Boot and TF-A
 
 
* The SDK (for cross-development on an host PC)
 
* The SDK (for cross-development on an host PC)
 
* The STM32Cube MPU Package (developed for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-M processor)
 
* The STM32Cube MPU Package (developed for Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-M processor)
Line 102: Line 119:
   
 
  {{Green|Developer-Package}}
 
  {{Green|Developer-Package}}
  ├── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}} {{Highlight|Source code for OpenSTLinux distribution}}
+
  ├── {{Green|SDK}}                                                                             {{Highlight|'''SDK for OpenSTLinux distribution''': details in [[Standard SDK directory structure]] article}}
  │  ├── {{Green|images}}
+
  │  ├── environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi {{Highlight|'''Environment setup script''' for Developer Package}}
  │  │  └── {{Green|stm32mp1}}                                {{Highlight|'''Debug symbol files installation directory'''}}
+
  │  ├── site-config-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi
  │  │      ├── tf-a-bl2-trusted.elf                {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
+
  │  ├── {{Green|sysroots}}
  │  │      ├── tf-a-bl32-trusted.elf              {{Highlight|Debug symbol file for TF-A → runtime software stage}}
+
  │  │   ├── {{Green|cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi}}                {{Highlight|Target sysroot (libraries, headers, and symbols)}}
  │  │       ├── u-boot-stm32mp157c-dk2-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP15 Discovery kits}}
+
  │  │   │  └── [...]
  │  │       ├── u-boot-stm32mp157c-ev1-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP15 Evaluation boards}}
+
│  │  └── {{Green|x86_64-ostl_sdk-linux}}                                    {{Highlight|Native sysroot (libraries, headers, and symbols)}}
  │  │      └── vmlinux                            {{Highlight|Debug symbol file for Linux kernel}}
+
  │  │      └── [...]
  +
│  └── version-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi
   
  │  └── {{Green|sources}}
+
├── {{Green|STM32Cube_FW_MP1_V''X.Y.Z''}}            {{Highlight|'''STM32CubeMP1 Package''': details in [[STM32CubeMP1 Package#STM32CubeMP1 Package Content|STM32CubeMP1 Package content]] article}}
  │       └── {{Green|arm-openstlinux_weston-linux-gnueabi}}
+
  │  ├── {{Green|Drivers}}
  │           ├── {{Green|linux-stm32mp-4.14-48}}     {{Highlight|'''Linux kernel installation directory'''}}
+
  │   │  ├── {{Green|BSP}}                        {{Highlight|BSP drivers for the supported STM32MPU boards}}
  │           │  ├── [*].patch            {{Highlight|ST patches for Linux kernel}}
+
  │   │  │  └── [...]
  │           │  ├── fragment-[*].config   {{Highlight|ST configuration fragments for Linux kernel}}
+
│  │  ├── {{Green|CMSIS}}
  │           │  ├── {{Green|linux-4.14.48}}         {{Highlight|'''Linux kernel source code directory'''}}
+
│  │  │  └── [...]
  │             ├── linux-4.14.48.tar.xz
+
│  │  └── {{Green|STM32MP1xx_HAL_Driver}}       {{Highlight|HAL drivers for the supported STM32MPU devices}}
  │           │  ├── README.HOW_TO.txt     {{Highlight|Helper file for Linux kernel management: '''reference''' for Linux kernel build}}
+
  │   │      └── [...]
  │             └── series
+
│  ├── {{Green|_htmresc}}
  +
│  │  └── [...]
  +
│  ├── License.md                      {{Highlight|License types for the components}}
  +
│  ├── {{Green|Middlewares}}                    {{Highlight|Middlewares used by the examples and applications}}
  +
  │   │  └── [...]
  +
│  ├── package.xml
  +
│  ├── {{Green|Projects}}
  +
│  │   ├── STM32CubeProjectsList.html  {{Highlight|List of examples and applications for STM32CubeMP1 Package}}
  +
  │   │  ├── {{Green|STM32MP157C-DK2}}            {{Highlight|Set of examples and applications → STM32MP157C-DK2}}
  +
│  │  │  └── [...]
  +
│  │  └── {{Green|STM32MP157C-EV1}}             {{Highlight|Set of examples and applications → STM32MP157C-EV1}}
  +
  │         └── [...]
  +
│  ├── Readme.md
  +
  │   ├── Release_Notes.html              {{Highlight|Release note for STM32CubeMP1 Package}}
  +
│  └── {{Green|Utilities}}
  +
│      └── [...]
  +
 
  +
└── {{Green|stm32mp1-openstlinux-20-02-19}}     {{Highlight|Source code for OpenSTLinux distribution}}
  +
    ├── {{Green|images}}
  +
    │  └── {{Green|stm32mp1}}                                {{Highlight|'''Debug symbol files installation directory'''}}
  +
    │      ├── tf-a-bl2-optee.elf                  {{Highlight|Debug symbol file for TF-A, with OP-TEE OS → trusted boot firmware stage}}
  +
    │      ├── tf-a-bl2-trusted.elf                {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
  +
    │      ├── tf-a-bl32-trusted.elf              {{Highlight|Debug symbol file for TF-A → runtime software stage}}
  +
    │      ├── u-boot-stm32mp157a-dk1-optee.elf    {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157A-DK1}}
  +
    │      ├── u-boot-stm32mp157a-dk1-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP157A-DK1}}
  +
    │      ├── u-boot-stm32mp157c-dk2-optee.elf    {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
  +
    │      ├── u-boot-stm32mp157c-dk2-trusted.elf {{Highlight|Debug symbol file for U-Boot → STM32MP157C-DK2}}
  +
    │      ├── u-boot-stm32mp157c-ev1-optee.elf    {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1}}
  +
          ├── u-boot-stm32mp157c-ev1-trusted.elf  {{Highlight|Debug symbol file for U-Boot → STM32MP157C-EV1}}
  +
          └── vmlinux                            {{Highlight|Debug symbol file for Linux kernel}}
   
│          ├── {{Green|tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c}}             {{Highlight|'''TF-A installation directory'''}}
+
    └── {{Green|sources}}
│          │  ├── [*].patch                                           {{Highlight|ST patches for TF-A}}
+
        └── {{Green|arm-openstlinux_weston-linux-gnueabi}}
│          │  ├── {{Green|git}}                                                 {{Highlight|'''TF-A source code directory'''}}
+
            ├── {{Green|linux-stm32mp-''X.Y-rR''}}   {{Highlight|'''Linux kernel installation directory'''}}
│          │  ├── Makefile.sdk                                        {{Highlight|Makefile for the TF-A compilation}}
+
            │  ├── [*].patch           {{Highlight|ST patches for Linux kernel}}
│          │  ├── README.HOW_TO.txt                                   {{Highlight|Helper file for TF-A management: '''reference''' for TF-A build}}
+
            │  ├── fragment-[*].config  {{Highlight|ST configuration fragments for Linux kernel}}
│          │  ├── series
+
            │  ├── {{Green|linux-''X.Y.Z''}}         {{Highlight|'''Linux kernel source code directory'''}}
│          │  └── tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c.tar.gz
+
            │  ├── linux-''X.Y.Z''.tar.xz
  +
            │  ├── README.HOW_TO.txt   {{Highlight|Helper file for Linux kernel management: '''reference''' for Linux kernel build}}
  +
            │  └── series
   
│          └── {{Green|u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e}}             {{Highlight|'''U-Boot installation directory'''}}
+
            ├── {{Green|optee-os-stm32mp-''X.Y.Z-rR''}} {{Highlight|'''OP-TEE OS installation directory'''}}
              ├── [*].patch                                                         {{Highlight|ST patches for U-Boot}}
+
              ├── [*].patch             {{Highlight|ST patches for OP-TEE OS}}
              ├── {{Green|git}}                                                               {{Highlight|'''U-Boot source code directory'''}}
+
            │  ├── ''X.Y.Z''.tar.gz
              ├── Makefile.sdk                                                      {{Highlight|Makefile for the U-Boot compilation}}
+
            │  ├── Makefile.sdk          {{Highlight|Makefile for the OP-TEE OS compilation}}
│              ├── README.HOW_TO.txt                                                 {{Highlight|Helper file for U-Boot management: '''reference''' for U-Boot build}}
+
              ├── {{Green|optee_os-''X.Y.Z''}}         {{Highlight|'''OP-TEE OS source code directory'''}}
              ├── series
+
              ├── README.HOW_TO.txt     {{Highlight|Helper file for OP-TEE OS management: '''reference''' for OP-TEE OS build}}
│              └── u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e.tar.gz
+
              └── series
   
├── {{Green|SDK}}                                                                          {{Highlight|'''SDK for OpenSTLinux distribution''': details in [[Standard SDK directory structure]] article}}
+
            ├── {{Green|tf-a-stm32mp-''X.Y-rR''}}           {{Highlight|'''TF-A installation directory'''}}
│  ├── environment-setup-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi  {{Highlight|'''Environment setup script''' for Developer Package}}
+
            │  ├── [*].patch                {{Highlight|ST patches for TF-A}}
│  ├── site-config-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi
+
            │  ├── {{Green|arm-trusted-firmware-''X.Y''}} {{Highlight|'''TF-A source code directory'''}}
│  ├── {{Green|sysroots}}
+
            │  ├── Makefile.sdk              {{Highlight|Makefile for the TF-A compilation}}
│  │  ├── {{Green|cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi}}               {{Highlight|Target sysroot (libraries, headers, and symbols)}}
+
            │  ├── README.HOW_TO.txt        {{Highlight|Helper file for TF-A management: '''reference''' for TF-A build}}
│  │  │  └── [...]
+
            │  ├── series
│  │  └── {{Green|x86_64-openstlinux_weston_sdk-linux}}                                   {{Highlight|Native sysroot (libraries, headers, and symbols)}}
+
              └── v''X.Y''.tar.gz
│  │       └── [...]
 
│  └── version-cortexa7hf-neon-vfpv4-openstlinux_weston-linux-gnueabi
 
   
└── {{Green|STM32Cube_FW_MP1_V0.4.0}}                             {{Highlight|'''STM32Cube MPU Package''': details in [[STM32CubeMP1 Package#STM32CubeMP1 Package Content|STM32Cube MPU Package content]] article}}
+
            └── {{Green|u-boot-stm32mp-''YYYY.MM-rR''}} {{Highlight|'''U-Boot installation directory'''}}
    ├── COPYING
+
                ├── [*].patch              {{Highlight|ST patches for U-Boot}}
    ├── COPYING.BSD-3
+
                ├── Makefile.sdk          {{Highlight|Makefile for the U-Boot compilation}}
    ├── {{Green|Drivers}}
+
                ├── README.HOW_TO.txt     {{Highlight|Helper file for U-Boot management: '''reference''' for U-Boot build}}
    │  ├── {{Green|BSP}}                                        {{Highlight|BSP drivers for the supported STM32MPU boards}}
+
                ├── series
    │  │  └── [...]
+
                 ├── {{Green|u-boot-''YYYY.MM-rR''}}         {{Highlight|'''U-Boot source code directory'''}}
    │  ├── {{Green|CMSIS}}
+
                └── v''YYYY.MM''.tar.gz
    │  │  └── [...]
 
     │  └── {{Green|STM32MP1xx_HAL_Driver}}                      {{Highlight|HAL drivers for the supported STM32MPU devices}}
 
    │      └── [...]
 
    ├── {{Green|_htmresc}}
 
    │  └── [...]
 
    ├── LLA_evaluation_for_STM32MPU_17-12-06_plain.txt
 
    ├── {{Green|Middlewares}}
 
    │  └── [...]
 
    ├── package.xml
 
    ├── {{Green|Projects}}
 
    │  ├── STM32CubeProjectsList.html                 {{Highlight|List of examples and applications for STM32Cube MP1 Package}}
 
    │  ├── {{Green|STM32MP15_DISCO}}                            {{Highlight|Set of examples and applications → STM32MP15 Discovery kits}}
 
    │  │  └── [...]
 
    │  └── {{Green|STM32MP15_EVAL}}                             {{Highlight|Set of examples and applications → STM32MP15 Evaluation boards}}
 
    │      └── [...]
 
    ├── Release_Notes.html                              {{Highlight|Release note for STM32Cube MP1 Package}}
 
    └── {{Green|Utilities}}
 
        └── [...]
 
   
[[#Appendix A: directory structure after build (Developer Package)|Appendix A]] shows the structure of the Linux kernel, U-Boot and TF-A installation directories after these software packages have been built.
+
[[#Appendix A: directory structure after build (Developer Package)|Appendix A]] shows the structure of the Linux kernel, U-Boot, TF-A and OP-TEE OS installation directories after these software packages have been built.
   
 
==Focus on the Distribution Package directory==
 
==Focus on the Distribution Package directory==
Line 180: Line 209:
   
 
  {{Green|Distribution-Package}}
 
  {{Green|Distribution-Package}}
  └── {{Green|openstlinux-4.14-rocko-mp1-18-07-03}}  {{Highlight|OpenSTLinux distribution}}
+
  └── {{Green|openstlinux-20-02-19}}  {{Highlight|'''OpenSTLinux distribution'''}}
     ├── {{Green|meta-openembedded}}  {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
+
     └── {{Green|layers}}
    │  └── [...]
+
        ├── {{Green|meta-openembedded}}  {{Highlight|Collection of layers for the OpenEmbedded-Core universe ([[OpenEmbedded]] standard)}}
    ├── {{Green|meta-qt5}}          {{Highlight|QT5 layer for OpenEmbedded (standard)}}
+
        │  └── [...]
    │  └── [...]
+
        ├── {{Green|meta-qt5}}          {{Highlight|QT5 layer for OpenEmbedded (standard)}}
  +
        │  └── [...]
   
    ├── {{Green|meta-st}}
+
        ├── {{Green|meta-st}}
    │  ├── {{Green|meta-st-openstlinux}}                  {{Highlight|STMicroelectronics layer that contains the settings of the frameworks and images for the OpenSTLinux distribution}}
+
        │  ├── {{Green|meta-st-openstlinux}}                  {{Highlight|STMicroelectronics layer that contains the settings of the frameworks and images for the OpenSTLinux distribution}}
    │  │  ├── {{Green|recipes-samples}}
+
        │  │  ├── {{Green|recipes-samples}}
    │  │  │  └── {{Green|images}}
+
        │  │  │  ├── {{Green|images}}
    │  │  │       ├── st-example-image-qt.bb    {{Highlight|ST example of image based on QT framework}}
+
        │  │  │   |  ├── st-example-image-qt.bb    {{Highlight|ST example of image based on QT framework}}
    │  │  │       ├── st-example-image-x11.bb  {{Highlight|ST example of image based on X11}}
+
        │  │  │   |  ├── st-example-image-x11.bb  {{Highlight|ST example of image based on X11}}
    │  │  │       └── st-example-image-xfce.bb  {{Highlight|ST example of image based on XFCE framework}}
+
        │  │  │   |  ├── st-example-image-xfce.bb  {{Highlight|ST example of image based on XFCE framework}}
    │  │  ├── {{Green|recipes-st}}
+
        │  │  │  |  └── st-image-userfs.bbappend  {{Highlight|Additional packages (application launcher, demo...) for ST Weston image}}
    │  │  │  ├── {{Green|images}}
+
        │  │  │  └── [...]
    │  │  │  │  ├── st-image-core.bb          {{Highlight|Core image for OpenSTLinux distribution}}
+
        │  │  ├── {{Green|recipes-st}}
    │  │  │  │  ├── st-image.inc
+
        │  │  │  ├── {{Green|images}}
    │  │  │  │  └── st-image-weston.bb        {{Highlight|Weston image with basic Wayland support for OpenSTLinux distribution: '''recommended setup'''setup}}
+
        │  │  │  │  ├── st-image-core.bb          {{Highlight|Core image for OpenSTLinux distribution}}
    │  │  │  └── {{Green|packagegroups}}
+
        │  │  │  │  ├── st-image.inc
    │  │  │      └── [...]
+
        │  │  │  │  └── st-image-weston.bb        {{Highlight|Weston image with basic Wayland support for OpenSTLinux distribution: '''recommended setup'''}}
    │  │  └── [...]
+
        │  │  │  └── {{Green|packagegroups}}
  +
        │  │  │      └── [...]
  +
        │  │  └── [...]
   
    │  ├── {{Green|meta-st-stm32mp}}                 {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
+
        │  ├── {{Green|meta-st-stm32mp}}                   {{Highlight|STMicroelectronics layer that contains the description of the BSP for the STM32 MPU devices}}
    │  │  ├── {{Green|recipes-bsp}}
+
        │  │  ├── {{Green|recipes-bsp}}
    │  │  │  ├── {{Green|alsa}}                   {{Highlight|Recipes for ALSA control configuration}}
+
        │  │  │  ├── {{Green|alsa}}                     {{Highlight|Recipes for ALSA control configuration}}
    │  │  │  │  └── [...]
+
        │  │  │  │  └── [...]
    │  │  │  ├── {{Green|drivers}}                 {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
+
        │  │  │  ├── {{Green|drivers}}                   {{Highlight|Recipes for Vivante GCNANO GPU kernel drivers}}
    │  │  │  │  └── [...]
+
        │  │  │  │  └── [...]
    │  │  │  ├── {{Green|trusted-firmware-a}}     {{Highlight|Recipes for TF-A}}
+
        │  │  │  ├── {{Green|trusted-firmware-a}}       {{Highlight|Recipes for TF-A}}
    │  │  │  │  └── [...]
+
        │  │  │  │  └── [...]
    │  │  │  └── {{Green|u-boot}}                 {{Highlight|Recipes for U-Boot}}
+
        │  │  │  └── {{Green|u-boot}}                   {{Highlight|Recipes for U-Boot}}
    │  │  │      └── [...]
+
        │  │  │      └── [...]
    │  │  ├── {{Green|recipes-extended}}
+
        │  │  ├── {{Green|recipes-extended}}
    │  │  │  ├── {{Green|m4projects}}             {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
+
        │  │  │  ├── {{Green|m4projects}}               {{Highlight|Recipes for STM32Cube MPU Package within the OpenSTLinux distribution}}
    │  │  │  │  └── [...]
+
        │  │  │  │  └── [...]
    │  │  │  ├── {{Green|openocd}}                {{Highlight|Recipes for Open On-Chip Debugging (OpenOCD) on Cortex-A or Cortex-M}}
+
        │  │  │  └── [...]
    │  │  │  │  └── [...]
+
        │  │  ├── {{Green|recipes-graphics}}
    │  │  │  └── {{Green|stlink}}                  {{Highlight|Recipes for STLink}}
+
        │  │  │  ├── {{Green|gcnano-userland}}           {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
    │  │  │      └── [...]
+
        │  │  │  │  └── [...]
    │  │  ├── {{Green|recipes-graphics}}
+
        │  │  │  └── [...]
    │  │  │  ├── {{Green|gcnano-userland}}         {{Highlight|Recipes for Vivante libraries OpenGL ES, OpenVG and EGL (multi backend)}}
+
        │  │  ├── {{Green|recipes-kernel}}
    │  │  │  │  └── [...]
+
        │  │  │  └── {{Green|linux}}                     {{Highlight|Recipes for Linux kernel}}
    │  │  │  └── [...]
+
        │  │  │      └── [...]
    │  │  ├── {{Green|recipes-kernel}}
+
        │  │  │  └── {{Green|linux-firmware}}           {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
    │  │  │  └── {{Green|linux}}                   {{Highlight|Recipes for Linux kernel}}
+
        │  │  │      └── [...]
    │  │  │      └── [...]
+
        │  │  ├── {{Green|recipes-st}}
    │  │  │  └── {{Green|linux-firmware}}         {{Highlight|Recipes for Linux firmwares (example, Bluetooth firmware)}}
+
        │  │  │  └── {{Green|images}}
    │  │  │      └── [...]
+
        │  │  │      ├── st-image-bootfs.bb   {{Highlight|Recipes for the ''bootfs'' partition binary}}
    │  │  ├── {{Green|recipes-st}}
+
        │  │  │      ├── st-image-userfs.bb    {{Highlight|Recipes for the ''userfs'' partition binary}}
    │  │  │  └── {{Green|images}}
+
        │  │  │      └── st-image-vendorfs.bb  {{Highlight|Recipes for the ''vendorfs'' partition binary}}
    │  │  │      ├── st-image-bootfs.bb {{Highlight|Recipes for the ''bootfs'' partition binary}}
+
        │  │  └── [...]
    │  │  │      └── st-image-userfs.bb  {{Highlight|Recipes for the ''userfs'' partition binary}}
 
    │  │  └── [...]
 
   
    │  ├── {{Green|meta-st-stm32mp-addons}}  {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
+
        │  ├── {{Green|meta-st-stm32mp-addons}}  {{Highlight|STMicroelectronics layer that helps managing the STM32CubeMX integration}}
    │      └── [...]
+
        │      └── [...]
    │  └── {{Green|scripts}}
+
        │  └── {{Green|scripts}}
    │      ├── envsetup.sh {{Highlight|'''Environment setup script''' for Distribution Package}}
+
        │      ├── envsetup.sh         {{Highlight|'''Environment setup script''' for Distribution Package}}
    │      └── [...]
+
        │      └── [...]
    └── {{Green|openembedded-core}}  {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
 
        └── [...]
 
   
{{InternalInfo| Additional layer for internal usage
+
        ├── {{Green|meta-timesys}}      {{Highlight|Timesys layer for OpenEmbedded (standard)}}
└── {{Green|st-hands-on}}  {{Highlight|STMicroelectronics layer that contains the reference source code for the hands-on}}
+
        │  └── [...]
}}
+
        └── {{Green|openembedded-core}}  {{Highlight|Core metadata for current versions of [[OpenEmbedded]] (standard)}}
  +
            └── [...]
   
 
[[#Appendix B: directory structure after build (Distribution Package)|Appendix B]] shows the structure of the build directory.
 
[[#Appendix B: directory structure after build (Distribution Package)|Appendix B]] shows the structure of the build directory.
Line 253: Line 282:
   
 
  Developer-Package
 
  Developer-Package
  ├── openstlinux-4.14-rocko-mp1-18-07-03 {{Highlight|Source code for OpenSTLinux distribution}}
+
  ├── stm32mp1-openstlinux-20-02-19  {{Highlight|Source code for OpenSTLinux distribution}}
 
  │  └── sources
 
  │  └── sources
 
  │      └── arm-openstlinux_weston-linux-gnueabi
 
  │      └── arm-openstlinux_weston-linux-gnueabi
  │          ├── linux-stm32mp-4.14-48                {{Highlight|'''Linux kernel installation directory'''}}
+
  │          ├── linux-stm32mp-''X.Y-rR''                  {{Highlight|'''Linux kernel installation directory'''}}
  │          │  ├── {{Green|build}}                             {{Highlight|'''Linux kernel build directory'''}}
+
  │          │  ├── {{Green|build}}                               {{Highlight|'''Linux kernel build directory'''}}
 
  │          │  │  ├── {{Green|install_artifact}}
 
  │          │  │  ├── {{Green|install_artifact}}
 
  │          │  │  │  ├── {{Green|lib}}
 
  │          │  │  │  ├── {{Green|lib}}
 
  │          │  │  │  │  └── {{Green|modules}}
 
  │          │  │  │  │  └── {{Green|modules}}
  │          │  │  │  │      └── {{Green|4.14.48}}
+
  │          │  │  │  │      └── {{Green|''X.Y.Z''}}
  │          │  │  │  │          └── {{Green|[...]}}         {{Highlight|Kernel modules hierarchy (''*.ko'' files)}}
+
  │          │  │  │  │          └── {{Green|[...]}}           {{Highlight|Kernel modules hierarchy (''*.ko'' files)}}
 
  │          │  │  │  └── {{Green|boot}}
 
  │          │  │  │  └── {{Green|boot}}
  │          │  │  │      ├── {{Green|stm32mp157c-d[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Discovery kits}}
+
│          │  │  │      ├── {{Green|stm32mp157a-dk1[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157A-DK1}}
  │          │  │  │      ├── {{Green|stm32mp157c-e[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Evaluation boards}}
+
  │          │  │  │      ├── {{Green|stm32mp157c-dk2[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157C-DK2}}
  │          │  │  │      ├── {{Green|uImage}}               {{Highlight|Linux kernel binary image file (with U-Boot wrapper) for ''bootfs'' partition}}
+
  │          │  │  │      ├── {{Green|stm32mp157c-ev1[*].dtb}}  {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157C-EV1}}
  +
  │          │  │  │      ├── {{Green|uImage}}                 {{Highlight|Linux kernel binary image file (with U-Boot wrapper) for ''bootfs'' partition}}
 
  │          │  │  │      └── {{Green|[...]}}
 
  │          │  │  │      └── {{Green|[...]}}
  │          │  │  ├── {{Green|vmlinux}}                       {{Highlight|Debug symbol file for Linux kernel}}
+
  │          │  │  ├── {{Green|vmlinux}}                         {{Highlight|Debug symbol file for Linux kernel}}
 
  │          │  │  └── {{Green|[...]}}
 
  │          │  │  └── {{Green|[...]}}
 
  │          │  └── [...]
 
  │          │  └── [...]
   
  │          ├── tf-a-stm32mp-1.5-release.AUTOINC+ed8112606c {{Highlight|'''TF-A installation directory'''}}
+
  │          ├── optee-os-stm32mp-''X.Y.Z-rR''                                          {{Highlight|'''OP-TEE OS installation directory'''}}
  │          │  ├── {{Green|build}}                                   {{Highlight|'''TF-A build directory'''}}
+
  │          │  ├── {{Green|build}}                                                           {{Highlight|'''OP-TEE OS build directory'''}}
  │          │  │  ├── {{Green|tf-a-bl2-trusted.elf}}               {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
+
  │          │  │  ├── {{Green|tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32}} {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1}}
│          │  │  ├── {{Green|tf-a-bl32-trusted.elf}}              {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
+
  │          │  │  ├── {{Green|tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2}}
  │          │  │  ├── {{Green|tf-a-stm32mp157c-dk2-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
+
  │          │  │  ├── {{Green|tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1}}
  │          │  │  ├── {{Green|tf-a-stm32mp157c-ev1-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
 
 
  │          │  │  └── {{Green|[...]}}
 
  │          │  │  └── {{Green|[...]}}
 
  │          │  └── [...]
 
  │          │  └── [...]
   
  │          └── u-boot-trusted-stm32mp-2018.03-release.AUTOINC+f95ab1fb6e {{Highlight|'''U-Boot installation directory'''}}
+
  │          ├── tf-a-stm32mp-''X.Y-rR''                            {{Highlight|'''TF-A installation directory'''}}
  │              ├── {{Green|build-stm32mp15_trusted_defconfig}}                     {{Highlight|'''U-Boot build directory'''}}
+
│          │  ├── {{Green|build}}                                      {{Highlight|'''TF-A build directory'''}}
  │              │  ├── {{Green|u-boot-stm32mp157c-dk2-trusted.elf}}               {{Highlight|Debug symbol file for U-Boot → STM32MP15 Discovery kits}}
+
│          │  │  ├── {{Green|optee}}                                  {{Highlight|TF-A, with OP-TEE OS}}
  │              │  ├── {{Green|u-boot-stm32mp157c-dk2-trusted.stm32}}             {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
+
│          │  │  │  ├── {{Green|tf-a-bl2-optee.elf}}                  {{Highlight|Debug symbol file for TF-A, with OP-TEE OS → trusted boot firmware stage}}
  │              │  ├── {{Green|u-boot-stm32mp157c-ev1-trusted.elf}}               {{Highlight|Debug symbol file for U-Boot → STM32MP15 Evaluation boards}}
+
│          │  │  │  ├── {{Green|tf-a-stm32mp157a-dk1-optee.stm32}}    {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
  │              │  ├── {{Green|u-boot-stm32mp157c-ev1-trusted.stm32}}             {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
+
│          │  │  │  ├── {{Green|tf-a-stm32mp157c-dk2-optee.stm32}}    {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
  +
│          │  │  │  ├── {{Green|tf-a-stm32mp157c-ev1-optee.stm32}}    {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
  +
│          │  │  │  └── {{Green|[...]}}
  +
│          │  │  └── {{Green|trusted}}                                {{Highlight|TF-A, without OP-TEE OS}}
  +
│          │  │      ├── {{Green|tf-a-bl2-trusted.elf}}                {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
  +
│          │  │      ├── {{Green|tf-a-bl32-trusted.elf}}              {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
  +
│          │  │      ├── {{Green|tf-a-stm32mp157a-dk1-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
  +
│          │  │      ├── {{Green|tf-a-stm32mp157c-dk2-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
  +
│          │  │      ├── {{Green|tf-a-stm32mp157c-ev1-trusted.stm32}}  {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
  +
│          │  │      └── {{Green|[...]}}
  +
│          │  └── [...]
  +
 
  +
│          └── u-boot-stm32mp-''YYYY.MM-rR''                      {{Highlight|'''U-Boot installation directory'''}}
  +
│              ├── {{Green|build-basic}}                                {{Highlight|'''U-Boot build directory for basic boot chain'''}}
  +
│              │  ├── {{Green|u-boot-spl.stm32-stm32mp157a-dk1-basic}}  {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
  +
│              │  ├── {{Green|u-boot-spl.stm32-stm32mp157c-dk2-basic}}  {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
  +
│              │  ├── {{Green|u-boot-spl.stm32-stm32mp157c-ev1-basic}}  {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
  +
│              │  ├── {{Green|u-boot-stm32mp157a-dk1-basic.img}}        {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
  +
│              │  ├── {{Green|u-boot-stm32mp157c-dk2-basic.img}}        {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
  +
│              │  ├── {{Green|u-boot-stm32mp157c-ev1-basic.img}}        {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
  +
│              ├── {{Green|build-optee}}                                {{Highlight|'''U-Boot build directory for trusted boot chain, with OP-TEE OS'''}}
  +
│              │  ├── {{Green|u-boot-stm32mp157a-dk1-optee.elf}}        {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157A-DK1}}
  +
│              │  ├── {{Green|u-boot-stm32mp157a-dk1-optee.stm32}}      {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
  +
│              │  ├── {{Green|u-boot-stm32mp157c-dk2-optee.elf}}        {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
  +
│              │  ├── {{Green|u-boot-stm32mp157c-dk2-optee.stm32}}      {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
  +
│              │  ├── {{Green|u-boot-stm32mp157c-ev1-optee.elf}}        {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1}}
  +
│              │  ├── {{Green|u-boot-stm32mp157c-ev1-optee.stm32}}      {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
  +
│              │  └── {{Green|[...]}}
  +
  │              ├── {{Green|build-trusted}}                               {{Highlight|'''U-Boot build directory for trusted boot chain'''}}
  +
│              │  ├── {{Green|u-boot-stm32mp157a-dk1-trusted.elf}}      {{Highlight|Debug symbol file for U-Boot → STM32MP157A-DK1}}
  +
│              │  ├── {{Green|u-boot-stm32mp157a-dk1-trusted.stm32}}    {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
  +
  │              │  ├── {{Green|u-boot-stm32mp157c-dk2-trusted.elf}}     {{Highlight|Debug symbol file for U-Boot → STM32MP157C-DK2}}
  +
  │              │  ├── {{Green|u-boot-stm32mp157c-dk2-trusted.stm32}}   {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
  +
  │              │  ├── {{Green|u-boot-stm32mp157c-ev1-trusted.elf}}     {{Highlight|Debug symbol file for U-Boot → STM32MP157C-EV1}}
  +
  │              │  ├── {{Green|u-boot-stm32mp157c-ev1-trusted.stm32}}   {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
 
  │              │  └── {{Green|[...]}}
 
  │              │  └── {{Green|[...]}}
 
  │              └── [...]
 
  │              └── [...]
Line 294: Line 357:
   
 
As long as you did not modify the source code:
 
As long as you did not modify the source code:
* the {{Purple|files in purple}} are the same as the ones available in the '''Starter Package''': flash layout, binaries for ''bootfs'', ''userfs'' and ''rootfs'' partitions
+
* the {{STPurple|files in STPurple}} are the same as the ones available in the '''Starter Package''': flash layout, binaries for ''bootfs'', ''rootfs'', ''userfs'' and ''vendorfs'' partitions
* the {{Grey|files in grey}} are the same as the ones available in the '''Starter and Developer Packages''': binaries for ''FSBL'' and ''SSBL'' partitions
+
* the {{Grey|files in grey}} are the same as the ones available in the '''Starter and Developer Packages''': binaries for ''FSBL'' and ''SSBL'' partitions, and for OP-TEE OS runtime services
* the {{Orange|files in orange}} are the same as the ones available in the '''Developer Package''': Linux kernel image and device tree blobs
+
* the {{Orange|files in orange}} are the same as the ones available in the '''Developer Package''': Linux kernel image and device tree blobs, and debug symbol files
* the {{Rose|files in pink}} are only available in the '''Distribution Package''': they concern the OP-TEE (see [[How to populate and boot a board with OP-TEE]])
 
   
   
  Distribution-Package/openstlinux-4.14-rocko-mp1-18-07-03/build-openstlinuxweston-stm32mp1/{{Green|tmp-glibc/deploy}}
+
  Distribution-Package/openstlinux-20-02-19 /build-openstlinuxweston-stm32mp/{{Green|tmp-glibc/deploy}}
  └── {{Green|images}}
+
  ├── {{Green|images}}
  |   └── {{Green|stm32mp1}}
+
    └── {{Green|stm32mp1}}
  |       ├── {{Purple|flashlayout_st-image-weston}}                                {{Highlight|Flash layout files (description of the partitions) for the supported flash devices}}
+
        ├── {{STPurple|flashlayout_st-image-weston}}                                {{Highlight|Flash layout files (description of the partitions) for the supported flash devices}}
  |       │  ├── {{Rose|FlashLayout_emmc_stm32mp157c-ev1-optee.tsv}}              {{Highlight|Flash layout file for eMMC and OP-TEE → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_emmc_stm32mp157c-ev1-optee.tsv}}              {{Highlight|Flash layout file for eMMC and trusted boot chain, with OP-TEE OS STM32MP157C-EV1}}
  |       │  ├── {{Purple|FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv}}            {{Highlight|Flash layout file for eMMC and trusted boot chain → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_emmc_stm32mp157c-ev1-trusted.tsv}}            {{Highlight|Flash layout file for eMMC and trusted boot chain → STM32MP157C-EV1}}
  |       │  ├── {{Rose|FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv}}        {{Highlight|Flash layout file for NAND Flash and OP-TEE → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nand-4-256_stm32mp157c-ev1-optee.tsv}}        {{Highlight|Flash layout file for NAND Flash and trusted boot chain, with OP-TEE OS STM32MP157C-EV1}}
  |       │  ├── {{Purple|FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv}}      {{Highlight|Flash layout file for NAND Flash and trusted boot chain → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nand-4-256_stm32mp157c-ev1-trusted.tsv}}      {{Highlight|Flash layout file for NAND Flash and trusted boot chain → STM32MP157C-EV1}}
  |       │  ├── {{Rose|FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv}}          {{Highlight|Flash layout file for NOR Flash (and eMMC) and OP-TEE → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nor-emmc_stm32mp157c-ev1-optee.tsv}}          {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain, with OP-TEE OS STM32MP157C-EV1}}
  |       │  ├── {{Purple|FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv}}        {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nor-emmc_stm32mp157c-ev1-trusted.tsv}}        {{Highlight|Flash layout file for NOR Flash (and eMMC) and trusted boot chain → STM32MP157C-EV1}}
  |       │  ├── {{Rose|FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv}}    {{Highlight|Flash layout file for NOR Flash (and NAND Flasdh) and OP-TEE → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nor-nand-4-256_stm32mp157c-ev1-optee.tsv}}    {{Highlight|Flash layout file for NOR Flash (and NAND Flash) and trusted boot chain, with OP-TEE OS STM32MP157C-EV1}}
  |       │  ├── {{Purple|FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv}}  {{Highlight|Flash layout file for NOR Flash (and NAND Flasdh) and trusted boot chain → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nor-nand-4-256_stm32mp157c-ev1-trusted.tsv}}  {{Highlight|Flash layout file for NOR Flash (and NAND Flash) and trusted boot chain → STM32MP157C-EV1}}
  |       │  ├── {{Rose|FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv}}        {{Highlight|Flash layout file for NOR Flash (and microSD card) and OP-TEE → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nor-sdcard_stm32mp157c-ev1-optee.tsv}}        {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain, with OP-TEE OS STM32MP157C-EV1}}
  |       │  ├── {{Purple|FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv}}      {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP15 Evaluation boards}}
+
        │  ├── {{STPurple|FlashLayout_nor-sdcard_stm32mp157c-ev1-trusted.tsv}}      {{Highlight|Flash layout file for NOR Flash (and microSD card) and trusted boot chain → STM32MP157C-EV1}}
  |      │  ├── {{Purple|FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Discovery kits}}
+
│      │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157a-dk1-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157A-DK1}}
  |       │  ├── {{Rose|FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv}}            {{Highlight|Flash layout file for microSD card and OP-TEE → STM32MP15 Discovery kits}}
+
  │      │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157a-dk1-optee.tsv}}            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157A-DK1}}
  |       │  ├── {{Purple|FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Discovery kits}}
+
      │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157a-dk1-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157A-DK1}}
  |       │  ├── {{Purple|FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP15 Evaluation boards}}
+
│      │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-dk2-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157C-DK2}}
  +
        │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-dk2-optee.tsv}}            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS STM32MP157C-DK2}}
  +
        │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157C-DK2}}
  +
        │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-ev1-basic.tsv}}            {{Highlight|Flash layout file for microSD card and basic boot chain → STM32MP157C-EV1}}
  +
│      │  ├── {{STPurple|FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv}}            {{Highlight|Flash layout file for microSD card and trusted boot chain, with OP-TEE OS → STM32MP157C-EV1}}
  +
│      │  └── {{STPurple|FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv}}          {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP157C-EV1}}
  +
│      │  └── [...]
  +
│      ├── {{STPurple|scripts}}
  +
│      │  └── {{STPurple|create_sdcard_from_flashlayout.sh}}
   
  |       │  ├── {{Rose|FlashLayout_sdcard_stm32mp157c-ev1-optee.tsv}}            {{Highlight|Flash layout file for microSD card and OP-TEE → STM32MP15 Evaluation boards}}
+
        ├── {{STPurple|st-image-bootfs-openstlinux-weston-stm32mp1.ext4}}           {{Highlight|Binary for ''bootfs'' partition}}
|      │  └── {{Purple|FlashLayout_sdcard_stm32mp157c-ev1-trusted.tsv}}         {{Highlight|Flash layout file for microSD card and trusted boot chain ('''recommended setup''') → STM32MP15 Evaluation boards}}
+
  │      ├── {{STPurple|st-image-userfs-openstlinux-weston-stm32mp1.ext4}}           {{Highlight|Binary for ''userfs'' partition}}
  |        └── [...]
+
        ├── {{STPurple|st-image-vendorfs-openstlinux-weston-stm32mp1.ext4}}         {{Highlight|Binary for ''vendorfs'' partition}}
|       ├── {{Purple|scripts}}
+
        ├── {{STPurple|st-image-weston-openstlinux-weston-stm32mp1.ext4}}            {{Highlight|Binary for ''rootfs'' partition}}
|      │  └── {{Purple|create_sdcard_from_flashlayout.sh}}
+
        ├── {{Orange|stm32mp157a-dk1[*].dtb}}                                     {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157A-DK1}}
|      ├── {{Purple|splash.bin}}                                                  {{Highlight|U-Boot splash screen picture (file in BMP format with a ''.bin'' extension) for NOR Flash}}
+
        ├── {{Orange|stm32mp157c-dk2[*].dtb}}                                     {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157C-DK2}}
  |       ├── {{Purple|st-image-bootfs-openstlinux-weston-stm32mp1.ext4}}           {{Highlight|Binary for ''bootfs'' partition}}
+
        ├── {{Orange|stm32mp157c-e[*].dtb}}                                        {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP157C-EV1}}
  |       ├── {{Purple|st-image-userfs-openstlinux-weston-stm32mp1.ext4}}            {{Highlight|Binary for ''userfs'' partition}}
+
  │      ├── {{Grey|tee-[header/pageable/pager]_v2-stm32mp157a-dk1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157A-DK1}}
  |       ├── {{Purple|st-image-weston-openstlinux-weston-stm32mp1.ext4}}           {{Highlight|Binary for ''rootfs'' partition}}
+
      ├── {{Grey|tee-[header/pageable/pager]_v2-stm32mp157c-dk2-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-DK2}}
  |       ├── {{Orange|stm32mp157c-d[*].dtb}}                                       {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Discovery kits}}
+
│      ├── {{Grey|tee-[header/pageable/pager]_v2-stm32mp157c-ev1-optee.stm32}}  {{Highlight|Binaries for OP-TEE OS runtime services (trusted boot chain) → STM32MP157C-EV1}}
  |       ├── {{Orange|stm32mp157c-e[*].dtb}}                                        {{Highlight|Linux kernel device tree blob files for ''bootfs'' partition → STM32MP15 Evaluation boards}}
+
│      ├── {{Orange|tf-a-bl2-optee.elf}}                                          {{Highlight|Debug symbol file for TF-A, with OP-TEE OS → trusted boot firmware stage}}
  |      ├── {{Rose|tf-a-bl2-optee.elf}}                                          {{Highlight|Debug symbol file for TF-A and OP-TEE → trusted boot firmware stage}}
+
        ├── {{Orange|tf-a-bl2-trusted.elf}}                                        {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
  |       ├── {{Orange|tf-a-bl2-trusted.elf}}                                        {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
+
        ├── {{Orange|tf-a-bl32-trusted.elf}}                                      {{Highlight|Debug symbol file for TF-A → runtime software stage}}
  |       ├── {{Orange|tf-a-bl32-trusted.elf}}                                      {{Highlight|Debug symbol file for TF-A → trusted boot firmware stage}}
+
│      ├── {{Grey|tf-a-stm32mp157a-dk1-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
  |      ├── {{Rose|tf-a-stm32mp157c-dk2-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (OP-TEE) STM32MP15 Discovery kits}}
+
  │      ├── {{Grey|tf-a-stm32mp157a-dk1-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
  |       ├── {{Grey|tf-a-stm32mp157c-dk2-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
+
      ├── {{Grey|tf-a-stm32mp157c-dk2-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS STM32MP157C-DK2}}
  |       ├── {{Rose|tf-a-stm32mp157c-ev1-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (OP-TEE) STM32MP15 Evaluation boards}}
+
        ├── {{Grey|tf-a-stm32mp157c-dk2-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
  |       ├── {{Grey|tf-a-stm32mp157c-ev1-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
+
        ├── {{Grey|tf-a-stm32mp157c-ev1-optee.stm32}}                            {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain), with OP-TEE OS STM32MP157C-EV1}}
  +
        ├── {{Grey|tf-a-stm32mp157c-ev1-trusted.stm32}}                          {{Highlight|TF-A binary for ''FSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
  +
│      ├── {{Grey|u-boot-spl.stm32-stm32mp157a-dk1-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
  +
│      ├── {{Grey|u-boot-spl.stm32-stm32mp157c-dk2-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
  +
│      ├── {{Grey|u-boot-spl.stm32-stm32mp157c-ev1-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
  +
│      ├── {{Grey|u-boot-stm32mp157a-dk1-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157A-DK1}}
  +
│      ├── {{Orange|u-boot-stm32mp157a-dk1-optee.elf}}                            {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157A-DK1}}
  +
│      ├── {{Grey|u-boot-stm32mp157a-dk1-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157A-DK1}}
  +
│      ├── {{Orange|u-boot-stm32mp157a-dk1-trusted.elf}}                          {{Highlight|Debug symbol file for U-Boot → STM32MP157A-DK1}}
  +
│      ├── {{Grey|u-boot-stm32mp157a-dk1-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157A-DK1}}
  +
│      ├── {{Grey|u-boot-stm32mp157c-dk2-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-DK2}}
  +
│      ├── {{Orange|u-boot-stm32mp157c-dk2-optee.elf}}                            {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-DK2}}
  +
│      ├── {{Grey|u-boot-stm32mp157c-dk2-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-DK2}}
  +
│      ├── {{Orange|u-boot-stm32mp157c-dk2-trusted.elf}}                          {{Highlight|Debug symbol file for U-Boot → STM32MP157C-DK2}}
  +
│      ├── {{Grey|u-boot-stm32mp157c-dk2-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-DK2}}
  +
│      ├── {{Grey|u-boot-stm32mp157c-ev1-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP157C-EV1}}
  +
│      ├── {{Orange|u-boot-stm32mp157c-ev1-optee.elf}}                            {{Highlight|Debug symbol file for U-Boot, with OP-TEE OS → STM32MP157C-EV1}}
  +
│      ├── {{Grey|u-boot-stm32mp157c-ev1-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain), with OP-TEE OS → STM32MP157C-EV1}}
  +
│      ├── {{Orange|u-boot-stm32mp157c-ev1-trusted.elf}}                          {{Highlight|Debug symbol file for U-Boot → STM32MP157C-EV1}}
  +
│      ├── {{Grey|u-boot-stm32mp157c-ev1-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP157C-EV1}}
  +
│      ├── {{Orange|uImage}}                                                     {{Highlight|Linux kernel binary image file (with U-Boot wrapper) for ''bootfs'' partition}}
  +
│      ├── {{Orange|vmlinux}}                                                    {{Highlight|Debug symbol file for Linux kernel}}
  +
│      └── [...]
  +
└── [...]
   
|      ├── {{Purple|u-boot-spl.stm32-stm32mp157c-dk2-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP15 Discovery kits}}
+
<noinclude>
|      ├── {{Purple|u-boot-spl.stm32-stm32mp157c-ev1-basic}}                      {{Highlight|U-Boot binary for ''FSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
+
{{PublicationRequestId | 7649 | 2018-06-11 | AnneJ}}
  |       ├── {{Purple|u-boot-stm32mp157c-dk2-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP15 Discovery kits}}
+
[[Category:STM32MPU Embedded Software distribution]]
|      ├── {{Rose|u-boot-stm32mp157c-dk2-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (OP-TEE) → STM32MP15 Discovery kits}}
+
</noinclude>
|      ├── {{Grey|u-boot-stm32mp157c-dk2-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Discovery kits}}
 
|      ├── {{Purple|u-boot-stm32mp157c-ev1-basic.img}}                            {{Highlight|U-Boot binary for ''SSBL'' partition (basic boot chain) → STM32MP15 Evaluation boards}}
 
|      ├── {{Rose|u-boot-stm32mp157c-ev1-optee.stm32}}                          {{Highlight|U-Boot binary for ''SSBL'' partition (OP-TEE) → STM32MP15 Evaluation boards}}
 
|      ├── {{Grey|u-boot-stm32mp157c-ev1-trusted.stm32}}                        {{Highlight|U-Boot binary for ''SSBL'' partition (trusted boot chain) → STM32MP15 Evaluation boards}}
 
|      ├── {{Orange|uImage}}                                                      {{Highlight|Linux kernel binary image file (with U-Boot wrapper) for ''bootfs'' partition}}
 
|      ├── {{Orange|vmlinux}}                                                    {{Highlight|Debug symbol file for Linux kernel}}
 
|      └── [...]
 
└── [...]