2. Release Specific¶
2.1. Processor SDK Android Release Notes¶
2.1.1. Overview¶
The Processor Software Development Kit (Processor-SDK) for Android provides a fundamental software platform for development, deployment and execution of Android based applications and includes the following:
- Bootloaders & Filesystems
- SDK Installer
- Setup Scripts
- Makefiles
- eMMC Images
- Android UI
- Example Applications
2.1.2. Licensing¶
Please refer to the software manifest, which outlines the licensing status for all packages included in this release. The manifest can be found on the SDK download page. The manifest can be found on the SDK download page or in the installed directory as indicated below. In addition, see Processor SDK Android GPLv3 Disclaimer
2.1.3. Documentation¶
- Software Developer Guide: Provides information on features, functions, delivery package and, compile tools for the Processor SDK Android release. This also provides detailed information regarding software elements and software infrastructure to allow developers to start creating applications.
- Getting Started Guide: provides information on getting the software and running examples/demonstrations bundled in the SDK.
- Software Manifest: Provides license information on software
included in the SDK release. This document is in the release at
[INSTALL-DIR]/docs. - EVM Quick Start Guide: Provides information on hardware setup and running the demonstration application that is loaded on flash. This document is provided as part of the EVM kit.
2.1.4. Release 05.00.00¶
Released July 2018
What’s New
This is an “O-Pastry” based release of Processor SDK Android for AM57x.
Release Features
Following new features are enabled/tested in this release:
- Support AM574x IDK
- Boot: fastboot, emmc boot, GP with FIT model
- Platform: LPAE support, SELinux Permissive mode
- Connectivity: USB2.0/USB3.0 Host, Gadget, Ethernet, SD card detect, eMMC
- Power: AVS0, MPU DVFS, ABB
- Thermal: Governors implemented for MPU (On Die), Monitoring implemented for all on chip sensors
- Video: 1080p30 MP4/H264/MP2
- Audio: MP3/AAC playback
- Display: SGX accelerated UI and touch, DRM/KMS
SDK Components and Versions
| Component | Version |
|---|---|
| Linux Kernel | 4.14.40 |
| U-boot | 2018.01 |
| Android | Android O-Pastry 8.1 |
| Toolchain | Linaro GCC 7.2-2017.11 |
| IPC | 3.47.01.00 |
2.1.5. Supported Platforms¶
See Processor_SDK_Supported_Platforms_and_Versions for a list of supported platforms and links to more information.
2.1.6. Issue Tracker¶
2.1.6.1. Issues opened in previous releases that were closed on this release¶
| Record ID | Platform | Title |
|---|---|---|
| PANDSDK-112 | am572x-evm | u-boot version being used is showing MMC fail messages |
| PANDSDK-127 | am571x-idk, am572x-idk | AM57xx-IDK: Screen is hard to use at default resolution |
| PANDSDK-128 | am572x-idk | AM572x-IDK: LCD & HDMI screens intermittently lockup while playing videos |
| PANDSDK-129 | am571x-idk, am572x-idk | AM57xx-IDK: Video played on LCD has long pauses when Android is booted without HDMI connected |
| PANDSDK-132 | am572x-evm, am571x-idk, am572x-idk | Audio breaks up some when MP3 clip is played and Internet is browsed |
| PANDSDK-142 | am572x-evm, am571x-idk, am572x-idk | When running setup.sh script seeing error pop up: “Unable to find the requested file. Please check the spelling and try again” |
| PSDKAA-1950 | am572x-evm, am571x-idk, am572x-idk | Random sgx crash on J6 with HDMI connected, one time issue. |
| PSDKAA-1948 | am572x-evm, am571x-idk, am572x-idk | After leaving SGX idle, UI was observed to freeze with SGX crash. One time issue |
| PSDKAA-1937 | am572x-evm, am571x-idk, am572x-idk | Crashes seen while running gfxbench |
2.1.6.2. Known Issues¶
| Record ID | Platform | Title | Workaround |
|---|---|---|---|
| LCPD-11852 | am57xx-evm | U-Boot: AM57x: doesn’t detect super-speed thumb drive | |
| LCPD-12491 | am57xx-evm | Android: Selinux warnings during bootup | |
| LCPD-12513 | am57xx-evm | Android O: Board takes longer to boot compared to MM | |
| LCPD-12776 | am57xx-evm | Android: Graphics Error with Vellamo3 Benchmark | |
| LCPD-12934 | am57xx-evm | Android: Robustness test: monkey fails | Appy patch available here |
| LCPD-12935 | am571x-idk, am572x-idk, am574x-idk | PVR Dmabuf error observed | Apply kernel patch and patches for vendor-ti-dra7xx |
| LCPD-13011 | am571x-idk, am572x-idk, am574x-idk, am57xx-evm | Web pages take a very long time to load >30 seconds | |
| PANDSDK-154 | am571x-idk, am572x-idk, am574x-idk | 1080p decoding does not work for AM57xx IDKs with LCD connected | For LCD only without HDMI connected, reduce the resolution by running wm size 1280x720. No workaround when both LCD and HDMI are used. This limitation comes from insufficient TILER memory when the screen resolution is larger than 720p. When LCD is connected, the screen resolution is detected and selected as 1920x1200. |
2.1.7. Installation and Usage¶
The Software Developer’s Guide provides instructions on how to setup up your Android development environment, install the SDK and start your development.
2.1.8. Host Support¶
The Processor SDK is developed, built and verified on Ubuntu 14.04.
Note
Processor SDK Installer is 64-bit, and installs only on 64-bit host machine. Support for 32-bit host is dropped as Linaro toolchain is available only for 64-bit machines
2.2. Supported Platforms and Versions¶
Supported Host Operating Systems
The following operating systems have been validated to work with our SDK.
- Linux SDK
| Operating System | Version |
| Ubuntu | 14.04 (64-bit) |
| Ubuntu | 16.04 (64-bit) |
- RTOS SDK
| Operating System | Version |
| Windows | 7 (64-bit) |
| Ubuntu | 16.04 (64-bit) |
- Android SDK
| Operating System | Version |
| Ubuntu | 14.04 (64-bit) |
Supported Platforms and EVMs
The following platforms and EVMs are supported with Processor SDK
2.3. Migration Guide¶
Overview
This page covers migration information for applications built on top of the Processor SDK for Android.
Processor SDK Android 05.00.00
- Linux Kernel and U-boot are updated to v4.14 and 2018.01 respectively, while the pastry continues to be Android-Oreo
- More details about Oreo can be obtained from here
- SD card creation now creates boot partition only with MLO, u-boot.img, and uEnv.txt. After flashing the eMMC device by Running Setup Scripts, SD card is required to boot AM57x IDKs. Keep the SD card plugged in, power cycle AM57x IDKs to use MLO and u-boot.img from the SD card and the rest from the eMMC. For AM57x GP EVM, SD card can be removed before the power cycle to boot Android with everything from the eMMC.
- VPE is not supported
Processor SDK Android 04.03.00
- This is a maintenance update release of Processor SDK Android for AM57xx with Oreo. More details about Oreo can be obtained from here
Processor SDK Android 04.02.00
- This is the first release of the Processor SDK Android for AM57xx with Oreo. Both U-Boot and Android Kernel are the same LTS as prior Processor SDK releases, i.e. 2016.05 and 4.4 respectively.
- More details about Oreo can be obtained from here
- See the Release Notes for full list of modifications.
Processor SDK Android 04.01.00
- This is the final release of the Processor SDK Android for AM57xx with Marshmallow. The next release will be based on Oreo
- See the Release Notes for full list of modifications.
Processor SDK Android 04.00.00
- This is the first release of the Processor SDK Android which supports AM57xx devices.
- See the Release Notes for full list of modifications.