Skip to content

Commit

Permalink
Minor Release Cleanups
Browse files Browse the repository at this point in the history
  • Loading branch information
wwarthen committed Jan 25, 2025
1 parent de94085 commit 8756937
Show file tree
Hide file tree
Showing 29 changed files with 137 additions and 102 deletions.
Binary file modified Doc/RomWBW Applications.pdf
Binary file not shown.
Binary file modified Doc/RomWBW Disk Catalog.pdf
Binary file not shown.
Binary file modified Doc/RomWBW Hardware.pdf
Binary file not shown.
Binary file modified Doc/RomWBW Introduction.pdf
Binary file not shown.
Binary file modified Doc/RomWBW System Guide.pdf
Binary file not shown.
Binary file modified Doc/RomWBW User Guide.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion ReadMe.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
**RomWBW Introduction** \
Version 3.5 \
Wayne Warthen ([[email protected]](mailto:[email protected])) \
24 Jan 2025
25 Jan 2025

# Overview

Expand Down
2 changes: 1 addition & 1 deletion ReadMe.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
RomWBW Introduction
Wayne Warthen ([email protected])
24 Jan 2025
25 Jan 2025



Expand Down
181 changes: 98 additions & 83 deletions Source/Doc/Hardware.md
Original file line number Diff line number Diff line change
Expand Up @@ -1352,6 +1352,8 @@ program the image into the first 512KB of the ROM for now.

`\clearpage`{=latex}

## Z80 K80W CPU Module

#### ROM Image File: RCZ80_k8w_std.rom

| | |
Expand Down Expand Up @@ -1876,113 +1878,126 @@ program the image into the first 512KB of the ROM for now.
This section briefly describes each of the possible devices that
may be discovered by RomWBW in your system.

## Serial

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| ACIA | Char | MC68B50 Asynchronous Communications Interface Adapter |
| ASCI | Char | Zilog Z180 CPU Built-in Serial Ports |
| DUART | Char | SCC2681 or compatible Dual UART |
| EF | Char | EF9345 Video Display Controller |
| KBD | Keyboard | 8242 PS/2 Keyboard Controller |
| LPT | Char | Parallel I/O Controller |
| MSXKYB | Keyboard | MSX Compliant Matrix Keyboard |
| PIO | Char | Zilog Parallel Interface Controller |
| PPK | Keyboard | Matrix Keyboard |
| PPPCON | Serial | ParPortProp Serial Console Interface |
| PRPCON | Serial | PropIO Serial Console Interface |
| SCON | Char | S100 Console |
| SIO | Char | Zilog Serial Port Interface |
| SSER | Char | Simple Serial Interface |
| UART | Char | 16C550 Family Serial Interface |
| USB-FIFO | Char | FT232H-based ECB USB FIFO |
| Z2U | Char | Zilog Z280 CPU Built-in Serial Ports |
## Character

| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| ACIA | MC68B50 Asynchronous Communications Interface Adapter |
| ASCI | Zilog Z180 CPU Built-in Serial Ports |
| DUART | SCC2681 or compatible Dual UART |
| EF | EF9345 Video Display Controller |
| ESPCON | ESP32 Firmware-based Video Console |
| ESPSER | ESP32 Firmware-based Serial Interface |
| LPT | Parallel I/O Controller |
| PIO | Zilog Parallel Interface Controller |
| PPPCON | ParPortProp Serial Console Interface |
| PRPCON | PropIO Serial Console Interface |
| SCON | S100 Console |
| SIO | Zilog Serial Port Interface |
| SSER | Simple Serial Interface |
| UART | 16C550 Family Serial Interface |
| USB-FIFO | FT232H-based ECB USB FIFO |
| Z2U | Zilog Z280 CPU Built-in Serial Ports |

By default, RomWBW will use the first available character device it
discovers for the initial console. Serial devices are scanned in
the following order:
discovers for the initial console. The following character devices are
scanned in the order shown. The available character devices depend on
the active platform and configuration.

