Release Notes of the QNX 6.4.0 BSP for Freescale i.MX27 ADS Trunk#

System requirements#

Target system#

Host development system#

System layout#

The tables below depict the memory layout for the image and for the flash.

Memory layout

OS image loaded at:0x00100000
Ethernet base address0xd4040300 (IRQ: 26)
Burst flash base address0xC0000000

The interrupt vector table can be found in the buildfile located at src/hardware/startup/boards/mx27ads/build

Getting Started#

Step 1: Connect your hardware#

1. Set up the board. Refer to the manual for the correct default jumper settings to use.
2. Connect the serial cable to the first serial port of the i.MX27 ADS and the first serial port of your host machine (e.g. ser1 on a Neutrino host).

3. Connect an RJ-45 ethernet cable between the ethernet port on the i.MX27 ADS and your local network.

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:

1. Make sure the host machine is capable of handling TFTP requests (see the inetd documentation for details).
2. Verify the serial link between the host machine and the target.
3. Verify that an Ethernet link exists between the host machine and the target.
4. Apply power to the target board.

You should see output similar to the following:

RedBoot(tm) bootstrap and debug environment [ROMRAM] 
Non-certified release, version FSL 200749 - built 17:00:12, Dec 13 2007

Platform: MX27 ADS/EVB (Freescale i.MX27 based) PASS 2.1 [x32 SDR] 
Copyright (C) 2000, 2001, 2002, 2003, 2004 Red Hat, Inc.

RAM: 0x00000000-0x07f00000, [0x00025260-0x07ed1000] available
FLASH: 0xc0000000 - 0xc2000000, 256 blocks of 0x00020000 bytes each.

Step 4: Setting up the environment#

1. At the RedBoot prompt, issue the following command to change the current environment:


The current configurations will be displayed; change the configuration if you want.

Run script at boot: false
Use BOOTP for network configuration: false
Gateway IP address:
Local IP address:
Local IP address mask:
Default server IP address:
Board specifics: 0
Console baud rate: 115200
Set eth0 network hardware address [MAC]: true
eth0 network hardware address [MAC]: 0x40:0x00:0x00:0xEA:0x18:0xF0
Set FEC network hardware address [MAC]: false 
GDB connection port: 9000
Force console for special debug messages: false
Network debug at boot time: false
Default network device: cs8900a_eth0
alias/bsp_tag: BSP_VER=rel3
Update RedBoot non-volatile configuration - continue (y/n)?

Typey to accept the new configuration; RedBoot will write the new configuration to the flash.

2. Once the above setup is complete, you can run the load command at the RedBoot prompt to download the image:

load -r -b 0x00100000 /images/ifs-mx27.raw

RedBoot will display the following message and start downloading the boot image:

Using default protocol (TFTP)

If the image is successfully loaded, you will see the following message from the RedBoot prompt:

Raw file loaded 0x00100000-0x002cbef7, assumed entry at 0x00100000

3. Type:

run 0x00100000

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

Welcome to Neutrino on the MX27ADS (ARM 926 core) 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 "Summary of driver commands" section.

Creating a flash partition#

1. Enter the following command to start the NOR flash filesystem driver:

devf-mx31ads -s0xc0000000,32M

2. Erase the flash: Because the ROM monitor and the QNX boot image are in the flash, you may not want to erase them. Use the -l (length) and -o (offset) options to avoid these areas.
For example, if the OS image has a maximum size of 3 MB, and you want to create a 16 MB partition,

flashctl -p/dev/fs0 -o4M -l16M -ve

3. Format the partition:

flashctl -p/dev/fs0p0 -o4M -l16M -vf

4. Slay, then restart the driver:

slay devf-mx31ads
devf-mx31ads -s0xc0000000,32M

You should now have a /fs0p0 directory which you can copy files to.

Driver Command Summary #

The following table summarizes the commands to launch the various drivers.

ComponentBuildfile CommandRequired BinariesRequired LibrariesSource Location
Serialdevc-sermx1 -e -F -b115200 -c13300000 0x1000a000,20 devc-sermx1.src/hardware/devc/sermx1
Flash (NOR)devf-mx31ads -s0xc0000000,32M devf-mx31ads
ETFS Flash (NAND)fs-etfs-imx31ads_512 -D addr=0xd8000000 -m /fs/etfs fs-etfs-imx31ads
Ethernetio-pkt-v4 -dcrys8900 ioport=0xd4040300,irq=26,mac=00e02991234e -ptcpip  io-pkt-v4
FECio-pkt-v4 -d mcimx27 irq=50 -p tcpip io-pkt-v4
USBio-usb -d ehci-mx31 ioport=0x10024300,irq=54,verbose=4 (host 1)
io-usb -d ehci-mx31 ioport=0x10024500,irq=55,verbose=4 (host 2)
class drivers
prebuilt only
I2Ci2c-imx31ads -p0x10012000, -i12 i2c-imx31ads.src/hardware/i2c/imx31ads

Some of the following 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.



     startup-mx21ads [startup-options]

Some modules are not enabled by default on power up, so you need to use command-line options to startup to enable them. These options must be passed before any other startup options.

To enableUse this optionComment
USB Host 1 FS-U1enable USB Host 1 FS
USB Host 2 HS-U2enable USB Host 2 HS

ETFS flash (NAND):#

Command to run the ETFS NAND flash driver (64 MB):
fs-etfs-imx31ads_512 -m /fs/etfs -D addr=0xd8000000

You need to use the -e option the first time you start NAND flash driver.
fs-etfs-imx31ads_512 -e -m /fs/etfs -D addr=0xd8000000

To erase and format the NAND flash partition:

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

You should slay and restart the driver, after which you should have the mountpoint /fs/etfs/, which you can use to copy files to.

USB host :#

USB can be run either on the USB HOST Serial Interface (FS/LS) or the USB HOST ULPI Interface (HS), which are referred to as Host 1 and Host 2 respectively.

To use Host 1 FS:

The USB host port is J8.

To use Host 2 HS:

The USB host port is J7.

You will want to include class drivers, such as devb-umass in order to make use of attached USB devices.

Known Issues for this BSP#