CM-T335: Android: Getting started - Revision history

Ilya: /* Mount the installation source media */

2015-06-23T07:13:10Z

‎Mount the installation source media

Ilya: /* Introduction */

2014-11-23T09:16:06Z

‎Introduction

Grinberg at 16:40, 4 November 2014

2014-11-04T16:40:51Z

Ilya: /* Boot from the micro SD card */

2014-09-07T12:10:13Z

‎Boot from the micro SD card

Ilya: /* Boot from the micro SD card */

2014-05-01T12:10:15Z

‎Boot from the micro SD card

Show changes

Ilya: /* Installing Android */

2013-12-26T11:26:09Z

‎Installing Android

Ilya: /* Installing Kernel */

2013-09-10T07:38:01Z

‎Installing Kernel

New page

= 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 -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>

= 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]]

@@ Line 17: / Line 17: @@
 == Boot into the installation environment (ramdisk) ==
 The first step in CM-T335 Android installation is starting the installation environment (Linux kernel and Ramdisk image).
-This can be done using the following media:
+This can be done using one of the following media:
 * [[#Using installation environment on micro SD card|Micro SD card]]
 * [[#Using installation environment on USB storage device|USB storage device]]
@@ Line 74: / Line 74: @@
 === Mount the installation source media ===
-The next step is installing the kernel and Android images. The following media can be used as a source for installation:
+The next step is installing the kernel and Android images. Any one of the following media can be used as a source for installation:
 * [[#Mount a micro SD Card|Micro SD Card]]
 * [[#Mount a USB Storage Device|USB storage device]]
@@ Line 144: / Line 144: @@
 root@compulab:~# mkdir -p /media/rootfs && mount -t ubifs ubi0:rootfs /media/rootfs
 </pre>
-* Extract the content of {{filename|Android-image.tar.bz2}} onto the /media/rootfs:
+* Extract the content of {{filename|Android-image-cm-t335.tar.bz2}} onto the /media/rootfs:
 <pre>
-root@compulab:~# tar --numeric-owner -xpf /mount/point/Android-image.tar.bz2 -C /media/rootfs && sync
+root@compulab:~# tar --numeric-owner -xpf /mount/point/Android-image-cm-t335.tar.bz2 -C /media/rootfs && sync
 </pre>
 * Unmount the ubi volume:
@@ Line 152: / Line 152: @@
 root@compulab:~# umount /media/rootfs
 </pre>
-* Reboot the CM-T335 evaluation system.
+* Turn off the CM-T335 evaluation system.
 * Continue to the [[#After Installation | After Installation]] section.
@@ Line 206: / Line 206: @@
 root@compulab:~# tar --numeric-owner -xpf /mount/point/Android-image-cm-t335.tar.bz2 -C /media/mmcblk0p2 && sync
 </pre>
-* Reboot the CM-T335 evaluation system.
+* Turn off the CM-T335 evaluation system.
 * Continue to the [[#After Installation | After Installation]] section.
@@ Line 259: / Line 259: @@
 </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 =
 == Select video out ==
 Default CM-T335 video output device is DVI. Other video output devices can be used as well.
@@ Line 290: / Line 291: @@
 * Set the {{parameter|bootargs}} environment variable:
 <pre>
-CM-T3x # setenv bootargs "console=ttyO0,115200n8 androidboot.console=ttyO0 root=/dev/mmcblk0p2 rw rootfstype=ext4 rootwait init=/init ip=off cm_t335_disp=${disp_type}"
+CM-T335 # setenv bootargs "console=ttyO0,115200n8 androidboot.console=ttyO0 root=/dev/mmcblk0p2 rw rootfstype=ext4 rootwait init=/init ip=off cm_t335_disp=${disp_type}"
 </pre>
 * To boot Android Demo image type:
 <pre>
-CM-T3x # setenv bootdelay 3
+CM-T335 # setenv bootdelay 3
-CM-T3x # setenv bootcmd "mmc rescan; load mmc 0:1 82000000 uImage-cm-t335; bootm"
+CM-T335 # setenv bootcmd "mmc rescan; load mmc 0:1 82000000 uImage-cm-t335; bootm"
-CM-T3x # saveenv
+CM-T335 # saveenv
-CM-T3x # boot
+CM-T335 # boot
 </pre>

@@ Line 22: / Line 22: @@
 === Using installation environment on micro SD card ===
-* Copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t335/#devres Android Demo package for CM-T335] to the root directory on the first partition of the micro SD card. Note, the partition must be FAT (16 or 32) formatted.
+* Copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t335/#devres Android Demo package for CM-T335] to the root directory on the first partition of the micro SD card.
 * Insert the micro SD card into the SD socket (P23) on the SB-T335.
 * Use the following U-boot commands to boot the installation environment on the CM-T335:
 <pre>
 CM-T335 # mmc rescan
-CM-T335 # fatload mmc 0:1 80400000 bootscr.img
+CM-T335 # load mmc 0:1 80400000 bootscr.img
 CM-T335 # source 80400000
 </pre>
@@ Line 33: / Line 34: @@
 === Using installation environment on USB storage device ===
-* Copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t335/#devres Android Demo package for CM-T335] to the root directory on the first partition on the USB storage device. Note, the partition must be FAT (16 or 32) formatted.
+* Copy {{filename|kernel.img}}, {{filename|ramdisk.img}} and {{filename|bootscr.img}} from [http://compulab.co.il/products/computer-on-modules/cm-t335/#devres Android Demo package for CM-T335] to the root directory on the first partition on the USB storage device.
 * Plug the USB storage device into:
 ** USB host connector (either P25, P26, P27 or P28) on SB-T335 if the CM-T335 module has U4 configuration or
@@ Line 40: / Line 42: @@
 <pre>
 CM-T335 # usb start
-CM-T335 # fatload usb 0:1 80400000 bootscr.img
+CM-T335 # load usb 0:1 80400000 bootscr.img
 CM-T335 # source 80400000
 </pre>
@@ Line 292: / Line 294: @@
 <pre>
 CM-T3x # setenv bootdelay 3
-CM-T3x # setenv bootcmd "mmc rescan; fatload mmc 0 82000000 uImage-cm-t335; bootm"
+CM-T3x # setenv bootcmd "mmc rescan; load mmc 0:1 82000000 uImage-cm-t335; bootm"
 CM-T3x # saveenv
 CM-T3x # boot

@@ Line 2: / Line 2: @@
 The Android Demo filesystem image for the CompuLab CM-T335 System-on-Module / Computer-on-Module 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.}}
+{{Note|Minimal system requirements for Android Demo Image: CPU with 2D/3D graphics acceleration (SGX) support ('''C600G''' assembly option), memory of 256MB at least.}}
 = Preparation steps =

@@ Line 1: / Line 1: @@
 = 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.
+The Android Demo filesystem image for the CompuLab CM-T335 System-on-Module / Computer-on-Module is based on Android 4.1.2 Jelly Bean with SGX (3D graphics acceleration) support.
 {{Note|We do not recommend using Android Demo Image on CM-T335 devices with less then 256MB of RAM.}}

@@ Line 52: / Line 52: @@
 * Extract the Android Demo root filesystem on to that partition:
 <pre>
-sudo tar -xpf /path/to/cm-t335-android/images/Android-image-cm-t335.tar.bz2 -C /media/rootfs && sync
+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:
@@ Line 75: / Line 75: @@
 CM-T3x # saveenv
 CM-T3x # boot
 </pre>