5AJ.1.4 Release Notes

From OMAPpedia

Jump to: navigation, search

Contents

[edit] Introduction

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

OS Kernel: Linux® 3.4
Android: Android JellyBean 4.1.2
Toolchain: Andriod linux-x86 toolchain arm-eabi-4.4.3
Reference hardware platforms: TI OMAP5 5430 SEVM ES1.0 HS (high secure device)
Build Host OS: Ubuntu
Daily Build OMAP5 SEVM Version: OMAP5_JB_mr0_master build 33

[edit] 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 Jelly Bean.

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


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 
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

Command to get repo version:

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

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 5AJ.1.4
cd 5AJ.1.4
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_5AJ.1.4.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.4
cd kernel/android-3.4
git checkout 7e0a924355a1dd7666c0421564b2739b255ab55f

If you already have kernel source cloned then just update it:

cd $YOUR_PATH/kernel/android-3.4
git fetch origin
git checkout 7e0a924355a1dd7666c0421564b2739b255ab55f


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 8448095e49b274a5c8bd0da5645b6564455ee488

[edit] Release Content

This release has the below content - Kernel and Drivers tested with OMAP5 5430 sEVM 1.0 HS (high security device) and verified with Jelly Bean UI

[edit] Build Instructions

[edit] Setting up build environment

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

export YOUR_PATH=`pwd`
export MYDROID=${YOUR_PATH}/mydroid
export PATH=$PATH:${MYDROID}/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/
mkdir $MYDROID/logs
export CROSS_COMPILE=${MYDROID}/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi-


[edit] Building usbboot

This is for creating the emmc boot For the high security devices you will need to have mshield-lite available to sign the bootloader that will be built with usbboot, with the latest version of usbboot the signing

of the bootloader is required to be done when running the build step for the usbboot component.

cd ${YOUR_PATH}/usbboot
git clean -fdx
export TOOLCHAIN=${MYDROID}/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi-
make MACH=omap5 BOARD=omap5evm clean
#Run this make command for an HS board.
make CROSS_COMPILE=${HOME}/.jenkins/workspace/OMAP5_AFS/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi- MACH=omap5 BOARD=omap5evm MSHIELD=${YOUR_PATH}/omap-mshield-lite
#if you have a GP board run the following command (not using the MSHIELD option)
make CROSS_COMPILE=${HOME}/.jenkins/workspace/OMAP5_AFS/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi- MACH=omap5 BOARD=omap5evm

[edit] Building Kernel

To create kernel uImage you need to add "mkimage" directory path to your "PATH" environment variable:

cd ${YOUR_PATH}/kernel/android-3.4
make -j$(cat /proc/cpuinfo |grep ^proc|wc -l) ARCH=arm CROSS_COMPILE=arm-eabi- mrproper
make -j$(cat /proc/cpuinfo |grep ^proc|wc -l) ARCH=arm CROSS_COMPILE=arm-eabi- android_omap5_es1_defconfig
make -j$(cat /proc/cpuinfo |grep ^proc|wc -l) ARCH=arm CROSS_COMPILE=arm-eabi- uImage modules

[edit] Building Android Filesystem (AFS)

cd $MYDROID
. build/envsetup.sh
lunch 15  #(specific lunch target: full_omap5sevm-userdebug)
make -j $(egrep '^processor' /proc/cpuinfo | wc -l) clean
make -j $(egrep '^processor' /proc/cpuinfo | wc -l)

[edit] Building SGX

It is recommended to open a new command terminal when building the sgx components.
The SGX package is based on an internal repository and so the package needs to be pulled from CDDS: In the Android Build system the binary package for sgx is available and will be installed automatically during the Android build. So it is not required to rebuild sgx but the

build steps have been included for if there is a case or change needed with the graphics binaries.

cd ${YOUR_PATH}
tar zxf /SGX_5AJ.1.4.tgz
cd sgx
export ANDROID_ROOT=${MYDROID}
export KERNELDIR=${YOUR_PATH}/kernel/android-3.4
export CROSS_COMPILE=${MYDROID}/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi-
export DISCIMAGE=${PWD}/discimage
if [ -d ${DISCIMAGE} ]; then
  rm -rf ${DISCIMAGE}
