6AJ.1.2 Release Notes

= Introduction =

These Release Notes provide instructions for:  Testing the release using a pre-built binary image which can be loaded onto eMMC on EVM 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.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
 * Boot: USB peripheral boot, single stage bootloader, Boot optimizations (QSPI 4 pin mode and 48MHz QSPI clock), SD Card boot [13]
 * Ethernet: Dual eMAC and VLAN
 * USB: USB2.0 MTP Host(read only), USB Charging, USB Super Speed
 * Display: Dual display support (On board LCD + HDMI or FPD Link + HDMI) [10]
 * Audio: Audio Router API to Map audio session IDs to playback zones, Merge multiple audio streams to TDM slots in single McASP [4]
 * Video: IPU accelerated playback - 1080p60fps, VIP single instance [11]
 * Secure boot: Validated in this release on HS device and mshiled DK lite (available in CDDS Only). Customers needing access to Mshield DK lite should contact their TI representatives to get access
 * Power: ABB
 * WiLink8Q: WLAN - Wi-Fi/Wi-Fi Direct/SoftAP (R8.2 Version), BT - A2DP Sink, AVRCP, HFP (using Cybercomm stack) [5]
 * HDCP: HDCP 1.0 driver for receiver (connecting to a single HDMI display receiver as endpoint)
 * 2D: Bltsville API
 * DCAN: DCAN support added [9]

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:
 * USB: The USB1 port is set to work in gadget mode for ADB and USB2 port is set to operate in USB host mode (mouse, etc...)
 * Single stage boot: Bluetooth is not functional in this boot configuration
 * Misc: adb reboot command does not work occasionally

=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


 * Install Pre-requisite packages for building the Android File System

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


 * Install Java SE 6 JDK 

sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner" sudo apt-get update sudo apt-get install sun-java6-jdk


 * Proxy/Firewall

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

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 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.


 * 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.

Android Filesystem Sources
You can get the Android source for this release by doing: cd 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

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

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.
 * For other options refer to "Boot Options" Application note.
 * For more info on partitions and flashing refer to "QSPI NOR/eMMC partitions" Application note.

DIP Switch settings
Required DIP switch settings: This configuration corresponds to the following device boot order: SD &rArr; 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
 * Copy u-boot.img and MLO files to an SD card (boot partition) and then boot the target board from this external SD card. If you don't want to use SD card, refer to peripheral booting option
 * Connect a USB cable from the Linux PC to the USB3.0 port on board
 * Power on the board and stop the board at u-boot prompt by interrupting with key press
 * Put the board in fastboot mode by typing in fastboot command
 * On the Linux PC which has the emmc images run the fastboot.sh script to flash the binaries
 * NOTE: After the flashing is done, remove the external SD card and reboot the board.

=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...