Deploy VxWorks 6.8 on MVME2500 SBC

Introduction

#

Overview

#

The MVME2500 Single Board Computer (SBC) is a VMEbus board, which features a single-core P2010 or the dual-core P2020 NXP® QorIQ® processors.

This document describes the procedure to boot VxWorks 6.8 on the MVME2500 board.

Deliverables

#

The following table lists the MVME2500 deliverables.

Booting VxWorks

#

Introduction

#

You can boot VxWorks on the MVME2500 board using any of the following methods:

• Network Boot
• Disk Boot
• USB Boot
• SPI Flash Boot

Network Boot

#

Prerequisites

#

You should have connectivity to the TFTP server.

Booting Procedure

#

The TFTP server should be configured and started in the connected PC. The VxWorks boot Image file, vxWorks-2020.st or vxWorks-2010.st, should be made available at the standard TFTP boot image path /tftpboot.

To boot VxWorks through network, perform the following steps:

1. Power up the MVME2500 board.

By default, it provides the U-Boot prompt.

2. Set the environmental variables at the U-Boot prompt.

setenv ipaddr <Board ip address>
setenv serverip <TFTP server ip address>
setenv gatewayip <Gateway ip address>
setenv netmask <Netmask>

Example:

setenv ipaddr 10.130.101.206
setenv serverip 10.130.101.216
setenv gatewayip 10.130.101.254
setenv netmask 255.255.255.0

3. Set the VxWorks boot image file name.

setenv vxbootfile vxWorks-2020.st
setenv vxbootfile vxWorks-2010.st

4. Set the VxWorks bootline arguments.

setenv vxbootargs 'motetsec(0,0)10.130.101.216:vxWorks h=10.130.101.216 e=10.130.101.206:ffffff00 u=vxworks pw=vxworks f=0x80’

Parameters description:

• motetsec(0,0) : Ethernet interface 0 on cpu 0
• 10.130.101.216 : Host Machine IP
• 10.130.101.206 : Board IP
• ffffff00 : Netmask
• u=vxworks : Username on host machine
• p=vxworks : Password for the above user in host machine
• f=0x80 : File Transfer Protocol (FTP)

5. Set the VxWorks network boot command.

setenv vxboot 'tftpboot $vxbootfile && setenv bootargs $vxbootargs && bootvx'

6. Save your current environmental variables.

saveenv

7. To boot VxWorks through network, execute the following command:

run vxboot

Disk Boot

#

Prerequisites

#

You should have:

• Serial Advanced Technology Attachment (SATA) hard disk with ext2 file system loaded, and
• VxWorks image loaded to the ext2 file system

Booting Procedure

#

To boot VxWorks using disk, perform the following steps:

1. Power up the MVME2500 board.

By default, it provides the U-Boot prompt.

2. Set the environmental variables at the U-Boot prompt.

setenv ipaddr <Board ip address>
setenv serverip <TFTP server ip address>
setenv gatewayip <Gateway ip address>
setenv netmask <Netmask>

Example:

setenv ipaddr 10.130.101.206
setenv serverip 10.130.101.216
setenv gatewayip 10.130.101.254
setenv netmask 255.255.255.0

3. Set the VxWorks boot image file name.

setenv vxbootfile vxWorks-2020.st
setenv vxbootfile vxWorks-2010.st

4. Set the VxWorks bootline arguments.

setenv vxbootargs 'motetsec(0,0)10.130.101.216:vxWorks h=10.130.101.216 e=10.130.101.206:ffffff00 u=vxworks pw=vxworks f=0x80’

Parameters description:

• motetsec(0,0) : Ethernet interface 0 on cpu 0
• 10.130.101.216 : Host Machine IP
• 10.130.101.206 : Board IP
• ffffff00 : Netmask
• u=vxworks : Username on host machine
• p=vxworks : Password for the above user in host machine
• f=0x80 : File Transfer Protocol (FTP)

5. Set the VxWorks disk boot command.

setenv vxdiskboot 'ext2load scsi 0:1 0x1000000 $vxbootfile && setenv bootargs $vxbootargs && bootvx'

6. Save your current environmental variables.

saveenv

7. To boot VxWorks through hard disk, execute the following command:

run vxdiskboot

USB Boot

#

Prerequisites

#

You should have:

• USB pen drive with VxWorks image, and vfat or ext2fs file system

Booting Procedure

#

To boot VxWorks using USB, perform the following steps:

1. Power up the MVME2500 board.

By default, it provides the U-Boot prompt.

2. Set the environmental variables.

setenv ipaddr <Board IP address>
setenv serverip <TFTP server IP address>
setenv gatewayip <Gateway IP address>
setenv netmask <Netmask>

Example:

setenv ipaddr 10.130.101.206
setenv serverip 10.130.101.216
setenv gatewayip 10.130.101.254
setenv netmask 255.255.255.0

3. Set the VxWorks boot image file name.

