DART-SD410 Android LL 1 1

From Variscite Wiki
DART-SD410 Android-LL-5.1.1 Developers Guide

1 Introduction

This WIKI describes how to build and deploy Android Lollipop Lollipop-5-1-1 on the DART-SD410. It is based on Qualcomm Android-LL-5.1.1.

2 Overview

The objective of this document is to guide DART-SD410 Android developers to obtain Android Lollipop sources, setting up host environment, compilation and deployment.

This document contains instructions for:

  • Hardware and software requirements.
  • Setup the hardware.
  • Setup the toolchain.
  • Download & build the sources.
  • Install the binaries on the DART-SD410 SOM.

2.1 Document Reference

This release is based on Qualcomm APQ8016_410C_LA.BR.1.2.4-01810-8x16.0_5.1.1_Lollipop_P2 release. Please refer to Qualcomm Developer Network before you start building.

3 Supported hardware and features

Feature Description
SOM support DART-SD410
Carrier Board support VAR-DT410CustomBoard
CPU Qualcomm - Snapdragon 410
Resque Image Resque Images set can be downloaded from FTP
eMMC up to 16GB
DDR size support configuration Up to 2G LPDDR3
SD-Card +
Wired Network 10/100 Mbps Ethernet
Wireless Network 802.11abg AP, & Wi-Fi
Bluetooth +
SPI +
I2C +
USB OTG Host and Device
Uarts x2
RTC +
Display HDMI: 1080P (On board DSI-to-HSMI bridge, 800x480 resolution)
LVDS (On board DSI-to-LVDS bridge, 800x480 resolution)
Audio Line In & Line out
Mono Speaker
Audio over HDMI
Camera IMX135 camera sensor. Board can be ordered separately at : sales@variscite.com

4 Hardware Requirements

DART-SD410 evaluation kit.

Please refer to Host requirements installation.

5 Obtain Variscite's BSP

Please download Android Board Support Package file from Variscite's FTP site.
Contact Variscite support for FTP credentials.

5.1 Unpack Variscite's Android Release Package

$ mkdir ~/dart-sd410
$ cd ~/dart-sd410
$ unzip ~/Downloads/variscite_bsp_vla.br_.1.2.4-01810-8x16.0-3.zip
$ cd source/

6 Download and Build Android Images

The following commands will download the full Android release from different Git repositories and build the Android images. It may take a very long time depending on Internel connection, Build machine, and remote servers. The process may fail fetching the repositories, in this case it can be started again.

$ chmod +x SD410c_build.sh
The file SD410c_build.sh can be edited and parameter $BUILD_MACHINE changed to follow the build machine. 
The best setting is number of threads of the CPU minus 2.
$ ./SD410c_build.sh
The build system will ask for credentials for repo initialization.

7 Build Specific Android Image

Usually the changes are done only to a kernel, or bootloader, in this case there is no need to build the whole system and a specific image can be built. To accomplish it run:

$ ./build.sh msm8916_64 --image "image to build"
"image to build" can be bootimg/sysimg/usrimg

To build the whole Android tree without downloading it again use:

$ ./build.sh msm8916_64

8 Flashing newly built images

The build process creates an out directory and puts all images in the following directory:
/out/target/product/msm8916_64/
The following image files are created:
emmc_appsboot.mbn - little kernel (uboot)
boot.img - kernel and dtb files
system.img - system folder
The images can be flashed one by one via fastboot.
In order to enter fastboot mode cycle the power or press Reset key with Back key pressed.

8.1 To flash the whole system

$ cd out/target/product/msm8916_64/
$ sudo fastboot flash aboot emmc_appsboot.mbn
$ sudo fastboot flash persist persist.img
$ sudo fastboot flash userdata userdata.img
$ sudo fastboot flash system system.img
$ sudo fastboot flash recovery recovery.img
$ sudo fastboot flash boot boot.img

8.2 To flash kernel and dtbs

