From 5029575d531576c6818094334dcae95359bdd119 Mon Sep 17 00:00:00 2001 From: patacongo Date: Fri, 18 Mar 2011 17:22:50 +0000 Subject: Update to apps/build git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3391 42af7a65-404d-4744-a932-0658087f49c3 --- nuttx/Documentation/NuttxPortingGuide.html | 62 ++++++++++++++++++++++++------ 1 file changed, 51 insertions(+), 11 deletions(-) (limited to 'nuttx/Documentation/NuttxPortingGuide.html') diff --git a/nuttx/Documentation/NuttxPortingGuide.html b/nuttx/Documentation/NuttxPortingGuide.html index d7f65090f..6e5c1d565 100644 --- a/nuttx/Documentation/NuttxPortingGuide.html +++ b/nuttx/Documentation/NuttxPortingGuide.html @@ -12,7 +12,7 @@

NuttX RTOS Porting Guide

-

Last Updated: March 16, 2011

+

Last Updated: March 18, 2011

@@ -564,14 +564,20 @@ |-- <config1-dir> | |-- Make.defs | |-- defconfig +| |-- appconfig1 | `-- setenv.sh |-- <config2-dir> | |-- Make.defs | |-- defconfig +| |-- appconfig1 | `-- setenv.sh | ... `-- (other board-specific configuration sub-directories)/ - + +

+ 1Optional +

+

2.3.2 Summary of Files

2.3.2.1 Board Specific Logic

@@ -628,24 +634,35 @@

  • - defconfig: This is a configuration file similar to the Linux - configuration file. In contains variable/value pairs like: +

    + defconfig: This is a configuration file similar to the Linux + configuration file. In contains variable/value pairs like: +

    This configuration file will be used at build time:

    -
      +

      1. As a makefile fragment included in other makefiles, and
      2. to generate include/nuttx/config.h which is included by most C files in the system.
        3. -
      +

  • - setenv.sh: This is a script that you can include that will be installed at - the top level of the directory structure and can be sourced to set any - necessary environment variables. +

    + appconfig: This is another configuration file that is specific to the + application. This file is copied into the application build directory + when NuttX is configured. See ../apps/README.txt for further details. +

    +
    • +
  • +

    + setenv.sh: This is a script that you can include that will be installed at + the top level of the directory structure and can be sourced to set any + necessary environment variables. +

    • @@ -942,6 +959,7 @@ tools/ |-- mkdeps.sh |-- mkimage.sh |-- mknulldeps.sh +|-- mkromfsimg.sh |-- unlink.sh |-- winlink.sh `-- zipme @@ -974,12 +992,24 @@ tools/
  • Copy configs/<board-name>/[<config-dir>/]setenv.sh to ${TOPDIR}/setenv.sh, and
  • Copy configs/<board-name>/[<config-dir>/]defconfig to ${TOPDIR}/.config
    • + +

    + And if configs/<board-name>/[<config-dir>/appconfig exists in the board configuration directory: +

    + + +

    Where <board-name> is the name of one of the sub-directories of the NuttX configs/ directory. This sub-directory name corresponds to one of the supported boards identified above. - And <config-dir> is the optional, specific configuration directory for the board. + <config-dir> is the optional, specific configuration directory for the board. + And <app-dir> is the location of the optonal application directory.

    Automated Configuration. @@ -988,7 +1018,17 @@ tools/

    + +

    + And if configs/<board-name>/[<config-dir>/appconfig + exists and your application directory is not in the standard loction (../apps), + then you should also specify the location of the application directory on the +command line like: +

    +

    -- cgit v1.2.3