Documentation: migrate boards/{z16|z80}/xxx/configs/README.txt

Documentation/platforms/z16/z16f/boards/z16f2800100zcog/index.rst

@@ -5,3 +5,70 @@ z16f2800100zcog
 z16f Microcontroller.  This port use the Zilog z16f2800100zcog
 development kit and the Zilog ZDS-II Windows command line tools.  The
 development environment is Cygwin under WinXP.
+
+
+Configurations
+==============
+
+nsh
+---
+
+**Loading and Executing Code**
+
+1. Copy the files to this directory as described above
+2. Connect the ZiLOG XTools USB debugger.
+3. Install the USB driver from the ZDS-II device_drivers directory
+4. Start ZDS-II and load the nsh.zfpproj project
+5. In the debug tab, connect to the debugger
+6. In the debug tab, load code, reset, and go
+
+**Console Output**
+
+Interaction with NSH is via the serial console at 57600 8N1 baud.
+
+**STATUS**
+
+1. Note that you must apply the ZNEO patch if you are using ZDS-II 5.0.1.
+   See the README.txt file in the parent directory for more information.
+   This configuration does run correctly with the path applied.
+
+2. I bet that this code, like ostest, will not run if started by a hardware
+   reset.  It may only run when started via the debugger.
+
+
+ostest
+------
+
+**OSTEST Project**
+
+``ostest.zfpproj``
+  is a simple ZDS II - ZNEO 5.0.1 project that will allow you
+  to use the ZDS-II debugger.  Before using, copy the following files from
+  the toplevel directory::
+
+    nuttx.hex, nuttx.map, nuttx.lod
+
+  to this directory as::
+
+    ostest.hex, ostest.map, ostest.lod
+
+**Loading and Executing Code**
+
+1. Copy the files to this directory as described above
+2. Connect the ZiLOG XTools USB debugger.
+3. Install the USB driver from the ZDS-II device_drivers directory
+4. Start ZDS-II and load the ostest.zfpproj project
+5. In the debug tab, connect to the debugger
+6. In the debug tab, load code, reset, and go
+
+Hmmm... it appears that the code does not run if started by a hardware reset.
+It runs only when started via the debugger.  What is up with that?
+
+**Console Output**
+
+OS test results will be provided on the serial console at 57600 8N1 baud.
+
+**STATUS**
+
+This example works fine when started from ZDS-II.  But I have seen problems
+when starting from a hardware reset.

Documentation/platforms/z80/ez80/boards/ez80f910200kitg/index.rst

@@ -5,3 +5,20 @@ ez80f0910200kitg
 ez80Acclaim! Microcontroller.  This port use the Zilog ez80f0910200kitg
 development kit, eZ80F091 part, and the Zilog ZDS-II Windows command line
 tools.  The development environment is Cygwin under WinXP.
+
+
+Configurations
+==============
+
+ostest
+------
+
+``ostest.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+  Before using, copy the following files from the toplevel directory::
+
+    nuttx.hex, nuttx.map, nuttx.lod
+
+  to this directory as::
+
+    ostest.hex, ostest.map, ostest.lod

Documentation/platforms/z80/ez80/boards/ez80f910200zco/index.rst

@@ -5,3 +5,37 @@ ez80f0910200zco
 ez80Acclaim! Microcontroller.  This port use the Zilog ez80f0910200zco
 development kit, eZ80F091 part, and the Zilog ZDS-II Windows command line
 tools.  The development environment is Cygwin under WinXP.
+
+Configurations
+==============
+
+dhcpd
+-----
+
+``dhcpd.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+httpd
+-----
+
+``httpd.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+nettest
+-------
+
+``nettest.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+nsh
+---
+
+``nsh.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+
+poll
+----
+
+``poll.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.

Documentation/platforms/z80/ez80/boards/makerlisp/index.rst

@@ -6,3 +6,63 @@ This port use the MakerLisp machine based on an eZ80F091 ez80Acclaim!
 Microcontroller, and the Zilog ZDS-II Windows command line tools.  The
 development environment is Cygwin under Windows. A Windows native
 development environment is available but has not been verified.
+
+Configurations
+==============
+
+nsh_flash
+---------
+
+``nsh.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+``nsh.zfpproj``
+  is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``nsh_flash.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/makerlisp_ram.ztgt``.
+
+``nsh_ram.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/makerlisp_flash.ztgt``.
+
+nsh_ram
+-------
+
+``nsh.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+``nsh.zfpproj``
+  is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``nsh_flash.ztgt`` is the target file that accompanies the project files.  This
+  one is identical to boards/scripts/makerlisp_ram.ztgt.
+
+``nsh_ram.ztgt``
+  is the target file that accompanies the project files.  This
+  one is identical to boards/scripts/makerlisp_flash.ztgt.
+
+sdboot
+------
+
+``sdboot.zdsproj`` is a simple ZDS-II project that will allow you
+  to use the ZDS-II debugger.
+
+``sdboot.zfpproj`` is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``sdboot_flash.ztgt`` is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/makerlisp_ram.ztgt``.
+
+``sdboot_ram.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/makerlisp_flash.ztgt``.

