diff options
-rw-r--r-- | nuttx/Documentation/NuttX.html | 143 | ||||
-rw-r--r-- | nuttx/README.txt | 10 | ||||
-rw-r--r-- | nuttx/configs/README.txt | 3 | ||||
-rw-r--r-- | nuttx/configs/p112/README.txt | 3 |
4 files changed, 117 insertions, 42 deletions
diff --git a/nuttx/Documentation/NuttX.html b/nuttx/Documentation/NuttX.html index 49f48d2d6..d8d393a7c 100644 --- a/nuttx/Documentation/NuttX.html +++ b/nuttx/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: November 5, 2012</p> + <p>Last Updated: December 15, 2012</p> </td> </tr> </table> @@ -1234,12 +1234,13 @@ svn checkout -r5313 http://svn.code.sf.net/p/nuttx/code/trunk nuttx-code </li> </td> <td bgcolor="#e4e4e4" valign="top"> - <li>Zilog + <li>ZiLOG <ul> - <li><a href="#zilogz16f">Zilog Z16F</a> (1)</li> - <li><a href="#zilogez80acclaim">Zilog eZ80 Acclaim!</a> (1)</li> - <li><a href="#zilogz8encore">Zilog Z8Encore!</a> (2)</li> - <li><a href="#zilogz80">Zilog Z80</a> (2)</li> + <li><a href="#zilogz16f">ZiLOG Z16F</a> (1)</li> + <li><a href="#zilogez80acclaim">ZiLOG eZ80 Acclaim!</a> (1)</li> + <li><a href="#zilogz8encore">ZiLOG Z8Encore!</a> (2)</li> + <li><a href="#zilogz180">ZiLOG Z180</a> (1)</li> + <li><a href="#zilogz80">ZiLOG Z80</a> (2)</li> </ul> </li> </ul> @@ -2777,6 +2778,35 @@ BFD_ASSERT (*plt_offset != (bfd_vma) -1); <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> + <a name="zilogz180"><b>Zilog Z180</b>.</a> + </td> +</tr> +<tr> + <td><br></td> + <td> + <p> + <b>P112</b>. + The P112 is a hobbyist single board computer based on a 16MHz Z80182 with up to 1MB of memory, serial, +parallel and diskette IO, and realtime clock, in a 3.5-inch drive form factor.. + The P112 computer originated as a commercial product of "D-X Designs Pty Ltd"[ of Australia. + </p> + </p> + Dave Brooks was successfully funded through Kickstarter for and another run of P112 boards in November of 2012. + In addition Terry Gulczynski makes additional P112 derivative hobbyist home brew computers. + </p> + <ul> + <p> + <b>STATUS:</b> + Most of the NuttX is in port for both the Z80182 and for the P112 board. + Boards from Kickstarter project will not be available, however, until the first quarter of 2013. + So it will be some time before this port is verified on hardware. + </p> + <ul> + </td> +</tr> +<tr> + <td valign="top"><img height="20" width="20" src="favicon.ico"></td> + <td bgcolor="#5eaee1"> <a name="zilogz80"><b>Zilog Z80</b>.</a> </td> </tr> @@ -2842,7 +2872,7 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> - <b>Linux + GNU <code>make</code> + GCC/binutils</b> + <b>Linux + GNU <code>make</code> + GCC/binutils for Linux</b> </td> </tr> <tr> @@ -2866,7 +2896,7 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> - <b>Linux + GNU <code>make</code> + SDCC</b> + <b>Linux + GNU <code>make</code> + SDCC for Linux</b> </td> </tr> <tr> @@ -2885,7 +2915,7 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> - <b>Cygwin + GNU <code>make</code> + GCC/binutils</b> + <b>Windows with Cygwin + GNU <code>make</code> + GCC/binutils (custom built under Cygwin)</b> </td> </tr> <tr> @@ -2893,10 +2923,8 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <td> <p> This combination works well too. - It works just as well as the native Linux environment except - that compilation and build times are a little longer. - The custom NuttX <a href="http://sourceforge.net/projects/nuttx/files/buildroot/">buildroot</a> referenced above may be build in - the Cygwin environment as well. + It works just as well as the native Linux environment except that compilation and build times are a little longer. + The custom NuttX <a href="http://sourceforge.net/projects/nuttx/files/buildroot/">buildroot</a> referenced above may be build in the Cygwin environment as well. </p> </td> </tr> @@ -2904,7 +2932,7 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> - <b>Cygwin + GNU <code>make</code> + SDCC</b> + <b>Windows with Cygwin + GNU <code>make</code> + SDCC (custom built under Cygwin)</b> </td> </tr> <tr> @@ -2919,7 +2947,7 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> - <b>Cygwin + GNU <code>make</code> + Windows Native Toolchain</b> + <b>Windows with Cygwin + GNU <code>make</code> + Windows Native Toolchain</b> </td> </tr> <tr> @@ -2975,11 +3003,12 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block </ul> <p> <b>Supported Windows Native Toolchains</b>. - At present, only the Zilog Z16F, z8Encore, and eZ80Acclaim ports use a non-GCC native Windows - toolchain(the Zilog ZDS-II toolchain). - Support for Windows native GCC toolchains (CodeSourcery and devkitARM) is currently implemented - for the NXP LPC214x, STMicro STR71x, and Luminary LMS6918 ARM ports. - (but could easily be extended to any other GCC-based platform with a small effort). + At present, the following Windows native toolchains are in use: + <ol> + <li>GCC built for Windows (such as CodeSourcery, Atollic, devkitARM, etc.),</li> + <li>SDCC built for Windows,</li> + <li> the ZiLOG XDS-II toolchain for Z16F, z8Encore, and eZ80Acclaim parts.</li> + </ol> </p> </td> </tr> @@ -2987,6 +3016,55 @@ avr, m68k, m68hc11, m68hc12, m9s12, blackfin, m32c, h8, and SuperH ports.</block <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> + <b>Windows Native (<code>CMD.exe</code>) + GNUWin32 (including GNU <code>make</code>) + MinGW Host GCC compiler + Windows Native Toolchain</b> + </td> +</tr> + <td><br></td> + <td> + <p> + Build support has been added to support building natively in a Windes <code>CMD.exe</code> rather than in a POSIX-like environment. + </p> + <p> + This build: + </p> + <ol> + <li>Uses all Windows style paths</li> + <li>Uses primarily Windows batch commands from cmd.exe, with</li> + <li>A few extensions from GNUWin32</li> + </ol> + <p> + This capability first appeared in NuttX-6.24 and should still be considered a work in progress because: (1) it has not been verfied on all targets and tools, and (2) still lacks some of the creature-comforts of the more mature environments. + The windows native build logic initiatiated if <code>CONFIG_WINDOWS_NATIVE=y</code> is defined in the NuttX configuration file: + </p> + <p> + At present, this build environment also requires: + </p> + <ul> + <li> + <b><code>CMD.exe</code> Shell</b>. + The build must be performed in a Windows <code>CMD.exe</code shell. + This may be the standard <code>cmd</code> shell that comes with Windows. + I prefer the ConEmu command shell which can be downloaded from: + http://code.google.com/p/conemu-maximus5/ + </li> + <li> + <b>GNUWin32</b>. + The build still relies on some Unix-like commands. + I usethe GNUWin32 tools that can be downloaded from http://gnuwin32.sourceforge.net/. + See the top-level <code>nuttx/README.txt</code> file for some download, build, and installation notes. + </li> + <li> + <b>MinGW-GCC</b>. + MinGW-GCC is used to compiler the C tools in the <code>nuttx/tools</code> directory that are neede by the build. + MinGW-GCC can be downloaded from http://www.mingw.org/. + If you are using GNUWin32, then it is recommendedthe you not install the optional MSYS components as there may be conflicts. + </li> + </td> +</tr> + +<tr> + <td valign="top"><img height="20" width="20" src="favicon.ico"></td> + <td bgcolor="#5eaee1"> <b>Wine + GNU <code>make</code> + Windows Native Toolchain</b> </td> </tr> @@ -3028,8 +3106,7 @@ if [ -x "$WINELOADER" ]; then exec "$WINELOADER" "$appname" "$@"; fi <tr> <td valign="top"><img height="20" width="20" src="favicon.ico"></td> <td bgcolor="#5eaee1"> - <b>Other Environments? - Windows Native <code>make</code> + Windows Native Toolchain?</b> + <b>Other Environments?</b> </td> </tr> <tr> @@ -3046,19 +3123,15 @@ if [ -x "$WINELOADER" ]; then exec "$WINELOADER" "$appname" "$@"; fi modification of the Make system would be required. </p> <p> - <b>GNUWin32</b>. - For example, with suitable make system changes, it should be possible to - use native GNU tools (such as those from - <a href="http://sourceforge.net/projects/gnuwin32/">GNUWin32</a>) - to build NuttX. - However, that environment has not been used as of this writing. - </p> - <p><small> - NOTE: One of the members on the <a href="http://tech.groups.yahoo.com/group/nuttx/">NuttX forum</a> - reported that they successful built NuttX using such a GNUWin32-based, Windows native environment. - They reported that the only necessary change was to the use the NTFS mklink command to create links - (see <code>tools/copydir.sh</code> script). - </small></p> + <b>MSYS</b>. + I have not used MSYS but what I gather from talking with NuttX users is that MSYS can be used as an alternative to Cygwin in any of the above Cygwin environments. + This is not surprising since MSYS is based on an older version of Cygwin (cygwin-1.3). + MSYS has been modified, however, to interoperate in the Windows environment better than Cygwin and that may be of value to some users. + </p> + <p> + MSYS, however, cannot be used with the native Windows NuttX build because it will invoke the MSYS bash shell instead of the <code>CMD.exe</code> shell. + Use GNUWin32 in the native Windows build envionment. + </p> </td> </tr> </table></center> diff --git a/nuttx/README.txt b/nuttx/README.txt index 9ad499d3f..b9210277e 100644 --- a/nuttx/README.txt +++ b/nuttx/README.txt @@ -499,16 +499,14 @@ Native Windows Build -------------------- The beginnings of a Windows native build are in place but still not full - usable as of this writing. The windows native build logic is currently - separate and must be started by: - - make -f Makefile.win + usable as of this writing. The windows native build logic initiatiated + if CONFIG_WINDOWS_NATIVE=y is defined in the NuttX configuration file: This build: - Uses all Windows style paths - Uses primarily Windows batch commands from cmd.exe, with - - A few extensions from GNUWin32 (or MSYS is you prefer) + - A few extensions from GNUWin32 In this build, you cannot use a Cygwin or MSYS shell. Rather the build must be performed in a Windows CMD shell. Here is a better shell than than the @@ -517,8 +515,6 @@ Native Windows Build Build Tools. The build still relies on some Unix-like commands. I use the GNUWin32 tools that can be downloaded from http://gnuwin32.sourceforge.net/. - The MSYS tools are probably also a option but are likely lower performance - since they are based on Cygwin 1.3. Host Compiler: I use the MingGW compiler which can be downloaded from http://www.mingw.org/. If you are using GNUWin32, then it is recommended diff --git a/nuttx/configs/README.txt b/nuttx/configs/README.txt index e7f73f945..21aace2af 100644 --- a/nuttx/configs/README.txt +++ b/nuttx/configs/README.txt @@ -1804,6 +1804,9 @@ configs/p112 Hal Bower was very active in the mid 1990's on the P112 project and ported the "Banked/Portable BIOS". + Dave Brooks was successfully funded through Kickstarter for and another + run of P112 boards in November of 2012. + configs/pic32-starterkit This directory contains the port of NuttX to the Microchip PIC32 Ethernet Starter Kit (DM320004) with the Multimedia Expansion Board (MEB, DM320005). diff --git a/nuttx/configs/p112/README.txt b/nuttx/configs/p112/README.txt index 265024cca..7f49ffe90 100644 --- a/nuttx/configs/p112/README.txt +++ b/nuttx/configs/p112/README.txt @@ -24,6 +24,9 @@ Gulczynski makes additional P112 derivative hobbyist home brew computers. Hal Bower was very active in the mid 1990's on the P112 project and ported the "Banked/Portable BIOS". +Dave Brooks was successfully funded through Kickstarter for and another +run of P112 boards in November of 2012. + Pin Configuration ================= |