Bump Version

- Minor typos

.github/workflows/release.yml

@@ -52,6 +52,21 @@ jobs:
           title: "${{env.TITLE}} ${{github.ref_name}}"
           files: |
             RomWBW-${{github.ref_name}}-Package.zip
+
+      - name: Build Docs
+        run: |
+          export TZ='America/Los_Angeles'
+          sudo apt-get install gpp pandoc
+          pip install mkdocs
+          make -C Source/Doc deploy_mkdocs
+          mkdocs build -f Source/Doc/mkdocs.yml
+
+      - name: Deploy Docs
+        uses: peaceiris/actions-gh-pages@v4
+#       if: github.ref == 'refs/heads/master'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: Source/Doc/site
       
 #      - name: Upload Package Archive
 #        uses: AButler/upload-release-assets@v2.0.2

Doc/CPM/ReadMe.txt

@@ -68,3 +68,11 @@ ZSDOS is the DOS portion of Z-System.  This is the manual for ZSDOS
 1.x as included in RomWBW.  The installation instructions can be
 ignored since that work has already been completed as part of the
 RomWBW distribution.
+
+ZPM3 ("ZPM3.txt")
+-----------------
+
+A Z80 coded CP/M 3.0 compatible BDOS replacement with ZCPR support.
+This minimal documentation is all that is provided with ZPM3.
+
+-- WBW 8:38 AM 6/6/2025

Doc/CPM/ZPM3.txt

