ConfigureAndBuild
Configure and BuildPrepare your host environment Hardware Software Configure your network Checkout sources Build rowboat Build kernel Build rootfs Install the Android Graphics SGX SDK on Host Machine Execute the installer Accept the License Agreement Select the source install location Edit Rules.make to configure the SGX source build Build the Kernel Module sources Install the drivers in Target filesystem Populate the root filesystem Prepare SD card Configure target board Beagleboard and IGEPv2 OMAP3_EVM External Display First start
To work with Beagleboard or OMAP3EVM you will need the following:
Board Host machine (Linux Ubuntu 8.x/9.04) with Ethernet card and serial port Serial cable (null-modem) Power supply (5V) USB Hub USB Ethernet adapter (for Beagleboard) USB Keyboard & Mouse Ethernet cross cable or Ethernet Switch/Hub+2 cables Card Reader 2Gb SD or MMC Card 4:3 or 16:9 capable Display with DVI input HDMI to DVI cable (for BeagleBoard or IGEPv2) DVI to DVI (if you want to use external Display on OMAP3EVM)
As Google we recommend to use Ubuntu 8.04+ , but also you can use CentOS 5.3 (32 bit).
Install DHCP server Install tftp server (actual for OMAP3EVM) Install repo tool Set up your Linux development environment, make sure you have the following:Required packages:
Git 1.5.4 or newer and the GNU Privacy Guard. JDK 5.0, update 12 or higher. Java 6 is not supported, because of incompatibilities with @Override. flex, bison, gperf, libsdl-dev, libesd0-dev, libwxgtk2.6-dev (optional), build-essential, zip, curl, minicom, tftp-server, uboot-mkimage
For Ubuntu 32-bit use such command:
$ sudo apt-get install git-core gnupg sun-java5-jdk flex bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev minicom tftpd uboot-mkimageUbuntu Intrepid (8.10) users may need a newer version of libreadline:
$ sudo apt-get install lib32readline5-devFor DSP users:
$ sudo apt-get install expect/etc/xinet.d/tftpd:
service tftp { protocol = udp port = 69 socket_type = dgram wait = yes user = nobody server = /usr/sbin/in.tftpd server_args = /tftpboot disable = no }Where ManifestName is:
rowboat-donut.xml - for donut version of rowboat rowboat-donut-dsp.xml - for donut version of rowboat with DSP support rowboat-eclair.xml - for eclair version of rowboat rowboat-eclair-dsp.xml - for eclair version of rowboat with DSP support rowboat-froyo.xml - for froyo version of rowboat
For froyo and eclair version of rowboat you may build kernel, filesystem, dvsdk (in case of dsp version) and install sgx drivers using the command below. After this step you may skip "Build kernel", "Build rootfs", "Install the Android Graphics SGX SDK on Host Machine", "Install the drivers in Target filesystem" sections and go to "Populate the root filesystem".
$ make TARGET_PRODUCT=(beagleboard|omap3evm|igepv2|am3517evm) [TARGET_BUILD_VARIANT=tests] [-j8] [OMAPES=(2.x|3.x|5.x)]Your must specify your board with TARGET_PRODUCT variable. To build tests TARGET_BUILD_VARIANT may be used (see "Build rootfs" section for more info). It is recommended to use more than one thread on multi core systems, specify -j number_of_threads for this. Set OMAPES variable to install proper version of SGX driver (Default is 3.x):
For OMAP3530 ES 1or2 = 2.x For OMAP3530 ES3.0 = 3.x For AM3517 = 3.x For AM37x = 5.xOnce make is finished, you can find kernel uImage in kernel/arch/arm/boot/ directory.
While building rowboat-eclair-dsp, this (Build kernel) and next (Build rootfs) steps are not needed. Please refer to the instructions in wiki DSP stack integration to build Eclair with DSP integrated.
The next step is building Linux kernel for your board. (If dvsdk target is specified while building rootfs, kernel is already built.) In following listing the first step is settings up prebuilt toolchains, the third step is kernel configuring and here you need to use right config file for your board
omap3_evm_android_defconfig is for OMAP3EVM omap3_beagle_android_defconfig is for Beagleboard igep0020_android_defconfig is for IGEPv2 am3517_evm_android_defconfig is for AM3517 EVM
The fourth step in listing is kernel build command, here we tell make utility what build is for ARM architecture using cross-toolchains for ARM, the build target is uImage and it’s multithread build (-j8):
$ cd <sources top> $ export PATH=${PWD}/prebuilt/linux-x86/toolchain/arm-eabi-4.4.0/bin:$PATH $ cd kernel/ $ make ARCH=arm omap3_evm_android_defconfig $ make ARCH=arm CROSS_COMPILE=arm-eabi- uImage -j8 $ cd ..The next step is Android file system build. To build file system you need to specify for which board you want to build. Use variable TARGET_PRODUCT for this:
beagleboard omap3evm igepv2 am3517evm
Also if you need some unit tests for further use TARGET_BUILD_VARIANT=tests. If you are using multicore CPU in your host it’s possible to use more than one core for building Android for this pass -j8 (or 16, it depends on cores/CPUs) parameter to make command.
In following listing we build Android for OMAP3EVM board with unit test packages and use 8 threads to speed up build process:
$ make TARGET_PRODUCT=omap3evm TARGET_BUILD_VARIANT=tests -j8 droidAfter build process finished you'll need rootfs for this do following:
$ cd out/target/product/omap3evm $ mkdir android_rootfs $ cp -r root/* android_rootfs $ cp -r system android_rootfs NOTE: IF YOU WANT TO INSTALL THE OPENGL SGX (3D Hardware accelerator) DRIVERS INTO FILESYSTEM THEN SKIP THE BELOW STEP AND CONTINUE WITH THE Android Graphics Installation procedure below. $ sudo ../../../../build/tools/mktarball.sh ../../../host/linux-x86/bin/fs_get_stats android_rootfs . rootfs rootfs.tar.bz2The procedure to install Android graphics SDK sources are mentioned below, you should have downloaded the sources as directed in Get source code wiki
Will result in following instruction, press "Y"
This will install TI OMAP35x/AM37x Android Graphics SDK on your computer. Continue? [n/Y] YKindly read the complete License agreement by pressing Space bar and agree when prompted by pressing "Y"
OMAP3530 / OMAP3515 / AM3517 / AM3715 / DM3730 Android Linux Graphics SDK Software License Agreement IMPORTANT - PLEASE READ THE FOLLOWING LICENSE AGREEMENT CAREFULLY. THIS IS A LEGALLY BINDING AGREEMENT. AFTER YOU READ THIS LICENSE AGREEMENT, YOU WILL BE ASKED WHETHER YOU ACCEPT AND AGREE TO THE TERMS OF THIS LICENSE AGREEMENT. DO NOT CLICK "I HAVE READ AND AGREE" UNLESS: (1) YOU ARE AUTHORIZED TO ACCEPT AND AGREE TO THE TERMS OF THIS LICENSE AGREEMENT ON BEHALF OF YOURSELF AND YOUR COMPANY; AND (2) YOU INTEND TO ENTER INTO AND TO BE BOUND BY THE TERMS OF THIS LEGALLY BINDING AGREEMENT ON BEHALF OF YOURSELF AND YOUR COMPANY. Important - Read carefully: This OMAP3530 / OMAP3515 / AM3517 / AM3715 / DM3730 Graphics Software License Agreement ("Agreement") is a legal agreement between you (either an individual or entity) and Texas Instruments Incorporated ("TI"). The "Licensed Materials" subject to this Agreement include the software programs (in whole or in part) set forth in Exhibit 1, which is attached hereto and incorporated herein by this reference, that accompany this Agreement and that TI has granted you access to download and any "on-line" or electronic documentation (in whole or in part) associated with these programs, as well as any updates or upgrades to such software programs and documentation, if any, provided to you at -- Press space to continue or 'q' to quit --Keep Pressing Space Bar on Keyboard until see
======================== END OF LICENSE AGREEMENT ======================== Do you agree to the licensing terms [n/Y] YShould see following directory structure
root@android-pc:~/OMAP35x_Android_Graphics_SDK_3_01_00_03# ls ANDROID_RN_3_01_00_03.pdf GFX_Linux_SDK gfx_rel_es5.x_android Makefile.KM.Android ANDROID_RN_3_01_00_03.txt gfx_rel_es2.x_android initrc.patch Rules.make GFX_Linux_KM gfx_rel_es3.x_android Makefile uninstallExample:
HOME=/home/user GRAPHICS_INSTALL_DIR=$(HOME)/OMAP35x_Android_Graphics_SDK_3_01_00_03 ANDROID_ROOT=$(HOME)/rowboat-android/out/target/product/omap3evm/android_rootfs CSTOOL_DIR=$(HOME)/rowboat-android/prebuilt/linux-x86/toolchain/arm-eabi-4.4.0/ KERNEL_INSTALL_DIR=$(HOME)/rowboat-android/kernelExecute the make command in the sources directory
root@android-pc:~/OMAP35x_Android_Graphics_SDK_3_01_00_03# makeWill display:
copying the sgx kernel modules to appropriate folder...Install the SGX drivers in the root filesystem built
Do a make to identify the processor option.
root@android-pc:~/OMAP35x_Android_Graphics_SDK_3_01_00_03# make help_km Usage (for build): make Usage (for install): make install OMAPES={2.x | 3.x | 5.x} See online Graphics Getting Started Guide for further details.Select the OMAP3 device you work with
For OMAP3530 ES 1or2 = 2.x For OMAP3530 ES3.0 = 3.x For AM3517 = 3.x For AM37x = 5.xExecute the following to install the libraries and drivers into the target filesystem. Example for OMAP3530 ES 3.0:
root@android-pc:~/OMAP35x_Android_Graphics_SDK_3_01_00_03# make install OMAPES=3.xWill display
Installation complete!Edit init.rc to auto-start SGX service while android starts.
$ vim out/target/product/omap3evm/android_rootfs/init.rcJust above the comment
# adbd is controlled by the persist.service.adb.enable system propertyAdd below two lines
# Start PowerVR SGX DDK service pvr /system/bin/sgx/rc.pvr startFollow the steps below to populate the Android File system.
$ sudo ../../../../build/tools/mktarball.sh ../../../host/linux-x86/bin/fs_get_stats android_rootfs . rootfs rootfs.tar.bz2The rootfs.tar.bz2 is the android filesystem, it can be put on a SD/MMC Card or used our NFS.
To boot Android from SD/MMC card you must have it partitioned like following:
$ sudo fdisk /dev/<your sdcard,for example sdd> Command (m for help): p Disk /dev/sdd: 1977 MB, 1977614336 bytes 64 heads, 63 sectors/track, 957 cylinders Units = cylinders of 4032 * 512 = 2064384 bytes Disk identifier: 0x00000000 Device Boot Start End Blocks Id System /dev/sdd1 * 1 30 60448+ b W95 FAT32 /dev/sdd2 31 957 1868832 83 LinuxFormat the partitions for use the commands:
$ sudo mkfs.msdos /dev/sdd1 $ sudo mkfs.ext3 /dev/sdd2Use the kernel image (e.g. uImage) from the build process above and place in on the W95 FAT32 partition:
$ sudo mkdir -p /mnt/fat32 $ sudo mount /dev/sdd1 /mnt/fat32 $ sudo cp kernel/arch/arm/boot/uImage /mnt/fat32Unpack the Android tarball above onto the EXT3 partition:
$ sudo mkdir -p /mnt/ext3 $ sudo mount /dev/sdd2 /mnt/ext3 $ sudo tar jxfv out/target/product/<board>/rootfs.tar.bz2 --numeric-owner -C /mnt/ext3And the final step:
$ sync $ sudo umount /mnt/fat32; sudo umount /mnt/ext3There is one important requirement:
for OMAP3EVM U-Boot should be 2008.10 (Jun 16 2009-18:54:50) for BeagleBoard and IGEPv2 U-Boot should be 2009.08
This is example. Adjust to your network parameters if needed
OMAP3_EVM# setenv bootcmd 'tftp; bootm' OMAP3_EVM# setenv baudrate 115200 OMAP3_EVM# setenv bootargs 'mem=128M console=tty0 console=ttyS0,115200n8 androidboot.console=ttyS0 root=/dev/mmcblk0p2 rw init=/init rootwait' OMAP3_EVM# setenv ipaddr 10.10.10.3 OMAP3_EVM# setenv netmask 255.255.255.0 OMAP3_EVM# setenv serverip 10.10.10.1 OMAP3_EVM# setenv ethaddr 00:50:c2:XX:XX:XX OMAP3_EVM# setenv bootfile 'evm/uImage' <-- full path on host is /tftpboot/evm/uImage OMAP3_EVM# saveenv OMAP3_EVM# resetIf you need external display you need to enable additional kernel parameters:
omap-dss.def_disp=dvi - this specifies to use DVI output instead on-board screen omapfb.video_mode=720x480MR-16@60 - this specifies the resolution for external displayHere 720x480MR-16@60 is example value which means:
resolution - 720x480 M - always present R - reduced blinking 16 - 16 bits = 65,536 colours @60 - 60 HzFor more detailed info see modedb Documentation
So full bootargs string with example values will be following:
OMAP3_EVM# setenv bootargs "mem=128M console=tty0 console=ttyS0,115200n8 androidboot.console=ttyS0 root=/dev/mmcblk0p2 rw init=/init rootwait omap-dss.def_disp=dvi omapfb.video_mode=720x480MR-16@60"Remember what if you are using external display on-board display is off, but touch surface still functional.
Start the target board and wait until Android installing all prebuilt applications (default and custom) and configuring default settings. There is no indication for this time so you just need to wait until Android fully launched. After this you need to reboot the board.