home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / ftp.demon.co.uk-pub-cpm / amstrad / du51.arc / DU51.DOC < prev    next >
Text File  |  1993-12-23  |  14KB  |  302 lines
  1. DU formatter v5.01 and DU51CON                     J. Elliott, 23 December 1993.
  2. ================================================================================
  3.   The DU51 formatter is a menu-driven disc formatter for the Amstrad PCW, CPC
  4. and Spectrum +3 computers. Features of DU51 are:
  5.  
  6. ╝ 15 different formats;
  7. ╝ CP/M and DOS discs can be formatted;
  8. ╝ Discs can be initialised for timestamping, removing the need for INITDIR;
  9. ╝ Disc names can be specified;
  10. ╝ Disc drives can be set to accept fixed formats - for example, formats which
  11.   CP/M does not automatically recognise.
  12. ╝ Support for drive renaming and Cirtech hard discs.
  13. ╝ Disc boot sectors can be saved as files.
  14.  
  15.   To use DU51, type the command:
  16.  
  17. DU51                   - if your floppy drives are A: and B:
  18. DU51 /G                - if you have a Gem hard drive
  19. DU51 /I                - if you have an InSyder hard drive
  20. DU51 { /A:d } { /B:d } - if your floppy drives have been renamed by MAPDRIVE.
  21.                         For example, if you had renamed A: to O: and B: to P:,
  22.                         then the command to type would have been DU51 /A:O /B:P.
  23.  
  24. The DU51 main screen will then appear.
  25.   The menu system is designed to be familiar to those who have used LocoScript,
  26. ALTER, or the +3 menu system. A highlighted bar will appear over a list of
  27. options, and it can be moved with the up and down cursor keys.
  28.   There are three option types:
  29.  
  30. Command options. Move the bar over the option and press ENTER to execute.
  31.  
  32. Input options - recognisable by the text cursor which appears in the menu bar.
  33.                Type the input and press ENTER afterwards. To abandon the
  34.                input, move the bar off the option using the cursor keys.
  35.  
  36. Settings options - recognisable by the ╗ or ╝ at the beginning of the line.
  37.                To change a Setting, move the bar over the option and press
  38.                the spacebar. ╗ means the option is not set. ╝ means it is.
  39.                PCW users can also use the [+] and [-] keys in the usual way.
  40.  
  41.   When the menu bar is over a Command or Settings option, shortcut keys are
  42. effective. These make the bar jump to a particular option. For example, in
  43. the format selection menu, the shortcut keys are shown on the left-hand side.
  44. Often the shortcut for an option is its first letter.
  45.  
  46.   The screen has three lines at the top in reverse video:
  47.  
  48.   The top line holds general information about the state of the drives. A "Fixed
  49. Format" drive can only recognise discs of one format; an "Auto Select" drive
  50. can recognise more than one type . If a drive name appears after the message
  51. "Using" then the disc shouldn't be taken out of the drive.
  52.   The lower two lines hold information specific to a particular activity.
  53. This might be a list of valid keypresses or information about what the computer
  54. is doing.
  55.  
  56. When the main screen appears, there are four options:
  57.  
  58. 1=Select Disc Type
  59. 2=Format Disc
  60. 3=Save Boot Sector to File
  61.   Exit to CP/M.
  62.  
  63. 1=Select Disc Type
  64. ------------------
  65.  
  66.   You will be asked which drive to use; then whether it should be "auto
  67. selecting" or "fixed format". The main reasons for using a fixed format are:
  68. (i)   To use a format (eg 792k format) which CP/M can't read automatically;
  69. (ii)  To use a CP/M sector editor (eg DU87) on a DOS disc;
  70. (iii) Option 3 (Save Boot Sector) needs to use a fixed format.
  71.   If you chose "fixed format" you will then be shown a menu of all possible
  72. formats. If you choose a DOS format, you will actually be given a fixed CP/M
  73. format which is close enough to the DOS format to allow the use of sector
  74. editors etc.
  75.   If, from this menu, you choose a 40-track format, you may then be asked about
  76. a "format option". This will be "Single track" 99% of the time; "Double track"
  77. has been included for mainly historical reasons - see "Double Track Discs"
  78. later.
  79.  
  80. 2=Format Disc
  81. -------------
  82.   You will be asked which drive to use; then which format. If you choose a
  83. 40-track format, you may then be asked whether the drive is Single or Double
  84. Track. If a drive can read 720k discs, it is Double Track; otherwise it is
  85. Single Track.
  86.   Then, insert the disc and wait. After the main part of formatting is complete,
  87. you may be asked whether the disc should be initialised for date-stamping. Only
  88. CP/M and +3DOS support date-stamped discs (and +3DOS doesn't actually set the
  89. date or time). Note that if you select this option, you will still need to use
  90. SET to turn on datestamping.
  91.   Finally, you will be asked whether the disc should have a label. Labels appear
  92. at the top of the LocoScript Disc Manager, and in DOS directories. They are also
  93. used by some PD disc cataloguing programs.
  94.  
  95.   Discs formatted by DU51 cannot be used to boot CP/M or DOS (but see the
  96. instructions for DU51CON below).
  97.  
  98. 3=Save Boot Sector
  99. ------------------
  100.   You should have set the drive whose bootsector you want to save to the
  101. correct fixed format. The computer will read the bootsector and save it as a
  102. conventional file.
  103. ________________________________________________________________________________
  104.  
  105. Formats
  106. -------
  107.   When using discs in non-standard formats, even if they do auto-detect, it is
  108. wise to reset the disc drive by typing RESET in BASIC or ^C (STOP) in CP/M. It
  109. is not a good idea to change discs at the * prompt of PIP (for example).
  110. DISCKIT may not recognise non-standard formats.
  111.  
  112.   It is not possible to supply a version of DU51 that makes auto-booting discs,
  113. due the fact that different computers use the same format but different boot
  114. sectors. However, you can use DU51CON to copy the boot sectors from your
  115. start-of-day disc into the program DU51, so that DU51 will make auto-booting
  116. discs.
  117.  
  118. Supplied formats are:
  119.  
  120. 1. PCW 8256 CF2
  121.     As made by DISCKIT, f2=Disc, +3DOS FORMAT etc. You can't boot from them (but
  122.   see DU51CON below).
  123. 2. CPC Data
  124.     You get 178k per side rather than 173k, with no catches, but you can't boot
  125.   from them under any circumstances.
  126. 3. CPC System
  127.     Only really of use for a CPC.
  128. 4. IBM Format
  129.     8 sectors per track instead of 9. If you format a 5¿" disc in this format,
  130.   you may be able to read it on a PC running DOS Plus.
  131. 5. Large directory CF2
  132.     You get 192 directory entries instead of 64, in case you want to store a lot
  133.   of 1k files.
  134. 6. Standard XCF2
  135.     You get 192k per disc instead of 173k, and 96 directory entries.
  136. 7. Large Directory XCF2
  137.     You get 189k per disc, and 192 directory entries.
  138. 8. XCF2 with no system track
  139.     You get 198k per disc, but the disc will not auto-detect, so you have to use
  140.   "fixed format".
  141. 9. PCW 9000 CF2DD
  142.     Standard 706k disc. Can be copied by DISCKIT, f2=Disc etc. If you use
  143.   DU51CON, you will be able to boot from these discs.
  144. A. QUAD with no system track and a small directory.
  145.     Very similar to CF2DD, but there is 716k per disc, not 706k, and only 128
  146.   directory entries. The disc will not auto-detect.
  147. B. XCF2DD
  148.     You get 784k per disc, in blocks of 4k.
  149. C. XCF2DD with no system track
  150.     You get 792k per disc, but it won't auto-detect.
  151. D. XCF2DD with no system track and a small directory.
  152.     You get 796k per disc, but it won't auto-detect and there are only 128
  153.   directory entries.
  154. E. DOS standard. Usable under MSDOS, PCDOS and DRDOS. 713k per disc, and 128
  155.  entries in the root directory. The boot sector supplied is the non-booting
  156.  "msdisc" sector by G Mortreuil.
  157. F. DOS Oddball. The program MSODBALL.COM can convert this DOS format to and
  158.  from format 9, preserving all files. The boot sector supplied is the non-
  159.  booting "msodball" sector by G Mortreuil.
  160. ________________________________________________________________________________
  161.  
  162. Double Track Discs
  163. ------------------
  164.   Discs made in 3⌐" drives, the B: drive of a PCW 8512, either drive of a PCW
  165. 9512 or an external 720k disc drive are referred to as "Double Track". These
  166. discs cannot be read in "Single Track" drives, such as the A: drive of a PCW
  167. 8256, a CPC 6128 or a Spectrum +3.
  168.   There are therefore two types of 173k disc; those made in "Single Track"
  169. drives (the usual sort) and those made in "Double Track" drives by this program
  170. or the original DU49 (on which this program is based). The two are not inter-
  171. changeable. The "Format Option" menu allows "Double Track" drives to read both
  172. types of disc, but "Single Track" drives can only read "Single Track" discs.
  173. ________________________________________________________________________________
  174.  
  175. The Configurator - DU51CON.COM
  176. ==============================
  177.  
  178.   The configurator program has the following features:
  179.  
  180. ╝ Add or replace bootsectors for any format;
  181. ╝ Edit any format.
  182.  
  183. The command is:
  184.  
  185. DU51CON          - Starts up with no file loaded;
  186. DU51CON du51.com - Loads the specified file, which should be a copy of DU51.COM.
  187.  
  188. The main menu for DU51CON has four options:
  189. Load DU51: Load a copy of DU51 to customize.
  190. Save DU51: Save a customized copy of DU51 to disc.
  191. Edit Bootsectors: Add or replace the bootsector for a format.
  192. Edit Format: Edit a format.
  193.  
  194. Load and Save DU51:
  195. -------------------
  196.   These options suggest a file on the current drive called DU51.COM; if you move
  197. the bar down to the second option, you will be able to input an alternative
  198. filename.
  199.  
  200. Edit Bootsectors:
  201. -----------------
  202.   This is mainly used to make a disc capable of booting CP/M (or DOS), but it
  203. should also be used if a new DOS format has been defined. If a DOS format has
  204. no bootsector, DU51 will try to generate one from the CP/M XDPB, and the result
  205. will probably not be accurate enough.
  206.   Here is a worked example for a PCW 8256:
  207.  
  208.   1. Run DU51.
  209.   2. Select option 1. Choose "Fixed Format", "PCW 8256 CF2", "Single Track"
  210.   3. Select option 3. Insert your CP/M Start of Day disc, and follow
  211.     the instructions, saving the bootsector as M:BOOT8256.BIN
  212.   4. Leave DU51, and run DU51CON.
  213.   5. Load a copy of DU51.COM.
  214.   6. Select option B. Choose "PCW 8256 CF2".
  215.   7. Enter the filename M:BOOT8256.BIN.
  216.   8. Save DU51 as DU51A.COM (or something similar).
  217.  
  218. Subsequently, all discs formatted by the new program (DU51A.COM in this
  219. example) in the appropriate format will be able to boot CP/M or LocoScript.
  220.  
  221. Edit Format:
  222. ------------
  223.   Choose the format. You will then be given three options:
  224. Edit XDPB: The XDPB editor menu will appear. The XDPB is shown in two parts;
  225.           the standard CP/M+ part and the Amstrad extension. Numbers can be
  226.           input at any time in decimal or Hex; to type a Hex number, put an
  227.           & character in front of it. Numbers will be displayed either all in
  228.           decimal or all in Hex.
  229.            When calculating the XDPB for a DOS format, define an XDPB for a
  230.           similar CP/M format (same number of tracks and sectors, similar
  231.           amount of directory entries).
  232. Edit Name: The format name, used in the format selection menu and various other
  233.           parts of the editor.
  234. Format Type: Either DOS or CP/M.
  235.  
  236. When you have defined the format, press ENTER. You will then be asked some
  237. questions so that the program can design the format's menu entry correctly:
  238. Will it autodetect?  Most formats will unless they don't have a system track.
  239. How much free space? The program will try and estimate the correct amount of
  240.                     free space an empty disc in this format should have. You
  241.                     can accept its estimate or type a more accurate figure of
  242.                     your own.
  243. How many directory entries? DOS formats only. The program will try to estimate
  244.                     the size of the directory from the XDPB, and you can accept
  245.                     its estimate or specify a different number.
  246.  
  247. Your format will then be defined. If it had a bootsector before, you may have
  248. to replace this bootsector with the correct one for your new format. Boot-
  249. sectors cannot be removed once loaded.
  250. ________________________________________________________________________________
  251.  
  252. Editing DU51.COM with SID:
  253.  
  254. The configuration data are located at 0103h-010Dh:
  255. 0103:    DEFB    51h    ;Version number - v5.01. Used by DU51CON to check for
  256.             ;a correct DU51.COM.
  257. 0104:    DEFW    FLAGS    ;The address of a 15-byte flags area.
  258. 0106:    DEFW    MENU    ;The address of the formats menu.
  259. 0108:    DEFW    XDPBS    ;The address of the XDPBs for the fixed formats.
  260. 010A:    DEFW    SECTORS    ;The address of the bootsectors table.
  261. 010C:    DEFW    ENDPRG    ;Address of the first byte after the program.
  262.  
  263. FLAGS:
  264. ;
  265. ;Each byte corresponds to one of the formats in the menu - so FLAGS+0 is for
  266. format 1, FLAGS+1 is for format 2 etc. Each byte should have:
  267. ;Bit 0 : Set to 0 if the formatter should generate a bootsector for the format.
  268. ;        Set to 1 if the formatter should use a ready-made bootsector.
  269. ;Bit 1 : Set to 0 if the format is a CP/M format.
  270. ;        Set to 1 if the format is a DOS format.
  271. ;Bits 2-7: Reserved (set to 0).
  272. ;
  273. MENU:    DEFB    row,column,width_of_options,no_of_options
  274.     DEFB    heading
  275.     DEFB    menu_entry,shortcut,0,0            ;15 times
  276. ;
  277. ;The MENU is a data structure containing the list of formats. The first four
  278. ;bytes should not be altered, unless you wish to reduce the number of options
  279. ;by changing the byte at MENU+3.
  280. ;The heading is 60 bytes long, and is printed at the top of the menu.
  281. ;Each entry is 60 bytes long, and is followed by its shortcut character (1 byte)
  282. ;and then two zeroes, which must not be altered.
  283. ;
  284. XDPBS:
  285. ;
  286. ;Each XDPB is a standard Amstrad XDPB, 27 bytes long. The last byte should be
  287. ;set to 0FFh. The XDPBs follow one after the other.
  288. ;
  289. SECTORS:
  290.     DEFW    sector_for_format_1
  291.     DEFW    sector_for_format_2 etc.
  292. ;
  293. ;Each entry in the table is the address of a bootsector. If a format's entry in
  294. ;the flags table has bit 0 set, the corresponding bootsector will be written to
  295. ;disc as the first sector on the first reserved track. If the address is 0, then
  296. ;load the bootsector at ENDPRG and change the corresponding entry accordingly.
  297. ;
  298. ENDPRG:
  299. ;New boot sectors or patches should be loaded here, and the value of the word at
  300. ;010Ch should be changed accordingly to mark the new end of the program.
  301. ;
  302.