From b32537905039d94d64a404f0bd2c4234553c53eb Mon Sep 17 00:00:00 2001 From: acn Date: Wed, 18 Mar 2020 13:10:01 +0100 Subject: [PATCH] Added first RomWBW App help files --- romwbw/01assign.help | 54 +++++++++++++++++++++++ romwbw/02mode.help | 47 ++++++++++++++++++++ romwbw/03syscopy.help | 22 ++++++++++ romwbw/04talk.help | 17 ++++++++ romwbw/05fat.help | 99 +++++++++++++++++++++++++++++++++++++++++++ romwbw/06tune.help | 37 ++++++++++++++++ 6 files changed, 276 insertions(+) create mode 100644 romwbw/01assign.help create mode 100644 romwbw/02mode.help create mode 100644 romwbw/03syscopy.help create mode 100644 romwbw/04talk.help create mode 100644 romwbw/05fat.help create mode 100644 romwbw/06tune.help diff --git a/romwbw/01assign.help b/romwbw/01assign.help new file mode 100644 index 0000000..a50c5c2 --- /dev/null +++ b/romwbw/01assign.help @@ -0,0 +1,54 @@ + + ///1ASSIGN + + Syntax: + + ASSIGN D:[=[{D:|[]:[]}]][,...] + + Explanation: + + Using the ASSIGN command, on a RomWBW system the drive + letter assignments can be listed or changed. + + Drive letters can be swapped, assigned to devices or slices + or unassigned. + + Multiple (un)assignments can be concatenated using commas. + + A device or slice can only be assigned to a single drive + letter. + + Author: + + Wayne Warthen (wwarthen@gmail.com) + + ///2Examples + + A>ASSIGN + + Display all active drive assignments + + A>ASSIGN /? + + Display version and usage + + A>ASSIGN /L + + Display all possible devices + + A>ASSIGN C:=D: + + Swaps C: and D: + + A>ASSIGN C:=FD0: + + Assign C: to floppy unit 0 + + A>ASSIGN C:=IDE0:1,D:=IDE0:2,E:=FD0: + + Assign C: to IDE unit0, slice 1, D: to IDE unit0, slice2 + and E: to floppy unit 0 + + A>ASSIGN C:= + + Unassign C: diff --git a/romwbw/02mode.help b/romwbw/02mode.help new file mode 100644 index 0000000..a6a5969 --- /dev/null +++ b/romwbw/02mode.help @@ -0,0 +1,47 @@ + + ///1MODE + + Syntax: + + MODE /? + MODE COM: + [[,[,[,]]]] [/P] + + Explanation: + + MODE is used to display and/or modify the configuration + of a serial device of a RomWBW system. + + is numerical baudrate + is (N)one, (O)dd, (E)ven, (M)ark, or (S)pace + is number of data bits, typically 7 or 8 + is number of stop bits, typically 1 or 2 + /P prompts the user prior to setting new configuration + + Notes: + + Parameters not provided will remain unchanged. + The device must support the specified configuration. + + Author: + + Wayne Warthen (wwarthen@gmail.com) + + ///2Examples + + A>MODE /? + + Display command usage + + A>MODE + + Display configuration of all serial ports + + A>MODE COM0: + + Display configuration of serial unit 0 + + A>MODE COM1: 9600,N,8,1 + + Set serial unit 1 configuration + diff --git a/romwbw/03syscopy.help b/romwbw/03syscopy.help new file mode 100644 index 0000000..d9520f7 --- /dev/null +++ b/romwbw/03syscopy.help @@ -0,0 +1,22 @@ + + ///1SYSCOPY + + Syntax: + + SYSCOPY [=] + + Explanation: + + SYSCOPY is used to copy a system image to or from the re- + served tracks of a disk on a RomWBW system. + + This is used for RomWBW adaptions of CP/M 2.2 and CP/M 3. + + and may be a drive or a file reference + + If is not specified, the system image will be read + from the current drive + + Author: + + Wayne Warthen (wwarthen@gmail.com) diff --git a/romwbw/04talk.help b/romwbw/04talk.help new file mode 100644 index 0000000..7dda7bb --- /dev/null +++ b/romwbw/04talk.help @@ -0,0 +1,17 @@ + + ///1TALK + + Syntax: + + TALK TTY:|CRT:|BAT:|UC1: + + Explanation: + + TALK is a minimal tool to talk directly to a character + device. + + Use Ctrl+Z to exit TALK. + + Author: + + Wayne Warthen (wwarthen@gmail.com) diff --git a/romwbw/05fat.help b/romwbw/05fat.help new file mode 100644 index 0000000..628dac9 --- /dev/null +++ b/romwbw/05fat.help @@ -0,0 +1,99 @@ + + ///1FAT + + Syntax: + + FAT DIR + FAT COPY + FAT REN + FAT DEL [|] + FAT MD + FAT FORMAT + + CP/M filespec: :FILENAME.EXT ( is CP/M drive letter) + FAT filespec: :/DIR/FILENAME.EXT ( is device #) + + Explanation: + + FAT is used to manipulate and exchange files with a FAT + (DOS) filesystem. It runs on any HBIOS hosted CP/M implemen- + tation. + + The first parameter defines the action to perform on the FAT + filesystem. + + Author: + + Wayne Warthen (wwarthen@gmail.com) + + ///2Examples + + A>FAT DIR 2:/ + + Shows the root directory of device 2 + + A>FAT COPY C:TEXT.TXT 2:/BOOK/ + + Copy the file TEXT.TXT from CP/M drive C: to the directory + /BOOK on device 2. + + A>FAT COPY 2:/BOOK/TEXT.TXT C: + + Vice versa + + A>FAT REN + A>FAT DEL + A>FAT MD + A>FAT FORMAT + (not yet finished) + + ///3Notes + + Partitioned or non-partitioned media is handled automatical- + ly. A floppy drive is a good example of a non-partitioned + FAT filesystem and will be recognized. Larger media will + typically have a partition table which will be recognized by + the application to find the FAT filesystem. + + Although RomWBW-style CP/M media does not know anything + about partition tables, it is entirely possible to have + media that has both CP/M and FAT file systems on it. This + is accomplished by creating a FAT filesystem on the media + that starts on a track beyond the last track used by CP/M. + Each CP/M slice on a media will occupy a little over 8MB. + So, make sure to start your FAT partition beyond + (slice count) * 8MB. + + The application infers whether you are attempting to refer- + ence a FAT or CP/M filesystem via the drive specifier (char + before ':'). + A numeric drive character specifies the HBIOS disk unit num- + ber for FAT access. An alpha (A-P) character indicates a + CP/M file system access targeting the specified drive let- + ter. If there is no drive character specified, the current + CP/M filesystem and current CP/M drive is assumed. + For example: + + 2:README.TXT refers to FAT file README.TXT on disk unit #2 + C:README.TXT refers to CP/M file README.TXT on CP/M drive C + README.TXT refers to README.TXT on current CP/M drive + + Files with SYS, HIDDEN, or R/O only attributes are not given + any special treatment. Such files are found and processed + like any other file. However, any attempt to write to a + read-only file will fail and the application will abort. + + It is not currently possible to reference CP/M user areas + other than the current user. To copy files to alternate user + areas, you must switch to the desired user number first or + use an additional step to copy the file to the desired user + area. + + Accessing FAT filesystems on a floppy requires the use of + RomWBW HBIOS v2.9.1-pre.13 or greater. + + Files written are not verified. + + Wildcard matching in FAT filesystems is a bit unusual as im- + plemented by FatFs. See FatFs documentation. + diff --git a/romwbw/06tune.help b/romwbw/06tune.help new file mode 100644 index 0000000..37892cb --- /dev/null +++ b/romwbw/06tune.help @@ -0,0 +1,37 @@ + + ///1TUNE + + Syntax: + + TUNE + + Explanation: + + TUNE plays PT2/PT3/MYM sound files. + + of sound file to load and play + Filename extension determines file type + (.PT2, .PT3, or .MYM) + + Notes: + + - Supports AY-3-8910, YM2149, etc. + - Max Z80 CPU clock is about 8 MHz or sound chip will not + handle speed. + - Higher CPU clock speeds are possible on Z180 because extra + I/O wait states are added during I/O to sound chip. + - Uses hardware timer support on systems that support a timer. + Otherwise, a delay loop calibrated to CPU speed is used. + - Delay loop is calibrated to CPU speed, but it does not com- + pensate for time variations in each quark loop resulting + from data decompression. + An average quark processing time is assumed in each loop. + - Most sound files originally targeted MSX or ZX Spectrum + which used 1.7897725 MHz and 1.773400 MHz respectively for + the PSG clock. For best sound playback, PSG should be run at + approx. this clock rate. + + Author: + + Wayne Warthen (wwarthen@gmail.com) +