diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index 56c7dfd1..6563a185 100644 Binary files a/Doc/RomWBW Applications.pdf and b/Doc/RomWBW Applications.pdf differ diff --git a/Doc/RomWBW Disk Catalog.pdf b/Doc/RomWBW Disk Catalog.pdf index 401fd823..e26862f5 100644 Binary files a/Doc/RomWBW Disk Catalog.pdf and b/Doc/RomWBW Disk Catalog.pdf differ diff --git a/Doc/RomWBW Hardware.pdf b/Doc/RomWBW Hardware.pdf index 5343fe8b..4379b959 100644 Binary files a/Doc/RomWBW Hardware.pdf and b/Doc/RomWBW Hardware.pdf differ diff --git a/Doc/RomWBW Introduction.pdf b/Doc/RomWBW Introduction.pdf index ca08a5b9..6753e46c 100644 Binary files a/Doc/RomWBW Introduction.pdf and b/Doc/RomWBW Introduction.pdf differ diff --git a/Doc/RomWBW System Guide.pdf b/Doc/RomWBW System Guide.pdf index e165e668..988c44df 100644 Binary files a/Doc/RomWBW System Guide.pdf and b/Doc/RomWBW System Guide.pdf differ diff --git a/Doc/RomWBW User Guide.pdf b/Doc/RomWBW User Guide.pdf index 70678054..cbcfb3f4 100644 Binary files a/Doc/RomWBW User Guide.pdf and b/Doc/RomWBW User Guide.pdf differ diff --git a/ReadMe.md b/ReadMe.md index 2d4e5ff3..f487c156 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -7,7 +7,7 @@ **RomWBW Introduction** \ Version 3.6 \ Wayne Warthen ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \ -20 Jul 2025 +22 Jul 2025 # Overview diff --git a/ReadMe.txt b/ReadMe.txt index d5775277..ef5dbc91 100644 --- a/ReadMe.txt +++ b/ReadMe.txt @@ -1,6 +1,6 @@ RomWBW Introduction Wayne Warthen (wwarthen@gmail.com) -20 Jul 2025 +22 Jul 2025 diff --git a/Source/Apps/Tune/hbios.inc b/Source/Apps/Tune/hbios.inc index a7d3351e..e56a67c8 100644 --- a/Source/Apps/Tune/hbios.inc +++ b/Source/Apps/Tune/hbios.inc @@ -7,6 +7,6 @@ BF_SND .EQU $50 BF_SNDRESET .EQU BF_SND + 0 ; RESET SOUND SYSTEM BF_SNDVOL .EQU BF_SND + 1 ; REQUEST SOUND VOL - L CONTAINS VOLUME (255 MAX, 0 SILENT) - SCALED AS REQUIRED BY DRIVER (EG: MAPS TO JUST 4 BIT RESOLUTION FOR SN76489) BF_SNDPRD .EQU BF_SND + 2 ; REQUEST SOUND PERIOD - HL CONTAINS DRIVER SPECIFIC VALUE -BF_SNDNOTE .EQU BF_SND + 3 ; REQUEST NOTE - L CONTAINS NOTE - EACH VALUE IS AN EIGHTH NOTE +BF_SNDNOTE .EQU BF_SND + 3 ; REQUEST NOTE - L CONTAINS NOTE - EACH VALUE IS AN EIGHTH TONE BF_SNDPLAY .EQU BF_SND + 4 ; INITIATE THE REQUESTED SOUND COMMAND BF_SNDQUERY .EQU BF_SND + 5 ; E IS SUBFUNCTION diff --git a/Source/Doc/SystemGuide.md b/Source/Doc/SystemGuide.md index 67152ee1..872de57d 100644 --- a/Source/Doc/SystemGuide.md +++ b/Source/Doc/SystemGuide.md @@ -2277,8 +2277,8 @@ using values that correspond to musical notes. The frequency will be applied when the next SNDPLAY function is invoked. The returned Status (A) is a standard HBIOS result code. -The Note (HL) values correspond to eighth notes. Increasing/decreasing -the value by 8 results in a full note increment/decrement. +The Note (HL) values correspond to eighth tones. Increasing/decreasing +the value by 8 results in a full tone increment/decrement. Increasing/decreasing the value by 48 results in a full octave increment/decrement. The value 0 corresponds to Bb/A# in octave 0. @@ -2286,7 +2286,7 @@ The sound chip resolution and its oscillator limit the range and accuracy of the notes played. The typical range of the AY-3-8910 is six octaves: Bb2/A#2 to A7, where each value is a unique tone. Values above and below can still be played but each eighth tone step may not result -in a note change. +in a tone change. The following table shows the mapping of the Note (HL) value to the corresponding octave and note. @@ -2505,9 +2505,8 @@ If the Unit specified is not a hard disk the Media ID will be returned and the slice parameter ignored. If there is no media in device, or the slice number is invaid (Parameter Out Of Range) the function will return an error status. -**NOTE: -This function was placed in HBIOS to be shared between the diffeent CP/M -varients supported by RomWBW. It is not strictly a BIOS function, +**NOTE:** This function was placed in HBIOS to be shared between the different CP/M +variants supported by RomWBW. It is not strictly a BIOS function, and may be moved in future. `\clearpage`{=latex} diff --git a/Source/HBIOS/audio.inc b/Source/HBIOS/audio.inc index 91352a3e..11021c49 100644 --- a/Source/HBIOS/audio.inc +++ b/Source/HBIOS/audio.inc @@ -45,8 +45,8 @@ AUD_SCALE .EQU 3 ; ON ENTRY, DE IS ADDRESS OF NOTE TABLE, HL IS NOTE TO PLAY ; NOTE VALUE 0 MEANS B0b/A0# IN OCTAVE 0 WHICH IS THE FIRST ENTRY ; OF THE NOTE TABLE. THE NOTE TABLE REPRESENTS THE FREQUENCIES -; FOR 1 FULL OCTAVE IN EIGHTH NOTES. SINCE THERE ARE 12 NOTES -; IN AN OCTAVE, THE TABLE HAS 48 ENTRIES FOR ALL QUARTER NOTES. +; FOR 1 FULL OCTAVE IN EIGHTH TONES. SINCE THERE ARE 12 HALF TONES +; IN AN OCTAVE, THE TABLE HAS 48 ENTRIES FOR ALL EIGHTH TONES. ; ; ON EXIT, HL CONTAINS THE PERIOD VALUE TO PROGRAM INTO THE PSG ; DERIVED FROM THE NOTE TABLE SCALED TO THE REQUESTED OCTAVE. diff --git a/Source/HBIOS/ay38910.asm b/Source/HBIOS/ay38910.asm index 072c1176..228e01d0 100644 --- a/Source/HBIOS/ay38910.asm +++ b/Source/HBIOS/ay38910.asm @@ -559,7 +559,7 @@ AYT_REGWR .DB "\r\nOUT AY-3-8910 $" ; EIGHTH TONE FREQUENCY TABLE ;====================================================================== ; -; THE FOLLOWING TABLE MAPS A FULL OCTAVE OF EIGHTH-NOTES +; THE FOLLOWING TABLE MAPS A FULL OCTAVE OF EIGHTH-TONES ; STARTING AT A# IN OCTAVE 0 TO THE CORRESPONDING PERIOD ; VALUE TO USE ON THE PSG TO ACHIEVE THE DESIRED NOTE FREQUENCY. ; diff --git a/Source/HBIOS/hbios.inc b/Source/HBIOS/hbios.inc index c58fbf39..50fc8be7 100644 --- a/Source/HBIOS/hbios.inc +++ b/Source/HBIOS/hbios.inc @@ -71,7 +71,7 @@ BF_SND .EQU $50 BF_SNDRESET .EQU BF_SND + 0 ; RESET SOUND SYSTEM BF_SNDVOL .EQU BF_SND + 1 ; REQUEST SOUND VOL - L CONTAINS VOLUME (255 MAX, 0 SILENT) - SCALED AS REQUIRED BY DRIVER (EG: MAPS TO JUST 4 BIT RESOLUTION FOR SN76489) BF_SNDPRD .EQU BF_SND + 2 ; REQUEST SOUND PERIOD - HL CONTAINS DRIVER SPECIFIC VALUE -BF_SNDNOTE .EQU BF_SND + 3 ; REQUEST NOTE - L CONTAINS NOTE - EACH VALUE IS AN EIGHTH NOTE +BF_SNDNOTE .EQU BF_SND + 3 ; REQUEST NOTE - L CONTAINS NOTE - EACH VALUE IS AN EIGHTH TONE BF_SNDPLAY .EQU BF_SND + 4 ; INITIATE THE REQUESTED SOUND COMMAND BF_SNDQUERY .EQU BF_SND + 5 ; E IS SUBFUNCTION BF_SNDDURATION .EQU BF_SND + 6 ; REQUEST DURATION HL MILLISECONDS diff --git a/Source/HBIOS/sn76489.asm b/Source/HBIOS/sn76489.asm index 64f5f30a..a9f1ffe3 100644 --- a/Source/HBIOS/sn76489.asm +++ b/Source/HBIOS/sn76489.asm @@ -455,7 +455,7 @@ SNT_REGWR .DB "\r\nOUT SN76489, $" ; EIGHTH TONE FREQUENCY TABLE ;====================================================================== ; -; THE FOLLOWING TABLE MAPS A FULL OCTAVE OF EIGHTH-NOTES +; THE FOLLOWING TABLE MAPS A FULL OCTAVE OF EIGHTH-TONES ; STARTING AT A# IN OCTAVE 0 TO THE CORRESPONDING PERIOD ; VALUE TO USE ON THE PSG TO ACHIEVE THE DESIRED NOTE FREQUENCY. ; diff --git a/Source/HBIOS/spk.asm b/Source/HBIOS/spk.asm index eecb7b9f..d754aceb 100644 --- a/Source/HBIOS/spk.asm +++ b/Source/HBIOS/spk.asm @@ -118,7 +118,7 @@ SP_NOTE: AND 00000011B ; TO THE ASSOCIATED ENTRY JR Z,SP_NOTE1 ; IN THE TUNE TABLE. ; - LD HL,$FFFF ; EIGHTH NOTES + LD HL,$FFFF ; EIGHTH TONES JR SP_NOTE2 ; NOT SUPPORTED ; SP_NOTE1: diff --git a/Source/HBIOS/ym2612.asm b/Source/HBIOS/ym2612.asm index 018729d6..0516ef42 100644 --- a/Source/HBIOS/ym2612.asm +++ b/Source/HBIOS/ym2612.asm @@ -245,11 +245,11 @@ YM_NOTE: ;CALL PRTHEXWORDHL LD DE,40 ; Calculate the ym2612 block (octave) ADD HL,DE ; This will go into b13-b11 LD DE,48 ; HL / DE - CALL DIV16 ; BC = block (octave) HL = quarter semitone note + CALL DIV16 ; BC = block (octave) HL = quarter semitone ; ADD HL,HL LD DE,ym_notetable ; point HL to frequency entry - ADD HL,DE ; for the quarter semitone note + ADD HL,DE ; for the quarter semitone ;CALL PRTHEXWORDHL ;CALL PC_COLON