Eurotech Adbc7519 Owner's manual

Wind River Linux BSP for Adbc7519

QorIQ-module

SOFTWARE MANUAL

Rev.2 – March 2014 – Z32013A0-MN002-01_SWMan_En_2

[Insert the picture here]

©

2014 Eurotech

Revision history

Revision

Description Date

1

First release

18 December 2013

2

Chapter 5.1 was revised.

6 March 2014

Wind River Linux BSP for Adbc7519 Software manual Table of contents

3

Z32013A0-MN002-01_SWMan_En_2

Table of contents

Revision history ........................................................................................................................................................... 2

Table of contents .......................................................................................................................................................... 3

1. Outline ........................................................................................................................................................................ 5

2. Installing the BSP ...................................................................................................................................................... 6

3. Preparation to start Wind River Linux on Adbc7519 ............................................................................................. 7

3.1. Creating a Wind River Linux image file ................................................................................................................ 7

3.2. Preparing boot file .............................................................................................................................................. 16

3.3. Connecting console ............................................................................................................................................ 16

3.4. Connecting network ............................................................................................................................................ 16

3.5. Setting of U-Boot ................................................................................................................................................ 17

3.5.1. Setting for booting from SD card ................................................................................................................ 18

3.5.2. Setting for booting from USB memory ....................................................................................................... 20

3.5.3. Setting for starting from network ................................................................................................................ 21

4. Booting the Wind River Linux for Adbc7519 ........................................................................................................ 22

5. RTC ........................................................................................................................................................................... 24

5.1. Setting of time and date ...................................................................................................................................... 24

5.2. Acquiring time and date ...................................................................................................................................... 24

6. SD card ..................................................................................................................................................................... 25

7. USB device............................................................................................................................................................... 26

8. SPI-Flash .................................................................................................................................................................. 27

8.1. SPI-Flash erase .................................................................................................................................................. 27

8.2. SPI-Flash mount ................................................................................................................................................. 27

9. EEPROM ................................................................................................................................................................... 28

10. Serial port............................................................................................................................................................... 29

11. PCI Express ........................................................................................................................................................... 30

12. Ethernet .................................................................................................................................................................. 31

12.1. Network setting ................................................................................................................................................ 31

Notes ............................................................................................................................................................................ 33

Wind River Linux BSP for Adbc7519 Software manual Outline

5

Z32013A0-MN002-01_SWMan_En_2

1. Outline

This manual describes the BSP (Board Support Package) for executing Wind River Linux (hereinafter referred to

as WRLinux) on the Adbc7519 COM Express CPU board based on Freescale QorIQ (P2020) processor.

The BSP is necessary to execute WRLinux on the Adbc7519 and acts as the interface to hardware among the

WRLinux components.

This BSP includes, in addition to WRLinux kernel image, device tree and root file system, layers and other

components necessary to create projects for Adbc7519 on a development environment “Wind River Workbench”.

It is possible to structure WRLinux to make it suitable for Adbc7519 by preparing both this BSP and development

environment provided by WindRiver.

The BSP does not include the development environment. In order to carry out development using the BSP, you

need to purchase the Workbench for WRLinux from Wind River. Please note that this BSP is compliant with GPL,

and may be redistributed freely.

This BSP supports WRLinux4.3 and SMP.

This manual describes an example of using Ubuntu 10.4 on a host Linux system.

Installing the BSP Wind River Linux BSP for Adbc7519 Software manual

6

Z32013A0-MN002-01_SWMan_En_2

2. Installing the BSP

This chapter describes how to install the BSP into the host Linux system.

The BSP is designed on the condition of being used in the Workbench, the development environment for

WRLinux running on Linux.

When using the Workbench, the layer (src/adbc7519.tar.bz2) on the accompanying CD is only used.

1. Copy the layer file to any directory on a PC with the Workbench installed.

Ex) $ mkdir ~/WindRiver/advanet/layer

$ cp " mount destination of the accompanying CD "/src/adbc7519.tar.bz2

~/WindRiver/advanet/layer

2. Decompress the copied adbc7519.tar.bz2.

Ex) $ tar jxvf adbc7519.tar.bz2

Now the installation has been completed.

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

7

Z32013A0-MN002-01_SWMan_En_2

3. Preparation to start Wind River Linux on Adbc7519

This section describes how to create a WRLinux image file required for executing WRLinux on the Adbc7519.

The default WRLinux image is contained in /bin in the accompanying CD.

3.1. Creating a Wind River Linux image file

Here is the procedure of creating with Workbench.

1. Start Workbench.

2. Click [File]  [New]  [Project…] in the Workbench menu bar.

3. Select [Wind River Linux]  [Wind River Linux Platform Project], and click the [Next] button.

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

8

Z32013A0-MN002-01_SWMan_En_2

4. Specify the project name and click the [Next] button.

5. Click the [<<Advanced], and then click the [Add] button in the dialog box shown below.

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

9

Z32013A0-MN002-01_SWMan_En_2

