Ingenic. Newton Android Development Guide

Transcription

1 Ingenic Date: Apr. 2014

2 Ingenic Copyright Ingenic Semiconductor Co. Ltd All rights reserved. Release history Date Revis ion Apr First release Change Disclaimer This documentation is provided for use with Ingenic products. No license to Ingenic property rights is granted. Ingenic assumes no liability, provides no warranty either expressed or implied relating to the usage, or intellectual property right infringement except as provided for by Ingenic Terms and Conditions of Sale. Ingenic products are not designed for and should not be used in any medical or life sustaining or supporting equipment. All information in this document should be treated as preliminary. Ingenic may make changes to this document without notice. Anyone relying on this documentation should contact Ingenic for the current documentation and errata. Ingenic Semiconductor Co., Ltd. Ingenic Headquarters, East Bldg. 14, Courtyard #10, Xibeiwang East Road, Haidian Dist., Beijing , China Tel: Fax: Http: //

3 Content Content 1 Overview Development Environment Preparing Linux Host Environment Setup Steps Preparing Windows Host Burning Environment Get Newton Android Source Code Downlaod repo script Download source code Sync to the Newton lastest version Building and Flashing Android source tree Build the Android project Build Bootloader Build boot.img Build system.img Build Android modules Flash the device Partition table of Newton Using ADB For Linux Host For Windows Host ADB driver Customization Customize Bootloader Logo Customize Boot Animation

4

5 1 Overview This document provides information for How to setup Ingenic Newton Android SDK platform, How to customize its function. It is suitable for the system software engineers. This document includes follow information: i. How to setup compiling and developing environment base on 64b PC ii. How to get Newton Android SDK iii. How to compile Android SDK iv. How to setup and use ADB tools v. How to customization Before reading this document, you should have follow work experience. i. Familiar with the Window XP/7 operating system and install device driver on Window XP/7 ii. Familiar with the Ubuntu operating system, environment variable set and shell commands 1

6

7 Development Environment 2 Development Environment This section introduces how to setup Linux host development environment and windows burning environment. 2.1 Preparing Linux Host Environment Linux host requirements i. Hard disk capacity not less than 128 GB; ii. RAM is not less than 4 GB; iii. Install Ubuntu bit systems 2.2 Setup Steps i. Install Ubuntu b system on host PC ii. Install following software packages $ sudo apt-get install cpp-4.6 g gcc-4.6 gcc-4.6-multilib gcc g++ cpp gcc-multilib g multilib git-core git gnupg flex bison gperf build-essential zip curl libc6-dev libncurses5-dev:i386 x11proto-core-dev libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc zlib1g-dev:i386 ia32-libs gawk qt4-dev-tools libgl1-mesa-dri:i386 libglapi-mesa:i386 Newton Android SDK compatible with Google Android packages. More information could available at iii. Install JDK Recommended to install the JDK version jdk-6u37-linux-x64, it is available at html 3

8 Development Environment Figure 2-1 Java JDK Download Web page Download jdk-6u37-linux-x64.bin JDK setup steps a. Copy jdk-6u37-linux-x64.bin to /usr/java/ directory b. Change file mode $ sudo chmod u+x /usr/java/jdk-6u37-linux-x64.bin c. Execute follow commands: $ sudo /usr/java/jdk-6u37-linux-x64.bin d. Setup system environment variables Method 1: Add follow line in /etc/environment file under with root user. PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin: /usr/games:/usr/java/jdk1.6.0_37/bin" JAVA_HOME=/usr/java/jdk1.6.0_37 JRE_HOME=/usr/java/jdk1.6.0_37/jre CLASSPATH=$CLASSPATH:$JAVA_HOME/lib:$JRE_HOME/lib 4

