From OMAPpedia

[edit] Introduction

This release has been developed and tested in the following environment.

OS Kernel: Linux® 2.6.29.
AndroidTM Donut public project.
Toolchain: CodeSourcery compiler version 2008q3-72.

[edit] Release Content

The release refers to the source code in git trees and the binary packages are distributed in different projects. The next section on how to build will help pull them into the correct directories to integrate the software system.

Documentation
OMAPpedia is an excellent source for details on the various components. There is a project listing in the main page on the various components.

Source code
Release Manifest for open code source. Release Tag - RLS25.14M.1_RC0

Other Binary packages

DSP Binary Package - DSP binaries Connectivity Package - Wilink project

[edit] Build and Installation Instructions

Building the Bootloader, Kernel and Android File System

The final Release RC tag from L25x manifest for the source should be used. Perform a clean build of u-boot, x-loader, kernel and the android file system. Instructions on how to build can also be obtained from Android Wiki

Pre-built binaries from this release can be obtained from RLS25.14M1 Package. Please follow the below instructions to modify the file system to make it work.

DSP binaries package

Pull in the DSP binaries and install them following the instructions in the readme.txt in the package. Features supported can be referred at OpenMAX page

IMPORTANT: To use Camera and Camcorder applications first you need to rename/move a couple of libraries to make them work. The libraries are in /system/lib:

• libOMX.TI.AMR.decode.so
• libOMX.TI.AMR.encode.so

Rename them to something else (e.g. libOMX.TI.AMR.decode.so.bak and libOMX.TI.AMR.encode.so.bak)

If you are booting from NAND then once you have booted your filesystem, on your terminal type the following:

mount -o remount rw /system
cd /system/lib
mv libOMX.TI.AMR.decode.so libOMX.TI.AMR.decode.so.bak
mv libOMX.TI.AMR.encode.so libOMX.TI.AMR.encode.so.bak

then reboot.

Connectivity package

Connectivity package can be obtained from Wilink package. For instructions to build and test, refer to Wilink wiki

[edit] New in this Release

• This release was validated using "donut" public branch
• This release is on 2.6.29 Kernel.
• PV open Core 2.03 and patches
• BSP
  • omap: SDMA: Fix omap_stop_dma() API for channel linking.
  • OMAP3: remove executable permissions on dma.c
  • omap_vout: Set maximum buffer size to 1280x720.
  • Refer to BSP release notes
• Bridge:
  • Fixed an issue during suspend/resume were dsp was causing a kernel panic due to a suspend timeout.
  • All the patches sent to open source were merged to L25x.
  • Refer to Bridge release notes
• Audio/System
  • ResourceManager bug fix to close open file handle when checking for dependencies.
  • ResourceManager supports run-time check of dsp dependencies as well as run-time check of supported OMAP version. If check fails RM will fall-back to "stub" mode
• Image/Video
  • All PPM changes patched on top of RLS25.14 are merged in this release.
  • Enabled Boost API to bump up OPP between capture and JPEG Encode time for image capture use case
  • Menu option provided to enable/disable generation and display of thumbnails during image capture
  • Thumbnail ON and OFF transition created an empty thumbnail record in SD card, this issue is fixed.
  • Refer to OMX release notes
• Bluetooth
  • Rebased the FM stack to M4 release from MCS.
  • AVRCP profile is enabled.
  • BT and FM features now supported with 2.6.29 kernel and donut file system with OMAP Serial driver with UART2 DMA enabled.
  • Audio streaming over A2DP (Media Service) to BT Stereo headset is supported.
  • Audio Streaming over HFP (Phone Audio Servive) to BT mono/stereo headset is supported. It is verified through the command line media player [alsa_aplay].
  • FM Radio [FM audio verified on zoom2 speaker and also on wired headset] is supported using TI command line application.
• Wi-Fi
  • Upgraded to WiLink M4 driver.
  • Improved connection process to AP.
  • Support for DVFS removed.
  • Resolving manual mode issue (DRT 210974)
  • Wake lock APIs added
  • Following WLAN features are supported (through UI and WLAN TI CLI Utility)
    • Scanning for AP's and listing the devices with SSID
    • Connecting to the available AP's
    • Web browsing
    • Roaming
    • Ad-hoc networking
    • QoS
    • Security (WEP40, WEP128, WPA, WPA2)
    • BT WLAN Coexistence
