Questions

June 2012 

TM 

Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, 

ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, mobileGT, PowerQUICC, 

Processor Expert, QorIQ, Qorivva, StarCore, Symphony and VortiQa are trademarks of 

Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. Airfast, BeeKit, BeeStack, 

CoreNet, Flexis, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, 

Ready Play, SafeAssure, the SafeAssure logo, SMARTMOS, TurboLink, Vybrid and 

Xtrinsic are trademarks of Freescale Semiconductor, Inc. All other product or service 

names are the property of their respective owners. © 2012 Freescale Semiconductor, Inc. 

.

• System Overview 

• User Guide Process 

• Building and Loading Images 

• Developing an Android Application 

• Tools and Debug 

• Q&A 

TM 

2 

Freescale, the Freescale logo, AltiVec, C-5, CodeTEST, CodeWarrior, ColdFire, ColdFire+, C-Ware, the Energy Efficient Solutions logo, Kinetis, 

mobileGT, PowerQUICC, Processor Expert, QorIQ, Qorivva, StarCore, Symphony and VortiQa are trademarks of Freescale Semiconductor, Inc., 

Reg. U.S. Pat. & Tm. Off. Airfast, BeeKit, BeeStack, CoreNet, Flexis, MagniV, MXC, Platform in a Package, QorIQ Qonverge, QUICC Engine, 

Ready Play, SafeAssure, the SafeAssure logo, SMARTMOS, TurboLink, Vybrid and Xtrinsic are trademarks of Freescale Semiconductor, Inc. All 

other product or service names are the property of their respective owners. © 2012 Freescale Semiconductor, Inc.

• Reference Platform 

• SABRE Platform for Smart Devices 

• Micro-USB B Cable 

• 4GB or larger SD card 

• Development PC 

• Dell/IBM Laptop 

• 64-bit capable with minimum 4GB of RAM 

• VMware Player 4.0.3 

• Virtual Machine 

• X86-64 Ubuntu 11.04 

• Minimum disk space required is 50GB 

• Android SDK, r18 for Windows 

TM 

3 






TM 

4 






TM 

5 






Username: androiduser 

Password: android 

TM 

6 






TM 

7 






http://source.android.com/source/initializing.html 

• Libraries 

• X86-64 Ubuntu 11.04 

• sudo apt-get install ia32-libs 

• sudo apt-get install libc6-dev-i386 zlib1g-dev g++-multilib lib32z1-dev lib32ncurses5-dev 

• Sun Java6 SDK 

• sudo apt-get purge openjdk* 

• sudo apt-get autoremove 

• sudo add-apt-repository ppa:ferramroberto/java 

• sudo apt-get update 

• sudo apt-get install sun-java6-re sun-java6-plugin sun-java6-fonts 

• sudo apt-get install sun-java6-jdk 

• Tools 

• sudo apt-get install curl git bison flex gperf uboot-mkimage minicom openssh-server 

TM 

8 






• Android SDK, r18 

• http://developer.android.com/sdk/index.html 

• Extract in /opt 

• sudo chgrp android /opt 

• sudo chmod 775 /opt 

• /opt/android-sdk-linux/tools/android 

TM 

9 






• Unpack i.MX Android Release Package 

android@ubuntu:~$ mkdir imx-android 

android@ubuntu:~$ cd imx-android 

android@ubuntu:~/imx-android$ tar –xzf imx-android-r13.3.tar.gz 

android@ubuntu:~/imx-android$ cd imx-android-r13.3/code 

android@ubuntu:~/imx-android/imx-android-r13.3/code$ tar –xzf r13.3.tar.gz 

• Retrieve Android Source Code 

android@ubuntu:~$ cd imx-android 

android@ubuntu:~/imx-android$ mkdir r13.3 

android@ubuntu:~/imx-android/r13.3$ curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > repo 

android@ubuntu:~/imx-android/r13.3$ chmod a+x ./repo 

android@ubuntu:~/imx-android/r13.3$ ./repo init –u https://android.googlesource.com/platform/manifest.git -b android-4.0.4_r1.1 

