Mercurial > hg > Members > kono > nitros9-code
annotate ReadMe @ 2898:28ed72477814 lwtools-port
Dummy merge of default branch into lwtools
hg -y merge --tool=internal:fail default
hg revert --all --no-backup --rev .
hg resolve -a -m
This dummy merge discards any changes from the default branch
so that the result is the same as what lwtools already had.
When merging back to default branch later, the discarded
changes will be discarded there also, so the result
will be that the default branch will contain what
the lwtools branch had before these merges.
Only scripts/burst was "rescued" from default branch.
author | Tormod Volden <debian.tormod@gmail.com> |
---|---|
date | Sat, 11 Jan 2014 18:40:44 +0100 |
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 |