9 Development Environment Re login and environment variables take effect automatically. Method 2: Add follow line in /etc/profile file under root user export JAVA_HOME=/usr/java/jdk1.6.0_37 export JRE_HOME=/usr/java/jdk1.6.0_37/jre export CLASSPATH=$CLASSPATH:$JAVA_HOME/lib:$JRE_HOME/lib export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH Re login and environment variables take effect automatically. e. Check Java version After re login, check Java version with follow command. Setup is finished if terminal show following information. Figure 2-2 Java JDK Version 2.3 Preparing Windows Host Burning Environment Currently, Ingenic only provide USBBurningTool under Windows XP/7 OS. How to install and running burning tools, please reference "Newton_Quick_Start_Guide_CN.pdf" More information about burning tools are aviliable at 5

10

11 Get Newton Android Source Code 3 Get Newton Android Source Code Newton Android source code could download from Ingenic GIT repository. Download steps: 3.1 Downlaod repo script $ mkdir newton-android $ cd newton-android $ wget $ chmod +x repo 3.2 Download source code $./repo init -u -b an droid-4.3-newton-4775 $./repo sync The total source code size is about 20-30GB. 3.3 Sync to the Newton lastest version $./repo forall -c "git reset --hard ingenic-android4.3.0-kernel newton-vx.x-yyyymmdd" ingenic-android4.3.0-kernel3.0.8-newton-vx.x-yyyymmdd is the Newton version tag, could check it under kernel directory: $ git tag 7

12

13 Building and Flashing 4 Building and Flashing This section describes how to build and flash Android images into the device. To download the source code, please refer sector 3. In this section, the location of the source code is newton-android and the root of Android will be used to indicate this path. 4.1 Android source tree Android source tree will be like this: Figure 4-1 Android source tree The source code of Bootloader is./bootable/bootloader/xboot. The source code Kernel is./kernel. The source code of configuration files for Newton is./device/ingenic/newton. 4.2 Build the Android project $ cd newton-android $ source build/envsetup.sh $ lunch full_newton-userdebug $ make It will take about several hours and depended on the performance of the host. You will find boot.img and system.img under out/target/product/newton when building is finished successfully. 4.3 Build Bootloader $ cd newton-android $ source build/envsetup.sh $ lunch full_newton-userdebug $ cd bootable/bootloader/xboot/ 9

14 Building and Flashing $ make clean $ make newton_msc_config $ make The file named mbr-xboot-gpt.bin could be found under bootable/bootloader/xboot/. 4.4 Build boot.img The following instruction describes how to build boot.img separately. $ cd newton-android $ source build/envsetup.sh $ lunch full_newton-userdebug $ cd kernel/ $ make newton_android_msc_defconfig $ make $ make zimage $ cp drivers/net/wireless/bcm43341/bcmdhd.ko../device/ingenic/newton/ wifi/iw/bcm43341/ $ cp arch/mips/boot/compressed/zimage../device/ingenic/newton/kernel $ croot $ make bootimage The file named boot.img could be found under out/target/product/newton/. 4.5 Build system.img The following instruction describes how to build system.img separately. $ cd newton-android $ source build/envsetup.sh $ lunch full_newton-userdebug $ make systemimage 4.6 Build Android modules $ cd newton-android $ source build/envsetup.sh $ lunch full_newton-userdebug $ cd < path of the certain module > 10

15 Building and Flashing $ mm 4.7 Flash the device Key files needed by Android i. mbr-xboot-gpt.bin ii. boot.img iii. system.img. Detail instructions please refer Newton_Quick_Start_Guide_CN.pdf. 4.8 Partition table of Newton Table 4-1 Newton Partition table Board Hardware File Start Add(B) Start Page Nand Option USBBurnTool Configuration mbr-xboot-gpt.bin 0 0 N_OOB Storage: EMMC 4G, Newton 512B/Sector Mem: Mobile DDR boot.img 3M 6144 N_OOB system.img 56M N_OOB Jz4775--eMCP-MDDR.ini Please import Jz4775--eMCP-MDDR.ini as configuration file in USBBurnTool and make sure all the binaries chosen are correct. Figure 4-2 Binary files and configuration 11

16 Building and Flashing As the figure showing, the start page of mbr-xboot-gpt.bin is 0, the start page of boot.img is 6144, the start page of system.img is Details of USBBurnTool please refer website of Ingenic: 12