android@ubuntu:~/imx-android/r13.3$ cp ../imx-android-r13.3/code/r13.3/default.xml .repo/manifests/default.xml 

android@ubuntu:~/imx-android/r13.3$ ./repo sync 

• Retrieve ALSA Source Code 

android@ubuntu:~/imx-android/r13.3$ cd external 

android@ubuntu:~/imx-android/r13.3/external$ git clone git://android.git.linaro.org/platform/external/alsa-lib.git 

android@ubuntu:~/imx-android/r13.3/external$ git clone git://android.git.linaro.org/platform/external/alsa-utils.git 

android@ubuntu:~/imx-android/r13.3/external$ cd ../hardware 

android@ubuntu:~/imx-android/r13.3/hardware$ git clone git://android.git.linaro.org/platform/hardware/alsa-sound.git 

TM 

10 






• Retrieve Freescale Linux Kernel Source 

android@ubuntu:~/imx-android/r13.3/hardware$ cd ../ 

android@ubuntu:~/imx-android/r13.3$ git clone git://git.freescale.com/imx/linux-2.6-imx.git kernel_imx 

android@ubuntu:~/imx-android/r13.3$ cd kernel_imx 

android@ubuntu:~/imx-android/r13.3/kernel_imx$ git checkout imx-android-r13.3 

• Retrieve Freescale U-Boot Source 

android@ubuntu:~/imx-android/r13.3/kernel_imx$ cd ../bootable/bootloader 

android@ubuntu:~/imx-android/r13.3/bootable/bootloader$ git clone git://git.freescale.com/imx/uboot-imx.git uboot-imx 

android@ubuntu:~/imx-android/r13.3/bootable/bootloader$ cd uboot-imx 

android@ubuntu:~/imx-android/r13.3/bootable/bootloader/uboot-imx$ git checkout imx-android-r13.3 

• Patch Repository with r13.3 Source 

android@ubuntu:~/imx-android/r13.3/bootable/bootloader/uboot-imx$ cd ~/imx-android/r13.3 

android@ubuntu:~/imx-android/r13.3$ . ../imx-android-r13/code/r13.3/and_patch.sh 

android@ubuntu:~/imx-android/r13.3$ help 

android@ubuntu:~/imx-android/r13.3$ c_patch /opt/imx-android-r13.3/code/r13.3 imx_r13.3 

TM 

11 






• Part of the R13.3 Release 

• R13.3_hot_fix_patches.tar.gz 

• See readme in R13.3_hot_fix_patches directory 

android@ubuntu:~/imx-android/r13.3$ cd ../ 

android@ubuntu:~/imx-android$ tar –xzf R13.3_hot_fix_patches.tar.gz 

android@ubuntu:~/imx-android$ cd r13.3/hardware/imx 

android@ubuntu:~/imx-android/r13.3/hardware/imx$ git apply ../../../R13.3_hot_fix_patches/hardware/imx/0002-ENGR00212135- 

CTS-result-is-not-stable-due-to-testPre.patch 

android@ubuntu:~/imx-android/r13.3/hardware/imx$ git apply ../../../R13.3_hot_fix_patches/hardware/imx/0001-ENGR00211879- 

Media-Server-will-hold-too-many-file-ha.patch 

android@ubuntu:~/imx-android/r13.3/hardware/imx$ cd ../../ 

android@ubuntu:~/imx-android/r13.3$ cp ../R13.3_hot_fix_patches/device/fsl/proprietary/omx/lib/lib_omx_client_arm11_elinux.so 

device/fsl/proprietary/omx/lib 

android@ubuntu:~/imx-android/r13.3$ cd frameworks/base 

android@ubuntu:~/imx-android/r13.3/frameworks/base$ git apply ../../../R13.3_hot_fix_patches/frameworks/base/0001- 

ENGR00211306-HDMI-Audio-No-audio-with-single-HDMI-ou.patch 

android@ubuntu:~/imx-android/r13.3/frameworks/base$ cd ../../kernel_imx 

android@ubuntu:~/imx-android/r13.3/kernel_imx$ git apply ../../R13.3_hot_fix_patches/kernel_imx/0001-ENGR00211686-mx6usb-system-crash-after-suspend-resu.patch 