Documentation/platforms/z80/ez80/boards/z20x/index.rst

@@ -4,3 +4,86 @@ z20x
 
 Microcontroller.  This directory holds the port of NuttX to the z80x board
 based on an ez80Acclaim! eZ80F091 microcontroller.
+
+Configurations
+==============
+
+
+hello
+-----
+
+``hello.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+``hello.zfpproj``
+  is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``hello_ram.ztgt`` is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/z20x_ram.ztgt``.
+
+``hello_flash.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/z20x_flash.ztgt``.
+
+nsh
+---
+
+``nsh.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+``nsh.zfpproj``
+  is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``nsh_ram.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/z20x_ram.ztgt``.
+
+``nsh_flash.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/z20x_flash.ztgt``.
+
+sdboot
+------
+
+``sdboot.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+``sdboot.zfpproj``
+  is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``sdboot_flash.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/z20x_ram.ztgt``.
+
+``sdboot_ram.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to ``boards/scripts/z20x_flash.ztgt``.
+
+w25boot
+-------
+
+``w25boot.zdsproj``
+  is a simple ZDS-II project that will allow you to use the ZDS-II debugger.
+
+``w25boot.zfpproj``
+  is a simple project that will allow you to use the Smart Flash
+  Programming.  NOTE:  As of this writing this project does not work, probably
+  due to RAM configuration in the project.  Use ZDS-II instead as is described
+  in the upper README.txt file
+
+``w25boot_flash.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to boards/scripts/z20x_ram.ztgt.
+
+``w25boot_ram.ztgt``
+  is the target file that accompanies the project files.
+  This one is identical to boards/scripts/z20x_flash.ztgt.

Documentation/platforms/z80/z8/boards/z8encore000zco/index.rst

@@ -5,3 +5,20 @@ z8encore000zco
 z8Encore! Microcontroller.  This port use the Zilog z8encore000zco
 development kit, Z8F6403 part, and the Zilog ZDS-II Windows command line
 tools.  The development environment is Cygwin under WinXP.
+
+Configurations
+==============
+
+ostest
+------
+
+``ostest.zfpproj``
+  is a simple ZDS-II project that will allow you
+  to use the ZDS-II debugger.  Before using, copy the following
+  files from the toplevel directory::
+
+    nuttx.hex, nuttx.map, nuttx.lod
+
+  to this directory as::
+
+    ostest.hex, ostest.map, ostest.lod

Documentation/platforms/z80/z8/boards/z8f64200100kit/index.rst

@@ -6,3 +6,19 @@ z8Encore! Microcontroller.  This port use the Zilog z8f64200100kit
 development kit, Z8F6423 part, and the Zilog ZDS-II Windows command line
 tools.  The development environment is Cygwin under WinXP.
 
+Configurations
+==============
+
+ostest
+------
+
+``ostest.zfpproj``
+  is a simple ZDS-II project that will allow you
+  to use the ZDS-II debugger.  Before using, copy the following
+  files from the toplevel directory::
+
+    nuttx.hex, nuttx.map, nuttx.lod
+
+  to this directory as::
+
+    ostest.hex, ostest.map, ostest.lod

boards/z16/z16f/z16f2800100zcog/configs/nsh/README.txt

@@ -1,48 +0,0 @@
-README.txt
-==========
-
-Contents
---------
-
-  o NSH Project
-  o Loading and Executing Code
-  o Console Output
-  o STATUS
-
-NSH Project
------------
-
-nsh.zfpproj is a simple ZDS II - ZNEO 5.0.1 project that will allow you
-  to use the ZDS-II debugger.  Before using, copy the following files from
-  the toplevel directory:
-
-    nuttx.hex, nuttx.map, nuttx.lod
-
-  to this directory as:
-
-    nsh.hex, nsh.map, nsh.lod
-
-Loading and Executing Code
---------------------------
-
-1. Copy the files to this directory as described above
-2. Connect the ZiLOG XTools USB debugger.
-3. Install the USB driver from the ZDS-II device_drivers directory
-4. Start ZDS-II and load the nsh.zfpproj project
-5. In the debug tab, connect to the debugger
-6. In the debug tab, load code, reset, and go
-
-Console Output
---------------
-
-Interaction with NSH is via the serial console at 57600 8N1 baud.
-
-STATUS
-------
-
-1. Note that you must apply the ZNEO patch if you are using ZDS-II 5.0.1.
-   See the README.txt file in the parent directory for more information.
-   This configuration does run correctly with the path applied.
-
-2. I bet that this code, like ostest, will not run if started by a hardware
-   reset.  It may only run when started via the debugger.