fi
mkdir ${DISCIMAGE}
cd ${ANDROID_ROOT}
. build/envsetup.sh
lunch 15
cd ${YOUR_PATH}/sgx
./build_DDK.sh -g 544 --build release clobber  #(required for rebuild only)
./build_DDK.sh -g 544 --build release

Final step for Graphics Build:

cd ${YOUR_PATH}/sgx
fakeroot ./build_DDK.sh -g 544 --install release

[edit] 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.

Wifi Drivers

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

Blueti Drivers

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


[edit] Building Ducati

It is recommended for the Ducati & RPMSG builds steps to review the release document: OPBU_Linux_5AJ_1_2_Release_Notes.doc available on CDDS.

The Ducati MM package "Ducati_5AJ.1.4.tgz" will need to be downloaded from CDDS.

The tools need to be downloaded and installed in a common tools directory that would then be used during the build. There are tool updates from the 5AJ.1.3 release.
Refer to the more detailed set of instructions the tools which is available in the OPBU_Linux_5AJ_1_4_Release_Notes that can be downloaded from CDDS.

[edit] Setup

cd ${YOUR_PATH}
tar zxf /Ducati_5AJ.1.4.tgz

[edit] Build Steps for RPMSG

cd ${YOUR_PATH}/ducati/
export DUCATI=`pwd`
git clone git://git.omapzoom.org/repo/sysbios-rpmsg.git rpmsg
cd rpmsg
git checkout 7a48f16fccf3519d568ea37ba4461274b738864f
chmod +w Makefile
  export BIOSTOOLSROOT=${YOUR_PATH}/dsptools
  export PATH=${PATH}:${BIOSTOOLSROOT}/cgtarm-5.0.1
  export TMS470CGTOOLPATH=
  export C6000CGTOOLPATH=

  make smp_config
  make -j

[edit] Build Steps for Ducati

More details on the Ducati build steps are given in the release document: OPBU_Linux_5AJ_1_4_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
    export DUCATIMMSRC=
    export TMS470CGTOOLPATH=${YOUR_PATH}/dsptools/cgtarm-5.0.1 

Specific Build Steps:

cd ${DUCATI}
  make unconfig
  make omap5_sevm_L_smp_config  #This configuration determines the camera module the ducati image will be for - this is the 8 MPix camera that is default.
  export JOBS=4                              # the "make omap5_sevm_smp_config" configures the build for the 14MPix camera.
  make 

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

[edit] 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_5AJ.1.4_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.

[edit] Rebuild Android Filesystem (AFS) to include the Wifi, Ducati & SGX binaries

Wifi & BT kernel modules:

export KERNEL=${YOUR_PATH}/kernel/android-3.4
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_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/wl1251/wl1251.ko .
cp -fp ${MYDROID}/hardware/ti/wlan/mac80211/compat_wl18xx/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 15
cp -v ${YOUR_PATH}/kernel/android-3.4/arch/arm/boot/zImage device/ti/${BOARD_TYPE}/boot/zImage
cp -v ${DUCATI}/ducati-m3-core0.xem3 out/target/product/${BOARD_TYPE}/system/vendor/firmware/
cp -avf ${YOUR_PATH}/sgx/discimage/system/etc/powervr.ini out/target/product/panda5/system/etc/
cp -avf ${YOUR_PATH}/sgx/discimage/system/vendor/* out/target/product/${BOARD_TYPE}/system/vendor/
cp -avf ${YOUR_PATH}/sgx/discimage/system/lib/modules/* out/target/product/${BOARD_TYPE}/system/lib/modules/
for i in $(ls out/target/product/omap5sevm/*img); do rm -vf $i; done
make -j $(egrep '^processor' /proc/cpuinfo | wc -l)

[edit] 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.4/arch/arm/boot/zImage emmc_files
cp -v ${YOUR_PATH}/usbboot/out/omap5evm/omap5evm_GP_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/omap5evm_HS_MLO emmc_files/omap5evm_HS_ES1.0_MLO   # for a HS device


[edit] 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

Personal tools
Namespaces
Variants
Views
  • Read
  • Edit
  • View history
Actions
Navigation
Toolbox
  • What links here
  • Related changes
  • Special pages
  • Printable version