annotate ReadMe @ 3024:8647c25ba101

cobbler: Handle disks with fragmented OS9Boot files
author Robert Gault <robert.gault@att.net>
date Thu, 11 Dec 2014 20:11:12 +0100
parents 635275f4498a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2158
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
1 ***************
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
2 NitrOS-9 ReadMe
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
3 ***************
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
4
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
5 Welcome to NitrOS-9!
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
6
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
7 DISTRIBUTION
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
8 ============
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
9 There are two double-sided 40 track DSK images ending in '_ds40_1.dsk',
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
10 and '_ds40_2.dsk' for disks 1 and 2, respectively. For those with
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
11 3.5" 720K drives, an 80 track DSK image ending in '_ds80.dsk' is also
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
12 included in the distribution.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
13
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
14 USING THE DISK IMAGES
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
15 =====================
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
16 If you wish to transfer the disk images to a floppy disk for use with a
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
17 real CoCo, follow the steps below:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
18
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
19 WINDOWS/DOS:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
20
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
21 1. Download and install the latest version of DSKINI/RETRIEVE at
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
22 http://www.nitros9.org/
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
23
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
24 2. Insert a blank double-sided floppy in to your drive (we assume B:)
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
25
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
26 3. Type the following command, replacing the name of the image:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
27
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
28 DSKINI /T40 /D B: <diskimagefile> (360K 5.25" floppy disk)
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
29 DSKINI /T80 /D B: <diskimagefile> (720K 3.5" floppy disk)
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
30
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
31 Where <diskimagefile> is the image file you want to transfer to the
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
32 floppy disk. The image file transfer should start. When it is done,
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
33 take out the disk and try booting your CoCo with it.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
34
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
35 Repeat steps 2-3 for each additional disk.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
36
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
37
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
38 LINUX:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
39
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
40 1. Download and install the latest version of fdutils from
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
41 http://fdutils.linux.lu/
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
42
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
43 2. Once installed, edit the /usr/local/etc/mediaprm file and add the
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
44 following lines at the end of the file:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
45
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
46 "COCO360":
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
47 DS DD sect=18 cyl=40 ssize=256 tpi=48
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
48
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
49 "COCO720":
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
50 DS DD sect=18 cyl=80 ssize=256 tpi=96
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
51
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
52 3. Insert your blank floppy into the drive on your Linux box.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
53
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
54 4. Type the following command:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
55
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
56 setfdprm /dev/fd1 coco360 (360K 5.25" floppy disk)
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
57 setfdprm /dev/fd1 coco720 (720K 3.5" floppy disk)
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
58
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
59 This assumes your floppy drive is /dev/fd1. You may need to make
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
60 adjustments to the above commands for your environment.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
61
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
62 5. After typing the setfdprm command, the floppy drive unit should spin
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
63 for a second then stop. Type this command:
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
64
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
65 dd if=<diskimagefile> of=/dev/fd1
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
66
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
67 Where <diskimagefile> is the image file you want to transfer to the
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
68 floppy disk. The image file transfer should start. When it is done,
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
69 take out the disk and try booting your CoCo with it.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
70
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
71 Repeat steps 3-5 for each additional disk.
f42b59c12c95 Moved ReadMe to root of project
boisy
parents:
diff changeset
72
2730
6bd6e348665d Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents: 2158
diff changeset
73
2911
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
74 NOTES
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
75 =====
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
76 Unfortunately, many of the FDC chipsets shipping on PC motherboards do NOT
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
77 understand, and will probably crash your PC when a 256 byte/sector disk
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
78 read or write is attempted. The Asus M2n-SLI Deluxe board is one such board.
2730
6bd6e348665d Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents: 2158
diff changeset
79
2911
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
80 When using DriveWire, the appropriate for your machine .dsk
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
81 file can be downloaded and mounted directly as a fully read/write
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
82 virtual disk. Please see for instance the tutorial at
635275f4498a Remove some obsolete comments from ReadMe file
Tormod Volden <debian.tormod@gmail.com>
parents: 2730
diff changeset
83 http://www.cocopedia.com/wiki/index.php/Getting_Started_with_DriveWire
2730
6bd6e348665d Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents: 2158
diff changeset
84