5AI.1.10 Release Notes

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

OS Kernel: Linux® 3.1 Android:  Android IcecreamSandwich 4.0.4 MR1 Audio Back End (ABE):  09.51 Toolchain: CodeSourcery compiler version Sourcery G++ Lite 2010q1-202 for ARM GNU/Linux Reference hardware platforms: TI OMAP5 5430 SEVM ES1.0 HD (high secure device) Build Host OS: Ubuntu Daily Build OMAP5 SEVM Version: OMAP5_master build 163

=Tools & Dependency packages=

Pre-requisite packages for building the Android Filesystem (Note this is with reference to Ubuntu 10.04 64-bit). Ubuntu 64-bit is required by Ice Cream Sandwich.

If you are behind firewall, you will have to set-up firewall using the instructions in

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

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

Add the partner repositories and install the JDK:

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

Install latest repo tool:

mkdir ~/bin -p sudo apt-get install curl curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo chmod a+x ~/bin/repo export PATH=~/bin:$PATH

Command to get repo version:

repo init repo --version Should be repo version v1.7.8.2 or higer.

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 Sourcery G++ Lite 2010q1-202 for ARM GNU/Linux version.

This tool chain can be obtained from



=Downloading Release Software= Android Filesystem Sources

Note

''1: You should export a variable "https_proxy" when behind a firewall, since file system build downloads repo tree from Google server over https connection. You can use

the format mentioned

below'' export https_proxy=

''2: Ensure that you back up .repo folder into another location, otherwise it will take precedence on top of the one you will be creating below. Command below for

reference'' mv $HOME/.repo $HOME/.repo_old

You can get the Android source for this release by doing: cd mkdir -p 5AI.1.10 cd 5AI.1.10 export YOUR_PATH=`pwd` mkdir -p mydroid; cd mydroid export MYDROID=`pwd` repo init -u git://git.omapzoom.org/platform/omapmanifest.git -b 5AI.x -m RLS_5AI.1.10.xml repo sync

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.1 cd kernel/android-3.1 git checkout acd732ba5467d9d71f7dc159f0881d2ef1c9ed5f If you already have kernel source cloned then just update it: cd $YOUR_PATH/kernel/android-3.1 git fetch origin git checkout acd732ba5467d9d71f7dc159f0881d2ef1c9ed5f Patches:

git cherry-pick 197e0983a79582f07e8e84f252de1c8626822b4a - from p-android-omap-3.4, fixes a secure violation that may be seen on later MSHIELD versions

U-Boot Sources U-Boot is no longer needed or required for the eMMC boot image, only usbboot is required.

UsbBoot Sources cd ${YOUR_PATH} git clone git://git.omapzoom.org/repo/omapboot.git usbboot cd usbboot git checkout e62665a2155619e46acc66f573eedbe1b84b45ad

=Release Content=

This release has the below content - Kernel and Drivers tested with OMAP5 5430 sEVM 1.0 HD (high security device) and verified with Ice Cream Sandwich UI

=Build Instructions=

Setting up build environment
From your work directory (5AI.1.10 folder): export YOUR_PATH=`pwd` export PATH=$PATH:/arm-2010q1/bin export MYDROID=${YOUR_PATH}/mydroid mkdir $MYDROID/logs export CROSS_COMPILE=arm-none-linux-gnueabi-

Building usbboot
This is for creating the emmc boot

cd ${YOUR_PATH}/usbboot git clean -fdx export TOOLCHAIN=${MYDROID}/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi- make ARCH=omap5 BOARD=omap5evm clean make ARCH=omap5 BOARD=omap5evm

Note: alternatively can add CROSS_COMPILE into make command, it will need full path

Building Kernel
To create kernel uImage you need to add "mkimage" directory path to your "PATH" environment variable: cd ${YOUR_PATH}/kernel/android-3.1 make -j$(cat /proc/cpuinfo |grep ^proc|wc -l) ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- mrproper make -j$(cat /proc/cpuinfo |grep ^proc|wc -l) ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- android_omap5sevm_defconfig make -j$(cat /proc/cpuinfo |grep ^proc|wc -l) ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- uImage modules

Patch for fastboot script specific for OMAP5
The patch given below with changes to the fastboot script that works for OMAP5. These instructions assume you have downloaded the attached patch into ${MYDROID}.

cd ${MYDROID}/device/ti/omap5sevm/ git fetch http://review.omapzoom.org/p/device/ti/omap5sevm refs/changes/43/21543/2 && git cherry-pick FETCH_HEAD

Building Android Filesystem (AFS)
cd $MYDROID . build/envsetup.sh lunch 16 make -j $(egrep '^processor' /proc/cpuinfo | wc -l) clean make -j $(egrep '^processor' /proc/cpuinfo | wc -l)