#. SSET: Simple Serial Interface
#. ASCI: Zilog Z180 CPU Built-in Serial Ports
#. Z2U: Zilog Z280 CPU Built-in Serial Ports
#. UART: 16C550 Family Serial Interface
#. DUART: SCC2681 or compatible Dual UART
#. SIO: Zilog Serial Port Interface
#. ACIA: MC68B50 Asynchronous Communications Interface Adapter
#. USB-FIFO: FT232H-based ECB USB FIFO

## Disk

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| CHSD | Disk | CH37x SD Card Interface |
| CHUSB | Disk | CH37x USB Drive Interface |
| EMM | Disk | Disk drive on Parallel Port emm interface (Zip Drive) |
| FD | Disk | 8272 or compatible Floppy Disk Controller |
| HDSK | Disk | SIMH Simulator Hard Disk |
| IDE | Disk | IDE/ATA/ATAPI Hard Disk Interface |
| IMM | Disk | IMM Zip Drive on PPI |
| MD | Disk | ROM/RAM Disk |
| PPA | Disk | PPA Zip Drive on PPI |
| PPIDE | Disk | 8255 IDE/ATA/ATAPI Hard Disk Interface |
| PPPSD | Disk | ParPortProp SD Card Interface |
| PRPSD | Disk | PropIO SD Card Interface |
| RF | Disk | RAM Floppy Disk Interface |
| SD | Disk | SD Card Interface |
| SYQ | Disk | Iomega SparQ Drive on PPI |
| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| CHSD | CH37x SD Card Interface |
| CHUSB | CH37x USB Drive Interface |
| FD | 8272 or compatible Floppy Disk Controller |
| HDSK | SIMH Simulator Hard Disk |
| IDE | IDE/ATA/ATAPI Hard Disk Interface |
| IMM | Zip Drive on PPI (IMM variant) |
| MD | ROM/RAM Disk |
| PPA | Zip Drive on PPI (PPA variant) |
| PPIDE | 8255 IDE/ATA/ATAPI Hard Disk Interface |
| PPPSD | ParPortProp SD Card Interface |
| PRPSD | PropIO SD Card Interface |
| RF | RAM Floppy Disk Interface |
| SD | SD Card Interface |
| SYQ | Iomega SparQ Drive on PPI |

## Video

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| CVDU | Video | MC8563-based Video Display Controller |
| FV | Video | S100 FPGA Z80 Onboard VGA/Keyboard |
| GDC | Video | uPD7220 Video Display Controller |
| TMS | Video | TMS9918/38/58 Video Display Controller |
| VDU | Video | MC6845 Family Video Display Controller |
| VGA | Video | HD6445CP4-based Video Display Controller |
| VRC | Video | VGARC Video Display Controller |
| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| CVDU | MC8563-based Video Display Controller |
| FV | S100 FPGA Z80 Onboard VGA/Keyboard |
| GDC | uPD7220 Video Display Controller |
| TMS | TMS9918/38/58 Video Display Controller |
| VDU | MC6845 Family Video Display Controller |
| VGA | HD6445CP4-based Video Display Controller |
| VRC | VGARC Video Display Controller |

## Keyboard

| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| KBD | 8242 PS/2 Keyboard Controller |
| MSXKYB | MSX Compliant Matrix Keyboard |
| NABUKB | NABU Keyboard |
| PPK | Matrix Keyboard |

## Audio

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| AY | Audio | AY-3-8910/YM2149 Programmable Sound Generator |
| SN76489 | Sound | SN76489 Programmable Sound Generator |
| SPK | Sound | Bit-bang Speaker |
| YM | Audio | YM2612 Programmable Sound Generator |
| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| AY | AY-3-8910/YM2149 Programmable Sound Generator |
| SN76489 | SN76489 Programmable Sound Generator |
| SPK | Bit-bang Speaker |
| YM | YM2612 Programmable Sound Generator |