TM 

12 






android@ubuntu:~$ cd imx-android/r13.3 

android@ubuntu:~/imx-android/r13.3$ ./repo status 

TM 

13 






TM 

14 






TM 

15 






TM 

16 






TM 

17 






• User build 

• Useful for analyzing production builds using logcat 

android@ubuntu:~/imx-android/r13.3$ source build/envsetup.sh 

android@ubuntu:~/imx-android/r13.3$ lunch sabresd_6q-user 

• User Debug build 

• Enables debug for Java processes 

• Useful to analyze Java runtime profiling and logcat 


android@ubuntu:~/imx-android/r13.3$ lunch sabresd_6q-userdebug 

• Engineering build (use this one) 

• Compiles source with –g option and no optimization 

• Enables debug for Java and native processes 

• Useful for source code level debug of Java and native source 


android@ubuntu:~/imx-android/r13.3$ lunch sabresd_6q-eng 

TM 

18 






• Manufacturing Tool(D:\iMX\FTF-CSD-F0054_iMX6_ANDROID\R13.3\imx-androidr13.3\tool\Mfgtools-Rel-12.04.01_ER_MXQ_UPDATER\) 

• R13.3 Release – Two versions 

• Mfgtools-Rel-12.04.01_ER_MX6Q_UPDATER 

• Mfgtools-Rel-12.04.01_ER_MX6DL_UPDATER 

TM 

19 






