<td>Assembly language interface sample program source</td>
</tr>
<tr>
<td>TESTAS.SUB</td>
<td><code>TESTAS.SUB</code></td>
<td>SUBMIT file to build TESTAS sample program</td>
</tr>
<tr>
<td>Z80AS.COM</td>
<td><code>Z80AS.COM</code></td>
<td>Z80 assembler which assembles the output of COWFIX and other Z80 source files (see <ahref="https://github.com/Laci1953/Z80AS">https://github.com/Laci1953/Z80AS</a>)</td>
</tr>
</tbody>
@ -3459,11 +3459,11 @@ such, they require RomWBW to operate. They should be compatible with all
CP/M and compatible operations systems provided in RomWBW.</p>
<p>The enhanced files are:</p>
<ul>
<li>CGEN.COM</li>
<li>CPP.COM</li>
<li>OPTIM.COM</li>
<li>P1.COM</li>
<li>ZAS.COM (replaced with Z80AS)</li>
<li><code>CGEN.COM</code></li>
<li><code>CPP.COM</code></li>
<li><code>OPTIM.COM</code></li>
<li><code>P1.COM</code></li>
<li><code>ZAS.COM</code> (replaced with Z80AS)</li>
</ul>
<p>A thread discussing this enhanced version of HI-TECH C is found at
<p>The RomWBW distribution is a compressed zip archive file organized in a
set of directories. Each of these directories has its own ReadMe.txt
file describing the contents in detail. In summary, these directories
are:</p>
<table>
<thead>
<tr>
<th><strong>Directory</strong></th>
<th><strong>Description</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Binary</strong></td>
<td>The final output files of the build process are placed here. Most importantly, the ROM images with the file names ending in “.rom” and disk images ending in .img.</td>
</tr>
<tr>
<td><strong>Doc</strong></td>
<td>Contains various detailed documentation, both RomWBW specifically as well as the operating systems and applications.</td>
</tr>
<tr>
<td><strong>Source</strong></td>
<td>Contains the source code files used to build the software and ROM images.</td>
</tr>
<tr>
<td><strong>Tools</strong></td>
<td>Contains the programs that are used by the build process or that may be useful in setting up your system.</td>
</tr>
</tbody>
</table>
<h4id="building-from-source">Building from Source</h4>
<p>It is also very easy to modify and build custom ROM images that fully
tailor the firmware to your specific preferences. All tools required to
build custom ROM firmware under Windows are included – no need to
install assemblers, etc. The firmware can also be built using Linux or
MacOS after confirming a few standard tools have been installed.</p>
<h2id="installation-operation">Installation & Operation</h2>
<p>In general, installation of RomWBW on your platform is very simple. You
just need to program your ROM with the correct ROM image from the RomWBW
distribution. Subsequently, you can write disk images on your disk
@ -251,16 +325,65 @@ review the <a href="https://github.com/wwarthen/RomWBW/blob/master/RELEASE_NOTES
Notes</a>
for helpful release-specific information.</p>
<h2id="documentation">Documentation</h2>
<p>Documentation for RomWBW includes:</p>
<p>There are several documents that form the core of the RomWBW
documentation:</p>
<ul>
<li>
<p><ahref="UserGuide/">RomWBW User Guide</a> is the main user guide for RomWBW,
it covers the major topics of how to install, manage and use RomWBW,
and includes additional guidance to the use of some of the operating
systems supported by RomWBW</p>
</li>
<li>
<p><ahref="Hardware/">RomWBW Hardware</a> contains a description of all the
hardware platforms, and devices supported by RomWBW.</p>
</li>
<li>
<p><ahref="Applications/">RomWBW Applications</a> is a reference for the
ROM-hosted and OS-hosted applications created or customized to enhance
the operation of RomWBW.</p>
</li>
<li>
<p><ahref="Catalog/">RomWBW Disk Catalog</a> is a reference for the contents of
the disk images provided with RomWBW, with a description of many of
the files on each image</p>
</li>
<li>
<p><ahref="SystemGuide/">RomWBW System Guide</a> discusses much of the internal
design and construction of RomWBW. It includes a reference for the
RomWBW HBIOS API functions.</p>
</li>
</ul>
<p>Each of the operating systems and ROM applications included with RomWBW
are sophisticated tools in their own right. It is not reasonable to
fully document their usage. However, you will find complete manuals in
PDF format in the Doc directory of the distribution. The intention of
this documentation is to describe the operation of RomWBW and the ways
in which it enhances the operation of the included applications and
operating systems.</p>
<p>Since RomWBW is purely a software product for many different platforms,
the documentation does <strong>not</strong> cover hardware construction,
configuration, or troubleshooting – please see your hardware provider
<li><ahref="https://groups.google.com/forum/#!forum/rc2014-z80">RC2014 Google
Group</a></li>
<li><ahref="https://groups.google.com/forum/#!forum/retro-comp">retro-comp Google
Group</a></li>
</ul>
<h1id="acknowledgments">Acknowledgments</h1>
<p>Submission of issues and bugs are welcome at the <ahref="https://github.com/wwarthen/RomWBW">RomWBW GitHub
Repository</a>.</p>
<p>Also feel free to email Wayne Warthen at <ahref="mailto:wwarthen@gmail.com">wwarthen@gmail.com</a>. I am
happy to provide support adapting RomWBW to new or modified systems</p>
<h1id="contributions">Contributions</h1>
<p>All source code and distributions are maintained on GitHub.
Contributions of all kinds to RomWBW are very welcome.</p>
<h2id="acknowledgments">Acknowledgments</h2>
<p>I want to acknowledge that a great deal of the code and inspiration for
RomWBW has been provided by or derived from the work of others in the
RetroBrew Computers Community. I sincerely appreciate all of their
@ -359,7 +482,8 @@ let me know if I missed you!</p>
</li>
<li>creation of the Introduction and Hardware documents</li>
<li>Z3PLUS operating system disk image</li>
<li>COPYSL and SLABEL utility</li>
<li>COPYSL utility</li>
<li>SLABEL utility</li>
<li>a feature for RomWBW configuration by NVRAM</li>
<li>
<p>the /B bulk mode of disk assignment to the ASSIGN utility</p>
@ -407,9 +531,40 @@ let me know if I missed you!</p>
<li>
<p>Les Bird has contributed support for the NABU w/ Option Board</p>
</li>
<li>
<p>Rob Gowin created an online documentation site via MkDocs, and
contributed a driver for the Xosera FPGA-based video controller.</p>
</li>
</ul>
<p>Contributions of all kinds to RomWBW are very welcome.</p>
<h2id="related-projects">Related Projects</h2>
<p>Outside of the hardware platforms adapted to RomWBW, there are a variety
of projects that either target RomWBW specifically or provide a
RomWBW-specific variation. These efforts are greatly appreciated and are
listed below. Please contact the author if there are any other such
projects that are not listed.</p>
<h4id="z88dk">Z88DK</h4>
<p>Z88DK is a software powerful development kit for Z80 computers
supporting both C and assembly language. This kit now provides specific
library support for RomWBW HBIOS. The Z88DK project is hosted at
<li><ahref="https://groups.google.com/forum/#!forum/rc2014-z80">RC2014 Google
Group</a></li>
<li><ahref="https://groups.google.com/forum/#!forum/retro-comp">retro-comp Google
Group</a></li>
</ul>
<p>Submission of issues and bugs are welcome at the <ahref="https://github.com/wwarthen/RomWBW">RomWBW GitHub
Repository</a>.</p>
<p>Also feel free to email Wayne Warthen at <ahref="mailto:wwarthen@gmail.com">wwarthen@gmail.com</a>.</p></div>
<p>All contributions to RomWBW are subject to this license.</p></div>
wwarthen
8 months ago