## RTC (RealTime Clock)

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| BQRTC | RTC | BQ4845P Real Time Clock |
| DS5RTC | RTC | Maxim DS1305 SPI Real-Time Clock w/ NVRAM |
| DS7RTC | RTC | Maxim DS1307 PCF I2C Real-Time Clock w/ NVRAM |
| DS1501RTC | RTC | Maxim DS1501/DS1511 Watchdog Real-Time Clock |
| DSRTC | RTC | Maxim DS1302 Real-Time Clock w/ NVRAM |
| INTRTC | RTC | Interrupt-based Real Time Clock |
| PCF | RTC | PCF8584-based I2C Real-Time Clock |
| RP5C01 | RTC | Ricoh RPC01A Real-Time Clock w/ NVRAM |
| SIMRTC | RTC | SIMH Simulator Real-Time Clock |

## DSKY (DiSplay KeYboard)

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| ICM | DsKy | ICM7218-based Display/Keypad on PPI |
| PKD | DsKy | P8279-based Display/Keypad on PPI |
| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| BQRTC | BQ4845P Real Time Clock |
| DS5RTC | Maxim DS1305 SPI Real-Time Clock w/ NVRAM |
| DS7RTC | Maxim DS1307 PCF I2C Real-Time Clock w/ NVRAM |
| DS1501RTC | Maxim DS1501/DS1511 Watchdog Real-Time Clock |
| DSRTC | Maxim DS1302 Real-Time Clock w/ NVRAM |
| INTRTC | Interrupt-based Real Time Clock |
| PCF | PCF8584-based I2C Real-Time Clock |
| RP5C01 | Ricoh RPC01A Real-Time Clock w/ NVRAM |
| SIMRTC | SIMH Simulator Real-Time Clock |

## DsKy (DiSplay KeYpad)

| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| FP | Simple LED & Switch Front Panel |
| GM7303 | Prolog 7303 derived Display/Keypad |
| H8P | Heath H8 Display/Keypad |
| ICM | ICM7218-based Display/Keypad on PPI |
| LCD | Hitachi HD44780-based LCD Display |
| PKD | P8279-based Display/Keypad on PPI |

## System

| **ID** | **Type** | **Description** |
|-----------|----------|--------------------------------------------------------|
| CH | System | CH375/376 USB Controller |
| CTC | System | Zilog Clock/Timer |
| DMA | System | Zilog DMA Controller |
| FP | System | Simple LED & Switch Front Panel |
| KIO | System | Zilog Serial/ Parallel Counter/Timer |
| LCD | System | Hitachi HD44780-based LCD Display |
| PPP | System | ParPortProp Host Interface Controller |
| PRP | System | PropIO Host Interface Controller |
| **ID** | **Description** |
|-----------|--------------------------------------------------------|
| CH | CH375/376 USB Interface Controller |
| CTC | Zilog Clock/Timer |
| DMA | Zilog DMA Controller |
| ESP | ESP32 Firmware-based interface |
| KIO | Zilog Serial/ Parallel Counter/Timer |
| PPP | ParPortProp Host Interface Controller |
| PRP | PropIO Host Interface Controller |

