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


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.3. Release 04.03.00

Released March 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, QSPI/NOR + emmc boot, Single stage bootloader, USB peripheral boot, HS Boot with FIT model, IPU Loading, Switch to recovery mode
  • Platform: LPAE support, SELinux enforce mode
  • IPC: MessageQ, MmRpc, Late attach support, error recovery : DEH And MMU faults
  • Connectivity: USB2.0/USB3.0 Host, Gadget and dual-role, Dual Ethernet, SD card detect, eMMC HS200 mode
  • Power: AVS0, MPU DVFS, ABB
  • Thermal: Governors implemented for MPU (On Die), Monitoring implemented for all on chip sensors
  • Video: 1080p60 MP4/H264/MP2, H264 Video Encode (F2F)
  • Audio: MP3/AAC playback, ARM<->DSP Audio Routing
  • Display: SGX accelerated UI and touch, DRM/KMS, DSS WB, SGX and DSS simultaneous composition.
  • Camera: VIP: YUYV/RGB888 format capture, NV12 capture, Interlaced capture, VPE: color conversion, V4L2 M2M, scalar, DEI

SDK Components and Versions

Component Version
Linux Kernel 4.4.117
U-boot 2016.05
Android Android O-Pastry 8.1
Toolchain Andriod linux-x86 toolchain android-eabi-4.9
IPC 3.47.01.00

2.1.4. Supported Platforms

See Processor_SDK_Supported_Platforms_and_Versions for a list of supported platforms and links to more information.


2.1.5. Issue Tracker

2.1.5.1. Issues opened in previous releases that were closed on this release

Record ID Platform Title
PANDSDK-109 am572x-evm, am571x-idk, am572x-idk Get libpcre2.so “No such file or directory” error when running setup.sh
PSDKAA-1949 am572x-evm, am571x-idk, am572x-idk Touchscreen errors when terminal disconnected. Issue with touchscreen with some PSUs
PSDKAA-1943 am572x-evm, am571x-idk, am572x-idk Crash seen with MPEG2 robustness test
PSDKAA-1942 am572x-evm, am571x-idk, am572x-idk H264 encode fails with main and high profiles
PSDKAA-1938 am572x-evm, am571x-idk, am572x-idk Wallpaper is loaded a few seconds after UI comes up
PSDKAA-1932 am572x-evm, am571x-idk, am572x-idk System crashes and reboots after adb remount
PSDKAA-1797 am572x-evm, am571x-idk, am572x-idk OOM and Kernel crash with 10 minutes of monkey test
PSDKAA-1718 am572x-evm, am571x-idk, am572x-idk Fence timeout issue - HWC timeout is not cleaned up correctly causing graphics failure

2.1.5.2. Known Issues

Record ID Platform Title Workaround
PANDSDK-112 am572x-evm u-boot version being used is showing MMC fail messages Does not affect functionality
PANDSDK-126 am572x-evm AM572x-EVM: No audio over HDMI when HDMI monitor connected  
PANDSDK-127 am571x-idk, am572x-idk AM57xx-IDK: Screen is hard to use at default resolution change resolution with “su; wm density 240”
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-131 am572x-evm, am571x-idk, am572x-idk Web pages take a very long time to load >30 seconds  
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”  
PANDSDK-145 am572x-evm, am571x-idk, am572x-idk Camera application not able to connect to camera  
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  

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.


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

Platform EVM Tested Version Document Processor SDK Linux Processor SDK RT Linux Processor SDK RTOS Processor SDK Android
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 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  
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 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  

All platforms supporting Linux share

  • Linux Kernel 4.9
  • U-Boot 2017.01
  • Linaro GCC 6.2.1 Toolchain

For a full list of components, see the Release Notes for Processor SDK Linux, Processor SDK RTOS, and Processor SDK Android.

2.3. Migration Guide

Overview

This page covers migration information for applications built on top of the Processor SDK for Android.

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.