Mercurial > hg > Members > kono > nitros9-code
annotate ReadMe @ 2879:531841047512 lwtools-port
boot_scsi.asm: Fix SCSI ID when booting from SCSI
Due to a typo it would probe for SCSI ID 4 instead
of default 0 (or 8 for HDBDOS/SuperDriver).
author | Tormod Volden <debian.tormod@gmail.com> |
---|---|
date | Sun, 24 Nov 2013 16:08:53 +0100 |
parents | 1868fbf470e7 |
children | 635275f4498a |
rev | line source |
---|---|
2158 | 1 *************** |
2 NitrOS-9 ReadMe | |
3 *************** | |
4 | |
5 Welcome to NitrOS-9! | |
6 | |
7 DISTRIBUTION | |
8 ============ | |
9 There are two double-sided 40 track DSK images ending in '_ds40_1.dsk', | |
10 and '_ds40_2.dsk' for disks 1 and 2, respectively. For those with | |
11 3.5" 720K drives, an 80 track DSK image ending in '_ds80.dsk' is also | |
12 included in the distribution. | |
13 | |
14 USING THE DISK IMAGES | |
15 ===================== | |
16 If you wish to transfer the disk images to a floppy disk for use with a | |
17 real CoCo, follow the steps below: | |
18 | |
19 WINDOWS/DOS: | |
20 | |
21 1. Download and install the latest version of DSKINI/RETRIEVE at | |
22 http://www.nitros9.org/ | |
23 | |
24 2. Insert a blank double-sided floppy in to your drive (we assume B:) | |
25 | |
26 3. Type the following command, replacing the name of the image: | |
27 | |
28 DSKINI /T40 /D B: <diskimagefile> (360K 5.25" floppy disk) | |
29 DSKINI /T80 /D B: <diskimagefile> (720K 3.5" floppy disk) | |
30 | |
31 Where <diskimagefile> is the image file you want to transfer to the | |
32 floppy disk. The image file transfer should start. When it is done, | |
33 take out the disk and try booting your CoCo with it. | |
34 | |
35 Repeat steps 2-3 for each additional disk. | |
36 | |
37 | |
38 LINUX: | |
39 | |
40 1. Download and install the latest version of fdutils from | |
41 http://fdutils.linux.lu/ | |
42 | |
43 2. Once installed, edit the /usr/local/etc/mediaprm file and add the | |
44 following lines at the end of the file: | |
45 | |
46 "COCO360": | |
47 DS DD sect=18 cyl=40 ssize=256 tpi=48 | |
48 | |
49 "COCO720": | |
50 DS DD sect=18 cyl=80 ssize=256 tpi=96 | |
51 | |
52 3. Insert your blank floppy into the drive on your Linux box. | |
53 | |
54 4. Type the following command: | |
55 | |
56 setfdprm /dev/fd1 coco360 (360K 5.25" floppy disk) | |
57 setfdprm /dev/fd1 coco720 (720K 3.5" floppy disk) | |
58 | |
59 This assumes your floppy drive is /dev/fd1. You may need to make | |
60 adjustments to the above commands for your environment. | |
61 | |
62 5. After typing the setfdprm command, the floppy drive unit should spin | |
63 for a second then stop. Type this command: | |
64 | |
65 dd if=<diskimagefile> of=/dev/fd1 | |
66 | |
67 Where <diskimagefile> is the image file you want to transfer to the | |
68 floppy disk. The image file transfer should start. When it is done, | |
69 take out the disk and try booting your CoCo with it. | |
70 | |
71 Repeat steps 3-5 for each additional disk. | |
72 | |
2774
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
73 Addendum by Gene Heskett |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
74 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
75 Unfortunately, many of the fdc chipsets shipping on motherboards for |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
76 the last 5 years or so, do NOT understand, and will probably crash your |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
77 pc when a 256 byte/sector disk read or write is attempted. This rather |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
78 high priced Asus M2n-SLI Deluxe board is one such board, so using floppies |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
79 for the 'sneakernet' to get this stuff onto my coco3 cannot be done. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
80 email to gheskett AT wdtv DOT com. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
81 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
82 1. This repo is newer than the sourceforge repo, and a lot more of it |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
83 Just Works(TM). If you find something that doesn't, use the above |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
84 email address. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
85 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
86 2. This repo's work will be transfered back to sourceforge when I can |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
87 figure out how to do a commit in mercurial. Tutorials on this are welcome. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
88 There are, since I did the hg clone about the 27th of October 2012, |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
89 probably at least 50 files needing committed, changed in getting this |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
90 back to buildable and bootable. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
91 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
92 3. Since we now have drivewire, the appropriate for your machine .dsk |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
93 files can be downloaded and mounted directly as a fully read/write |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
94 virtual disk. Drivewire is the cats meow, many thanks to Aaron Wolfe. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
95 Make yourself a cable and join in on the dance floor, its amazing. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
96 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
97 4. I am still using mamou as the assembler, no attempt has been made |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
98 to convert it to using William Astles lwtools just yet as I wanted |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
99 this to be as close to 100% usable as possible before attempting the |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
100 conversion so that only the conversion generated errors remain. There |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
101 will be some teething problems while that is going on in a separate |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
102 tree that won't be visible until it Just Works(TM). |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
103 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
104 5. One thing that was recently done by Boisy was to convert the |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
105 boot_scsi.asm file from, because of code size constraints, the use of |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
106 the former drive addressing scheme of a single marching set bit across |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
107 the scsi bus drive address field, into a base zero decimal scheme, so the |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
108 drive address contained in the 4th byte from the end can now be looked |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
109 at as a decimal value where $00 is now a legal address for drive 0 on |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
110 the bus. A MAJOR change, and one in the right direction IMO, that was |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
111 not even mentioned in the comments of the boot_scsi.asm header till I |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
112 discovered it yesterday while reading the code trying to figure out why |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
113 with that byte set to $01 like it had been for years, the boot was |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
114 failing because it was trying to find OS9Boot on my drive 1, s1, and |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
115 fixed the makefiles accordingly. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
116 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
117 6. I am not trying to keep this a secret but it probably will not get |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
118 any ink on the coco list until such time as I have committed to source- |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
119 forge and that repo is again useable, so bear with me. I have cable |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
120 dsl so my 'intertube' at 3 megabits isn't that fast. A lot of traffic |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
121 will probably result in my isp blocking the port address I do use to |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
122 get past the port 80 block just like they do without admitting to it |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
123 because if they did admit it, the FCC would probably discuss their |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
124 common carrier status with the ISP's legal dept. As that status has |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
125 huge tax and licensing advantages to the ISP, they will not give that |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
126 status up without a prolonged court fight. I have even considered |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
127 putting this page on port 6809, but when and if that happens, you'll |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
128 see it in my email sig. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
129 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
130 Thats all for now folks, keep the old girl running till the rapture |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
131 or whatever. |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
132 |
1868fbf470e7
Merged lwtools-port (2773:ce3dba57003b) and mainline (2772:0a3f4d8ea6d5)
Boisy Pitre <boisy.pitre@nuance.com>
parents:
2158
diff
changeset
|
133 Cheers, Gene |