Panda5AJ.1.5 Release Notes

From OMAPpedia

Jump to: navigation, search

NOTE: Release content updated on 6th May 2013

1 Introduction
2 Using the Prebuilt Release Image
3 Rebuilding Android from Sources
4 Flashing eMMC images
5 Post release fixes/patches/features

[edit] Introduction

These Release Notes provide instructions for:

Testing the release using a pre-built binary image which can be loaded onto eMMC on uEVM board

and

Rebuilding the Android binary image from the Android sources

Both sets of instructions make use of binary components to enable hardware acceleration for Graphics and Multimedia.

This software release has been developed and verified in the following software and hardware environment.

OS Kernel: Linux® 3.4
Android: Android JellyBean 4.2.2
Toolchain: Andriod linux-x86 toolchain arm-eabi-4.6
Reference hardware platforms: TI OMAP5 5432 uEVM ES2.0 (Panda5)
Build Host OS: Ubuntu
Daily Build OMAP5 uEVM Version: OMAP5_JB_panda5_mr1 build 59

NOTE: This release is not backward compatible with OMAP5432 ES1.0 silicon

uEVMs built with ES1.0 Silicon are labeled UEVM5432x-00-yy-zz

uEVMs built with ES2.0 Silicon are labeled UEVM5432x-02-yy-zz

[edit] Using the Prebuilt Release Image

The prebuilt release image can be obtained from here.
After you download the binaries, follow the flashing instruction from "Flashing eMMC image" section.

[edit] Rebuilding Android from Sources

[edit] Build PC setup

You would need a 64bit machine for building Android file system. You must have sudo permissions on the PC for installing packages

Install Pre-requisite packages for building the Android File System

The following commands will install the correct packages to your PC:

Ubuntu 10.04

sudo apt-get install git-core flex bison gperf libesd0-dev zip libwxgtk2.6-dev zlib1g-dev build-essential tofrodos x-dev 
sudo apt-get install lib32readline5-dev libstdc++6 lib32z1 lib32z1-dev ia32-libs g++-multilib libx11-dev libncurses5-dev 
sudo apt-get install uboot-mkimage libxml2-utils

Ubuntu 12.04

sudo apt-get install git-core flex bison gperf libesd0-dev zip libwxgtk2.8-dev zlib1g-dev build-essential tofrodos 
sudo apt-get install lib32readline6-dev libstdc++6 lib32z1 lib32z1-dev ia32-libs g++-multilib libx11-dev libncurses5-dev 
sudo apt-get install uboot-mkimage libxml2-utils

For more up to date information on initializing build environment for Android, refer to official Android page here

Install Java SE 6 JDK from Oracle

http://www.oracle.com/technetwork/java/javase/downloads/index.html

Proxy/Firewall

If you are behind proxy/firewall, workaround it using the instructions in [1]

For installing repo make sure you also export https_proxy environment variable.

export https_proxy= eg: http://local.proxyserver.com:80

Install latest repo tool

mkdir ~/bin -p
sudo apt-get install curl
curl 
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

If you do not have sudo rights to your machine, contact your System Administrator for assistance.

Tool Chain for building Kernel and Drivers

The Kernel and Driver sources are built using the Android linux-x86 toolchain for ARM GNU/Linux version. This tool chain can be obtained when you pull the Android code based on the released manifest that will be given.

[edit] Downloading Release Software

[edit] Android Filesystem Sources

You can get the Android source for this release by doing:

cd 
mkdir -p 5AJ.1.5
cd 5AJ.1.5
export YOUR_PATH=$PWD
mkdir -p mydroid; cd mydroid
export MYDROID=`pwd`
repo init -u git://git.omapzoom.org/platform/omapmanifest.git -b 5AJ.x -m RLS_panda5AJ.1.5.xml
repo sync

[edit] TI Hardware Accelerated Graphics and Multimedia Binaries

Multimedia (ducati) and accelerated graphics binaries are part of Android file system build now

[edit] UsbBoot Sources

cd ${YOUR_PATH}
git clone git://git.omapzoom.org/repo/omapboot.git usbboot
cd usbboot
git checkout 33af7cb409b603cf7988306ab2ea70f052a9a02b

