Make RTL8187 driver an add-on

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

ChangeLog

@@ -1579,3 +1579,16 @@
 	  switching.  Basically, the logic was missing the cases to handle
 	  the differing stack frames when a priority change occurs and when
 	  no priority change occurs.
+	* configs/qemu-i486/ostest and nsh -- The QEMU i486 port is complete.
+	  it now passes the OS test and supports the NuttShell (NSH).
+	* misc/drivers -- Created a new directory to hold non-BSD licensed
+	  drivers that may be added into NuttX via an installation script.
+	* drivers/usbhost/usbhost_rtl8187.c -- A decision was made to
+	  incorporate code taken from the Linux kernel.  That changes the
+	  licensing on this module to GPL.  To avoid licensing contamination,
+	  this driver was moved to misc/drivers/rtl8187x *prior* to adding
+	  and of the GPL log.  There is an INSTALL.sh script at the location
+	  where the GPL driver(s) can be re-installed into the NuttX source
+	  tree.  By re-installing the driver, you agree to the GPL licsensing
+	  and all of its implications.
+

Documentation/NuttX.html

@@ -8,7 +8,7 @@
   <tr align="center" bgcolor="#e4e4e4">
     <td>
       <h1><big><font color="#3c34ec"><i>NuttX RTOS</i></font></big></h1>
-      <p>Last Updated: March 17, 2011</p>
+      <p>Last Updated: March 18, 2011</p>
     </td>
   </tr>
 </table>
@@ -2206,6 +2206,18 @@ nuttx-5.20 2011-xx-xx Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
       switching.  Basically, the logic was missing the cases to handle
       the differing stack frames when a priority change occurs and when
       no priority change occurs.
+    * configs/qemu-i486/ostest and nsh -- The QEMU i486 port is complete.
+      it now passes the OS test and supports the NuttShell (NSH).
+    * misc/drivers -- Created a new directory to hold non-BSD licensed
+      drivers that may be added into NuttX via an installation script.
+    * drivers/usbhost/usbhost_rtl8187.c -- A decision was made to
+      incorporate code taken from the Linux kernel.  That changes the
+      licensing on this module to GPL.  To avoid licensing contamination,
+      this driver was moved to misc/drivers/rtl8187x *prior* to adding
+      and of the GPL log.  There is an INSTALL.sh script at the location
+      where the GPL driver(s) can be re-installed into the NuttX source
+      tree.  By re-installing the driver, you agree to the GPL licsensing
+      and all of its implications.
 
 apps-5.20 2011-xx-xx Gregory Nutt &lt;spudmonkey@racsa.co.cr&gt;
 

configs/olimex-lpc1766stk/wlan/defconfig

@@ -816,7 +816,7 @@ CONFIG_EXAMPLES_NSH_DISABLEBG=n
 CONFIG_EXAMPLES_NSH_ROMFSETC=n
 CONFIG_EXAMPLES_NSH_CONSOLE=y
 CONFIG_EXAMPLES_NSH_TELNET=n
-CONFIG_EXAMPLES_NSH_ARCHINIT=y
+CONFIG_EXAMPLES_NSH_ARCHINIT=n
 CONFIG_EXAMPLES_NSH_IOBUFFER_SIZE=512
 CONFIG_EXAMPLES_NSH_DHCPC=n
 CONFIG_EXAMPLES_NSH_NOMAC=n

configs/qemu-i486/README.txt

@@ -14,6 +14,7 @@ Contents
   * Toolchains
     - Cygwin Buildroot Toolchain
     - Buildroot Instructions
+  * FAQ
   * Configurations
     - ostest
     - nsh
@@ -22,7 +23,7 @@ QEMU
 ====
 
 QEMU is a generic and open source machine emulator and virtualizer.  Here are
-some links (which are mostly outdated by the time your read this):
+some links (which will probably be mostly outdated by the time your read this):
 
   Home Page:     http://wiki.qemu.org/Main_Page
   Downloads:     http://wiki.qemu.org/Download
@@ -34,7 +35,7 @@ Building QEMU
 
   tar zxf qemu-0.14.0.tar.gz 
   cd qemu-0.14.0
-  ./configure
+  ./configure --target-list=i386-softmmu
   make
   make install
 
@@ -62,8 +63,8 @@ Cygwin Build Problems
     2. Try building QEMU with MingGW (I understand that this is difficult).
 
   NOTE: As of this writing, I have not been successful getting ANY pre-built
-  version of QEMU to work successful; they all fail immediately with
+  version of QEMU to work successfully with WinXP.  The same binaries work
-  initialization errors.
+  fine on Vista, however.
 
 Running QEMU
 ------------
@@ -72,6 +73,13 @@ Running QEMU
 
     qemu -cpu 486 -m 2 -kernel nuttx.elf -nographic
 
+  The -nographic option redirects COM1 to your console.  However, the -nographic
+  option does not work under Cygwin.  For simple testing under Cygwin, I use
+  
+    qemu -cpu 486 -m 2 -kernel nuttx.elf -serial file:test.txt
+
+  which will send COM1 output to the file test.txt.
+ 
 Toolchains
 ==========
 
@@ -125,6 +133,12 @@ Buildroot Instructions
   detailed PLUS some special instructions that you will need to follow if you
   run into problems building the toolchain for Cygwin under Windows.
 
+FAQ
+===
+
+Q: I get the following error message, "undefined reference to '__stack_chk_fail'"
+A: Add -fno-stack-protector to ARCHCPUFLAGS in you Make.defs file.
+
 Configurations
 ==============
 

drivers/usbhost/Make.defs

@@ -36,10 +36,16 @@
 USBHOST_ASRCS  =
 USBHOST_CSRCS  = hid_parser.c
 
+# Built-in USB driver logic
+
 ifeq ($(CONFIG_USBHOST),y)
 USBHOST_CSRCS  += usbhost_registry.c usbhost_registerclass.c usbhost_findclass.c
 USBHOST_CSRCS  += usbhost_enumerate.c usbhost_storage.c usbhost_hidkbd.c
+
+# Add-on USB driver logic (see misc/drivers)
+
 ifeq ($(CONFIG_NET),y)
-  USBHOST_CSRCS  += usbhost_rtl8187.c
+  RTL8187_CSRC  := ${shell if [ -f usbhost/rtl8187x.c ]; then echo "rtl8187x.c"; fi}
+  USBHOST_CSRCS += $(RTL8187_CSRC)
 endif
 endif