setenv vxbootfile vxWorks-2020.st
setenv vxbootfile vxWorks-2010.st

4. Set the VxWorks bootline arguments.

setenv vxbootargs 'motetsec(0,0)10.130.101.216:vxWorks h=10.130.101.216 e=10.130.101.206:ffffff00 u=vxworks pw=vxworks f=0x80’

Parameters description:

• motetsec(0,0) : Ethernet interface 0 on cpu 0
• 10.130.101.216 : Host Machine IP
• 10.130.101.206 : Board IP
• ffffff00 : Netmask
• u=vxworks : Username on host machine
• p=vxworks : Password for the above user in host machine
• f=0x80 : File Transfer Protocol (FTP)

5. Set the VxWorks USB boot command.

setenv vxusbboot 'usb reset && fatload usb 0:1 0x1000000 $vxbootfile && setenv bootargs $vxbootargs && bootvx'

6. Save your current environmental variables.

saveenv

7. To boot VxWorks through USB, execute the following command:

run vxusbboot

SPI Flash Boot

#

Prerequisites

#

You should have:

• TFTP server connectivity is required only when you want to copy new VxWorks image to SPI Flash.

Booting Procedure

#

The TFTP server should be configured and started in the connected PC. The VxWorks boot Image file, vxWorks-2020.st or vxWorks-2010.st, should be made available at the standard TFTP boot image path /tftpboot.

Follow 1 to 8 steps to copy VxWorks image from network to SPI Flash.

1. Power up the MVME2500 board.

By default, it provides the U-Boot prompt.

2. Set the environmental variables at the U-Boot prompt.

setenv ipaddr <Board ip address>
setenv serverip <TFTP server ip address>
setenv gatewayip <Gateway ip address>
setenv netmask <Netmask>

Example:

setenv ipaddr 10.130.101.206
setenv serverip 10.130.101.216
setenv gatewayip 10.130.101.254
setenv netmask 255.255.255.0

3. Set the VxWorks boot image file name.

setenv vxbootfile vxWorks-2020.st
setenv vxbootfile vxWorks-2010.st

4. Set the VxWorks bootline arguments.

setenv vxbootargs 'motetsec(0,0)10.130.101.216:vxWorks h=10.130.101.216 e=10.130.101.206:ffffff00 u=vxworks pw=vxworks f=0x80’

Parameters description:

• motetsec(0,0) : Ethernet interface 0 on cpu 0
• 10.130.101.216 : Host Machine IP
• 10.130.101.206 : Board IP
• ffffff00 : Netmask
• u=vxworks : Username on host machine
• p=vxworks : Password for the above user in host machine
• f=0x80 : File Transfer Protocol (FTP)

5. Initialize SPI Flash0 device:

sf probe 0

Note: To initialize SPI Flash 1, set the command as below:

sf probe 1

6. To erase SPI Flash memory region:

sf erase 0x200000 0x300000

Note: Maximum space available in SPI Flash for VxWorks image is 5MB (0x500000). Here it is assumed that the VxWorks image size is less than 3MB(0x300000). If the VxWorks image size is more than 3MB, then you can change the image size here accordingly.

7. Load the VxWorks image from network to the memory location (0x1000000):

tftpboot VxWorks.st

8. Write to SPI Flash 0 device at location (0x200000) from memory location(0x1000000):

sf write 0x1000000 0x200000 0x300000

Note: VxWorks image is loaded permanently to SPI flash 0. To load Vxworks image use SPI Flash device from next time.

To boot directly from SPI Flash follow below steps:

1. Initialize SPI Flash0 device

sf probe 0

Note: To initialize SPI Flash 1, set the command as below:

sf probe 1

2. Copy VxWorks image from SPI Flash 0 location (0x200000) to memory location (0x1000000) with 3MB size.

read 0x1000000 0x200000 0x300000

3. Set the VxWorks SPI Flash boot command.

setenv vxboot 'setenv bootargs $vxbootargs && bootvx'

4. Save your current environmental variables.

saveenv

5. To boot VxWorks through SPI Flash, execute the following command:

run vxboot

Building Board Support Package

#

Building Procedure

#

The mvme2500_sp1.tar.gz contains VxWorks 6.8 BSP source files for the MVME2500 board. Perform the following steps to build the BSP:

1. Extract the mvme2500_sp1.tar.gz to any working directory.
2. Start the Wind River VxWorks Workbench by executing the following command:

<vxWorks Installation Directory>/startWorkbench.sh

3. Open the Wind River VxWorks Workbench. Select File -> New -> VxWorks Image Project

4. Give a project name and then click Next.

5. Go to BSP and select mvme2500 from the dropdown list. Click Browse and point to the location where you have extracted the BSP. Click Next.

6. Select any configuration profile.

7. Click Finish.

8. Double-click mvme2500.h file. Enable MVME2500_P2020 or MVME2500_P2010 based on the MVME2500 board version.

9. Right-click the project name which you have created, and select Build Project.