Sometimes the changes are done only to the android kernel, in this case there is no need to flash the whole system.
The kernel and dtb files are located in boot.img file.
Flashing it is enough

$ cd out/target/product/msm8916_64/
$ sudo fastboot flash boot boot.img

8.3 To flash little kernel

Sometimes the changes are done only to the bootloader, in this case there is no need to flash the whole system.
The little kernel is located in emmc_appsboot.mbn file.
Flashing it is enough

$ cd out/target/product/msm8916_64/
$ sudo fastboot flash aboot emmc_appsboot.mbn

9 Adding Applications

9.1 Adding Broswer

  • Download Browser.zip file from Variscite's FTP site into ~/dart-sd410/source/ directory.
  • The file is located in dart-sd410/Software/Android/AdditionalPackages/ FTP directory
  • Extract the downloaded file into your android directory
$ cd ~/dart-sd410/source/
$ unzip Browser.zip
  • Build the Android
  • Flash the new Android into the board by fastboot

9.2 Adding GPS Test

  • Download GPSTest.zip file from Variscite's FTP site into ~/dart-sd410/source/ directory.
  • The file is located in dart-sd410/Software/Android/AdditionalPackages/ FTP directory
  • Extract the downloaded file into your android directory
$ cd ~/dart-sd410/source/
$ unzip GPSTest.zip
  • Add the new package into your board configuration
$ gedit ./APQ8016_410C_LA.BR.1.2.4-01810-8x16.0_5.1.1_Lollipop_P2/device/qcom/msm8916_64/msm8916_64.mk

locate the following lines:

PRODUCT_PACKAGES += \
libqcomvisualizer \
libqcompostprocbundle \
libqcomvoiceprocessing

Add a new package to the PRODUCT_PACKAGES

PRODUCT_PACKAGES += \
libqcomvisualizer \
libqcompostprocbundle \
libqcomvoiceprocessing \
GPSTest

Save the file and exit gedit

  • Build the Android
  • Flash the new Android into the board by fastboot

9.3 Adding Geekbench

Follow the same procedure as for GPSTest to add Geekbench into your image file.

9.4 Troubleshoot

If something goes wrong check the following:

  • The downloaded files should be extracted into packages/apps/ directory verify that the new directory exists
  • Verify that the build process rebuilds the system.img image
  • Verify that the fastboot burns the system.img into system partition succsessfully

10 Customizing hardware

The DART-SD410 hardware customization should be done by changing DTS files.
This article is very helpful for reading about the DTS files.
The VAR-SD410CustmoBoard DTS files are located in kernel/arch/arm/boot/dts/qcom/ folder. The DTS file tree is:

apq8016-var-sd410.dts
└── apq8016-var-sd410.dtsi
    ├── apq8016-camera-sensor-var-sd410.dtsi
    ├── dsi-panel-var-sd410.dtsi
    └── apq8016-dart.dtsi
        ├── msm8916-pinctrl.dtsi
        └── msm8916.dtsi
            ├── skeleton64.dtsi
            ├── msm8916-coresight.dtsi
            ├── msm8916-smp2p.dtsi
            ├── msm8916-pinctrl.dtsi
            ├── msm8916-ipcrouter.dtsi
            ├── msm-gdsc-8916.dtsi
            ├── msm8916-iommu.dtsi
            ├── msm8916-gpu.dtsi
            ├── msm8916-mdss.dtsi
            │   ├── dsi-panel-sim-video.dtsi
            │   └── dsi-panel-sim-cmd.dtsi
            ├── msm8916-mdss-pll.dtsi
            ├── msm8916-iommu-domains.dtsi
            ├── msm8916-bus.dtsi
            ├── msm8916-camera.dtsi
            ├── msm-pm8916-rpm-regulator.dtsi
            ├── msm-pm8916.dtsi
            ├── msm8916-regulator.dtsi
            └── msm8916-pm.dtsi