Build Instructions for IPC Utils Examples

General Information

This page explains how to build the examples provided in the IPC Utils product.

Requirements

See the Release Notes for the specific software and hardware components this release of IPC Utils has been validated against.

Directory Structure

examples
    +---ti
        +---sdo
            +---opencl
            |   +---autoviz
            |   +---hello
            +---rcm
                +---hello
			+---tiler
			    +---examples
				    +---remote

Directory Conventions

Important: throughout the rest of this document, we will use the following notation:

<FC_INSTALL_DIR> - the root directory of your FC installation. The FC packages are in the <FC_INSTALL_DIR>/packages directory (or repository); the original examples are in the <FC_INSTALL_DIR>/examples directory (or repository).
<XDAIS_INSTALL_DIR> - the root directory of your XDAIS installation. Some distributions of this FC release include an fctools directory which contains an XDAIS release. In the case of those distributions, <XDAIS_INSTALL_DIR> could be set to <FC_INSTALL_DIR>/fctools. Note that the XDAIS packages will be located in the <XDAIS_INSTALL_DIR>/packages directory (or repository).
<XDC_INSTALL_DIR> - the root directory of your XDC tools installation. The FC examples now have a dependency on the XDC tools std.h header file. If you have installed DSP BIOS, you can set <XDC_INSTALL_DIR> to <BIOS_INSTALL_DIR>/xdctools. Otherwise, set <XDC_INSTALL_DIR> to the root directory of your XDC tools installation.

Preparing to Build the Examples

Create a working directory

Create a working directory (e.g. c:/myPackages) and copy the examples directory into it (e.g. c:/myPackages/examples). This will be where you build and modify the IPC Utils examples.

Doing this will ensure you have a backup copy of the original examples, as provided by the IPC Utils product.

Building examples under ti/sdo/opencl

1. Manage makefile

Under individual examples in the ti/sdo/opencl directory, there is a makefile that will need to be edited for your particular usecase. Edit the following variables described below

2. Dependencies

Dependencies can be set in makefile

INSTALL_DIR

The many INSTALL_DIR variables let you set the path to other dependent components. Depending on the programs you are building and the devices you build for, you will need to set the path for one or more of these components. If your distribution includes fctools/, you can set many of these variables to $(FC_INSTALL_DIR)/fctools.

Codegen Tools

Correct code generation tool paths will need to be specified for the architectures you will be building for. For instance, to build for the C6472 device, you will need to set the appropriate cgtools variables to the TI C64x toolchain location.
Note that for TI toolchains, this is the directory that contains bin/, include/, and lib/ subdirectories.

2. Build examples

In your specific example directory (for e.g., ti/sdo/opencl/examples/autoviz), type

gmake clean
gmake

This will build all the examples that are specified in the makefile

Last updated: August 10, 2012