Building SGX
The SGX package is based on the following internal repository:


 * The DDK version is 1.8@869593
 * repository - INTERNAL or pull from CDDS
 * commit ID - 93e8cd1a21e47bc6971c499ee9dd8ed27eec3c48

cd ${YOUR_PATH} tar zxf /SGX_5AI.1.10.tgz cd sgx_2012-05-04_15-11-34 export ANDROID_ROOT=${MYDROID} export KERNELDIR=${YOUR_PATH}/kernel/android-3.1 export DISCIMAGE=${PWD}/discimage if [ -d ${DISCIMAGE} ]; then rm -rf ${DISCIMAGE} fi mkdir ${DISCIMAGE} ./build_DDK.sh --build omap5 release clobber #(required for rebuild only) ./build_DDK.sh --build omap5 release fakeroot ./build_DDK.sh --install omap5 release

Building TI WLAN & Blueti Drivers
When building the wifi drivers and the new blue tooth blueti drivers you will also need to also have the CROSS_COMPILE also set as listed above in Setting up the Build Environment. For both the WLAN and BTFM components there is licensed firmware that needs to be downloaded from CDDS and the specific details are included in the

OPBU_Linux_5AI.1.10_Release_Notes document and should be used when adding the connectivity components.

Wifi Drivers export KERNEL_DIR=${YOUR_PATH}/kernel/android-3.1 export ARCH=arm export KLIB=${KERNEL_DIR} export KLIB_BUILD=${KERNEL_DIR} cd ${MYDROID}/hardware/ti/wlan/mac80211/compat/ make -j4 clean make -j4

Blueti Drivers export KERNEL_DIR=${YOUR_PATH}/kernel/android-3.1 export ARCH=arm export KLIB=${KERNEL_DIR} export KLIB_BUILD=${KERNEL_DIR} cd ${MYDROID}/hardware/ti/wpan/bluetooth-compat/ make -j4 clean make -j4

Building Ducati

 * RPMSG
 * Repository - INTERNAL
 * Commit Tag - 1.10.07.16-SMP1


 * Ducati MM
 * Repository - INTERNAL
 * Commit Tag - DUCATIMM-2.x.7.2

The Ducati MM package "Ducati_5AI.1.10.tgz" and the RPMSG package "RPMSG_5AI.1.10.tgz" will both need to be downloaded from CDDS.


 * Required Build Tools for Ducati packages:
 * Codec Engine
 * Framework Components
 * IPC
 * XDAIS
 * OSAL
 * SMPBIOS (SMPBIOS - replaced the BIOS)
 * XDC Tools
 * CG Tools

The tools need to be downloaded and installed in a common tools directory that would then be used during the build. A complete Tools package is available from CDDS at the following link: [https://cdds.ext.ti.com/ematrix/common/emxNavigator.jsp?objectId=28670.42872.10690.31676:

ICS_Ducati_Tools] There is some tool updates hat also need to be downloaded from CDDS and the tools package that is needed is Ducati_SMPBIOS_Update_Tools.tgz. A more detailed set of instructions for setting up the tools is available in the OPBU_Linux_5AI_1_10_Release_Notes document that can be downloaded from CDDS. This package will install the tools together in one specific directory called dsptools.

Setup
cd ${YOUR_PATH} tar zxf /Ducati_5AI.1.10.tgz

Build Steps for RPMSG
cd ${YOUR_PATH}/Ducati_2012-04-03_11-54-33/ export DUCATI=`pwd` git clone git://git.omapzoom.org/repo/sysbios-rpmsg.git rpmsg-1.10.04.12 cd rpmsg-1.10.04.12 git checkout 1.10.04.12 chmod +w Makefile export BIOSTOOLSROOT=${YOUR_PATH}/dsptools

Edit the Makefile - REPO - else echo - put the path to the dsptools. Example using sed command below: sed -i -e "s#/usr/local#${BIOSTOOLSROOT}#g" Makefile

export PATH=${PATH}:${BIOSTOOLSROOT}/cgtarm-4.9.0 export XDCPATH="${DUCATI}/rpmsg-1.10.04.12/src; /bios_6_32_01_38/packages" export TMS470CGTOOLPATH= export C6000CGTOOLPATH=

make clean make -j4

Build Steps for Ducati
More details on the Ducati build steps are given in the release document: OPBU_Linux_5AI_1_9_Release_Notes.doc available on CDDS. The paths below need to be defined and for each export commands are one line. Environment Settings: export BIOSTOOLSROOT=${YOUR_PATH}/dsptools (This assumes all the dsptools are loaded in this directory; so you can modify this if needed) export RPMSGSRC=${DUCATI}/rpmsg-1.10.04.12 export DUCATIMMSRC= export TMS470CGTOOLPATH=${YOUR_PATH}/dsptools/cgtarm-4.9.0 Specific Build Steps: cd ${DUCATI} make omap5_sevm_config make -j4