6. Select the directory where adbc7519.tar.bz2 layer was decompressed in (2. Installing the BSP, page 6), and

click the [OK] button.

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

10

Z32013A0-MN002-01_SWMan_En_2

7. Click the [Reload] button to read the layer.

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

11

Z32013A0-MN002-01_SWMan_En_2

8. Specify “adbc75xx” in [Board:], “glibc_small” in [RootFS:], and “standard“ in [Kernel:].

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

12

Z32013A0-MN002-01_SWMan_En_2

9. “ROOTFS:debug” and “ROOTFS:demo” configured by default are unneeded applications. Delete them. And

then click [Template… ].

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

13

Z32013A0-MN002-01_SWMan_En_2

10. Select a template. In this example, the test application template used for testing by Eurotech is selected.

Check “feature/test_tools”, and click [OK].

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

14

Z32013A0-MN002-01_SWMan_En_2

11. Make sure that “feature/test_tools” is selected, and click the [Next] button.

12. Click the [Finish] button to complete the project creation.

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

15

Z32013A0-MN002-01_SWMan_En_2

13. Select the created project in Project Explorer, and right-click to select [Build Project].

14. Once WRLinux is built, the execution images are created in the locations below.

o Kernel image

" Workspace in the workbench "/adbc7519_prj/build/linux-adbc75xx-standard-build/

arch/powerpc/boot/uImage

o Device tree

" Workspace in the workbench "/adbc7519_prj/build/linux-adbc75xx-standard-build/

arch/powerpc/boot/adbc7519.dtb

o Root file system

" Workspace in the workbench "/adbc7519_prj/export/

adbc75xx-standard-glibc_small-dist.tar.bz2

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

16

Z32013A0-MN002-01_SWMan_En_2

3.2. Preparing boot file

The eMMC Flash memory of the Adbc7519 has U-Boot in it. WRLinux boots up by loading WRLinux kernel

image and device tree using the U-Boot commands.

<<Note>>

Set SW1 to OFF to start the U-Boot from the eMMC Flash memory.

3.3. Connecting console

The RS-232C serial console is used as a console in the WRLinux of the BSP. Connect the COM0 serial port of

the Adbc7519 and a PC in which character terminal (dumb terminal) or terminal software such as hyper terminal

operates with a RS-232C cross cable.

Communication conditions of the serial port are as follows:

baud rate : 115200

character length : 8bit

parity bit : nil

stop bit : 1

flow control : nil

3.4. Connecting network

You can boot up WRLinux via a network by connecting a Ethernet hub or router connected to a host computer

and ETHERNET1 of the Adbc7519 with an Ethernet cable.

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

17

Z32013A0-MN002-01_SWMan_En_2

3.5. Setting of U-Boot

Connect the console and power on the Adbc7519 to start U-Boot as follows.

U-Boot 2009.11 (Aug 30 2011 - 17:20:07)

CPU0: P2020E, Version: 2.0, (0x80ea0020)

Core: E500, Version: 5.0, (0x80211050)

Clock Configuration:

CPU0:1000 MHz, CPU1:1000 MHz,

CCB:500 MHz,

DDR:333.333 MHz (666.667 MT/s data rate) (Asynchronous), LBC:31.250 MHz

L1: D-cache 32 kB enabled

I-cache 32 kB enabled

Board: Adbc7519

I2C: ready

SPI: ready

DRAM: 2 GB

L2: 512 KB enabled

MMC: FSL_ESDHC: 0

PCIE1 used as Root Complex (base addr ffe0a000)

Scanning PCI bus 01

PCIE1 on bus 00 - 01

PCIE2 used as Root Complex (base addr ffe09000)

PCIE2 on bus 02 - 02

PCIE3 used as Root Complex (base addr ffe08000)

PCIE3 on bus 03 - 03

In: serial

Out: serial

Err: serial

Net: eTSEC1, eTSEC2, eTSEC3

Hit any key to stop autoboot: 1

With the default settings, WRLinux boots from the SD card in 1 second.

You can change the setting by command prompt after cancelling the autoboot by key input from the serial

console within 1 second from U-Boot start.

WRLinux kernel image and device tree can be loaded in the following ways.

 From SD card (EXT3 format) [Default setting]

 From USB memory (EXT3 format)

 From a host Linux system via network (TFTP)

The root file system must be stored in the devices mentioned above.

 Mount the root file system stored in SD card (EXT3 format).

 Mount the root file system stored in USB memory (EXT3 format).

 Mount the root file system stored in a host Linux system via network by NFS.

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

18

Z32013A0-MN002-01_SWMan_En_2

3.5.1. Setting for booting from SD card

Create a bootable SD card on a host Linux system in the following way.

1. Set an SD card in the host Linux system, and create a partition table in the SD card using the fdisk

command.

An example is shown below.

o In the following explanations, the SD card inserted in the host Linux system is named /dev/sdb for

convenience. The device name depends on the host Linux environment. Please change it according to

your environment.

1) Execute the fdisk command.

