View source for STM32MP1 Distribution Package for Android

This article describes how to obtain and use the '''Distribution Package for Android''' of the '''STM32MPU Embedded Software''' for any '''STM32MP1 family''' ([[STM32MP15 boards]]) development platform, in order to modify or add pieces of software, and to create the right Android distribution for the targeted product. <br>

It lists some '''prerequisites''' in terms of knowledge and development environment, and gives '''step-by-step''' instructions to download and install the STM32MPU Embedded Software packages for this Package.

{{Warning|
{{EcosystemFlow/Archives | custom=Android | flow=v1}}
}}

==Distribution Package content==
If you are not familiar with the '''STM32MPU Embedded Software for Android''' distribution and its '''Packages''', please read the following articles:
* [[Which STM32MPU Embedded Software Package for Android better suits your needs]] (and especially the [[Which STM32MPU Embedded Software Package for Android better suits your needs#Distribution Package|Distribution Package]] chapter)
* [[:Category:STM32MPU Embedded Software distribution for Android|STM32MPU Embedded Software distribution for Android]]

In summary, this '''Distribution Package''' provides:
* An '''Android build framework''' (aka distribution builder)
* For the '''STM32MPU distribution for Android''' (development on Arm Cortex-A processor):
** the BSP (Linux kernel, U-Boot, TF-A, optionally OP-TEE) pieces in '''binary''' (prebuilt). Several scripts are provided to load source code and re-build them
** the application frameworks (including hardware abstraction code) pieces in '''source code'''
* For the '''STM32Cube MPU Package''' (development on Arm Cortex-M processor), all pieces of software in '''source code''': BSP, HAL, middlewares and applications
* A toolset to tune the system for your needs, and to handle the built image (for example STM32CubeProgrammer to install the built image on the board).

==Prerequisites==
===Knowledge===
The STM32MP1 Distribution Package aims to create an Android distribution for the targeted product: solid knowledge of Linux and Android are recommended to make the most of this Package.

The STM32MPU distribution for Android is an Android distribution based on the Android build framework: a short introduction about Android is available in AOSP<ref>https://source.android.com/devices/architecture</ref>.

Reading the [[STM32MPU Embedded Software for Android architecture overview]] is also highly recommended.

===Development setup===
{{:Development setup for STM32MPU Embedded Software}}

== Installing the STM32MPU distribution for Android ==
{{Warning|
{{EcosystemFlow/Archives | custom=Android | flow=v1}}
}}

== Building the STM32MPU distribution for Android==

When the installation is complete, please refer to the [[How to build STM32MPU distribution for Android]] page to learn how to build it.

== Flashing the built image==

When the distribution has been built, please refer to the [[How to populate boards for Android]] page to learn how to flash your device.

==References==
<references />

<noinclude>
[[Category:Getting started with STM32MP1 boards]]
[[Category:Distribution Package]]
[[Category:Android]]
{{PublicationRequestId | 12870 |2019-07-30}}
</noinclude>