diff --git a/Doc/ROM Applications.pdf b/Doc/ROM Applications.pdf index 200a6909..be61eaa6 100644 Binary files a/Doc/ROM Applications.pdf and b/Doc/ROM Applications.pdf differ diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index 7f5689bd..0b8495cf 100644 Binary files a/Doc/RomWBW Applications.pdf and b/Doc/RomWBW Applications.pdf differ diff --git a/Doc/RomWBW Architecture.pdf b/Doc/RomWBW Architecture.pdf index 7ce320d5..e0055961 100644 Binary files a/Doc/RomWBW Architecture.pdf and b/Doc/RomWBW Architecture.pdf differ diff --git a/Doc/RomWBW Disk Catalog.pdf b/Doc/RomWBW Disk Catalog.pdf index fb73082d..9037645c 100644 Binary files a/Doc/RomWBW Disk Catalog.pdf and b/Doc/RomWBW Disk Catalog.pdf differ diff --git a/Doc/RomWBW Getting Started.pdf b/Doc/RomWBW Getting Started.pdf index 38bcfe88..b73abada 100644 Binary files a/Doc/RomWBW Getting Started.pdf and b/Doc/RomWBW Getting Started.pdf differ diff --git a/ReadMe.md b/ReadMe.md index 0b0b9c04..e369792e 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -1,9 +1,50 @@ +--- +author: "Wayne Warthen (mailto:wwarthen@gmail.com)" +classoption: +- oneside +colorlinks: true +date: 27 Oct 2021 +documentclass: book +fontfamily: helvet +fontsize: 12pt +geometry: +- top=1.5in +- bottom=1.5in +- left=1.5in +- right=1.5in +graphics: true +header-includes: +- +- +include-before: +- +- +institution: RetroBrew Computers Group +linestretch: 1.25 +numbersections: true +papersize: letter +secnumdepth: 1 +title: RomWBW Getting Started +toc: true +toc-depth: 1 +--- + + + + + + + + + + + # RomWBW ## Z80/Z180 System Software Version 3.1 Pre-release -22 Oct 2021 +27 Oct 2021 Wayne Warthen diff --git a/ReadMe.txt b/ReadMe.txt index 97da5566..20a32d9f 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,9 +1,23 @@ +RomWBW Getting Started +Wayne Warthen (mailto:wwarthen@gmail.com) +27 Oct 2021 + + + + + + + + + + + RomWBW Z80/Z180 System Software Version 3.1 Pre-release -22 Oct 2021 +27 Oct 2021 Wayne Warthen wwarthen@gmail.com diff --git a/Source/BPBIOS/def-ww-z33.lib b/Source/BPBIOS/def-ww-z33.lib index d848a30b..d5b833ad 100644 --- a/Source/BPBIOS/def-ww-z33.lib +++ b/Source/BPBIOS/def-ww-z33.lib @@ -19,7 +19,7 @@ DATE MACRO DEFB '07 Oct 21' ; Date of this version ENDM AUTOCL MACRO - DEFB 8,'ZEX ZST ',0 ; Autostart command line + DEFB 8,'ZEX Z33 ',0 ; Autostart command line ENDM ;--- Basic System and Z-System Section --- diff --git a/Source/BPBIOS/def-ww-z33bnk.lib b/Source/BPBIOS/def-ww-z33bnk.lib index d67f369a..aaae6bf8 100644 --- a/Source/BPBIOS/def-ww-z33bnk.lib +++ b/Source/BPBIOS/def-ww-z33bnk.lib @@ -19,7 +19,7 @@ DATE MACRO DEFB '07 Oct 21' ; Date of this version ENDM AUTOCL MACRO - DEFB 8,'ZEX ZST ',0 ; Autostart command line + DEFB 8,'ZEX Z33 ',0 ; Autostart command line ENDM ;--- Basic System and Z-System Section --- diff --git a/Source/BPBIOS/suportww.lbr b/Source/BPBIOS/suportww.lbr index 0bc2e57f..04760f13 100644 Binary files a/Source/BPBIOS/suportww.lbr and b/Source/BPBIOS/suportww.lbr differ diff --git a/Source/BPBIOS/support.txt b/Source/BPBIOS/support.txt index 071e4626..db70c39d 100644 --- a/Source/BPBIOS/support.txt +++ b/Source/BPBIOS/support.txt @@ -7,43 +7,38 @@ others are Date and Time stamp drivers, some are command line editors and history shells others are needed to initialize the RAMDRIVE as well as help files. The following table shows which files are needed to support each of the ten -BPBIOS variants (BP33N, BP33T, BP33NBNK, BP33TBNK, BP34N, BP34T, BP34NBNK, -BP34TBNK, BP41NBNK & BBP41TBNK). +BPBIOS variants (BP33, BP33BNK, BP34, BP34BNK & BBP41BNK). -Variant Name BP33N* BP33T* BP34N* BP34T* BP41NBNK BP41TBNK -====================================================================== -bpbio.ndr X X X X +Variant Name BP33 BP33BNK BP34 BP34BNK BP41BNK +================================================================ +bpbio.ndr X X X bpbioz33.ndr X X -BPCNFG.COM X X X X X X +BPCNFG.COM X X X X X EASE.COM X X EASE.HLP X X fcp-4.zrl X X -fcp-4t.zrl X X X X -FILEATTR.COM X X X X X X -HELPLSH.COM X X X X -IF.COM X X X X -jetldr.com X X X X X X -LDTIME7.COM X -LDTIME9.COM X -LDTIMEC.COM X -LDTIMEE.COM X -LSH.COM X X X X -LSHF.COM -LSHF.VAR -myterm.z3t X X X X X X -nzdec23d.z3t X X X X X X -PUTDS.COM X X X X X X -RAMFILES.TXT X X X X X X -RCOPY.COM X X X X X X +fcp-4t.zrl X X X +RELOG X X X X X +HELPLSH.COM X X X +IF.COM X X X X +jetldr.com X X X X X +LDTIMEC.COM X X X +LSH.COM X X X +LSHF.COM* X X X +LSHF.VAR* X X X +myterm.z3t X X X X X +nzdec23d.z3t X X X X X +PUTDS.COM X X X X X +RAMFILES.TXT X X X X X +RCOPY.COM X X X X X rcp-16h.zrl X X X X -Z33N.ZEX X -Z33T.ZEX X -ZEX.COM X X X X X X -ZPATH.COM X X X X X X -ZSCFG2.COM -ZSTF.ZEX X X -ZSTN.ZEX X -ZSTT.ZEX X +SAVE.COM X X X X +Z33.ZEX X X +ZEX.COM X X X X X +ZPATH.COM X X X X X +ZSCFG2.COM X +ZSTF.ZEX X +ZST.ZEX X X Instructions: @@ -54,7 +49,7 @@ files. First extract ZEX.COM while logged onto the A: drive with the following command: B0:LBREXT SUPPORT C0:ZEX.C?M /U Next place all the .COM files on C15: by typing: - B0:LBREXT SUPPORT C15:*.C?M + B0:LBREXT SUPPORT C15:*.C?M /U The remaining files should be placed on C0:. B0:LBREXT SUPPORT C0:*.Z?X /U B0:LBREXT SUPPORT C0:*.Z?L /U @@ -74,15 +69,12 @@ BPCNFG.COM - BPBIOS configuration program EASE.COM - Command line editor & history shell for Z33* EASE.HLP - Help file for EASE fcp-4.zrl - Z33 Flow Control Processor (handles IF, ELSE etc) -fcp-4t.zrl - Z34 & Z41 Flow Control Processor (handles IF, ELSE etc) -FILEATTR.COM - Enables date stamping on RAM drive. +fcp-4t.zrl - Z34 & Z41 Flow Control Processor (IF is transient) +RELOG.COM - Enables date stamping on RAM drive. HELPLSH.COM - Help file for LSH if.com - Adds tests to fcp-4t jetldr.com - Loads Zsystem segments -LDTIME9.COM - Date stamping & clock drivers for Z33N* variants -LDTIME7.COM - Date stamping & clock drivers for Z33T* variants -LDTIMEE.COM - Date stamping & clock drivers for Z34N* variants -LDTIMEC.COM - Date stamping & clock drivers for Z34T* variants +LDTIMEC.COM - Date stamping & clock drivers for z33* & Z34* variants LSH.COM - Command line editor & history shell for Z34 & Z41 LSHF.COM - LSH with a fixed length History file (runs faster) LSHF.VAR - History file for LSHF @@ -92,13 +84,12 @@ PUTDS.COM - Installs date stamping for RAM drive. RAMFILES.TXT - List of frequently used command (edit to suit) RCOPY.COM - Copies files listed in RAMFILES.TXT to RAMDRIVE rcp-16h.zrl - Zsystem Resident Command Processor -Z33N.ZEX - Automatically executed Startup script -Z33T.ZEX - Automatically executed Startup script +SAVE.COM - Transient save command loads at 8000h +Z33.ZEX - Automatically executed Startup script for Z33 variants ZEX.COM - Memory resident SUBMIT - executes startup scripts ZPATH.COM - Loads the Zsystem & ZSDOS search paths ZSCFG2.COM - Configures ZSDOS 2 -ZSTF.ZEX - Automatically executed Startup script for BP41* -ZSTN.ZEX - Automatically executed Startup script for BP34N* -ZSTT.ZEX - Automatically executed Startup script for BP34T* +ZSTF.ZEX - Automatically executed Startup script for BP41BNK +ZST.ZEX - Automatically executed Startup script for BP34* -Note that clock & datestamping drivers are builtin to Z41. \ No newline at end of file +Note that clock & datestamping drivers are builtin to Z41. \ No newline at end of file diff --git a/Source/BPBIOS/z33.zex b/Source/BPBIOS/z33.zex new file mode 100644 index 00000000..8ed8d4af --- /dev/null +++ b/Source/BPBIOS/z33.zex @@ -0,0 +1,20 @@ +;; Set the ZCPR and ZSDOS paths +c15:zpath $$$$ a0 b0 c15 c0 /d=$$$$ c15 c0 +;; Load ZCPR segments +jetldr rcp-16h.zrl,fcp-4t.zrl,bpbio.ndr,nzdec23d.z3t +;; Load date/time extension into user space +ldtimec +;; Initialize the RAM disk if needed and copy some useful files there +if ~ex a0:-ram.000 +;; Load datestamping file on a: +putds -d=a: +;; Enable datestamping +relog +save 0 a:-ram.000 +rcopy ramfiles.txt a0: /q +fi +;; Print Time & Date as a reminder in case they need setting +td +;; Load the command history shell and editor +ease + \ No newline at end of file diff --git a/Source/BPBIOS/zst.zex b/Source/BPBIOS/zst.zex index 01cf9858..94ff4afb 100644 --- a/Source/BPBIOS/zst.zex +++ b/Source/BPBIOS/zst.zex @@ -6,11 +6,15 @@ jetldr rcp-16h.zrl,fcp-4t.zrl,bpbio.ndr,nzdec23d.z3t ldtimec ;; Initialize the RAM disk if needed and copy some useful files there if ~ex a0:-ram.000 +;; Load datestamping file on a: putds -d=a: +;; Enable datestamping relog save 0 a:-ram.000 rcopy ramfiles.txt a0: /q fi +;; Print Time & Date as a reminder in case they need setting +td ;; Load the command history shell and editor lsh  \ No newline at end of file diff --git a/Source/BPBIOS/zstf.zex b/Source/BPBIOS/zstf.zex index 1e811865..397b91eb 100644 --- a/Source/BPBIOS/zstf.zex +++ b/Source/BPBIOS/zstf.zex @@ -6,11 +6,15 @@ zscfg2 cb +a- jetldr fcp-4t.zrl,bpbio.ndr,nzdec23d.z3t ;; Initialize the RAM disk if needed and copy some useful files there if ~ex a0:-ram.000 +;; Load datestamping file on a: putds -d=a: +;; Enable datestamping relog -save 0 a0:-ram.000 +save 0 a:-ram.000 rcopy ramfiles.txt a0: /q fi +;; Print Time & Date as a reminder in case they need setting +td ;; Load the command history shell and editor lsh  \ No newline at end of file diff --git a/Source/CBIOS/cbios.asm b/Source/CBIOS/cbios.asm index 695c823d..4bb0b22e 100644 --- a/Source/CBIOS/cbios.asm +++ b/Source/CBIOS/cbios.asm @@ -2471,6 +2471,17 @@ MD_INIT4: CALL $FFFD ; DO IT (RST 08 NOT SAFE HERE) ; #IF (CLRRAMDISK == CLR_AUTO) + ; CHECK THE FIRST SECTOR (512 BYTES) FOR ALL ZEROES. IF SO, + ; IT IMPLIES THE RAM IS UNINITIALIZED. + LD HL,0 ; START AT BEGINING OF RAM DISK + LD BC,512 ; COMPARE 512 BYTES + XOR A ; COMPARE TO ZERO +CLRRAM000: + CPI ; A - (HL), HL++, BC-- + JR NZ,CLRRAM00 ; IF NOT ZERO, GO TO NEXT TEST + JP PE,CLRRAM000 ; LOOP THRU ALL BYTES + JR CLRRAM2 ; ALL ZEROES, JUMP TO INIT +CLRRAM00: ; CHECK FIRST 32 DIRECTORY ENTRIES. IF ANY START WITH AN INVALID ; VALUE, INIT THE RAM DISK. VALID ENTRIES ARE E5 (EMPTY ENTRY) OR ; 0-15 (USER NUMBER). @@ -2528,6 +2539,17 @@ CLRRAM3: CALL HB_BNKSEL ; SELECT BANK #IF (CLRRAMDISK == CLR_AUTO) + ; CHECK THE FIRST SECTOR (512 BYTES) FOR ALL ZEROES. IF SO, + ; IT IMPLIES THE RAM IS UNINITIALIZED. + LD HL,0 ; START AT BEGINING OF RAM DISK + LD BC,512 ; COMPARE 512 BYTES + XOR A ; COMPARE TO ZERO +CLRRAM000: + CPI ; A - (HL), HL++, BC-- + JR NZ,CLRRAM00 ; IF NOT ZERO, GO TO NEXT TEST + JP PE,CLRRAM000 ; LOOP THRU ALL BYTES + JR CLRRAM2 ; ALL ZEROES, JUMP TO INIT +CLRRAM00: ; CHECK FIRST 32 DIRECTORY ENTRIES. IF ANY START WITH AN INVALID ; VALUE, INIT THE RAM DISK. VALID ENTRIES ARE E5 (EMPTY ENTRY) OR ; 0-15 (USER NUMBER). diff --git a/Source/CPM3/boot.z80 b/Source/CPM3/boot.z80 index 9789cb8b..ce3fef1b 100644 --- a/Source/CPM3/boot.z80 +++ b/Source/CPM3/boot.z80 @@ -328,6 +328,17 @@ clrram: ;call hb_bnksel ; select bank call 0FFF3h ; select bank + ; Check the first sector (512 bytes) for all zeroes. If so, + ; it implies the RAM is uninitialized. + ld hl,0 ; start at begining of ram disk + ld bc,512 ; compare 512 bytes + xor a ; compare to zero +clrram000: + cpi ; a - (hl), hl++, bc-- + jr nz,clrram00 ; if not zero, go to next test + jp pe,clrram000 ; loop thru all bytes + jr clrram2 ; all zeroes, jump to init +clrram00: ; Check first 32 directory entries. If any start with an invalid ; value, init the ram disk. Valid entries are e5 (empty entry) or ; 0-15 (user number). diff --git a/Source/Doc/Applications.md b/Source/Doc/Applications.md index bd955d1b..4a2d6a2e 100644 --- a/Source/Doc/Applications.md +++ b/Source/Doc/Applications.md @@ -1,5 +1,5 @@ -\define{doc_title}{Applications} -\include{"Common.h"} +$define{doc_title}{Applications}$ +$include{"Common.h"}$ # Summary @@ -28,8 +28,8 @@ on the media. Most of the applications are included as source code in the RomWBW distribution and are built in the normal build process. The source -code is found in the Source\\\\Apps directory of the distribution. The -binary executable applications are found in the Binary\\\\Apps directory. +code is found in the Source\\Apps directory of the distribution. The +binary executable applications are found in the Binary\\Apps directory. The following table clarifies where each of the applications can be found: @@ -523,7 +523,7 @@ manually perform a verification function with the `FLASH VERIFY` form of the command. The author's documentation for the application is found in the RomWBW -distribution in the Doc\\\\Contrib directory. +distribution in the Doc\\Contrib directory. ## Notes diff --git a/Source/Doc/Architecture.md b/Source/Doc/Architecture.md index cd8114ee..859c712a 100644 --- a/Source/Doc/Architecture.md +++ b/Source/Doc/Architecture.md @@ -1,5 +1,5 @@ -\define{doc_title}{Architecture} -\include{"Common.h"} +$define{doc_title}{Architecture}$ +$include{"Common.h"}$ Overview ======== @@ -134,7 +134,7 @@ the same area that is bank switched. Boot Phase 1 copies the phase 2 code to upper memory and jumps to it to continue the boot process. This is required because the CPU starts at -address \$0000 in low memory. However, low memory is used as the area +address $0000 in low memory. However, low memory is used as the area for switching ROM/RAM banks in and out. Therefore, it is necessary to relocate execution to high memory in order to initialize the RAM memory banks. @@ -184,7 +184,7 @@ ROM Boot At power on (or hardware reset), ROM page 0 is automatically mapped to lower memory by hardware level system initialization. Page Zero (first 256 bytes of the CPU address space) is reserved to contain dispatching -instructions for interrupt instructions. Address \$0000 performs a jump +instructions for interrupt instructions. Address $0000 performs a jump to the start of the phase 1 code so that this first page can be reserved. @@ -210,13 +210,13 @@ initiate an Application Boot using the system image contained in the application file itself. Upon execution, the Application Boot program is loaded into memory by -the previously running operating system starting at \$0100. Note that +the previously running operating system starting at $0100. Note that program image contains a copy of the HBIOS to be installed and run. Once the Application Boot program is loaded by the previous operating system, control is passed to it and it performs a system initialization similar to the ROM Boot, but using the image loaded in RAM. -Specifically, the code at \$0100 (in low memory) copies phase 2 boot +Specifically, the code at $0100 (in low memory) copies phase 2 boot code to upper memory and transfers control to it. The phase 2 boot code copies the HBIOS image from application RAM to RAM, then calls the HBIOS initialization routine. At this point, the prior HBIOS code has been @@ -387,7 +387,7 @@ _Bits_ | _Function_ 2 | Stop Bits (???) 1-0 | Data Bits (???) -The 5-bit baud rate value (V) is encoded as V = 75 \* 2\^X \* 3\^Y. The +The 5-bit baud rate value (V) is encoded as V = 75 * 2^X * 3^Y. The bits are defined as YXXXX. ### Function 0x00 -- Character Input (CIOIN) @@ -526,17 +526,17 @@ types. **Media ID** | **Value** | **Format** ------------ | --------- | ---------- -MID\_NONE | 0 | No media installed -MID\_MDROM | 1 | ROM Drive -MID\_MDRAM | 2 | RAM Drive -MID\_RF | 3 | RAM Floppy (LBA) -MID\_HD | 4 | Hard Disk (LBA) -MID\_FD720 | 5 | 3.5" 720K Floppy -MID\_FD144 | 6 | 3.5" 1.44M Floppy -MID\_FD360 | 7 | 5.25" 360K Floppy -MID\_FD120 | 8 | 5.25" 1.2M Floppy -MID\_FD111 | 9 | 8" 1.11M Floppy -MID\_HDNEW | 10 | Hard Disk with 1024 Directory entries +MID_NONE | 0 | No media installed +MID_MDROM | 1 | ROM Drive +MID_MDRAM | 2 | RAM Drive +MID_RF | 3 | RAM Floppy (LBA) +MID_HD | 4 | Hard Disk (LBA) +MID_FD720 | 5 | 3.5" 720K Floppy +MID_FD144 | 6 | 3.5" 1.44M Floppy +MID_FD360 | 7 | 5.25" 360K Floppy +MID_FD120 | 8 | 5.25" 1.2M Floppy +MID_FD111 | 9 | 8" 1.11M Floppy +MID_HDNEW | 10 | Hard Disk with 1024 Directory entries ### Function 0x10 -- Disk Status (DIOSTATUS) @@ -950,22 +950,22 @@ possible 16 values for foreground or background: **Foreground** | **Background** | **Color** ------------------ | ------------------ | ---------------- -\_0 \_\_\_\_0000 | 0\_ 0000\_\_\_\_ | Black -\_1 \_\_\_\_0001 | 1\_ 0001\_\_\_\_ | Red -\_2 \_\_\_\_0010 | 2\_ 0010\_\_\_\_ | Green -\_3 \_\_\_\_0011 | 3\_ 0011\_\_\_\_ | Brown -\_4 \_\_\_\_0100 | 4\_ 0100\_\_\_\_ | Blue -\_5 \_\_\_\_0101 | 5\_ 0101\_\_\_\_ | Magenta -\_6 \_\_\_\_0110 | 6\_ 0110\_\_\_\_ | Cyan -\_7 \_\_\_\_0111 | 7\_ 0111\_\_\_\_ | White -\_8 \_\_\_\_1000 | 8\_ 1000\_\_\_\_ | Gray -\_9 \_\_\_\_1001 | 9\_ 1001\_\_\_\_ | Light Red -\_A \_\_\_\_1010 | A\_ 1010\_\_\_\_ | Light Green -\_B \_\_\_\_1011 | B\_ 1011\_\_\_\_ | Yellow -\_C \_\_\_\_1100 | C\_ 1100\_\_\_\_ | Light Blue -\_D \_\_\_\_1101 | D\_ 1101\_\_\_\_ | Light Magenta -\_E \_\_\_\_1110 | E\_ 1110\_\_\_\_ | Light Cyan -\_F \_\_\_\_1111 | F\_ 1111\_\_\_\_ | Bright White +n0 nnnn0000 | 0n 0000nnnn | Black +n1 nnnn0001 | 1n 0001nnnn | Red +n2 nnnn0010 | 2n 0010nnnn | Green +n3 nnnn0011 | 3n 0011nnnn | Brown +n4 nnnn0100 | 4n 0100nnnn | Blue +n5 nnnn0101 | 5n 0101nnnn | Magenta +n6 nnnn0110 | 6n 0110nnnn | Cyan +n7 nnnn0111 | 7n 0111nnnn | White +n8 nnnn1000 | 8n 1000nnnn | Gray +n9 nnnn1001 | 9n 1001nnnn | Light Red +nA nnnn1010 | An 1010nnnn | Light Green +nB nnnn1011 | Bn 1011nnnn | Yellow +nC nnnn1100 | Cn 1100nnnn | Light Blue +nD nnnn1101 | Dn 1101nnnn | Light Magenta +nE nnnn1110 | En 1110nnnn | Light Cyan +nF nnnn1111 | Fn 1111nnnn | Bright White Attribute byte values are constructed using the following bit encoding: @@ -1087,12 +1087,12 @@ The currently defined video device types are: VDA ID | Value | Device ---------- | ----- | ------ -VDA\_NONE | 0x00 | No VDA -VDA\_VDU | 0x10 | ECB VDU board -VDA\_CVDU | 0x20 | ECB Color VDU board -VDA\_7220 | 0x30 | ECB uPD7220 video display board -VDA\_N8 | 0x40 | TMS9918 video display built-in to N8 -VDA\_VGA | 0x50 | ECB VGA board +VDA_NONE | 0x00 | No VDA +VDA_VDU | 0x10 | ECB VDU board +VDA_CVDU | 0x20 | ECB Color VDU board +VDA_7220 | 0x30 | ECB uPD7220 video display board +VDA_N8 | 0x40 | TMS9918 video display built-in to N8 +VDA_VGA | 0x50 | ECB VGA board ### Function 0x44 -- Video Set Cursor Style (VDASCS) @@ -1107,7 +1107,7 @@ VDA\_VGA | 0x50 | ECB VGA board If supported by the video hardware, adjust the format of the cursor such that the cursor starts at the pixel specified in the top nibble of D and -end at the pixel specified in the bottom nibble of D. So, if D=\$08, a +end at the pixel specified in the bottom nibble of D. So, if D=$08, a block cursor would be used that starts at the top pixel of the character cell and ends at the ninth pixel of the character cell. @@ -2150,23 +2150,24 @@ The following section outlines the read only data referenced by the #### TMS9918 Driver: -| Name | Offset | Size (bytes)| Description | -|--------|--------|-------------|-------------| -| PPIA | 0 | 1 | PPI PORT A | -| PPIB | 1 | 1 | PPI PORT B | -| PPIC | 2 | 1 | PPI PORT C | -| PPIX | 3 | 1 | PPI CONTROL PORT | -| DATREG | 4 | 1 | IO PORT ADDRESS FOR MODE 0 | -| CMDREG | 5 | 1 | IO PORT ADDRESS FOR MODE 1 | -| The following are the register mirror values that HBIOS used for initialisation | -| REG. 0 | 6 | 1 | $00 - NO EXTERNAL VID -| REG. 1 | 7 | 1 | $50 or $70 - SET MODE 1 and interrupt if enabled | -| REG. 2 | 8 | 1 | $00 - PATTERN NAME TABLE := 0 -| REG. 3 | 9 | 1 | $00 - NO COLOR TABLE -| REG. 4 | 10 | 1 | $01 - SET PATTERN GENERATOR TABLE TO $800 -| REG. 5 | 11 | 1 | $00 - SPRITE ATTRIBUTE IRRELEVANT -| REG. 6 | 12 | 1 | $00 - NO SPRITE GENERATOR TABLE -| REG. 7 | 13 | 1 | $F0 - WHITE ON BLACK -| DCNTL* | 14 | 1 | Z180 DMA/WAIT CONTROL | +| **Name** | **Offset** | **Bytes** | **Description** | +|--------|----|----|-----------------------| +| PPIA | 0 | 1 | PPI PORT A | +| PPIB | 1 | 1 | PPI PORT B | +| PPIC | 2 | 1 | PPI PORT C | +| PPIX | 3 | 1 | PPI CONTROL PORT | +| DATREG | 4 | 1 | IO PORT ADDRESS FOR MODE 0 | +| CMDREG | 5 | 1 | IO PORT ADDRESS FOR MODE 1 | +| | | | _Below are the register mirror values_ | +| | | | _that HBIOS used for initialisation_ | +| REG. 0 | 6 | 1 | $00 - NO EXTERNAL VID +| REG. 1 | 7 | 1 | $50 or $70 - SET MODE 1 and interrupt if enabled | +| REG. 2 | 8 | 1 | $00 - PATTERN NAME TABLE := 0 | +| REG. 3 | 9 | 1 | $00 - NO COLOR TABLE | +| REG. 4 | 10 | 1 | $01 - SET PATTERN GENERATOR TABLE TO $800 | +| REG. 5 | 11 | 1 | $00 - SPRITE ATTRIBUTE IRRELEVANT | +| REG. 6 | 12 | 1 | $00 - NO SPRITE GENERATOR TABLE | +| REG. 7 | 13 | 1 | $F0 - WHITE ON BLACK | +| DCNTL* | 14 | 1 | Z180 DMA/WAIT CONTROL | * ONLY PRESENT FOR Z180 BUILDS diff --git a/Source/Doc/Build.cmd b/Source/Doc/Build.cmd index f03f1e5e..34316376 100644 --- a/Source/Doc/Build.cmd +++ b/Source/Doc/Build.cmd @@ -37,7 +37,10 @@ echo. echo Processing document %1.md... -gpp -o %1.tmp -U "\\" "" "{" "}{" "}" "{" "}" "#" "" %1.md +::gpp -o %1.tmp %1.md +::gpp -o %1.tmp -U "\\" "" "{" "}{" "}" "{" "}" "#" "" %1.md +::gpp -o %1.tmp -U "" "" "(" "," ")" "(" ")" "#" "" -M "#" "\n" " " " " "\n" "(" ")" %1.md +gpp -o %1.tmp -U "$" "$" "{" "}{" "}$" "{" "}" "@@@" "" -M "$" "$" "{" "}{" "}$" "{" "}" %1.md :: pandoc %1.tmp -f markdown -s -o %1.tex --default-image-extension=pdf || exit /b :: pause @@ -46,9 +49,9 @@ gpp -o %1.tmp -U "\\" "" "{" "}{" "}" "{" "}" "#" "" %1.md :: goto :eof pandoc %1.tmp -f markdown -t pdf -s -o %1.pdf --default-image-extension=pdf || exit /b -pandoc %1.tmp -f markdown -t html -o %1.html --default-image-extension=png || exit /b -pandoc %1.tmp -f markdown -t dokuwiki -o %1.dw --default-image-extension=png || exit /b -pandoc %1.tmp -f markdown -t gfm -o %1.gfm --default-image-extension=png || exit /b -pandoc %1.tmp -f markdown -t plain -o %1.txt --default-image-extension=png || exit /b +pandoc %1.tmp -f markdown -t html -s -o %1.html --default-image-extension=png || exit /b +pandoc %1.tmp -f markdown -t dokuwiki -s -o %1.dw --default-image-extension=png || exit /b +pandoc %1.tmp -f markdown -t gfm -s -o %1.gfm --default-image-extension=png || exit /b +pandoc %1.tmp -f markdown -t plain -s -o %1.txt --default-image-extension=png || exit /b goto :eof \ No newline at end of file diff --git a/Source/Doc/Catalog.md b/Source/Doc/Catalog.md index c0e1d3eb..b070ef2f 100644 --- a/Source/Doc/Catalog.md +++ b/Source/Doc/Catalog.md @@ -1,7 +1,7 @@ -\define{doc_title}{Disk Catalog} -\define{doc_author}{Mykl Orders} -\define{doc_authmail}{} -\include{"Common.h"} +$define{doc_title}{Disk Catalog}$ +$define{doc_author}{Mykl Orders}$ +$define{doc_authmail}{}$ +$include{"Common.h"}$ # RomWBW Distribution File Catalog diff --git a/Source/Doc/Common.h b/Source/Doc/Common.h index 886a203c..5e7708ac 100644 --- a/Source/Doc/Common.h +++ b/Source/Doc/Common.h @@ -1,22 +1,19 @@ -\define{doc_ver}{3.1 Pre-release} -\define{doc_product}{RomWBW} -\ifndef{doc_title} \define{doc_title}{Document Title} \endif -\ifndef{doc_author} \define{doc_author}{Wayne Warthen} \endif -\define{doc_date}{\date{%d %b %Y}} -\ifndef{doc_authmail} \define{doc_authmail}{wwarthen@gmail.com} \endif -\define{doc_orgname}{RetroBrew Computers Group} -\define{doc_orgurl}{www.retrobrewcomputers.org} +$define{doc_ver}{3.1 Pre-release}$ +$define{doc_product}{RomWBW}$ +$ifndef{doc_title}$ $define{doc_title}{Document Title}$ $endif$ +$ifndef{doc_author}$ $define{doc_author}{Wayne Warthen}$ $endif$ +$define{doc_date}{$date{%d %b %Y}$}$ +$ifndef{doc_authmail}$ $define{doc_authmail}{wwarthen@gmail.com}$ $endif$ +$define{doc_orgname}{RetroBrew Computers Group}$ +$define{doc_orgurl}{www.retrobrewcomputers.org}$ --- # Force pandoc to enable graphics for Logo in title page! graphics: true -title: | - | \doc_product \doc_title - | - | Version \doc_ver -author: \doc_author (mailto:\doc_authmail) -date: \doc_date -institution: \doc_orgname +title: $doc_product$ $doc_title$ +author: $doc_author$ (mailto:$doc_authmail$) +date: $doc_date$ +institution: $doc_orgname$ documentclass: book classoption: - oneside @@ -52,14 +49,14 @@ header-includes: \includegraphics[width=\textwidth]{Graphics/Logo.pdf} \par \vfill \raggedleft - {\scshape \bfseries \fontsize{48pt}{56pt} \selectfont \doc_product \par} - {\bfseries \fontsize{32pt}{36pt} \selectfont \doc_title \par} + {\scshape \bfseries \fontsize{48pt}{56pt} \selectfont $doc_product$ \par} + {\bfseries \fontsize{32pt}{36pt} \selectfont $doc_title$ \par} \vspace{24pt} - {\huge Version \doc_ver \\ \doc_date \par} + {\huge Version $doc_ver$ \\ $doc_date$ \par} \vspace{24pt} - {\large \itshape \doc_orgname \\ \href{http://\doc_orgurl}{\doc_orgurl} \par} + {\large \itshape $doc_orgname$ \\ \href{http://$doc_orgurl$}{$doc_orgurl$} \par} \vspace{12pt} - {\large \itshape \doc_author \\ \href{mailto:\doc_authmail}{\doc_authmail} \par} + {\large \itshape $doc_author$ \\ \href{mailto:$doc_authmail$}{$doc_authmail$} \par} \end{titlepage} } \pagestyle{empty} @@ -78,5 +75,5 @@ include-before: ```{=latex} \clearpage \pagenumbering{arabic} -\lhead{\fancyplain{}{\nouppercase{\footnotesize \bfseries \leftmark \hfill \doc_product \doc_title}}} +\lhead{\fancyplain{}{\nouppercase{\footnotesize \bfseries \leftmark \hfill $doc_product$ $doc_title$}}} ``` diff --git a/Source/Doc/GettingStarted.md b/Source/Doc/GettingStarted.md index 3176fcba..e7ba2ea3 100644 --- a/Source/Doc/GettingStarted.md +++ b/Source/Doc/GettingStarted.md @@ -1,14 +1,14 @@ -\define{doc_title}{GettingStarted} -\include{"Common.h"} +$define{doc_title}{Getting Started}$ +$include{"Common.h"}$ # RomWBW ## Z80/Z180 System Software -| Version \doc_ver -| \doc_date +| Version $doc_ver$ +| $doc_date$ -\doc_author [\doc_authmail](mailto:\doc_authmail) +$doc_author$ [$doc_authmail$](mailto:$doc_authmail$) ### Download @@ -1351,4 +1351,4 @@ RetroBrew Computers projects is via the community forums: Submission of issues and bugs are welcome at the [RomWBW GitHub Repository](https://github.com/wwarthen/RomWBW). -Also feel free to email \doc_author at [\doc_authmail](mailto:\doc_authmail). +Also feel free to email $doc_author$ at [$doc_authmail$](mailto:$doc_authmail$). diff --git a/Source/Doc/Makefile b/Source/Doc/Makefile index 6133aaea..e92f986c 100644 --- a/Source/Doc/Makefile +++ b/Source/Doc/Makefile @@ -13,7 +13,7 @@ include $(TOOLS)/Makefile.inc all :: deploy %.tmp : %.md - gpp -o $@ -U "\\" "" "{" "}{" "}" "{" "}" "#" "" $< + gpp -o $@ -U "$" "$" "{" "}{" "}$" "{" "}" "@@@" "" -M "$" "$" "{" "}{" "}$" "{" "}" $< %.pdf : %.tmp pandoc $< -f markdown -t latex -s -o $@ --default-image-extension=pdf diff --git a/Source/Doc/ROM_Applications.md b/Source/Doc/ROM_Applications.md index 0908b32d..abb2a5ac 100644 --- a/Source/Doc/ROM_Applications.md +++ b/Source/Doc/ROM_Applications.md @@ -1,7 +1,7 @@ -\define{doc_title}{ROM Applications} -\define{doc_author}{Phillip Summers} -\define{doc_authmail}{} -\include{"Common.h"} +$define{doc_title}{ROM Applications}$ +$define{doc_author}{Phillip Summers}$ +$define{doc_authmail}{}$ +$include{"Common.h"}$ # Summary diff --git a/Source/Images/d_bp/u15/ldtime7.com b/Source/Images/d_bp/u15/ldtime7.com deleted file mode 100644 index e79603de..00000000 Binary files a/Source/Images/d_bp/u15/ldtime7.com and /dev/null differ diff --git a/Source/Images/d_bp/u15/ldtime9.com b/Source/Images/d_bp/u15/ldtime9.com deleted file mode 100644 index 656f04df..00000000 Binary files a/Source/Images/d_bp/u15/ldtime9.com and /dev/null differ diff --git a/Source/Images/d_bp/u15/ldtimee.com b/Source/Images/d_bp/u15/ldtimee.com deleted file mode 100644 index 95a6e5f7..00000000 Binary files a/Source/Images/d_bp/u15/ldtimee.com and /dev/null differ diff --git a/Source/Images/d_bp/u15/save.com b/Source/Images/d_bp/u15/save.com index 7f12428e..0f6d8352 100644 Binary files a/Source/Images/d_bp/u15/save.com and b/Source/Images/d_bp/u15/save.com differ diff --git a/Source/ver.inc b/Source/ver.inc index 61eac6ca..2c77bb1e 100644 --- a/Source/ver.inc +++ b/Source/ver.inc @@ -2,4 +2,4 @@ #DEFINE RMN 1 #DEFINE RUP 1 #DEFINE RTP 0 -#DEFINE BIOSVER "3.1.1-pre.131" +#DEFINE BIOSVER "3.1.1-pre.132" diff --git a/Source/ver.lib b/Source/ver.lib index 7c8580d2..d12c7674 100644 --- a/Source/ver.lib +++ b/Source/ver.lib @@ -3,5 +3,5 @@ rmn equ 1 rup equ 1 rtp equ 0 biosver macro - db "3.1.1-pre.131" + db "3.1.1-pre.132" endm