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
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 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