Release Notes of the QNX 6.4.0 BSP for Centrality Titan EVB Trunk#

Before you begin#

For information about the hardware or firmware, refer to the documentation for your board. You may also find the following website useful:

http://www.centralitycomm.com

What's in this BSP?#

Neutrino supports the following devices on the Centrality Titan boards:

Titan serial port (UART1)
DM9000A Ethernet
64 MB NAND flash (Samsung K9F1208U0M)

If you need support for a particular device that isn't listed here, please contact us. The solution may be as simple as modifying an existing driver, which you might be able to do yourself, or it may involve more extensive support (e.g. a Custom Engineering arrangement). Contact a QNX technical support representative or Field Application Engineer to help you decide how to proceed.

System requirements#

Target system#

• Centrality Titan Motherboard version 1.2.0
• CPU Core module board version 2.2.0 (with 64MB of RAM)
• CPU TT640
• Sharp 4.3" LCD panel (resolution: 800x480)
• ROM monitor: NBoot v5.1
• USB cable
• Serial cable (straight-through)
• One serial port (UART RS-232)

If the Titan board is populated with more than 64 MB of RAM, you'll need to change the startup code (i.e. init_raminfo.c) to add the proper RAM size.

Host development system#

• RS-232 serial port
• USB port
• Ethernet link (optional)

For other system requirements (e.g. disk, RAM), see the installation notes for QNX Momentics.

Getting Started#

Step 1: Connect your hardware#

Connect the Centrality Titan board's power supply as per the instructions provided with the hardware. Connect the straight-through serial cable between the UART1 port (P23) on the Titan, and a free serial port on the host PC you wish to use.

If you have a Neutrino host with a serial mouse, you may have to move it to the second serial port on your host, because some terminal programs require the first serial port.

Connect the supplied USB cable to the P20 connector (USB client) on the Centrality Titan board. Connect the other end of the USB cable to a free USB port on a Windows PC.

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.

The pre-built IPL binary provided with the binary components needs to be padded to 16 KB before transferring it to the board via NBoot. Use the following script to pad the IPL binary to 16 KB:

*script to build a binary IPL for the Titan evaluation board 
    set -v 
    rm -f ipl-titan.bin 
*convert IPL into an S-record 
    ${QNX_HOST}/usr/bin/ntoarm-objcopy -Osrec ipl-titan ipl-tmp-titan.srec 
*convert S-Record IPL to binary 
    ${QNX_HOST}/usr/bin/ntoarm-objcopy -Obinary ipl-tmp-titan.srec ipl.tmp 
    mkrec -r -ffull -s16k ipl.tmp > ipl-titan.bin 
*Clean up temporary files 
    rm -f *tmp* 

This step is necessary only when transferring the pre-built IPL via NBoot.

Step 3: Transfer the IPL to the on-board NAND flash#

Before transferring the OS image to the board, you'll need to program the IPL to the flash.

The QNX IPL will replace EBoot. It is possible to update the IPL by using the AtlasMgr5.exe utility from Centrality.

Step 3.1: Program the IPL#

On your host machine, start your favorite terminal program with these settings:

• Baud: 38400
• Bits: 8
• Stop bits: 1
• Parity: none

The Titan board has a two-stage boot process. The first loader to run is called NBoot, which will present the user with a menu of further boot and configuration options. The second loader called EBoot won't be used. The following procedure will replace the EBoot loader completely with a QNX Initial Program Loader, which can then be used to load a QNX Neutrino OS image serially. To perform this procedure, you will need a Microsoft Windows Utility called AtlasMgr5.exe (for NBoot v5.1), available from Centrality. You will also need to install a USB device driver on the Windows HOST for the Titan board. This driver is also available from Centrality.

The Centrality tools are usually provided with the Centrality Titan board.

Transfer the binary IPL, to a MS Windows HOST that is connected to the Titan board via the USB link. The binary IPL file is called ipl-titan.bin.

Apply power to the Centrality Titan board. On the serial console, you should see the following NBoot output when using NBoot v5.1:

Centrality NBOOT v5.1
Nov 14 2006 19:16:19
ClockInfo: 0x0

1): Launch EBOOT
2): Launch NK
3): Launch DM
4): Erase and Reset TOC
5): Toggle NBOOT Menu
6): Set Clock
7): Config CS
Input:

