Creating a new QNX System Builder project

The IDE provides a wizard to set up an image-building project based on your buildfile preferences.

To create a new QNX System Builder project:

  1. Select File > New > Project..., or simply click the New button (Icon: New button).
  2. Expand QNX System Builder, then select QNX System Builder Project. Click Next.
  3. Type a name in the Project name field, then click Next. The IDE displays the Buildfile Initialization window.
  4. Choose from the following options:

    Create a new buildfile
    To create a simple buildfile, select your target platform from the dropdown list.
    Import from a BSP project
    To use the buildfile from an existing BSP project, select the buildfile from the dropdown list.
    Copy an existing buildfile
    Click Browse… to locate an existing buildfile. Refer to your BSP's user guide to learn the name and .build file for your board.
    Note: Creating a buildfile requires a working knowledge of boot script grammar, as described in the entry for mkifs in the Utilities Reference and in the Building Embedded Systems guide.
  5. Click Next if you want to customize the buildfile; the following sections discuss your customization options.

    Otherwise, skip the remaining steps and click Finish to create the project.

Creating a generic buildfile

If you've chosen to create a new buildfile, the wizard's BuildFile Template window lets you create a generic minimal buildfile for your platform:

  1. In the Boot file dropdown, select the format of the bootstrap file. This file calls the startup script, which sets up the environment and transfers control to procnto, which is the QNX Neutrino microkernel and process manager. To learn how image components work together during startup, see The boot process in Building Embedded Systems.

    The format you select affects the virtual attribute of the .bootstrap entry, which is found near the top of the buildfile.

  2. In the Startup dropdown, select the type of startup script. This selection determines the name of the startup script and hence the .bootstrap file contents.

Creating a combined image

You can create combined images by joining together several components—an Initial Program Loader (IPL), an OS image, and one or more flash images—into a single system image. For example, you might want to combine an IPL with an OS image and then download the resulting image to the target board through Uboot.

The wizard's Image Combination Details window lets you control how images are combined with your System Builder project:

window: Image Combination Details

Start by filling in the following fields:

Image name
The image name. By default, the IDE displays the same name that you assigned to the project.
Where the IDE looks for files that go into the image. Enter a filesystem location or click Browse... to browse available BSPs for a staging directory.

If you select Combine image with IPL, the IDE enables the following fields:

IPL file
The fully qualified name of an IPL file that you want to append to the front of an IFS.
Pad IPL to
A dropdown list that lets you choose the amount of padding required for the IPL file that you want to append. Select a value where the padding is equal to or greater than the size of the IPL. The IPL plus the padding amount will provide the start of the IFS.
If the padding is less than the size of the IPL, the image won't contain the complete IPL.

If you want to burn the image into ROM at a given memory location, select Create ROM image. The IDE enables the following fields:

A board-specific offset, in hex, that indicates the distance (displacement) from the beginning of the image to where the IFS starts. You typically use this setting for S-Record images (see Format field, below).
A numerical value for the size of the ROM. To determine the amount of ROM you'll need, you can compile the code to create a HEX file of the code; the size of the file is the size of the ROM you require.
A dropdown list of image formats. If you want to download an image to the target, the resulting ROM image will be copied to the format you choose.

Adding project references

The wizard's Referenced Projects window lets you add project references to your QNX System Builder project. Simply check the boxes for any projects on which your new project depends, then click Finish.

What happens when you click Finish

When you click Finish in the QNX System Builder Project wizard, the IDE does the following: