STM32MP15 distribution for Android release note - v1.0.0

This message will disappear after all relevant tasks have been resolved.

Semantic MediaWiki

There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.

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 9.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 arm-8.2-2019.01
openOCD version v0.10.0
GCnano version v6.2.4.p4

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
Others	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/ stm32mp1-bootloader Primary (Trusted Firmware-A) and secondary (Universal Boot Loader for embedded devices) bootloaders for STM32MP

STM32MPU distribution for Android licenses - v1.0.0

stm32mp1-kernel device/stm/ stm32mp1-kernel Linux STM32MP Kernel

STM32MPU distribution for Android licenses - v1.0.0

stm32mp1-tee device/stm/ stm32mp1-tee OPTEE OS for STM32MP

STM32MPU distribution for Android licenses - v1.0.0

stm32mp1-openocd device/stm/ stm32mp1-openocd Free and Open On-Chip Debugging, In-System Programming and Boundary-Scan Testing

Name	Version	License
stm32mp1-openocd	0.10.0	GPLv2

13.1.2. Common and peripherals modules[edit source]

Module name Path of module Description

stm32mp1 device/stm/ stm32mp1 Configuration of the STM32MP1 distribution for Android

Name	Version	License
stm32mp1	NA	Apache v2.0

allocator device/stm/stm32mp1/ peripheral/allocator STMicroelectronics allocator HAL public header files useful for composer

Name	Version	License
allocator	NA	Apache v2.0

audio device/stm/stm32mp1/ peripheral/audio STMicroelectronics Audio HAL source code

Name	Version	License
audio	NA	Apache v2.0

bootctrl device/stm/stm32mp1/ peripheral/bootctrl STMicroelectronics Boot Control HAL source code and the dedicated misc partition image generator

Name	Version	License
bootctrl	NA	Apache v2.0

camera device/stm/stm32mp1/ peripheral/camera STMicroelectronics Camera HAL source code

Name	Version	License
camera	NA	Apache v2.0

composer device/stm/stm32mp1/ peripheral/composer STMicroelectronics composer HAL source code

Name	Version	License
composer	NA	Apache v2.0

copro device/stm/stm32mp1/ peripheral/copro STMicroelectronics Copro HAL source code

Name	Version	License
copro	NA	Apache v2.0

health device/stm/stm32mp1/ peripheral/health STMicroelectronics Health hardware service source code

Name	Version	License
health	NA	Apache v2.0

lights device/stm/stm32mp1/ peripheral/lights STMicroelectronics Lights HAL source code

Name	Version	License
lights	NA	Apache v2.0

memtrack device/stm/stm32mp1/ peripheral/memtrack STMicroelectronics Memtrack HAL source code

Name	Version	License
memtrack	NA	Apache v2.0

oemlock device/stm/stm32mp1/ peripheral/oemlock STMicroelectronics OemLock HAL source code (stub version)

Name	Version	License
oemlock	NA	Apache v2.0

thermal device/stm/stm32mp1/ peripheral/thermal STMicroelectronics Thermal hardware service source code

Name	Version	License
thermal	NA	Apache v2.0

usb device/stm/stm32mp1/ peripheral/usb STMicroelectronics Usb hardware service source code

Name	Version	License
usb	NA	Apache v2.0

wifi device/stm/stm32mp1/ peripheral/wifi STMicroelectronics libwifi HAL source code

Name	Version	License
wifi	NA	Apache v2.0

13.1.3. Board modules[edit source]

Module name Path of module Description

eval device/stm/stm32mp1/ eval STMicroelectronics configuration for Android used to generate images adapted to the STM32MP15 Evaluation boards

Name	Version	License
eval	NA	Apache v2.0

13.1.4. Coprocessor service module[edit source]

Module name Path of module Description

CoproService packages/apps/ CoproService

Name	Version	License
CoproService	NA	TBD

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

Name	Version	License
app	NA	Apache v2.0