Skip to content

Commit

Permalink
Documentation: migrate boards/{z16|z80}/xxx/configs/README.txt
Browse files Browse the repository at this point in the history
  • Loading branch information
raiden00pl authored and xiaoxiang781216 committed Oct 28, 2023
1 parent 896727b commit f9d0885
Show file tree
Hide file tree
Showing 24 changed files with 294 additions and 239 deletions.
67 changes: 67 additions & 0 deletions Documentation/platforms/z16/z16f/boards/z16f2800100zcog/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
17 changes: 17 additions & 0 deletions Documentation/platforms/z80/ez80/boards/ez80f910200kitg/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
34 changes: 34 additions & 0 deletions Documentation/platforms/z80/ez80/boards/ez80f910200zco/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
60 changes: 60 additions & 0 deletions Documentation/platforms/z80/ez80/boards/makerlisp/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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``.
83 changes: 83 additions & 0 deletions Documentation/platforms/z80/ez80/boards/z20x/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
17 changes: 17 additions & 0 deletions Documentation/platforms/z80/z8/boards/z8encore000zco/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
16 changes: 16 additions & 0 deletions Documentation/platforms/z80/z8/boards/z8f64200100kit/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
48 changes: 0 additions & 48 deletions boards/z16/z16f/z16f2800100zcog/configs/nsh/README.txt

This file was deleted.

Loading

0 comments on commit f9d0885

Please sign in to comment.