# UNA Hardware BIOS

Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/GMZ180_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ FPLED_IO .SET $00 ; FP: PORT ADDRESS FOR FP LEDS
LEDENABLE .SET FALSE ; ENABLES STATUS LED (SINGLE LED)
LEDMODE .SET LEDMODE_STD ; LEDMODE_[STD|SC|RTC|NABU]
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
DSRTCENABLE .SET TRUE ; DSRTC: ENABLE DS-1302 CLOCK DRIVER (DSRTC.ASM)
INTRTCENABLE .SET TRUE ; ENABLE PERIODIC INTERRUPT CLOCK DRIVER (INTRTC.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/MK4_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Z180_CLKDIV .SET 1 ; Z180: CHK DIV: 0=OSC/2, 1=OSC, 2=OSC*2
Z180_MEMWAIT .SET 0 ; Z180: MEMORY WAIT STATES (0-3)
Z180_IOWAIT .SET 1 ; Z180: I/O WAIT STATES TO ADD ABOVE 1 W/S BUILT-IN (0-3)
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
UARTENABLE .SET TRUE ; UART: ENABLE 8250/16550-LIKE SERIAL DRIVER (UART.ASM)
SIOENABLE .SET FALSE ; SIO: ENABLE ZILOG SIO SERIAL DRIVER (SIO.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCEZ80_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ CPUOSC .SET 20000000 ; CPU OSC FREQ IN MHZ
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;;
TMSENABLE .SET FALSE ; TMS: ENABLE TMS9918 VIDEO/KBD DRIVER (TMS.ASM)
TMSMODE .SET TMSMODE_MSX ; TMS: DRIVER MODE: TMSMODE_[SCG|N8|MSX|MSXKBD|MSXMKY|MBC|COLECO|DUO|NABU]
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ180_ext_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Z180_IOWAIT .SET 1 ; Z180: I/O WAIT STATES TO ADD ABOVE 1 W/S BUILT-IN (0-3)
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
DSRTCENABLE .SET TRUE ; DSRTC: ENABLE DS-1302 CLOCK DRIVER (DSRTC.ASM)
INTRTCENABLE .SET TRUE ; ENABLE PERIODIC INTERRUPT CLOCK DRIVER (INTRTC.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ180_nat_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Z180_IOWAIT .SET 1 ; Z180: I/O WAIT STATES TO ADD ABOVE 1 W/S BUILT-IN (0-3)
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
DSRTCENABLE .SET TRUE ; DSRTC: ENABLE DS-1302 CLOCK DRIVER (DSRTC.ASM)
INTRTCENABLE .SET TRUE ; ENABLE PERIODIC INTERRUPT CLOCK DRIVER (INTRTC.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ180_z1rcc_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Z180_IOWAIT .SET 1 ; Z180: I/O WAIT STATES TO ADD ABOVE 1 W/S BUILT-IN (0-3)
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
DSRTCENABLE .SET TRUE ; DSRTC: ENABLE DS-1302 CLOCK DRIVER (DSRTC.ASM)
INTRTCENABLE .SET TRUE ; ENABLE PERIODIC INTERRUPT CLOCK DRIVER (INTRTC.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ280_ext_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Z280_INTWAIT .SET 0 ; Z280: INT ACK WAIT STATUS (0-3)
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
UARTENABLE .SET TRUE ; UART: ENABLE 8250/16550-LIKE SERIAL DRIVER (UART.ASM)
Z2UENABLE .SET TRUE ; Z2U: ENABLE Z280 UART SERIAL DRIVER (Z2U.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ280_nat_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Z280_INTWAIT .SET 0 ; Z280: INT ACK WAIT STATUS (0-3)
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
UARTENABLE .SET TRUE ; UART: ENABLE 8250/16550-LIKE SERIAL DRIVER (UART.ASM)
Z2UENABLE .SET TRUE ; Z2U: ENABLE Z280 UART SERIAL DRIVER (Z2U.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ80_easy_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ WDOGIO .SET $6F ; WATCHDOG REGISTER ADR
FPLED_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL LEDS
FPSW_ENABLE .SET TRUE ; FP: ENABLES FRONT PANEL SWITCHES
CRTACT .SET FALSE ; ACTIVATE CRT (VDU,CVDU,PROPIO,ETC) AT STARTUP
VDAEMU_SERKBD .SET 0 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
DSRTCENABLE .SET TRUE ; DSRTC: ENABLE DS-1302 CLOCK DRIVER (DSRTC.ASM)
INTRTCENABLE .SET TRUE ; ENABLE PERIODIC INTERRUPT CLOCK DRIVER (INTRTC.ASM)
Expand Down
2 changes: 1 addition & 1 deletion Source/HBIOS/Config/RCZ80_jbl_std.asm
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@
;
CPUOSC .SET 3686400 ; CPU OSC FREQ IN MHZ
;
VDAEMU_SERKBD .SET 1 ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
VDAEMU_SERKBD .SET $FF ; VDA EMULATION: SERIAL KBD UNIT #, OR $FF FOR HW KBD
;
DUARTENABLE .SET FALSE ; DUART: ENABLE 2681/2692 SERIAL DRIVER (DUART.ASM)
;
Expand Down
Loading

0 comments on commit 8756937

Please sign in to comment.