annotate 3rdparty/roms/dos/SuperDos/ReadMe.txt @ 2527:051d0f956c6f

Cleaned up patches and attempted to keep tempo intact. Unfortunately tempo is 1.23x slower for no known reason. RG
author robertgault
date Sat, 10 Apr 2010 13:44:38 +0000
parents 4037b23c848d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1985
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
1 This archive contains the disassembled source for SuperDos version E6,
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
2 I have tidyed it up and partially commented it (it is a work in progress as
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
3 respects to thie comments :) ).
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
4
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
5 I have also (hopefully) successfully ported it to the Dragon Alpha hardware,
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
6 so that it may be used with Mess' Alpha emulation, or with a real Alpha.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
7
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
8 As of January 2006, this code has also been ported to run on the Tandy RS-DOS
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
9 and compatible controlers when attached to a Dragon, thested so far are FD-500
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
10 (P.Harvey-Smith) and FD-502, Disto Super Controller I (Boisy Pitre).
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
11
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
12 The tools required to build this are :-
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
13
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
14 1) A version of Make, I used the gnu one, but any reasonable make should work.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
15 2) The mamou assembler from NitrOS9's toolshed, available from www.nitros9.org,
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
16 I will hopefully soon have permission to upload a binary version of this.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
17 3) Aditionally to build the zips you will need pkzip (or zip under Unix/Linux).
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
18
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
19 The directories are structured as follows :-
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
20
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
21 SuperDos
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
22
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
23 Makefile Project makefile
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
24 superdos-e6-03.asm Source to SuperDos.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
25 dgndefs.asm Defines for inclusion in superdos-e6-03.asm
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
26 dosdefs.asm Defines for dos variables
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
27 romdefs.asm Defines of Basic rom vars and calls
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
28 Readme.txt This file !
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
29
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
30 Subdirectories
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
31 Dragon32 Dragon 32 build, dragondos cart
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
32 Dragon64 Dragon 64 build, dragondos cart
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
33 DgnAlpha Dragon Alpha build, internal disk hardware
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
34 TanoD64 Tano Dragon 64, RS-DOS compatible cartrage
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
35 disks Contains a zipped image of the AlphaDos boot disk, this may be used
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
36 with mess or written to disk and used with a real Alpha.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
37
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
38 If you want to build dos for use with Mess, extract the relevent romset into
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
39 the above directory.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
40
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
41 Make targets.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
42
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
43 The makefile contains the following targets, to build them type make followed
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
44 by one of :-
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
45
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
46 all Builds everything.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
47 alpha Builds SuperDos for the Alpha, in file dragondos-alpha.bin
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
48 ddos Builds SuperDos, for the vanilla DragonDos cartragein file dragondos-ddos.bin.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
49 ddd32 Builds SuperDos, for the Dragon32 for Mess in : dragon32\dragon32.zip
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
50 ddd64 Builds SuperDos, for the Dragon64 for Mess in : dragon64\dragon64.zip
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
51 dddalpha Builds SuperDos, for the Dragon Alpha for Mess in : dgnalpha\dgnalpha.zip
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
52 sdtano Builds SuperDos, for the Tano Dragon/RS-DOS for Mess in : tanodr64\tanodr64.zip
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
53
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
54 The raw rom images will also be built in the above directories.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
55
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
56 The files superdos-ddos.bin and superdos-alpha.bin are raw binary images and are suitable
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
57 for blowing into an eprom for use on a real machine.
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
58
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
59 All source is (C) 1983 DragonData Ltd, (C) 1986 ?? Grosvenor Software, except the Alpha port which
4037b23c848d SuperDos rom, assembalable for Dragon Dos, Dragon Alpha or RS-DOS
afra
parents:
diff changeset
60 is (C) 2004, P.Harvey-Smith, and the RS-DOS port which is (C) 2006, P.Harvey-Smith.