About the Character DDK

This chapter includes:

• What you'll find in this guide
• Typographical conventions
• Technical support
• Assumptions
• Building DDKs

What you'll find in this guide

The following table may help you find information quickly:

Assumptions

To use this guide, you need to have:

• sufficient hardware documentation for your hardware in order to be able to program all the registers
• a working knowledge of the C programming language

Building DDKs

The Character DDK package can be downloaded from Foundry27.

The latest source code can also be downloaded at Foundry27:BSPs and Drivers Source code .

You can compile the DDK from the IDE or the command line.

• To compile the DDK from the IDE:

  Please refer to the Managing Source Code chapter, and “QNX Source Package” in the Common Wizards Reference chapter of the IDE User's Guide.

• To compile the DDK from the command line:

  Please refer to the release notes or the installation notes for information on the location of the DDK archives.

  DDKs are simple zipped archives, with no special requirements. You must manually expand their directory structure from the archive. You can install them into whichever directory you choose, assuming you have write permissions for the chosen directory.

  The following example indicates how you create a directory and unzip the archive file:

  # cd ~
  # mkdir ddk_install_dir
  # cd ddk_install_dir
  # unzip /path_to_ddks/ddk-device_type.zip
  # make

  Then you should get binaries and libraries in ddk_install_dir/install .

  The top-level directory structure for the DDK looks like this:

  ---

  

  ---

  Directory structure for this DDK.

  ---

  Historically, you had to run: . ./setenv.sh to set up the environment variable of the installation directory's make. This method is no longer required, as all the directories in /src have been set up to install their binaries and libraries to ddk_install_dir/install. Additionally, on Windows hosts you'll need to run the Bash shell (bash.exe) before you run the make command. Each DDK is rooted in whatever directory you copy it to. If you type make within this directory, you'll generate all of the buildable entities within that DDK, no matter where you move the directory. All binaries are placed in a scratch area /install within the DDK directory that mimics the layout of a target system. When you build a DDK, everything it needs, aside from standard system headers, is pulled in from within its own directory. Nothing that's built is installed outside of the DDK's directory. The makefiles shipped with the DDKs copy the contents of the prebuilt directory into the install directory. The binaries are built from the source using include files and link libraries in the install directory.

  ---

Typographical conventions

Throughout this manual, we use certain typographical conventions to distinguish technical terms. In general, the conventions we use conform to those found in IEEE POSIX publications. The following table summarizes our conventions:

We use an arrow (→) in directions for accessing menu items, like this:

You'll find the Other... menu item under Perspective-->Show View.

We use notes, cautions, and warnings to highlight important messages:

---

Notes point out something important or useful.

---

---

Cautions tell you about commands or procedures that may have unwanted or undesirable side effects.

---

---

Warnings tell you about commands or procedures that could be dangerous to your files, your hardware, or even yourself.

---

Note to Windows users

In our documentation, we use a forward slash (/) as a delimiter in all pathnames, including those pointing to Windows files.

We also generally follow POSIX/UNIX filesystem conventions.

Navigation buttons

At the top and bottom of our HTML docs, you'll see some or all of these buttons:

Use this button:	To move:
	To the previous part of the document.
	“Up” in the document: In a prose book, this typically takes you to About This Guide. In a reference book, it takes you to the listing of items that start with a given letter. For example, if you're looking at the docs for abs(), this button takes you to the listing of the functions that start with A.
	To the keyword index.
	To the next part of the document.

Technical support

To obtain technical support for any QNX product, visit the Support area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.

Copyright © 2002–2010, QNX Software Systems GmbH & Co. KG. All rights reserved.