diff --git a/Documentation/NuttX.html b/Documentation/NuttX.html index 6929f54e1c2..c8e89dc6868 100644 --- a/Documentation/NuttX.html +++ b/Documentation/NuttX.html @@ -8,7 +8,7 @@
Last Updated: March 20, 2011
+Last Updated: March 21, 2011
nuttx-5.19 Release Notes: +
nuttx-6.0 Release Notes:
- The 66th release of NuttX, Version 5.19, was made on March 12, 2011 and is available for download from the + The 67th release of NuttX, Version 6.0, was made on March 21, 2011 and is available for download from the SourceForge website. The change log associated with the release is available here. Unreleased changes after this release are available in SVN. These unreleased changes are listed here.
- This release includes several new features in various states of integration and maturity: + The version number of this release was bumped from 5.19 to 6.0. + A change in the major revision number is used to reflect an incompatibility with previous versions. + In this release, the NuttX core OS functionality has been separated from NuttX application-related functionality. + These are provided as separate tarballs:
nuttx-6.0.tar.gz, andapps-6.0.tar.gz+ The purpose of this separation is both to better organize and modularize the NuttX source tree, + but also to provide better support for incorporation of end-user applications with Nuttx. +
++ The incompatibily results from the changes to the board configuration logic needed to supported the separable application. + The major changes to the configuration include: +
+CONFIG_APPS_DIR - This should not, typically be set.
+ The default is ../apps.
+ This should only be set if you have a custom, product-specific application directory in some different location.
apps/ directory appears in this port.
- This apps/ directory provides a mechanism for applications using NuttX to have a highly customizable initialization process.
- It supports a set of end-user applications than can be executed
- (1) standalone so you can have a fully customizable application startup, or
- (2) on top of NSH.
- Think of it this way:
- In a buckled-up embedded application, your end-user programs will probably have their own dedicated start-up logic.
- But, during development, you might want to have you applications available and executable from the NSH command line.
- This apps/ add-on (and NSH hooks) was contributed by Uros Platise to accomplish just that.
- /etc/init.d/rcS File.
- NSH was also extended to support application specific ROMFS /etc/init.d/rcS start-up scripts.
- This feature, as well, as all of the above-mentioned apps/ directory support was contributed by Uros Platise
- waitpid().
- New waitpid() system interface.
- appconfig - Each board configuration now requires a new file called appconfig.
+ As its name suggests, this file provides new configuration information needed by the logic in ../apps.
+ In addition to this major reorganization in the directory structure, this release also includes some important extensions to existing features and + some important bugfixes. + These include: +
+fopen() and STM32 GPIO configuration
+ + Please see the ChangeLog for details. +
|
- QEMU i486. + QEMU/Bifferboard i486. This port uses the QEMU i486 and the native Linux, Cywgin, MinGW the GCC toolchain under Linux or Cygwin. STATUS: - This port is code complete but not yet tested. Stayed tuned. + The basic port was code-complete in NuttX-5.19 and verifed in NuttX-6.0. + The port was verified using the OS and NuttShell (NSH) examples under QEMU. + The port is reported to be functional on the Bifferboard as well. + This is a great, stable starting point for anyone interest in fleshing out the x86 port! |
@@ -2074,113 +2068,7 @@ Other memory:
-nuttx-5.19 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr> - - * arch/arm/stm32/stm32_idle.c -- During idle times, the STM32 now uses the - WFI instruction to sleep in a reduced power mode until the next interrupt - occurs (Contributed by Uros Platise). - * NSH: 'mem' command renamed to 'free'. Output is now more similar to the - Linux 'free' command. - * NSH: Correct a redirection bug in NSH. The following would not work; it - resulted in a hang after the 'cat /dev/fifo': - - nsh> mkfile /dev/fifo - nsh> cd /tmp # /tmp is a mounted RAM disk - nsh> cat /dev/fifo > test.txt & - nsh> echo "This is a test" > /dev/fifo - - The error was caused because (1) there was a path that resulted in stdout - being closed (the "hang") and also (2) the 'cat' command was always outputting - to stdout, not to the redirected file descriptor. Now: - - nsh> cat test.txt - This is a test - - * drivers/pipes/pipe_common.c -- Driver open method was not returning an EINTR - error when it received a signal. Instead, it just re-started the wait. This - makes it impossible to kill a background pipe operation from NSH. - * include/stdint.h -- Correct some errors in conditional compilation (submitted - by Johannes Hampel). - * arch/arm/lpc17xx/lp17_idle.c -- Uses the same logic as the STM32: uses the - WFI instruction to sleep in a reduced power mode until the next interrupt - occurs. - * configs/olimex-lpc1766stk -- Added an LED encoded to indicate if the LPC1766 - is in sleeping. - * examples/mm -- This is a simplified version of the "built-in" memory manager - test of mm/mm_test.c. It is simplified because it does not have access to - the internals of the memory manager as does mm/mm_test.c, but it has the - advantage that it runs in the actual NuttX tasking environment (the - mm/mm_test.c only runs in a PC simulation environment). - * drivers/mmcsd_sdio.c/h -- Several corrections submitted by Uros Platise. - * arch/x86 - Provide support for x86 architectures. Support for the i486 - architecture under QEMU is provided under arch/x86/include/i486, - arch/x86/include/qemu, arch/x86/src/i486, and arch/x86/src/qemu. - * configs/qemu-i486 - "Board" support configurations for verifying the QEME - i486 port. - * arch/arm/src/stm32/stm32_spi.c -- Correct base address of SPI3 (reported by - Uros Platise). - * drivers/mmcsd/mmcsd_sdio.c -- Correct a loop termination condition (also - reported by Uros Platise). - * drivers/mtd/ramtron.c - Driver for SPI-based RAMTRON NVRAM devices FM25V10 - (and others). Contributed by Uros Platise. - * examples/nsh and tools/mkromfsimg.sh -- Add support for platform-specific - ROMFS-based NSH start-up scripts. - * drivers/uart_16550.c and include/nuttx/uart_16550.h - Support for a generic - 16550 UART. - * configure/qemu-i486/nsh - QEMU NSH example. - * ../apps - The apps directory add-on was created by Uros Platise. It - supports a set of end-user applications than can be executed on top of - NSH. Think of it this way: In a buckled-up embedded application, your - end-user programs will probably have their own dedicated start-up logic. - But, during development, you might want to have you applications - available and executable from the NSH command line. This apps/ addon - (and NSH hooks) was contributed by Uros to accomplish just that. - * sched/sched_waitpid() and include/sys/wait.h - Provides a simple and - very incomplete implementation of waitpid(). waitpid() is only available - if CONFIG_SCHED_WAITPID is defined in your configuration file. - * sched/atexit.c and sched/exit.c - The atexit function is not frequently - used. In order to save a few bytes, it is now conditioned on - CONFIG_SCHED_ATEXIT. It your application is currently using atexit(), - you will need to add CONFIG_SCHED_ATEXT to your configuration file. - * drivers/net/slip.c - Add a SLIP driver (untested on initial check-in). - * configs/olimex-lpc1766stk/slip-httpd - An example that uses SLIP to - provide a serial-port based THTTPD web server. - -apps-5.19 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr> - - * Initial version of the apps/ directory was released as contributed by - Uros Platise. - -pascal-2.0 2009-12-21 Gregory Nutt <spudmonkey@racsa.co.cr> - - * Updated to use standard C99 types in stdint.h and - stdbool.h. This change was necessary for compatibility - with NuttX-5.0 (any beyond). - -buildroot-1.9 2011-02-10 <spudmonkey@racsa.co.cr> - - * configs/arm926t-defconfig-4.3.3: update arm926t-defconfig-4.2.4 - * configs/arm926t-defconfig-nxflat: NXFLAT-only configuration for - arm926 - * toolchain/gdb/gdb.mk - Remove ncurses dependency from gdb_target target. - * toolchain/gdb/gdb.mk - Added --disable-werror to GDB configuration line. - GDB 6.8 won't build because the tarbal was released with -Werror enabled and - the build stops on the first warning. - * Add support for Freescale m9s12x using binutils 2.18 and gcc 3.3.6 and - patches available from http://www.msextra.com/tools courtesy of James - Cortina. Add configs/m9x12x-defconfig-3.3.6. -- -
| - Unreleased Changes - | -
-nuttx-5.20 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+nuttx-6.1 2011-03-21 Gregory Nutt <spudmonkey@racsa.co.cr>
* lib/lib_fopen() -- fopen() was not returning the correct errno value
when the underlying open() failed.
@@ -2229,7 +2117,7 @@ nuttx-5.20 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
* apps/vsn - Move all VSN apps to apps/vsn.
* nuttx/examples moved to apps/examples
-apps-5.20 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+apps-6.0 2011-03-21 Gregory Nutt <spudmonkey@racsa.co.cr>
* README.txt -- README cosmetics
* hello/ -- hello world minor changes
@@ -2238,6 +2126,39 @@ apps-5.20 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
* hello/Makefile -- Now uses new Make.defs definitions. Added README.txt.
* apps/poweroff -- New application to turn off board power.
+pascal-2.0 2009-12-21 Gregory Nutt <spudmonkey@racsa.co.cr>
+
+ * Updated to use standard C99 types in stdint.h and
+ stdbool.h. This change was necessary for compatibility
+ with NuttX-5.0 (any beyond).
+
+buildroot-1.9 2011-02-10 <spudmonkey@racsa.co.cr>
+
+ * configs/arm926t-defconfig-4.3.3: update arm926t-defconfig-4.2.4
+ * configs/arm926t-defconfig-nxflat: NXFLAT-only configuration for
+ arm926
+ * toolchain/gdb/gdb.mk - Remove ncurses dependency from gdb_target target.
+ * toolchain/gdb/gdb.mk - Added --disable-werror to GDB configuration line.
+ GDB 6.8 won't build because the tarbal was released with -Werror enabled and
+ the build stops on the first warning.
+ * Add support for Freescale m9s12x using binutils 2.18 and gcc 3.3.6 and
+ patches available from http://www.msextra.com/tools courtesy of James
+ Cortina. Add configs/m9x12x-defconfig-3.3.6.
+
+
+| + Unreleased Changes + | +
+nuttx-6.1 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+
+apps-6.1 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
+
pascal-2.1 2011-xx-xx Gregory Nutt <spudmonkey@racsa.co.cr>
buildroot-1.10 2011-xx-xx <spudmonkey@racsa.co.cr>
diff --git a/Documentation/NuttxPortingGuide.html b/Documentation/NuttxPortingGuide.html
index 85fc8010dca..3b00632fba9 100644
--- a/Documentation/NuttxPortingGuide.html
+++ b/Documentation/NuttxPortingGuide.html
@@ -12,7 +12,7 @@
NuttX RTOS Porting Guide
- Last Updated: March 20, 2011
+ Last Updated: March 21, 2011
@@ -1016,7 +1016,6 @@ netutils/
configs/<board-name>/[<config-dir>/appconfig to <app-dir>/.configecho "CONFIG_BUILTIN_APPS=y" >> "${TOPDIR}/.config"echo "APPS_LOC=\"<app-dir>\"" >> "${TOPDIR}/.config"
- CONFIG_APP_DIR: Identifies the directory that builds the application to link with NuttX.
- This symbol must be assigned to the path to the application build directory relative to the NuttX top build directory.
- If the application resides in the top-level apps directory, it is not necessary to define CONFIG_APP_DIR.
- If you had an application directory and the NuttX directory both within another directory like this:
+ CONFIG_APPS_DIR: Identifies the directory that builds the application to link with NuttX.
+ This symbol must be assigned to the path of the application build directory relative to the NuttX top build directory.
+ If the application resides in the top-level ../apps/ directory, it is not necessary to define CONFIG_APPS_DIR.
+ If you have an application directory and the NuttX directory each in separate directories such as this:
build
|-nuttx
@@ -2681,14 +2680,15 @@ build
|
`- Makefile
CONFIG_APP_DIR=../application.
+ Then you would set CONFIG_APPS_DIR=../application.
+ The default value of CONFIG_APPS_DIR is ../apps/.
The application direction must contain Makefile and this make file must support the following targets:
libapp$(LIBEXT) (usually libapp.a).
- libapp.a is a static library ( an archive) that contains all of application object files.
+ libapps$(LIBEXT) (usually libapps.a).
+ libapps.a is a static library ( an archive) that contains all of application object files.
clean.
@@ -2708,7 +2708,7 @@ build
When this application is invoked it will receive the setting TOPDIR like:
$(MAKE) -C $(CONFIG_APP_DIR) TOPDIR="$(TOPDIR)" <target>
+ $(MAKE) -C $(CONFIG_APPS_DIR) TOPDIR="$(TOPDIR)" <target>