17 Using ADB 5 Using ADB 5.1 For Linux Host i. /etc/udev/rules.d/51-android.rules Create /etc/udev/rules.d/51-android.rules if it is not existing. Add: SUBSYSTEM=="usb usb_device", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev" ii. Download SDK You can find it at: Figure 5-1 List of Android Linux SDK Please choose the certain version of SDK depend on you development enviroment. For example, choose adt-bundle-linux-x86_ zip for 64-bit version of Ubuntu. iii. Set up environment a. Decompress the zip file to the <ANDROID_SDK_INSTALL_PATH> directory. b. Modify ~/.bash_profile, add: export PATH=${PATH}:<ANDROID_SDK_INSTALL_PATH>/platform-tools c. Run "source ~/.bash_profile", or re login 5.2 For Windows Host 13

18 Using ADB i. Download SDK You can find it at: Figure 5-2 List of Android Windows SDK Please choose the certain version of SDK depend on you development enviroment. For example, choose adt-bundle-windows-x zip for 32-bit version of Windows. ii. Set up environment Take Windows7 for example. a. Right-click on Computer and choose Properties. b. Turn to table named Advanced system settings, open Environment Variables. c. Find and edit Path in System variables. d. Add the path of adb at the tail( ; should be added between values). iii. Check ADB version If the former step was correct, you will get the version of ADB by running adb version in cmd line. Figure 5-3 ADB version 5.3 ADB driver 1)Download Google USB driver From: 14

19 Using ADB Figure 5-4 Google USB driver Click Download Google USB Driver to download latest_usb_driver_windows.zip. 2)Install the driver Please find the detail at Android website 15

20

21 Customization 6 Customization 6.1 Customize Bootloader Logo i. Prepare an original jpg image of logo. Recommended to use a jpg picture which has same resolution with LCD screen and rename it to logo.jpg. For example, if the screen resolution of 288x192, please create a 288x192 jpg picture and saved as logo.jpg. ii. Generate logo.rle file Enter Android project root directory, and run $ cp logo.jpg kernel/drivers/video/img2rle $ cd kernel/drivers/video/img2rle $./img2rle logo.jpg logo.rle Rle file "logo.rle" will be generated. iii. Compiled into XBoot a. Copy logo.rle Enter Android project root directory, and run $ cp kernel/drivers/video/logo.rle bootable/bootloader/xboot/boot/logo $ cd bootable/bootloader/xboot $ mv boot/logo/logo.rle boot/logo/jz_logo.rle b. Modify logo configuration Open./Makefile in xboot and seek "newton_msc_config" will find the board-level configuration. Modify the logo file name under "newton_msc_config". For example, in newton_msc_config, changed as below: Figure 6-1 Modify the logo file in board-level config 17

22 Customization c. Re-compile XBoot $ make clean $ make newton_msc_config $ make iv. Burn the new mbr-xboot-gpt.bin into Newton. Boot logo customize is finished. 6.2 Customize Boot Animation i. Prepare the bootanimation picture Prepare the picture for each frame of bootanimation according the screen resolution. Name these pictures according to the playback order, such as all_0001.jpg, all_0002.jpg... and so on. ii. Prepare the directory for Compression $ mkdir bootanimation $ cd bootanimation $ mkdir part1 part2 $ cp../*.jpg part1 $ cp../*.jpe part2 Part1: First stage animation; part2: Looping animation $ touch desc.txt Edit desc.txt as below,save and quit p 1 0 part1 p 0 0 part2 The first line is the resolution and play time interval to the next picture. Make sure there no other files except of the above files above. Directory tree: desc.txt 18

23 Customization part1 all_0001.jpg all_0002.jpg all_0003.jpg part2 all_0001.jpg all_0002.jpg all_0003.jpg iii. Compressed bundle file directory structure $ zip -0 bootanimation.zip part1/*jpg part2/*jpg desc.txt iv. Replace boodanimation.zip of Android system. If bootanimation.zip is ready, copy it to /system/media/bootanimation.zip or /data/local/bootanimation.zip in Newton device. The customization of bootanimation is finished.. 19