MYiR MYD-Y7Z010/007S User manual

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [e-mail] www.myirtech.com
MYD-Y7Z010/007S Board
Linux Development
Manual
V1.0

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [e-mail] www.myirtech.com
Revision History
Revision Date
Revised Contents
Version
Revised By
Reviewed By
2018.1.3
First Edition
V1.0

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 1/ 14
Table of Contents
TABLE OF CONTENTS ........................................................................................................................................ 1
CHAPTER 1 OVERVIEW AND INTRODUCTION OF SOFTWARE RESOURCE .......................................................... 2
1.1 OVERVIEW ........................................................................................................................................................ 2
1.2 SOFTWARE RESOURCES ....................................................................................................................................... 2
CHAPTER 2 BUILD LINUX DEVELOPMENT ENVIRONMENT ................................................................................ 3
2.1 ESTABLISHMENT WORKING DIRECTORY................................................................................................................... 3
2.2 SET CROSS COMPILE TOOL ................................................................................................................................... 3
2.3 INSTALL TOOL .................................................................................................................................................... 3
CHAPTER 3 LINUX SYSTEM COMPILE ................................................................................................................ 3
3.1 COMPILE BOOTLOADER ....................................................................................................................................... 3
3.2 COMPILE LINUX KERNEL....................................................................................................................................... 4
3.3 CREATE ROOT FILESYSTEM.................................................................................................................................... 4
3.4 MAKE FILE SYSTEM............................................................................................................................................. 5
3.4.1Make Ramdisk ........................................................................................................................................ 5
3.4.2Modify Rootfs.......................................................................................................................................... 6
CHAPTER 4 DOWNLOAD LINUX SYSTEM ........................................................................................................... 6
4.1 CREATE A MICRO SD CARD .................................................................................................................................. 6
4.2 PREPARE IMAGE FILE........................................................................................................................................... 7
4.3 START INSTALL ................................................................................................................................................... 8
CHAPTER 5 LINUX APPLICATION ....................................................................................................................... 8
5.1 LED ................................................................................................................................................................ 9
5.2 CAN ............................................................................................................................................................... 9
APPENDIX I DISCLAIMER ................................................................................................................................ 10
APPENDIX II TECHNICAL SUPPORT AND WARRANTY ...................................................................................... 11
APPENDIX III CONTACT US .............................................................................................................................. 14

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 2/ 14
Chapter 1 Overview and Introduction of Software Resource
1.1 Overview
MYD-Y7Z010/007S Board provides abundant hardware and software resource. This manual will
start from building the environment and introduce how to develop a MYD-Y7Z010/007S Board
Linux program step by step. The development commands of this manual are illustrated based-on
Ubuntu system.
1.2 Software Resources
Category
Name
Remark
Code
Tool
chains
gcc 4.6.1
gcc version 4.6.1
(Sourcery CodeBench Lite 2011.09-50)
Boot
loader
boot.bin
First bootstrap Include FSBL and u-boot
Yes
Linux
Kernel
Linux 3.15.0
Linux kernel customized for the
MYD-Y7Z010/007S Board hardware
Yes
Driver
USB host
USB host driver
Yes
Ethernet
Gigabit Ethernet driver(3 net interfaces)
Yes
MMC/SD/TF
MMC/SD/TF card driver
Yes
UART
UART driver
Yes
UARTlite
Uartlite serial driver
Yes
CAN
CAN driver
Yes
LCD
LCD driver
Yes
HDMI
HDMI driver
Yes
LED
LED driver
Yes
GPIO
GPIO driver
Yes
File
system
Ramdisk
Ramdisk image system
Rootfs
Made by Buildroot
Yes
Table 1-1

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 3/ 14
Chapter 2 Build Linux Development Environment
2.1 Establishment Working Directory
Copy the document in MYD-Y7Z010/007S Board DVD disk to the host:
$ mkdir -p <WORKDIR>
$ cp -a <DVDROM>/04-Linux_Source/* <WORKDIR>
2.2 Set Cross Compile Tool
$ cd <WORKDIR>/Toolchain
$ tar xvjf Sourcery_CodeBench_Lite_for_Xilinx_GNU_Linux.tar.bz2
$ export PATH=$PATH:<WORKDIR>/Toolchain/\
CodeSourcery/Sourcery_CodeBench_Lite_for_Xilinx_GNU_Linux/bin
$ export CROSS_COMPILE=arm-xilinx-linux-gnueabi-
After executing the "export" commands, input “arm” and then press the Tab key to check whether
or not the "export" settings has been executed successfully. These settings are only valid for the
current terminal; if it is required to keep them permanently, please add above commands to script
file: “~/.bashrc”
2.3 Install Tool
Install other necessary tools:
$ sudo apt-get install build-essential git-core libncurses5-dev \
flex bison texinfo zip tar zlib1g-dev gettext \
gperf libsdl-dev libesd0-dev libwxgtk2.6-dev \
uboot-mkimage \
g++ xz-utils
Chapter 3 Linux System Compile
3.1 Compile Bootloader
Enter Bootloader director, tar U-boot source code:
$ cd <WORKDIR>/Bootloader

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 4/ 14
$ tar jxvf u-boot-xlnx.tar.bz2
$ cd u-boot-xlnx
Compile the source code:
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi- distclean
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi-\
zynq_myd_config
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi-
After compiling, it will generate “u-boot” ELF files in the current directory.It is crucial to rename this
file to “u-boot.elf” when using this image to make “boot.bin”.
3.2 Compile Linux kernel
Enter the “Kernel”director, and tar the kernel source code:
$ cd <WORKDIR>/Kernel
$ tar xvjf linux-xlnx.tar.bz2
$ cd linux-xlnx
Compile the source code:
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi- distclean
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi- \
zynq_myd_defconfig
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi- uImage
$ make ARCH=arm CROSS_COMPILE=arm-xilinx-linux-gnueabi- dtbs
After compiling, it will generate the “uImage” in the “arch/arm/boot” directory and the
“zynq_myd.dtb” file in the “arch/arm/boot/dts/” directory.
3.3 Create Root Filesystem
Create rootfs using buildroot in here. Enter the file system directory, extract buildroot source:
$ cd <WORKDIR>/Filesystem
$ tar jxvf buildroot-2015.02.tar.bz2
$ cd buildroot-2015.02
Rename the zynq_myd_config to .config:
$ cp zynq_myd_config .config
Configure:
$ make menuconfig
Set the path of Toolchain:
Toolchain --- >

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 5/ 14
() Toolchain path
Enter Toolchain path option, fill in the Toolchain path:
<WORKDIR>/Toolchain/CodeSourcery/Sourcery_CodeBench_Lite_for_Xilinx_GNU_Lin
ux
Exit and make:
$ make
After compiling, you will find the rootfs.tar in the “buildroot-2015.02/output/images”.
3.4 Make File System
3.4.1Make Ramdisk
⑴Mount ramdisk
Create a new directory “tmp”, and copy the “uramdisk.image.gz” to this directory:
$ cd <WORKDIR>/Filesystem
$ mkdir tmp
$ cp uramdisk.image.gz tmp/
$ cd tmp/
Delete the 64 bytes header file generated by “mkimage”, and generate a new “ramdisk.image.gz”:
$ dd if=uramdisk.image.gz of=ramdisk.image.gz bs=64 skip=1
gunzip “ramdisk.image.gz” to generate “ramdisk.image”:
$ gunzip ramdisk.image.gz
Create a new mount directory "ramdiskdir", and mount the “ramdisk.image” file:
$ mkdir -p ramdiskdir
$ sudo mount -o loop,rw ramdisk.image ramdiskdir
Enter the “ramdiskdir” directory, and modify it if necessary.
⑵Generatea new ramdisk
Synchronize the file system and unmount the ramdisk file system:
$ sync
$ sudo umount ramdiskdir
Compress “ramdisk.image” with gzip, and generate “ramdisk.image.gz”:
$ gzip -9 ramdisk.image
Add new head file with mkimage, generate a new “uramdisk.image.gz” file for u-boot:
$ mkimage -A arm -T ramdisk -C gzip -n Ramdisk -d ramdisk.image.gz
uramdisk.image.gz
Delete temporary file “ramdisk.image.gz”:

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 6/ 14
$ rm ramdisk.image.gz
3.4.2Modify Rootfs
(1)Extract the tar :
$ cd <WORKDIR>/Filesystem
$ mkdir -p rootfs
$ sudo tar xvf rootfs.tar –C ./rootfs/
(2)Modifying Filesystem,add new file.
(3)Archive tar
$ cd ./rootfs
$ sudo tar cvf ../rootfs.tar ./*
Chapter 4 Download Linux System
In here, we will boot from Micro SD Card using Ramdisk, then install bootloader and kernel to
QSPI-Flash, install rootfs to eMMC.
4.1 Create a Micro SD Card
⑴TF card format
Please format the TF Card using the “HP USB Disk Storage Format Tool 2.0.6” tool in directory
“03-Tools” of the DVD disk.
①Insert the TF card into the USB card reader, then connect the card reader with a
computer;
②Open “HP USB Disk Storage Format Tool 2.0.6”. It will prompt up a dialog as the
following:

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 7/ 14
Figure 4-1
③Select the "FAT32" file system;
④click “Start”;
⑤After formatting accomplishes, click “OK”.
NOTE: The “HP USB Disk Storage Format Tool 2.0.6” Tool will clear all data in the TF card.
Please make backup before formatting.
4.2 Prepare Image File
Copy the image to the Micro SD Card which just create. You can find all of them in the CDROM.
Image
Description
boot.bin
This is the system startup program, including“fsbl”, and “u-boot”.
The specific building methods will be described in "
MYD-Y7Z010/007S Board Programmable Logic Development
Manual".
7z010.bit
XC7Z010 Bitstream File
7z007.bit
XC7Z007S Bitstream File
uImage
Linux kernel
devicetree.dtb
Device Tree
uramdisk.image.gz
Ramdisk file system

MYD-Y7Z010/007S Board Linux Development Manual
MYIR Electronics Limited | [email protected]om www.myirtech.com 8/ 14
uEnv.txt
U-boot Environment File
rootfs.tar
Root filesystem, it will copy to eMMC
Table 4-2
4.3 Start Install
⑴set sw1: 1 off, 2 on;
(2)Insert TF card which just copyed image. Connect the serial port, set baud rate to 115200,
then powered on;
(3) It will load into Ramdisk, Enter Linux command, keyin as follow:
welcome to myir board
myir login: root
[root@myir ~]#/updatesys.sh /mnt/mmcblk1p1
The script will be copy BOOT.bin, 7z010.bit/7z007.bit, devicetree.dtb and uImage into the
QSPI-Flash, copy the rootfs.tar to eMMC.
(4) After the programming is completed, set sw1: 1 on, 2 on, Power ON again.
Chapter 5 Linux Application
MYD-Y7Z010/007S Board provides demo programs for common peripherals. These programs
and source codes are storaged in the "<WORKDIR>/Examples/" directory. Please compile the
source codes according to the “Makefile” or “README” file in directory:
$ cd <WORKDIR>/Examples/
$ export CROSS_COMPILE=arm-xilinx-linux-gnueabi-
$ make
Connect J8, set the baud rate for 115200, 8 data bits, stop bits 1, no parity; Copy the
corresponding executable program to the development board. If the program can not be executed,
please execute the following command first:
# chmod +x <program-to-be-executed>