View source for Android Usage

Several features selected to facilitate development have been built into this port of Android on Overo COMs. Some tweaks may be required to get this to work on your setup.

=== Calibrate Touchscreen ===
For touchscreen displays, you might like to replace the ''/system/etc/pointercal'' file from the Android root file system with one specific to the touchscren you are using.  To generate this calibration file, boot your Gumstix + touchscreen with the standard Angstrom build, do the touchscreen calibration step, and then grab the ''/etc/pointercal'' file from the root file system.

== Busybox ==
The Android shell is accessible via the console port as usual however many standard GNU tools are missing and the shell is pretty minimal.  To install busybox, navigate to <code>/system/bin</code>, and issue the command <code>$ <strong>./busybox install</strong></code>. Similarly, the Vim editor has been installed as a binary.

== Change Boot Options (Display) ==
A ''boot.scr'' u-boot script sets appropriate boot options assuming 4.3" expansion boards. This file is generated using [https://github.com/gumdroid/android-utils/raw/master/mkscript this script] based on [https://github.com/gumdroid/android-utils/raw/master/androidboot.cmd these u-boot commands]. To change the boot options, generate a new version of this script.
<code>
 $ <strong>git clone git://github.com/gumdroid/android-utils.git utils</strong>
 $ <strong>sudo apt-get install uboot-mkimage</strong>
 <...make changes to utils/androidboot.cmd...>
 $ <strong>source utils/mkscript</strong>
</code>
For 3.5" touchscreen boards such as Palo35, change ''omapdss.def_disp=lcd43'' to ''omapdss.def_disp=lcd35''. For expansion boards supporting external monitors such as Tobi, change ''omapdss.def_disp=lcd43'' to ''omapdss.def_disp=dvi''. Note that even if you are using an LCD panel, it is not necessary to change the ''omapfb.mode'' as this just sets up the framebuffer in the case that an external DVI monitor is used.

'''Note:''' If the u-boot environment doesn't load a boot script on startup (the default behaviour), the board may not boot as expected. To reset to the default u-boot environment, issue the following command at the u-boot prompt on startup:
<code>
 $ <strong>nand erase 240000 20000</strong>
</code>

== Debugging ==
Google has provided several tools to assist debugging [http://developer.android.com/guide/developing/index.html within the Android environment]. For system level debugging, these techniques may be useful:
* [http://source.android.com/porting/debugging_native.html Native Applications]
* [http://source.android.com/porting/debugging_gdb.html GDB]
* [http://source.android.com/porting/tcpdump.html TCPDump]
* [http://source.android.com/porting/instrumentation_testing.html Instrumentation Testing]
Likewise, [http://www.omappedia.org/wiki/Android_Debugging Omappedia] has a comprehensive list of suggestions.

=== Using ADB ===
The Android Debug Bridge (ADB) is a development Swiss Army knife for Android systems.  Specifically, it facilitates application debugging and monitoring, file transfer and file management, investigation of the systems logs and configuration, and even allows screenshot capture.  Depending on your host OS, the [http://developer.android.com/guide/developing/device.html#setting-up setup instructions] will change. The USB IDs are set to some defaults within the kernel (''arch/arm/mach-omap2/board-overo.c''):
{| class="wikitable" style="margin: 1em auto 1em auto;"
|-
! Parameter
! Value
|-
| VID (Vendor ID) 
| 0x18D1
|-
| PID (Product ID)
| 0x9018
|}
For recent Ubuntu systems, copy this file to ''/etc/udev/rules.d/51-android.rules'':
<code>
 $ <strong>sudo wget http://github.com/gumdroid/android-utils/master/raw/51-android.rules /etc/udev/rules.d/</strong>
</code>

== Customization ==
The themes and features of Android are readily [http://source.android.com/porting/customization.html customizable]. For more help changing the boot screen, check out [http://www.omappedia.org/wiki/Android_Debugging this link].

== Useful Links ==
* [http://omappedia.org/wiki/Android_Getting_Started Omappedia Getting Started]