L25.INC3.4P3 Community Release Notes
From OMAPpedia
m (→Build and Installation Instructions) |
m (→Build and Installation Instructions) |
||
| Line 102: | Line 102: | ||
'''Connectivity package ''' | '''Connectivity package ''' | ||
| - | Connectivity package can be obtained from [https://gforge.ti.com/gf/ | + | Connectivity package can be obtained from [https://gforge.ti.com/gf/project/wilink_drivers/frs/?action=FrsReleaseBrowse&frs_package_id=184 Wilink package]. For instructions to build and test, refer to [http://omappedia.org/wiki/WiLink_Connectivity_Project Wilink wiki] |
'''Graphics package ''' | '''Graphics package ''' | ||
Revision as of 20:03, 14 December 2010
Contents |
Introduction
This release has been developed and tested in the following environment.
OS Kernel: Linux® 2.6.32. AndroidTM Froyo 2.2.1 public project. Toolchain: Android Froyo Toolchain : arm-eabi-4.4.0 (Using GCC4.4.0). Manifest: 25.INC3.4P3_Manifest. U-boot Version: fbe4cef852de5a39412234b4acd47a830d0282a2. X-loader version: eb8b047c29a2027fbdd841cd1289fa27ddb22d72. Kernel version: 0d27f8409fd277b66d46e16ffadb0ec9bf26eb8a.
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.
You may also go and check the following:
Refer to BSP release notes at
https://gforge.ti.com/gf/project/omapandroid/docman/?subdir=11
Refer to Bridge release notes at
https://gforge.ti.com/gf/project/omapandroid/docman/?subdir=17
Power Management materials PM is enabled by default in the kernel, but for enabling any of the features we need to use some sysfs entries from user space:
http://omappedia.org/wiki/Linux_OMAP_Kernel_Main http://elinux.org/OMAP_Power_Management
Refer to OMX release notes at https://gforge.ti.com/gf/project/omapandroid/docman/?subdir=22
Source code
Release Manifest for open code source. Release Tag - RLS25.INC3.4P3DB237rc0
Follow these instructions in order to download RLS25.INC3.4P3DB237rc0 manifest:
mkdir RLS25.INC3.4P3DB237rc0 cd RLS25.INC3.4P3DB237rc0 repo init -u git://git.omapzoom.org/platform/omapmanifest.git -b eclair cd .repo/manifests git reset --hard RLS25.INC3.4P3DB237rc0 cd ../.. repo sync
Kernel cloning/building
git clone git://git.omapzoom.org/kernel/omap.git cd omap/ git checkout --track -b p-android-omap-2.6.32 origin/p-android-omap-2.6.32 git checkout -b L25.I3.4P3 android-2.6.32-2.2-Inc3-4P3 make ARCH=arm CROSS_COMPILE=arm-eabi- android_zoom3_defconfig make ARCH=arm CROSS_COMPILE=arm-eabi- uImage
U-Boot cloning/building
git clone git://git.omapzoom.org/repo/u-boot.git cd u-boot/ git checkout -b L25.I3.4P3 fbe4cef852de5a39412234b4acd47a830d0282a2 make ARCH=arm CROSS_COMPILE=arm-eabi- omap3630zoom3_config make ARCH=arm CROSS_COMPILE=arm-eabi-
X-Loader cloning/building
git clone git://git.omapzoom.org/repo/x-loader.git cd x-loader/ git checkout -b L25.I3.4P3 eb8b047c29a2027fbdd841cd1289fa27ddb22d72 make ARCH=arm CROSS_COMPILE=arm-eabi- omap3630zoom3_config make ARCH=arm CROSS_COMPILE=arm-eabi- ift
Other Binary packages
DSP Binary Package - project
Connectivity Package - project
Graphics Package - Please refer to Build/Install instructions on details
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 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: 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). By default, AMR libraries have been already renamed in available pre-compiled binaries RLS25.INC2.5 Package.
If you are booting from NAND then once you have booted your filesystem, on your terminal type the following:
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
Graphics package
To access the graphics package - following steps are required
- Send an email to 'gamingonomap@list.ti.com' requesting access to the OMAP – Mobile Gaming extranet
- You will get an e-mail as a response to your request. Follow instructions in the e-mail to register at TI extranet site
- Go to OMAP Gaming website - https://www-a.ti.com/extranet/cm/product/wtbugaming/wtbuext/general/homepage.shtml and log in with your newly created credentials
- Download the file named: OMAP36xx_Android_SGX_SDK_zoom3_20100506.zip referred as OpenGL®ES Graphics Android SDK for OMAP3630 Zoom3 Development platform Supports OpenGLES v1.1 OpenGLES 2.0 and OpenVG 1.1 on the web-page. Please note you will need to accept the licensing terms before downloading the package.
- Copy to Linux PC, after unzipping the package you should get Linux installer with the file name OMAP36xx_Android_SGX_SDK_zoom3-1.5.15.2766.bin
- You may need to give execute permission with below command $ chmod +x OMAP36xx_Android_SGX_SDK_zoom3-1.5.15.2766.bin
- Now run this installer $ ./OMAP36xx_Android_SGX_SDK_zoom3-1.5.15.2766.bin
- Read the license terms and accept them to install the graphics SDK on to your system. After successful installation you will get a directory with name OMAP36xx_GFX_Android_SDK in a given path. Refer the readme.txt file in this package for using the SDK.
NO Zoom2 (OMAP 3430) support for this L25.INC3.4P3 Release
Bootargs
nand unlock nand ecc hw setenv bootargs console=androidboot.console=ttyO3 console=ttyO3,115200n8 root=/dev/mmcblk0p2 rw rootdelay=1 init=/init omap_vout_mod.video1_numbuffers=6 omap_vout_mod.vid1_static_vrfb_alloc=y omapfb.vram=0:4M setenv bootcmd 'mmcinit 0; fatload mmc 0 0x81c00000 uImage_L25.INC3.4P3_CCD_Zoom3; bootm 0x81c00000' saveenv boot
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_000433_eAACplus_stereo_48000Hz_48kbps.m4a | Pass | Audio plays without audible glitches. | |
| 3 | A/V Playback - MPEG4 | Play - Shall play synchronized audio/video without audible/visible distortion. | MPEG4_QVGA_320x240_ASP_L3_30fps_1_5Mbps_AAC_48kHz_128kbps_stereo.MP4 | Pass | Video is heard and rendered without distortion. | |
| 4 | A/V Playback - H264 | Play - Shall play synchronized audio/video without audible/visible distortion. | AV_000343_h264_Baseline_Profile_level_1_3_CIF_30fps_768Kbps_AAC_48khz_128kbps_stereo.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 viewfinder 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. You can switch to Camcorder and then go back to Camera to keep taking pictures. | |
| 7 | Bluetooth | Pass if pairing is succesful. | NA | Pass | BT device is paired without issues. | |
| 8 | FM | FM station should be listened properly. | N/A. | Pass. | FM station listened correctly. | |
| 9 | Bluetooth File Transfer | Sent and received file should be uncurrupted. | N/A. | Pass. | Files sent and received OK. | |
| 10 | WLAN | File shall be downloaded and rendered successfully by the browser. | NA | Pass. | URL is downloaded and displayed correctly on browser. | |
| 11 | GFX SDK OGLES2HelloTriangle | GFX should be displayed properly. | NA | Pass. | GFX displayed OK. |
Resources
OMAPZoom.org and OMAPpedia.org may be good starting places.
IRC Chat - #linux-omap
Googlegroups - OmapZoom
Mailing List - OMAPAndroid Discussion list
Related Links
[lcd tv]