======= Android Installation =======
This is short introduction of installing the Android-BSP into eMMC of the TQMa53
<WRAP round important>This is a rudimentary BSP of Android for the TQMa53 and for an evaluation process only </WRAP>
====== Overview of Installation Process ======
  - Prepare your Linux host
  - Check for nessesary tools
  - Download the BSP from TQ-Website
  - Set nessesary variables for the install script
  - Extract the BSP to your development folder
  - Configure the make file
  - Deploy the binary Android image via tftp to your TQMa53


====== Prepare your Linux host ======
===== Check for nessary tools and commands =====

Please check the following tools are available and install if nessesary
<code>which dd
which sudo
which tar
which sed
which make
which bunzip2
which parted
which tar
which mkfs.vfat
which mkfs.ext4
which mkfs.ext3
</code>
Also check if a '' nfs server '' and a '' tftp server '' are installed.

<WRAP round tip>If some commands cannot be found, login as root and search for the commands again. Some commands may be only accessible with root privilegs.</WRAP>

====== Download the Android BSP ======

The Android BSP can be downloaded in the Android downloadsection of this wiki or at the TQ-Website in the Modulsection.
===== Download sources =====


  - Bla 1
  - Bla 2
    - Bla 3
      - Bla 4
======= Define enviroment variables =======
Please define the following enviroment variables
=====       Enviroment variables =====
<code>
export MY_VERSION=20130224-2
export MY_ANDROID=/my_develop/android/tqma53
export MY_DISTRIB=${MY_ANDROID}/distrib/${MY_VERSION}
export ANDROID_MK=${MY_DISTRIB}/scripts/android_binary.mk
</code>

====== Extract the BSP to your development folder ======

After downloading the BSP and configuring the enviroment variables create the ''MY_DISTRIB'' folder and extract the downloaded BSP into it
===== Folder creation and BSP extraction =====
<code>mkdir -p ${MY_DISTRIB}
tar xjf android-tqma53-${MY_VERSION}.tar.bz2 -C ${MY_DISTRIB} </code>


====== Configure the make file ======

Now it's time to configure the makefile.
  - set the sdcard reader (eg. /dev/sdd)
  - set IP-adresses of the host, target and gateway
  - define the tftproot folder
  - define the nfs_client_ip

The make file is accessable via ''$ANDORID_MK'' 

===== configuration =====

<code> nano ${ANDROID_MK} </code>
To open the makefile

and edit the marked points 
<code>

#################################################
# User specific settings
# Please set the variables below this line
#################################################

# Set the root folder for the Android software
# most of the files and directories are installed or created in this folder or subfolders.
MY_ANDROID:=/my_develop/android/tqma53

# current version number
MY_VERSION:=20130224-2

# VERY IMPORTANT: This is the device name of the SD-card on the host, when it is inserted in the card reader.
# This device will be ERASED and FORMATTED!!!
# Don't select a disk of your host, otherwise it will be erased !!
# You can use 'dmesg' to find out the device name, after the SD-card has been inserted in the card reader.
# If you don't know the device name use /dev/null
SDCARD_DEV:=/dev/null

# The distribution archive has been extracted into this folder
MY_DISTRIB:=$(MY_ANDROID)/distrib/$(MY_VERSION)

# Please set folder of the tftp server
MY_TFTPBOOT:=/tftpboot

# Please set the IP addresses of your host and the target.
IP_ADDR_TARGET:=192.168.1.11         #<--- ip_adress of the TQMa53
IP_ADDR_HOST:=192.168.1.51           #<--- Host IP
IP_NETMASK:=255.255.255.0            #<--- netmask adress of network
IP_ADDR_GATEWAY:=192.168.1.1         #<--- gateway of the network

# This client address is used in the file /etc/exports
IP_NFS_CLIENT:=192.168.1.255/24      #<--- NFS configuration

# Please set the number of CPUs which are active on the host
CPUS_ANDROID:=2                     

#################################################
# No need to change the variables below this line
#################################################

</code>

====== Deploy the binary Android image via tftp to your TQMa53 ======
===== After configuring the make file we can start deploy the image =====

First copy images from distrib folder to the image folder 
<code> make --makefile ${ANDROID_MK} cp_images </code>

Copy the image into the tftproot
<code>  make --makefile ${ANDROID_MK} cp_image_tftpboot_01 </code>

===== Start the MBa53=====

Start the MBa53 and go into the Barebox enviroment by pressing any key 

After starting the MBa53 , type on your Linux host the following command
<code> make --makefile ${ANDROID_MK} cp_image_board_01 </code> 
and follow the onscreen instructions.

__Example instructions__

<code># On the barebox command line:
# Write the image to /dev/disk0
# !!!!! This will overwrite the bootloader on /dev/disk0 !!!!! 

eth0.ipaddr=172.21.16.3
eth0.netmask=255.255.0.0
eth0.serverip=172.21.10.175
eth0.gateway=172.21.2.1
tftp android-image-tqma53_01 /dev/disk0 
</code>
<WRAP round important>Dependig on your networkspeed the download takes about 25 min.</WRAP>

After copy the files via tftp in the eMMC power off the MBa53 and and set the DIP-Switches "S1","S2" and "S3" in order to boot from eMMC
<code>S1-1,2 off
S2-6 on
S2-7 on, other S2-Switches off
S3-3 on
S3-5 on, other S3-Switches off
</code>

You can insert an SD-card into slot X6 on the target. It will be only used for the /mnt/sdcard partition

====== Start your Android the first time ======
After about 3min the GUI of Android appears and it is ready to use