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

This commit is contained in:
raiden00pl 2023-10-27 14:08:46 +02:00 committed by Xiang Xiao
parent 896727b576
commit f9d088590a
24 changed files with 294 additions and 239 deletions

View File

@ -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.

View File

@ -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

View File

@ -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.

View File

@ -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``.

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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