From 6fbf5e062f77a85ba6e8eee256f6f454d4e9ab9e Mon Sep 17 00:00:00 2001 From: fvaneijk Date: Sat, 19 Oct 2024 07:04:33 -0400 Subject: [PATCH] add instruction for creation of SD Card cpm image to readme --- README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 48 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e2b52cf..7bde4fa 100644 --- a/README.md +++ b/README.md @@ -43,13 +43,52 @@ UART connected to serial interface 2 of the core. The latter allows to use the c For more details on console connection, refer to the official MiSTer documentation: [MiSTer Console Connection Guide](https://mister-devel.github.io/MkDocs_MiSTer/advanced/console/) - - ## The MiSTer OSD allows the access to four machines: ### Z80 CP/M: You can now use both an external SDCard and/or select the image file within MiSTer. Whatever you like. +### Formatting the SD Card and Installing CP/M + +Note this procedure has to be performed from a tty terminal as descibed above. + +#### Formatting the Drive + +1. Load the Intel-HEX dump of the `FORMAT` program into memory by copying the contents of `FORM128.HEX` (for 128MB SD card utilization) into the terminal window. +2. The `FORMAT` program will reside at memory address `$5000` when loaded. To start the formatting process, execute the program by typing `G5000` and pressing ENTER. +3. You will see the following message: + +``` +CP/M Formatter by G. Searle 2012 +``` + +4. After a few seconds, the formatting process will display: + +``` +ABCDEFGHIJKLMNOP +Formatting complete +``` + +Each drive is 8MB, so a 128MB SD card will have drives labeled A: to P:. + +#### Installing CP/M + +CP/M is installed on the first track of the disk. When booted, the first track is read into memory and executed. To install CP/M, follow these steps: + +1. Load the Intel-HEX dump of CP/M by copying the contents of `CPM22.HEX` into the terminal window (this takes about 10 seconds). +2. Load the Intel-HEX dump of the CBIOS by copying the contents of `CBIOS128.HEX` (for 128MB total drive space) into the terminal window (this takes about 3 seconds). +3. Load the Intel-HEX dump of `PUTSYS` by copying the contents of `PUTSYS.HEX` into the terminal window. + +The `PUTSYS` program also resides at memory address `$5000`. To transfer CP/M and CBIOS to the disk, execute `PUTSYS` by typing `G5000` and pressing ENTER. You will see: + +``` +CP/M System Transfer by G. Searle 2012 +System transfer complete +``` + +At this point, CP/M is installed and ready for boot. You can now proceed with installing applications. + + For convenience you can use the Multicomp FPGA - CP/M Demo Disk from Obsolescence Guaranteed: http://obsolescence.wixsite.com/obsolescence/multicomp-fpga-cpm-demo-disk @@ -65,13 +104,16 @@ RIGHT$, MID$, END, FOR, NEXT, DATA, INPUT, DIM, READ, LET, GOTO, RUN, IF, RESTOR NULL, WAIT, DEF, POKE, DOKE, LINES, CLS, WIDTH, MONITOR, PRINT, CONT, LIST, CLEAR, NEW, TAB, TO, FN, SPC, THEN, NOT, STEP, +, -, *, /, ^, AND, OR, >, <, = -PLUS my additional implementations here (making it version 4.7b): +PLUS additional implementations here (making it version 4.7b): HEX$(nn) - convert a SIGNED integer (-32768 to +32767) to a string containing the hex value -BIN$(nn) - convert a SIGNED integer (-32768 to +32767) to a string containing the binary value -&Hnn - interpret the value after the &H as a HEX value (signed 16 bit) -&Bnn - interpret the value after the &B as a BINARY value (signed 16 bit) +BIN$(nn) - convert a SIGNED integer (-32768 to +32767) to a string containing the binary value + +&Hnn - interpret the value after the &H as a HEX value (signed 16 bit) + +&Bnn - interpret the value after the &B as a BINARY value (signed 16 bit) + ### 6502 Basic - No SD card support (No CSAVE/CLOAD): END, FOR, NEXT, DATA, INPUT, DIM, READ, LET, GOTO, RUN, IF, RESTORE, GOSUB, RETURN, REM, STOP, ON, NULL, WAIT, DEF, POKE, PRINT, CONT, LIST, CLEAR, NEW, TAB(, TO, FN, SPC(, THEN, NOT, STEP, SGN, INT, ABS, USR, FRE, POS, SQR, RND, LOG, EXP, COS, SIN, TAN, ATN,