3.4. Steps for creating a Custom project

The steps described in this section assume that you have performed the first three steps described in Common steps for creating a user-defined project.

This section also describes:

To create a Custom project:

  1. Complete the entries on the Create Custom Project dialog box:

    Project Name

    This shows the name specified for the new project.

    Toolchain

    Select the toolchain to use for this project from the drop-down list.

    RealView Debugger uses this to bind the project to all available debug targets that have the same processor type.

    Select type of Custom Project

    Specifies how the image is built for the project and determines what additional information you must provide.

    Make a makefile (your own makefile)

    Uses the default make command together with your makefile to build the image.

    For a Custom project, the project base directory must contain your makefile.

    Run Command (your own tool/builder)

    Uses your own build tool command to build the image. You must enter the command in the Command field.

    If you want to use the command expansion controls, $a, $e, and $f, then you must specify the information in the corresponding field.

    Note

    To build your Custom project successfully, you must remove the $e control character, and use your own arguments as required. See Using your own make command.

    No-Build (echo Arguments as message only)

    If you do not want to build an image for this project.

    Command

    This data field contains the default make command used for the new project, for example, make -f $f $a $e.

    You can also use the project path expansion control $p in the command, for example, make -f $p\$f. The path expansion control uses the path you specified in the Project Base data field, see Common steps for creating a user-defined project for details.

    See Using your own make command for details on how to amend this default makefile command.

    Use the File Arg, Arguments, and Executable fields to populate the makefile command line or set up the command manually.

    Note

    The Command field must be filled in even when the project specifies a no-build model, for example use a dummy entry such as dummy.

    Do not enter any other command here, for example to run a batch file.

    File Arg

    This data field contains the name of the makefile, that is $f.

    By default, the name of the makefile is the same as the name of the new Custom project. If your makefile has a different name, change the name in this field so that it is correct.

    Arguments

    This data field contains the arguments to the command, that is $a.

    Executable

    This data field contains the executable file to build, that is $e.

    Description

    This data field contains a text description for the new project, saved in the PROJECT group.

  2. Click OK to confirm the project details and close the Create Custom Project dialog box.

  3. Make any changes to the project properties to customize the new project. See Customizing and building your project.

Copyright © 2005, 2006 ARM Limited. All rights reserved.ARM DUI 0291C
Non-Confidential