boards/z16/z16f/z16f2800100zcog/configs/ostest/README.txt

@@ -1,39 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-OSTEST Project
---------------
-
-ostest.zfpproj is a simple ZDS II - ZNEO 5.0.1 project that will allow you
-  to use the ZDS-II debugger.  Before using, copy the following files from
-  the toplevel directory:
-
-    nuttx.hex, nuttx.map, nuttx.lod
-
-  to this directory as:
-
-    ostest.hex, ostest.map, ostest.lod
-
-Loading and Executing Code
---------------------------
-
-1. Copy the files to this directory as described above
-2. Connect the ZiLOG XTools USB debugger.
-3. Install the USB driver from the ZDS-II device_drivers directory
-4. Start ZDS-II and load the ostest.zfpproj project
-5. In the debug tab, connect to the debugger
-6. In the debug tab, load code, reset, and go
-
-Hmmm... it appears that the code does not run if started by a hardware reset.
-It runs only when started via the debugger.  What is up with that?
-
-Console Output
---------------
-
-OS test results will be provided on the serial console at 57600 8N1 baud.
-
-STATUS
-------
-
-This example works fine when started from ZDS-II.  But I have seen problems
-when starting from a hardware reset.

boards/z80/ez80/ez80f910200kitg/configs/ostest/README.txt

@@ -1,12 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-ostest.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.  Before using, copy the following
-  files from the toplevel directory:
-
-  nuttx.hex, nuttx.map, nuttx.lod
-
-  to this directory as:
-
-  ostest.hex, ostest.map, ostest.lod

boards/z80/ez80/ez80f910200zco/configs/dhcpd/README.txt

@@ -1,5 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-dhcpd.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.

boards/z80/ez80/ez80f910200zco/configs/httpd/README.txt

@@ -1,5 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-httpd.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.

boards/z80/ez80/ez80f910200zco/configs/nettest/README.txt

@@ -1,5 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-nettest.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.

boards/z80/ez80/ez80f910200zco/configs/nsh/README.txt

@@ -1,5 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-nsh.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.

boards/z80/ez80/ez80f910200zco/configs/poll/README.txt

@@ -1,5 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-poll.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.

boards/z80/ez80/makerlisp/configs/nsh_flash/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-nsh.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-nsh.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-nsh_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/makerlisp_ram.ztgt.
-nsh_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/makerlisp_flash.ztgt.

boards/z80/ez80/makerlisp/configs/nsh_ram/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-nsh.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-nsh.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-nsh_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/makerlisp_ram.ztgt.
-nsh_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/makerlisp_flash.ztgt.

boards/z80/ez80/makerlisp/configs/sdboot/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-sdboot.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-sdboot.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-sdboot_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/makerlisp_ram.ztgt.
-sdboot_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/makerlisp_flash.ztgt.

boards/z80/ez80/z20x/configs/hello/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-hello.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-hello.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-hello_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_ram.ztgt.
-hello_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_flash.ztgt.

boards/z80/ez80/z20x/configs/nsh/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-nsh.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-nsh.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-nsh_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_ram.ztgt.
-nsh_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_flash.ztgt.

boards/z80/ez80/z20x/configs/sdboot/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-sdboot.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-sdboot.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-sdboot_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_ram.ztgt.
-sdboot_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_flash.ztgt.

boards/z80/ez80/z20x/configs/w25boot/README.txt

@@ -1,13 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-w25boot.zdsproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.
-w25boot.zfpproj is a simple project that will allow you to use the Smart Flash
-  Programming.  NOTE:  As of this writing this project does not work, probably
-  due to RAM configuration in the project.  Use ZDS-II instead as is described
-  in the upper README.txt file
-w25boot_flash.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_ram.ztgt.
-w25boot_ram.ztgt is the target file that accompanies the project files.  This
-  one is identical to boards/scripts/z20x_flash.ztgt.

boards/z80/z8/z8encore000zco/configs/ostest/README.txt

@@ -1,12 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-ostest.zfpproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.  Before using, copy the following
-  files from the toplevel directory:
-
-  nuttx.hex, nuttx.map, nuttx.lod
-
-  to this directory as:
-
-  ostest.hex, ostest.map, ostest.lod

boards/z80/z8/z8f64200100kit/configs/ostest/README.txt

@@ -1,12 +0,0 @@
-README.txt
-^^^^^^^^^^
-
-ostest.zfpproj is a simple ZDS-II project that will allow you
-  to use the ZDS-II debugger.  Before using, copy the following
-  files from the toplevel directory:
-
-  nuttx.hex, nuttx.map, nuttx.lod
-
-  to this directory as:
-
-  ostest.hex, ostest.map, ostest.lod