QNX® Momentics® 6.3.0 my-board-name Board Support Package my-version-number Release Notes
QNX® Momentics® 6.3.0 my-board-name Board Support Package my-version-number Release Notes
Date of this edition: August 16, 2007
Target OS: This BSP is compatible with targets that are running QNX® Neutrino® 6.3.2.
Host OS: In order to install this BSP, you must have already installed QNX Momentics 6.3.2 on one of the following hosts:
- Microsoft Windows Vista, XP SP2, or 2000 SP4
- QNX® Neutrino® 6.3.2
- Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7.0.4, or SUSE 10
Boards supported: my-board-names
Contents
- What's in this BSP?
- Location of source and documentation
- Fixed issues for this BSP
- Known issues for this BSP
- Uninstalling this BSP
- Technical support
Throughout this document, you may see QNX reference numbers associated with particular issues, changes, etc. When corresponding with QNX 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
Binary components
Update as appropriate:
- IPL
- Startup
- PCI server
- Serial driver
- Network driver
- Bestcomm DMA library
- Bestcomm utility
- USB support
- EIDE driver
- SPI driver
- I2C driver
- Audio driver (Media5200 Only)
- Graphics driver (Media5200 Only)
- lvds utility (Media5200 Only)
- Touch screen driver (Media5200 Only)
Source code
Update as appropriate:
- IPL
- Startup
- PCI server
- Serial driver
- Network driver
- SPI driver
- I2C driver
- Flash driver
- Audio driver (Media5200 Only)
- Touch screen driver (Media5200 Only)
Documentation
- my-board-name readme (HTML)
Each BSP guide contains board-specific information and instructions on building an OS image for that particular board.
Location of source and documentation
After you've installed the BSP, you'll find some or all of the following in installation_dir (depending on what the BSP includes):
| File or directory | Description |
|---|---|
| uninstall | A script that will uninstall the BSP and its documentation |
| images/ | All buildfiles and the Makefile |
| install/ | An empty directory where make installs the binaries that it builds from the source code |
| prebuilt/ | Prebuilt binaries, libraries, and headers |
| src/ | Source code |
| Makefile | Control file for building the source code |
| setenv.sh | A script that sets up the build environment (to be included in the Makefile) |
| source.xml | The XML file that the IDE uses |
| docs/usr/help/product/bsp_BSP_name/ | Documentation to be copied to $QNX_TARGET/usr/help/product |
| BSP_name_rel.html | Release notes |
For documentation about all your installed BSPs, see $QNX_TARGET/usr/help/product/bsp_index.html.
The "roadmap" page (e.g. from the Windows XP start menu: ) contains links to the various HTML booksets that accompany the OS: System Architecture, Building Embedded Systems, Programmer's Guide, Library Reference, Utilities Reference, etc.
Fixed issues for this BSP
This version of the BSP provides fixes the following issues:
- my-fixed-issues
Known issues for this BSP
- Don't rename the directory after running setupbsp, or else you won't be able to build or uninstall the BSP properly. (QNX Ref# 38361)
- If you uninstall this BSP, the uninstaller removes only those files that were originally shipped with the BSP (whether or not you modified them). If you've added any files, they remain on your system. (QNX Ref# 38368)
- The uninstaller script doesn't remove itself when you uninstall the BSP. (QNX Ref# 38368)
- If you install a BSP more than once, and then uninstall an instance of it, the documentation for all copies of the BSP is uninstalled. (QNX Ref# 38320)
- All QNX BSPs ship with an images/Makefile whose purpose
is to build an image filesystems (ifs) file using drivers
built from source.
Currently, it's set up to copy buildfiles from within the source directory
structure (source/hardware/startup) to the
images directory so that it can generate an
ifs.
This happens automatically when you do a top-level make, but
this mechanism doesn't work when you're making an binary BSP.
(QNX Ref# 38242)
Workaround: For a binary-only BSP, change these lines in the root Makefile:
all: install links $(if $(wildcard images/*),images) @echo doneto the following:
all: prebuilt links $(if $(wildcard images/*),images) @echo done
Uninstalling this BSP
- Log in as root (or as a user with system-administrator privileges on Windows).
- Go to the directory where you installed the BSP (installation_dir).
- Run the uninstall script that you'll find in this directory:
ksh ./uninstall
Technical support
Explain how people can reach you for technical support.