ANDROID RN 4 06 00 01

'''  Content is no longer maintained and is being kept for reference only! '''

Introduction
'''  Content is no longer maintained and is being kept for reference only! '''

This release includes the Android graphics drivers for Icecream Sandwich supporting AM335x, AM/DM 37x family of chipsets. The Graphics SDK contains documentation, demo programs and tools.

Important Note:


 * AM/DM 37x have been tested with 2.6.37 kernel.
 * AM 335x is tested with 3.1 kernel.

Requirements, Pre-requisites and demo instructions
For software setup and pre-requisites and other instructions, refer to the main pages at, Android_Graphics_SDK_Getting_Started_Guide

Features in this release

 * Support for SGX-530 core revisions 1.2.5 (AM 37x, AM335x)
 * Support for AM37x with 2.6.37 Kernel on IceCream Sandwich.
 * Support for AM335x with 3.1 Kernel on IceCream Sandwich.

Kernel, Toolchain used for validation
AM37x:


 * Tested with Linux 2.6.37 kernel - IceCream Sandwich.
 * Android toolchain - IceCream Sandwich.
 * Android filesystem - IceCream Sandwich.

AM335x:


 * Tested with Linux 3.1 kernel - IceCream Sandwich.
 * Android toolchain - IceCream Sandwich.
 * Android filesystem - IceCream Sandwich.

Khronos API support

 * OpenGL ES 1.1
 * OpenGL ES 2.0
 * EGL
 * Limited 2D acceleration via PVR2D API

Window Systems

 * Android Window system is supported.

Extensions

 * Refer to eglinfo output (run eglinfo on Android terminal prompt to see the list of extensions supported).

What is not supported

 * Android Hardware Composer HAL functionality introduced in Icecream Sandwich is not supported in the current release.
 * Automatic SGX core version detection, and target side install are not supported due to the limited command set available on Android.

Additional Packages
Benchmarking packages for SGX functionalities and APIs are available at,


 * https://gforge.ti.com/gf/project/gleslayer/

Fixed in this Release

 * Unified Build system to support different platforms viz. AM 335x| AM/DM 37x on Icecream Sandwich.

Limitations/ Known Issues

 * Android Hardware Composer HAL functionality introduced in Icecream Sandwich is not supported.

Build and Installation

 * SDK Build Procedure:

1) Edit Rules.make file and set appropriate paths

2) Build SDK Using -     $ make OMAPES=X.x (see make help for more info)

4) Install the SDK into File system using:     $ sudo make OMAPES=X.x install

(This copies the *.so and *.ko to file system pointed to by TARGETFS_INSTALL_DIR variable).

Contents
The folders in the installed package contain binaries for several family of devices containing the SGX530/540 cores. Brief description of these folders is below.

{| ! ! Folder Name ! Description ! Used by ! style="background: #FFDDDD;"|1 ! style="background: #FFDDDD;"|1 ! style="background: #FFDDDD;"|1 ! style="background: #FFDDDD;"|3 }
 * + Graphics SDK folder contents
 * gfx_rel_es4.x_android
 * Release binaries for platforms having SGX-530 core revision 1.2.5
 * (AM335x) GSG:_AM35x_and_OMAP35x_Rebuilding_the_Software
 * gfx_rel_es5.x_android
 * Release binaries for platforms having SGX-530 core revision 1.2.5
 * (AM37xx/DM37xx) GSG:_AM35x_and_OMAP35x_Rebuilding_the_Software
 * gfx_rel_es6.x_android
 * Release binaries for platforms having SGX-530 core revision 1.2.5
 * (TI81xx) GSG:_AM35x_and_OMAP35x_Rebuilding_the_Software
 * TI_Android_Graphics_SDK
 * Source for Graphics Kernel Modules
 * Contains kernel dependent code, changes depending on Linux kernel used