Project Home
Project Home
Wiki
Wiki
Project Information
Project Info
wiki2967: Nto640FreescaleMpc8313eRdbTrunkReleasenotes (Version 2)


Release Notes for the QNX Neutrino 6.4.0 BSP for Freescale MPC8313E RDB 1.0.0#

System requirements#

Target system#

  • QNX Neutrino RTOS 6.4.0
  • Board version: Freescale mpc8313e
  • ROM Monitor version UBoot v 1.1.6
  • EON EN29LV640 (8 MB) NOR Flash
  • Samsung K9F5608UOD (32 MB) NAND Flash

Host development system#

  • QNX Momentics 6.4.0, one of the following host systems:
    • QNX Neutrino 6.4.0
    • Microsoft Windows Vista, XP SP2 or SP3, 2000 SP4
    • Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7, or SUSE 10
  • Terminal emulation program (Qtalk, Momentics IDE Terminal, tip, HyperTerminal, etc.)
  • RS-232 serial port
  • NULL-modem serial cable
  • Ethernet link

System layout#

The table below depicts the memory layout for the image and for the flash.

Memory layout

ItemAddress
OS image loaded at: 0x00200000
OS image begins execution at: 0x00200000
Flash base address 0xfe000000
eTSEC1 base address 0xe0002400 (IRQ: 13, 14, 18)
eTSEC2 base address 0xe0002500 (IRQ: 19, 20, 24)
TSEC3 base address (8548) 0xe0002600 (IRQ: 15, 16, 17)
TSEC4 base address (8548) 0xe0002700 (IRQ: 21, 22, 23)
Ethernet base address 0xB4020000 (IRQ: 168)
Serial base address (8572) 0xe0004500 (IRQ: 26)

Getting Started#

Step 1: Connect your hardware#

Connect the serial cable to the first serial port of the MPC8313E RDB board to the first serial port of your host machine (e.g. ser1 on a Neutrino host).
  • If you have a Neutrino host with a serial mouse, you may have to move the mouse to the second serial port on your host, because some terminal programs require the first serial port.

Step 2: Build the BSP#

You can build a BSP OS image from the source code or the binary components contained in a BSP package. For instructions about building a BSP OS image, please refer to the chapter Working with a BSP in the Building Embedded Systems manual.

Step 3: Transfer the OS image to the target using the ROM monitor#

On your host machine, start your favorite terminal program with these settings:
  • Baud: 115200
  • Bits: 8
  • Stop bits: 1
  • Parity: none
  • Flow control: none

Step 4: Setting up the environment#

  • Apply power to the target board. You should see the U-Boot ROM monitor output.
  • You can use TFTP download (the default) or serial download to transfer an OS image to the board, as described below.

Step 4A: TFTP download#

This method requires a raw image, which the buildfile creates by default. On your target, type the following, filling in the appropriate IP addresses and ifs file:

=> setenv ethact TSEC1
=> setenv ipaddr 172.18.80.142
=> setenv serverip 172.18.80.174
=> setenv bootfile ifs-mpc8313rdb.raw
=> setenv loadaddr 0x200000
=> setenv bootcmd 'tftpboot $loadaddr $bootfile; go $loadaddr'
=> setenv bootdelay 2
=> saveenv

Saving Environment to Flash...
Un-Protected 1 sectors
Erasing Flash...
flash erase done
Erased 1 sectors
Writing to Flash... done
Protected 1 sectors
=> boot
At this point you should see the ROM monitor download the boot image, indicated by a series of number signs. You'll also see output similar to this when it completes downloading:
Speed: 1000, full duplex
Using TSEC1 device
TFTP from server 172.18.80.174; our IP address is 172.18.80.142
Filename 'ifs-mpc8313rdb.raw'.
Load address: 0x200000
Loading: #################################################################
#################################################################
#################################################################
#################################################################
##############################
done
Bytes transferred = 1483860 (16a454 hex)
## Starting application at 0x00200000 ...
You should see the QNX Neutrino welcome message on your terminal screen:
Welcome to QNX Neutrino 6.4.0 on the Freescale MPC8313E RDB board
You can now test the OS simply by executing any shell builtin command or any command residing within the OS image (e.g. ls).

Step 4B: Serial download#

This method requires an SREC image. You have to modify the buildfile to create this format. Change this:

[virtual=ppcbe,raw]

to this:

[virtual=ppcbe,srec]

Rebuild the image. On your target, type:

=>: setenv loads_echo 0
=>: saveenv
=>: loads

On your host, copy the image to the serial port that's connected to the board. For example, on a Neutrino host:

