Panda5AJ.1.3 Release Notes
From OMAPpedia
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.1
Toolchain: Andriod linux-x86 toolchain arm-eabi-4.4.3
Reference hardware platforms: TI OMAP5 5432 uEVM ES1.0 (Panda5)
Build Host OS: Ubuntu
Daily Build OMAP5 uEVM Version: OMAP5_JB_panda5_master_ build 100
NOTE: This release is not forward compatible with OMAP5432 ES2.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] 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:
cdmkdir -p 5AJ.1.3 cd 5AJ.1.3 export YOUR_PATH=`pwd` mkdir -p mydroid; cd mydroid export MYDROID=`pwd` #Use http instead of https in git git config --global url."http://".insteadOf https:// repo init -u git://git.omapzoom.org/platform/omapmanifest.git -b 5AJ.x -m RLS_5AJ.1.3.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 ba84518df1c32908b1188a73bf015d69e2f321e1
If you already have kernel source cloned then just update it:
cd $YOUR_PATH/kernel/android-3.4 git fetch origin git checkout ba84518df1c32908b1188a73bf015d69e2f321e1
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 71f4037a947416a6d40b5cae28180d65512d701c
[edit] Release Content
This release has the below content - Kernel and Drivers tested with OMAP5 5432 uEVM 1.0 GP and verified with Jelly Bean UI
[edit] Build Instructions
[edit] Setting up build environment
From your work directory (5AJ.1.3 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
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=omap5uevm clean make MACH=omap5 BOARD=omap5uevm CROSS_COMPILE=${HOME}/.jenkins/workspace/OMAP5_AFS/prebuilt/linux-x86/toolchain/arm-eabi-4.4.3/bin/arm-eabi-
[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_omap_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 17 #(specific lunch target: full_omap5panda-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 addition the OMAPLFB package is also needed in this release and is on an internal repository but the package is available on CDDS also:
- The DDK version is 1.9@2166536 (tag: 1.9IMG2166536_TI.0003)
- repository - need to pull from CDDS
- commit ID - 084d3dbdab598dfdf1d2497a3fded3b833284fa9
cd ${YOUR_PATH} tar zxf/SGX_5AJ.1.3.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 17 #(specific lunch target: full_omap5panda-userdebug) 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_panda5AJ_1_2_Release_Notes.doc available on CDDS.
- RPMSG
- Repository - git://git.omapzoom.org/repo/sysbios-rpmsg.git
- Commit - 7a48f16fccf3519d568ea37ba4461274b738864f
- Commit Tag - 2.00.10.30
- Ducati MM
- Repository - INTERNAL
- Commit Tag - TI-MM-DUCATI_RLS_2.x.15.2
The Ducati MM package "Ducati_5AJ.1.3.tgz" will need to be downloaded from CDDS.
- Required Build Tools for Ducati packages:
- Codec Engine
- Framework Components
- IPC
- XDAIS
- OSAL
- SMPBIOS
- 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. There is a tool package that contains most of the tools
required: 5AJ.1.3_Ducati_Tools.tgz.
Refer to the more detailed set of instructions the tools which is available in the OPBU_Linux_panda5AJ_1_2_Release_Notes.doc that can be downloaded from CDDS.
[edit] Setup
cd ${YOUR_PATH} tar zxf/Ducati_5AJ.1.3.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 BIOSVERSION=bios_6_34_01_14 IPCVERSION=ipc_1_24_03_32 XDCVERSION=xdctools_3_24_02_30
[edit] Build Steps for Ducati
More details on the Ducati build steps are given in the release document: OPBU_Linux_panda5AJ_1_2_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_panda5AJ_1_2_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="panda5" 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 17 cp -v ${YOUR_PATH}/kernel/android-3.4/arch/arm/boot/zImage device/ti/${BOARD_TYPE}/kernel 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/${BOARD_TYPE}/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/panda5/*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/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/MLO emmc_files/omap5uevm_GP_ES1.0_MLO cp -v ${YOUR_PATH}/usbboot/out/omap5uevm/usbboot emmc_files cp -v ${YOUR_PATH}/usbboot/out/omap5uevm/iboot.ift emmc_files # for a GP device
[edit] Flashing eMMC images
This is done using usbboot to put the PANDA5 board (OMAP5) in fastboot mode with the steps given below:
Required switch settings on the Panda5 board to enable eMMC boot. (S6 on the back of the board) 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.
SD Card Boot Information