View source for CM-T335: Android: Getting started

= Introduction =
The Android Demo filesystem image for CM-T335 is based on Android 4.1.2 Jelly Bean with SGX (3D graphics acceleration) support. The CompuLab Android Demo package for CM-T335 includes ready to run Demo Android filesystem image and Linux kernel based on 3.2.0 version.
{{Note|We do not recommend using Android Demo Image on CM-T335 devices with less then 256MB of RAM.}}

= Preparation steps =
* Obtain a Linux PC workstation.
* Get a USB Card reader and a micro SD Card. Use either the micro SD card, supplied with the CM-T335 Evaluation kit, or create a new one.
* Plug the USB SD Card reader to a host Linux PC. Insert the micro SD Card into the USB Card reader. From now we assume the device name of the MMC/SD card on your Linux PC is {{filename|/dev/sdc}}.
* Download the [http://compulab.co.il/products/computer-on-modules/cm-t335/#devres Android Demo package for CM-T335] from CompuLab website. Unzip the package to a directory on your host workstation.
* All image files mentioned below can be found in {{filename|images}} subdirectory of the Demo package.

= Preparing MMC/SD card =
* Create two partitions (FAT32 partition for Linux kernel and ext4 partition for root filesystem) as described in the [[CM-T3x: U-Boot: Firmware_Overview#Default MMC.2FSD card mapping | Default MMC/SD Card mapping]] article:
<pre>
Disk /dev/sdc: 8035 MB, 8035237888 bytes
32 heads, 32 sectors/track, 15326 cylinders, total 15693824 sectors
Units = sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0x710ab397

   Device Boot      Start         End      Blocks   Id  System
/dev/sdc1   *        2048      242959      120456    c  W95 FAT32 (LBA)
/dev/sdc2          243712    15693823     7725056   83  Linux
</pre>
* Format FAT32 partition:
<pre>
sudo mkfs.vfat -F 32 -n boot /dev/sdc1
</pre>
* Format ext4 partition:
<pre>
sudo mkfs.ext4 -L rootfs /dev/sdc2
</pre>
* Mount the FAT32 partition under {{filename|/media/boot}} location:
<pre>
sudo mkdir -p /media/boot
sudo mount /dev/sdc1 /media/boot
</pre>
* Mount the partition under {{filename|/media/boot}} location:
<pre>
sudo mkdir -p /media/rootfs
sudo mount /dev/sdc2 /media/rootfs
</pre>

= Installing Kernel =
* Copy Linux kernel image on to the boot partition:
<pre>
cp /path/to/cm-t335-android/images/uImage-cm-t335 /media/boot/
</pre>

= Installing Android =
* Extract the Android Demo root filesystem on to that partition:
<pre>
sudo tar --numeric-owner -xpf /path/to/cm-t335-android/images/Android-image-cm-t335.tar.bz2 -C /media/rootfs && sync
</pre>
* Unmount all micro SD card partitions:
<pre>
sudo umount /dev/sdc1; sudo umount /dev/sdc2
</pre>
* Remove the micro SD card from the SD card reader and insert into the CM-T335 micro SD card socket (P23).
* Continue to the [[#After Installation | After Installation]] section.

= After Installation =
* Connect the host PC to the SB-T335 base-board (connector P11) via the serial cable supplied with the evaluation kit.
* Start terminal emulation software on your PC. Set baud rate to 115200 bps, 8 bit per frame, 1 stop bit, no parity, no flow control.
* Connect the DVI display to the CM-T335 evaluation system. The U-Boot boot-loader will start and you will get a command prompt.
* Set the {{parameter|bootargs}} environment variable:
<pre>
setenv bootargs "console=ttyO0,115200n8 androidboot.console=ttyO0 root=/dev/mmcblk0p2 rw rootfstype=ext4 rootwait init=/init ip=off"
</pre>
* To boot Android Demo image type:
<pre>
CM-T3x # setenv bootdelay 3
CM-T3x # setenv bootcmd "mmc rescan; fatload mmc 0 82000000 uImage-cm-t335; bootm"
CM-T3x # saveenv
CM-T3x # boot
</pre>

=== Select video out ===

Default CM-T335 video output device is DVI. 
LCD video output can be enabled by adding the following boot options to the kernel command line parameters:
<pre>
cm_t335_disp=lcd
</pre>

= See also =
* [[CM-T3x: U-Boot: Firmware_Overview]]
* [[CM-T335: Android]]
* [[CM-T335: Android: Kernel]]
* [[CM-T335: Android: Building images]]
* [http://source.android.com Android Open Source Project]
* [http://www.ti.com/tool/ANDROIDSDK-SITARA Android Development Kit for Sitara Microprocessors]


[[Category:Android]]
[[Category:CM-T335]]