6AJ.1.2 Release Notes

From OMAPpedia

Revision as of 12:40, 17 June 2014 by Vishalm (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

Introduction

These Release Notes provide instructions for:

  1. Testing the release using a pre-built binary image which can be loaded onto eMMC on EVM board
  2. and

  3. 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.8.13
Android: Android JellyBean 4.3
Toolchain: Andriod linux-x86 toolchain arm-eabi-4.7
Reference hardware platforms: TI DRA7xxx EVM (J6 EVM) - REV D boards and later with Poly Fixed Silicon [1]
WiLink hardware: wl18xxQ, PG 1.1
Build Host OS: Ubuntu
Daily Build J6 EVM Version: JACINTO6_JB_MR2_DB build 66 + u-boot patch


Release Features

On top of previous release, following new features are enabled


NOTE: OPP_HIGH(1.5 GHz) is enabled in this release. if you don't have a poly fixed silicon, make sure to pick up an extra patch in kernel to disable OPP_HIGH.

Refer to "Poly Fix Silicon Identification" for finding out if you have poly fixed silicon or not.


Release Limitations

In this release:


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 images" section.
NOTE: Downloading binary now requires my.ti.com login


Rebuilding Android from Sources

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

The information below on initializing build environment for Android, is taken from official Android page here

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
sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
sudo apt-get update
sudo apt-get install sun-java6-jdk

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=<local_site_proxy_server> eg: http://local.proxyserver.com:80
mkdir ~/bin -p
sudo apt-get install curl
curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
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.

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.


Downloading Release Software

Android Filesystem Sources

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

cd <your work directory>
mkdir -p 6AJ.1.2
cd 6AJ.1.2
export YOUR_PATH=$PWD
mkdir -p mydroid; cd mydroid
export MYDROID=$PWD
repo init -u git://git.omapzoom.org/platform/omapmanifest.git -b 6AJ.x -m RLS_6AJ.1.2.xml
repo sync

TI Hardware Accelerated Graphics and MultiMedia Binaries

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

U-Boot Sources

cd ${YOUR_PATH}
git clone git://git.omapzoom.org/repo/u-boot.git
cd u-boot
git checkout 9aaed55f1b8815254ff3977249b7e0857911ae04
git fetch http://review.omapzoom.org/repo/u-boot refs/changes/87/34287/1 && git cherry-pick FETCH_HEAD

Usbboot Sources

cd ${YOUR_PATH}
git clone git://git.omapzoom.org/repo/omapboot.git
cd omapboot
git checkout 6ebde14205520687c9a67b95430bc1c86d84cb92

Kernel & Driver Sources

cd ${YOUR_PATH}
mkdir kernel
git clone git://git.omapzoom.org/kernel/omap.git kernel/android-3.8
cd kernel/android-3.8
git checkout 3f970b61a2ba7276ea122f1254240db020f94b21

Step to get additional patch to disable OPP_HIGH. Needed only if you don't have a poly fixed silicon[1]

 git fetch http://review.omapzoom.org/kernel/omap refs/changes/49/33449/1 && git cherry-pick FETCH_HEAD


Build Instructions

Setting up build environment

From your work directory (6AJ.1.2 folder):

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

Building U-boot sources

Instructions for building x-loader and bootloader

cd ${YOUR_PATH}/u-boot
export CROSS_COMPILE=${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.7/bin/arm-eabi-
export ARCH=arm
make distclean
make dra7xx_evm_android

Building usbboot tool

Instructions for building usbboot host PC binary

cd ${YOUR_PATH}/omapboot
export CROSS_COMPILE=${MYDROID}/prebuilts/gcc/linux-x86/arm/arm-eabi-4.7/bin/arm-eabi-
cd host/tools
make

Building Kernel

Instructions for building kernel and device tree

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

Note: If you are making changes to kernel defconfig and need to rebuild SGX kernel module, refer here

Building Android Filesystem (AFS)

Instructions for building Android file system

cd $MYDROID
. build/envsetup.sh
lunch full_jacinto6evm-userdebug
make -j2 clean
make -j2

Building WiLink WLAN Driver

Instructions for building TI WiLink (Wl18xx) WLAN driver

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


Preparing Android Image

Rebuild Android Filesystem (AFS) to include kernel and WLAN driver

Copy Kernel Image (This step is for making your kernel to be part of boot.img)

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

Copy WLAN Driver (This step is for making wlan driver modules to be part of system.img)

cd $OUT/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/wl18xx/wl18xx.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/drivers/net/wireless/ti/wlcore/wlcore.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/drivers/net/wireless/ti/wlcore/wlcore_sdio.ko .

Rebuild AFS to generate update images

cd $MYDROID
. build/envsetup.sh
lunch full_jacinto6evm-userdebug
rm out/target/product/jacinto6evm/*.img
rm out/target/product/jacinto6evm/obj/PACKAGING/systemimage_intermediates/system.img
make -j2

Preparing eMMC binaries/images

cd $YOUR_PATH
mkdir emmc_files
cp -v ${MYDROID}/out/target/product/jacinto6evm/*img emmc_files
cp -v ${MYDROID}/out/target/product/jacinto6evm/dra7-ipu1-fw.xem4 emmc_files
cp -v ${MYDROID}/device/ti/jacinto6evm/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.8/arch/arm/boot/zImage emmc_files/kernel
cp -v ${YOUR_PATH}/kernel/android-3.8/arch/arm/boot/dts/dra7-evm.dtb emmc_files
cp -v ${YOUR_PATH}/u-boot/MLO emmc_files/GP_MLO
cp -v ${YOUR_PATH}/u-boot/MLO emmc_files/
cp -v ${YOUR_PATH}/u-boot/u-boot.img emmc_files
cp -v ${YOUR_PATH}/u-boot/spl/u-boot-spl.bin emmc_files
cp -v ${YOUR_PATH}/omapboot/host/tools/usbboot-stand-alone emmc_files


Flashing eMMC images

The default setup is to flash MLO and u-boot.img to QSPI and remaining binaries (kernel, dtb file and AFS) to emmc.

DIP Switch settings

Required DIP switch settings: This configuration corresponds to the following device boot order: SD ⇒ QSPI_1

SYSBOOT [0-15]
OFF ON ON OFF OFF OFF OFF OFF    ON OFF OFF OFF OFF OFF OFF OFF ON

USERCONFIG [SW5]
OFF OFF ON OFF ON ON ON OFF OFF OFF

Flashing procedure

Hit any key to stop autoboot:  3
DRA752 EVM # fastboot
 cd $YOUR_PATH/emmc_files
 sudo ./fastboot.sh


Application notes/Additional Info

6AJ.1.2_Application_Notes

Refer to Application notes page for more info on features of this release, additional boot options, etc...

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox