iWave iW-RainboW-G17D User Manual

iWave iW-RainboW-G17D User Manual

Table of Contents

Advertisement

Quick Links

iW
iW-RainboW-G17D Linux User Guide
iW-RainboW-G17D
Cyclone V Qseven SOM Development Platform
Linux User Guide
Rev 1.0
iWave Systems Technologies Pvt. Ltd.
Page 1 of 55

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for iWave iW-RainboW-G17D

  • Page 1 Linux User Guide iW-RainboW-G17D Cyclone V Qseven SOM Development Platform Linux User Guide Rev 1.0 iWave Systems Technologies Pvt. Ltd. Page 1 of 55...
  • Page 2 STRICTLY PROHIBITED. Thank you. “iWave Systems Tech. Pvt. Ltd.” Rev 1.0 iWave Systems Technologies Pvt. Ltd.
  • Page 3 Linux User Guide Disclaimer iWave Systems reserves the right to change details in this publication including but not limited to any Product specification without notice. No warranty of accuracy is given concerning the contents of the information contained in this publication.
  • Page 4: Table Of Contents

    Linux User Guide Table of Contents 1 INTRODUCTION ..........................9 1.1 Purpose ............................9 1.2 Scope ..............................9 2 BSP COMPILATION ........................10 2.1 Host Requirements .......................... 10 2.2 Host package installation ......................... 10 2.3 BSP source & cross compiler installation ..................10 2.4 Yocto Installation ..........................
  • Page 5 Linux User Guide 5.1.1 SD/USB Host Test ........................24 5.2 Network Devices Test........................25 5.2.1 Ethernet Test ..........................25 5.2.1.1 File transfer using TFTP server ................... 26 5.2.1.2 Folder Mount from NFS...................... 26 5.2.2 CAN Test ............................. 26 5.3 Display Devices Test ......................... 28 5.3.1 LCD Back light Testing .........................
  • Page 6 Linux User Guide 15 FREQUENTLY ASKED QUESTIONS ....................54 Rev 1.0 iWave Systems Technologies Pvt. Ltd. Page 6 of 55...
  • Page 7 Linux User Guide List of Figures Figure 1: Boot device memory layout ......................15 Figure 2: Binary Programming script ......................16 Figure 3: Flashing SD card Warning ......................17 Figure 4: Binary programming Partition Table ..................17 Figure 5: Binary programming finished message ..................18 Figure 6: LCD Image Dump ........................
  • Page 8 Linux User Guide List of Tables Table 1: Basic Settings ..........................53 Table 2: Boot settings ..........................53 Table 3: Peripheral connections ......................... 53 Rev 1.0 iWave Systems Technologies Pvt. Ltd. Page 8 of 55...
  • Page 9: Introduction

    Linux User Guide 1 INTRODUCTION 1.1 Purpose The Purpose of this document is to help the software engineers to program and test the iW-RainboW- G17M-Q7 Linux development platform and this will also guide to configure the Linux development environment in the Host PC and build the board support package.
  • Page 10: Bsp Compilation

    Linux User Guide 2 BSP COMPILATION 2.1 Host Requirements  A Linux host PC with latest version (ex. Ubuntu version 12.04)  Root permission on the Development Host.  Cross compiler package for iW-RainboW-G17M-Q7. 2.2 Host package installation ...
  • Page 11: Yocto Installation

    Linux User Guide  Execute the following command to install the yocto Source package in desired folder. host@host/$ ./Linux-iwg17m_iW-PREDZ-SC-01-R1.0-REL1.0.bsx G17M-BSP  The Cross-compiler and source code packages are deployed into below path <Path to G17M-BSP>/G17M-BSP/ 2.4 Yocto Installation ...
  • Page 12: Standalone Compilation

    To export the Cross Compiler and tool chain path, execute the below command. host@host/<directory>/uboot-iwg17m ~$export PATH=$PATH:<Path to G17M- BSP>/G17M-BSP/linaro/gcc-linaro-arm-linux-gnueabihf-4.7-2012-11- 20121123_linux/bin host@host/<directory>/uboot-iwg17m ~$export CROSS_COMPILE=arm-linux-gnueabihf- host@host/<directory>/uboot-iwg17m ~$export ARCH=arm  To configure for iWave-G17M-Q7 platform, execute the below command. Rev 1.0 iWave Systems Technologies Pvt. Ltd. Page 12 of 55...
  • Page 13: Linux Kernel

    Linux User Guide host@host/<directory>/uboot-iwg17m ~$make socfpga_iwg17m_q7_config  To compile the u-boot source code, execute the below command. host@host/<directory>/uboot-iwg17m ~$make  After successful compilation, boot loader image (u-boot.img) and pre-loader raw image will be created in below path. <Path to uboot-iwg17m>/uboot-iwg17m/u-boot.img <Path to uboot-iwg17m>/uboot-iwg17m/spl/u-boot-spl.bin...
  • Page 14: Pre-Loader Binary Generation

    Linux User Guide  After successful compilation, kernel image (zImage) and device tree (.dtb) image will be created in the below path. ~/linux-iwg17m/arch/arm/boot/zImage ~/linux-iwg17m/arch/arm/boot/dts/iwg17m_q7.dtb  Refer the BINARY PROGRAMMING section to update the Linux kernel binary. 2.7 Pre-loader binary generation Pre-loader update on the source code is recommended on every changes of FPGA binary/FPGA project only.
  • Page 15: Binary Programming

    Linux User Guide 3 BINARY PROGRAMMING The mksdboot_iwg17m.sh is a shell script which runs in a linux system and is used to partition the standard SD card and program the binaries in to the card. 3.1 Requirements To program the binaries for iW-RainboW-G17M-Q7 platform, following Items are required: ...
  • Page 16: Figure 2: Binary Programming Script

    Linux User Guide  The programming script will be in below path of the deliverables. <path to iW-RainboW-G17M-Q7-Rx.x-RELx.x-LinuxDeliverables>/iW-RainboW-G17M-Q7- Rx.x-RELx.x-LinuxDeliverables/Tools/ProgrammingScript/mksdboot_iwg17m.sh  Copy the programming script file into local directory and change the permission. host@host~$ chmod +x mksdboot_iwg17m.sh  Execute the below command to program the binaries into SD card.
  • Page 17: Figure 3: Flashing Sd Card Warning

    Linux User Guide Figure 3: Flashing SD card Warning  Press enter key to start flashing the SD card, and copy the binaries in the SD card.  The following Figure shows the partition details during binary programming. Figure 4: Binary programming Partition Table ...
  • Page 18: Figure 5: Binary Programming Finished Message

    Linux User Guide Figure 5: Binary programming finished message  To power on the board, refer the section Powering ON iW-RainboW-G17D in iW-RainboW- G17D-QuickStartGuide document. Rev 1.0 iWave Systems Technologies Pvt. Ltd. Page 18 of 55...
  • Page 19: Boot Testing And Boot Configuration

    Standard SD (default)  Connect debug UART with host PC and Power ON the iW-RainboW-G17M-Q7 platform. Refer the sections Debug UART Setting and Powering ON iW-RainboW-G17D in iW-RainboW-G17D- QuickStartGuide document to connect debug UART and power ON procedure.  To enter in boot loader console, refer the Linux Test Environment section in iW-RainboW- G17D-QuickStartGuide document to get the boot loader console.
  • Page 20: Basic Device Tests

    Linux User Guide 4.2 Basic Device Tests In U-Boot level, the supported devices are    Ethernet Note: To know about the procedure for connecting the peripherals to iW-RainboW-G17M-Q7 platform refer GenericQsevenCarrierBoard-HardwareUserGuide document. 4.2.1 RAM test  In iW-RainboW-G17M-Q7 platform RAM physical address is from 0x00000000 to 0x1FFFFFFF.
  • Page 21: Ethernet Test

    Linux User Guide Name: 00000 Tran Speed: 50000000 Rd Block Len: 512 SD version 2.0 Clock: 50000000 High Capacity: No Capacity: 974.5 MiB Bus Width: 1-bit  To list the files in the SD card, execute the below command.
  • Page 22: Environment Variable Setting

    Linux User Guide iWave-G17M >ping <any_ip_addr> Example iWave-G17M >ping ************ Using miio device host *********** is alive 4.3 Environment variable setting 4.3.1 SD boot  SD booting is the default boot mode for the iW-RainboW-G17M-Q7 platform.  To load the kernel and file systems from the SD, the environment variables should be set as shown below.
  • Page 23: Optional Features Settings

    Linux User Guide 4.3.3 Optional features settings  By default Dual core will be in active state. To limit the no of processors add the below string in the boot arguments. maxcpus=<maximum no of cpu to be active> Example iWave-G15 >setenv bootargs_mmc 'setenv bootargs ${bootargs_base}...
  • Page 24: Linux Peripheral Test

    G17M-Q7 platform.  Connect debug UART with host PC and Power ON the iW-RainboW-G17M-Q7 platform. Refer the sections Debug UART Setting and Powering ON iW-RainboW-G17D in iW-RainboW-G17D- QuickStartGuide document to connect debug UART and power ON procedure.  To enter in boot loader console, refer the section Linux Test Environment section in iW- RainboW-G17D-QuickStartGuide document to get the Linux console ...
  • Page 25: Network Devices Test

    Linux User Guide  To create a directory and remove a directory from the mounted partition, execute below commands respectively. root@iWave-G17M/<mount_directory>$mkdir <directory_name> root@iWave-G17M/<mount_directory>$rm –rf <target_directory>  To copy a file to the mounted partition, execute below command. root@iWave-G17M/<mount_folder>$cp <soruce_file> <Destination>...
  • Page 26: File Transfer Using Tftp Server

    5.2.1.2 Folder Mount from NFS  To mount any folder from NFS server (Host PC) to iW-RainboW-G17M-Q7 platform, execute the below command root@iWave-G15M~$mount -o nolock -t nfs <server_ip>://<filepath> /mnt/floppy  To view the NFS mounted files and folders, execute below command. root@iWave-G15M~$ls /mnt/floppy/ 5.2.2 CAN Test...
  • Page 27 Also the application will not display the received data.  To transmit the data, execute the below command. root@iWave-G17M:~#cansend <candev_no> 0x11 0x22 0x33 0x44 0x55 0x66 0x77 0x88  To disable the CAN modules, execute the below command.
  • Page 28: Display Devices Test

    Linux User Guide 5.3 Display Devices Test The iW-RainboW-G17M-Q7 platform will support the below display devices.  LCD (LVDS - 0)  5.3.1 LCD Back light Testing  The LCD back light has been controlled using PWM.  To disable/enable the backlight, execute the below command respectively.
  • Page 29: Hid Devices Test

    Linux User Guide Figure 6: LCD Image Dump 5.4 HID Devices Test The iW-RainboW-G17M-Q7 platform will support the below Human Interface devices.  USB HID devices Testing device Requirements To test the Human Interface Devices supported by iW-RainboW-G17M-Q7 platform, following Items are required.
  • Page 30: Mouse

    Linux User Guide 5.4.1.1 Mouse  Insert the USB Mouse in iW-RainboW-G17M-Q7 platform USB slot. The following message will be displayed in command prompt. usb 1-1.4: new low speed USB device number 6 using dwc2 usb 1-1.4: New USB device found, idVendor=046d, idProduct=c05a usb 1-1.4: New USB device strings: Mfr=1,Product=2,SerialNumber=0...
  • Page 31: Uart Test

    Linux User Guide B: ABS=2618000 3 Note: In the above log touch device is detected as input0 indicated in bold. So in the script file “export TSLIB_TSDEVICE” is modified as shown below. root@socfpga~$export TSLIB_TSDEVICE=/dev/input/event0 root@socfpga~$cat /dev/input/event0&  To exit from this test case, execute below command and then press ctrl+‘c’.
  • Page 32: I2C Test

    Linux User Guide Example root@iWave-G17M:~# stty –F /dev/ttyS1 115200  The tested Baud rates are given below: 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 & 230400 5.6 I2C Test  To list out supported i2c buses, execute the below cooommand.
  • Page 33: Appendix A - Network Speed And Duplex Settings

    Linux User Guide 6 APPENDIX A - NETWORK SPEED AND DUPLEX SETTINGS  The “ethtool” utility used to query and change settings such as speed, auto- negotiation and checksum offload on many network devices, especially Ethernet devices.  This section explains how to set the ethernet speed to 10/100/1000 Mbps or half/full duplex in the iW-RainboW-G17M platform.
  • Page 34: Appendix B - Proxy Setting

    Linux User Guide 7 APPENDIX B - PROXY SETTING  The Ubuntu package manager requires network access to download packages.  If the Ubuntu host is on a network that requires a network proxy, this can be configured in the Gnome menu option "System ->...
  • Page 35 Linux User Guide  Close all the old terminal windows and open a new terminal window to get the new values.  To check the settings, execute the below command. user@ubuntu:~$ env | grep proxy http_proxy=http://example:8000/ ftp_proxy=ftp://example:8000/ https_proxy=https://example:8000 Rev 1.0 iWave Systems Technologies Pvt.
  • Page 36: Appendix C - Tftp & Nfs Server Configuration

    Linux User Guide 8 APPENDIX C - TFTP & NFS SERVER CONFIGURATION This section describes to setup a TFTP server and NFS server Ubuntu Linux distributions.  The following host pc setup is required only once per host. ...
  • Page 37: Nfs

    Linux User Guide  Change the ownership of the directory. $ sudo mkdir /tftpboot $ sudo chmod -R 777 /tftpboot $ sudo chown -R <user_name>:<user_name> /tftpboot  Start the tftp services, $ sudo service xinetd stop $ sudo service xinetd start ...
  • Page 38: Appendix D - Lcd Raw Image Generation

    Linux User Guide 9 APPENDIX D – LCD RAW IMAGE GENERATION The FPGA LVDS frame reader supports 24bpp image format. But the frame reader will read 32bits from the buffer memory to process every pixel. It is necessary to convert 24bit data into 32 bit data by adding 1 byte on the MSB side.
  • Page 39: Appendix E - Application Compilation

    Linux User Guide 10 APPENDIX E – APPLICATION COMPILATION Application compilation for iW-RainboW-G17M platform To run any application in the G17M platform, it is necessary to compile the application with G17M cross- compiler.  Create one application called test.c ...
  • Page 40: Appendix F - Manual Binary Programming

    This section explains the step by step procedure to flash the binaries into SD card manually. 11.1 SD card partition Note: Refer this section, if a New Standard SD card is using or the iWave provided SD card is corrupted. This chapter describes the steps to prepare an SD card to boot the iW-RainboW-G17M-Q7 platform.
  • Page 41 Linux User Guide  Press 'p' to create primary partition. Give 1 as partition number. Then give first cylinder as ‘5’(Based on the total cylinders we have to change the size) Because first 5 cylinders are used to save U-Boot environmental variables and Last cylinder as half of displayed size (e.g below case...
  • Page 42 Linux User Guide Hex code (type L to list codes): 6 Changed system type of partition 1 to 6 (FAT16) Command (m for help): t Partition number (1-4): 2 Hex code (type L to list codes): 83 Command (m for help): t...
  • Page 43: Manual Binary Programming

    Linux User Guide 11.2 Manual binary programming  Insert SD card 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 44: Appendix G - Eds Tool Installatoin

    Linux User Guide 12 APPENDIX G – EDS TOOL INSTALLATOIN The pre-loader can be generated using EDS tool. This section describes step by step procedure to install the EDS tool. The EDS tool can be downloaded from the below link.
  • Page 45: Figure 10: Eds Tool Installation-2

    Linux User Guide  Accept the agreement and select for next step as mentioned below Figure 10: EDS Tool installation-2  Select a directory to install the EDS tool as mentioned below. Figure 11: EDS Tool installation-3 Rev 1.0 iWave Systems Technologies Pvt.
  • Page 46: Figure 12: Eds Tool Installation-4

    Linux User Guide  Select for SoC Embedded Design Suite (EDS) option as mentioned below. Figure 12: EDS Tool Installation-4  EDS package will be unpackaged into selected directory as shown below. Figure 13: EDS Tool Installation-5 Rev 1.0 iWave Systems Technologies Pvt.
  • Page 47: Figure 14: Eds Tool Installation-6

    Linux User Guide  Un select the Launch DS-5 installation and finish the installation as mentioned below Figure 14: EDS Tool Installation-6 Rev 1.0 iWave Systems Technologies Pvt. Ltd. Page 47 of 55...
  • Page 48: Appendix H - Pre-Loader Source Generation

    Linux User Guide 13 APPENDIX H – PRE-LOADER SOURCE GENERATION Pre-loader update on the source code is recommended on every changes of FPGA binary/FPGA project only. The pre-loader binary has to be changed in case of pre-loader source code update.
  • Page 49: Figure 16: Bsp Editor-2

    Linux User Guide  In the BSP Editor, select File -> New BSP Figure 16: BSP Editor-2  Click the browse button to browse to the handoff folder. Figure 17: BSP Editior-3 Note : The Path of Handoff folder is given Below: <Path to G17M-EDS>/G17M-EDS/iW-PREDZ-SY-01-R1.0-...
  • Page 50: Figure 18: Bsp Editor-4

    Linux User Guide  Select the handoff folder path and click open as mentioned below. Figure 18: BSP Editor-4  The New BSP window will have all the settings populated, based on the handoff folder. Accept the default settings and click OK. This will close the window.
  • Page 51: Figure 20: Bsp Editor-6

    Linux User Guide  In the BSP Editor window, edit any settings if necessary, and then click Generate. Figure 20: BSP Editor-6  The message panel on the bottom will indicate the status of the generation. Click Exit to close the BSP Editor.
  • Page 52 Linux User Guide  The FPGA project will updates the pre-loader SDRAM files. These file will be located in the below path <path to G17M-EDS>/G17M-EDS/iW-PREDZ-SY-01-R1.0- REL1.0/hps_isw_handoff/soc_system_hps_0/  The FPGA project SDRAM files are listed below and copy these files into following path <path to uboot-iwg17m>/uboot-iwg17m/board/altera/socfpga_iwg17m_q7/sdram/...
  • Page 53: Appendix I - Quick Reference

    Linux User Guide 14 APPENDIX I – QUICK REFERENCE 14.1 Serial port settings iW-RainboW-G17M-Q7 basic settings Refer the below sections for iW-RainboW-G17D platform basic settings and host serial port settings. Table 1: Basic Settings Section Document Name Powering ON iW-RainboW-G17D...
  • Page 54 Linux User Guide 15 FREQUENTLY ASKED QUESTIONS 1. How to power ON the iW-RainboW-G17M-Q7 platform? Refer the section Serial port settings iW-RainboW-G17M-Q7 basic settings for iW-RainboW-G17M- Q7 platform power ON procedure. 2. How to connect the Debug port of iW-RainboW-G17M-Q7 with host PC / What are the settings...
  • Page 55 Linux User Guide iWave-G17M >env default -f -a 8. Why LCD display going off after some time, if the iW-RainboW-G15M-Q7 platform kept power ON for more than 15 minutes? If you keep the iW-RainboW-G17M-Q7 platform in power ON condition for more than 15 minutes, execute the following command.

Table of Contents