cp ifs-mpc8572ds.srec /dev/ser1
On a Windows host, you can use Hyperterminal's transfer feature to copy the image as a text file.
Note:
The serial line shouldn't already be in use.

At this point, you should see the ROM monitor download the boot image, indicated by a series of dots. You'll also see output similar to this when it finishes downloading:

## First Load Addr = 0x00200000
## Last  Load Addr = 0x0023955B -------- ?
## Total Size      = 0x0013955C = 1283420 Bytes -----?
## Start Addr      = 0x00101E38 -----?
=>: 

Type:

go start_addr

You should now see the QNX Neutrino welcome message on your terminal screen:

System page at phys:0000c000 user:0000c000 kern:0000c000
Starting next program at v00133af4
Welcome to QNX Neutrino 6.4.0 on the Freescale MPC8313E RDB board
#

You can test the OS simply by executing any shell builtin command or any command residing within the OS image (e.g. ls).

Once the initial image is running, you can update the OS image using the network and flash drivers. For sample command lines, please see the " Driver Command Summary" section.

Creating a flash partition#

  • Enter the following command to start the flash filesystem driver:
     fs-etfs-mpc8313erdb512 -D cs=1
  • Stop the filesystem on the device:
      etfsctl -d /dev/etfs2 -s
  • Format the filesystem:
      etfsctl -d /dev/etfs2 -f
  • Make the filesystem continue:
      etfsctl -d /dev/etfs2 -c
You should now have a /fs/etfs directory which you can copy files to.


Driver Command Summary#

The driver command lines below are specific to the Freescale MPC8572DS board. See the online docs for each driver for additional command-line options and other details.

NOTE: Some of these drivers are commented out in the default buildfile. To use the drivers in the target hardware, you'll need to uncomment them in your buildfile, rebuild the image, and load the image into the board.

ComponentBuildfile CommandRequired BinariesRequired LibrariesSource Location
Startup startup-mpc8313e-rdb . . src/hardware/startup/boards/mpc8313e-rdb
Serial devc-ser8250 -e -F -c166000000 -b115200 0xe0004500,0x09 0xe0004600,0x0Adevc-ser8250 . src/hardware/devc/ser8250
PCI pci-mpc8313 & pci-mpc8313 . src/hardware/pci/mpc8313
Network io-pkt-v4 -dmpc85xx syspage io-pkt-v4
ifconfig
devnp-mpc85xx.so
libsocket.so
"Binary form only:"
prebuilt/ppcbe/lib/dll/devnp-mpc85xx.so
ETFS fs-etfs-mpc8313erdb512 -D cs=1 fs-etfs-mpc8313erdb512
etfsctl
. src/hardware/etfs/nand512/mpc8313erdb512
I2C i2c-mpc5200 -p0xe0003000 -c88000000 -i14 (Interface 1)
i2c-mpc5200 -p0xe0003100 -c88000000 -i15 (Interface 2)
i2c-mpc5200 . src/hardware/i2c/mpc5200
SPI spi-master -d mpc8349 . . src/hardware/spi/mpc8349

Serial#

The value passed to the -c option depends on the CCB clock frequency as displayed by U-Boot at boot time, which may change depending upon board dip switch settings. For instance, CCB:166Mhz translates to -c166000000.

Network:#


io-pkt-v4 -dmpc85xx syspage

I2C:#

Run both I2C channels:

i2c-mpc5200 -p0xe0003000 -i14 --u1
i2c-mpc5200 -p0xe0003100 -i15 --u0

Note:
For more information about these commands, see the Neutrino Utilities Reference.


Known issues for this BSP#

  • U-Boot has a known bug on this board (as documented in U-Boot/board documentation), that device TSEC0 fails to load the image in the first run, as evidenced in the following log:
 => tftpboot 200000 image
        Speed: 1000, full duplex
        Using TSEC0 device 
        TFTP from server 172.18.80.174; our IP address is 172.18.80.142
        Filename 'ifs-mpc8313rdb.raw'.
        Load address: 0x200000
        Loading: Got error 4

        Abort
        => tftpboot 200000 ifs-mpc8313rdb.raw
        Speed: 1000, full duplex
        Using TSEC0 device
        TFTP from server 172.18.80.174; our IP address is 172.18.80.142
        Filename 'ifs-mpc8313rdb.raw'.
        Load address: 0x200000
        Loading: #################################################################
        #################################################################
        #################################################################
        #################################################################
        ##############################
        done
        Bytes transferred = 1483860 (16a454 hex)
        => go 200000
                ## Starting application at 0x00200000 ...   
Workaround: Either TSEC1 can be used for loading image in the first run, or TSEC0 can be used to load image successfully second run onwards.