Zynq ultrascale+ rfsoc (zu29/39/49dr) som development platform (61 pages)
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.
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 ..............................
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...
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...
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...
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.
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.
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 ...
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 ...
= <&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...
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.
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. ...
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 -...
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...
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.
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 ...
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.
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.
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 ...
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...
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 ...
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...
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.
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. ...
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 ...
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.
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 ...
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 ...
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...
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...
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...
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...
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.
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.
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.
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 ...
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...
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.
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 ...
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 >...
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...
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 ...
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.
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...
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. ...
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”...
Need help?
Do you have a question about the iW-RainboW-G15M and is the answer not in the manual?
Questions and answers