Mercurial > hg > Members > kono > nitros9-code
annotate ReadMe @ 2772:0a3f4d8ea6d5
Found ENDC in wrong location in dwread.asm and dwwrite.asm. Corrected.
Moved the native 6309 code in dwread.asm and dwwrite.asm into the H6309 labeled area and changed IFEQ H6309 to IFNE H6309. Also moved the 57600bps 6809 code to the default location. This change had been done in the old dwread.asm and dwwrite.asm files to make it easier to follow. Though these two files were overwritten from the HDBDOS project dwread.asm and dwwrite.asm files. So this conversion needed to be done again so it made the source easier to follow.
| author | drencor-xeen |
|---|---|
| date | Wed, 23 Jan 2013 12:36:55 -0600 |
| parents | 6bd6e348665d |
| 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 | |
|
2730
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
73 Addendum by Gene Heskett |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
74 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
75 Unfortunately, many of the fdc chipsets shipping on motherboards for |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
76 the last 5 years or so, do NOT understand, and will probably crash your |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
77 pc when a 256 byte/sector disk read or write is attempted. This rather |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
78 high priced Asus M2n-SLI Deluxe board is one such board, so using floppies |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
79 for the 'sneakernet' to get this stuff onto my coco3 cannot be done. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
80 email to gheskett AT wdtv DOT com. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
81 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
82 1. This repo is newer than the sourceforge repo, and a lot more of it |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
83 Just Works(TM). If you find something that doesn't, use the above |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
84 email address. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
85 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
86 2. This repo's work will be transfered back to sourceforge when I can |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
87 figure out how to do a commit in mercurial. Tutorials on this are welcome. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
88 There are, since I did the hg clone about the 27th of October 2012, |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
89 probably at least 50 files needing committed, changed in getting this |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
90 back to buildable and bootable. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
91 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
92 3. Since we now have drivewire, the appropriate for your machine .dsk |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
93 files can be downloaded and mounted directly as a fully read/write |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
94 virtual disk. Drivewire is the cats meow, many thanks to Aaron Wolfe. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
95 Make yourself a cable and join in on the dance floor, its amazing. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
96 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
97 4. I am still using mamou as the assembler, no attempt has been made |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
98 to convert it to using William Astles lwtools just yet as I wanted |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
99 this to be as close to 100% usable as possible before attempting the |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
100 conversion so that only the conversion generated errors remain. There |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
101 will be some teething problems while that is going on in a separate |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
102 tree that won't be visible until it Just Works(TM). |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
103 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
104 5. One thing that was recently done by Boisy was to convert the |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
105 boot_scsi.asm file from, because of code size constraints, the use of |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
106 the former drive addressing scheme of a single marching set bit across |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
107 the scsi bus drive address field, into a base zero decimal scheme, so the |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
108 drive address contained in the 4th byte from the end can now be looked |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
109 at as a decimal value where $00 is now a legal address for drive 0 on |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
110 the bus. A MAJOR change, and one in the right direction IMO, that was |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
111 not even mentioned in the comments of the boot_scsi.asm header till I |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
112 discovered it yesterday while reading the code trying to figure out why |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
113 with that byte set to $01 like it had been for years, the boot was |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
114 failing because it was trying to find OS9Boot on my drive 1, s1, and |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
115 fixed the makefiles accordingly. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
116 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
117 6. I am not trying to keep this a secret but it probably will not get |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
118 any ink on the coco list until such time as I have committed to source- |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
119 forge and that repo is again useable, so bear with me. I have cable |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
120 dsl so my 'intertube' at 3 megabits isn't that fast. A lot of traffic |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
121 will probably result in my isp blocking the port address I do use to |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
122 get past the port 80 block just like they do without admitting to it |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
123 because if they did admit it, the FCC would probably discuss their |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
124 common carrier status with the ISP's legal dept. As that status has |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
125 huge tax and licensing advantages to the ISP, they will not give that |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
126 status up without a prolonged court fight. I have even considered |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
127 putting this page on port 6809, but when and if that happens, you'll |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
128 see it in my email sig. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
129 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
130 Thats all for now folks, keep the old girl running till the rapture |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
131 or whatever. |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
132 |
|
6bd6e348665d
Working on cloned default branch, pulled 2012/11/03
gheskett@wdtv.com
parents:
2158
diff
changeset
|
133 Cheers, Gene |