Using NBoot version 5.1: Make sure that you have correctly installed the USB device driver on the MS Windows host and that the USB cable is plugged in. From the MS Windows host, run the AtlasMgr5.exe program. In the Transport area, make sure that USB is selected. Then simultaneously reset the board and quickly click on the Open button of the AtlasMgr5.exe program until the NBoot output appears in the USB Terminal section of the AtlasMgr5.exe program. In the Target Media section, select CS0. In the Update Functions section, select Update EBoot. In the Open dialog box that appears, navigate to the ipl-titan.bin file, and select it. The IPL will now be programmed to the EBoot area of the CS0 NAND flash. The AtlasMgr utility should display the following message when the IPL is successfully programmed to the flash:

Update EBoot Successful!

Now, reset the Titan board.

From the NBoot menu, select #1 Launch EBOOT option. Change the baud rate of your terminal to 115200. You should then see the following IPL output (or similar):

QNX Neutrino Initial Program Loader for Centrality Titan board
Commands:

Press 'D' for serial download, using the 'sendnto' utility

Step 4: Transfer the OS image to the target#

Once the IPL is running on the board, use the following steps to transfer the OS image to the board. You can transfer the OS image into RAM and execute it from RAM.

Step 4.1: Transfer the OS image to RAM#

Locate the QNX OS image generated in Step 2: Build the BSP

Select the IPL option D to download the OS image serially to the board.

Use the QNX sendnto utility to transfer the OS image from the host to the Centrality Titan board. For instance:

sendnto -d com1 ifs-titan.bin

Once the transfer is completed, the OS image will be executed and QNX Neutrino will boot on the board. You should also see the following welcome message on your terminal screen:

Welcome to QNX Neutrino 6.x on the Centrality Communications Titan Board

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

Change the clock settings (optional)#

Note the NBoot menu is displayed on the board, you can use the following steps to change the clock settings for the Titan board.

Select the NBoot> option #6 to change the clock settings. You should see the following output:

a) DDR_500_250_250_200_125
b) DDR_125_125_125_200_62.5
c) DDR_250_125_125_125_62.5
d) DDR_500_200_200_100_100
e) MDDR_500_250_250_166_125
f) MDDR_125_125_125_166_62.5
g) MDDR_250_125_125_125_62.5
h) MDDR_500_240_240_60_120
i) SDR_500_250_250_133_125
j) SDR_125_125_125_133_62.5
k) SDR_250_125_125_125_62.5
l) SDR_500_240_240_60_120
m) DDR_96_48_48_24_24
n) MDDR_300_150_150_75_133
z) return
Input:

The NBoot uses the following setting by default:

a) DDR_500_250_250_200_125

Select the desired frequency option. Once the OS image is loaded into RAM the clock settings selected from the NBoot will be applied.

System Layout#

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

Item	Address
OS image loaded at:	0xC0200000
OS image begins execution at:	0xC0200000
IPL offset:	In on-board NAND flash, at EBoot location
Ethernet base address	0x14000000 (IRQ: 301)

Summary of driver commands#

The driver command lines below are specific to the Centrality Titan boards. See the online docs for each driver for additional command-line options and other details.

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.

Serial#

Command when booting from the QNX IPL:

devc-sertitan -e -F -b115200

Ethernet#

Command:

io-net -ddm9000-titan ioport=0x14000000,irq=301 -ptcpip
ifconfig en0 x.x.x.x

Replace x.x.x.x with a proper IP address.

NAND Flash#

Command to run the NAND flash ETFS driver on the on-board NAND flash:

fs-etfs-titan512 -r32768 -m /fs/etfs

where -r <cluster-number> is the number of clusters (a cluster contains 2 pages of 512 B) to reserve for the IPL, the OS image and potential bad blocks skipped when the IPL and the OS image are copied to the flash. You should then see the /dev/etfs1 and /dev/etfs2 partitions. The /dev/etfs1 partition contains the IPL and the OS image, so be sure to not erase it.

To format the second NAND flash partition (i.e. /dev/etfs2):

etfsctl -d /dev/etfs2 -S -f -c

You should now see the mountpoint /fs/etfs/, which you can use to copy files to.

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