Developer Resources: Board support packages; Foundry27 projects; Forums

QNX Technical Articles

QNX® Momentics® 6.3.0 Renesas SystemH BSP Release Notes

QNX^® Momentics^® 6.3.0

Renesas SystemH (SH4) BSP

Release Notes

Date of this edition: May 27, 2004

Target OS: QNX^® Neutrino^® 6.3.0

Host OS: Microsoft Windows XP SP1 or 2K SP4; Sun Solaris 7/8; QNX^® Neutrino^® 6.3.0; Linux^® (Red Hat 8/9)

NOTE:

For information on installing this BSP, see the installation note.
For the most up-to-date version of these release notes, log into your myQNX account, and then go to the Download Center area of www.qnx.com.

NOTE:

Throughout this document, you may see reference numbers associated with particular issues, changes, etc. When corresponding with our Technical Support staff about a given issue, please quote the relevant reference number. You might also find the reference numbers useful for tracking issues as they become fixed.

What's in this BSP?

This BSP contains:

Binary components
Source code
Documentation.

NOTE:

The source code requires a BSP Source License.

Binary components

IPL
Startup
PCI server
Input driver (included with OS)
Serial drivers (included with OS)
Network driver (included with OS).

Source code

IPL
Startup
PCI server
Input driver
Serial drivers
Network driver.

NOTE:

The flash filesystem driver binary and the flash filesystem library are included in the separately available flash product.

Documentation

Renesas SystemH (SH4) BSP guide (HTML)

NOTE:

Each BSP guide contains board-specific information and instructions on building an OS image for that particular board.

The procedure for building BSPs has changed since QNX Momentics 6.2.1. For instance, you must now run the setenv.sh script before compiling your BSP source. For details, see the chapter "Working with a BSP" in the Building Embedded Systems manual (in the Documentation Roadmap page under the QNX Neutrino RTOS section).

Location of source and documentation

When you install BSPs, you'll find the source code and documentation in the following locations:

Host	Source code	Documentation	Release notes
Windows	`$QNX_TARGETusrsrcarchivesqnx`	`$QNX_TARGETusrhelpproductbsp_name_of_board`	`$QNX_TARGETetcreadmebsp`
QNX Neutrino, Linux, and Solaris	`$QNX_TARGET/usr/src/archives/qnx/`	`$QNX_TARGET/usr/help/product/bsp_name_of_board`	`$QNX_TARGET/etc/readme/bsp`

NOTE:

The "roadmap" page (e.g. from the Windows XP start menu: All Programs-->QNX Momentics 6.3.0-->Documentation) contains links to the various HTML booksets that accompany the OS: System Architecture, Building Embedded Systems, Programmer's Guide, Library Reference, Utilities Reference, etc..

Binaries, buildfiles, IPLs, and other files

Depending on the particular BSP and type of driver, you'll find the files in these locations:

Windows hosts

File	Location
Buildfile	`$QNX_TARGETCPUbootbuild`
IPL and/or startup	`$QNX_TARGETCPUbootsys`
"`bin`" drivers (serial, flash, block, PCI, PCMCIA, USB)	`$QNX_TARGETCPUbin`
"`dll`" drivers (audio, graphics, network)	`$QNX_TARGETCPUlibdll`

QNX Neutrino, Linux, and Solaris hosts

File	Location
Buildfile	`$QNX_TARGET/CPU/boot/build`
IPL and/or startup	`$QNX_TARGET/CPU/boot/sys`
"`bin`" drivers (serial, flash, block, PCI, PCMCIA, USB)	`$QNX_TARGET/CPU/bin`
"`dll`" drivers (audio, graphics, network)	`$QNX_TARGET/CPU/lib/dll`

Known issues for this BSP

devn-smc9000.so -- There's an alignment problem in devn-smc9000.so that may cause io-net to SIGBUS. (Ref# 19170)
Workaround: Enable alignment-fault emulation for procnto:
```
procnto -ae
```

NOTE:

Please check the version of these release notes posted on the website for the most up-to-date information.

Technical support

If you have any questions, comments, or problems with a QNX product, we recommend that you use our support forums available from our news server, news://inn.qnx.com.

Since QNX developers and support staff frequent our newsgroups, you should find them to be your best avenue of support for solving problems.