12.5.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.

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.


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

    RealView Debugger uses this to bind the project to the debug target that has 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.

    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.


    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.



    The Command field must be filled 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.

    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 Appendix B Project Properties Reference for details on how to amend this default makefile command.

    Use the fields below to populate the makefile command line or set up the command manually.

    File Arg

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


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


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


    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 © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B