TI-Android-FroYo-DevKit-V2.2 ReleaseNotes

TI Android FroYo DevKit V2.2 Release Notes

Release Notes - January 31, 2011

Introduction

This is TI's Devkit V2.2 release based on Android FroYo 2.2 for AM35x EVM, AM37x EVM, DM37x EVM, OMAP35x EVM, Beagleboard Rev Cx, Beagleboard XM platforms.

This release serves to provide

• Fundamental software platform to build Android based products with TI devices.
• Give Android application developer a stable integrated foundation software.
• Provide benchmark numbers to evaluate Android based solutions with other distributions on TI devices
• A single release package that comprises of all TI components (bootloader, kernel, Tools), TI differentiators (like 3D graphics based on SGX, Overlay libraries, Adobe Flash 10, multimedia DSP acceleration) and Android standard components.

Component	Version	Base Repository	Base Tag (or commit id)
OMAP Linux Kernel	2.6.32(Android Linux kernel version)	The baseline was chosen from "PSP" release from http://arago-project.org/git/projects/linux-omap3.git	OMAPPSP_03.00.01.06_baseline
U-Boot	2010.06.rc2	http://arago-project.org/git/projects/u-boot-omap3.git	PSP 04.00.00.09
Android	FroYo 2.2	http://gitorious.org/rowboat	TI-Android-FroYo-DevKit-V2.2.xml (without multimedia DSP acceleration), TI-Android-FroYo-DSP-DevKit-V2.2.xml (with multimedia DSP acceleration)

The filesystem was built by integrating the sources from arowboat.org project hosted on arowboat gitorious Project using TI-Android-FroYo-DevKit-V2.2.xml manifest file.
The codebase for Linux kernel, SGX kernel drivers, U-Boot included in this release is also hosted at the following repositories:

Component	Repository (Branch)	Commit ID / Baseline
Bootloader	http://gitorious.org/rowboat/u-boot-omap3	PSP 04.00.00.09
OMAP Linux Kernel	http://gitorious.org/rowboat/kernel (rowboat-eclair-2.6.32)	b263debb4bd3565f4550bd27cf4bb78ae44ef8c3
SGX Release	http://git.gitorious.org/rowboat/ti_android_sgx_sdk.git	b263debb4bd3565f4550bd27cf4bb78ae44ef8c3
Adobe Flash 10	http://focus.ti.com/docs/toolsw/folders/print/adobeflash-a8.html	v10.1.r105
TI DVSDK (for DM3730 only)	http://software-dl.ti.com/dsps/dsps_public_sw/sdo_sb/targetcontent/dvsdk/DVSDK_4_00/latest/index_FDS.html	4.01.00.09

For detailed information on the various software components included in the release and how to use them, please refer to the
http://processors.wiki.ti.com/index.php/TI-Android-FroYo-DevKit-V2.2_UserGuide.

The Android sources, SGX drivers, DSP software stack for DM3730, Kernel and U-Boot have been compiled with GNU Toolchain for ARM Processors from Android pre-built package
http://gitorious.org/rowboat/prebuilt/trees/rowboat-froyo/linux-x86/toolchain/arm-eabi-4.4.0

Documentation

• User guide

Provides instructions on how to use the TI's Android FroYo DevKit package. A copy of the User Guide is included in the docs folder of the DevKit package. The User Guide also gives instructions on building the Android root filesystem using Android sources maintained on rowboat repositories.
Location  : http://processors.wiki.ti.com/index.php/TI-Android-FroYo-DevKit-V2.2_UserGuide

• Performance guide

Gives the benchmark numbers for various parameters and peripherals
Location  : http://processors.wiki.ti.com/index.php/Android_Benchmarks_DevKit2.2

• Porting guide

Provides information on porting packages like WLAN/BT, Camera, PowerManagement, NAND UBIFS for other platforms,
Location  : http://processors.wiki.ti.com/index.php/TI-Android-DevKit-PortingGuide-V2.2

What's Supported

This SDK package includes support for the OMAP35x EVM, AM35x EVM, AM37x EVM, DM37x EVM, Beagleboard Rev Cx, Beagleboard XM.

Software features/components supported in this DevKit are

