Reorganize some AT91SAM3U files; Add an NSH kernel build configuration to the WaveSahhare Open1788 board

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@5732 42af7a65-404d-4744-a932-0658087f49c3

1 files changed, 62 insertions, 0 deletions

diff --git a/nuttx/configs/open1788/README.txt b/nuttx/configs/open1788/README.txt
index da3d91821..da41538cd 100644
--- a/nuttx/configs/open1788/README.txt
+++ b/nuttx/configs/open1788/README.txt
@@ -292,4 +292,66 @@ CONFIGURATION
        CONFIG_ARMV7M_TOOLCHAIN_BUILDROOT=y : Buildroot toolchain
        CONFIG_ARMV7M_OABI_TOOLCHAIN=y      : Older, OABI toolchain
 
+  knsh
+  ----
+    This is identical to the nsh configuration below except that NuttX
+    is built as a kernel-mode, monolithic module and the user applications
+    are built separately.  This build requires a special make command; not
+    just 'make' but make with the following two arguments:
 
+        make pass1 pass2
+
+    This is required because in the normal case (just 'make'), make will
+    create all dependencies then execute the pass1 and pass2 targets.  But
+    this example, pass2 depends on auto-generatd files produced during pass1.
+    This special make command ('make pass1 pass2') will make the dependencies
+    separately for each pass.
+
+    NOTES:
+ 
+    1. This configuration uses the mconf-based configuration tool.  To
+       change this configuration using that tool, you should:
+
+       a. Build and install the kconfig-mconf tool.  See nuttx/README.txt
+          and misc/tools/
+
+       b. Execute 'make menuconfig' in nuttx/ in order to start the
+          reconfiguration process.
+
+    2. Uses the older, OABI, buildroot toolchain.  But that is easily
+       reconfigured:
+
+       CONFIG_ARMV7M_TOOLCHAIN_BUILDROOT=y : Buildroot toolchain
+       CONFIG_ARMV7M_OABI_TOOLCHAIN=y      : Older, OABI toolchain
+
+    3. At the end of the build, there four files will top-level build
+       directory:
+
+       nuttx_user.elf    - The pass1 user-space ELF file
+       nuttx             - The pass2 kernel-space ELF file
+       nuttx_user.hex    - The pass1 Intel HEX format file
+       nuttx.hex         - The pass2 Intel HEX file
+       System.map        - Symbols in the kernel-space ELF file
+       User.map          - Symbols in the user-space ELF file
+
+  nsh
+  ---
+    Configures the NuttShell (nsh) located at examples/nsh.  The
+    Configuration enables both the serial NSH interface.
+
+    NOTES:
+ 
+    1. This configuration uses the mconf-based configuration tool.  To
+       change this configuration using that tool, you should:
+
+       a. Build and install the kconfig-mconf tool.  See nuttx/README.txt
+          and misc/tools/
+
+       b. Execute 'make menuconfig' in nuttx/ in order to start the
+          reconfiguration process.
+
+    2. Uses the older, OABI, buildroot toolchain.  But that is easily
+       reconfigured:
+
+       CONFIG_ARMV7M_TOOLCHAIN_BUILDROOT=y : Buildroot toolchain
+       CONFIG_ARMV7M_OABI_TOOLCHAIN=y      : Older, OABI toolchain