From 25c752a2deca4a5357ce111844aa085001e127b6 Mon Sep 17 00:00:00 2001
From: b1ackmai1er <difficultylevelhigh@gmail.com>
Date: Mon, 13 Sep 2021 21:23:05 +0800
Subject: [PATCH] Doc updates

---
 Source/Doc/ROM_Applications.md | 50 ++++++++++++++++++++++++++++++++++
 Source/HBIOS/dbgmon.asm        |  2 +-
 Source/HBIOS/dsky.asm          |  2 +-
 Source/HBIOS/dskyng.asm        |  2 +-
 4 files changed, 53 insertions(+), 3 deletions(-)

diff --git a/Source/Doc/ROM_Applications.md b/Source/Doc/ROM_Applications.md
index 071abe5d..956ff83f 100644
--- a/Source/Doc/ROM_Applications.md
+++ b/Source/Doc/ROM_Applications.md
@@ -58,6 +58,7 @@ Memory Area | Function
 ------------|-----------------------------------
 `0000-00FFh`| Jump and restart (RST) vectors
 `0100-01FFh`| HBIOS configuration block
+`EF00-FDFFh`| MONITOR
 `FE00-FFFFh`| HBIOS proxy
 
 Commands can be entered at the command prompt `>` 
@@ -94,6 +95,7 @@ O xxxx yy            - Output value yy to port xxxx
 P xxxx               - Program RAM at address xxxx
 R xxxx [[yy] [zzzz]] - Run code at address xxxx
                        Pass yy and zzzz to register A and BC
+T xxxx	             - X-modem transfer to memory location xxxx
 S xx                 - Set bank to xx
 X                    - Exit monitor
 ```
@@ -215,6 +217,43 @@ Monitor is saved on the stack so the program can return
 to the monitor. On return to the monitor, the contents of
 the A, HL, DE and BC registers are displayed.
 
+## Set bank
+
+S xx - Change the bank in memory to xx. Memory addresses
+0000-7FFF (i.e. bottom 32k) are affected. Because the
+interrupt vectors are stored in the bottom page of this
+range, this function is disable when interrupt mode 1 is
+being used (IM1). Interrupt mode 2 is not affected as the
+associated jump vectors are stored in high memory. 
+
+Changing the bank also impacts the restart vectors (RST),
+so executing code that call the HBIOS using the RST 08
+assembly code will not work.
+
+The monitor stack resides in high memory and is not affected
+but any code that changes the stack to low memory will be
+affected.
+
+### Bank codes and descriptions
+
+TYPE | DESCRIPTION        |BANK| DETAILS
+-----|--------------------|----|-----------
+RAM  | COMMON BANK        | 8E |
+RAM  | USER BANK          | 8D |
+RAM  | BIOS BANK          | 8C |
+RAM  | AUX BANK           | 8B |
+RAM  | RAM DRIVE END	  | 8A | LAST BANK
+RAM  | RAM DRIVE START    | ?? | 512K SYSTEM
+RAM  | RAM DRIVE START    | ?? | 1024K SYSTEM
+ROM  | BOOT BANK          | 00 |
+ROM  | LOADER & IMAGES    | 01 | MONITOR, FORTH
+ROM  | ROM IMAGES CONTD.  | 02 | BASIC, ETC
+ROM  | FAT FILESYSTEM     | 03 |
+ROM  | NETWORK BOOT       | 04 |
+ROM  | ROM DRIVE START    | 05 |
+ROM  | ROM DRIVE END      | 0F | 512K
+ROM  | ROM DRIVE END      | 1F | 1024K
+
 ## NOTES:
 
 The RTC utility on the CP/M ROM disk provides facilities
@@ -222,6 +261,17 @@ to manipulate the Real Time Clock non-volatile Memory.
 Use the C or Z option from the Boot Loader to load CP/M 
 and then run RTC to see the options list.
 
+# X-modem transfer
+
+T xxxx - Receive an X-modem file transfer and load it into
+memory starting at location xxxx. 
+
+128 byte blocks and checksum mode is the only supported 
+protocol.
+
+If the monitor is assembled with the DSKY functionality,
+this feature will be exclude due to space limitions.
+
 # FORTH
 
 CamelForth is the version of Forth included as part of the boot
diff --git a/Source/HBIOS/dbgmon.asm b/Source/HBIOS/dbgmon.asm
index 0fb680df..7467519f 100644
--- a/Source/HBIOS/dbgmon.asm
+++ b/Source/HBIOS/dbgmon.asm
@@ -68,7 +68,7 @@ UART_ENTRY:
 ; P XXXX		- PROGRAM RAM STARTING AT XXXX, PROMPT FOR VALUES
 ; R XXXX		- RUN A PROGRAM AT ADDRESS XXXX
 ; S XX			- SET ACTIVE BANK TO XX
-; T xxxx 		- X-MODEM TRANSFER TO MEMORY LOCATION XXXX
+; T XXXX 		- X-MODEM TRANSFER TO MEMORY LOCATION XXXX
 ; X			- EXIT MONITOR
 ;
 ;__COMMAND_PARSE______________________________________________________________
diff --git a/Source/HBIOS/dsky.asm b/Source/HBIOS/dsky.asm
index 8b577ce2..35cf176d 100644
--- a/Source/HBIOS/dsky.asm
+++ b/Source/HBIOS/dsky.asm
@@ -1,6 +1,6 @@
 ;
 ;==================================================================================================
-; DSKY ROUTINES
+; DSKY (DISPLAY AND KEYBOARD) ROUTINES 
 ;==================================================================================================
 ;
 ; THE DSKY MAY COSESIDE ON THE SAME PPI BUS AS A PPISD.  IT MAY NOT
diff --git a/Source/HBIOS/dskyng.asm b/Source/HBIOS/dskyng.asm
index 4fb46adb..fde11a51 100644
--- a/Source/HBIOS/dskyng.asm
+++ b/Source/HBIOS/dskyng.asm
@@ -1,6 +1,6 @@
 ;
 ;==================================================================================================
-; DSKY NEXT GEN ROUTINES
+; DSKYNG (DISPLAY AND KEYBOARD NEXT GENERATION) ROUTINES
 ;==================================================================================================
 ;
 ; A DSKYNG CAN SHARE A PPI BUS WITH EITHER A PPIDE OR PPISD.