• Android FroYo 2.2 release from Google Android
• Android Linux Kernel 2.6.32 integrated with PSP (03.00.01.06) drivers
• Bootloader (u-boot) and x-loader
• SGX Open GL Driver & Libraries
• TI DVSDK 4.01 for DM3730
• Adobe Flash 10 (upon approval)
• WLAN and Bluetooth Firmware and Drivers for TI's WL1271
• Example Applications and Demos
  • Desk Clock, Browser, Calendar, Calculator, Contacts, Gallery, GlobalSearch, Launcher, Music, Settings
  • 3D Graphics - OpenGLES demos.
• Documentation
  • User Guide
  • Release Notes
  • CTS report
  • RowboPERF (Performance measurement) application user guide
  • Software Manifest files
• Host Tools
  • NAND Flashing Tool
  • Pin Mux Utility
  • SignGP
• Android Debugging
  • ADB Debugging over USB, Ethernet and Ethernet over USB
  • Connecting Eclipse (as provided by Android) with the EVMs, Beagleboards
• Test and Performance Reports
  • Performance, benchmarking results
  • Test results from our validation

Complete directory structure of DevKit

  TI_Android_FroYo_DevKit-V2.2
      |-- Android_Source_Manifest
      |   `-- TI-Android-FroYo-DevKit-V2.2.0.0.xml
      |   `-- TI-Android-FroYo-DSP-DevKit-V2.2.xml
      |-- Documents
      |   |-- RowboPERF_User_Guide.pdf
      |   |-- Software_Manifests
      |   |-- Test_Performance_Results
      |   `-- TI-Android-FroYo-DevKit-V2.2UserGuide.pdf
      |-- OMAP35x_Android_SGX_SDK.tar.gz
      |-- Performance_Apps
      |   |-- 0xbench
      |   |-- 3D
      |   |-- Launcher2
      |   |-- rowboatBench
      |   |-- RowboPERF
      |   `-- StorageIO
      |-- Prebuilt_Images
      |   |-- AM35X
      |   |-- AM37X
      |   |-- beagleboard-rev-c4
      |   |-- beagleboard-xm
      |   |-- OMAP35X
      |   |-- DM37X
      |-- Sources
      |   |-- Android_Linux_Kernel_2_6_32.tar.gz
      |   |-- u-boot.tar.gz
      |   `-- x-loader-03.00.02.07.tar.gz
      |-- Tools
      |   |-- android-sdk_r06-linux_86.tgz
      |   |-- flash-utility.tar.gz
      |   |-- mk-bootscr
      |   |-- mk-mmc
      |   |-- pinmux-utility.tar.gz
      |   |-- signGP
      |-- Wireless
          |-- WL1271Android-patches.tar.gz

New in this Release

• The following items are newly added in this release:
  • Power Management
  • WLAN (WL1271) on AM37x EVM
  • Bluetooth connectivity for OPP, A2DP profiles on AM37x EVM
  • Camera Image capture on Beagle XM
  • Fastboot
  • NAND UBIFS booting
  • UI and video on S-video
  • Hardware accelerated dynamic rotation for Video pipeline.
  • Multimedia DSP acceleration on DM37x EVM and OMAP35x EVM
    • Support 720P MPEG4 ASP and H.264 MP/HP video decoding on DM37x EVM (1GHz)
    • Support D1 MPEG4 SP and H.264 BP video decoding on OMAP35x EVM

• The following features from previous release are provided:
  • Adobe Flash 10
  • USB Mass Storage
  • Audio Record feature in Android
  • Performance measurements using RowboPERF, 0xbench and rowboatbench
  • Media clips for Audio, Video and JPEG
  • Keypad support on AM35x EVM

What's Not Supported

• The following items are not supported:
  • AM/DM37x Processor card with Micron Memory
  • H.263 video decoding with DSP acceleration
  • Stagefright framework with DSP acceleration
  • Media Flash content with Flash 10 Plugin while DSP acceleration enabled

Installation and Usage

The DevKit release is maintained as a single "TI_Android_FroYo_DevKit-V2.2.tar.gz" at http://software-dl.ti.com/dsps/dsps_public_sw/sdo_tii/TI_Android_DevKit/02_02_00/index_FDS.html and individual component packages.

On a Linux Host PC download the single release package and execute the following components

    #> tar -xzvf TI_Android_FroYo_DevKit-V2.2.tar.gz

Please refer to the TI Android FroYo DevKit User Guidefor more information on how to install and use the DevKit

Other individual packages can be used to refer to respective components.

The md5 checksums are provided for users to double check or verify the completeness of downloaded package.

Device Support

This release supports the following Texas Instruments devices

• OMAP35x, AM35x, AM37x, DM37x

This release supports the following platforms

• Texas Instruments AM37x EVM (on the Mistral Rev G AM3715EVM)
• Texas Instruments DM37x EVM (on the Mistral Rev G DM3730EVM)
• Texas Instruments AM35x EVM
• Texas Instruments OMAP35x EVM (on the Mistral Rev G OMAP35x)
• Beagleboard Rev Cx
• Beagleboard XM

Known Issues

Component	Issue Description	Workaround	Comments
Hardware	USB EHCI Host port doesn't work on few AM37x EVMs	NONE	No fix available currently, suggestion is to try the same with Beagleboard XM or use TI USB PHY
Software	Pinmux Utility: could not resize the GUI, so could not see what the other button on the bottom right corner is.	User may need to adjust the display resolution of their Windows PC	To be fixed in future releases
Software	Pinmux Utility: could not resize the GUI, so could not see what the other button on the bottom right corner is. Pinmux utility requires Left-click to select a peripheral interface cell. The cell should be auto selected when user right-click it.	No impact to functionality. Just a note on the user interface.	To be fixed in future releases
Software	AM35x EVM platform booting doesn't continue after below shown messages AudioPolicyService not published, waiting...	This happens if the Filesystem was not unmounted properly. Look for the process ID in the console messages. Kill the process with "kill" command. This will not appear again.
Software	ARM performance data is not shown sometimes when RowboPERF runs ARM bechmarks	The CPU tests in Rowboat Bench will generate ARM benchmarks, this can be used for same purpose
Software	Netperf Ethernet performance is low when using a buffer size of 8192	No workaround	Other buffer sizes give better performance, see the performance results sheet for this release
Software	System does not obtain IP address automatically after booting	Use netcfg <eth0> dhcp on the console.	See user guide for more details
Software	Graphics Screen resolution is changed after suspend/resume sequence	No workaround	This is only with one of the demo app, this will not affect UI. The other 3D tests in RowboPerf work good.
Software	SUSPEND power consumption is too high (~85mw)	No workaround	To be done
Software	It takes too long for the system to go into SUSPEND mode after sleep/stand-by button is pressed	No workaround	To be done
Software	Acquiring different WakeLocks doesn't change power consumption	No workaround	To be done
Software	Sometimes the WLAN driver fails to load during boot	No workaround	Not observed consistently
Hardware	Video display is not clear when displayed over s-video Not observed on LCD TVs	No workaround	Not consistent on all TVs
Tool	Flashing NAND using flash utility v1.3 doesn’t work over UART	USB can be used with same utility to flash the NAND
Software	Spurious irq messages are shown on the console while sending data over WLAN	No workaround	Not observed consistently
Software	"Four Dalvik VM unit tests failed during testing failed: 057-iteration-performance failed: 062-character-encodings failed: 063-process-manager failed: 071-dexfile	No workaround	To be done
N/A	system boot-up takes too long, UI is less responsive, or video playback is sluggish	use the SD cards listed in the "SD Card Recommendations" section in the User Guide
Software	Random kernel crash on DM37xx with part of the Oops message "PC is at move_freepages_block+..."	change the memory hole config in bootargs 'mem=71M@0x80000000' to 'mem=68M@0x80000000'	The start of the memory hole has to be aligned at the 4MB boundary

Version

This is Release TI Android FroYo DevKit-V2.2 The release is available from http://software-dl.ti.com/dsps/dsps_public_sw/sdo_tii/TI_Android_DevKit/02_02_00/index_FDS.html

Technical Support and Product Updates

For further information or to report any problems, contact http://e2e.ti.com/android or http://support.ti.com.
For community support join http://groups.google.com/group/rowboat
For IRC #rowboat on irc.freenode.net
To raise any defect for this release please use http://code.google.com/p/rowboat/issues/list