This article describes the content of STM32MPU distribution for Android software release version Template:Highlight2, which is part of STM32MP15 ecosystem release note - v1.1.0.
1. Intended audience[edit source]
The targeted audience is STM32MP15 customers or partners.
2. Delivery scope and purpose[edit source]
The STM32MPU distribution for Android™ provides all necessary components for running, developing and/or making your own platform based on Android™ framework. It runs on the Arm® Cortex®-A7 processors, and is a fundamental part of the STM32MPU Embedded Software distribution for Android.
It is compatible with Android 9.0.0 (Pie).
This delivery of STM32MPU distribution for Android is part of STM32MP15-Ecosystem-v1.0.0 (see the STM32MP15 ecosystem release note - v1.0.0).
3. Licensing[edit source]
This software package is licensed under a LIMITED LICENSE AGREEMENT FOR ST MATERIALS EVALUATION (LLA). Customers may not use this package except in compliance with the software license agreement (SLA).
All of the packages use the same source components. All components and their respective licenses are listed here.
4. Supported hardware[edit source]
This software delivery is compatible with the following boards:
- STM32MP157C-EV1 Evaluation board. For more information on this board, please read the article STM32MP157C-EV1 - hardware description
5. Delivered features[edit source]
5.1. Main software components[edit source]
- Android version v9.0.0 (AOSP android-9.0.0_r46 tag)
- Kernel version v4.19.49 (AOSP common kernel) + updates for STM32MP1 and associated boards (waiting upstream finalization)
- TF-A version v2.0 + updates for STM32MP1 and associated boards (waiting upstream finalization)
- U-Boot version v2018.11 + updates for STM32MP1 and associated boards (waiting upstream finalization)
- OP-TEE version v3.3.0 + updates for STM32MP1 and associated boards (waiting upstream finalization)
- STM32CubeMP1 FW v1.1.0
- GCC version v8.2
- openOCD version v0.10.0
- GCnano version v6.2.4
5.2. Detailed features[edit source]
5.2.1. Kernel part[edit source]
5.2.2. U-boot part[edit source]
5.2.3. TF-A part[edit source]
5.2.4. OP-TEE part[edit source]
5.2.5. Features list[edit source]
Domain | Feature | STM32MP15 Evaluation board |
Comment |
---|---|---|---|
Boot | Fastboot | Entering this mode through connect ST-Link console (uart) or by HW control | |
Verified boot | |||
A/B mechanism | A/B images available but boot on A by default | ||
Recovery | |||
Multimedia | Audio speaker | Partially | audio speaker output can be used only to connect heaset |
Audio headset | |||
Audio USB | |||
Camera | |||
Camera USB | |||
Video SW decode | 480p30 max. without audio | ||
Security | SELinux | ||
Runtime verification | |||
Trust environment | OP-TEE | ||
Keystore | Only default software solution available | ||
Network and connectivity | Ethernet | ||
Wifi | Using USB dongle (RTL8723AU) | ||
Wifi hotspot | |||
BT / BLE | Using USB dongle (RTL8723AU) | ||
USB | Mass storage / MTP / PTP | ||
Systems | Boot control | Partially | Available but not enable |
Power control | Partially | Available but not enable | |
Thermal control | Partially | Available but not enable | |
Update engine | |||
Sensors | Accelerometer | ||
Gyroscope | |||
Magnetometer | |||
Proximity | |||
Pressure | |||
Temperature | |||
Sensor Hub | |||
Debug | ADB (USB) | ||
ADB (Ethernet) | |||
ADEB | |||
Perfetto | |||
SYSTRACE | |||
Metrics | |||
Storage | USB Key | ||
microSD card | |||
eMMC | |||
Others | Lights | ||
Touchscreen |
6. Recommendations for use[edit source]
6.1. Safe use[edit source]
6.2. Non-recommended use[edit source]
7. Main restrictions list[edit source]
8. Minor release updates[edit source]
9. How to get started with st-android-9.0.0-2019-09-27[edit source]
Refer to How to get the software and start with this release.
10. Associated tools[edit source]
Refer to the Referenced tools release notes .
++ Android Studio?
11. Demo applications[edit source]
11.1. STCopro M4Echo application[edit source]
11.2. STCopro M4Example application[edit source]
12. Change log / Main changes[edit source]
Initial version.
13. Detailed delivery content[edit source]
13.1. Detailed description of STMicroelectronics modules[edit source]
13.1.1. BSP modules[edit source]
Module name | Path of module | Description | ||||
---|---|---|---|---|---|---|
stm32mp1-bootloader | device/stm/
|
Primary (Trusted Firmware-A) and secondary (Universal Boot Loader for embedded devices) bootloaders for STM32MP | ||||
STM32MPU distribution for Android licenses - v1.0.0 | ||||||
STM32MPU distribution for Android licenses - v1.0.0 | ||||||
stm32mp1-kernel | device/stm/
|
Linux STM32MP Kernel | ||||
STM32MPU distribution for Android licenses - v1.0.0 | ||||||
stm32mp1-tee | device/stm/
|
OPTEE OS for STM32MP | ||||
STM32MPU distribution for Android licenses - v1.0.0 | ||||||
stm32mp1-openocd | device/stm/
|
Free and Open On-Chip Debugging, In-System Programming and Boundary-Scan Testing | ||||
|
13.1.2. Common and peripherals modules[edit source]
Module name | Path of module | Description | ||||
---|---|---|---|---|---|---|
stm32mp1 | device/stm/
|
Configuration of the STM32MP1 distribution for Android | ||||
| ||||||
allocator | device/stm/stm32mp1/
|
STMicroelectronics allocator HAL public header files useful for composer | ||||
| ||||||
audio | device/stm/stm32mp1/
|
STMicroelectronics Audio HAL source code | ||||
| ||||||
bootctrl | device/stm/stm32mp1/
|
STMicroelectronics Boot Control HAL source code and the dedicated misc partition image generator | ||||
| ||||||
camera | device/stm/stm32mp1/
|
STMicroelectronics Camera HAL source code | ||||
| ||||||
composer | device/stm/stm32mp1/
|
STMicroelectronics composer HAL source code | ||||
| ||||||
copro | device/stm/stm32mp1/
|
STMicroelectronics Copro HAL source code | ||||
| ||||||
health | device/stm/stm32mp1/
|
STMicroelectronics Health hardware service source code | ||||
| ||||||
lights | device/stm/stm32mp1/
|
STMicroelectronics Lights HAL source code | ||||
| ||||||
memtrack | device/stm/stm32mp1/
|
STMicroelectronics Memtrack HAL source code | ||||
| ||||||
oemlock | device/stm/stm32mp1/
|
STMicroelectronics OemLock HAL source code (stub version) | ||||
| ||||||
thermal | device/stm/stm32mp1/
|
STMicroelectronics Thermal hardware service source code | ||||
| ||||||
usb | device/stm/stm32mp1/
|
STMicroelectronics Usb hardware service source code | ||||
| ||||||
wifi | device/stm/stm32mp1/
|
STMicroelectronics libwifi HAL source code | ||||
|
13.1.3. Board modules[edit source]
Module name | Path of module | Description | ||||
---|---|---|---|---|---|---|
eval | device/stm/stm32mp1/
|
STMicroelectronics configuration for Android used to generate images adapted to the STM32MP15 Evaluation boards | ||||
|
13.1.4. Coprocessor service module[edit source]
Module name | Path of module | Description | ||||
---|---|---|---|---|---|---|
CoproService | packages/apps/
|
|||||
|
13.1.5. ST application modules[edit source]
Module name | Path of module | Description | ||||
---|---|---|---|---|---|---|
app | vendor/stm/app
|
STMicroelectronics applications associated if required to their respective coprocessor firmware | ||||
|