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