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.01.00

Released October 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:

  • 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: 720p30 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.67
U-boot 2018.01
Android Android O-Pastry 8.1
Toolchain Linaro GCC 7.2-2017.11

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
LCPD-12486 am57xx-evm Android: libdrm-modetest not found in builds
LCPD-12487 am574x-idk, am57xx-evm Android: eth port issue
LCPD-12488 am57xx-evm Android: GFX warning seen on console
LCPD-12512 am57xx-evm Board is not able to boot from emmc after flashing
LCPD-12659 am57xx-evm Artifact observed during video decode operations
LCPD-12679 am574x-idk, am57xx-evm, am57xx-beagle-x15 PVR_K: dmabuf error during video playback
LCPD-12776 am57xx-evm Android: Graphics Error with Vellamo3 Benchmark
LCPD-12782 am571x-idk, am572x-idk Android: AM571/572 IDK Board is not able to boot
LCPD-12796 am571x-idk, am572x-idk, am574x-idk, am57xx-beagle-x15 Board requires USB input device to boot
LCPD-12919 am57xx-evm PVR error observed during long term decode operations
LCPD-12934 am57xx-evm Android: Robustness test: monkey fails
LCPD-12935 am571x-idk, am572x-idk, am574x-idk PVR Dmabuf error observed
LCPD-12938 am571x-idk, am572x-idk, am574x-idk, am57xx-evm GFXBench is not able to run no space left on device
LCPD-13003 am571x-idk, am572x-idk, am574x-idk, am57xx-evm Need LCD detection logic for the IDK boards in the fastboot.sh script
LCPD-13005 am571x-idk, am572x-idk, am574x-idk, am57xx-evm Component Test: POWERMGR_S_FUNC_CPUFREQ_BASIC Failed
LCPD-13006 am571x-idk, am572x-idk, am574x-idk, am57xx-evm Seeing gadget disconnect/reconnect over and over ~5 minutes after booting
LCPD-13009 am571x-idk, am572x-idk, am574x-idk, am57xx-evm, am57xx-beagle-x15 AM57xx-IDK: Video played on LCD has long pauses when Android is booted without HDMI connected
LCPD-13016 am571x-idk, am572x-idk, am574x-idk, am57xx-evm u-boot version being used is showing MMC fail messages
LCPD-13467 am571x-idk, am572x-idk, am574x-idk, am57xx-evm Services problems reported after reboot

2.1.6.2. Issues found and closed on this release that may be applicable to prior releases

Record ID Platform Title
LCPD-13147 am57xx-evm, am57xx-beagle-x15 Regression to boot to UI with DB 178
LCPD-13568 am571x-idk, am572x-idk, am574x-idk, am57xx-evm, am57xx-beagle-x15 Android Boot failure due to binder errors
LCPD-13601 am571x-idk, am574x-idk, am57xx-evm, am57xx-beagle-x15 Android: Treble: Gatekeeper service crash
LCPD-13668 am57xx-evm Android: AM57x with LCD: Android System Internal error reported at boot_complete

2.1.6.3. Known Issues

Record ID Platform Title Workaround
LCPD-12491 am57xx-evm Android: Selinux warnings during bootup  
LCPD-12511 am57xx-evm Audio record is not working  
LCPD-12513 am57xx-evm Android O: Board takes longer to boot compared to MM  
LCPD-12928 am57xx-evm Periodic frame freezes observed while decoding H264 video  
LCPD-13409 am571x-idk, am572x-idk, am574x-idk Android: IDK: Bootloader images fail to boot from eMMC  
LCPD-13602 am571x-idk, am574x-idk, am57xx-evm, am57xx-beagle-x15 Android: Treble: Selinux warnings and enforcing mode errors  
LCPD-13723   [android] allmodconfig fails to build on kernel build redirect  
LCPD-13795 am571x-idk, am57xx-evm, am57xx-beagle-x15 Android: Graphics service failure with “stop” and “start” command  
LCPD-13796 am57xx-evm Android: monkey test causes system crash after 10 mins of execution  
LCPD-13797 am57xx-evm Android:CTS Failures  

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)
16.04 (64-bit)
18.04 (64-bit)
  • RTOS SDK
Operating System
Version
Windows
7 (64-bit)
Ubuntu
14.04 (64-bit)
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

Platform EVM Tested Version Document Processor SDK Linux Processor SDK RT Linux Processor SDK RTOS Processor SDK Android
AM65x/DRA80xM AM65x/DRA80xM EVM Beta Hardware User’s Guide Hardware Setup with CCS X X X  
AM65x/DRA80xM IDK Beta Hardware User’s Guide Hardware Setup with CCS X X X  
AM57x AM572x EVM A3 Hardware User’s Guide X X X X
AM572x IDK 1.3A Hardware User’s Guide Hardware Setup with CCS X X X  
AM571x IDK 1.3A Hardware User’s Guide Hardware Setup with CCS X X X X
AM574x IDK 1.0A Hardware User’s Guide Hardware Setup with CCS X X X X
AM437x AM437x EVM 1.5B Hardware User’s Guide X X X  
AM437x SK 1.1A Hardware User’s Guide X   X  
AM437x IDK 1.4A Hardware User’s Guide   X X  
AM335x AM335x EVM 1.6A Hardware User’s Guide X X X  
AM335x SK 1.2 Hardware User’s Guide X   X  
BeagleBone Black B6 Hardware User’s Guide X   X  
AM335x ICE 2.1A Hardware User’s Guide Hardware Setup with CCS   X X  
K2H/K2K 66AK2Hx EVM 4.0 Hardware User’s Guide X X X  
TCI6638K2K EVM 4.0 Hardware User’s Guide X X X  
K2E AK2Ex EVM 1.0.3.0 Hardware User’s Guide X X X  
K2L 66AK2L06 EVM 1.0.3.0 Hardware User’s Guide X X X  
K2G K2G EVM 1.3D

Hardware User’s Guide

Hardware Setup with CCS

 X X X  
K2G 1G EVM 1.5D X X X  
K2G Audio Daughtercard D Software Support     X  
K2G ICE EVM 1.0C Beta Hardware User’s Guide Hardware Setup with CCS X X X  
C665x C665x EVM 1.1-44 Hardware User’s Guide N/A N/A X  
C667x C667x EVM 3B Hardware User’s Guide N/A N/A X  
OMAPL137/C6747 OMAP-L137/C6747 Starter kit EVM J Hardware User’s Guide Hardware Setup with CCS N/A N/A X  
OMAPL138/C6748 OMAP-L138/C6748 LCDK A7A Hardware User’s Guide X N/A X  
AMIC110 AMIC110 ICE 1.1 Hardware User’s Guide Hardware Setup with CCS     X  

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.01.00

  • This is a maintenance update release of Processor SDK Android for AM57xx with Oreo. More details about Oreo can be obtained from here
  • Multimedia with hardware acceleration is not supported
  • Video decoding up to 720p resolution
  • See 05.01.00 Release Notes for full list of modifications.

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
  • See 05.00.00 Release Notes for full list of modifications.

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
  • See 04.03.00 Release Notes for full list of modifications.

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 04.02.00 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 04.01.00 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 04.00.00 Release Notes for full list of modifications.