Tool(D:\iMX\FTF-CSD- 

F0054_iMX6_ANDROID\R13.3\imx-android-r13.3\tool\Mfgtools-Rel- 

12.04.01_ER_MXQ_UPDATER\Profiles\MX6Q Linux Update\OS 

Firmware\files\android. 

TM 

20 






TM 

21 






TM 

22 






TM 

23 






TM 

24 






Partition Type/Index Name Start Offset Size File System Content 

N/A BOOT Loader 0 1 MB N/A Bootloader 

Primary 1 Boot 8 MB 8 MB 

Primary 2 Recovery After end of Boot 8MB 

Logic 5 

(Extended 3) 

Logic 6 

(Extended 3) 

Logic 7 

(Extended 3) 

Logic 8 

(Extended 3) 

Logic 9 

(Extended 3) 

Why does Android use the partitioning scheme it does? 

• Android 4.0 CDD only states the following: 

• At least 350MB of non-volatile storage for private application data - /data 

• Download Manager must be able to download at least 100MB file size to default “cache” location 

• At least 1GB of non-volatile shared storage for applications - /sdcard 

Why did the partitioning scheme change in R13.2 ICS? 

• This scheme is commonly adopted by in other Android products. It added a vendor and boot partition to support 

vendor specific information and support recovery OTA 

TM 

SYSTEM 

CACHE 

DATA 

After end of 

Recovery 

After end of 

SYSTEM 

After end of 

CACHE 

512 MB 

256 MB 

> 

1024 MB 

Vendor After end of DATA 8 MB 

Misc 

After end of 

Vendor 

Primary 4 MEDIA After end of Misc 

4 MB 

Up to remaining 

sectors 

25 

boot.img format – kernel + 

ramdisk 

boot.img format – kernel + 

ramdisk 

boot.img 

recovery.img 

EXT4 – mount as /system Android system files 

under /system 

EXT4 – mount as /cache Android cache for OTA 

image store 

EXT4 – mount as /data Data storage for 

system applications 

EXT4 – mount as /vendor Vendor specific 

information 

N/A Recovery store, 

bootloader message 

VFAT Internal media files 

under /mnt/sdcard 






• ADB 

• Add udev rules for Android USB devices 

• sudo vi /etc/udev/rules.d/51-android.rules 

• SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666“ 

• sudo service udev restart 

• minicom –D /dev/ttyUSB0 

TM 

26 






• minicom –D /dev/ttyUSB0 

• Press 

• Stop U-Boot autoboot 

• setenv bootargs „console=ttymxc0,115200 init=/init video=mxcfb0 fbmem=10M 

vmalloc=400M androidboot.console=ttymxc0 enable_wait_mode=off‟ 

• saveenv 

• boot 

TM 

27 






• Add a new application to our system – MyWeatherWidget 

• Sample code from the Android SDK 

• Create folder to hold the new application 

• „vendor‟ directory is checked for content by the build system 

android@ubuntu:~/imx-android/r13.3$ mkdir vendor 

android@ubuntu:~/imx-android/r13.3$ cd vendor 

android@ubuntu:~/imx-android/r13.3/vendor$ mkdir acme 

• Move to the sample code directory 

android@ubuntu:~/imx-android/r13.3/vendor$ cd /opt/android-sdk-linux/samples/android-15 

android@ubuntu:/opt/android-sdk-linux/samples/android-15$ ls 

android@ubuntu:/opt/android-sdk-linux/samples/android-15$ cp –r WeatherListWidget ~/imx-android/r13.3/vendor/acme 

• Return to the WeatherListWidget directory 

android@ubuntu:/opt/android-sdk-linux/samples/android-15$ cd ~/imx-android/r13.3/vendor/acme/WeatherListWidget 

android@ubuntu:~/imx-android/r13.3/vendor/acme/WeatherListWidget$ cp 

~/imxandroid/r13.3/packages/apps/DeskClock/Android.mk . 

TM 

28 






TM 

29 






• From out root repository, we can build the application 

android@ubuntu:~/imx-android/r13.3/vendor/acme/WeatherListWidget$ cd ~/imx-android/r13.3 

android@ubuntu:~/imx-android/r13.3$ make –j2 

We can check the output of the build process to confirm the application is built 

• Verify the APK is in our system image 

android@ubuntu:~/imx-android/r13.3$ cd out/target/product/sabresd_6q/system 

android@ubuntu:~/imx-android/r13.3/out/target/product/sabresd_6q/system$ find . –name *.apk 

We can check if our APK is in the system image….and it is NOT! Why? 

• We need to instruct build process the package is part of our product 

android@ubuntu:~/imx-android/r13.3/out/target/product/sabresd_6q/system$ cd ~/imx-android/r13.3 

android@ubuntu:~/imx-android/r13.3$ cd device/fsl/imx6 

android@ubuntu:~/imx-android/r13.3/device/fsl/imx6$ vi imx6.mk 

TM 

30 






TM 

31 






• From out root repository, we can build the application 

android@ubuntu:~/imx-android/r13.3$ make –j2 

We can check the output of the build process to confirm the application is built 

• Verify the APK is in our system image 

android@ubuntu:~/imx-android/r13.3$ cd out/target/product/sabresd_6q/system 

android@ubuntu:~/imx-android/r13.3/out/target/product/sabresd_6q/system$ find . –name *.apk 

• To do on your own: Load the images on the SABRE 

TM 

32 






• Setup and configuration for DDMS 

• ~/.android/ddms.cfg 

• Change „defaultHeapUpdateEnabled‟ to true 

• Add „native=true‟ 

• Default locations and environment 

• $PATH variable arm-eabi-addr2line 

• $ANDROID_PRODUCT_OUT/system/lib for symbols 

• So…make sure to run from Android repository… 

• Source build/envsetup.sh 

• lunch 

• From the console or using ADB (requires root) 

• adb shell setprop.debug.malloc 1 

• adb shell stop 

• adb shell start 

• /opt/android-linux-sdk/tools/ddms & 

TM 

33 






TM 

34 






TM 

35 






• Launch the Browser 

• Locate the PID of the Browser 

• Launch minicom and execute the „ps‟ command to locate the PID 

• adb forward tcp:9999 tcp:9999 

• gdbserver :9999 –attach 

TM 

36 






• Launching GDB with DDD (Data Display Debugger) 

• ddd –debugger arm-eabi-gdb 

TM 

37 






TM 

38 






TM 

39 






TM 

40 






Questions: 

jeff.kudrick@freescale.com 

TM 

Freescale on Kaixin 

Tag yourself in photos 

and upload your own! 

Session materials will be posted @ www.freescale.com/FTF 

41 

Weibo? 

Please use hashtag 

#FTF2012#

Questions

Create successful ePaper yourself

Delete template?

Save as template?