Mercurial > hg > Members > kono > nitros9-code
annotate ReadMe @ 2811:611715587834 lwtools-port
Updated rules.mak and level1/coco1/bootfiles/makefile
Updated the rules.mak file to remove the format entire image related
to drivewire server disk images.
Updated level1/coco1/bootfiles/makefile to create 3 new bootfile images.
These images are stripped down to just the common files needed
for vovdg games on os9 level 1. These bootfiles are for becker, dw,
and arduino. Also corrected a duplicated dd descriptor when building
some bootfiles that had both floppy_40d, floppy_80d, RBDW, RBBECKER,
and RBARDUINO. Removed the dd descriptor from each of these sections
and made it where the dd descriptor for the specific section was added
in the main bootfile list.
| author | David Ladd <drencor-xeen@users.sf.net> |
|---|---|
| date | Mon, 11 Feb 2013 20:16:24 -0600 |
| 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 |