@@ -0,0 +1,483 @@
+
+                    Z P M 3   by Simeon Cran
+                    ========================
+
+          A Z80 coded CP/M 3.0 compatible BDOS replacement.
+
+               The first public release: 27/3/92
+                    This document dated: 16/6/92
+
+          Distributed at: Z-Node 62 (Perth, Western Australia)
+                     V21,V22,V22bis 09 450 0200
+
+
+WELCOME TO ZPM3
+~~~~~~~~~~~~~~~
+Welcome to the best CP/M compatible operating system for Z80 
+based computers with banked memory. The best? Yes, we believe so. 
+CP/M 3.0 has had bad press, but the fact is that it is faster 
+than CP/M 2.2 ever was, and it offered more integrated 
+facilities. Perhaps it was all the Z80 replacement BDOSes for 
+CP/M 2.2 which stole the limelight from CP/M 3.0, or was it just 
+that few computers had the required banked memory?
+
+Whatever the reason for CP/M 3.0's lack of success in the 
+marketplace, there are still plenty of users who will stand by 
+its wonderful facilities and speed. For those users ZPM3 provides 
+the long awaited Z80 coded update.
+
+ZPM3 offers all the good things that CP/M 3.0 does, and then it 
+offers more. Because ZPM3 is written in Z80 code rather than the 
+8080 code of CP/M 3.0, it can do everything that CP/M 3.0 does, 
+but in much less space. With the extra space recovered, ZPM3 
+packs in a number of new facilities. Yet the whole package fits 
+in exactly the same space as CP/M 3.0 so you can directly replace 
+your old CP/M 3.0 BDOS with ZPM3 without a worry.
+
+ZPM3 is also fast. Faster, in fact, than CP/M 3.0. This is 
+possible because the rich Z80 instruction set allows many 
+algorithms to be implemented more efficiently. In addition, the 
+extra space available in ZPM3 has been put to use to further 
+optimise the code. Lots of small optimisations smooth the 
+execution flow, so ZPM3 becomes the fastest operating system on 
+most banked CP/M computers.
+
+
+THE FEATURES
+~~~~~~~~~~~~
+ZPM3, in addition to complete CP/M 3.0 compatibility, offers the 
+following features:
+
+
+Random Read Bug fixed.
+++++++++++++++++++++++
+Maybe you didn't know, but CP/M 3.0 has a bug. It affects random 
+reads under very specific circumstances, and can result in a 
+program thinking that you don't have some pieces of data in a 
+file when in fact you do. The bug would occur very, very rarely, 
+but it is real. ZPM3 finally squashes it.
+
+
+Protected SCB User code
++++++++++++++++++++++++
+The System Control Block of CP/M 3.0 was a revolution at the 
+time. ZCPR has a system environment and most other operating 
+systems have other similar structures, but the SCB of CP/M 3.0 
+was one of the very first.
+
+Unfortunately, Digital Research never properly documented it, and 
+some programmers found things out about it that weren't quite 
+true and started programming accordingly. As well, because it is 
+available in the TPA bank, runaway programs can overwrite it 
+causing problems.
+
+Mostly though, the SCB will survive, or at least any problems 
+will be so obvious that the user will realise that a crash has 
+occurred and will reboot. A real problem exists with the CP/M 3.0 
+code however when the user value is written over with a value 
+above 15. Many programs now directly write to this byte, and if 
+they put a value in that is above 15, all sorts of havoc can 
+happen with the disk system. Actually, CP/M 3.0 will handle user 
+areas above 15 with this method, and all seems ok until the 
+operating system mistakes one of these directory entries as an 
+XFCB. Simply put, user areas above 15 must not be used with CP/M 
+3.0.
+
+ZPM3 has code which prevents these problems, making the system 
+even more stable.
+
+
+Obsoleted Trap system.
+++++++++++++++++++++++
+One of the problems of the banked operating system was that it 
+was possible to redirect the BIOS to code below common memory, in 
+which case the banked BDOS could not access it. One solution is 
+to call all BIOS code from common memory, but this involves a 
+bank switch for every BIOS call, and this slows things down 
+considerably.
+
+CP/M 3.0 got around the problem by providing special code just 
+below the SCB. If you redirected the BIOS, you also had to change 
+this code which caused a bank switch when your new BIOS routine 
+was called. When you removed the redirection, you also had to 
+restore the special code.
+
+This system has major drawbacks. For a start, if you redirect the 
+BIOS, then another program redirects your redirection, then you 
+remove your first redirection (along with the special code), the 
+bank switch won't happen for the second redirection and the 
+system will crash.
+
+If a CP/M 2.2 program tried to do the redirection, it would know 
+nothing about CP/M 3.0 and would not adjust the special code, so 
+a crash would result in that case too.
+
+The special code was called the "Trap System" as it was meant to 
+trap redirection (as long as you set the trap). ZPM3 has 
+eliminated the need for the traps. They are still there, and 
+programs can still fiddle with them, but it doesn't matter how 
+they are set, they are ignored. There is simply no need for them 
+anymore. And this has been achieved without a performance 
+penalty. In fact, in the case of a program which sets the traps 
+but forgets to restore them, performance is now much better.
+
+
+Semi-Permanent Read Only status for drives.
++++++++++++++++++++++++++++++++++++++++++++
+In recent years, a trend in CP/M 2.2 is to make drives which have 
+been set read only to remain that way until explicitly changed by 
+function 37. ZPM3 now adopts this logic. Previously a control-C 
+would return a read only drive to read write. The advantage is 
+that a program can now make a drive read only for a session and 
+know that it will stay that way.
+
+
+ZCPR compatible function 152
+++++++++++++++++++++++++++++
+Function 152 is the CP/M 3.0 parser. It was a great innovation at 
+the time as parsing is one of the more tedious aspects of 
+programming for CP/M. Unfortunately, almost as soon as it 
+appeared, it was made obsolete by the fact that it didn't handle 
+references to user number (DU references). A line such as 
+A:FILE.TYP would be correctly parsed, but A3:FILE.TYP would not. 
+CP/M 3.0 programs would often parse the drive and user 
+separately, then give function 152 the line without the DU: 
+reference. All this extra work should not have been necessary if 
+CP/M 3.0 had included user number parsing.
+
+ZPM3 parses the user number, and goes even further by handling 
+named directories for ZCPR. This is possible as long as you set a 
+special word in the SCB which tells ZPM3 where to find the ZCPR 
+system environment descriptor. ZCCP, a companion CCP for ZPM3, 
+handles this automatically, but for Z3PLUS users, a special 
+utility is available which automatically sets this word.
+
+The result is that CP/M 3.0 programs will not balk at DU: 
+references and ZPM3 aware programs can use the full DU: and DIR: 
+facilities of function 152. It has also made the brilliant ZCCP 
+code possible.
+
+
+New Functions 54 and 55
++++++++++++++++++++++++
+Datestamps in CP/M 3.0 are wonderful, but difficult to 
+manipulate. Two new functions make them easier to handle and at 
+the same time give compatibility to Z80DOS aware programs.
+
+Function 54 (Get Stamp) returns a Z80DOS compatible datestamp. 
+Any program (such as many directory programs) which recognise the 
+Z80DOS standard can make use of function 54. There is only one 
+slight difference between Z80DOS datestamps and ZPM3's which you 
+should be aware of. Z80DOS will return a correct datestamp after 
+any successful open or search of any extent. ZPM3 can only return 
+a correct datestamp after a successful open or search of the 
+first extent of the file. This is because CP/M 3.0 datestamps are 
+only saved for the first extents of each file, in order to 
+provide the highest performance.
+
+Even more interesting is Function 55 (Use Stamp) which provides a 
+mechanism for changing datestamps on files. Trying to do this 
+with CP/M 3.0 was virtually impossible because it involved direct 
+sector writes. With Function 55 you can simply set the stamp and 
+then write.
+
+
+Wheel protected files
++++++++++++++++++++++
+If you are using a ZCPR system (ZCCP or Z3PLUS), ZPM3 has access 
+to the wheel byte and supports wheel protected files. Such files 
+act normally if the wheel is set (signifying a priveleged user), 
+but if the wheel is not set, the files can not be changed. This 
+is of most benefit to BBS systems. The implementation is 
+virtually the same as most current Z80 CP/M 2.2 compatible 
+BDOSes.
+
+
+Better error messages
++++++++++++++++++++++
+CP/M 3.0 introduced the best error messages that CP/M had ever 
+had. ZPM3 goes further. The main difference you will notice is 
+that the user number as well as the drive is shown in the error 
+message. This is invaluable in helping you identify which file 
+might have caused a problem.
+
+
+Function 10 history buffer and improved editing.
+++++++++++++++++++++++++++++++++++++++++++++++++
+Function 10 is used by the CCP to input command lines. Many other 
+programs use function 10 for input.
+
+CP/M 3.0 introduced a history buffer for function 10. You press 
+control-W and you were returned the last command. It is a great 
+facility, but because it only remembers one command it is rather 
+limited. There have been RSXes written which give a much larger 
+history buffer, but RSXes take up extra program memory so are 
+undesirable.
+
+ZPM3 gives a large (approximately 250 bytes) history buffer which 
+can store multiple commands. It also makes very intelligent use 
+of the buffer so that identical commands are not stored twice, 
+and commands of less than three characters are not stored. The 
+history buffer takes up no additional memory, and is always 
+available.
+
+For security, it is possible to clear the history buffer so that 
+other users can not see what commands you have used.
+
+The ZPM3 history buffer feature is so good, that for many users, 
+the ZPM3 upgrade is completely justified by it.
+
+As part of the history buffer system, ZPM3 also offers a facility 
+called Automatic Command Prompting. This can be disabled, or can 
+be made switchable from the keyboard. When it is on, ZPM3 tries 
+to fill in the rest of your command based on what commands you 
+used most recently. It is like magic, and can save you typing out 
+complicated commands many times. In effect, it looks through the 
+history buffer for you and finds the command it thinks you want. 
+As you keep typing, if it turns out that the command doesn't 
+match anymore, it will try to match another command, and if it 
+can't, it lets you make the command by yourself. This facility is 
+quite amazing to watch.
+
+And to integrate the history buffer and the automatic command 
+prompting, function 10 has the best command line editing you'll 
+find anywhere. Most of the control keys do something when you are 
+editing a function 10 line, and for the most part they mimic the 
+standard WordStar/NewWord/ZDE functions. You can jump to 
+different words in the command, delete individual words, delete 
+individual letters, insert letters, and a whole lot more.
+
+
+Here is a list of what the various control keys do for function 
+10:
+
+A    Move left one word
+B    Go to the beginning or end of the line
+C    Warm boot if at start of line, otherwise nothing
+D    Go right one character
+E    Go backwards one command in the history buffer
+F    Go right one word
+G    Delete current character
+H    Destructive backspace
+I
+J    Enter line
+K    Delete all to the right
+L
+M    Enter line
+N
+O
+P    Toggle printing
+Q    Toggle automatic command prompting (if enabled)
+R
+S    Go left one character
+T    Delete current word
+U    Add current line to history buffer
+V    Clear line and delete from history buffer
+W    Go forwards one command in the history buffer
+X    Delete all to the left
+Y    Clear the whole line
+Z
+
+
+CPMLDR.REL bug fixed.
++++++++++++++++++++++
+If you have ever tried to use the CPMLDR.REL code supplied with 
+CP/M 3.0 to load a CPM3.SYS file larger than 16k, you have 
+probably come across the CPMLDR.REL bug. The computer probably 
+crashed, and you were left wondering what you did wrong in your 
+bios.
+
+Well CPMLDR.REL has a bug. To solve this for you ZPM3 comes with 
+ZPM3LDR.REL which directly replaces CPMLDR.REL. It is also 
+somewhat better in that all the messages, and the fcb for loading 
+CPM3.SYS, are at the start of the file along with plenty of spare 
+room. As a result you can easily patch the signon and error 
+messages to say whatever you like and even change the FCB to load 
+a file called something other than CPM3.SYS.
+
+
+
+
+All About the Random Read Bug.
+==============================
+Never heard of it? Well it's there in CP/M 3.0. I spent a lot of 
+time trying to work out what it was and just why it was 
+happening, and if you are interested, here are the details.
+
+CP/M 3.0 uses the Record Count byte of an active FCB a little 
+differently from the way CP/M 2.2 does. It is mentioned in the 
+CP/M 3.0 manuals that the record count may contain numbers 
+greater than 128, but in such a case it implies that the record 
+count is really 128. CP/M 2.2 would not return record counts 
+greater than 128.
+
+The reason for the use of the record count in this way is to help 
+speed up some of the logic used to find records in a file. It 
+works very well for sequential access. When it comes to random 
+access, the system has some failings.
+
+The idea behind CP/M 3.0's unusual use of the record count is to 
+keep the record count of the last logical extent of the current 
+physical extent always in the Record Count byte. When accessing 
+extents before the last one, bit 7 of the byte is set. That way 
+it will always be at least 128 for logical extents before the 
+last (which CP/M 3.0 translates to mean equal to 128), and the 
+lower 7 bits are used as convenient storage for the record count 
+of the last logical extent. This is particularly convenient 
+because it means there is no need to go and read the directory 
+entry again when it comes time to read the last logical extent.
+
+I hope you have followed that! In sequential access, this scheme 
+is great. The problem occurs with random access. In this case it 
+is possible to access a logical extent which has no records in 
+it. This could be any logical extent past the last one. In such a 
+case the record count must be returned as 0 (which is correct). 
+If we then go back to a previous logical extent in the same 
+physical extent, CP/M 3.0 gets confused and assumes that there 
+must be 128 records in that extent because the one we just came 
+from had no records and we are now accessing an earlier extent. 
+You're probably well and truly lost by now!
+
+Anyhow, the assumption that CP/M 3.0 makes is quite wrong. The 
+record count ends up being set to 128, a read is allowed to go 
+ahead as if nothing was wrong, no error is returned, and the 
+record count remains incorrectly set until a different physical 
+extent is opened. The result could be chaos, but mostly it just 
+means that a program returns the wrong information.
+
+Remember, a logical extent is always 16k. A physical extent can 
+be a multiple of 16k and is all the data described by one 
+directory entry. If your system has physical extents which are 
+16k, you would never have the problem because a new physical 
+extent would be properly opened for every new logical extent that 
+was accessed.
+
+Typically though, a physical extent is 32k, so it holds 2 logical 
+extents. The problem won't arise until the file grows past the 
+32k mark in such a case. And when the file gets over 48k the 
+problem can't occur again until it gets over 64k... and so on. 
+Even then, it can only happen if reads are attempted to 
+particular extents in a particular order. So you shouldn't be too 
+surprised if the bug hasn't been too noticeable to you.
+
+ZPM3 squashes the bug once and for all by using the correct 
+logic. In the situation where the bug would normally occur, ZPM3 
+makes sure it gets the correct record count information, and the 
+reads return the correct record count every time.
+
+If you are interested in seeing a demonstration of the bug in 
+action (on CP/M 3.0) and comparing it with ZPM3, there is a file 
+floating around various bulletin boards which contains 
+demonstrations for the bug and an RSX to fix it. The RSX is a 
+less than perfect way of overcoming the bug, although it seems to 
+work. However, now that you have ZPM3, you don't need to worry.
+
+
+
+
+Other things you should know about ZPM3
+=======================================
+ZPM3 has worked on EVERY CP/M 3.0 system tried so far except one. 
+This is a Bondwell computer, and as yet it isn't clear why it 
+won't work. I will study the source code of its BIOS and come up 
+with a fix shortly.
+
+The MAKEDOS.COM utility is not perfect (as mentioned previously) 
+and it seems that nobody has managed to get it to work with the 
+Commodore C128 system. You must use the conventional method for 
+installing ZPM3 on such systems.
+
+If you have a computer that ZPM3 will not install on with MAKEDOS 
+and you do not have access to the files required to do a 
+conventional install, please contact me. I am interested in 
+making ZPM3 as universal as possible and will help you to install 
+it on your system.
+
+The ESCAPE key is ignored by function 10. There has been some 
+lively discussion about this but the decision is final: it stays 
+ignored. Remember what function 10 is for and you will understand 
+why I made it ignore the ESCAPE key. The argument against this 
+has been from people who control their terminals from the command 
+line. Apparently some people type in an escape sequence at the 
+command line (which CP/M 3.0 will not output correctly anyhow 
+(converting the escape character to ^[)) then press return to 
+have the CCP echo back the line including the escape character.
+
+Sorry folks, that is a KLUDGE in my books! Anybody using Z-System 
+would of course use an ALIAS and ECHO to do this properly, but 
+for those who will continue to complain that I have sacrificed 
+CP/M 3.0 compatibility I am now including ECHOTERM.COM to solve 
+your problems. Run it and whatever you type will be sent to the 
+terminal correctly after you press RETURN. Press RETURN twice to 
+exit the program.
+
+And a reminder that the ability to put control characters into 
+function 10 lines was always limited by the fact that some 
+control keys were used to edit the command line. CP/M 3.0 added 
+even more, and ZPM3 uses virtually all the control keys. The few 
+that aren't used are ignored, and this is in fact a FEATURE which 
+guarantees that unusable characters can't get into function 10 
+lines by accident.
+
+
+
+
+LEGALS and SUCH
+===============
+The ZPM3 package is supplied free of charge, on the condition 
+that you don't use it to make money. If you want to use it 
+commercially you must contact me to get the OK (and negotiate our 
+fee).
+
+If you find anyone (except myself) charging money for ZPM3, 
+please inform me!
+
+Nobody is making any guarantees about this software. None at all. 
+If it causes your house to burn down, or a divorce, or just a bad 
+day, this is unfortunate, regrettable, but there is nothing that 
+I can or will do about it. You have been warned.
+
+The ZPM3 package must only be distributed in the form that you 
+found it. Do not change or add anything. Don't even change it 
+into a different type of archive. Just leave it alone. However 
+you are free to distribute it to as many places and people that 
+you can. Just don't charge for it.
+
+
+
+If in using ZPM3 you find that it doesn't act as described, 
+please forward the details to me so that either the ZPM3 code or 
+the documentation can be changed. If you would like further 
+details, please forward your specific questions to me. SJC.
+
+
+
+
+As a service to all our ZPM3 fans, the latest version of the ZPM3 
+package can now be ordered. At this stage we can only supply IBM 
+formatted 3.5 inch 720k disks, however if you are keen enough 
+that shouldn't matter. ZPM3 remains free, however this service 
+will cost you $15 Australian (for the disk, copying, postage and 
+packing) to most places in the Western World (others by 
+arrangement).
+
+This is a good way to guarantee you have the latest version, and 
+to guarantee that your package has not been corrupted by some 
+unscrupulous person.
+
+When we fill your order, we will make sure to include the latest 
+demonstration copy of MYZ80 - the fastest and best Z80 emulator 
+for IBM AT (and better) compatibles. MYZ80 can run ZPM3 with 
+ease. It also handles ZCPR and CP/M 2.2. And yes, we do mean 
+FASTEST.
+
+Send your international money order to:
+
+          Software by Simeon
+          ZPM3 Package
+          2 Maytone Ave
+          Killara   NSW
+          Australia 2071
+
+Your order will be promptly filled.
+

Doc/ChangeLog.txt

@@ -1,11 +1,16 @@
 Version 3.6
 -----------
+- RDG: Added VDA driver for Xosera FPGA-based VDC
 - MGG: Added COBOL language disk image
 - WDC: Added config options to PCF driver
 - WBW: Enabled dynamic CPU speed update on LCD screen
 - WBW: Improve LPT driver boot messaging when not detected (per Robb Bates)
 - WBW: Correct DS1307 boot date/time display (per Tadeusz Pycio)
 - WBW: Add -DELAY option to TUNE app (per Robb Bates)
+- RDG: Add online documentation site
+- WBW: Added enhanced Hi-Tech C Compiler files from Ladislau Szilagyi
+- WBW: Added boundary check to ram/rom disk driver
+- WBW: Per Peter Onion, switch KERMIT default file xfer mode to binary
 
 Version 3.5.1
 -------------

Doc/ReadMe.txt

@@ -28,6 +28,7 @@ ChangeLog.txt
 Log of changes in RomWBW by version.
 
 
+RomWBW Introduction ("RomWBW Introduction.pdf")
 RomWBW User Guide ("RomWBW User Guide.pdf")
 RomWBW System Guide ("RomWBW System Guide.pdf")
 RomWBW Applications ("RomWBW Applications.pdf")
@@ -84,4 +85,4 @@ UCSD p-System Users Manual ("UCSD p-System Users Manual.pdf")
 Official user manual for p-System operating system included with
 RomWBW.
 
---WBW 5:18 PM 6/14/2023
+--WBW 8:37 AM 6/6/2025

ReadMe.md

@@ -7,7 +7,7 @@
 **RomWBW Introduction** \
 Version 3.6 \
 Wayne Warthen  ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
-28 May 2025
+06 Jun 2025
 
 # Overview
 
@@ -49,7 +49,7 @@ Supported hardware features of RomWBW include:
 - Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip,
   Iomega
 - Serial drivers including UART (16550-like), ASCI, ACIA, SIO
-- Video drivers including TMS9918, SY6545, MOS8563, HD6445
+- Video drivers including TMS9918, SY6545, MOS8563, HD6445, Xosera
 - Keyboard (PS/2) drivers via VT8242 or PPI interfaces
 - Real time clock drivers including DS1302, BQ4845
 - Support for CP/NET networking using Wiznet, MT011 or Serial
@@ -340,6 +340,9 @@ let me know if I missed you!
 
 - Les Bird has contributed support for the NABU w/ Option Board
 
+- Rob Gowin created an online documentation site via MkDocs, and
+  contributed a driver for the Xosera FPGA-based video controller.
+
 ## Related Projects
 
 Outside of the hardware platforms adapted to RomWBW, there are a variety

ReadMe.txt

@@ -1,6 +1,6 @@
 RomWBW Introduction
 Wayne Warthen (wwarthen@gmail.com)
-28 May 2025
+06 Jun 2025
 
 
 
@@ -46,7 +46,7 @@ Supported hardware features of RomWBW include:
 - Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip,
   Iomega
 - Serial drivers including UART (16550-like), ASCI, ACIA, SIO
-- Video drivers including TMS9918, SY6545, MOS8563, HD6445
+- Video drivers including TMS9918, SY6545, MOS8563, HD6445, Xosera
 - Keyboard (PS/2) drivers via VT8242 or PPI interfaces
 - Real time clock drivers including DS1302, BQ4845
 - Support for CP/NET networking using Wiznet, MT011 or Serial
@@ -347,6 +347,9 @@ let me know if I missed you!
 
 - Les Bird has contributed support for the NABU w/ Option Board
 
+- Rob Gowin created an online documentation site via MkDocs, and
+  contributed a driver for the Xosera FPGA-based video controller.
+
 
 Related Projects
 

Source/CPM22/ReadMe.txt

@@ -38,7 +38,7 @@ It is an independent disassembly and reconstruction of CCP/BDOS.
 DRI CPM22PAT01 was already applied.  Unclear why, but the BDOS
 source was checking for a blank instead of a ctrl-s in the
 KBSTAT routine.  Ctrl-s seems to be correct based on all other
-BDOS images I have encountered.  Also, these files imbed the
+BDOS images I have encountered.  Also, these files embed the
 CP/M version number into the serial number fields.  Other than
 this, they are byte identical to the OS2CCP/OS3BDOS images above.
 
@@ -51,17 +51,24 @@ BDOS22.ASM - Modified ORG & fix for ctrl-S
 CCPB03 & BDOSB01
 ----------------
 
-Sourced from N8VEM effort to create an enhanced
-variant of CP/M 2.2.
+These files were derived from a disassembly of the Jade DD CP/M-80
+image by William Beech in 1982.
 
-It appears to be a disassembly and reconstruction of CCP/BDOS,
-but there are no comments attributing the work.  DRI CPM22PAT01
-was already applied.  The message string literals are all
+- Modified by Bill Beech for global CP/M size configuration
+  and separate CCP and BDOSE 2013.
+
+- Modified by Bill Beech for addition of MON
+  command and display/change of user on command line
+  1984.  Also removed all SN checks.
+
+Eventually modified as part of the N8VEM project and converted to
+the Z80 instruction set.
+
+DRI CPM22PAT01 has been applied.  The message string literals are all
 in CAPS in BDOS.  Additionally, there is explicit filler of 0x55
 value bytes at the end of the CCP/BDOS files padding their
 length out to full page.  Other than this, the BDOS
-is byte identical to the others above.  CCP contains multiple
-enhancements and is, therefore, not identical to others.
+is byte identical to the others above.
 
 CCPB03.ASM - Enhanced reassembly of CCP
 

Source/Doc/Basic.h

@@ -14,7 +14,14 @@ $define{doc_sys}{[RomWBW System Guide]($doc_root$/RomWBW System Guide.pdf)}$
 $define{doc_apps}{[RomWBW Applications]($doc_root$/RomWBW Applications.pdf)}$
 $define{doc_catalog}{[RomWBW Disk Catalog]($doc_root$/RomWBW Disk Catalog.pdf)}$
 $define{doc_hardware}{[RomWBW Hardware]($doc_root$/RomWBW Hardware.pdf)}$
-
+$ifdef{GFM}$
+  $define{doc_intro}{[RomWBW Introduction](Introduction.md)}$
+  $define{doc_user}{[RomWBW User Guide](UserGuide.md)}$
+  $define{doc_sys}{[RomWBW System Guide](SystemGuide.md)}$
+  $define{doc_apps}{[RomWBW Applications](Applications.md)}$
+  $define{doc_catalog}{[RomWBW Disk Catalog](Catalog.md)}$
+  $define{doc_hardware}{[RomWBW Hardware](Hardware.md)}$
+$endif$
 ---
 title: $doc_product$ $doc_title$
 subtitle: $doc_ver$

Source/Doc/Catalog.md

@@ -70,11 +70,12 @@ disks should now be fully described.
   CP/M 3.  Applications have been patched according to the DRI
   patch list.
 
-- **ZPM3**: Digital Research CP/M-80 2.2 Distribution Files
+- **ZPM3**: ZPM3 Distribution Files
 
-  Documentation: *CPM Manual.pdf*
+  Documentation: *ZPM3.txt*
 
-  These files are from Simeon Cran's ZPM3 operating system distribution.
+  These files are from Simeon Cran's official distribution of ZPM3. 
+  All known patches have been applied.
 
 `\clearpage`{=latex}
 
@@ -573,7 +574,7 @@ This is a generic ZPM3 adaptation for RomWBW.
 
 The following files came from from Microcode Consulting. The official
 distribution files can be found on the Microcode Consulting website at
-[https://www.microcodeconsulting.com/z80/qpm.htm].
+<https://www.microcodeconsulting.com/z80/qpm.htm>.
 Also included in this image are debugz, and linkz frm the same company.
 
 This disk includes the standard DRI CP/M 2.2 files in addition to the
@@ -651,7 +652,7 @@ look a little strange depending on the terminal emulation you are using.
 
 User area 4 contains a full implementation of the CP/NET 1.2 client 
 provided by Doug Miller. Please refer to
-[https://github.com/durgadas311/cpnet-z80] for more information, 
+<https://github.com/durgadas311/cpnet-z80> for more information, 
 complete documentation and the latest source code.
 
 Please refer to the RomWBW User Guide for instructions on installing
@@ -979,7 +980,7 @@ The following files are found in
 | `ZEXDOC.COM`        | Z80 Instruction Set Exerciser                           |
 
 And The following CPU Tests - Which are probably originally from this source. 
-[https://github.com/raxoft/z80test]
+<https://github.com/raxoft/z80test>
 
 | **File**       | **Description**                                               |
 |----------------|---------------------------------------------------------------|
@@ -1002,7 +1003,7 @@ including MS-DOS, Apple II DOS 3.3 and PRoDOS, Commodore 64, Macintosh and
 Amiga. This disk contains the CP/M version of that compiler. A cross-compiler
 for MS-DOS or Windows XP is also available.
 
-For full documentation, see [https://www.aztecmuseum.ca] 
+For full documentation, see <https://www.aztecmuseum.ca> 
 The user manual is available in the Doc/Language directory
 Aztec_C_1.06_User_Manual_Mar84.pdf
 
@@ -1048,10 +1049,10 @@ NOTE : The above is incomplete
 
 The Cowgol 2.0 compiler and related tools.
 These files were provided by Ladislau Szilagyi and were sourced
-from his GitHub repository at [https://github.com/Laci1953/Cowgol_on_CP_M].
+from his GitHub repository at <https://github.com/Laci1953/Cowgol_on_CP_M>.
 
 The primary distribution site for Cowgol 2.0 is at
-[https://github.com/davidgiven/cowgol].
+<https://github.com/davidgiven/cowgol>.
 The user manual is available in the Doc/Language directory
 Cowgol Language.pdf
 
@@ -1061,23 +1062,64 @@ The following files are found in
 
 | **File**     | **Description**                            |
 |--------------|--------------------------------------------|
-| ADVENT.COW   | Adventure game program source              |
-| ADVENT.SUB   | Submit file to build ADVENT                |
-| ADVENT?.TXT  | Adventure game program resource            |
-| ADVMAIN.COW  | Adventure game program source              |
-| RAND.AS      | Assembler Library File                     |
-| COWBE.COM    |                                            |
-| COWFE.COM    | RomWBW specific (Memory Manage) version    |
-| COWLINK.COM  |                                            |
-| DYNMSORT.COW | demonstrates a sort algorithm              |
-| DYNMSORT.SUB | Submit file to build DYNMSORT              |
-| HEXDUMP.COW  | a simple hex dump utility, purely a Cowgol |
-| HEXDUMP.SUB  | Submit file to build HEXDUMP               |
-| HMERGES.C    | C Library File                             |
-| XRND.AS      | Assembler Library File                     |
-| -            | -                                          |
-
-NOTE : The above is incomplete
+| $EXEC.COM    | HiTech C batch processor which launches the Cowgol toolchain executables |
+| ADVENT.COW   | Adventure game program source |
+| ADVENT.SUB   | SUBMIT file to build Adventure game |
+| ADVENT?.TXT  | Adventure game program resources |
+| ADVMAIN.COW  | Adventure game program source |
+| ADVTRAV.COW  | Adventure game component source |
+| ARGV.COH     | Cowgol include file providing command line argument processing |
+| C.LIB        | HI-TECH C runtime library |
+| CGEN.COM     | HiTech C compiler pass 2 |
+| COMMFILE.COH | Include file providing file I/O |
+| COMMON.COH   | Include file providing common functions |
+| COWBE.COM    | Cowgol back end which builds the cowgol object files (optimized) |
+| COWFE.COM    | Cowgol front end which parses the source file (optimized) |
+| COWFIX.COM   | Interface to Z80AS -- performs code optimizations |
+| COWGOL.COH   | Include file providing standard Cowgol functions |
+| COWGOL.COM   | Interprets the command line and generates $EXEC run requests (a variant of HiTech C.COM) |
+| COWGOL.COO   | Cowgol object file with ??? |
+| COWGOL.LIB   | ??? |
+| COWGOLC.COH  | Cowgol include file providing ??? |
+| COWLINK.COM  | Cowgol linker which binds all the cowgol object files and outputs a Z80 assembler file (optimized) |
+| CPP.COM      | HiTech C pre-processor, modified to accept // style comments |
+| DYNMSORT.COW | Sort algorithm sample program source |
+| DYNMSORT.SUB | SUBMIT file to build DYNMSORT sample application |
+| FACT.COW     | Factorial computation sample program source |
+| FILE.COH     | Include file providing CP/M file processing support |
+| FILEIO.COH   | Include file providing CP/M file processing support |
+| HEXDUMP.COW  | Hex file dump sample  source |
+| HEXDUMP.SUB  | SUBMIT file to build HEXDUMP sample program |
+| LIBBASIC.COH | Include file providing ??? |
+| LIBBIOS.COH  | Include file providing ??? |
+| LIBCONIO.COH | Include file providing console I/O |
+| LIBFP.COH    | Include file providing floating point support |
+| LIBR.COM     | HiTech object file librarian |
+| LIBSTR.COH   | Include file providing string functions |
+| LINK.COM     | HiTech linker which builds the final executable from object and library files |
+| MALLOC.COH   | Include file providing dynamic memory management functions |
+| MERGES.C     | Merge sort sample function C language source |
+| MISC.COH     | Include file providing miscellaneous functions |
+| MISC.COO     | Miscellaneous functions object file |
+| MISC.COW     | Miscellaneous functions source file |
+| OPTIM.COM    | HiTech C compiler optimizer |
+| P1.COM       | HiTech C compiler first pass |
+| RAND.AS      | Pseudo-random number generator source in assembly language |
+| RANFILE.COH  | Include file providing random file access functions |
+| RANFILE.COO  | Random file access functions object file |
+| RANFILE.COW  | Random file access functions source file |
+| README.TXT   | Cowgol disk image release notes |
+| SEQFILE.COH  | Include file providing sequential file access functions |
+| SEQFILE.COO  | Sequential file access functions object file |
+| SEQFILE.COW  | Sequential file access functions source file |
+| STDCOW.COH   | Include file providing standard library functions |
+| STRING.COH   | Include file providing string functions |
+| STRING.COO   | String functions object file |
+| STRING.COW   | String functions source file |
+| STRINGS.COH  | Include file implementing string functions |
+| TESTAS.COW   | Assembly language interface sample program source |
+| TESTAS.SUB   | SUBMIT file to build TESTAS sample program |
+| Z80AS.COM    | Z80 assembler which assembles the output of COWFIX and other Z80 source files (see <https://github.com/Laci1953/Z80AS>) |
 
 ## Microsoft Fortran 80 (Fortran)
 
@@ -1114,12 +1156,12 @@ Zork 1 through 3, Planetfall and Hitchhiker's Guide to the Galaxy.
 Nemesis and Dungeon Master is a Rogue-like game released in 1981. It is playable
 on a text terminal using ASCII graphics to represent the dungeon. Only a few
 thousand copies of the game were ever made, making it very rare. See
-[http://crpgaddict.blogspot.com/2019/03/game-322-nemesis-1981.html]
+<http://crpgaddict.blogspot.com/2019/03/game-322-nemesis-1981.html>
 
 Colossal Cave Adventure is a CP/M port of the 1976 classic game originally
 written by Will Crowther for the PDP-10 mainframe. See
-[https://en.wikipedia.org/wiki/Colossal_Cave_Adventure] and
-[https://if50.substack.com/p/1976-adventure]
+<https://en.wikipedia.org/wiki/Colossal_Cave_Adventure> and
+<https://if50.substack.com/p/1976-adventure>
 
 The following files are found in
 
@@ -1136,31 +1178,92 @@ NOTE : The above is incomplete
 | Floppy Disk Image: **fd_hitechc.img**
 | Hard Disk Image: **hd_hitechc.img**
 
-The HI-TECH C Compiler  is  a  set  of  software  which
+The HI-TECH C Compiler is a set of software which
 translates  programs written in the C language to executable
 machine code programs. Versions are available which  compile
 programs  for  operation under the host operating system, or
 which produce programs for  execution  in  embedded  systems
 without an operating system.
 
-This is the Mar 21, 2023 update 17 released by Tony Nicholson who currently
-maintains HI-TECH C at [https://github.com/agn453/HI-TECH-Z80-C]
+This is the Jun 2, 2025 update 19 released by Tony Nicholson who
+currently maintains HI-TECH C at
+<https://github.com/agn453/HI-TECH-Z80-C>.
 
 The manual is available in the Doc/Language directory,
 HI-TECH Z80 C Compiler Manual.txt
 
 A good blog post about the HI-TECH C Compiler is available at
-[https://techtinkering.com/2008/10/22/installing-the-hi-tech-z80-c-compiler-for-cpm]
+<https://techtinkering.com/2008/10/22/installing-the-hi-tech-z80-c-compiler-for-cpm>.
+
+User area 1 contains another complete copy of the HI-TECH C Compiler.
+It is identical to the copy in user area 0 except for the following files
+which were enhanced by Ladislau Szilagyi from his GitHub Repository at
+<https://github.com/Laci1953/HiTech-C-compiler-enhanced>.  The files
+take advantage of additional banked memory using the RomWBW HBIOS API.
+As such, they require RomWBW to operate.  They should be compatible with
+all CP/M and compatible operations systems provided in RomWBW.
+
+The enhanced files are:
+
+- CGEN.COM
+- CPP.COM
+- OPTIM.COM
+- P1.COM
+- ZAS.COM (replaced with Z80AS)
+
+A thread discussing this enhanced version of HI-TECH C is found at
+<https://groups.google.com/g/rc2014-z80/c/sBCCIpOnnGg>.
 
 The following files are found in
 
 *  /Source/Images/d_hitechc
 
-| **File** | **Description** |
-|----------|-----------------|
-| --       |       --        |
-
-NOTE : The above is incomplete
+| **File**     | **Description**                            |
+|--------------|--------------------------------------------|
+| $EXEC.COM    | Compiler execution manager |
+| ASSERT.H     | Language include file |
+| C.COM        | Compiler invocation application (updated) |
+| C309.COM     | Compiler invocation application (original) |
+| CGEN.COM     | The code generator - produces assembler code |
+| CONIO.H      | Language include file (see manual) |
+| CPM.H        | Language include file (see manual) |
+| CPP.COM      | Pre-processor - handles macros and conditional compilation |
+| CREF.COM     | Produces cross-reference listings of C or assembler programs |
+| CRTCPM.OBJ   | Startup Object File (standard) |
+| CTYPE.H      | Language include file (see manual) |
+| DEBUG.COM    | C Debugger (Z80) |
+| DRTCPM.OBJ   | Startup Object File (???) |
+| EXEC.H       | Language include file (see manual) |
+| FLOAT.H      | Language include file (see manual) |
+| HITECH.H     | Language include file (see manual) |
+| LIBC.LIB     | Standard C Runtime Library |
+| LIBF.LIB     | Floating Point Library |
+| LIBOVR.LIB   | Overlay Library |
+| LIBR.COM     | Creates and maintains libraries of object modules |
+| LIMITS.H     | Language include file (see manual) |
+| LINQ.COM     | Link editor - links object files with libraries |
+| MATH.H       | Language include file (see manual) |
+| NRTCPM.OBJ   | Startup Object File (minimal getargs) |
+| OBJTOHEX.COM | Converts the output of LINK into the appropriate executable file format (e.g., .EXE or .PRG or .HEX) |
+| OPTIM.COM    | Code improver - may optionally be omitted, reducing compilation  time at a cost of larger, slower code produced |
+| OPTIONS      | Compiler usage help file |
+| OVERLAY.H    | Language include file |
+| P1.COM       | The syntax and  semantic analysis pass - writes intermediate code for the code generator to read |
+| RRTCPM.OBJ   | Startup Object File (self relocating) |
+| SETJMP.H     | Language include file (see manual) |
+| SIGNAL.H     | Language include file (see manual) |
+| STAT.H       | Language include file (see manual) |
+| STDARG.H     | Language include file (see manual) |
+| STDDEF.H     | Language include file (see manual) |
+| STDINT.H     | Language include file (see manual) |
+| STDIO.H      | Language include file (see manual) |
+| STDLIB.H     | Language include file (see manual) |
+| STRING.H     | Language include file (see manual) |
+| SYMTOAS.COM  | Convert symbol file to assembler |
+| SYS.H        | Language include file (see manual) |
+| TIME.H       | Language include file (see manual) |
+| UNIXIO.H     | Language include file (see manual) |
+| ZAS.COM      | The assembler - in fact a general purpose macro  assembler |
 
 ## MSX ROMS
 
@@ -1170,7 +1273,7 @@ NOTE : The above is incomplete
 The collection of MSX ROMs (2 disks) as provided by Les Bird.  
 These ROMs are "run" by using the
 appropriate variant of Les' MSX8 ROM loader.  You can download the
-loader binaries from [https://github.com/lesbird/MSX8].  You will need
+loader binaries from <https://github.com/lesbird/MSX8>.  You will need
 appropriate hardware to run the loader.
 
 Please review the file ROMLIST.TXT for information on the current
@@ -1206,7 +1309,7 @@ The manual can be found in the Docs/Language directory,
 Turbo_Pascal_Version_3.0_Reference_Manual_1986.pdf
 
 A good overview of using Turbo Pascal in CP/M is available at
-[https://techtinkering.com/2013/03/05/turbo-pascal-a-great-choice-for-programming-under-cpm]
+<https://techtinkering.com/2013/03/05/turbo-pascal-a-great-choice-for-programming-under-cpm>
 
 The following files are found in
 
@@ -1358,10 +1461,10 @@ The manual(s) are available in the Doc/Language directory,
 * Z80DIS User Manual (1985).pdf
 
 A run through of using the assembler is available at
-[https://8bitlabs.ca/Posts/2023/05/20/learning-z80-asm]
+<https://8bitlabs.ca/Posts/2023/05/20/learning-z80-asm>
 
 And another shorter, but shows linker usage guide
-[https://pollmyfinger.wordpress.com/2022/01/10/modular-retro-z80-assembly-language-programming-using-slr-systems-z80asm-and-srlnk/]
+<https://pollmyfinger.wordpress.com/2022/01/10/modular-retro-z80-assembly-language-programming-using-slr-systems-z80asm-and-srlnk/>
 
 The following files are found in
 

Source/Doc/Hardware.md

@@ -111,26 +111,26 @@ Others
 
 | **Description**                                             | **Bus**  | **ROM Image File**          | **Baud Rate** |
 |-------------------------------------------------------------|----------|-----------------------------|--------------:|
-| [Dyno Z180 SBC]^6^                                          | Dyno     | DYNO_std.rom                |         38400 |
-| [EP Mini-ITX Z180]^11^                                      | UEXT     | EPITX_std.rom               |        115200 |
-| [eZ80 for RCBus Module]^13^, 512K RAM/ROM                   | RCBus    | RCEZ80_std.rom              |        115200 |
-| [Genesis Z180 System]^12^                                   | STD      | GMZ180_std.rom              |        115200 |
-| [Heath H8 Z80 System]^10^                                   | H8       | HEATH_std.rom               |        115200 |
-| [NABU w/ RomWBW Option Board]^10^                           | NABU     | NABU_std.rom                |        115200 |
-| [S100 Computers Z180 SBC]^9^                                | S100     | S100_std.rom                |         57600 |
-| [S100 Computers FPGA Z80 SBC]^9^                            | S100     | FZ80_std.rom                |          9600 |
-| [UNA Hardware BIOS]^3^                                      | -        | UNA_std.rom                 |             - |
-| [Z80-Retro SBC]^8^                                          | -        | Z80RETRO_std.rom            |         38400 |
-| [Z180 Mark IV SBC]^3^                                       | ECB      | MK4_std.rom                 |         38400 |
+| [Dyno Z180 SBC]^2^                                          | Dyno     | DYNO_std.rom                |         38400 |
+| [EP Mini-ITX Z180]^6^                                       | UEXT     | EPITX_std.rom               |        115200 |
+| [eZ80 for RCBus Module]^8^, 512K RAM/ROM                    | RCBus    | RCEZ80_std.rom              |        115200 |
+| [Genesis Z180 System]^7^                                    | STD      | GMZ180_std.rom              |        115200 |
+| [Heath H8 Z80 System]^5^                                    | H8       | HEATH_std.rom               |        115200 |
+| [NABU w/ RomWBW Option Board]^5^                            | NABU     | NABU_std.rom                |        115200 |
+| [S100 Computers Z180 SBC]^4^                                | S100     | S100_std.rom                |         57600 |
+| [S100 Computers FPGA Z80 SBC]^4^                            | S100     | FZ80_std.rom                |          9600 |
+| [UNA Hardware BIOS]^1^                                      | -        | UNA_std.rom                 |             - |
+| [Z80-Retro SBC]^3^                                          | -        | Z80RETRO_std.rom            |         38400 |
+| [Z180 Mark IV SBC]^1^                                       | ECB      | MK4_std.rom                 |         38400 |
 
-| ^3^Designed by John Coffman
-| ^6^Designed by Steve Garcia
-| ^8^Designed by Peter Wilson
-| ^9^Designed by John Monahan
-| ^10^Designed by Les Bird
-| ^11^Designed by Alan Cox
-| ^12^Designed by Doug Jackson
-| ^13^Designed by Dean Netherton
+| ^1^Designed by John Coffman
+| ^2^Designed by Steve Garcia
+| ^3^Designed by Peter Wilson
+| ^4^Designed by John Monahan
+| ^5^Designed by Les Bird
+| ^6^Designed by Alan Cox
+| ^7^Designed by Doug Jackson
+| ^8^Designed by Dean Netherton
 
 `\clearpage`{=latex}
 
@@ -2279,6 +2279,7 @@ the active platform and configuration.
 | VDU       | MC6845 Family Video Display Controller (*)             |
 | VGA       | HD6445CP4-based Video Display Controller               |
 | VRC       | VGARC Video Display Controller                         |
+| XOSERA    | XOSERA FPGA-based Video Display Controller             |
 
 Note:
 
@@ -2317,6 +2318,7 @@ Note:
 | DSRTC     | Maxim DS1302 Real-Time Clock w/ NVRAM                  |
 | EZ80RTC   | eZ80 Real-Time Clock                                   |
 | INTRTC    | Interrupt-based Real Time Clock                        |
+| PCRTC     | MC146818/DS1285/DS12885 PC style                       |
 | PCF       | PCF8584-based I2C Real-Time Clock                      |
 | RP5C01    | Ricoh RPC01A Real-Time Clock w/ NVRAM                  |
 | SIMRTC    | SIMH Simulator Real-Time Clock                         |

Source/Doc/Introduction.md

@@ -41,7 +41,7 @@ Supported hardware features of RomWBW include:
 * Banked memory services for several banking designs
 * Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip, Iomega
 * Serial drivers including UART (16550-like), ASCI, ACIA, SIO
-* Video drivers including TMS9918, SY6545, MOS8563, HD6445
+* Video drivers including TMS9918, SY6545, MOS8563, HD6445, Xosera
 * Keyboard (PS/2) drivers via VT8242 or PPI interfaces
 * Real time clock drivers including DS1302, BQ4845
 * Support for CP/NET networking using Wiznet, MT011 or Serial
@@ -324,6 +324,10 @@ please let me know if I missed you!
 
 * Les Bird has contributed support for the NABU w/ Option Board
 
+* Rob Gowin created an online documentation site via MkDocs, and
+  contributed a driver for the Xosera FPGA-based video
+  controller.
+
 `\clearpage`{=latex}
 
 ## Related Projects

Source/Doc/Makefile

@@ -18,6 +18,10 @@ include $(TOOLS)/Makefile.inc
 
 all :: deploy
 
+clean ::
+	rm -rf mkdocs
+	rm -rf site
+
 %.tmp : %.md
 	gpp -o $@ -U "$$" "$$" "{" "}{" "}$$" "{" "}" "@@@" "" -M "$$" "$$" "{" "}{" "}$$" "{" "}" $<
 
@@ -31,11 +35,16 @@ all :: deploy
 	pandoc $< -f markdown -t dokuwiki -s -o $@ --default-image-extension=pdf
 
 %.gfm : %.tmp
-	pandoc $< -f markdown -t gfm-yaml_metadata_block -s -o $@ --default-image-extension=pdf
+	pandoc $< -f markdown -t gfm-yaml_metadata_block -s -o $@ --default-image-extension=svg
 
 %.txt : %.tmp
 	pandoc $< -f markdown -t plain -s -o $@ --default-image-extension=pdf
 
+mkdocs/%.md : %.md
+	-mkdir -p mkdocs
+	gpp -DGFM -U "$$" "$$" "{" "}{" "}$$" "{" "}" "@@@" "" -M "$$" "$$" "{" "}{" "}$$" "{" "}" $< \
+	    | pandoc -f markdown -t gfm-yaml_metadata_block -s -o $@ --default-image-extension=svg
+
 deploy :
 	cp Introduction.gfm      "../../ReadMe.md"
 	cp Introduction.txt      "../../ReadMe.txt"
@@ -45,3 +54,10 @@ deploy :
 	cp Applications.pdf      "../../Doc/RomWBW Applications.pdf"
 	cp Catalog.pdf           "../../Doc/RomWBW Disk Catalog.pdf"
 	cp Hardware.pdf          "../../Doc/RomWBW Hardware.pdf"
+
+deploy_mkdocs : mkdocs/Introduction.md mkdocs/UserGuide.md mkdocs/SystemGuide.md mkdocs/Applications.md \
+                mkdocs/Catalog.md mkdocs/Hardware.md mkdocs/ReadMe.md
+	mkdir -p mkdocs/UserGuide/Graphics mkdocs/SystemGuide/Graphics
+	mv mkdocs/ReadMe.md mkdocs/README.md
+	cp Graphics/*.svg        mkdocs/UserGuide/Graphics
+	cp Graphics/*.svg        mkdocs/SystemGuide/Graphics

Source/Doc/SystemGuide.md

@@ -346,6 +346,14 @@ The memory manager used is determined by the configuration choices
 that are part of a RomWBW build process.  A given ROM can only have a
 single memory manager -- it is not selected dynamically.
 
+The configuration variable `MEMMGR` sets the memory mannager used by
+the ROM build.  It must be set to one of the above memory manager
+types.  For example, for the Z2 memory manager, `MEMMGR` should be set
+to `MM_Z2`.
+
+Note that the term memory manager (MM) and memory management unit (MMU)
+are used interchangeably in the documentation and code.
+
 # Disk Layout
 
 ## Floppy Disk Layout
@@ -1408,6 +1416,7 @@ unit.  The table below enumerates these values.
 | RTCDEV_DS7      | 0x04   | Maxim DS1307 PCF I2C RTC w/ NVRAM        | ds7rtc.asm  |
 | RTCDEV_RP5      | 0x05   | Ricoh RPC01A Real-Time Clock w/ NVRAM    | rp5rtc.asm  |
 | RTCDEV_EZ80     | 0x07   | eZ80 on-chip RTC                         | ez80rtc.asm |
+| RTCDEV_PC       | 0x08   | MC146818/DS1285/DS12885 RTC w/ NVRAM     | pcrtc.asm   |
 
 The time functions to get and set the time (RTCGTM and RTCSTM) require a
 6 byte date/time buffer in the following format. Each byte is BCD 
@@ -1756,14 +1765,17 @@ All video units are assigned a Device Type ID which indicates
 the specific hardware device driver that handles the unit.  The table
 below enumerates their values.
 
-| **Device Type** | **ID** | **Description**                          | **Driver** |
-|-----------------|-------:|------------------------------------------|------------|
-| VDADEV_VDU      | 0x00   | MC6845 Family Video Display Controller   | vdu.asm    |
-| VDADEV_CVDU     | 0x01   | MC8563-based Video Display Controller    | cvdu.asm   |
-| VDADEV_GDC      | 0x02   | uPD7220 Video Display Controller         | gdc.asm    |
-| VDADEV_TMS      | 0x03   | TMS9918/38/58 Video Display Controller   | tms.asm    |
-| VDADEV_VGA      | 0x04   | HD6445CP4-based Video Display Controller | vga.asm    |
-| VDADEV_VRC      | 0x05   | VGARC                                    | vrc.asm    |
+| **Device Type** | **ID** | **Description**                            | **Driver** |
+|-----------------|-------:|--------------------------------------------|------------|
+| VDADEV_VDU      | 0x00   | MC6845 Family Video Display Controller     | vdu.asm    |
+| VDADEV_CVDU     | 0x01   | MC8563-based Video Display Controller      | cvdu.asm   |
+| VDADEV_GDC      | 0x02   | uPD7220 Video Display Controller           | gdc.asm    |
+| VDADEV_TMS      | 0x03   | TMS9918/38/58 Video Display Controller     | tms.asm    |
+| VDADEV_VGA      | 0x04   | HD6445CP4-based Video Display Controller   | vga.asm    |
+| VDADEV_VRC      | 0x05   | VGARC                                      | vrc.asm    |
+| VDADEV_EF       | 0x06   | EF9345                                     | ef.asm     |
+| VDADEV_FV       | 0x07   | S100 FPGA VGA                              | fv.asm     |
+| VDADEV_XOSERA   | 0x08   | Xosera FPGA-based Video Display Controller | xosera.asm |
 
 Depending on the capabilities of the hardware, the use of colors and
 attributes may or may not be supported. If the hardware does not support

Source/Doc/mkdocs.yml

@@ -0,0 +1,16 @@
+site_name: RomWBW Documentation V3.6
+repo_url: https://github.com/wwarthen/RomWBW
+edit_uri: ""
+docs_dir: mkdocs
+nav:
+  - Introduction: Introduction.md
+  - User Guide: UserGuide.md
+  - System Guide: SystemGuide.md
+  - Applications: Applications.md
+  - Catalog: Catalog.md
+  - Hardware: Hardware.md
+theme:
+  name: mkdocs
+  color_mode: auto
+  user_color_mode_toggle: true
+  navigation_depth: 3

Source/Fonts/fonts.txt

@@ -15,13 +15,18 @@ There are multiple fonts associated with ROMWBW supported hardware:
 	ECB-VGA3	vga.asm		6445
 	MBC-VDC		cvdu.asm	8568
 	MBC-VDP		tms.asm		9938/9958
+	RCBUS-VRC	vrc.asm		PLD
+	RCBUS-TMS	tms.asm		99x8
 
-Name            Font    Storage	    Size    Board & Display Mode
---------------------------------------------------------------------------------------------
-font8x8u.bin    6x8     8x8         2048    ECB-SCG, ECB-VGA3 (80x60), MBC-VDP
-font8x11u.bin   8x11    8x11        2816    ECB-VGA3 (80x43)
-font8x16u.bin   8x14    8x16        4096    ECB-CVDU (80x25), ECB-VGA3 (80x24, 80x25, 80x30), MBC-VDC
-fontcgau.bin    8x8     8x16        4096    ECB-CVDU (80x25), MBC-VDC
+Name		Glyph	Cell	Size	Comp	Board & Display Mode
+------------------------------------------------------------------------------------------------
+font8x8		7x8	8x8	2048	1034	ECB-SCG, ECB-VGA3 (80x60), MBC-VDP
+font8x11	8x11	8x11	2816	1252	ECB-VGA3 (80x43)
+font8x16	8x14	8x16	4096	1466	ECB-CVDU (EGA), ECB-VGA3 (80x24, 80x25, 80x30), MBC-VDC (EGA)
+fontcga		8x8	8x16	4096	1280	ECB-CVDU (CGA), MBC-VDC (CGA)
+fontvrc		8x8	8x8	1024	650	VGARC
+				-----	-----
+				14080	5682
 
 Notes:
 

Source/HBIOS/Build.cmd

@@ -17,8 +17,8 @@ set CPMDIR80=%TOOLS%/cpm/
 
 ::
 :: This PowerShell script validates the build variables passed in.  If
-:: necessary, the user is prmopted to pick the variables.  It then creates
-:: an include file that is imbedded in the HBIOS assembly (build.inc).
+:: necessary, the user is prompted to pick the variables.  It then creates
+:: an include file that is embedded in the HBIOS assembly (build.inc).
 :: It also creates a batch command file that sets environment variables
 :: for use by the remainder of this batch file (build_env.cmd).
 ::
@@ -97,7 +97,6 @@ call :asm nascom || exit /b
 call :asm game || exit /b
 call :asm usrrom || exit /b
 call :asm updater || exit /b
-call :asm imgpad2 || exit /b
 
 :: Sysconf builds as both BIN and COM files
 tasm -t%CPUType% -g3 -fFF -dROMWBW sysconf.asm sysconf.bin sysconf_bin.lst || exit /b
@@ -106,30 +105,32 @@ tasm -t%CPUType% -g3 -fFF -dCPM sysconf.asm sysconf.com sysconf_com.lst || exit
 ::
 :: Create additional ROM bank images by assembling components into
 :: 32K chunks which can be concatenated later.  Note that
-:: osimg_small is a special case because it is 20K in size.  This
+:: appboot is a special case because it is 20K in size.  This
 :: image is subsequently used to generate the .com loadable file.
 ::
 
-copy /b romldr.bin + dbgmon.bin + ..\zsdos\zsys_wbw.bin + ..\cpm22\cpm_wbw.bin osimg.bin || exit /b
-copy /b ..\Forth\camel80.bin + nascom.bin + ..\tastybasic\src\tastybasic.bin + game.bin + eastaegg.bin + %NETBOOT% + updater.bin + sysconf.bin + usrrom.bin osimg1.bin || exit /b
+copy /b romldr.bin + dbgmon.bin + ..\zsdos\zsys_wbw.bin + ..\cpm22\cpm_wbw.bin rom1.bin || exit /b
+copy /b ..\Forth\camel80.bin + nascom.bin + ..\tastybasic\src\tastybasic.bin + game.bin + eastaegg.bin + %NETBOOT% + updater.bin + sysconf.bin + usrrom.bin rom2.bin || exit /b
 
 if %Platform%==S100 (
     zxcc slr180 -s100mon/fh
     zxcc mload25 -s100mon || exit /b
-    copy /b s100mon.com osimg2.bin || exit /b
+    copy /b s100mon.com rom3.bin || exit /b
 ) else (
-    copy /b imgpad2.bin osimg2.bin || exit /b
+    copy nul rom3.bin
 )
 
-copy /b romldr.bin + dbgmon.bin + ..\zsdos\zsys_wbw.bin osimg_small.bin || exit /b
+copy /b romldr.bin + dbgmon.bin + ..\zsdos\zsys_wbw.bin appboot.bin || exit /b
 
 ::
 :: Inject one byte checksum at the last byte of all 4 ROM bank image files.
-:: This means that computing a checksum over any of the 32K osimg banks
-:: should yield a result of zero.
+:: This means that computing a checksum over any of the 32K rom banks
+:: should yield a result of zero.  Any bank image file that is not
+:: 32K will be automatically normalized to 32K by the srec_cat
+:: formula (extended or truncated)!!!
 ::
 
-for %%f in (hbios_rom.bin osimg.bin osimg1.bin osimg2.bin) do (
+for %%f in (hbios_rom.bin rom1.bin rom2.bin rom3.bin) do (
   "%TOOLS%\srecord\srec_cat.exe" %%f -Binary -Crop 0 0x7FFF -Checksum_Negative_Big_Endian 0x7FFF 1 1 -o %%f -Binary || exit /b
 )
 
@@ -150,13 +151,13 @@ for %%f in (hbios_rom.bin osimg.bin osimg1.bin osimg2.bin) do (
 ::
 
 if %ROMSize% gtr 0 (
-    copy /b hbios_rom.bin + osimg.bin + osimg1.bin + osimg2.bin + ..\RomDsk\rom%ROMDiskSize%_wbw.dat %ROMName%.rom || exit /b
-    copy /b hbios_rom.bin + osimg.bin + osimg1.bin + osimg2.bin %ROMName%.upd || exit /b
-    copy /b hbios_app.bin + osimg_small.bin %ROMName%.com || exit /b
+    copy /b hbios_rom.bin + rom1.bin + rom2.bin + rom3.bin + ..\RomDsk\rom%ROMDiskSize%_wbw.dat %ROMName%.rom || exit /b
+    copy /b hbios_rom.bin + rom1.bin + rom2.bin + rom3.bin %ROMName%.upd || exit /b
+    copy /b hbios_app.bin + appboot.bin %ROMName%.com || exit /b
 ) else (
-    copy /b hbios_rom.bin + osimg.bin + osimg1.bin + osimg2.bin  + ..\RomDsk\rom%RAMDiskSize%_wbw.dat %ROMName%.rom || exit /b
-    copy /b hbios_rom.bin + osimg.bin + osimg1.bin + osimg2.bin %ROMName%.upd || exit /b
-    copy /b hbios_app.bin + osimg_small.bin %ROMName%.com || exit /b
+    copy /b hbios_rom.bin + rom1.bin + rom2.bin + rom3.bin  + ..\RomDsk\rom%RAMDiskSize%_wbw.dat %ROMName%.rom || exit /b
+    copy /b hbios_rom.bin + rom1.bin + rom2.bin + rom3.bin %ROMName%.upd || exit /b
+    copy /b hbios_app.bin + appboot.bin %ROMName%.com || exit /b
 )
 
 ::
@@ -187,14 +188,14 @@ call :asm dbgmon || exit /b
 call :asm romldr || exit /b
 
 :: Create the OS bank
-copy /b romldr.bin + dbgmon.bin + ..\zsdos\zsys_una.bin + ..\cpm22\cpm_una.bin osimg.bin || exit /b
+copy /b romldr.bin + dbgmon.bin + ..\zsdos\zsys_una.bin + ..\cpm22\cpm_una.bin rom2.bin || exit /b
 
 :: Copy OS Bank and ROM Disk image files to output
-copy /b osimg.bin ..\..\Binary\UNA_WBW_SYS.bin || exit /b
+copy /b rom2.bin ..\..\Binary\UNA_WBW_SYS.bin || exit /b
 copy /b ..\RomDsk\rom%ROMDiskSize%_una.dat ..\..\Binary\UNA_WBW_ROM%ROMDiskSize%.bin || exit /b
 
 :: Create the final ROM image
-copy /b ..\UBIOS\UNA-BIOS.BIN + osimg.bin + ..\UBIOS\FSFAT.BIN + ..\RomDsk\rom%ROMDiskSize%_una.dat %ROMName%.rom || exit /b
+copy /b ..\UBIOS\UNA-BIOS.BIN + rom2.bin + ..\UBIOS\FSFAT.BIN + ..\RomDsk\rom%ROMDiskSize%_una.dat %ROMName%.rom || exit /b
 
 :: Copy to output
 copy %ROMName%.rom ..\..\Binary || exit /b

Source/HBIOS/Config/RCZ80_xosera.asm

@@ -0,0 +1,61 @@
+;
+;==================================================================================================
+;   ROMWBW CUSTOM USER BUILD SETTINGS EXAMPLE FOR RCBUS Z80
+;==================================================================================================
+;
+; THIS FILE IS AN EXAMPLE OF A CUSTOM USER SETTINGS FILE.  THESE
+; SETTINGS OVERRIDE THE DEFAULT SETTINGS OF THE INHERITED FILES AS
+; DESIRED BY A USER.
+;
+; ROMWBW USES CASCADING CONFIGURATION FILES AS INDICATED BELOW:
+;
+; cfg_MASTER.asm			- MASTER: CONFIGURATION FILE DEFINES ALL POSSIBLE ROMWBW SETTINGS
+; |
+; +-> cfg_<platform>.asm		- PLATFORM: DEFAULT SETTINGS FOR SPECIFIC PLATFORM
+;     |
+;     +-> Config/<plt>_std.asm		- BUILD: SETTINGS FOR EACH OFFICIAL DIST BUILD
+;         |
+;         +-> Config/<plt>_<cust>.asm	- USER: CUSTOM USER BUILD SETTINGS
+;
+; THE TOP (MASTER CONFIGURATION) FILE DEFINES ALL POSSIBLE ROMWBW
+; CONFIGURATION SETTINGS. EACH FILE BELOW THE MASTER CONFIGURATION FILE
+; INHERITS THE CUMULATIVE SETTINGS OF THE FILES ABOVE IT AND MAY
+; OVERRIDE THESE SETTINGS AS DESIRED.
+;
+; OTHER THAN THE TOP MASTER FILE, EACH FILE MUST "#INCLUDE" ITS PARENT
+; FILE (SEE #INCLUDE STATEMENT BELOW).  THE TOP TWO FILES SHOULD NOT BE
+; MODIFIED.
+;
+; THIS FILE EXEMPLIFIES THE IDEAL WAY TO CREATE A USER SPECIFIC BUILD
+; CONFIGURATION.  NOTICE THAT IT INCLUDES THE DEFAULT BUILD SETTINGS
+; FILE AND OVERRIDES SOME DESIRED SETTINGS.
+;
+; BY CREATING A CUSTOM USER SETTINGS FILE, YOU ARE LESS LIKELY TO BE
+; IMPACTED BY FUTURE CHANGES BECAUSE YOU WILL BE INHERITING MOST
+; OF YOUR SETTINGS WHICH WILL BE UPDATED BY AUTHORS AS ROMWBW EVOLVES.
+;
+; PLEASE REFER TO THE CUSTOM BUILD INSTRUCTIONS (README.TXT) IN THE
+; SOURCE DIRECTORY (TWO DIRECTORIES ABOVE THIS ONE).
+;
+; *** WARNING: ASIDE FROM THE MASTER CONFIGURATION FILE, YOU MUST USE
+; ".SET" TO OVERRIDE SETTINGS.  THE ASSEMBLER WILL ERROR IF YOU ATTEMPT
+; TO USE ".EQU" BECAUSE IT WON'T LET YOU REDEFINE A SETTING WITH ".EQU".
+;
+; THIS FILE ENABLES THE XOSERA DRIVER WITH A BASE ADDRESS Of $A0 AND 
+; DISPLAY SIZE OF 80 COLUMNS X 30 ROWS.
+;
+#INCLUDE "Config/RCZ80_std.asm"		; INHERIT FROM OFFICIAL BUILD SETTINGS
+;
+XOSENABLE	.SET	TRUE		; XOSERA: ENABLE XOSERA VIDEO DRIVERS (XOSERA.ASM)
+XOS_BASE	.SET	$A0		; XOSERA: I/O BASE ADDRESS (REQUIRES 32 BYTES)
+XOSSIZ		.SET	V80X30		; XOSERA: DISPLAY FORMAT [V80X30|V80X60]
+;
+AUTOCON		.SET	FALSE		; ENABLE CONSOLE TAKEOVER AT LOADER PROMPT
+VDAEMU_SERKBD	.SET	$0		; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
+;
+; WHEN A XOSERA BOARD IN IS THE SYSTEM, LIMIT THE NUMBER OF UARTS THAT ARE PROBED
+; TO TWO, BECAUSE THE PROBE TO DETECT A THIRD UART WRITES UNLUCKY VALUES TO 
+; XOSERA THAT CAUSE IT TO RECONFIGURE ITSELF AND LOCK UP THE BUS FOR A TIME. IF
+; YOU NEED MORE THAN TWO UARTS, YOU WILL NEED TO MOVE XOSERA OUT OF THE $A0-$BF
+; I/O ADDRESS REGION.
+UARTCNT		.SET	2

Source/HBIOS/Makefile

@@ -1,7 +1,7 @@
 
 MOREDIFF = game.bin hbios_rom.bin nascom.bin usrrom.bin \
-	dbgmon.bin hbios_app.bin imgpad2.bin osimg1.bin osimg2.bin romldr.bin \
-	eastaegg.bin hbios_img.bin osimg.bin game.bin updater.bin usrrom.bin
+	dbgmon.bin hbios_app.bin imgpad2.bin rom2.bin rom3.bin romldr.bin \
+	eastaegg.bin hbios_img.bin rom1.bin game.bin updater.bin usrrom.bin
 
 DEST = ../../Binary
 TOOLS =../../Tools
@@ -58,37 +58,37 @@ ROMNAME=${ROM_PLATFORM}_${ROM_CONFIG}
 # $(info TASM=$(TASM))
 
 $(OBJECTS) : $(ROMDEPS)
-	@cat romldr.bin dbgmon.bin ../ZSDOS/zsys_$(BIOS).bin ../CPM22/cpm_$(BIOS).bin >osimg.bin
-	cat romldr.bin dbgmon.bin ../ZSDOS/zsys_$(BIOS).bin >osimg_small.bin
+	@cat romldr.bin dbgmon.bin ../ZSDOS/zsys_$(BIOS).bin ../CPM22/cpm_$(BIOS).bin >rom1.bin
+	cat romldr.bin dbgmon.bin ../ZSDOS/zsys_$(BIOS).bin >appboot.bin
 	if [ $(ROM_PLATFORM) = DUO ] ; then \
 		cat netboot-duo.mod >netboot.mod ; \
 	else \
 		cat netboot-mt.mod >netboot.mod  ; \
 	fi
 	if [ $(ROM_PLATFORM) != UNA ] ; then \
-		cat camel80.bin nascom.bin tastybasic.bin game.bin eastaegg.bin netboot.mod updater.bin sysconf.bin usrrom.bin >osimg1.bin ; \
+		cat camel80.bin nascom.bin tastybasic.bin game.bin eastaegg.bin netboot.mod updater.bin sysconf.bin usrrom.bin >rom2.bin ; \
 		if [ $(ROM_PLATFORM) = S100 ] ; then \
-			cat s100mon.bin >osimg2.bin ; \
+			cat s100mon.bin >rom3.bin ; \
 		else \
-			cat imgpad2.bin >osimg2.bin ; \
+			>rom3.bin ; \
 		fi ; \
-		for f in hbios_rom.bin osimg.bin osimg1.bin osimg2.bin ; do \
+		for f in hbios_rom.bin rom1.bin rom2.bin rom3.bin ; do \
 			srec_cat $$f -Binary -Crop 0 0x7FFF -Checksum_Negative_Big_Endian 0x7FFF 1 1 -o $$f -Binary ; \
 		done \
 	fi
 	if [ $(ROM_PLATFORM) = UNA ] ; then \
-		cp osimg.bin $(DEST)/UNA_WBW_SYS.bin ; \
+		cp rom1.bin $(DEST)/UNA_WBW_SYS.bin ; \
 		cp ../RomDsk/rom$(ROMDISKSIZE)_una.dat $(DEST)/UNA_WBW_ROM$(ROMDISKSIZE).bin ; \
-		cat ../UBIOS/UNA-BIOS.BIN osimg.bin ../UBIOS/FSFAT.BIN ../RomDsk/rom$(ROMDISKSIZE)_una.dat >$(ROMNAME).rom ; \
+		cat ../UBIOS/UNA-BIOS.BIN rom1.bin ../UBIOS/FSFAT.BIN ../RomDsk/rom$(ROMDISKSIZE)_una.dat >$(ROMNAME).rom ; \
 	else \
 		if [ $(ROMSIZE) -gt 0 ] ; then \
-			cat hbios_rom.bin osimg.bin osimg1.bin osimg2.bin ../RomDsk/rom$(ROMDISKSIZE)_wbw.dat >$(ROMNAME).rom ; \
-			cat hbios_rom.bin osimg.bin osimg1.bin osimg2.bin >$(ROMNAME).upd ; \
-			cat hbios_app.bin osimg_small.bin > $(ROMNAME).com ; \
+			cat hbios_rom.bin rom1.bin rom2.bin rom3.bin ../RomDsk/rom$(ROMDISKSIZE)_wbw.dat >$(ROMNAME).rom ; \
+			cat hbios_rom.bin rom1.bin rom2.bin rom3.bin >$(ROMNAME).upd ; \
+			cat hbios_app.bin appboot.bin > $(ROMNAME).com ; \
 		else \
-			cat hbios_rom.bin osimg.bin osimg1.bin osimg2.bin ../RomDsk/rom$(RAMDISKSIZE)_wbw.dat >$(ROMNAME).rom ; \
-			cat hbios_rom.bin osimg.bin osimg1.bin osimg2.bin >$(ROMNAME).upd ; \
-			cat hbios_app.bin osimg_small.bin > $(ROMNAME).com ; \
+			cat hbios_rom.bin rom1.bin rom2.bin rom3.bin ../RomDsk/rom$(RAMDISKSIZE)_wbw.dat >$(ROMNAME).rom ; \
+			cat hbios_rom.bin rom1.bin rom2.bin rom3.bin >$(ROMNAME).upd ; \
+			cat hbios_app.bin appboot.bin > $(ROMNAME).com ; \
 		fi \
 	fi
 

Source/HBIOS/cfg_MASTER.asm

@@ -202,6 +202,9 @@ DS7RTCMODE	.EQU	DS7RTCMODE_PCF	; DS7RTC: OPERATING MODE: DS7RTCMODE_[PCF]
 ;
 DS5RTCENABLE	.EQU	FALSE		; DS5RTC: ENABLE DS-1305 SPI CLOCK DRIVER (DS5RTC.ASM)
 ;
+PCRTCENABLE	.EQU	FALSE		; PCRTC: DISABLE DS12885 etc. RTC
+PCRTC_BASE	.EQU	$C0		; Default port for PCRTC, like DSRTC.
+;
 SSERENABLE	.EQU	FALSE		; SSER: ENABLE SIMPLE SERIAL DRIVER (SSER.ASM)
 SSERCFG		.EQU	SER_9600_8N1	; SSER: SERIAL LINE CONFIG
 SSERSTATUS	.EQU	$FF		; SSER: STATUS PORT
@@ -311,6 +314,9 @@ VRCENABLE	.EQU	FALSE		; VRC: ENABLE VGARC VIDEO/KBD DRIVER (VRC.ASM)
 SCONENABLE	.EQU	FALSE		; SCON: ENABLE S100 CONSOLE DRIVER (SCON.ASM)
 EFENABLE	.EQU	FALSE		; EF: ENABLE EF9345 VIDEO DRIVER (EF.ASM)
 FVENABLE	.EQU	FALSE		; FV: ENABLE FPGA VGA VIDEO DRIVER (FV.ASM)
+XOSENABLE	.EQU	FALSE		; XOSERA: ENABLE XOSERA VIDEO DRIVERS (XOSERA.ASM)
+XOS_BASE	.EQU	$20		; XOSERA: I/O BASE ADDRESS (REQUIRES 32 BYTES)
+XOSSIZ		.EQU	V80X30		; XOSERA: DISPLAY FORMAT [V80X30|V80X60]
 ;
 MDENABLE	.EQU	TRUE		; MD: ENABLE MEMORY (ROM/RAM) DISK DRIVER (MD.ASM)
 MDROM		.EQU	TRUE		; MD: ENABLE ROM DISK

Source/HBIOS/dsrtc.asm

@@ -482,6 +482,7 @@ DSRTC_DETECT:
 DSRTC_DETECT1:
 	PUSH	AF			; SAVE STATUS
 	LD	A,(DSRTC_TEMP)		; GET SAVED VALUE
+	LD	E,A			; TO E
 	LD	C,30			; NVRAM INDEX 30
 	CALL	DSRTC_SETBYT		; SAVE IT
 	POP	AF			; RECOVER STATUS

Source/HBIOS/hbios.asm

@@ -522,8 +522,9 @@ HB_HCB_END	.EQU	$
 ; THE FOLLOWING CODE IS RELOCATED TO THE TOP OF MEMORY TO HANDLE INVOCATION DISPATCHING
 ;
 HB_PROXY_BEG	.EQU	$
+HBX_IMG		.EQU	$		; LOC OF HBX IMAGE IN HBIOS IMAGE BANK
 ;
-	.FILL	(HBX_IMG - $)		; FILL TO START OF PROXY IMAGE START
+;;;	.FILL	(HBX_IMG - $)		; FILL TO START OF PROXY IMAGE START
 	.ORG	HBX_LOC			; ADJUST FOR RELOCATION
 ;
 ; MEMORY LAYOUT:
@@ -3954,6 +3955,9 @@ HB_PCINITTBL:
 #IF (PIO_4P | PIO_ZP)
 	.DW	PIO_PREINIT
 #ENDIF
+#IF (XOSENABLE)
+	.DW	XOS_PREINIT
+#ENDIF
 ;
 HB_PCINITTBLLEN	.EQU	(($ - HB_PCINITTBL) / 2)
 ;
@@ -4058,6 +4062,9 @@ HB_INITTBL:
 #IF (EZ80RTCENABLE)
 	.DW	EZ80RTC_INIT
 #ENDIF
+#IF (PCRTCENABLE)
+	.DW	PCRTC_INIT
+#ENDIF
 #IF (CPUFAM == CPU_EZ80)
 	; INITALISE ONE OF THE SUPPORTED SYSTEM TIMER TICKS DRIVERS
 	.DW	EZ80_TMR_INIT
@@ -4089,6 +4096,9 @@ HB_INITTBL:
 #IF (SCONENABLE)
 	.DW	SCON_INIT
 #ENDIF
+#IF (XOSENABLE)
+	.DW     XOS_INIT
+#ENDIF
 #IF (LPTENABLE)
 	.DW	LPT_INIT
 #ENDIF
@@ -8830,6 +8840,7 @@ PS_VDVGA	.TEXT	"VGA$"
 PS_VDVRC	.TEXT	"VRC$"
 PS_VDEF		.TEXT	"EF$"
 PS_VDFV		.TEXT	"FV$"
+PS_VDXOSERA	.TEXT	"XOSERA$"
 ;
 ; VIDEO TYPE STRINGS
 ;
@@ -8969,6 +8980,15 @@ SIZ_DS5RTC	.EQU	$ - ORG_DS5RTC
 		MEMECHO	" bytes.\n"
 #ENDIF
 ;
+#IF (PCRTCENABLE)
+ORG_PCRTC	.EQU	$
+  #INCLUDE "pcrtc.asm"
+SIZ_PCRTC	.EQU	$ - ORG_PCRTC
+		MEMECHO	"PCRTC occupies "
+		MEMECHO	SIZ_PCRTC
+		MEMECHO	" bytes.\n"
+#ENDIF
+;
 #IF (INTRTCENABLE)
 ORG_INTRTC	.EQU	$
   #INCLUDE "intrtc.asm"
@@ -9167,6 +9187,15 @@ SIZ_FV	.EQU	$ - ORG_FV
 		MEMECHO	" bytes.\n"
 #ENDIF
 ;
+#IF (XOSENABLE)
+ORG_XOS	.EQU	$
+  #INCLUDE "xosera.asm"
+SIZ_XOS	.EQU	$ - ORG_XOS
+		MEMECHO "XOS occupies "
+		MEMECHO SIZ_XOS
+		MEMECHO " bytes.\n"
+#ENDIF
+;
 #IF (DMAENABLE)
 ORG_DMA	.EQU	$
 #INCLUDE "dma.asm"

Source/HBIOS/hbios.inc

@@ -431,6 +431,7 @@ RTCDEV_DS7	.EQU	$04		; DS1307 (I2C)
 RTCDEV_RP5	.EQU	$05		; RP5C01
 RTCDEV_DS5	.EQU	$06		; DS1305 (SPI)
 RTCDEV_EZ80	.EQU	$07		; EZ80 ON-CHIP RTC
+RTCDEV_PC	.EQU	$08		; PC style parallel RTC
 ;
 ; DSKY DEVICE IDS
 ;
@@ -450,6 +451,7 @@ VDADEV_VGA	.EQU	$04		; ECB VGA3 - HITACHI HD6445
 VDADEV_VRC	.EQU	$05		; VGARC
 VDADEV_EF	.EQU	$06		; EF9345
 VDADEV_FV	.EQU	$07		; S100 FPGA VGA
+VDADEV_XOSERA	.EQU	$08		; XOSERA RCBUS
 ;
 ; SOUND DEVICE IDS
 ;

Source/HBIOS/layout.inc

@@ -1,146 +1,224 @@
 ;
-; The was extracted out of STD.ASM, so can be included
-; in BIOS apps that are NOT in HBIOS directory!
+;==================================================================================================
+;   ROMWBW CPU MEMORY AND ROM BANK LAYOUT DEFINITIONS
+;==================================================================================================
 ;
-; =============
-; MEMORY LAYOUT
-; =============
+; THIS FILE DEFINES THE MEMORY LAYOUT OF THE CPU ADDRESS SPACE AND
+; THE LAYOUT OF CODE IMAGES IN ROM.  THIS FILE IS INTENDED TO BE
+; INCLUDED IN SOURCE FILES AS NEEDED TO ADAPT TO THE ROMWBW BUILD
+; CONFIGURATION.
 ;
-SYS_SIZ		.EQU	$3000			; COMBINED SIZE OF SYSTEM AREA (OS + HBIOS PROXY)
-HBBUF_SIZ	.EQU	1024			; INVARIANT HBIOS PHYSICAL DISK BUFFER, 1K
-HBX_SIZ		.EQU	$200			; HBIOS PROXY SIZE (SUBJECT TO CHANGE)
-CPM_SIZ		.EQU	SYS_SIZ - HBX_SIZ	; NET SIZE OF ALL OS COMPONENTS (EXCLUDING HBIOS PROXY)
-CCP_SIZ		.EQU	$800			; INVARIANT SIZE OF CCP
-BDOS_SIZ	.EQU	$E00			; INVARIANT SIZE OF BDOS
-CBIOS_SIZ	.EQU	CPM_SIZ - CCP_SIZ - BDOS_SIZ	; CBIOS IS THE REMAINDER
+; THE FIRST 4 BANKS OF ROMWBW ROMS CONTAIN ROMWBW SOFTWARE COMPONENTS.
+; THE REMAINING BANKS ARE USED AS ROM DISK CONTENTS.
+;
+;   ROM BANK SUMMARY
+;   ----------------
+;
+;   ROM BANK	BANK ID		DESCRIPTION
+;   --------	--------	----------------------------------------
+;   0 (ROM0)	BID_BOOT	HBIOS KERNEL (HBIOS.ASM)
+;   1 (ROM1)	BID_IMG0	MONITOR, BOOT LOADER, ROM OS IMAGES
+;   2 (ROM2)	BID_IMG1	ROM APPLICATIONS
+;   3 (ROM3)	BID_IMG2	ROM UTILITIES
+;
+;--------------------------------------------------------------------------------------------------
+; CPU ADDRESS SPACE MEMORY LAYOUT
+;--------------------------------------------------------------------------------------------------
 ;
 MEMTOP		.EQU	$10000			; INVARIANT TOP OF Z80 ADDRESSABLE MEMORY
 BNKTOP		.EQU	$8000			; BANK MEMORY BARRIER
 ;
-HBX_IMG		.EQU	$200			; LOC OF HBX IMAGE IN HBIOS IMAGE BANK
+HBX_SIZ		.EQU	$200			; HBIOS PROXY SIZE (SUBJECT TO CHANGE)
+HBX_LOC		.EQU	MEMTOP - HBX_SIZ	; RUNNING LOCATION OF HBIOS PROXY
 ;
-HBBUF_END	.EQU	BNKTOP			; END OF PHYSICAL DISK BUFFER IN HBIOS
-HBBUF_LOC	.EQU	HBBUF_END - HBBUF_SIZ	; START OF PHYSICAL DISK BUFFER
-HBX_END		.EQU	MEMTOP			; END OF HBIOS PROXY
-HBX_LOC		.EQU	HBX_END - HBX_SIZ	; START OF HBIOS PROXY
-CPM_END		.EQU	HBX_LOC			; END OF CPM COMPONENTS (INCLUDING CBIOS)
-CPM_LOC		.EQU	CPM_END - CPM_SIZ	; START OF CPM COMPONENTS
-CBIOS_END	.EQU	HBX_LOC			; END OF CBIOS
-CBIOS_LOC	.EQU	CBIOS_END - CBIOS_SIZ	; START OF CBIOS
+CPM_LOC		.EQU	$D000			; START OF CPM COMPONENTS
+CPM_SIZ		.EQU	HBX_LOC - CPM_LOC	; NET SIZE OF ALL OS COMPONENTS (EXCLUDING HBIOS PROXY)
+;
+CCP_SIZ		.EQU	$0800			; INVARIANT SIZE OF CCP
+BDOS_SIZ	.EQU	$0E00			; INVARIANT SIZE OF BDOS
+CBIOS_SIZ	.EQU	CPM_SIZ - CCP_SIZ - BDOS_SIZ	; REMAINDER IS CBIOS SIZE
+;
+CBIOS_LOC	.EQU	HBX_LOC - CBIOS_SIZ	; START OF CBIOS
+BDOS_LOC	.EQU	CBIOS_LOC - BDOS_SIZ	; START OF BDOS
+CCP_LOC		.EQU	BDOS_LOC - CCP_SIZ	; START OF CCP
 ;
 CPM_ENT		.EQU	CBIOS_LOC		; CPM ENTRY POINT (IN CBIOS)
 ;
-CPM_IMGSIZ	.EQU	$3000
+; THE SIZE OF THE CPM IMAGE STORED ON A ROM BANK IS GREATER THAN THE
+; SIZE TO BE LOADED.  THE FORMER INCLUDES HBIOS SPACE AND THE LATTER
+; DOES NOT.  USE CPM_IMGSIZ WHEN REFERRING TO IMAGE SIZE STORED ON ROM.
+CPM_IMGSIZ	.EQU	$3000			; CPM IMAGE SIZE ON ROM
 ;
-; =============================
-; ROM BANK 0    (hbios_rom.bin)
-; =============================
+;--------------------------------------------------------------------------------------------------
+; ROM BANK 0 (BID_BOOT) LAYOUT (ROM0.BIN)
+;--------------------------------------------------------------------------------------------------
 ;
-; See hbios.asm for content of Bank 0
+; SEE HBIOS.ASM FOR CONTENT OF BANK 0
 ;
-; =============================
-; ROM BANK 1 LAYOUT (osimg.bin)
-; =============================
+;--------------------------------------------------------------------------------------------------
+; ROM BANK 1 (BID_IMG0) LAYOUT (ROM1.BIN)
+;--------------------------------------------------------------------------------------------------
 ;
-LDR_LOC		.EQU	$0000			; ROM LOADER
-LDR_SIZ		.EQU	$1000
-LDR_END		.EQU	LDR_LOC +LDR_SIZ
-LDR_IMGLOC	.EQU	$0000
+BNK_NXTLOC	.EQU	$0000			; RESET TO START OF BANK
+BNK_CUR		.EQU	1			; THIS IS ROM BANK 1 (BID_IMG0)
 ;
-MON_LOC		.EQU	$EE00			; LOCATION OF MONITOR FOR RUNNING SYSTEM
+LDR_BNK		.EQU	BNK_CUR
+LDR_LOC		.EQU	$0000			; RUNNING LOCATION OF BOOT LOADER
+LDR_SIZ		.EQU	$1000			; SIZE OF BOOT LOADER BINARY IMAGE
+LDR_END		.EQU	LDR_LOC + LDR_SIZ	; ENDING ADDRESS OF RUNNING BOOT LOADER
+LDR_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	LDR_IMGLOC + LDR_SIZ	; IMG LOC OF NEXT COMPONENT
+;
+MON_BNK		.EQU	BNK_CUR
+MON_LOC		.EQU	$EE00			; RUNNING LOCATION OF MONITOR
 MON_SIZ		.EQU	$1000			; SIZE OF MONITOR BINARY IMAGE
-MON_END		.EQU	MON_LOC + MON_SIZ	; END OF MONITOR
-MON_IMGLOC	.EQU	LDR_IMGLOC + LDR_SIZ
+MON_END		.EQU	MON_LOC + MON_SIZ	; ENDING ADDRESS OF RUNNING MONITOR
+MON_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	MON_IMGLOC + MON_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
-ZSYS_IMGLOC	.EQU	MON_IMGLOC + MON_SIZ	; ZSDOS / Z-System
+ZSYS_BNK	.EQU	BNK_CUR
+ZSYS_LOC	.EQU	CPM_LOC			; RUNNING LOCATION OF ZSYSTEM
+ZSYS_SIZ	.EQU	CPM_SIZ			; SIZE OF ZSYSTEM BINARY IMAGE
+ZSYS_END	.EQU	ZSYS_LOC + ZSYS_SIZ	; ENDING ADDRESS OF RUNNING ZSYSTEM
+ZSYS_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+ZSYS_IMGSIZ	.EQU	CPM_IMGSIZ		; SIZE OF LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	ZSYS_IMGLOC + ZSYS_IMGSIZ	; IMG LOC OF NEXT COMPONENT
 ;
-CPM_IMGLOC	.EQU	ZSYS_IMGLOC + CPM_IMGSIZ ; CP/M 2.2
+CPM22_BNK	.EQU	BNK_CUR
+CPM22_LOC	.EQU	CPM_LOC			; RUNNING LOCATION OF CPM 2.2
+CPM22_SIZ	.EQU	CPM_SIZ                 ; SIZE OF CPM 2.2 BINARY IMAGE
+CPM22_END	.EQU	CPM22_LOC + CPM22_SIZ   ; ENDING ADDRESS OF RUNNING CPM 2.2
+CPM22_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+CPM22_IMGSIZ	.EQU	CPM_IMGSIZ		; SIZE OF LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	CPM22_IMGLOC + CPM22_IMGSIZ	; IMG LOC OF NEXT COMPONENT
 ;
-BNK1_IMGEND	.EQU	CPM_IMGLOC + CPM_IMGSIZ	; END OF BANK
-BNK1_REMAIN	.EQU	BNKTOP - BNK1_IMGEND	; REMAINING
+BNK1_LEN	.EQU	BNK_NXTLOC		; SIZE OF BANK CONTENTS
+BNK1_SLACK	.EQU	BNKTOP - BNK_NXTLOC	; REMAINING BANK SPACE
 ;
-; ==============================
-; ROM BANK 2 LAYOUT (osimg1.bin)
-; ==============================
+;--------------------------------------------------------------------------------------------------
+; ROM BANK 2 (BID_IMG1) LAYOUT (ROM2.BIN)
+;--------------------------------------------------------------------------------------------------
+;
+BNK_NXTLOC	.SET	$0000			; RESET TO START OF BANK
+BNK_CUR		.SET	2			; THIS IS ROM BANK 2 (BID_IMG1)
 ;
 ; NOTE FOLLOWING ARE COPY/PASTED INTO camel80.azm !!!!!!!!
+FTH_BNK		.EQU	BNK_CUR
 FTH_LOC		.EQU	$0200			; CAMEL FORTH
 FTH_SIZ		.EQU	$1700
 FTH_END		.EQU	FTH_LOC + FTH_SIZ
-FTH_IMGLOC	.EQU	$0000
-
+FTH_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	FTH_IMGLOC + FTH_SIZ	; IMG LOC OF NEXT COMPONENT
+;
+BAS_BNK		.EQU	BNK_CUR
 BAS_LOC		.EQU	$0200			; NASCOM BASIC
 BAS_SIZ		.EQU	$2000
 BAS_END		.EQU	BAS_LOC + BAS_SIZ
-BAS_IMGLOC	.EQU	FTH_IMGLOC + FTH_SIZ
+BAS_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	BAS_IMGLOC + BAS_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
 ; NOTE FOLLOWING ARE COPY/PASTED INTO tastybasic.asm !!!!!!!!
+TBC_BNK		.EQU	BNK_CUR
 TBC_LOC		.EQU	$0A00			; TASTYBASIC
 TBC_SIZ		.EQU	$0A00
 TBC_END		.EQU	TBC_LOC + TBC_SIZ
-TBC_IMGLOC	.EQU	BAS_IMGLOC + BAS_SIZ
+TBC_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	TBC_IMGLOC + TBC_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
+GAM_BNK		.EQU	BNK_CUR
 GAM_LOC		.EQU	$0200			; GAME 2048
 GAM_SIZ		.EQU	$0900
 GAM_END		.EQU	GAM_LOC + GAM_SIZ
-GAM_IMGLOC	.EQU	TBC_IMGLOC + TBC_SIZ
+GAM_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	GAM_IMGLOC + GAM_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
+EGG_BNK		.EQU	BNK_CUR
 EGG_LOC		.EQU	$F000			; EASTER EGG
 EGG_SIZ		.EQU	$0200
 EGG_END		.EQU	EGG_LOC + EGG_SIZ
-EGG_IMGLOC	.EQU	GAM_IMGLOC + GAM_SIZ
+EGG_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	EGG_IMGLOC + EGG_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
+NET_BNK		.EQU	BNK_CUR
 NET_LOC		.EQU	$0100			; NETWORK BOOT
 NET_SIZ		.EQU	$1000
 NET_END		.EQU	NET_LOC + NET_SIZ
-NET_IMGLOC	.EQU	EGG_IMGLOC + EGG_SIZ
+NET_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	NET_IMGLOC + NET_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
+UPD_BNK		.EQU	BNK_CUR
 UPD_LOC		.EQU	$0200			; ROM UPDATER
 UPD_SIZ		.EQU	$0D00
 UPD_END		.EQU	UPD_LOC + UPD_SIZ
-UPD_IMGLOC	.EQU	NET_IMGLOC + NET_SIZ
+UPD_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	UPD_IMGLOC + UPD_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
+NVR_BNK		.EQU	BNK_CUR
 NVR_LOC		.EQU	$0100			; NVRAM CONFIG
 NVR_SIZ		.EQU	$0800
 NVR_END		.EQU	NVR_LOC + NVR_SIZ
-NVR_IMGLOC	.EQU	UPD_IMGLOC + UPD_SIZ
+NVR_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	NVR_IMGLOC + NVR_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
+USR_BNK		.EQU	BNK_CUR
 USR_LOC		.EQU	$0200			; USER
 USR_SIZ		.EQU	$0200
 USR_END		.EQU	USR_LOC + USR_SIZ
-USR_IMGLOC	.EQU	NVR_IMGLOC + NVR_SIZ
+USR_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	USR_IMGLOC + USR_SIZ	; IMG LOC OF NEXT COMPONENT
 ;
-BNK2_IMGEND	.EQU	USR_IMGLOC + USR_SIZ	; END OF BANK
-BNK2_REMAIN	.EQU	BNKTOP - BNK2_IMGEND	; REMAINING
+BNK2_LEN	.EQU	BNK_NXTLOC		; SIZE OF BANK CONTENTS
+BNK2_SLACK	.EQU	BNKTOP - BNK_NXTLOC	; REMAINING BANK SPACE
 ;
-; ==============================
-; ROM BANK 3 LAYOUT (osimg2.bin)
-; ==============================
+;--------------------------------------------------------------------------------------------------
+; ROM BANK 3 (BID_IMG2) LAYOUT (ROM3.BIN)
+;--------------------------------------------------------------------------------------------------
 ;
-; not defined here, see build files
-; optionally contains S100 monitor
+BNK_NXTLOC	.SET	$0000			; RESET TO START OF BANK
+BNK_CUR		.SET	3			; THIS IS ROM BANK 3 (BID_IMG2)
 ;
-; =================
+HWMON_BNK	.EQU	BNK_CUR
+HWMON_LOC	.EQU	$E000
+HWMON_SIZ	.EQU	$2000
+HWMON_END	.EQU	HWMON_LOC + HWMON_SIZ
+HWMON_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	HWMON_IMGLOC + HWMON_SIZ	; IMG LOC OF NEXT COMPONENT
+;
+FONTS_BNK	.EQU	BNK_CUR
+;;;FONTS_LOC	.EQU	$E000
+FONTS_SIZ	.EQU	$2000
+;;;FONTS_END	.EQU	FONTS_LOC + FONTS_SIZ
+FONTS_IMGLOC	.EQU	BNK_NXTLOC		; LOCATION OF BINARY LOAD IMAGE IN BANK
+BNK_NXTLOC	.SET	FONTS_IMGLOC + FONTS_SIZ	; IMG LOC OF NEXT COMPONENT
+;
+BNK3_LEN	.EQU	BNK_NXTLOC		; SIZE OF BANK CONTENTS
+BNK3_SLACK	.EQU	BNKTOP - BNK_NXTLOC	; REMAINING BANK SPACE
+;
+;--------------------------------------------------------------------------------------------------
 ;
 #IFDEF BNKINFO
+;
 	.ECHO "-------------------------------\n"
-	.ECHO "ROM BANK INFO  \tLENGTH \tREMAIN \n"
+	.ECHO "ROM BANK INFO  \tLENGTH \tSLACK \n"
 	.ECHO "---------------\t-------\t-------\n"
-	.ECHO "BANK1 BID_IMG0 \t" \ .ECHO BNK1_IMGEND \ .ECHO "\t" \ .ECHO BNK1_REMAIN \ .ECHO "\n"
-	.ECHO "BANK2 BID_IMG1 \t" \ .ECHO BNK2_IMGEND \ .ECHO "\t" \ .ECHO BNK2_REMAIN \ .ECHO "\n"
+	.ECHO "BANK1 BID_IMG0 \t" \ .ECHO BNK1_LEN \ .ECHO "\t" \ .ECHO BNK1_SLACK \ .ECHO "\n"
+	.ECHO "BANK2 BID_IMG1 \t" \ .ECHO BNK2_LEN \ .ECHO "\t" \ .ECHO BNK2_SLACK \ .ECHO "\n"
+	.ECHO "BANK3 BID_IMG2 \t" \ .ECHO BNK3_LEN \ .ECHO "\t" \ .ECHO BNK3_SLACK \ .ECHO "\n"
 	.ECHO "-------------------------------\n"
 ;
-  #IF (BNK1_IMGEND > BNKTOP)
-	.ECHO	"*** BANK 1 IS TOO BIG!!!\n"
+  #IF (BNK1_LEN > BNKTOP)
+	.ECHO	"*** ROM BANK 1 IS TOO BIG!!!\n"
 	!!!	; FORCE AN ASSEMBLY ERROR IF BANK SIZE EXCEEDS SPACE
   #ENDIF
-  #IF (BNK2_IMGEND > BNKTOP)
-	.ECHO	"*** BANK 2 IS TOO BIG!!!\n"
+;
+  #IF (BNK2_LEN > BNKTOP)
+	.ECHO	"*** ROM BANK 2 IS TOO BIG!!!\n"
+	!!!	; FORCE AN ASSEMBLY ERROR IF BANK SIZE EXCEEDS SPACE
+  #ENDIF
+;
+  #IF (BNK3_LEN > BNKTOP)
+	.ECHO	"*** ROM BANK 3 IS TOO BIG!!!\n"
 	!!!	; FORCE AN ASSEMBLY ERROR IF BANK SIZE EXCEEDS SPACE
   #ENDIF
 ;
 #ENDIF
-
-
-
-

Source/HBIOS/md.asm

@@ -359,6 +359,7 @@ MD_RDSECF:				; CALLED FROM MD_RW
 					; SAVE THE 4K LBA FOR FUTURE CHECKS
 ;
 	CALL	MD_CALBAS		; SETUP BANK AND SECTOR
+	RET	NZ			; RETURN IF ERROR
 ;
 	LD	IX,MD_F4KBUF		; SET DESTINATION ADDRESS
 	LD	HL,MD_FREAD_R		; PUT ROUTINE TO CALL
@@ -467,7 +468,18 @@ MD_CALBAS:
 	CALL	PRTHEXWORD		; DISPLAY BANK AND
 	CALL	PC_SPACE		; SECTOR RESULT
 #ENDIF
-
+;
+	; CHECK FOR ACCESS BEYOND AVAILABLE ROM BANKS
+	LD	A,B			; BANK ID TO ACCUM
+	SUB	BID_ROMD0		; ZERO OFFSET
+	CP	ROMD_BNKS		; CHECK FOR OUT OF BOUNDS
+	JR	C,MD_CALBAS1		; IF NOT, CONTINUE
+	LD	A,ERR_IO		; ELSE SIGNAL IO ERROR
+	OR	A			; SET FLAGS
+	RET				; AND RETURN
+;
+MD_CALBAS1:
+	XOR	A			; SIGNAL SUCCESS
 	RET
 ;
 ; WRITE FLASH
@@ -485,6 +497,7 @@ MD_WRSECF:				; CALLED FROM MD_RW
 	LD	(MD_LBA4K),BC		; SAVE 4K LBA
 ;
 	CALL	MD_CALBAS		; SETUP BANK AND SECTOR
+	RET	NZ			; RETURN ON ERROR
 ;
 	LD	IX,MD_F4KBUF		; SET DESTINATION ADDRESS
 	LD	HL,MD_FREAD_R		; PUT ROUTINE TO CALL
@@ -566,6 +579,12 @@ MD_FBAS		.DW	$FFFF		; BANK AND SECTOR
 ;
 MD_RDSEC:
 	CALL	MD_IOSETUP		; SETUP FOR MEMORY COPY
+	CP	$FF			; ERROR?
+	JR	NZ,MD_RDSEC1		; IF NOT, CONTINUE
+	LD	A,ERR_IO		; SIGNAL IO ERROR
+	OR	A			; SET FLAGS
+	RET				; AND DONE
+MD_RDSEC1:
 #IF (MDTRACE >= 2)
 	LD	(MD_SRC),HL
 	LD	(MD_DST),DE
@@ -597,6 +616,12 @@ MD_RDSEC:
 ;
 MD_WRSEC:
 	CALL	MD_IOSETUP		; SETUP FOR MEMORY COPY
+	CP	$FF			; ERROR?
+	JR	NZ,MD_WRSEC1		; IF NOT, CONTINUE
+	LD	A,ERR_IO		; SIGNAL IO ERROR
+	OR	A			; SET FLAGS
+	RET				; AND DONE
+MD_WRSEC1:
 	EX	DE,HL			; SWAP SRC/DEST FOR WRITE
 #IF (MDTRACE >= 2)
 	LD	(MD_SRC),HL
@@ -682,13 +707,21 @@ MD_IOSETUP:
 	JR	Z,MD_IOSETUP2		; DO ROM DRIVE, ELSE FALL THRU FOR RAM DRIVE
 ;
 MD_IOSETUP1:	; ROM
+	CP	ROMD_BNKS		; WITHIN AVAILABLE ROM DISK BANKS?
+	JR	NC,MD_IOSETUP3		; HANDLE OUT OF BOUNDS
 	ADD	A,BID_ROMD0
 	RET
 ;
 MD_IOSETUP2:	; RAM
+	CP	RAMD_BNKS		; WITHIN AVAILABLE RAM DISK BANKS?
+	JR	NC,MD_IOSETUP3		; HANDLE OUT OF BOUNDS
 	ADD	A,BID_RAMD0
 	RET
 ;
+MD_IOSETUP3:
+	OR	$FF			; SIGNAL ERROR
+	RET				; DONE
+;
 ;
 ;
 #IF (MDTRACE >= 2)

Source/HBIOS/pcrtc.asm

@@ -0,0 +1,368 @@
+;
+;==================================================================================================
+; MC146818/DS1285/DS12885 PC style CLOCK DRIVER
+;==================================================================================================
+;
+PCRTC_BUFSIZ	.EQU	6	; SIX BYTE BUFFER (YYMMDDHHMMSS)
+
+	;;  Addressing is via first writing the address byte to IO port PCRTC_BASE
+	;;  Then read from or write to PCRTC_DAT
+
+	;; PCRTC_BASE must be set in config files
+PCRTC_REG	.EQU 	PCRTC_BASE
+PCRTC_DAT	.EQU	PCRTC_BASE + $01
+
+REG_SEC		.EQU	$00
+REG_SEC_ALM	.EQU	$01
+REG_MIN		.EQU 	$02
+REG_MIN_ALM	.EQU 	$03
+REG_HOUR	.EQU 	$04
+REG_HOUR_ALM	.EQU 	$05
+REG_DOW		.EQU	$06	; day of week
+REG_DAY		.EQU	$07
+REG_MONTH	.EQU	$08
+REG_YEAR	.EQU	$09
+REG_CTLA	.EQU	$0A
+REG_CTLB	.EQU	$0B
+REG_CTLC	.EQU	$0C
+REG_CTLD	.EQU	$0D
+
+CTLA_VAL	.EQU	$2F
+CTLB_VAL	.EQU	$0A
+
+PCRTC_NVBASE	.EQU	$10
+PCRTC_NVSIZE	.EQU	$30	; 64 bytes in total is what DS1285 and MC146818 had
+
+		DEVECHO	"PCRTC: IO="
+		DEVECHO	PCRTC_BASE
+		DEVECHO	"\n"
+
+PCRTC_INIT:
+	LD	A, (RTC_DISPACT)	; RTC DISPATCHER ALREADY SET?
+	OR	A			; SET FLAGS
+	RET	NZ			; IF ALREADY ACTIVE, ABORT
+
+	CALL	NEWLINE			; FORMATTING
+	PRTS("PC RTC: $")
+
+	; PRINT RTC REGISTER NR PORT ADDRESS
+	PRTS("IO=0x$")			; LABEL FOR IO ADDRESS
+	LD	A,PCRTC_REG		; GET IO ADDRESS
+	CALL	PRTHEXBYTE		; PRINT IT
+        CALL    PC_SPACE                ; FORMATTING
+
+	; CHECK PRESENCE STATUS
+	CALL	PCRTC_DETECT		; HARDWARE DETECTION
+	JR	Z, PCRTC_INIT1		; IF ZERO, ALL GOOD
+	PRTS("NOT PRESENT$")		; NOT ZERO, H/W NOT PRESENT
+	OR	$FF			; SIGNAL FAILURE
+	RET				; BAIL OUT
+
+PCRTC_INIT1:
+	CALL	PCRTC_RDTIM
+
+	; DISPLAY CURRENT TIME
+	LD	HL, PCRTC_BCDBUF	; POINT TO BCD BUF
+	CALL	PRTDT
+;
+	LD	BC, PCRTC_DISPATCH
+	CALL	RTC_SETDISP
+;
+	XOR	A			; SIGNAL SUCCESS
+	RET
+;
+; DETECT RTC HARDWARE PRESENCE
+;
+PCRTC_DETECT:
+	LD	C, 0			; NVRAM INDEX 0
+	CALL	PCRTC_GETBYT		; GET VALUE
+	LD	A, E			; TO ACCUM
+	LD	L, A			; SAVE IT
+	XOR	$FF			; FLIP ALL BITS
+	LD	E, A			; TO E
+	LD	C, 0			; NVRAM INDEX 0
+	CALL	PCRTC_SETBYT		; WRITE IT
+	LD	C, 0			; NVRAM INDEX 0
+	CALL	PCRTC_GETBYT		; GET VALUE
+	LD	A, L			; GET SAVED VALUE
+	XOR	$FF			; FLIP ALL BITS
+	CP	E			; COMPARE WITH VALUE READ
+	LD	A, 0			; ASSUME OK
+	JR	Z, PCRTC_DETECT1	; IF MATCH, GO AHEAD
+	LD	A, $FF			; ELSE STATUS IS ERROR
+
+PCRTC_DETECT1:
+	PUSH	AF			; SAVE STATUS
+	LD	E, L			; GET SAVED VALUE
+	LD	C, 0 			; NVRAM INDEX 0
+	CALL	PCRTC_SETBYT		; SAVE IT
+	POP	AF			; RECOVER STATUS
+	OR	A			; SET FLAGS
+	RET
+;
+; RTC DEVICE FUNCTION DISPATCH ENTRY
+;   A: RESULT (OUT), 0=OK, Z=OK, NZ=ERR
+;   B: FUNCTION (IN)
+;
+PCRTC_DISPATCH:
+	LD	A,B			; GET REQUESTED FUNCTION
+	AND	$0F			; ISOLATE SUB-FUNCTION
+	JP	Z,PCRTC_GETTIM		; GET TIME
+	DEC	A
+	JP	Z,PCRTC_SETTIM		; SET TIME
+	DEC	A
+	JP	Z,PCRTC_GETBYT		; GET NVRAM BYTE VALUE
+	DEC	A
+	JP	Z,PCRTC_SETBYT		; SET NVRAM BYTE VALUE
+	DEC	A
+	JP	Z,PCRTC_GETBLK		; GET NVRAM DATA BLOCK VALUES
+	DEC	A
+	JP	Z,PCRTC_SETBLK		; SET NVRAM DATA BLOCK VALUES
+	DEC	A
+	JP	Z,PCRTC_GETALM		; GET ALARM
+	DEC	A
+	JP	Z,PCRTC_SETALM		; SET ALARM
+	DEC	A
+	JP	Z,PCRTC_DEVICE		; REPORT RTC DEVICE INFO
+	SYSCHKERR(ERR_NOFUNC)
+	RET
+;
+; RTC GET NVRAM BYTE
+;   C: INDEX
+;   E: VALUE (OUTPUT)
+;   A:0 IF OK, ERR_RANGE IF OUT OF RANGE
+;
+PCRTC_GETBYT:
+	LD	A, C
+	CP	PCRTC_NVSIZE
+	JR	NC, PCRTC_BADIDX
+
+	ADD	A, PCRTC_NVBASE
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	E, A
+
+	XOR	A			; SIGNAL SUCCESS
+	RET				; AND RETURN
+
+PCRTC_BADIDX:
+	LD	E, 00
+	LD	A, ERR_RANGE
+	RET
+;
+; RTC SET NVRAM BYTE
+;   C: INDEX
+;   E: VALUE
+;   A:0 IF OK, ERR_RANGE IF OUT OF RANGE
+;
+PCRTC_SETBYT:
+	LD	A, C
+	CP	PCRTC_NVSIZE
+	JR	NC, PCRTC_BADIDX
+
+	ADD	A, PCRTC_NVBASE
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, E
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	XOR	A			; SIGNAL SUCCESS
+	RET				; AND RETURN
+
+
+PCRTC_GETBLK:
+PCRTC_SETBLK:
+PCRTC_GETALM:
+PCRTC_SETALM:
+	SYSCHKERR(ERR_NOTIMPL)
+	RET
+;
+; RTC GET TIME
+;   A: RESULT (OUT), 0=OK, Z=OK, NZ=ERR
+;   HL: DATE/TIME BUFFER (OUT)
+; BUFFER FORMAT IS BCD: YYMMDDHHMMSS
+; 24 HOUR TIME FORMAT IS ASSUMED
+;
+PCRTC_GETTIM:
+	; GET THE TIME INTO TEMP BUF
+	PUSH	HL			; SAVE PTR TO CALLERS BUFFER
+;
+	CALL	PCRTC_RDTIM
+
+	; NOW COPY TO REAL DESTINATION (INTERBANK SAFE)
+	LD	A,BID_BIOS		; COPY FROM BIOS BANK
+	LD	(HB_SRCBNK),A		; SET IT
+	LD	A,(HB_INVBNK)		; COPY TO CURRENT USER BANK
+	LD	(HB_DSTBNK),A		; SET IT
+	LD	HL,PCRTC_BCDBUF		; SOURCE ADR
+	POP	DE			; DEST ADR
+	LD	BC,PCRTC_BUFSIZ		; LENGTH
+	CALL	HB_BNKCPY		; COPY THE CLOCK DATA
+
+	XOR	A			; SIGNAL SUCCESS
+	RET				; AND RETURN
+;
+;
+; RTC SET TIME
+;   A: RESULT (OUT), 0=OK, Z=OK, NZ=ERR
+;   HL: DATE/TIME BUFFER (IN)
+; BUFFER FORMAT IS BCD: YYMMDDHHMMSSWW
+; 24 HOUR TIME FORMAT IS ASSUMED
+;
+PCRTC_SETTIM:
+	; COPY TO BCD BUF
+	LD	A,(HB_INVBNK)		; COPY FROM CURRENT USER BANK
+	LD	(HB_SRCBNK),A		; SET IT
+	LD	A,BID_BIOS		; COPY TO BIOS BANK
+	LD	(HB_DSTBNK),A		; SET IT
+	LD	DE,PCRTC_BCDBUF		; DEST ADR
+	LD	BC,PCRTC_BUFSIZ		; LENGTH
+	CALL	HB_BNKCPY		; COPY THE RPC DATA
+;
+	LD	A, REG_CTLA	; Set Ctl Reg A
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, CTLA_VAL
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_CTLB	; Set Ctl Reg B
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, CTLB_VAL|0x80 ; Set the SET bit to stop updates
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_SEC	; Set seconds
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, (PCRTC_SS)
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_MIN	; Set minutes
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, (PCRTC_MM)
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_HOUR	; Set hours
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, (PCRTC_HH)
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_DAY	; Set date
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, (PCRTC_DT)
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+	
+	LD	A, REG_MONTH	; Set month
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, (PCRTC_MO)
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_YEAR	; Set year
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, (PCRTC_YR)
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	LD	A, REG_CTLB	; Set Ctl Reg B
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	LD	A, CTLB_VAL		; Reset the SET bit to start clock
+	EZ80_IO
+	OUT	(PCRTC_DAT), A
+
+	XOR	A			; SIGNAL SUCCESS
+	RET				; AND RETURN
+;
+; REPORT RTC DEVICE INFO
+;
+PCRTC_DEVICE:
+	LD	D,RTCDEV_PC		; D := DEVICE TYPE
+	LD	E,0			; E := PHYSICAL DEVICE NUMBER
+	LD	H,0			; H := 0, DRIVER HAS NO MODES
+	LD	L, PCRTC_BASE		; L := 0, NO I/O ADDRESS
+	XOR	A			; SIGNAL SUCCESS
+	RET
+
+;
+; READ OUT THE TIME
+PCRTC_RDTIM:
+	;;  Need to wait until update-in-progress flag is reset
+	LD	A, REG_CTLA	; Set Ctl Reg A
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	BIT	7, A
+	JP	NZ, PCRTC_RDTIM	; Jump back if update in progress.
+
+	LD	A, REG_SEC	; Set seconds
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	(PCRTC_SS), A
+
+	LD	A, REG_MIN	; Set minutes
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	(PCRTC_MM), A
+
+	LD	A, REG_HOUR	; Set hours
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	(PCRTC_HH), A
+
+	LD	A, REG_DAY	; Set day
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	(PCRTC_DT), A
+
+	LD	A, REG_MONTH	; Set month
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	(PCRTC_MO), A
+
+	LD	A, REG_YEAR	; Set year
+	EZ80_IO
+	OUT	(PCRTC_REG), A
+	EZ80_IO
+	IN	A, (PCRTC_DAT)
+	LD	(PCRTC_YR), A
+
+	RET
+
+
+;
+; REGISTER EXTRACTED VALUES
+;
+PCRTC_BCDBUF:
+PCRTC_YR	.DB	$25
+PCRTC_MO	.DB	$01
+PCRTC_DT	.DB	$01
+PCRTC_HH	.DB	$00
+PCRTC_MM	.DB	$00
+PCRTC_SS	.DB	$00
+

Source/HBIOS/romldr.asm

@@ -1553,7 +1553,7 @@ s100mon1:
 	; Launch S100 Monitor from ROM Bank 3
 	call	ldelay			; wait for UART buf to empty
 	di				; suspend interrupts
-	ld	a,BID_IMG2		; S100 monitor bank
+	ld	a,HWMON_BNK		; S100 monitor bank
 	ld	ix,0			; execution resumes here
 	jp	HB_BNKCALL		; do it
 ;
@@ -2629,31 +2629,32 @@ ra_ent		.equ	12
 ;
 ra_tbl:
 ;
-;      Name	  Key	   Dsky	  Bank	    Src	         Dest	    Size     Entry
-;      ---------  -------  -----  --------  -----        -------  -------  ----------
-ra_ent(str_mon,	  'M',	   KY_CL, BID_IMG0, MON_IMGLOC,  MON_LOC, MON_SIZ, MON_SERIAL)
-ra_entsiz	.equ	$ - ra_tbl
-#if (BIOS == BIOS_WBW)
-  #if (PLATFORM == PLT_S100)
-ra_ent(str_smon,  'S',	   $FF,	  bid_cur , $8000,       $8000,   $0001,   s100mon)
-  #endif
-#endif
-ra_ent(str_cpm22, 'C',	   KY_BK, BID_IMG0, CPM_IMGLOC,  CPM_LOC, CPM_SIZ, CPM_ENT)
-ra_ent(str_zsys,  'Z',	   KY_FW, BID_IMG0, ZSYS_IMGLOC, CPM_LOC, CPM_SIZ, CPM_ENT)
-#if (BIOS == BIOS_WBW)
-ra_ent(str_bas,	  'B',	   KY_DE, BID_IMG1, BAS_IMGLOC,  BAS_LOC, BAS_SIZ, BAS_LOC)
-ra_ent(str_tbas,  'T',	   KY_EN, BID_IMG1, TBC_IMGLOC,  TBC_LOC, TBC_SIZ, TBC_LOC)
-ra_ent(str_fth,	  'F',	   KY_EX, BID_IMG1, FTH_IMGLOC,  FTH_LOC, FTH_SIZ, FTH_LOC)
-ra_ent(str_play,  'P',	   $FF,	  BID_IMG1, GAM_IMGLOC,  GAM_LOC, GAM_SIZ, GAM_LOC)
-ra_ent(str_net,   'N',	   $FF,	  BID_IMG1, NET_IMGLOC,  NET_LOC, NET_SIZ, NET_LOC)
-ra_ent(str_upd,   'X',	   $FF,	  BID_IMG1, UPD_IMGLOC,  UPD_LOC, UPD_SIZ, UPD_LOC)
-ra_ent(str_nvr,   'W'+$80, $FF,	  BID_IMG1, NVR_IMGLOC,  NVR_LOC, NVR_SIZ, NVR_LOC)
-ra_ent(str_user,  'U',	   $FF,	  BID_IMG1, USR_IMGLOC,  USR_LOC, USR_SIZ, USR_LOC)
+;      Name	  Key	   Dsky	  Bank	     Src	   Dest	    Size     Entry
+;      ---------  -------  -----  --------   -----         -------  -------  ----------
+ra_ent(str_mon,	  'M',	   KY_CL, MON_BNK,   MON_IMGLOC,   MON_LOC, MON_SIZ, MON_SERIAL)
+ra_entsiz	.equ	$ - ra_tbl                         
+#if (BIOS == BIOS_WBW)                                     
+  #if (PLATFORM == PLT_S100)                               
+ra_ent(str_smon,  'S',	   $FF,	  bid_cur,   $8000,        $8000,   $0001,   s100mon)
+  #endif                                                   
+#endif                                                     
+ra_ent(str_cpm22, 'C',	   KY_BK, CPM22_BNK, CPM22_IMGLOC, CPM_LOC, CPM_SIZ, CPM_ENT)
+ra_ent(str_zsys,  'Z',	   KY_FW, ZSYS_BNK,  ZSYS_IMGLOC,  CPM_LOC, CPM_SIZ, CPM_ENT)
+#if (BIOS == BIOS_WBW)                                     
+ra_ent(str_bas,	  'B',	   KY_DE, BAS_BNK,   BAS_IMGLOC,   BAS_LOC, BAS_SIZ, BAS_LOC)
+ra_ent(str_tbas,  'T',	   KY_EN, TBC_BNK,   TBC_IMGLOC,   TBC_LOC, TBC_SIZ, TBC_LOC)
+ra_ent(str_fth,	  'F',	   KY_EX, FTH_BNK,   FTH_IMGLOC,   FTH_LOC, FTH_SIZ, FTH_LOC)
+ra_ent(str_play,  'P',	   $FF,	  GAM_BNK,   GAM_IMGLOC,   GAM_LOC, GAM_SIZ, GAM_LOC)
+ra_ent(str_net,   'N',	   $FF,	  NET_BNK,   NET_IMGLOC,   NET_LOC, NET_SIZ, NET_LOC)
+ra_ent(str_upd,   'X',	   $FF,	  UPD_BNK,   UPD_IMGLOC,   UPD_LOC, UPD_SIZ, UPD_LOC)
+ra_ent(str_nvr,   'W'+$80, $FF,	  NVR_BNK,   NVR_IMGLOC,   NVR_LOC, NVR_SIZ, NVR_LOC)
+ra_ent(str_user,  'U',	   $FF,	  USR_BNK,   USR_IMGLOC,   USR_LOC, USR_SIZ, USR_LOC)
 #endif
 #if (DSKYENABLE)
-ra_ent(str_dsky,  'Y'+$80, KY_GO, BID_IMG0, MON_IMGLOC,  MON_LOC, MON_SIZ, MON_DSKY)
+ra_ent(str_dsky,  'Y'+$80, KY_GO, MON_BNK,   MON_IMGLOC,   MON_LOC, MON_SIZ, MON_DSKY)
 #endif
-ra_ent(str_egg,	  'E'+$80, $FF,   BID_IMG1, EGG_IMGLOC,  EGG_LOC, EGG_SIZ, EGG_LOC)
+ra_ent(str_egg,	  'E'+$80, $FF,   EGG_BNK,   EGG_IMGLOC,   EGG_LOC, EGG_SIZ, EGG_LOC)
+;
 		.dw	0		; table terminator
 ;
 ra_tbl_app:
@@ -2665,6 +2666,7 @@ ra_ent(str_zsys,  'Z',	   KY_FW, bid_cur,  ZSYS_IMGLOC, CPM_LOC, CPM_SIZ, CPM_EN
 #if (DSKYENABLE)
 ra_ent(str_dsky,  'Y'+$80, KY_GO, bid_cur,  MON_IMGLOC,  MON_LOC, MON_SIZ, MON_DSKY)
 #endif
+;
 		.dw	0		; table terminator
 ;
 str_mon		.db	"Monitor",0

Source/HBIOS/rp5rtc.asm

@@ -136,7 +136,7 @@ RP5RTC_DETECT:
 
 RP5RTC_DETECT1:
 	PUSH	AF			; SAVE STATUS
-	LD	A, L			; GET SAVED VALUE
+	LD	E, L			; GET SAVED VALUE
 	LD	C, 0 			; NVRAM INDEX 0
 	CALL	RP5RTC_SETBYT		; SAVE IT
 	POP	AF			; RECOVER STATUS

Source/HBIOS/std.asm

@@ -881,8 +881,8 @@ ROMD_BNKS	.SET	0
 ;										-- TYPICAL --
 BID_BOOT	.EQU	BID_ROM0 + 0	; BOOT BANK				0x00
 BID_IMG0	.EQU	BID_ROM0 + 1	; ROM LOADER AND FIRST IMAGES BANK	0x01
-BID_IMG1	.EQU	BID_ROM0 + 2	; SECOND IMAGES BANK		 	0x02
-BID_IMG2	.EQU	BID_ROM0 + 3	; RESERVED				0x03
+BID_IMG1	.EQU	BID_ROM0 + 2	; ROM APPS IMAGES BANK		 	0x02
+BID_IMG2	.EQU	BID_ROM0 + 3	; ROM UTILITIES IMAGES BANK		0x03
 BID_ROMD0	.EQU	BID_ROM0 + 4	; FIRST ROM DRIVE BANK			0x04
 BID_BIOS	.EQU	BID_RAM0 + 0	; HBIOS BANK				0x80
 BID_RAMD0	.EQU	BID_RAM0 + 1	; FIRST RAM DRIVE BANK			0x81
@@ -899,8 +899,8 @@ BID_COM		.EQU	BID_RAMN - 0	; COMMON BANK, UPPER 32K		0x8F
 ;										-- TYPICAL --
 BID_BOOT	.EQU	BID_RAM0 + 0	; BOOT BANK				0x80
 BID_IMG0	.EQU	BID_RAM0 + 1	; ROM LOADER AND FIRST IMAGES BANK	0x81
-BID_IMG1	.EQU	BID_RAM0 + 2	; SECOND IMAGES BANK		 	0x82
-BID_IMG2	.EQU	BID_RAM0 + 3	; RESERVED				0x83
+BID_IMG1	.EQU	BID_RAM0 + 2	; ROM APPS IMAGES BANK		 	0x82
+BID_IMG2	.EQU	BID_RAM0 + 3	; ROM UTILITIES IMAGES BANK		0x83
 BID_RAMD0	.EQU	BID_RAM0 + 4	; FIRST RAM DRIVE BANK			0x84
 BID_APP0	.EQU	BID_RAMD0 + RAMD_BNKS	; FIRST APP BANK		0x89
 BID_BUF		.EQU	BID_RAMN - 3	; OS BUFFERS (CP/M3)			0x8C
@@ -1093,8 +1093,8 @@ INT_PIO1B	.EQU	12	; ZILOG PIO 1, CHANNEL B
 #ENDIF
 
 
-#DEFINE IVT(INTX) HB_IVT+(INTX * 4)+1
-#DEFINE VEC(INTX) INTX*2
+#DEFINE IVT(INTX) HB_IVT + (INTX * 4) + 1
+#DEFINE VEC(INTX) INTX * 2
 
 ;
 ; SET DEFAULT CSIO SPEED (INTERNAL CLOCK, SLOW AS POSSIBLE)

Source/Images/Common/All/u10/FLASH.DOC

@@ -1,206 +1,207 @@
-
-        FLASH4 (c) 2014-2020 William R Sowerbutts <will@sowerbutts.com>
-                          http://sowerbutts.com/8bit/
-
-= Supported machines =
-
-FLASH4 has been tested and confirmed working on:
- * N8VEM SBCv2
- * N8VEM SBCv2 MegaFlash
- * N8VEM N8-2312
- * N8VEM Mark IV SBC
- * DX-Designs P112
- * ZETA SBC v1
- * ZETA SBC v2
- * RC2014 with 512KB ROM 512KB RAM module
-
-It should work on many other machines that run RomWBW or UNA BIOS.  If you test
-it on another machine please let me know the outcome.
-
-FLASH030 (also included) is a Linux version of the same software. It is
-targetted at my 68030 machine but should be very easy to port to other
-machines. It expects a machine with a larger address space, and thus omits much
-of the bank switching and other tricks required on Z80 platforms.
-
-
-= Introduction =
-
-FLASH4 is a CP/M program which can read, write and verify Flash ROM contents to
-or from an image file stored on a CP/M filesystem. It is intended for in-system
-programming of Flash ROM chips on Z80 and Z180 systems.
-
-FLASH4 aims to support a range of Flash ROM chips and machines. Ideally I would
-like to support all Z80/Z180 machines. If FLASH4 does not support your machine
-please let me know and I will try to add support.
-
-When writing to the Flash ROM, FLASH4 will only reprogram the sectors whose
-contents have changed. This helps to reduce wear on the flash memory, makes the
-reprogram operation faster, and reduces the risk of leaving the system
-unbootable if power fails during a reprogramming operation. FLASH4 always
-performs a full verify operation after writing to the chip to confirm that the
-correct data has been loaded.
-
-FLASH4 is reasonably fast. Reprogramming and verifying every sector on a 512KB
-SST 39F040 chip takes 21 seconds on my Mark IV SBC, versus 45 seconds to
-perform the same task using a USB MiniPro TL866 EEPROM programmer under Linux
-on my PC. If only a subset of sectors require reprogramming FLASH4 will be
-even faster.
-
-FLASH4 works with binary ROM image files, it does not support Intel Hex format
-files. Hex files can be easily converted to or from binaries using "hex2bin" or
-the "srec_cat" program from SRecord:
-
-  $ srec_cat image.hex -intel -fill 0xFF 0 0x80000 -output image.bin -binary
-  $ srec_cat image.bin -binary -output image.hex -intel
-
-FLASH4 version 1.3 introduces support for programming multiple flash chips.
-Some machines use multiple flash chips for larger ROM capacity, for example the
-"Megaflash" version of the Retrobrew Computers SBC-V2 contains two 512KB flash
-ROMs for a total of 1MB ROM. All flash chips in the system must be of the same
-type.
-
-FLASH4 can use several different methods to access the Flash ROM chips. The
-best available method is determined automatically at run time. Alternatively
-you may provide a command-line option to force the use of a specific method.
-
-FLASH4 will detect the presence of RomWBW, UNA BIOS or P112 B/P BIOS and use
-the bank switching methods they provide to map in the flash memory.
-
-If no bank switching method can be auto-detected, and the system has a Z180
-CPU, FLASH4 will use the Z180 DMA engine to access the Flash ROM chip. This
-does not require any bank switching but it is slower and will not work on all
-platforms. 
-
-Z180 DMA access requires the flash ROM to be linearly mapped into the lower
-region of physical memory, as it is on the Mark IV SBC (for example). The
-N8-2312 has additional memory mapping hardware, consequently Z180 DMA access on
-the N8-2312 is NOT SUPPORTED and if forced will corrupt the contents of RAM;
-use one of the supported bank switching methods instead.
-
-Z180 DMA access requires the Z180 CPU I/O base control register configured to
-locate the internal I/O addresses at 0x40 (ie ICR bits IOA7, IOA6 = 0, 1).
-
-
-= Usage =
-
-The three basic operations are:
-
-  FLASH4 WRITE filename [options]
-
-  FLASH4 VERIFY filename [options]
-
-  FLASH4 READ filename [options]
-
-The WRITE command will rewrite the flash ROM contents from the named file. The
-file size must exactly match the size of the ROM chip. After the WRITE
-operation, a VERIFY operation will be performed automatically.
-
-The VERIFY command will read out the flash ROM contents and report if it
-matches the contents of the named file. The file size must exactly match the
-size of the ROM chip.
-
-The READ command will read out the entire flash ROM contents and write it to
-the named file.
-
-FLASH4 will auto-detect most parameters so additional options should not
-normally be required.
-
-The "/V" (verbose) option makes FLASH4 print one line per sector, giving a
-detailed log of what it did.
-
-The "/P" or "/PARTIAL" option can be used if your ROM chip is larger than the
-image you wish to write and you only want to reprogram part of it. To avoid
-accidentally flashing the wrong file, the image file must be an exact multiple
-of 32KB in length. The portion of the ROM not occupied by the image file is
-left either unmodified or erased.
-
-The "/ROM" option can be used when you are using an ROM/EPROM/EEPROM chip which
-cannot be programmed in-system and FLASH4 cannot recognise it.  Only the "READ"
-and "VERIFY" commands are supported with this option.  This mode assumes a 512K
-ROM is fitted, smaller ROMs will be treated as a 512KB ROM with the data
-repeated multiple times.
-
-One of the following optional command line arguments may be specified at the
-end of the command line to force FLASH4 to use a particular method to access
-the flash ROM chip:
-
-BIOS interfaces:
-  /ROMWBW         For ROMWBW BIOS version 2.6 and later
-  /ROMWBWOLD      For ROMWBW BIOS version 2.5 and earlier
-  /UNABIOS        For UNA BIOS
-
-Direct hardware interfaces:
-  /Z180DMA        For Z180 DMA
-  /P112           For DX-Designs P112
-  /N8VEMSBC       For N8VEM SBC (v1, v2), Zeta (v1) SBC
-
-If no option is specified FLASH4 attempts to determine the best available
-method automatically.
-
-If RomWBW 2.6+ is in use, and correctly configured, then multiple flash chips
-can be detected automatically. Multiple chip operation can also be manually
-enabled using the command line options "/1", "/2", "/3" etc up to "/9" to
-specify the number of flash chips to program. All flash chips in the system
-must be of the same type.
-
-
-= Supported flash memory chips =
-
-FLASH4 will interrogate your flash ROM chip to identify it automatically.
-
-FLASH4 does not support setting or resetting the protection bits on individual
-sectors within Flash ROM devices. If your Flash ROM chip has protected sectors
-you will need to unprotect them by other means before FLASH4 can erase and
-reprogram them.
-
-AT29C series chips employ an optional "software data protection" feature. This
-is supported by FLASH4 and is left activated after programming the chip to
-prevent accidental reprogramming of sectors.
-
-The following chips are fully supported and will be programmed sector by
-sector:
-
-  AMIC A29010B
-  AMIC A29040B
-  Atmel AT29C010
-  Atmel AT29C020
-  Atmel AT29C040
-  Atmel AT29C512
-  Atmel AT29F010
-  Atmel AT29F040
-  Macronix MX29F040
-  SST 39F010
-  SST 39F020
-  SST 39F040
-  SST M29F010
-  SST M29F040
-
-The following chips are supported, but have unequal sector sizes, so FLASH4
-will only erase and reprogram the entire chip at once:
-
-  Atmel AT49F001N
-  Atmel AT49F001NT
-  Atmel AT49F002N
-  Atmel AT49F002NT
-  Atmel AT49F040
-
-
-= Compiling =
-
-The software is written in a mix of C and assembler. It builds using the SDCC
-toolchain and the SRecord tools. SDCC 3.6 and 3.8 have been tested. A Makefile
-is provided to build the executable in Linux and I imagine it can be easily
-modified to build in Windows.
-
-You may need to adjust the path to the SDCC libraries in the Makefile if your
-installation is not in /usr/local or /usr
-
-
-= License =
-
-FLASH4 is licensed under the The GNU General Public License version 3 (see
-included "LICENSE.txt" file). 
-
-FLASH4 is provided with NO WARRANTY. In no event will the author be liable for
-any damages. Use of this program is at your own risk. May cause rifts in space
-and time.
+
+        FLASH4 (c) 2014-2020 William R Sowerbutts <will@sowerbutts.com>
+                          http://sowerbutts.com/8bit/
+
+= Supported machines =
+
+FLASH4 has been tested and confirmed working on:
+ * N8VEM SBCv2
+ * N8VEM SBCv2 MegaFlash
+ * N8VEM N8-2312
+ * N8VEM Mark IV SBC
+ * DX-Designs P112
+ * ZETA SBC v1
+ * ZETA SBC v2
+ * RC2014 with 512KB ROM 512KB RAM module
+
+It should work on many other machines that run RomWBW or UNA BIOS.  If you test
+it on another machine please let me know the outcome.
+
+FLASH030 (also included) is a Linux version of the same software. It is
+targetted at my 68030 machine but should be very easy to port to other
+machines. It expects a machine with a larger address space, and thus omits much
+of the bank switching and other tricks required on Z80 platforms.
+
+
+= Introduction =
+
+FLASH4 is a CP/M program which can read, write and verify Flash ROM contents to
+or from an image file stored on a CP/M filesystem. It is intended for in-system
+programming of Flash ROM chips on Z80 and Z180 systems.
+
+FLASH4 aims to support a range of Flash ROM chips and machines. Ideally I would
+like to support all Z80/Z180 machines. If FLASH4 does not support your machine
+please let me know and I will try to add support.
+
+When writing to the Flash ROM, FLASH4 will only reprogram the sectors whose
+contents have changed. This helps to reduce wear on the flash memory, makes the
+reprogram operation faster, and reduces the risk of leaving the system
+unbootable if power fails during a reprogramming operation. FLASH4 always
+performs a full verify operation after writing to the chip to confirm that the
+correct data has been loaded.
+
+FLASH4 is reasonably fast. Reprogramming and verifying every sector on a 512KB
+SST 39F040 chip takes 21 seconds on my Mark IV SBC, versus 45 seconds to
+perform the same task using a USB MiniPro TL866 EEPROM programmer under Linux
+on my PC. If only a subset of sectors require reprogramming FLASH4 will be
+even faster.
+
+FLASH4 works with binary ROM image files, it does not support Intel Hex format
+files. Hex files can be easily converted to or from binaries using "hex2bin" or
+the "srec_cat" program from SRecord:
+
+  $ srec_cat image.hex -intel -fill 0xFF 0 0x80000 -output image.bin -binary
+  $ srec_cat image.bin -binary -output image.hex -intel
+
+FLASH4 version 1.3 introduces support for programming multiple flash chips.
+Some machines use multiple flash chips for larger ROM capacity, for example the
+"Megaflash" version of the Retrobrew Computers SBC-V2 contains two 512KB flash
+ROMs for a total of 1MB ROM. All flash chips in the system must be of the same
+type.
+
+FLASH4 can use several different methods to access the Flash ROM chips. The
+best available method is determined automatically at run time. Alternatively
+you may provide a command-line option to force the use of a specific method.
+
+FLASH4 will detect the presence of RomWBW, UNA BIOS or P112 B/P BIOS and use
+the bank switching methods they provide to map in the flash memory.
+
+If no bank switching method can be auto-detected, and the system has a Z180
+CPU, FLASH4 will use the Z180 DMA engine to access the Flash ROM chip. This
+does not require any bank switching but it is slower and will not work on all
+platforms. 
+
+Z180 DMA access requires the flash ROM to be linearly mapped into the lower
+region of physical memory, as it is on the Mark IV SBC (for example). The
+N8-2312 has additional memory mapping hardware, consequently Z180 DMA access on
+the N8-2312 is NOT SUPPORTED and if forced will corrupt the contents of RAM;
+use one of the supported bank switching methods instead.
+
+Z180 DMA access requires the Z180 CPU I/O base control register configured to
+locate the internal I/O addresses at 0x40 (ie ICR bits IOA7, IOA6 = 0, 1).
+
+
+= Usage =
+
+The three basic operations are:
+
+  FLASH4 WRITE filename [options]
+
+  FLASH4 VERIFY filename [options]
+
+  FLASH4 READ filename [options]
+
+The WRITE command will rewrite the flash ROM contents from the named file. The
+file size must exactly match the size of the ROM chip. After the WRITE
+operation, a VERIFY operation will be performed automatically.
+
+The VERIFY command will read out the flash ROM contents and report if it
+matches the contents of the named file. The file size must exactly match the
+size of the ROM chip.
+
+The READ command will read out the entire flash ROM contents and write it to
+the named file.
+
+FLASH4 will auto-detect most parameters so additional options should not
+normally be required.
+
+The "/V" (verbose) option makes FLASH4 print one line per sector, giving a
+detailed log of what it did.
+
+The "/P" or "/PARTIAL" option can be used if your ROM chip is larger than the
+image you wish to write and you only want to reprogram part of it. To avoid
+accidentally flashing the wrong file, the image file must be an exact multiple
+of 32KB in length. The portion of the ROM not occupied by the image file is
+left either unmodified or erased.
+
+The "/ROM" option can be used when you are using an ROM/EPROM/EEPROM chip which
+cannot be programmed in-system and FLASH4 cannot recognise it.  Only the "READ"
+and "VERIFY" commands are supported with this option.  This mode assumes a 512K
+ROM is fitted, smaller ROMs will be treated as a 512KB ROM with the data
+repeated multiple times.
+
+One of the following optional command line arguments may be specified at the
+end of the command line to force FLASH4 to use a particular method to access
+the flash ROM chip:
+
+BIOS interfaces:
+  /ROMWBW         For ROMWBW BIOS version 2.6 and later
+  /ROMWBWOLD      For ROMWBW BIOS version 2.5 and earlier
+  /UNABIOS        For UNA BIOS
+
+Direct hardware interfaces:
+  /Z180DMA        For Z180 DMA
+  /P112           For DX-Designs P112
+  /N8VEMSBC       For N8VEM SBC (v1, v2), Zeta (v1) SBC
+
+If no option is specified FLASH4 attempts to determine the best available
+method automatically.
+
+If RomWBW 2.6+ is in use, and correctly configured, then multiple flash chips
+can be detected automatically. Multiple chip operation can also be manually
+enabled using the command line options "/1", "/2", "/3" etc up to "/9" to
+specify the number of flash chips to program. All flash chips in the system
+must be of the same type.
+
+
+= Supported flash memory chips =
+
+FLASH4 will interrogate your flash ROM chip to identify it automatically.
+
+FLASH4 does not support setting or resetting the protection bits on individual
+sectors within Flash ROM devices. If your Flash ROM chip has protected sectors
+you will need to unprotect them by other means before FLASH4 can erase and
+reprogram them.
+
+AT29C series chips employ an optional "software data protection" feature. This
+is supported by FLASH4 and is left activated after programming the chip to
+prevent accidental reprogramming of sectors.
+
+The following chips are fully supported and will be programmed sector by
+sector:
+
+  AMIC A29010B
+  AMIC A29040B
+  Atmel AT29C010
+  Atmel AT29C020
+  Atmel AT29C040
+  Atmel AT29C512
+  Atmel AT29F010
+  Atmel AT29F040
+  Macronix MX29F040
+  SST 39F010
+  SST 39F020
+  SST 39F040
+  SST M29F010
+  SST M29F040
+
+The following chips are supported, but have unequal sector sizes, so FLASH4
+will only erase and reprogram the entire chip at once:
+
+  Atmel AT49F001N
+  Atmel AT49F001NT
+  Atmel AT49F002N
+  Atmel AT49F002NT
+  Atmel AT49F040
+
+
+= Compiling =
+
+The software is written in a mix of C and assembler. It builds using the SDCC
+toolchain and the SRecord tools. SDCC 3.6 and 3.8 have been tested. A Makefile
+is provided to build the executable in Linux and I imagine it can be easily
+modified to build in Windows.
+
+You may need to adjust the path to the SDCC libraries in the Makefile if your
+installation is not in /usr/local or /usr
+
+
+= License =
+
+FLASH4 is licensed under the The GNU General Public License version 3 (see
+included "LICENSE.txt" file). 
+
+FLASH4 is provided with NO WARRANTY. In no event will the author be liable for
+any damages. Use of this program is at your own risk. May cause rifts in space
+and time.
+

Source/Images/d_hitechc/Readme.txt

@@ -1,20 +1,20 @@
 ===== HI-TECH Z80 CP/M C compiler V3.09-17 =====
 
-The HI-TECH C Compiler  is  a  set  of  software  which
+The HI-TECH C Compiler is a set of software  which
 translates  programs written in the C language to executable
 machine code programs. Versions are available which  compile
 programs  for  operation under the host operating system, or
 which produce programs for  execution  in  embedded  systems
 without an operating system.
 
-This is the Mar 21, 2023 update 17 released by Tony Nicholson who currently
-maintains HI-TECH C at https://github.com/agn453/HI-TECH-Z80-C
+This is the Jun 2, 2025 update 19 released by Tony Nicholson who currently
+maintains HI-TECH C at https://github.com/agn453/HI-TECH-Z80-C.
 
 The manual is available in the Doc/Language directory,
 HI-TECH Z80 C Compiler Manual.txt
 
 A good blog post about the HI-TECH C Compiler is available at
-https://techtinkering.com/2008/10/22/installing-the-hi-tech-z80-c-compiler-for-cpm/
+https://techtinkering.com/2008/10/22/installing-the-hi-tech-z80-c-compiler-for-cpm/.
 
 == License ==
 
@@ -24,3 +24,24 @@ support is offered or implied.
 
 You may use this software for whatever you like, providing you acknowledge
 that the copyright to this software remains with HI-TECH Software.
+
+== Enhanced Version ==
+
+User area 1 contains another complete copy of the HI-TECH C Compiler.
+It is identical to the copy in user area 0 except for the following files
+which were enhanced by Ladislau Szilagyi from his GitHub Repository at
+https://github.com/Laci1953/HiTech-C-compiler-enhanced.  The files
+take advantage of additional banked memory using the RomWBW HBIOS API.
+As such, they require RomWBW to operate.  They should be compatible with
+all CP/M and compatible operations systems provided in RomWBW.
+
+The enhanced files are:
+
+- CGEN.COM
+- CPP.COM
+- OPTIM.COM
+- P1.COM
+- ZAS.COM (replaced with Z80AS)
+
+A thread discussing this enhanced version of HI-TECH C is found at
+https://groups.google.com/g/rc2014-z80/c/sBCCIpOnnGg.

Source/Images/d_hitechc/u0/STDIO.H

@@ -2,8 +2,17 @@
 #define _HTC_STDIO_H
 
 /*
- * STDIO.H	Modified version from Tesseract vol 91
+ * STDIO.H	HI-TECH C standard I/O for V3.09-xx
+ *
+ *		This version incorporates changes to stdio routines
+ *		resulting from backporting features from V4.11
  */
+
+#define _HTC_VERSION	"3.09-19"
+#define _HTC_MAJOR	3
+#define _HTC_MINOR	9
+#define _HTC_REV	19
+
 #if	z80
 #define	BUFSIZ		512
 #define	_NFILE		8
@@ -12,18 +21,27 @@
 #define	_NFILE		20
 #endif	z80
 
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;
+typedef	unsigned	size_t;
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
 #ifndef FILE
-#define	uchar	unsigned char
+#define	uchar		unsigned char
 
 extern	struct	_iobuf
 {
-    char		*_ptr;
-    int			 _cnt;
-    char		*_base;
-    unsigned short	 _flag;
-    char		 _file;
+	char		*_ptr;
+	int		 _cnt;
+	char		*_base;
+	unsigned short	 _flag;
+	char		 _file;
+	size_t		 _size;
 } _iob[_NFILE];
 
+#define	FILE		struct _iobuf
 #endif	FILE
 
 #ifndef SEEK_SET
@@ -32,25 +50,26 @@ extern	struct	_iobuf
 #define SEEK_END 2
 #endif
 
-#define	_IOREAD		01
-#define	_IOWRT		02
-#define	_IORW		03
-#define	_IONBF		04
-#define	_IOMYBUF	010
-#define	_IOEOF		020
-#define	_IOERR		040
-#define	_IOSTRG		0100
-#define	_IOBINARY	0200
-                                /* New flags */
-#define	_IODIRN		01000	/* Set if writing to a R/W file */
-#define _IOAPPEND	02000	/* Set if in append mode */
-#define _IOWROTE 	04000	/* Write occurred since last seek */
+/* I/O status flag word bits */
+#define	_IOREAD		01	/* Allow file reading */
+#define	_IOWRT		02	/* Allow file writing */
+#define	_IORW		03	/* Mask for reading or writing */
+#define	_IONBF		04	/* Not being buffered */
+#define	_IOMYBUF	010	/* Using buffer */
+#define	_IOEOF		020	/* At end-of-file */
+#define	_IOERR		040	/* An I/O error has occurred */
+#define	_IOSTRG		0100	/* End of string reached */
+#define	_IOBINARY	0200	/* Binary mode */
+#define	_IOLBF		0400	/* Using line buffering */
+#define	_IODIRN		01000	/* Direction - writing to a R/W file */
+#define _IOAPPEND	02000	/* Append mode */
+#define _IOSEEKED	04000	/* A seek has occurred since last write */
+#define	_IOFBF		010000	/* Using full buffering */
 
 #ifndef	NULL
 #define	NULL	((void *)0)
 #endif	NULL
 
-#define	FILE		struct _iobuf
 #define	EOF		(-1)
 
 #define	stdin		(&_iob[0])
@@ -79,9 +98,6 @@ extern	struct	_iobuf
 #define	clrerr(p)	p->_flag &= ~_IOERR
 #define	clreof(p)	p->_flag &= ~_IOEOF
 
-#define	L_tmpnam	34		        /* max length of temporary names */
-#define	L_TMPNAM	(L_tmpnam)		/* max length of temporary names */
-
 extern int	 fclose(FILE *);
 extern int	 fflush(FILE *);
 extern int	 fgetc(FILE *);
@@ -96,7 +112,8 @@ extern int	 fread(void *, unsigned, unsigned, FILE *);
 extern int	 fwrite(void *, unsigned, unsigned, FILE *);
 extern int	 fseek(FILE *, long, int);
 extern int	 rewind(FILE *);
-extern int	 setbuf(FILE *, char *);
+extern void	 setbuf(FILE *, char *);
+extern int	 setvbuf(FILE *, char *, int, size_t);
 extern int	 printf(char *, ...);
 extern int	 fprintf(FILE *, char *, ...);
 extern int	 sprintf(char *, char *, ...);
@@ -111,5 +128,5 @@ extern long	 ftell(FILE *);
 extern char	*fgets(char *, int, FILE *);
 extern char	*_bufallo(void);
 
-#endif
-
+#endif _HTC_STDIO_H
+

Source/Images/d_hitechc/u0/SYS.H

@@ -34,6 +34,7 @@ extern char   **_getargs(char *, char *);
 extern int	_argc_;
 extern int	inp(int);
 extern void	outp(int, int);
+extern void *	sbrk(size_t);
 
 #endif
-
+

Source/Images/d_hitechc/u1/ASSERT.H

@@ -0,0 +1,23 @@
+#ifndef _HTC_ASSERT_H
+#define _HTC_ASSERT_H
+
+/*
+ *	Assertion - use liberally for debugging. Defining NDEBUG
+ *	turns assertions off.
+ *	assert(exp) where exp is non-zero does nothing, while
+ *	assert(exp) where exp evaluates to zero aborts the program
+ *	with a message like
+ *
+ *	Assertion failed: prog.c line 123: "exp"
+ *
+ */
+
+#ifndef	NDEBUG
+extern void	_fassert(int, char *, char *);
+#define	assert(exp)	if(!(exp)) {_fassert(__LINE__, __FILE__, "exp");}
+#else
+#define	assert(exp)
+#endif
+
+#endif
+

Source/Images/d_hitechc/u1/CONIO.H

@@ -0,0 +1,30 @@
+#ifndef _HTC_CONIO_H
+#define _HTC_CONIO_H
+
+/*
+ *	Low-level console I/O functions
+ */
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+
+extern char	getch(void);
+extern char	getche(void);
+extern void	putch(int);
+extern void	ungetch(int);
+extern int	kbhit(void);
+extern char *	cgets(char *);
+extern void	cputs(char *);
+
+#endif
+

Source/Images/d_hitechc/u1/CPM.H

@@ -0,0 +1,215 @@
+#ifndef _HTC_CPM_H
+#define _HTC_CPM_H
+
+/* Header file for CP/M routines for Z-80 C */
+
+/* get basic definitions */
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+#define	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+#endif	_STDDEF
+
+/*	hitech.h has definitions for uchar, ushort etc */
+
+#include	<hitech.h>
+#if	z80
+#define	MAXFILE		8	/* max number of files open */
+#else	z80
+#define	MAXFILE		15	/* max number of files open */
+#endif	z80
+#define	SECSIZE		128	/* no. of bytes per sector */
+
+extern struct	fcb
+{
+    uchar	dr;		/*  0: drive code */
+    char	name[8];	/*  1: file name */
+    char	ft[3];		/*  9: file type */
+    uchar	ex;		/* 12: file extent */
+    char	fil[2];		/* 13: not used */
+    char	rc;		/* 15: number of records in present extent */
+    char	dm[16];		/* 16: CP/M disk map */
+    char	nr;		/* 32: next record to read or write */
+    uchar	ranrec[3];	/* 35: random record number (24 bit no.) */
+    long	rwp;		/* 38: read/write pointer in bytes */
+    uchar	use;		/* 42: use flag */
+    uchar	uid;		/* 43: user id belonging to this file */
+    long	fsize;		/* 44: file length in bytes */
+}  _fcb[MAXFILE];
+
+extern short	   bdos(int, ...);
+#define bdoshl	   bdos
+#define bdose	   bdos
+extern struct fcb* getfcb(void);
+extern char *      fcbname(short i);
+extern short	   getuid(void);
+extern short	   setuid(short);
+extern uchar	   setfcb(struct fcb *, char *);
+extern char	*  (*_passwd)(struct fcb *);
+extern short	   bios(short fn, ...);
+#define bios3 bios
+
+/*   flag values in fcb use */
+
+#define	U_READ	1		/* file open for reading */
+#define	U_WRITE	2		/* file open for writing */
+#define	U_RDWR	3		/* open for read and write */
+#define	U_CON	4		/* device is console */
+#define	U_RDR	5		/* device is reader */
+#define	U_PUN	6		/* device is punch */
+#define	U_LST	7		/* list device */
+#define U_RSX   8               /* PIPEMGR RSX */
+#define U_ERR   9               /* PIPEMGR stderr channel */
+
+/*	special character values */
+
+#define	CPMETX	032		/* ctrl-Z, CP/M end of file for text */
+#define	CPMRBT	003		/* ctrl-C, reboot CPM */
+
+/*	operating systems	*/
+
+#define	MPM	0x100		/* bit to test for MP/M */
+#define	CCPM	0x400		/* bit to test for CCP/M */
+
+#define	ISMPM()	(bdoshl(CPMVERS)&MPM)	/* macro to test for MPM */
+
+/*	 what to do after you hit return */
+
+#define	EXIT	(*(int (*)())0)	/* where to go to reboot CP/M */
+
+/*	 BDOS calls etc. */
+
+#define	CPMRCON   1		/* read console */
+#define	CPMWCON   2		/* write console */
+#define	CPMRRDR   3		/* read reader */
+#define	CPMWPUN   4		/* write punch */
+#define	CPMWLST   5		/* write list */
+#define	CPMDCIO   6		/* direct console I/O */
+#define	CPMGIOB   7		/* get I/O byte */
+#define	CPMSIOB   8		/* set I/O byte */
+#define	CPMWCOB	  9		/* write console buffered */
+#define	CPMRCOB  10		/* read console buffered */
+#define	CPMICON	 11		/* interrogate console ready */
+#define	CPMVERS  12		/* return version number */
+#define	CPMRDS   13		/* reset disk system */
+#define	CPMLGIN	 14		/* log in and select disk */
+#define	CPMOPN	 15		/* open file */
+#define	CPMCLS	 16		/* close file */
+#define	CPMFFST	 17		/* find first */
+#define	CPMFNXT	 18		/* find next */
+#define	CPMDEL	 19		/* delete file */
+#define	CPMREAD	 20		/* read next record */
+#define	CPMWRIT	 21		/* write next record */
+#define	CPMMAKE	 22		/* create file */
+#define	CPMREN	 23		/* rename file */
+#define	CPMILOG	 24		/* get bit map of logged in disks */
+#define	CPMIDRV	 25		/* interrogate drive number */
+#define	CPMSDMA	 26		/* set DMA address for i/o */
+#define CPMGALL  27		/* get allocation vector address */
+#define CPMWPRD  28		/* write protect disk */
+#define CPMGROV  29		/* get read-only vector */
+#define CPMSATT  30		/* set file attributes */
+#define CPMDPB	 31		/* get disk parameter block */
+#define	CPMSUID	 32		/* set/get user id */
+#define	CPMRRAN	 33		/* read random record */
+#define	CPMWRAN	 34		/* write random record */
+#define	CPMCFS	 35		/* compute file size */
+#define CPMSRAN  36		/* set random record */
+#define CPMRDRV  37		/* reset drive */
+#define CPMACDV  38		/* MP/M access drive */
+#define CPMFRDV  39		/* MP/M free drive */
+#define CPMWRZF  40		/* write random with zero fill */
+#define CPMTWR   41		/* MP/M test and write record */
+#define CPMLOKR  42		/* MP/M lock record */
+#define CPMUNLR  43		/* MP/M unlock record */
+#define CPMSMSC  44		/* CP/M+ set multi-sector count */
+#define CPMERRM  45		/* CP/M+ set BDOS error mode */
+#define CPMDFS   46		/* CP/M+ get disk free space */
+#define CPMCHN   47		/* CP/M+ chain to program */
+#define CPMFLSH  48		/* CP/M+ flush buffers */
+#define CPMGZSD  48		/* ZSDOS get ZSDOS/ZDDOS version */
+#define CPMSCB	 49		/* access CP/M+ system control block */
+#define CPMBIOS  50		/* CP/M+ direct BIOS call */
+#define	CPMDSEG	 51		/* set DMA segment */
+#define CPMGFTM  54		/* Z80DOS/ZPM3 get file time-stamp */
+#define CPMSFTM  55		/* Z80DOS/ZPM3 set file time-stamp */
+#define CPMLDOV  59		/* CP/M+ Load Overlay - requires LOADER RSX */
+#define CPMRSX	 60		/* CP/M+ call RSX */
+#define CPMLGI   64		/* CP/Net login */
+#define CPMLGO   65		/* CP/Net logout */
+#define CPMSMSG  66		/* CP/Net send message */
+#define CPMRMSG  67		/* CP/Net receive message */
+#define CPMNETS  68		/* CP/Net get network status */
+#define CPMGCFT  69		/* CP/Net get configuration table address */
+#define CPMSCAT  70		/* CP/Net set compatibility attributes */
+#define CPMGSVC  71		/* CP/Net get server configuration */
+#define CPMFRBL  98		/* CP/M+ free blocks */
+#define CPMTRNC  99		/* CP/M+ truncate file */
+#define CPMSLBL 100		/* CP/M+ set directory label */
+#define CPMDLD  101		/* CP/M+ get directory label data */
+#define CPMGFTS 102		/* CP/M+ get file timestamp and password mode */
+#define CPMWXFC 103		/* CP/M+ write file XFCB */
+#define CPMSDAT 104		/* CP/M+ set date and time */
+#define CPMGDAT 105		/* CP/M+ get date and time */
+#define CPMSPWD 106		/* CP/M+ set default password */
+#define CPMGSER 107		/* CP/M+ get serial number */
+#define CPMRCOD 108		/* CP/M+ get/set return code */
+#define CPMCMOD 109		/* CP/M+ get/set console mode */
+#define CPMODEL 110		/* CP/M+ get/set output delimiter */
+#define CPMPBLK 111		/* CP/M+ print block */
+#define CPMLBLK 112		/* CP/M+ list block */
+#define CPMPARS 152		/* CP/M+ parse filename */
+
+/* CP/M BIOS functions.  Numbers above 16 pertain to CP/M 3 only.  */
+
+enum BIOSfns
+{
+    _BOOT	=  0,
+    _WBOOT	=  1,
+
+    _CONST	=  2,
+    _CONIN	=  3,
+    _CONOUT	=  4,
+    _LIST	=  5,
+    _PUNOUT	=  6,	/* CP/M 2.2 name */
+    _AUXOUT	=  6,	/* CP/M 3.1 name */
+    _RDRIN	=  7,	/* CP/M 2.2 name */
+    _AUXIN	=  7,	/* CP/M 3.1 name */
+    _LISTST	= 15,
+    _CONOST	= 17,
+    _AUXIST	= 18,
+    _AUXOST	= 19,
+
+    _DEVTBL	= 20,
+    _DEVINI	= 21,
+    _DRVTBL	= 22,
+
+    _HOME	=  8,
+    _SELDSK	=  9,
+    _SETTRK	= 10,
+    _SETSEC	= 11,
+    _SETDMA	= 12,
+    _READ	= 13,
+    _WRITE	= 14,
+    _SECTRN	= 16,
+    _MULTIO	= 23,
+    _FLUSH	= 24,
+
+    _MOVE	= 25,
+    _SELMEM	= 27,
+    _SETBNK	= 28,
+    _XMOVE	= 29,
+
+    _TIME	= 26,
+    _USERF	= 30
+};
+
+#endif
+

Source/Images/d_hitechc/u1/CTYPE.H

@@ -0,0 +1,41 @@
+#ifndef _HTC_CTYPE_H
+#define _HTC_CTYPE_H
+
+#define	_U	0x01
+#define	_L	0x02
+#define	_N	0x04
+#define	_S	0x08
+#define _P	0x10
+#define _C	0x20
+#define	_X	0x40
+
+extern	unsigned char	_ctype_[];	/* in libc.lib */
+
+#define	isalpha(c)	((_ctype_+1)[c]&(_U|_L))
+#define	isupper(c)	((_ctype_+1)[c]&_U)
+#define	islower(c)	((_ctype_+1)[c]&_L)
+#define	isdigit(c)	((_ctype_+1)[c]&_N)
+#define	isxdigit(c)	((_ctype_+1)[c]&(_N|_X))
+#define	isspace(c)	((_ctype_+1)[c]&_S)
+#define ispunct(c)	((_ctype_+1)[c]&_P)
+#define isalnum(c)	((_ctype_+1)[c]&(_U|_L|_N))
+#define isprint(c)	((_ctype_+1)[c]&(_P|_U|_L|_N|_S))
+#define isgraph(c)	((_ctype_+1)[c]&(_P|_U|_L|_N))
+#define iscntrl(c)	((_ctype_+1)[c]&_C)
+#define isascii(c)	(!((c)&0xFF80))
+/*--------------------------------------*\
+ |    Changed  2014-07-04 (Jon Saxton)	|
+ |--------------------------------------|
+ |	Original macro definitions	|
+ | #define toupper(c)	((c)-'a'+'A')	|
+ | #define tolower(c)	((c)-'A'+'a')	|
+ |--------------------------------------|
+ |	  Use functions instead		|
+\*--------------------------------------*/
+extern int toupper(int);	/* in LIBC.LIB */
+extern int tolower(int);	/* in LIBC.LIB */
+
+#define toascii(c)	((c)&0x7F)
+
+#endif
+

Source/Images/d_hitechc/u1/EXEC.H

@@ -0,0 +1,22 @@
+#ifndef _HTC_EXEC_H
+#define _HTC_EXEC_H
+
+/*
+ *	Definitions of the EXEC format
+ */
+
+#define	EXITIT	0x80
+#define	EXEC	0x81
+#define	IGN_ERR	0x82
+#define	DEF_ERR	0x83
+#define	SKP_ERR	0x84
+#define	TRAP	0x85
+#define	IF_ERR	0x86
+#define	IF_NERR	0x87
+#define	ECHO	0x88
+#define	PRINT	0x89
+#define	RM_FILE	0x8A
+#define	RM_EXIT	0x8B
+
+#endif
+

Source/Images/d_hitechc/u1/FLOAT.H

@@ -0,0 +1,73 @@
+#ifndef _HTC_FLOAT_H
+#define _HTC_FLOAT_H
+
+/*	Characteristics of floating types */
+
+#define	DBL_RADIX	2		/* radix of exponent for a double */
+#define	DBL_ROUNDS	1		/* doubles round when converted to int */
+#define	FLT_RADIX	2		/* radix of float exponent */
+#define	FLT_ROUNDS	1		/* float also rounds to int */
+
+#if	z80
+#define	FLT_MANT_DIG	24		/* 24 bits in mantissa */
+#define	DBL_MANT_DIG	24		/* ditto for double */
+#define	DBL_MANT_DIG	24		/* ditto long double */
+#define	FLT_EPSILON	-1.192093	/* smallest x, x+1.0 != 1.0 */
+#define	DBL_EPSILON	-1.192093	/* smallest x, x+1.0 != 1.0 */
+#define	FLT_DIG		6		/* decimal significant digs */
+#define	DBL_DIG		6
+#define	FLT_MIN_EXP	-62		/* min binary exponent */
+#define	DBL_MIN_EXP	-62
+#define	FLT_MIN		1.084202e-19	/* smallest floating number */
+#define	DBL_MIN		1.084202e-19
+#define	FLT_MIN_10_EXP	-18
+#define	DBL_MIN_10_EXP	-18
+#define	FLT_MAX_EXP	64		/* max binary exponent */
+#define	DBL_MAX_EXP	64
+#define	FLT_MAX		1.84467e19	/* max floating number */
+#define	DBL_MAX		1.84467e19
+#define	FLT_MAX_10_EXP	19		/* max decimal exponent */
+#define	DBL_MAX_10_EXP	19
+#endif	z80
+
+#if	i8086 || m68k
+
+/*	The 8086 and 68000 use IEEE 32 and 64 bit floats */
+
+#define	FLT_RADIX	2
+#define	FLT_MANT_DIG	24
+#define	FLT_EPSILON	1.19209290e-07
+#define	FLT_DIG		6
+#define	FLT_MIN_EXP	-125
+#define	FLT_MIN		1.17549435e-38
+#define	FLT_MIN_10_EXP	-37
+#define	FLT_MAX_EXP	128
+#define	FLT_MAX		3.40282347e+38
+#define	FLT_MAX_10_EXP	38
+#define	DBL_MANT_DIG	53
+#define	DBL_EPSILON	2.2204460492503131e-16
+#define	DBL_DIG		15
+#define	DBL_MIN_EXP	-1021
+#define	DBL_MIN		2.225073858507201e-308
+#define	DBL_MIN_10_EXP	-307
+#define	DBL_MAX_EXP	1024
+#define	DBL_MAX		1.797693134862316e+308
+#define	DBL_MAX_10_EXP	308
+#endif	i8086 || m68k
+
+
+/*	long double equates to double */
+
+
+#define	LDBL_MANT_DIG	DBL_MANT_DIG
+#define	LDBL_EPSILON	DBL_EPSILON
+#define	LDBL_DIG	DBL_DIG
+#define	LDBL_MIN_EXP	DBL_MIN_EXP
+#define	LDBL_MIN	DBL_MIN
+#define	LDBL_MIN_10_EXP	DBL_MIN_10_EXP
+#define	LDBL_MAX_EXP	DBL_MAX_EXP
+#define	LDBL_MAX	DBL_MAX
+#define	LDBL_MAX_10_EXP	DBL_MAX_10_EXP
+
+#endif
+

Source/Images/d_hitechc/u1/HITECH.H

@@ -0,0 +1,74 @@
+#ifndef _HTC_HITECH_H
+#define _HTC_HITECH_H
+
+/*	Standard types for HI-TECH Software code
+	These types may need to be tuned for different
+	machines/compilers. Notes with each one indicate assumptions
+	that should be maintained for each type.
+ */
+
+
+/*
+	Turn ANSI on if the compiler supports function prototypes and
+	has the ANSI header files
+		<stdlib.h>
+		<string.h>
+ */
+
+#if	HI_TECH_C
+#define	ANSI	1
+#endif	HI_TECH_C
+
+/*	shorthand types */
+
+#define	uchar	unsigned char
+#define	ulong	unsigned long
+#define	ushort	unsigned short
+
+/* useful, tuneable types. Change only if:
+
+	1) compiler does not support type, e.g. unsigned char.
+	2) compiler generates bad code for a particular type.
+	3) a larger type would generate faster code, e.g. byte counters
+	   on the 65816 are inefficient code-wise.
+ */
+
+#define	BOOL	unsigned char		/* boolean variable. Any integral type
+					   will do. */
+#define	FAST	char			/* fast, small counter. Must permit
+					   values -128 to 127 but may be larger. */
+#define	UFAST	unsigned char		/* fast, small unsigned counter. Must
+					   permit values 0-255 at least */
+#define	BYTE	unsigned char		/* sizeof(BYTE) must == 1 */
+#define	INT_16	short			/* signed, >= 16 bits */
+#define	UINT_16	unsigned short		/* unsigned, >= 16 bits */
+#define	INT_32	long			/* signed, >= 32 bits */
+#define	UINT_32	unsigned long		/* unsigned, >= 32 bits */
+
+
+/*	Register variable selectors; REG1 is for things that must go
+	in registers at all costs, REG2 for things that should, REG3 for
+	things that could go in registers if there are any left over.
+	Ordering of declarations will of course come into it too.
+ */
+
+#if	z80		/* only has one register variable */
+#define	REG1	register
+#define	REG2	auto
+#define	REG3	auto
+#endif	z80
+
+#if	i8086		/* only has two register variable */
+#define	REG1	register
+#define	REG2	register
+#define	REG3	auto
+#endif	i8086
+
+#if	i8096 || m68k	/* lots of registers! */
+#define	REG1	register
+#define	REG2	register
+#define	REG3	register
+#endif	i8096 || m68k
+
+#endif
+

Source/Images/d_hitechc/u1/LIMITS.H

@@ -0,0 +1,23 @@
+#ifndef _HTC_LIMITS_H
+#define _HTC_LIMITS_H
+
+/*	Characteristics of integral types */
+
+#define	CHAR_BIT	8		/* bits per char */
+#define	CHAR_MAX	127		/* max value of a char */
+#define	CHAR_MIN	-128		/* min value */
+#define	SCHAR_MAX	CHAR_MAX	/* chars are signed */
+#define	SCHAR_MIN	CHAR_MIN
+#define	UCHAR_MAX	255		/* for unsigned chars */
+#define	SHRT_MAX	32767		/* max value of a short */
+#define	SHRT_MIN	-32768
+#define	USHRT_MAX	65535		/* unsigned short */
+#define	INT_MAX		32767		/* max for int */
+#define	INT_MIN		-32768		/* min for int */
+#define	UINT_MAX	65535		/* unsigned int */
+#define	LONG_MAX	2147483647	/* max value of long */
+#define	LONG_MIN	-2147483648	/* min value */
+#define	ULONG_MAX	4294967295	/* unsigned long */
+
+#endif
+

Source/Images/d_hitechc/u1/MATH.H

@@ -0,0 +1,13 @@
+#ifndef _HTC_MATH_H
+#define _HTC_MATH_H
+
+extern double fabs(double), floor(double), ceil(double), modf(double, double *);
+extern double sqrt(double), atof(char *);
+extern double sin(double), cos(double), tan(double);
+extern double asin(double), acos(double), atan(double), atan2(double, double);
+extern double frexp(double, int *), ldexp(double, int);
+extern double log(double), log10(double), pow(double, double), exp(double);
+extern double sinh(double), cosh(double), tanh(double);
+
+#endif
+

Source/Images/d_hitechc/u1/OPTIONS

@@ -0,0 +1,22 @@
+HI-TECH Z80 CP/M C compiler options:
+
+-A	Generate a self-relocating .COM program.
+-C	Generate object code only; don't link.
+-CR     Produce a cross-reference listing e.g. -CRfile.crf
+-D	Define a symbol, e.g. -DDEBUG=1
+-E	Specify executable output filename, e.g. -Efile.com
+-Ffile	Generate a symbol file for debug.com or overlay build (default L.SYM)
+-H      Output help (the OPTIONS file) and exit.
+-I	Specify an include directory, e.g. -I1:B:
+-L	Scan a library, e.g. -LF scans the floating point library.
+-M	Generate a map file, e.g. -Mfile.map
+-N	Use the NRTCPM.OBJ start-up with minimal _getargs().
+-O	Invoke the peephole optimizer (reduced code-size)
+-OF	Invoke the optimizer for speed (Fast)
+-S	Generate assembler code in a .AS file; don't assemble or link.
+-U	Undefine a predefined symbol, e.g. -UDEBUG
+-V	Be verbose during compilation.
+-W	Set warning level, e.g. -w5 or -w-2
+-X	Suppress local symbols in symbol tables.
+-Y	Generate an overlay output file (.OVR file-type)
+

Source/Images/d_hitechc/u1/OVERLAY.H

@@ -0,0 +1,6 @@
+#ifndef _HTC_OVERLAY_H
+#define _HTC_OVERLAY_H
+
+#include <stdint.h>
+intptr_t ovrload(char *ovr_name,intptr_t args);
+#endif

Source/Images/d_hitechc/u1/SETJMP.H

@@ -0,0 +1,24 @@
+#ifndef _HTC_SETJMP_H
+#define _HTC_SETJMP_H
+
+#if	z80
+typedef	int	jmp_buf[4];
+#endif
+
+#if	i8086
+typedef	int	jmp_buf[8];
+#endif
+
+#if	i8096
+typedef	int	jmp_buf[10];
+#endif
+
+#if	m68k
+typedef	int	jmp_buf[10];
+#endif
+
+extern	int	setjmp(jmp_buf);
+extern void	longjmp(jmp_buf, int);
+
+#endif
+

Source/Images/d_hitechc/u1/SIGNAL.H

@@ -0,0 +1,36 @@
+#ifndef _HTC_SIGNAL_H
+#define _HTC_SIGNAL_H
+
+/*
+ *	Signal definitions for CP/M
+ */
+#ifdef	unix
+#define NSIG 17
+#define	SIGHUP	1	/* hangup    (not used by terminal driver) */
+#define	SIGINT	2	/* interrupt (^C or BREAK) */
+#define	SIGQUIT	3	/* quit      (^\) */
+#define	SIGILL	4	/* illegal instruction (not reset when caught) */
+#define	SIGTRAP	5	/* trace trap (not reset when caught) */
+#define	SIGIOT	6	/* IOT instruction */
+#define	SIGEMT	7	/* EMT instruction */
+#define	SIGFPE	8	/* floating point exception */
+#define	SIGKILL	9	/* kill (cannot be caught or ignored) */
+#define	SIGBUS	10	/* bus error */
+#define	SIGSEGV	11	/* segmentation violation */
+#define	SIGSYS	12	/* bad argument to system call */
+#define	SIGPIPE	13	/* write on a pipe with no one to read it */
+#define	SIGALRM	14	/* alarm clock */
+#define	SIGTERM	15	/* software termination signal from kill */
+#else
+#define NSIG 1
+#define	SIGINT	1		/* control-C */
+#endif
+
+typedef void* signal_t;
+#define	SIG_DFL	((signal_t)0)	/* default action is to exit */
+#define	SIG_IGN	((signal_t)1)	/* ignore them */
+
+signal_t signal(int sig, signal_t action);
+
+#endif
+

Source/Images/d_hitechc/u1/STAT.H

@@ -0,0 +1,28 @@
+#ifndef _HTC_STAT_H
+#define _HTC_STAT_H
+
+struct stat
+{
+	short	st_mode;	/* flags */
+	long	st_atime;	/* access time */
+	long	st_mtime;	/* modification time */
+	long	st_size;	/* file size in bytes */
+};
+
+/* Flag bits in st_mode */
+
+#define	S_IFMT		0x600	/* type bits */
+#define		S_IFDIR	0x400	/* is a directory */
+#define		S_IFREG	0x200	/* is a regular file */
+#define	S_IREAD		0400	/* file can be read */
+#define	S_IWRITE	0200	/* file can be written */
+#define	S_IEXEC		0100	/* file can be executed */
+#define	S_HIDDEN	0x1000	/* file is hidden */
+#define	S_SYSTEM	0x2000	/* file is marked system */
+#define	S_ARCHIVE	0x4000	/* file has been written to */
+
+
+extern int	stat(char *, struct stat *);
+
+#endif
+

Source/Images/d_hitechc/u1/STDARG.H

@@ -0,0 +1,15 @@
+#ifndef _HTC_STDARG_H
+#define _HTC_STDARG_H
+
+/*	Macros for accessing variable arguments */
+
+typedef void *	va_list[1];
+
+#define	va_start(ap, parmn)	*ap = (char *)&parmn + sizeof parmn
+
+#define	va_arg(ap, type)	(*(*(type **)ap)++)
+
+#define	va_end(ap)
+
+#endif
+

Source/Images/d_hitechc/u1/STDDEF.H

@@ -0,0 +1,18 @@
+#ifndef _HTC_STDDEF_H
+#define _HTC_STDDEF_H
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+
+#endif
+

Source/Images/d_hitechc/u1/STDINT.H

@@ -0,0 +1,15 @@
+#ifndef _HTC_STDINT_H
+#define _HTC_STDINT_H
+
+#if z80||i8086||i8096||m68k
+typedef unsigned char uint8_t;
+typedef char int8_t;
+typedef unsigned short uint16_t;
+typedef short int16_t;
+typedef unsigned long uint32_t;
+typedef long int32_t;
+typedef unsigned short intptr_t;
+#endif
+
+#endif
+

Source/Images/d_hitechc/u1/STDIO.H

@@ -0,0 +1,132 @@
+#ifndef _HTC_STDIO_H
+#define _HTC_STDIO_H
+
+/*
+ * STDIO.H	HI-TECH C standard I/O for V3.09-xx
+ *
+ *		This version incorporates changes to stdio routines
+ *		resulting from backporting features from V4.11
+ */
+
+#define _HTC_VERSION	"3.09-19"
+#define _HTC_MAJOR	3
+#define _HTC_MINOR	9
+#define _HTC_REV	19
+
+#if	z80
+#define	BUFSIZ		512
+#define	_NFILE		8
+#else	z80
+#define	BUFSIZ		1024
+#define	_NFILE		20
+#endif	z80
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;
+typedef	unsigned	size_t;
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
+#ifndef FILE
+#define	uchar		unsigned char
+
+extern	struct	_iobuf
+{
+	char		*_ptr;
+	int		 _cnt;
+	char		*_base;
+	unsigned short	 _flag;
+	char		 _file;
+	size_t		 _size;
+} _iob[_NFILE];
+
+#define	FILE		struct _iobuf
+#endif	FILE
+
+#ifndef SEEK_SET
+#define SEEK_SET 0
+#define SEEK_CUR 1
+#define SEEK_END 2
+#endif
+
+/* I/O status flag word bits */
+#define	_IOREAD		01	/* Allow file reading */
+#define	_IOWRT		02	/* Allow file writing */
+#define	_IORW		03	/* Mask for reading or writing */
+#define	_IONBF		04	/* Not being buffered */
+#define	_IOMYBUF	010	/* Using buffer */
+#define	_IOEOF		020	/* At end-of-file */
+#define	_IOERR		040	/* An I/O error has occurred */
+#define	_IOSTRG		0100	/* End of string reached */
+#define	_IOBINARY	0200	/* Binary mode */
+#define	_IOLBF		0400	/* Using line buffering */
+#define	_IODIRN		01000	/* Direction - writing to a R/W file */
+#define _IOAPPEND	02000	/* Append mode */
+#define _IOSEEKED	04000	/* A seek has occurred since last write */
+#define	_IOFBF		010000	/* Using full buffering */
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+#define	EOF		(-1)
+
+#define	stdin		(&_iob[0])
+#define	stdout		(&_iob[1])
+#define	stderr		(&_iob[2])
+#define	getchar()	getc(stdin)
+#define	putchar(x)	putc(x,stdout)
+
+/*
+ *	getc() and putc() must be functions for CP/M to allow the special
+ *	handling of '\r', '\n' and '\032'. The same for MSDOS except that
+ *	it at least knows the length of a file.
+ */
+
+#if	UNIX
+#define	getc(p)   (--(p)->_cnt>=0?(unsigned)*(p)->_ptr++:_filbuf(p))
+#define	putc(x,p) (--(p)->_cnt>=0?((unsigned)(*(p)->_ptr++=x)):_flsbuf((unsigned)(x),p))
+#else	UNIX
+#define	getc(p)		fgetc(p)
+#define	putc(x,p)	fputc(x,p)
+#endif	UNIX
+
+#define	feof(p)		(((p)->_flag&_IOEOF)!=0)
+#define	ferror(p)	(((p)->_flag&_IOERR)!=0)
+#define	fileno(p)	((uchar)p->_file)
+#define	clrerr(p)	p->_flag &= ~_IOERR
+#define	clreof(p)	p->_flag &= ~_IOEOF
+
+extern int	 fclose(FILE *);
+extern int	 fflush(FILE *);
+extern int	 fgetc(FILE *);
+extern int	 ungetc(int, FILE *);
+extern int	 fputc(int, FILE *);
+extern int	 getw(FILE *);
+extern int	 putw(int, FILE *);
+extern char	*gets(char *);
+extern int	 puts(char *);
+extern int	 fputs(char *, FILE *);
+extern int	 fread(void *, unsigned, unsigned, FILE *);
+extern int	 fwrite(void *, unsigned, unsigned, FILE *);
+extern int	 fseek(FILE *, long, int);
+extern int	 rewind(FILE *);
+extern void	 setbuf(FILE *, char *);
+extern int	 setvbuf(FILE *, char *, int, size_t);
+extern int	 printf(char *, ...);
+extern int	 fprintf(FILE *, char *, ...);
+extern int	 sprintf(char *, char *, ...);
+extern int	 scanf(char *, ...);
+extern int	 fscanf(FILE *, char *, ...);
+extern int	 sscanf(char *, char *, ...);
+extern int	 remove(char *);
+extern FILE	*fopen(char *, char *);
+extern FILE	*freopen(char *, char *, FILE *);
+extern FILE	*fdopen(int, char *);
+extern long	 ftell(FILE *);
+extern char	*fgets(char *, int, FILE *);
+extern char	*_bufallo(void);
+
+#endif _HTC_STDIO_H
+

Source/Images/d_hitechc/u1/STDLIB.H

@@ -0,0 +1,42 @@
+#ifndef _HTC_STDLIB_H
+#define _HTC_STDLIB_H
+
+/*	Standard utility functions */
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+
+#define	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+#endif	_STDDEF
+
+#define	RAND_MAX	32767		/* max value returned by rand() */
+
+extern double	 atof(char *);
+extern int	 atoi(char *);
+extern long	 atol(char *);
+extern int	 rand(void);
+extern void	 srand(unsigned int);
+extern void	*calloc(size_t, size_t);
+extern void	 free(void *);
+extern void	*malloc(size_t);
+extern void	*realloc(void *, size_t);
+extern void	 abort(void);
+extern void	 exit(int);
+extern char	*getenv(char *);
+extern int	 system(char *);
+typedef int (*__qsort_compf)(void *, void *);  /* workaround compiler bug */
+extern void	 qsort(void *, size_t, size_t, __qsort_compf);
+extern int	 abs(int);
+extern long	 labs(long);
+
+#endif
+

Source/Images/d_hitechc/u1/STRING.H

@@ -0,0 +1,54 @@
+#ifndef _HTC_STRING_H
+#define _HTC_STRING_H
+
+/*	String functions v3.09-4 */
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+
+extern void	*memcpy(void *, void *, size_t);
+extern void	*memmove(void *, void *, size_t);
+extern char	*strcpy(char *, char *);
+extern char	*strncpy(char *, char *, size_t);
+extern char	*strcat(char *, char *);
+extern char	*strncat(char *, char *, size_t);
+extern int	 memcmp(void *, void *, size_t);
+extern int	 strcmp(char *, char *);
+extern int	 strcasecmp(char *, char *);
+#define stricmp strcasecmp
+extern int	 strncmp(char *, char *, size_t);
+extern int	 strncasecmp(char *, char *, size_t);
+#define strnicmp strncasecmp
+/* extern size_t	 strcoll(char *, size_t, char *); */ /* missing */
+extern void	*memchr(void *, int, size_t);
+/* extern size_t	 strcspn(char *, char *); */ /* missing */
+/* extern char	*strpbrk(char *, char *); */ /* missing */
+/* extern size_t	 strspn(char *, char *); *//* missing */
+extern char	*strstr(char *, char *);
+extern char	*strtok(char *, char *);
+extern void	*memset(void *, int, size_t);
+extern char	*strerror(int);
+extern size_t	 strlen(char *);
+extern char	*strchr(char *, int);
+/* #define index	strchr */	/* these are equivalent */
+extern char	*index(char *, int);
+extern char	*strrchr(char *, int);
+/* #define	rindex	*strrchr */	/* these are equivalent */
+extern char	*rindex(char *, int);
+extern char	*strcasestr(char *, char *);
+#define stristr	strcasestr
+extern char	*strncasestr(char *, char *, size_t);
+#define	strnistr strncasestr
+
+#endif
+

Source/Images/d_hitechc/u1/SYS.H

@@ -0,0 +1,40 @@
+#ifndef _HTC_SYS_H
+#define _HTC_SYS_H
+
+/*
+ *	System-dependent functions.
+ */
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+
+extern int	execl(char *, char *, char *, ...);
+extern int	execv(char *, char **);
+extern int	spawnl(char *, char *, char *, ...);
+extern int	spawnv(char *, char **);
+extern int	spawnle(char *, char *, char *, char *, ...);
+extern int	spawnve(char *, char **, char *);
+extern short	getuid(void);
+extern short	setuid(short);
+extern int	chdir(char *);
+extern int	mkdir(char *);
+extern int	rmdir(char *);
+extern int	getcwd(int);
+extern char   **_getargs(char *, char *);
+extern int	_argc_;
+extern int	inp(int);
+extern void	outp(int, int);
+extern void *	sbrk(size_t);
+
+#endif
+

Source/Images/d_hitechc/u1/TIME.H

@@ -0,0 +1,44 @@
+#ifndef _HTC_TIME_H
+#define _HTC_TIME_H
+
+/* time.h for HI-TECH C Z80 v3.09-4*/
+
+#ifndef	_HTC_TIME_T
+
+typedef	long	time_t;		/* for representing times in seconds */
+struct tm {
+	int	tm_sec;
+	int	tm_min;
+	int	tm_hour;
+	int	tm_mday;
+	int	tm_mon;
+	int	tm_year;
+	int	tm_wday;
+	int	tm_yday;
+	int	tm_isdst;
+};
+#define	_HTC_TIME_T
+#endif	_HTC_TIME_T
+
+#ifndef _STDDEF
+typedef int	ptrdiff_t;	/* result type of pointer difference */
+typedef unsigned size_t;	/* type yielded by sizeof */
+#define _STDDEF
+#define offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif
+
+extern int	time_zone;	/* minutes WESTWARD of Greenwich */
+				/* this value defaults to 0 since with
+				   operating systems like MS-DOS there is
+				   no time zone information available */
+
+extern time_t	time(time_t *);		/* seconds since 00:00:00 Jan 1 1970 */
+extern char *	asctime(struct tm *);	/* converts struct tm to ascii time */
+extern char *	ctime(time_t *);	/* current local time in ascii form */
+extern struct tm *	gmtime(time_t *);	/* Universal time */
+extern struct tm *	localtime(time_t *);	/* local time */
+extern size_t strftime(char *s, size_t maxs, char *f, struct tm *t);
+extern time_t	mktime(struct tm *);	/* convert struct tm to time value */
+
+#endif
+

Source/Images/d_hitechc/u1/UNIXIO.H

@@ -0,0 +1,34 @@
+#ifndef _HTC_UNIXIO_H
+#define _HTC_UNIXIO_H
+
+/*
+ *	Declarations for Unix style low-level I/O functions.
+ */
+
+#ifndef	_STDDEF
+typedef	int		ptrdiff_t;	/* result type of pointer difference */
+typedef	unsigned	size_t;		/* type yielded by sizeof */
+#define	_STDDEF
+#define	offsetof(ty, mem)	((int)&(((ty *)0)->mem))
+#endif	_STDDEF
+
+#ifndef	NULL
+#define	NULL	((void *)0)
+#endif	NULL
+
+extern int	errno;			/* system error number */
+
+extern int	open(char *, int);
+extern int	close(int);
+extern int	creat(char *, int);
+extern int	dup(int);
+extern long	lseek(int, long, int);
+extern int	read(int, void *, int);
+extern int	rename(char *, char *);
+extern int	unlink(char *);
+extern int	write(int, void *, int);
+extern int	isatty(int);
+extern int	chmod(char *, int);
+
+#endif
+

Source/Images/d_zsdos/u0/LICENSE.TXT

@@ -1,339 +1,339 @@
-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-                          675 Mass Ave, Cambridge, MA 02139, USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-			    Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.)  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
-
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-		    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-			    NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
-
-		     END OF TERMS AND CONDITIONS
-
-	    How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) 19yy  <name of author>
-
-    This program is free software; you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License
-    along with this program; if not, write to the Free Software
-    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) 19yy name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
-
-This General Public License does not permit incorporating your program into
-proprietary programs.  If your program is a subroutine library, you may
-consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Library General
-Public License instead of this License.
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+                          675 Mass Ave, Cambridge, MA 02139, USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+		    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+			    NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+	    How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) 19yy  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) 19yy name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Library General
+Public License instead of this License.

Source/Images/fd_z3plus.txt

@@ -1,63 +1,63 @@
-#
-# Add the ReadMe document
-#
-d_z3plus/ReadMe.txt 0:
-#
-# Add files from CPM3 build
-#
-../CPM3/cpmldr.com 0:
-../CPM3/cpmldr.sys 0:
-../CPM3/ccp.com 0:
-../CPM3/gencpm.com 0:
-../CPM3/genres.dat 0:
-../CPM3/genbnk.dat 0:
-../CPM3/bios3.spr 0:
-../CPM3/bnkbios3.spr 0:
-../CPM3/bdos3.spr 0:
-../CPM3/bnkbdos3.spr 0:
-../CPM3/resbdos3.spr 0:
-../CPM3/cpm3res.sys 0:
-../CPM3/cpm3bnk.sys 0:
-../CPM3/gencpm.dat 0:
-../CPM3/cpm3.sys 0:
-../CPM3/readme.1st 0:
-../CPM3/cpm3fix.pat 0:
-#
-# Include CP/M 3 files
-#
-d_cpm3/u0/*.COM 15:
-d_cpm3/u0/SUBMIT.COM 0:
-d_cpm3/u0/HELP.HLP 0:
-#
-# Add RomWBW utilities
-#
-../../Binary/Apps/assign.com 15:
-../../Binary/Apps/cpuspd.com 15:
-../../Binary/Apps/reboot.com 15:
-../../Binary/Apps/fat.com 15:
-../../Binary/Apps/fdu.com 15:
-../../Binary/Apps/mode.com 15:
-../../Binary/Apps/rtc.com 15:
-../../Binary/Apps/survey.com 15:
-../../Binary/Apps/syscopy.com 15:
-../../Binary/Apps/sysgen.com 15:
-../../Binary/Apps/timer.com 15:
-../../Binary/Apps/xm.com 15:
-#
-# Add Shared NZCOM/Z3PLUS
-#
-Common/NZ3PLUS/u10/*.* 10:
-Common/NZ3PLUS/u14/*.* 14:
-Common/NZ3PLUS/u15/*.* 15:
-#
-# Add Common Applications
-#
-# Common/All/u10/*.* 10:
-# Common/All/u14/*.* 14:
-# Common/All/u15/*.* 15:
-Common/CPM3/*.* 15:
-Common/Z/u14/*.* 14:
-Common/Z/u15/*.* 15:
-# Common/Z3/u10/*.* 10:
-Common/Z3/u14/*.* 14:
-Common/Z3/u15/*.* 15:
+#
+# Add the ReadMe document
+#
+d_z3plus/ReadMe.txt 0:
+#
+# Add files from CPM3 build
+#
+../CPM3/cpmldr.com 0:
+../CPM3/cpmldr.sys 0:
+../CPM3/ccp.com 0:
+../CPM3/gencpm.com 0:
+../CPM3/genres.dat 0:
+../CPM3/genbnk.dat 0:
+../CPM3/bios3.spr 0:
+../CPM3/bnkbios3.spr 0:
+../CPM3/bdos3.spr 0:
+../CPM3/bnkbdos3.spr 0:
+../CPM3/resbdos3.spr 0:
+../CPM3/cpm3res.sys 0:
+../CPM3/cpm3bnk.sys 0:
+../CPM3/gencpm.dat 0:
+../CPM3/cpm3.sys 0:
+../CPM3/readme.1st 0:
+../CPM3/cpm3fix.pat 0:
+#
+# Include CP/M 3 files
+#
+d_cpm3/u0/*.COM 15:
+d_cpm3/u0/SUBMIT.COM 0:
+d_cpm3/u0/HELP.HLP 0:
+#
+# Add RomWBW utilities
+#
+../../Binary/Apps/assign.com 15:
+../../Binary/Apps/cpuspd.com 15:
+../../Binary/Apps/reboot.com 15:
+../../Binary/Apps/fat.com 15:
+../../Binary/Apps/fdu.com 15:
+../../Binary/Apps/mode.com 15:
+../../Binary/Apps/rtc.com 15:
+../../Binary/Apps/survey.com 15:
+../../Binary/Apps/syscopy.com 15:
+../../Binary/Apps/sysgen.com 15:
+../../Binary/Apps/timer.com 15:
+../../Binary/Apps/xm.com 15:
+#
+# Add Shared NZCOM/Z3PLUS
+#
+Common/NZ3PLUS/u10/*.* 10:
+Common/NZ3PLUS/u14/*.* 14:
+Common/NZ3PLUS/u15/*.* 15:
+#
+# Add Common Applications
+#
+# Common/All/u10/*.* 10:
+# Common/All/u14/*.* 14:
+# Common/All/u15/*.* 15:
+Common/CPM3/*.* 15:
+Common/Z/u14/*.* 14:
+Common/Z/u15/*.* 15:
+# Common/Z3/u10/*.* 10:
+Common/Z3/u14/*.* 14:
+Common/Z3/u15/*.* 15:

Source/Images/hd_z3plus.txt

@@ -1,102 +1,102 @@
-#
-# Add the ReadMe document
-#
-d_z3plus/ReadMe.txt 0:
-#
-# Add files from CPM3 build
-#
-../CPM3/cpmldr.com 0:
-../CPM3/cpmldr.sys 0:
-../CPM3/ccp.com 0:
-../CPM3/gencpm.com 0:
-../CPM3/genres.dat 0:
-../CPM3/genbnk.dat 0:
-../CPM3/bios3.spr 0:
-../CPM3/bnkbios3.spr 0:
-../CPM3/bdos3.spr 0:
-../CPM3/bnkbdos3.spr 0:
-../CPM3/resbdos3.spr 0:
-../CPM3/cpm3res.sys 0:
-../CPM3/cpm3bnk.sys 0:
-../CPM3/gencpm.dat 0:
-../CPM3/cpm3.sys 0:
-../CPM3/readme.1st 0:
-../CPM3/cpm3fix.pat 0:
-#
-# Include CP/M 3 files
-#
-d_cpm3/u0/*.COM 15:
-d_cpm3/u0/SUBMIT.COM 0:
-d_cpm3/u0/HELP.HLP 0:
-#
-# Add RomWBW utilities
-#
-#../../Binary/Apps/*.com 15:
-../../Binary/Apps/assign.com 15:
-../../Binary/Apps/bbcbasic.com 15:
-../../Binary/Apps/bbcbasic.txt 10:
-../../Binary/Apps/cpuspd.com 15:
-../../Binary/Apps/reboot.com 15:
-../../Binary/Apps/copysl.com 15:
-../../Binary/Apps/copysl.doc 10:
-../../Binary/Apps/fat.com 15:
-../../Binary/Apps/fdu.com 15:
-../../Binary/Apps/fdu.doc 10:
-../../Binary/Apps/format.com 15:
-../../Binary/Apps/mode.com 15:
-../../Binary/Apps/rtc.com 15:
-../../Binary/Apps/slabel.com 15:
-../../Binary/Apps/survey.com 15:
-../../Binary/Apps/syscopy.com 15:
-../../Binary/Apps/sysgen.com 15:
-../../Binary/Apps/talk.com 15:
-../../Binary/Apps/htalk.com 15:
-../../Binary/Apps/tbasic.com 15:
-../../Binary/Apps/timer.com 15:
-../../Binary/Apps/tune.com 15:
-../../Binary/Apps/xm.com 15:
-../../Binary/Apps/zmp.com 15:
-../../Binary/Apps/zmp.hlp 15:
-../../Binary/Apps/zmp.doc 10:
-../../Binary/Apps/zmp.cfg 15:
-../../Binary/Apps/zmp.fon 15:
-../../Binary/Apps/zmxfer.ovr 15:
-../../Binary/Apps/zmterm.ovr 15:
-../../Binary/Apps/zminit.ovr 15:
-../../Binary/Apps/zmconfig.ovr 15:
-../../Binary/Apps/zmd.com 15:
-../../Binary/Apps/vgmplay.com 15:
-#
-../../Binary/Apps/Test/*.com 2:
-../../Binary/Apps/Test/*.doc 2:
-Common/Test/*.* 2:
-#
-# Add Tune sample files
-#
-../../Binary/Apps/Tunes/*.pt? 3:
-../../Binary/Apps/Tunes/*.mym 3:
-../../Binary/Apps/Tunes/*.vgm 3:
-#
-# Add CPNET client files
-#
-../../Binary/CPNET/cpn3*.lbr 4:
-../../Binary/CPNET/ReadMe.txt 4:
-#
-# Add Shared NZCOM/Z3PLUS
-#
-Common/NZ3PLUS/u10/*.* 10:
-Common/NZ3PLUS/u14/*.* 14:
-Common/NZ3PLUS/u15/*.* 15:
-#
-# Add Common Applications
-#
-Common/All/u10/*.* 10:
-Common/All/u14/*.* 14:
-Common/All/u15/*.* 15:
-Common/CPM3/*.* 15:
-Common/Z/u14/*.* 14:
-Common/Z/u15/*.* 15:
-Common/Z3/u10/*.* 10:
-Common/Z3/u14/*.* 14:
-Common/Z3/u15/*.* 15:
-Common/SIMH/*.* 13:
+#
+# Add the ReadMe document
+#
+d_z3plus/ReadMe.txt 0:
+#
+# Add files from CPM3 build
+#
+../CPM3/cpmldr.com 0:
+../CPM3/cpmldr.sys 0:
+../CPM3/ccp.com 0:
+../CPM3/gencpm.com 0:
+../CPM3/genres.dat 0:
+../CPM3/genbnk.dat 0:
+../CPM3/bios3.spr 0:
+../CPM3/bnkbios3.spr 0:
+../CPM3/bdos3.spr 0:
+../CPM3/bnkbdos3.spr 0:
+../CPM3/resbdos3.spr 0:
+../CPM3/cpm3res.sys 0:
+../CPM3/cpm3bnk.sys 0:
+../CPM3/gencpm.dat 0:
+../CPM3/cpm3.sys 0:
+../CPM3/readme.1st 0:
+../CPM3/cpm3fix.pat 0:
+#
+# Include CP/M 3 files
+#
+d_cpm3/u0/*.COM 15:
+d_cpm3/u0/SUBMIT.COM 0:
+d_cpm3/u0/HELP.HLP 0:
+#
+# Add RomWBW utilities
+#
+#../../Binary/Apps/*.com 15:
+../../Binary/Apps/assign.com 15:
+../../Binary/Apps/bbcbasic.com 15:
+../../Binary/Apps/bbcbasic.txt 10:
+../../Binary/Apps/cpuspd.com 15:
+../../Binary/Apps/reboot.com 15:
+../../Binary/Apps/copysl.com 15:
+../../Binary/Apps/copysl.doc 10:
+../../Binary/Apps/fat.com 15:
+../../Binary/Apps/fdu.com 15:
+../../Binary/Apps/fdu.doc 10:
+../../Binary/Apps/format.com 15:
+../../Binary/Apps/mode.com 15:
+../../Binary/Apps/rtc.com 15:
+../../Binary/Apps/slabel.com 15:
+../../Binary/Apps/survey.com 15:
+../../Binary/Apps/syscopy.com 15:
+../../Binary/Apps/sysgen.com 15:
+../../Binary/Apps/talk.com 15:
+../../Binary/Apps/htalk.com 15:
+../../Binary/Apps/tbasic.com 15:
+../../Binary/Apps/timer.com 15:
+../../Binary/Apps/tune.com 15:
+../../Binary/Apps/xm.com 15:
+../../Binary/Apps/zmp.com 15:
+../../Binary/Apps/zmp.hlp 15:
+../../Binary/Apps/zmp.doc 10:
+../../Binary/Apps/zmp.cfg 15:
+../../Binary/Apps/zmp.fon 15:
+../../Binary/Apps/zmxfer.ovr 15:
+../../Binary/Apps/zmterm.ovr 15:
+../../Binary/Apps/zminit.ovr 15:
+../../Binary/Apps/zmconfig.ovr 15:
+../../Binary/Apps/zmd.com 15:
+../../Binary/Apps/vgmplay.com 15:
+#
+../../Binary/Apps/Test/*.com 2:
+../../Binary/Apps/Test/*.doc 2:
+Common/Test/*.* 2:
+#
+# Add Tune sample files
+#
+../../Binary/Apps/Tunes/*.pt? 3:
+../../Binary/Apps/Tunes/*.mym 3:
+../../Binary/Apps/Tunes/*.vgm 3:
+#
+# Add CPNET client files
+#
+../../Binary/CPNET/cpn3*.lbr 4:
+../../Binary/CPNET/ReadMe.txt 4:
+#
+# Add Shared NZCOM/Z3PLUS
+#
+Common/NZ3PLUS/u10/*.* 10:
+Common/NZ3PLUS/u14/*.* 14:
+Common/NZ3PLUS/u15/*.* 15:
+#
+# Add Common Applications
+#
+Common/All/u10/*.* 10:
+Common/All/u14/*.* 14:
+Common/All/u15/*.* 15:
+Common/CPM3/*.* 15:
+Common/Z/u14/*.* 14:
+Common/Z/u15/*.* 15:
+Common/Z3/u10/*.* 10:
+Common/Z3/u14/*.* 14:
+Common/Z3/u15/*.* 15:
+Common/SIMH/*.* 13:

Source/ver.inc

@@ -2,7 +2,7 @@
 #DEFINE	RMN	6
 #DEFINE	RUP	0
 #DEFINE	RTP	0
-#DEFINE BIOSVER	"3.6.0-dev.1"
+#DEFINE BIOSVER	"3.6.0-dev.4"
 #define rmj	RMJ
 #define rmn	RMN
 #define rup	RUP

Source/ver.lib

@@ -3,5 +3,5 @@ rmn	equ	6
 rup	equ	0
 rtp	equ	0
 biosver	macro
-	db	"3.6.0-dev.1"
+	db	"3.6.0-dev.4"
 	endm