source: xtideuniversalbios/wiki/SerialDrives.wiki @ 309

Last change on this file since 309 was 309, checked in by gregli@…, 10 years ago

Updates to serial drive documentation.

File size: 8.6 KB
Line 
1#summary Instructions for emulating Serial Drives with the XTIDE Universal BIOS
2*Table of Contents*
3<wiki:toc max_depth="3" />
4----
5= Introduction =
6
7With version 2, the XTIDE Universal BIOS can emulate floppy and hard disks over a serial connection.  By doing so, aging hardware can be bootstrapped from a floppy image, or even run without a physical hard disk.  No special hardware is required, the BIOS can work with any standard COM port that is installed on the machine.  And with high speed COM ports, performance can approach the performance of vintage hard disks.
8
9== System Requirements ==
10
11To use this feature, you will need:
12   
13  * Client PC
14    * Standard or High Speed COM Port
15    * XTIDE Universal BIOS option ROM installed
16
17  * Server PC
18    * Standard or High Speed COM Port (USB add-ons serial ports work great)
19    * Windows XP or later (In the future, support for additional platforms may be added)
20    * Flat Disk Images of floppy disks or hard disks
21    * Command line utility, SerDrive, included with the XTIDE Universal BIOS distribution
22
23  * [http://en.wikipedia.org/wiki/Null_modem Null Modem cable] between the two machines
24
25== Getting Started ==
26
271. * Connect the two machines via the serial connection. *
28
292. * Open a command prompt, and run the SerDrive utility on the server. *  Arguments are described below.  In its simplest form:
30    C:/> SerDrive MyImage.img
31If you do not already have an image, you can obtain boot floppies of FreeDOS from.
32SerDrive will use the first available COM port by default, at a speed of 9600 baud (which is reliable, but relatively slow, you will likely want to increase this for continued use).
33
343. * Boot the client computer.  During drive detection, hold down the Alt key, and at the end of drive detection, the BIOS will display "Serial Master on COM Detect". *  The BIOS will now scan the available COM ports on the client (COM 1-7), looking for a server.
35
36If a server is found, the floppy and/or hard disk emulated will appear in the boot menu for the BIOS.  You can now proceed as normal.
37
38SerDrive is stateless, and flushes writes to the image files immediately.  You can start and stop the server at will, although this is not recommended.   If the server is stopped and a disk access is attempted by the client, that request will result in an error on the client.  Also, changing the image file without also rebooting the client may result in unexpected behavior and possible data loss.
39
40= Performance =
41
42= Configuring with XTIDECFG =
43
44Holding down the Alt key is a bootstrapping feature, which is always available.  In addition, xtidecfg can be used to configure the BIOS to always look on a particular COM port for a server, or to automatically scan on each boot (as if the Alt key had been pressed).
45
46Note that serial ports must be the last configured IDE controller.  Xtidecfg will move any serial ports to the end of the list if this is not already done.  This is done so that serial floppy disks, if any are presented, will be last on the list of drives.
47
48= SerDrive Command Line Arguments =
49
50* Usage: SerDrive [options] imagefile [[slave-options] slave-imagefile] *
51
52Specify Disk Geometry: * -g [cyl:head:sect] *
53
54Geometry in cylinders, sectors per cylinder, and heads.  -g also implies CHS addressing mode (default is LBA28).
55
56Create New Disk Image: * -n [megabytes] *
57
58Create new disk with given size or use -g geometry.  Maximum size is 137438 MB (the LBA28 size limit).  Floppy images can also be created, such as "360K".  Default disk size is 32 MB disk, with a CHS geometry 65:16:63.
59
60Emulator Pipe Mode: * -p [pipename] *
61
62Named Pipe mode for emulators.  Pipe name must begin with "\\", default is "\\.\pipe\xtide".
63
64Specify COM Port: *-c COMPortNumber *
65
66COM Port to use (default is first found).  The usage message will also list the available COM ports on this system.
67
68Specify Baud Rate: * -b BaudRate *
69
70Baud rate to use on the COM port.  If the client machine has a hardware rate multipler (for high speed operation), then that will impact this setting:
71
72|| Rate Multiplier || Available Baud Rates ||
73|| None ||  2400,  4800,  9600,  28.8K,  57.6K, 115.2K ||
74|| 2x || 4800,  9600, 19200,  57.6K, 115.2K, 230.4K ||
75|| 4x || 9600, 19200, 38400, 115.2K, 230.4K, 460.8K ||
76
77And for completeness, 76.8K and 153.6K can also be set.  The default baud rate is 9600 (115.2K when used in named pipe mode)
78
79Disable Operation Timeout: * -t *
80
81Disable timeout, useful for long delays when debugging.
82
83Read Only Disk: * -r *
84
85Treat the disk as a Read Only disk, SerDrive will not allow writes.
86
87Verbose: * -v [level] *
88
89Reporting level 1-6, with increasing information as the number increases.  This switch can be very useful for seeing the secot-by-secotr traffic between the PC and the hard disk.
90
91ImageFiles: * ImageFileName *
92
93Finally, the image file name appears. Up to two image files can be used, each with their own settings for many of the switches above.
94
95Floppy images may also be used.  Image size must be exactly the same size
96as a 2.88MB, 1.44MB, 1.2MB, 720KB, 360KB, 320KB, 180KB, or 160KB disk.
97Floppy images must be the last disks discovered by the BIOS, and only
98two floppy drives are supported by the BIOS at a time.
99
100= High Speed Operation =
101
102Normal COM ports top out their speed somewhere between the reliable 9600 baud and the unreliable theoretical maximum of 115.2K baud.  This includes COM ports that are included on the motherboard of even modern PCs.  COM ports with FIFOs can usually achieve the 115.2K speed.  In addition, High Speed COM ports were introduced with a clock multiplier, resulting in top speeds of 230.4K and 460.8K.  Many USB COM ports on the market can achieve 500K or higher speeds.
103
104The BIOS supports speeds up to 460.8K baud.  To achieve this speed, you will need:
105
106  * COM port on the client machine capable of high speed operation.  Believe it or not, one can still buy new ISA High Speed COM ports that accomplish this, that can even be used in old 8-bit machines.  Serial cards that have been tested:
107
108 In addition, the [http://www.vintage-computer.com/vcforum/showwiki.php?title=XTIDE+Rev2 XTIDE rev2] has a high speed COM port installed for this purpose.
109
110  * COM port on the server machine capable of high speed operation.  Most motherboard based COM ports can NOT attain high speed.  However, most USB COM ports can attain high speed.  USB serial ports that have been tested:
111
112Care must be taken when configuring the serial connection - the clock multiplier is not detectable by the client PC.  With a 4x clock multiplier, the client PC should be set to 115.2K baud, while the matching server needs to be set to 460.8K baud.
113
114= Disk Image Format =
115
116Disk image files, at this time, are flat hard disk images.  Sectors are laid out on disk, starting with sector 0, and proceeding in LBA order (literally 512-byte sector 0, then 1, then 2, etc.).  No meta-data about the size of the disk or disk geometry is stored in the file. Alo no compression of unused sectors is done.  SerDrive's "-n" switch can be used to create images of the proper size, with all sectors initialized to zeros.
117
118In the future, support for additional disk image formats may be added.
119
120== Disk Image Utilities ==
121
122[http://www.winimage.com/winimage.htm WinImage] is a good tool that can manipulate image files - it can view, inject, and extract files from a file system stored on the image.   
123
124Other possible tools include [http://hp.vector.co.jp/authors/VA013937/editdisk/index_e.html DiskExplorer] and GNU has a set of tools called [http://www.gnu.org/software/mtools Mtools], although I have not seen a good port of those to Win32.
125
126== Emulators ==
127
128Floppy and hard disk image files can be shared between the XTIDE Universal BIOS and other emulators, such as [http://bochs.sourceforge.net Bochs].  One nice feature of this is that bootable images can be created and tested in an emulated enivornment, copmlete with multiple floppy and CD-ROM drives, and then the resulting image can be used with physical hardware through the BIOS.
129
130Bochs was heavily used in the development of the serial code, as its debugger offers control over the emulated system that is hard to accomplish on actual hardware.  You can run the XTIDE Universal BIOS in Bochs as an installed option ROM, and interface with Bochs' emulate IDE hard disks and serial ports.  To support serial ports, SerDrive's "-p" switch can be used to run over a Win32 named pipe instead of a physical COM port, and Bochs can be set to emulate a COM port over a named pipe.  In addition, it can be set to emulate a specific baud rate from the client (Bochs), using the standard "-b" switch.  The "-t" switch is useful to prevent the server from timing out on operations, if a breakpoint is hit in the BIOS code.
131
Note: See TracBrowser for help on using the repository browser.