iWave iW-RainboW-G15M User Manual
Hide thumbs Also See for iW-RainboW-G15M:
Table of Contents

Advertisement

Quick Links

iW-RainboW-G15M Android User Manual
iW-RainboW-G15M
i.MX6 Qseven SOM Development platform
Android User Manual
REL 1.0
iWave Systems Technologies Pvt. Ltd.
Page 1 of 59

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the iW-RainboW-G15M and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for iWave iW-RainboW-G15M

  • Page 1 Android User Manual iW-RainboW-G15M i.MX6 Qseven SOM Development platform Android User Manual REL 1.0 iWave Systems Technologies Pvt. Ltd. Page 1 of 59...
  • Page 2 If you are not the intended recipient (or authorized to receive for the recipient), you are hereby notified that any disclosure, copying distribution or use of any of the information contained within this document is STRICTLY PROHIBITED. Thank you. “iWave Systems Tech. Pvt. Ltd.” REL 1.0 iWave Systems Technologies Pvt.
  • Page 3 (including liability to any person by reason of negligence) will be accepted by iWave Systems, its subsidiaries or employees for any direct or indirect loss or damage caused by omissions from or inaccuracies in this document.
  • Page 4: Table Of Contents

    Android User Manual Table of Contents INTRODUCTION ............................8 ................................8 URPOSE .................................. 8 COPE ..............................8 IST OF CRONYMS BOARD SUPPORT PACKAGE......................... 10 BSP D ............................10 RIVER DETAILS 2.1.1 BSP S ........................... 10 UPPORTED EATURES 2.1.2 D ..........................
  • Page 5 Android User Manual ..............................37 UDIO OUT ..............................38 LOCK ETTINGS USB OTG D ............................39 EVICE USB H – HID C ............................42 LASS 4.9.1 K ..............................42 OARD 4.9.2 M ..............................42 OUSE 4.10 ............................. 43 AVE TEST APPLICATION 4.10.1 UART I...
  • Page 6 Android User Manual List of Figures 1: B ..........................21 IGURE OOT DEVICE MEMORY LAYOUT 2: P ............................25 IGURE LATFORM ETECTION 3: B ........................... 25 IGURE INARY ROGRAMMING UCCEED 4: A ............................... 29 IGURE NDROID ESKTOP 5: L ..............................
  • Page 7 Android User Manual 44: M ............................ 50 IGURE AGNETOMETER SENSOR List of Tables 1: A & A ........................... 8 ABLE CRONYMS BBREVIATIONS 2: D ............................. 10 ABLE RIVER OURCE 3: D .............................. 12 ABLE EVICE TREE SOURCE 4: L ..............................
  • Page 8: Introduction

    1. INTRODUCTION Purpose The Purpose of this document is to help the software engineers to program and test the iW-RainboW-G15M-Q7 Android development platform and this will also guide to configure the Android development environment in the Host PC and build the board support package.
  • Page 9 Android User Manual Acronyms Abbreviations Serial Peripheral Interface UART Universal Asynchronous Receiver/Transmitter Universal Serial Bus USB OTG USB On The Go REL 1.0 iWave Systems Technologies Pvt. Ltd. Page 9 of 59...
  • Page 10: Board Support Package

    BSP Driver details This section explains about the features supported, the device driver details and path of the device drivers and device tree details in the iW-RainboW-G15M-Q7 BSP. 2.1.1 BSP Supported Features Refer the Software release note for the supported features in the BSP.
  • Page 11 Android User Manual File Path Description sound/soc/fsl/fsl_ssi.c SSI CPU DAI driver source file sound/soc/fsl/fsl_ssi.h SSI CPU DAI driver and SSI register definitions header file drivers/mxc/ipu3/ipu_common.c IPU common library functions drivers/mxc/ipu3/ipu_ic.c IPU IC base driver source file drivers/mxc/ipu3/ipu_disp.c IPU display functions source file drivers/mxc/ipu3/ipu_device.c...
  • Page 12: Device Tree Source Description

    Board file for i.MX6 Qseven iWG15 SOMs 2.1.3 Device tree source description This section explains about the device tree source code configuration and organization for iW-RainboW-G15M-Q7 platform. The device tree source codes will be available in below path of the Linux kernel.
  • Page 13 Android User Manual Non PMIC SOMs with CPU regulators in LDO bypass mode. imx6dls-iwg15m-q7_pmic_ldobypass.dts This device tree source file is for i.MX6 Duallite and solo PMIC SOMs with CPU regulators in LDO bypass mode. This device tree source file is for i.MX6 Quad and Dual PMIC imx6qd-iwg15m-q7_pmic_ldobypass.dts...
  • Page 14: Bsp Compilation

    Android User Manual BSP COMPILATION 2.2.1 Host Requirements  This document assumes that Ubuntu PC is used. Not a requirement, but the packages may be named differently and the method of installing them may be different.  The recommended minimum Ubuntu version is 14.04 or later.
  • Page 15: Android Build Procedure

     Since the iW-RainboW-G15M-Q7 Solo platform has only 512MB RAM, split the system.img and program for iW-RainboW-G15M-Q7 Solo platform only. Execute the below commands to split the system.img $ simg2img system.img system_raw.img $ dd if=system_raw.img of=system1.img bs=1M count=256 skip=0 $ dd if=system_raw.img of=system2.img bs=1M count=256 skip=256...
  • Page 16 Android User Manual $ dd if=system_raw.img of=system5.img bs=1M count=256 skip=1024 $ dd if=system_raw.img of=system6.img bs=1M count=256 skip=1280 $ rm system_raw.img Note: If path of the Android Source code directories contain any space, it may show an error while compiling.
  • Page 17: Bsp Standalone Compilation

    To export the Cross Compiler and tool chain path, execute the below command. $ export ARCH=arm $ export CROSS_COMPILE=arm-eabi- $ export PATH=$PATH:<Path to Android source code>/prebuilts/gcc/linux-x86/arm/arm-eabi-4.8/bin  To configure for iWave-G15M-Q7 platform, execute the below command. $ make mx6_iwg15m_q7_defconfig  To compile the u-boot source code, execute the below command. $ make ...
  • Page 18: Kernel

    To export the Cross Compiler and tool chain path, execute the below command. $ export ARCH=arm $ export CROSS_COMPILE=arm-eabi- $ export PATH=$PATH:<Path to Android source code>/prebuilts/gcc/linux-x86/arm/arm-eabi-4.8/bin  To configure for iWave-G15M-Q7 platform, execute the below command. $ make iw_rainbowg15m_q7_android_defconfig  To compile kernel, execute the below command. $ make ...
  • Page 19: Bsp Miscellaneous Settings And Configurations

    = <&pinctrl_uart5_4>; fsl,uart-has-rtscts; status = "okay"; 2.4.3 Default Linux boot logo To Enable Default Linux Boot logo, deselect “Standard 224-color iWave logo” in make menuconfig and compile again. Device Drivers ---> Graphics support ---> [*] Bootup logo ---> [ ] Standard 224-color iWave logo REL 1.0...
  • Page 20: Display Device On The Linux Image

    Android User Manual 2.4.4 Display device on the Linux Image This chapter describes how to set up the display device in the device tree. Here, the LCD display is connected with LVDS0 channel. The LCD display supports 800x480 resolution, RGB666 pixel format and 16 bpp.
  • Page 21: Binary Programming

    The MFG-Tool is a manufacturing tool from Freescale that runs under Windows. It is designed to program firmware to iW-RainboW-G15M-Q7 platforms for mass production.  For iW-RainboW-G15M-Q7 Solo platform, the system.img should be split for programming. To split the system.img file, refer the Android Build Procedure section in this document. ...
  • Page 22: Programming Device Selection

    Android User Manual 3.1.3 Programming Device Selection Select the vbs file according to the target devices as shown in the following table Table 4: List of VBS files Target device and boot storage VBS files i.Mx6Quad/Dual iW-G15M_Q7 board with LDO bypass mfgtool2-android-mx6qd-iwg15m-q7-ldobypass-spi.vbs...
  • Page 23 Android User Manual Target device and boot storage VBS files i.Mx6Solo iW-G15M_Q7 board with LDO bypass - mfgtool2-android-mx6s-iwg15m-q7-ldobypass -mSD.vbs Micro SD i.Mx6Solo iW-G15M_Q7 board with LDO active - mfgtool2-android-mx6s-iwg15m-q7-ldoactive-mSD.vbs Micro SD i.Mx6Solo iW-G15M_Q7 board with LDO bypass – mfgtool2-android-mx6s-iwg15m-q7-ldobypass -sSD.vbs Standard SD i.Mx6Solo iW-G15M_Q7 board with LDO active -...
  • Page 24: Programming The Binaries

    UART Setting and Powering ON iW-RainboW-G15D in iW-RainboW-G15D-QuickStartGuide document to connect debug UART and power ON procedure  Use USB type A to micro B cable to connect the iW-RainboW-G15M-Q7 platform with host PC via USB OTG port  The MFG-Tool package will be in the below path /<path...
  • Page 25: Limitations

    Android User Manual Figure 2: Platform Detection  Click on the Start button, MFG Tool will start programming binaries into boot device and the debug console will show the debug messages  After successfully programming the Android binaries into boot device, the progress bar will become Green colour and the status box will be shown “Done”...
  • Page 26 Android User Manual  If you stop the application in between of programming binaries and if you re-start, the application will try to continue from the point where you stopped before. But it is not guaranteed that it can continue successfully.
  • Page 27: Manual Sd Card Programming

    This section explains the step by step procedure to flash the binaries into micro SD card manually. 3.2.1 Requirements To program the binaries in SD card for iW-RainboW-G15M-Q7 platform, following Items are required:  Card reader for manual binary programming ...
  • Page 28: Binary Programming

    Android User Manual 3.2.3 Binary Programming  Remove and insert the SD card by using SD card reader to the PC. Execute mount command to see the attached nodes and mount points $ mount  SD card may attach to the dev nodes either sdb/sdc/sdd/sde. Assume the SD card is attached to /dev/sdb node.
  • Page 29: Android

    Android User Manual 4. Android This part of the document explains about testing the peripherals in Linux OS level for iW-RainboW-G15M-Q7 platform.  Connect debug UART with host PC and Power ON the iW-RainboW-G15M-Q7 platform. Refer the sections Debug UART Setting and Powering ON iW-RainboW-G15M-Q7 in iW-RainboW-G15M-QuickStartGuide document to connect debug UART and power ON procedure.
  • Page 30: Browser

    Android User Manual  The Application Screen will appear on the LCD as shown below Figure 6: Android application Screen1 Browser  The Chromium browser application is used to test the Ethernet functionality Figure 7: Browser  Before run the Browser application set the Proxy ...
  • Page 31: Gallery

    Android User Manual Figure 8: Browser Terms and Conditions  Set the time and date properly or else “your clock is behind” error message will be displayed on the browser.  Once everything is proper, the browser will search and display as shown below...
  • Page 32: Figure 10: Gallery

    Android User Manual Figure 10: Gallery  After opening the Gallery application, multimedia files of internal storage, micro SD card, Standard SD card, and USB memory stick will appear on screen as shown below Figure 11: Gallery with Multimedia Files ...
  • Page 33: Camera

    Android User Manual Camera  Click on the camera icon on the application screen as shown in the figure below. Figure 13: Camera application icon  The camera window will open as shown in the figure below. Figure 14: Camera window REL 1.0...
  • Page 34: Figure 15: Camera Options Icon

    Android User Manual  Click on the icon to view options. Figure 15: Camera options icon  Click on the icons in the below figure, to switch from image mode to video mode. Figure 16: Switch camera mode REL 1.0 iWave Systems Technologies Pvt.
  • Page 35: Figure 17: Switch Camera Icon

    Android User Manual  In video mode, the capture button is used to start and stop the video recording.  While Video Recording is going on if you click anywhere in the screen it will capture the image. ...
  • Page 36: Audio In Test

    Android User Manual Audio In Test  Connect Headset to Audio-out port  Go to Sound Recorder Folder to record and play the audio Figure 18: Sound Recorder  Press the start button to start the record Figure 19: Sound Recording Window - Start ...
  • Page 37: Audio Out Test

    Android User Manual  Click the play button to play the recorded audio Figure 21: Playing the Recorded Audio Audio out Test Note: Audio will not work in audio out port when HDMI is connected since by default HDMI audio will be selected.
  • Page 38: Clock Settings

    Android User Manual Clock Settings  Go to “Menu->Settings->Date & time” and deselect the “Automatic Date and Time” and “Automatic Time Zone” options Figure 23: Settings Menu Figure 24: Clock  Now using “Select Time Zone” option, set the time zone ...
  • Page 39: Usb Otg Device Test

    Android User Manual Figure 25: Alarm Settings  At the time of the alarm, a pop up message will appear and an alarming tone will be routed to Audio out. USB OTG Device Test OTG can be used as device. To use OTG as device execute the following steps ...
  • Page 40: Figure 27: Usb Otg Device - Host Pc

    Android User Manual Figure 27: USB OTG Device - Host PC  USB OTG connection options will be displayed as shown below Figure 28: USB OTG Device connection option  Select “Transfer files” option to mount the internal storage in PC with MTP mode. The mounted partition will be shown as below REL 1.0...
  • Page 41: Figure 29: Mounted Internal Storage Device

    Android User Manual Figure 29: Mounted Internal Storage device  Select “Transfer photos (PTP)” option to only mount Android Camera folder in Host PC REL 1.0 iWave Systems Technologies Pvt. Ltd. Page 41 of 59...
  • Page 42: Usb Host - Hid Class

    Android User Manual USB Host – HID Class 4.9.1 Key Board Test  Press arrow keys to navigate from one application to another application in android  Click on Chrome browser  Go to google.com and type by using the keyboard as shown below Figure 30: Keyboard Test 4.9.2 Mouse Test...
  • Page 43: Iwave Test Application

    Android User Manual 4.10 iWave test application  The iWave test application is used to test the UART, CAN and Sensors which are supported by iW-RainboW- G15M-Q7 platform  The icon of G15M-Q7-TestApp.apk as shown below Figure 32: iWave Test Application Icon 4.10.1 UART Interface...
  • Page 44: Figure 34: Uart Window

    Android User Manual  The supported UART devices and it’s nodes are listed below, UART 1 - /dev/ttymxc0 UART2 (debug) - /dev/ttymxc1 UART 4 - /dev/ttymxc3 UART 5 - /dev/ttymxc4  In case of data UART, Open another UART console in host PC and set the serial port settings as mentioned below.
  • Page 45: Figure 35: Uart Window-Options

    Android User Manual Figure 35: UART window-Options  Use the provided menu option’s to change the Baud rate and the UART device Figure 36: UART window-select device  Use the provided menu option’s to change the Baud rate. REL 1.0 iWave Systems Technologies Pvt.
  • Page 46: Can Interface

    Android User Manual Figure 37: UART window-change baud rate Note: The default UART baud rate is 9600bps and special characters are not supported through UART. 4.10.2 CAN Interface Note: If customer uses their own CAN device with the iW-Rainbow G15 platform then user has to take care of the particular CAN device application part.
  • Page 47: Light Sensor

     Data will appear on Receive Textbox. 4.10.3 Light Sensor  To test the light sensor, select the light sensor from iWave test application window.  The light sensor window will appear as shown below. Figure 40: Light Sensor ...
  • Page 48: Pressure Sensor

    Android User Manual 4.10.4 Pressure sensor  Click on the pressure sensor option to open the pressure sensor window. Figure 41: Pressure sensor  The pressure value is displayed in the text box.  Click on refresh button to update the pressure value 4.10.5 Temperature sensor...
  • Page 49: Accelerometer Sensor

    Android User Manual  The temperature value is displayed in Celsius and Fahrenheit. 4.10.6 Accelerometer sensor  Click on the Accelerometer sensor option to open the Accelerometer sensor window. Figure 43: Accelerometer sensor  The Accelerometer value is displayed in m/s2.
  • Page 50: Hdmi Test

    Android User Manual Figure 44: Magnetometer sensor  The magnetometer value is displayed in μT.  Click on refresh button to update the Magnetometer value 4.11 HDMI Test  To set the boot arguments for HDMI, refer Section HDMI Settings ...
  • Page 51: Command Line Test

    LVDS Back light Testing - Optional  The given BSP supports the LVDS backlight and power control through Qseven connector. This section explains how to test the LVDS backlight and power control in the iW-RainboW-G15M platform.  To enable the backlight, execute below command # echo 1 >...
  • Page 52: Pcie Device Test

    Android User Manual PCIe Device test  Connect the PCIe device in iW-RainboW-G15M-Q7 platform before powering ON.  To list out the PCIe device, connected with board, execute the below command. # /data/busybox lspci 00:00.0 Class 0604: 16c3:abcd 01:00.0 Class 0280: 1814:3090 REL 1.0...
  • Page 53: Boot Arguments

    Android User Manual 6. BOOT ARGUMENTS By default auto environment variable option is enabled in u-boot, the respective environment variables will be saved in respective the boot devices, like, SPI NOR Flash, SATA or SD/MMC. Micro SD boot ...
  • Page 54: Sata Boot

    Android User Manual androidboot.storage_type=emmc cma=198M androidboot.selinux=permissive androidboot.dm_verity=disabled iWave-G15> setenv bootcmd boota mmc2 iWave-G15> saveenv  To boot the platform, execute the below command iWave-G15> boot SATA boot  To load the kernel and file systems from the SATA, the environment variables should be set as shown below.
  • Page 55: Dual Disaplay

    Android User Manual iWave-G15> saveenv iWave-G15> boot  Set the following boot arguments to configure HDMI as default display with 1080p resolution in U-boot command prompt iWave-G15> setenv bootargs console=ttymxc1,115200 init=/init video=mxcfb1:off video=mxcfb0:dev=hdmi,1920x1080M@60,if=RGB24,bpp=24 vmalloc=400M androidboot.console=ttymxc1 consoleblank=0 androidboot.hardware=freescale androidboot.storage_type=emmc cma=198M androidboot.selinux=permissive...
  • Page 56: Optional Features Settings

    1 iWave-G15> saveenv 6.8.1 Permanent MAC address This section will have the information to set permanent MAC address for the iW-RainboW-G15M-Q7 platform in u- boot level. Note: This is one time programmable. Not possible to revert back. ...
  • Page 57: Appendix

    Refer the section Powering ON iW-RainboW-G15D of Quick Start Guide for iW-RainboW-G15M-Q7 platform power ON procedure. 2. How to connect the Debug port of iW-RainboW-G15M-Q7 with host PC? What are the settings to be done in host side to connect the debug port of iW-RainboW-G15M-Q7 platform? Refer the section Debug UART Setting of Quick Start Guide for iW-RainboW-G15M-Q7 platform debug port connection procedure.
  • Page 58 14. How to connect ADB to iW-RainboW-G15M-Q7 platform via USB?  Connect the USB OTG cable between host pc and iW-Rainbow-G15M-Q7 board  Add the following rules for udev rule in “/etc/udev/rules.d/51-android.rules” SUBSYSTEM==”usb”, SYSFS{idVendor}==”18d1”, MODE=”0777” SUBSYSTEM==”usb|usb_device”, ATTR{idVendor}==”18d1”, MODE=”0666”, GROUP=”plugdev”...
  • Page 59 Android User Manual  Keep the board connecting with USB to the PC, and enable the ‘USB debugging’ from “Setting->About tablet” options and then press 7 times for “Build number” and see the pop-up message on the display like “you are now developer”...

Table of Contents