[edit] Kernel & Driver Sources

To clone kernel source from scratch do:

cd ${YOUR_PATH}
mkdir kernel
git clone git://git.omapzoom.org/kernel/omap.git kernel/android-3.4
cd kernel/android-3.4
git checkout 499e8d5a5aa8a271bf9c4ae404ad234b7fb22b9f

[edit] Build Instructions

[edit] Setting up build environment

From your work directory (5AJ.1.5 folder):

export YOUR_PATH=$PWD
export MYDROID=${YOUR_PATH}/mydroid
export PATH=$PATH:${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.6/bin/
export CROSS_COMPILE=${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.6/bin/arm-eabi-

[edit] Building usbboot

This is for creating the emmc boot

cd ${YOUR_PATH}/usbboot
export CROSS_COMPILE=${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.6/bin/arm-eabi-
make MACH=omap5 BOARD=omap5uevm clean
make MACH=omap5 BOARD=omap5uevm

[edit] Building Kernel

Follow the steps below to build kernel image.

cd ${YOUR_PATH}/kernel/android-3.4
export CROSS_COMPILE=${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.6/bin/arm-eabi-
make ARCH=arm mrproper
make ARCH=arm android_omap_defconfig
make ARCH=arm uImage modules

[edit] Building Android Filesystem (AFS)

cd $MYDROID
. build/envsetup.sh
lunch 25  #(specific lunch target: full_omap5panda-userdebug)
make -j2 clean
make -j2

[edit] Building TI WLAN Drivers

WLAN connection will work only on uEVM with PG2.1 wl8 chip.

OMAP5 Panda boards with model number uEVM5432x-02-01-00 and uEVM5432x-02-11-00 both have the WL1857 ES2.1 on them

export CROSS_COMPILE=${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.6/bin/arm-eabi-
export KERNEL_DIR=${YOUR_PATH}/kernel/android-3.4
export KLIB=${KERNEL_DIR}
export KLIB_BUILD=${KERNEL_DIR}
cd ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/
make ARCH=arm

[edit] Preparing Android image

[edit] Rebuild Android Filesystem (AFS) to include kernel and connectivity drivers

Copy WLAN kernel modules:

cd $MYDROID/out/target/product/panda5
mkdir -p system/lib/modules; cd system/lib/modules
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/compat/compat.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/net/wireless/cfg80211.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/net/mac80211/mac80211.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/drivers/net/wireless/ti/wl12xx/wl12xx.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/drivers/net/wireless/ti/wl18xx/wl18xx.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/drivers/net/wireless/ti/wlcore/wlcore*.ko .

Copy Kernel Image

cd $MYDROID
cp -v ${YOUR_PATH}/kernel/android-3.4/arch/arm/boot/zImage device/ti/panda5/kernel

Rebuild AFS to generate update images

cd $MYDROID
. build/envsetup.sh
lunch 25  #(specific lunch target: full_omap5panda-userdebug)
rm out/target/product/panda5/*img
rm out/target/product/panda5/obj/PACKAGING/systemimage_intermediates/system.img
make -j2

[edit] Preparing eMMC binaries/images

cd $YOUR_PATH
mkdir emmc_files
cp -v ${MYDROID}/out/target/product/panda5/*img emmc_files
cp -v ${MYDROID}/device/ti/omap5sevm/boot/fastboot.sh emmc_files
cp -v ${MYDROID}/out/host/linux-x86/bin/{simg2img,make_ext4fs,mkbootimg,fastboot,adb} emmc_files
cp -v ${YOUR_PATH}/kernel/android-3.4/arch/arm/boot/zImage emmc_files/kernel
cp -v ${YOUR_PATH}/usbboot/out/omap5uevm/omap5uevm_GP_ES2.0_MLO emmc_files
cp -v ${YOUR_PATH}/usbboot/out/omap5uevm/usbboot emmc_files

[edit] Flashing eMMC images

This is done using usbboot and fastboot tool. usbboot is used to put the OMAP5 uEVM board in fastboot mode and fastboot is used to flash the images to emmc.

Follow the steps below to flash the binaries to emmc of the board:

(Refer here for DIP switch location)

Required switch settings on the Panda5 board to enable eMMC boot.
    3   2   1   0
   OFF OFF OFF OFF

1. Connect your USB3 cable from the target to your flashing station, the power supply, 
& the micro usb cable using a terminal or screen 
(for screen the command is: screen /dev/ttyUSB0 115200)

2. Make sure the board is powered OFF

3. Start usbbboot in fastboot mode:

      sudo ./usbboot -f
         When running this command you will see: 
         usbboot -f:  starting in fastboot mode
         waiting for device...

4. Power up your board

     From the terminal you should see something similar to this saying the device is in fastboot mode: 
            r1Texas Instruments Inc Bootloader 1.1.0-jenkins-OMAP5_usbboot-102^0
            Build Info: Apr 20 2012 - 05:01:26
            Entering fastboot mode...
 
   From the command prompt where you ran the usbboot command you should see something similar to this below:
    reading ASIC ID
    CHIP: 5430
    IDEN: cfd7d499ed40beab470795a5cfbc5707807b4b6a
    MPKH: 351edf8f4d739d50f7449a6d3d3d983d6220974836f039c752dae7226bb19955
    CRC0: 06e92275
    CRC1: 3894aaf5
    device is ED/HD (EMU/HS)
    sending 2ndstage to target... f0030002
    waiting for 2ndstage response...
    received 2ndstage response...

5. Run your fastboot.sh script
     sudo ./fastboot.sh
       This will flash the binaries into the emmc on the Panda board.

6. Now reset the board and let it boot up.

[edit] Post release fixes/patches/features

Details on patches for work done after the release.

[edit] Appendix A: Enabling 2D Blitter / GC320 (Optional)

To enable 2D Blitter (GC320) on this release, apply the following patches and rebuild kernel and AFS.

Kernel Patch,

cd ${YOUR_PATH}/kernel/android-3.4
git fetch http://review.omapzoom.org/kernel/omap refs/changes/51/32851/1 && git cherry-pick FETCH_HEAD

Userspace Patches,

cd $MYDROID/hardware/ti/omap4xxx
git fetch http://review.omapzoom.org/platform/hardware/ti/omap4xxx refs/changes/53/32853/1 && git cherry-pick FETCH_HEAD
cd $MYDROID/device/ti/panda5
git fetch http://review.omapzoom.org/device/ti/panda5 refs/changes/52/32852/1 && git cherry-pick FETCH_HEAD

[edit] Appendix B: Allow EMIF to idle and CORE to hit Retention

To enable CORE PD to hit CSWR, apply the following patches and rebuild the kernel and MLO

MLO Patch

 cd ${YOUR_PATH}/usbboot
 git fetch http://review.omapzoom.org/repo/omapboot refs/changes/17/32917/1 && git cherry-pick FETCH_HEAD

Kernel Patches

 cd ${YOUR_PATH}/kernel/android-3.4
 git fetch http://review.omapzoom.org/kernel/omap refs/changes/18/32918/1 && git cherry-pick FETCH_HEAD
 git fetch http://review.omapzoom.org/kernel/omap refs/changes/19/32919/1 && git cherry-pick FETCH_HEAD
 git fetch http://review.omapzoom.org/kernel/omap refs/changes/20/32920/1 && git cherry-pick FETCH_HEAD

[edit] Appendix C: Enabling Wi-Fi Display sink feature

To enable Wi-Fi display sink feature on this release, apply the following userspace patches and rebuild the Android File System

 cd $MYDROID/device/ti/panda5
 git fetch http://review.omapzoom.org/device/ti/panda5 refs/changes/78/33078/2 && git cherry-pick FETCH_HEAD
 cd $MYDROID/frameworks/av
 git fetch http://review.omapzoom.org/platform/frameworks/av refs/changes/85/33085/1 && git cherry-pick FETCH_HEAD
 cd $MYDROID/device/ti/common-open
 git fetch http://review.omapzoom.org/device/ti/common-open refs/changes/86/33086/1 && git cherry-pick FETCH_HEAD

Retrieved from "http://omapedia.org/wiki/Panda5AJ.1.5_Release_Notes"