$ sudo fdisk /dev/sdb

2) SD cards on the market are usually formatted with FAT16 or FAT32. Delete the existing partition table.

Command (m for help): d  If there are 2 or more partitions, delete them all.

3) Create a partition table.

Command (m for help): n

Command action

e extended

p primary partition (1-4)

p

Partition number (1-4): 1

First cylinder (1-3871, default 1):

Using default value 1

Last cylinder or +size or +size{K,M,G} (1-3871, default 3871):

Using default value 3871

4) Write the partition table settings.

Command (m for help): w

The partition table has been altered!

Calling ioctl() to re-read partition table.

Syncing disks.

2. Format the partition table created in 1 to EXT3.

$ sudo mkfs.ext3 /dev/sdb1 -L rootfs

3. Mount the partition table formatted in 2.

$ sudo mount /dev/sdb1 /mnt/tmp/

4. Change directory to the partition table mounted in 3.

$ cd /mnt/tmp/

5. Decompress the root file system.

$ sudo tar jxvf ~/adbc7519_prj/export/adbc75xx-standard-glibc_small-dist.tar.bz2

6. Copy the kernel image.

$ sudo cp ~/adbc7519_prj/build/linux-adbc75xx-standard-build/

arch/powerpc/boot/uImage boot/

7. Copy the device tree.

$ sudo cp ~/adbc7519_prj/build/linux-adbc75xx-standard-build/

arch/powerpc/boot/adbc7519.dtb boot/

8. Flush buffers to unmount partitions.

$ cd /

$ sync; sudo umount /mnt/tmp/

Wind River Linux BSP for Adbc7519 Software manual Preparation to start Wind River Linux on Adbc7519

19

Z32013A0-MN002-01_SWMan_En_2

9. Insert the SD card and power on the board

10. Enter as follows on the command prompt of U-Boot to set the command to be executed by autoboot.

=> setenv change_sdhc 'i2c mw 70 8 8;i2c mw 4c 0 2;'

=> setenv bootcmd 'run change_sdhc;setenv bootargs root=/dev/mmcblk0p1

rw rootfstype=ext3 rootwait

console=ttyS0,115200;mmc rescan FSL_ESDHC:0;ext2load mmc 0:1 1000000 /

boot/uImage;ext2load mmc 0:1 c00000 /boot/adbc7519.dtb;bootm 1000000 - c00000'

=> saveenv

<< Remarks >>

Once a boot command is set, it is saved to eMMC Flash memory by executing the saveenv command.

You don’t need to re-enter them when you boot it again at the same parameters.

<<Note>>

When you change the setting of a boot command, be sure to turn off power and then turn on again

before making the change.

11. Power on the board again and confirm that WRLinux boots normally.

Preparation to start Wind River Linux on Adbc7519 Wind River Linux BSP for Adbc7519 Software manual

20

Z32013A0-MN002-01_SWMan_En_2

3.5.2. Setting for booting from USB memory

Create a bootable USB memory on a host Linux system in the following way.

1. Set an USB memory in the host Linux system, and create a partition table in the USB memory using the

fdisk command.

An example is shown below.

o In the following explanations, the USB memory inserted in the host Linux system is named /dev/sdb for

convenience. The device name depends on the host Linux environment. Please change it according to

your environment.

1) Execute the fdisk command.

$ sudo fdisk /dev/sdb

2) USB memorys on the market are usually formatted with FAT16 or FAT32. Delete the existing partition

table.

Command (m for help): d  If there are 2 or more partitions, delete them all.

3) Create a partition table.

Command (m for help): n

Command action

e extended

p primary partition (1-4)

p

Partition number (1-4): 1

First cylinder (1-514, default 1):

Using default value 1

Last cylinder or +size or +size {K,M,G} (1-514, default 514):

Using default value 514

4) Write the partition table settings.

Command (m for help): w

The partition table has been altered!

Calling ioctl() to re-read partition table.

Syncing disks.

2. Format the partition table created in 1 to EXT3.

$ sudo mkfs.ext3 /dev/sdb1 -L rootfs

3. Mount the partition table formatted in 2.

$ sudo mount /dev/sdb1 /mnt/tmp/

4. Change directory to the partition table mounted in 3.

$ cd /mnt/tmp/

5. Decompress the root file system.

$ sudo tar jxvf ~/adbc7519_prj/export/adbc75xx-standard-glibc_small-dist.tar.bz2

6. Copy the kernel image.

$ sudo cp ~/adbc7519_prj/build/linux-adbc75xx-standard-build/

arch/powerpc/boot/uImage boot/

7. Copy the device tree.

$ sudo cp ~/adbc7519_prj/build/linux-adbc75xx-standard-build/

arch/powerpc/boot/adbc7519.dtb boot/

8. Flush buffers to unmount partitions.

$ cd /

$ sync; sudo umount /mnt/tmp/

Page is loading ...

Eurotech Adbc7519 Owner's manual

Eurotech Adbc7519 Owner's manual

Related papers

Other documents