The ducati-m3.bin would be generated and then this binary will be copied into the Android File System as instructed below.

=Preparing Android binaries= Officially this release supports emmc boot. For the emmc the system image file must have the sgx and ducati binary included, the document OPBU_Linux_5AI.1.10_Release_Notes.doc contain details on other components that can also be added to the AFS as done for sgx and ducati. It is recommended to read the document before building your final image.

Rebuild Android Filesystem (AFS) to include the Wifi, Ducati & SGX binaries
Wifi & BT kernel modules: export BOARD_TYPE="omap5sevm" cd $MYDROID/out/target/product/$BOARD_TYPE mkdir -p system/lib/modules; cd system/lib/modules cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/compat/compat.ko. cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/net/wireless/cfg80211.ko. cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/net/mac80211/mac80211.ko. cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/drivers/net/wireless/ti/wl12xx/wl12xx.ko. cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/drivers/net/wireless/ti/wl18xx/wl18xx.ko. cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/drivers/net/wireless/ti/wl1251/wl1251.ko. cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat/drivers/net/wireless/ti/wlcore/wlcore*.ko. cp -fp ${MYDROID}/hardware/ti/wpan/bluetooth-compat/net/bluetooth/bnep/bnep.ko. cp -fp ${MYDROID}/hardware/ti/wpan/bluetooth-compat/net/bluetooth/rfcomm/rfcomm.ko. cp -fp ${MYDROID}/hardware/ti/wpan/bluetooth-compat/net/bluetooth/bluetooth.ko. cp -fp ${MYDROID}/hardware/ti/wpan/bluetooth-compat/net/bluetooth/hidp/hidp.ko. cp -fp ${MYDROID}/hardware/ti/wpan/bluetooth-compat/drivers/bluetooth/btwilink.ko.

cd $MYDROID . build/envsetup.sh lunch 16 cp -v ${YOUR_PATH}/kernel/android-3.1/arch/arm/boot/zImage device/ti/${BOARD_TYPE}/boot/zImage cp -v ${DUCATI}/ducati-m3.bin out/target/product/${BOARD_TYPE}/system/vendor/firmware/ cp -avf ${YOUR_PATH}/sgx_2012-05-04_15-11-34/discimage/system/vendor/* out/target/product/${BOARD_TYPE}/system/vendor/ cp -v ${YOUR_PATH}/sgx_2012-05-04_15-11-34/discimage/system/etc/* out/target/product/${BOARD_TYPE}/system/etc/ find out/target/product/${BOARD_TYPE} -name *.img -exec rm -f {} \; make -j $(egrep '^processor' /proc/cpuinfo | wc -l)

Preparing eMMC binaries/images
cd $YOUR_PATH mkdir emmc_files cp -v ${MYDROID}/out/target/product/omap5sevm/*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.1/arch/arm/boot/zImage emmc_files cp -v ${YOUR_PATH}/usbboot/out/omap5evm/MLO emmc_files/omap5evm_GP_ES1.0_MLO cp -v ${YOUR_PATH}/usbboot/out/omap5evm/usbboot emmc_files cp -v ${YOUR_PATH}/usbboot/out/omap5evm/iboot.ift emmc_files # for a GP device

${YOUR_PATH}/omap-mshield-lite/generate_ULO OMAP5430 ES1.0 ${YOUR_PATH}/usbboot/out/omap5evm/iboot.bin ${YOUR_PATH}/omap-mshield-lite/generate_MLO OMAP5430 ES1.0 ${YOUR_PATH}/usbboot/out/omap5evm/eboot.bin cp -v ${YOUR_PATH}/omap-mshield-lite/ULO emmc_files/iboot.ift cp -v ${YOUR_PATH}/omap-mshield-lite/MLO emmc_files/omap5evm_HS_ES1.0_MLO
 * 1) for HD devices (high security devices) sign the usbboot binaries with m-shield-lite
 * 1) for HD devices (high security devices) copy the following after signing with m-shield-lite

Flashing eMMC images
This is done using usbboot to put the OMAP5 board in fastboot mode with the steps given below:

Required dip switch settings on switch S6 to enable eMMC boot. (S6 on the back of the board) 3   2   1    0   ON ON ON ON

1. Connect your micro usb cable (USB3 cable can also be used) from the target to your flashing station, the power supply, & the 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 omap5 board.

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

SD Card Boot Information