diff options
author | patacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3> | 2011-04-14 19:17:41 +0000 |
---|---|---|
committer | patacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3> | 2011-04-14 19:17:41 +0000 |
commit | c548df2a3788bfe7527f7fef439d1365cb095e7c (patch) | |
tree | dfdd15e41f6140c6d31674ef3352d4217446ed0d /nuttx/Documentation/NuttxPortingGuide.html | |
parent | c8240be02d71629918b38fe85f9071e5f76a2dc5 (diff) | |
download | px4-nuttx-c548df2a3788bfe7527f7fef439d1365cb095e7c.tar.gz px4-nuttx-c548df2a3788bfe7527f7fef439d1365cb095e7c.tar.bz2 px4-nuttx-c548df2a3788bfe7527f7fef439d1365cb095e7c.zip |
Documentation update
git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3505 42af7a65-404d-4744-a932-0658087f49c3
Diffstat (limited to 'nuttx/Documentation/NuttxPortingGuide.html')
-rw-r--r-- | nuttx/Documentation/NuttxPortingGuide.html | 66 |
1 files changed, 62 insertions, 4 deletions
diff --git a/nuttx/Documentation/NuttxPortingGuide.html b/nuttx/Documentation/NuttxPortingGuide.html index b55dc6fd9..4f9b0694f 100644 --- a/nuttx/Documentation/NuttxPortingGuide.html +++ b/nuttx/Documentation/NuttxPortingGuide.html @@ -12,7 +12,7 @@ <h1><big><font color="#3c34ec"> <i>NuttX RTOS Porting Guide</i> </font></big></h1> - <p>Last Updated: April 7, 2011</p> + <p>Last Updated: April 14, 2011</p> </td> </tr> </table> @@ -981,7 +981,11 @@ include/ <ul><pre> tools/ |-- Makefile.host +|-- README.txt |-- configure.sh +|-- cfgparser.c +|-- cfgparser.h +|-- define.sh |-- incdir.sh |-- indent.sh |-- link.sh @@ -990,11 +994,19 @@ tools/ |-- mkimage.sh |-- mknulldeps.sh |-- mkromfsimg.sh +|-- mksyscall.c +|-- mkversion.c |-- unlink.sh +|-- version.sh |-- winlink.sh -`-- zipme +`-- zipme.sh </pre></ul> +<p> + Refer to the README file in the <code>tools</code> directory for more information about the individual files. + Some of these tools are discussed below as well in the discussion of <a href="#configandbuild">configuring and building</a> NuttX. +</p> + <h2>2.16 <a name="topmakefile">nuttx/Makefile</a></h2> <p> The top-level <code>Makefile</code> in the <code>${TOPDIR}</code> directory contains all of the top-level control @@ -1105,7 +1117,7 @@ netutils/ <p> And if <code>configs/</code><i><board-name></i><code>/[</code><i><config-dir></i><code>/appconfig</code> exists and your application directory is not in the standard loction (<config>../apps</config>), - then you should also specify the location of the application directory on the +command line like: + then you should also specify the location of the application directory on the command line like: </p> <ul><pre> cd tools @@ -1113,6 +1125,51 @@ netutils/ </pre></ul> <p> + <b>Version Files</b>. + The NuttX build expects to find a version file located in the top-level NuttX build directory. + That version file is called <code>.version</code>. + The correct version file is installed in each versioned NuttX released. + However, if you are working from an SVN snapshot, then there will be no version file. + If there is no version file, the top-level <code>Makefile</code> will create a dummy <code>.version</code> file on the first make. + This dummy version file will contain all zeroes for version information. + If that is not what you want, they you should run the <code>version.sh</code> script to create a better <code>.version</code> file. +</p> + +<p> + You can get help information from the <code>version.sh</code> script using the <code>-h</code> option. + For example: +</p> +<ul><pre> +$ tools/version.sh -h +tools/version.sh is a tool for generation of proper version files for the NuttX build + +USAGE: tools/version.sh [-d|-h] [-b build] -v <major.minor> <outfile-path> + +Where: + -d + Enable script debug + -h + show this help message and exit + -v <major.minor> + The NuttX version number expressed a major and minor number separated + by a period + <outfile-path> + The full path to the version file to be created +</pre></ul> + +<p> + As an example, the following command will generate a version file for version 6.1 using the current SVN revision number: +</p> +<ul><pre> +tools/version.h -v 6.1 .version +</pre></ul> + +<p> + The <code>.version</code> file is also used during the build process to create a C header file at <code>include/nuttx/version.h</code> that contains the same version information. + That version file may be used by your C applications for, as an example, reporting version information. +</p> + +<p> <b>Additional Configuration Steps</b>. The remainder of configuration steps will be performed by <a href="#topmakefile"><code>${TOPDIR}/Makefile</code></a> the first time the system is built as described below. @@ -1154,7 +1211,8 @@ The system can be re-made subsequently by just typing <code>make</code>. These additional steps include: </p> <ul> - <li>Auto-generating the file <code>include/nuttx/config.</code> using the <code>${TOPDIR}/.config</code> file. + <li>Auto-generating the file <code>include/nuttx/config.h</code> using the <code>${TOPDIR}/.config</code> file. + <li>Auto-generating the file <code>include/nuttx/version.h</code> using the <code>${TOPDIR}/.version</code> file. <li>Creating a link to <code>${TOPDIR}/arch/</code><i><arch-name></i><code>/include</code> at <code>${TOPDIR}/include/arch</code>. <li>Creating a link to <code>${TOPDIR}/configs/</code><i><board-name></i><code>/include</code> at <code>${TOPDIR}/include/arch/board</code>. <li>Creating a link to <code>${TOPDIR}/configs/</code><i><board-name></i><code>/src</code> at <code>${TOPDIR}/arch/</code><i><arch-name></i><code>/src/board</code> |