• PPM SmartReflex™
  • SmartReflex™ is an adaptive voltage scaling technology, in which the supply voltage can be adapted to the silicon performance either from the static sense (e.g. adapted to the manufacturing process of a given device) or the dynamic sense (e.g. adapted to the temperature induced current performance of the device). This allows dynamically adapting the VDD1 & VDD2 voltages to the silicon characteristics and temperature to minimize active power consumption. It can operate under manual or automatic mode to suit PM SW needs. Though it is recommended to run the system at specified voltage & frequency as per selected OPP, the optimal voltage for a given frequency varies with the manufacturing process of the device and temperature. Thus, the optimal voltage for a given frequency is different for every silicon chip based on its silicon characteristics (hot vs. cold samples) and current temperature.
    
    Note: SmartReflex™ does tuning around the recommended OPP voltage and never changes the OPP
    
    To enable/disable SmartReflexН for VDD1 & VDD2, use the following commands, respectively:
    # echo –n > /sys/power/sr_vdd1_autocomp
    The value can be
    0 – To disable
    1 – To enable
     
    # echo –n > /sys/power/sr_vdd2_autocomp
    The value can be
    0 – To disable
    1 – To enable
    

  ---

  
  

  [edit] Limitations/Known Issues

  IMPORTANT:

  • This is the latest release for Android on OMAP. Consider the previous RLS25.12 as the stable release.
  • Currently we support only MPEG4 video encoding. To test it open the camera (or camcorder) app. Once it is open, press . Select "Settings" from the menu. Once this menu loads, choose "Select Video Quality" and "Select Video Encoder" and set them to DVD-Video NTSC and MPEG4 respectively. See Test Execution Instructions

  
  Video Playback

  • Deblocking is temporarily disabled as it is causing stability issues.

  Camera

  • Burst mode capture of more than 4 pics fails randomly.
  • If you see Camera application is busy message press ‘Wait’ and everything will continue to work fine.

  Camcorder

  • If you see ‘Activity Camcorder is not responding’, press ‘Wait’ and everything will continue to work fine.

  Bluetooth

  • Display is not coming up, when BT chip in sleep and Android is in suspend, if we start pairing from remote device.

  Random white screen issue

  This is a known issue which happens due to change in GPIO pin muxing in beta and production boards. Reading the gpio_94 to determine production vs pilot units has shown not to be a reliable method. Now we will check the silicon version of the zoom2 unit based on the following:
  
  If Silicon rev is ES3.1 or greater => Zoom2 Production Units. If Silicon rev is ES3.0 or lesser => Zoom2 Pilot Units
  
  With this information we can determine the gpio value required for the lcd reset:
  
  Zoom2 Production Unit => LCD panel reset gpio = 96
  Zoom2 Pilot Unit => LCD panel reset gpio = 55
  
  Refer to the commit ID 571770a16d95a0eaae9740ee0c58246700b345c7 for a fix.

  [edit] Use Case Test Results

  Test Case ID	Test Case Name	Validation Criteria	Sample file	Test Result	Comments
  1	Boot from SD	Android boots from SD card	N/A	Pass	Android boots up and the Home screen is displayed on the LCD (no need of any DSP binary)
  2	Audio Playback - AAC	Play - Audio shall play without audible glitches.	A_000396_AAC_48kHz_128kbps_hint.mp4	Pass	Audio plays without audible glitches.
  3	A/V Playback - MPEG4	Audio can be mute, video can be distorted until play is resumed.	AV_000370_MPEG4_Visual_Simple_Profile_Level_5_D1NTSC_30fps_8Mbps_short_version_AAC_48Khz_128Kbps_stereo.3gp	Pass	Video is heard and rendered without distortion.
  4	A/V Playback - H264	Play - Shall play synchronized audio/video without audible/visible distortion.	AV_000523_H264_BL30_D1NTSC_30fps_4Mbps_AAC_48kHz_128kbps_stereo_4m30s.mp4	Pass	Video is heard and rendered without distortion.
  5	A/V Record - MPEG4	Shall record synchronized audio/video without audible/visible distortion. Digital zoom applies to viewfinding and capture.	NA	Pass	Need to rename libOMX.TI.AMR.encode.so and libOMX.TI.AMR.decode.so in /system/lib to make Camcorder use Android's audio encoder since there is no TI AMR encoder.
  6	Image Capture - JPEG	Image should be capture without any distortion.	NA	Pass	Image is displayed without distortion. NOTE: If you capture several pictures (4+ snapshots) Camera becomes unstable and preview sometimes freezes. You can switch to Camcorder and then go back to Camera to keep taking pictures but still will see instability after several captures. Use it at your own risk.
  7	Bluetooth	Pass if pairing is succesful.	NA	Pass	BT device is paired without issues.
  8	WLAN	File shall be downloaded and rendered successfully by the browser.	NA	Pass.	URL is downloaded and displayed correctly on browser.

  ---

  
  

  [edit] Robustness Test Results

  Test Case ID	Test Case Name	Validation Criteria	Sample file	Test Result	Comments
  1	Audio Playback - AAC	Play - Audio shall play each time without audible glitches and Music player application remains functional without hanging or crashing.	A_000396_AAC_48kHz_128kbps_hint.mp4	Pass	Audio plays without audible glitches.
  2	A/V Playback - MPEG4	Seek forward - Audio can be mute, video can be distorted until play is resumed. Gallery video player application should remain functional after four plays.	AV_000370_MPEG4_Visual_Simple_Profile_Level_5_D1NTSC_30fps_8Mbps_short_version_AAC_48Khz_128Kbps_stereo.3gp	Pass	Video is heard and rendered without distortion.
  3	A/V Playback - H264	Play - Shall play synchronized audio/video without audible/visible distortion. Gallery video player application should remain functional after four plays.	AV_000523_H264_BL30_D1NTSC_30fps_4Mbps_AAC_48kHz_128kbps_stereo_4m30s.mp4	Pass	Video is heard and rendered without distortion.
  4	Image Capture - JPEG	Images should be capture without any distortion. Camera application should remain functional after 4 snapshots.	NA	Pass.	Images are displayed without distortion. Sometimes after taking a few pictures you may see camera app freeze.
  5	A/V Record - MPEG4	Shall record synchronized audio/video without audible/visible distortion in four different clips.	NA	Pass	Need to rename libOMX.TI.AMR.encode.so and libOMX.TI.AMR.decode.so in /system/lib to make Camcorder use Android's audio encoder since there is no TI AMR encoder.

  ---

  [edit] Resources

  OMAPZoom.org and OMAPpedia.org may be good starting places.

  IRC Chat - #linux-omap
  Googlegroups - OmapZoom
  

  Mailing List - OMAPAndroid Discussion list