![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to emutos.txt CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [HATARI the Atari ST Emulator] / hatari / doc|
Return to emutos.txt CVS log | Up to [HATARI the Atari ST Emulator] / hatari / doc |
1.1 root 1:
1.1.1.2 root 2: Contents:
3: - Hatari and EmuTOS
4: - What is EmuTOS
5: - EmuTOS usage
6: - EmuTOS compatibility
7: - Debugging issues with EmuTOS
8: - EmuTOS compatibility lists
9: - Working free/shareware Atari ST demos and games
10: - Non-working free/shareware GEM/mono Atari ST games
11: - Working free/shareware Atari STE programs
12: - "Almost" working color STE games
13: - Working free/shareware Falcon demos, games and applications
14:
15:
16: Hatari and EmuTOS
17: =================
18:
19: To run the emulator a TOS ROM image is needed. EmuTOS, a free
20: implementation of TOS, is shipped with the official releases of
21: Hatari.
22:
23: This tos.img ROM image is identical to the official binary package of
24: EmuTOS, which is available at the SourceForge website of EmuTOS. For
25: downloading other versions or the source code of EmuTOS, please visit
26: the EmuTOS website.
27:
28:
29: What is EmuTOS
30: ==============
31:
32: EmuTOS is a single-user single-tasking operating system for the 32-bit
33: Atari computers and emulators. It can be used as a replacement for
34: the TOS images typically needed today for using emulators and it is
35: also running on some real hardware, like the Atari Mega STE. All the
36: source code is open and free, licensed under the GNU General Public
37: License (GPL). A copy of the GNU GPL can be found in the gpl.txt
38: file.
1.1 root 39:
40: EmuTOS has its home at SourceForge:
1.1.1.2 root 41: http://sourceforge.net/projects/emutos
42:
43:
44: EmuTOS usage
45: ============
46:
47: There are various reasons for using EmuTOS instead of a real TOS ROM
48: image:
49:
50: * Users who don't have Atari HW or other legal means to obtain the
51: original Atari TOS ROMs (for all of the Hatari supported Atari
52: versions: ST/STE/TT/Falcon), but would like to try out Hatari and
53: see what kind of software Atari ST had. EmuTOS gives them a way to
54: test Hatari with free demos, games etc.
55:
56: * Users who want to continue using Atari compatible operating systems
57: and need a open source replacement of TOS for modifications. Beside
58: EmuTOS they typically alse use FreeMiNT, XaAES and fVDI as operating
59: system replacements/improvements.
60:
61: * EmuTOS allows also using ACSI disk images with Hatari TT/Falcon
62: emulation, whereas TOS 3 & 4 support only IDE and SCSI disks (which
63: Hatari doesn't currently support). Hard disk images are needed for
64: running MiNT and some other programs.
65:
66:
67: EmuTOS compatibility
68: ====================
69:
70: Many commercial games and applications work fine with EmuTOS. This is
71: because games (like Bombjack, Nebulus, Oids, Super Hang-On, Turrican,
72: Xenon...) use directly the hardware which Hatari emulates just fine
73: and applications use the correct higher level APIs (AES/VDI) for which
74: EmuTOS has implementations.
75:
76: EmuTOS AES support is somewhat buggy (mouse dragging and window &
77: dialog background drawing in larger 4-bit modes) and VDI support
78: is slowish. Anybody wanting proper AES/VDI support should install
79: replacement for these, either the free XaAES + fVDI, or the earlier
80: commercial solutions like NVDI.
81:
82: Free games have the issue that they often use the Line-A functionality
83: which is not supported by EmuTOS[1] unlike AES/VDI. This is partly a
84: problem with the tools that they've been done with (for example older
85: STOS and GFA basic version liked to use Line-A for graphics). There
86: are also many demos which use it for convenience.
87:
88: [1] EmuTOS has some old partial implementations for some of the Line-A
89: functionality, but these are so buggy that they aren't enabled in
90: EmuTOS releases except for mouse on/off functionality.
91:
92: Joystick doesn't work in some (STOS) games that access it through some
93: other means than XBIOS function Kbdvbase() or by hooking into the IKBD
94: interrupt vector. They probably uses some unofficial system variables
95: which location depends on the TOS version.
96:
97:
98: Debugging issues with EmuTOS
99: ============================
100:
101: To debug problems with EmuTOS, you have to download its source code and
102: recompile it. Enable the MIDI debug output in the config.h header file,
103: then you can start Hatari with the "--midi /dev/stderr" option. You will
104: then see the EmuTOS debug output like calls to missing Line-A functions.
105:
106: To debug EmuTOS panics, you need to compile EmuTOS and create a disassembly
107: of the ROM image. You can then look up the program counter value given in
108: panic message from the disassembly to see where the crash happens.
109:
110:
111: EmuTOS compatibility lists
112: ==========================
113:
114: The compatibility lists below cater for users who don't have Atari HW
115: and therefore won't have (legal) version of commercial Atari software
116: and most likely lack motivation to investigate applications very
117: deeply (Linux offers better alternatives nowadays for most of that).
118: I.e. the list skips commercial software and concentrates on EmuTOS
119: compatibility of freely available games and demos.
120:
121: Games that are considered good quality & fun, are marked with "*".
122: All the listed demos are quite OK. Most demos can be downloaded from
123: http://pouet.net/ .
124:
125: First are listed ST demos and games, then STE demos, games and music
126: applications and last Falcon demos, games and (music) applications.
127:
128:
129: Working free/shareware Atari ST demos and games
130: -----------------------------------------------
131:
132: There are so many freely available color games and demos that from
133: those only the ones found working with EmuTOS are listed. Often the
134: non-working ones "Panic" EmuTOS.
135:
136: Demos:
137: - 4getful (by gwEm, 4KB intro)
138: - 4kker (by Checkpoint, 4KB intro)
139: - Anomaly (by MMJ-Prod)
140: - Breath (by Mystic Bytes)
141: - Darktrip (by Legend, doesn't work with >2MB of RAM)
142: - Dark Side of the Spoon (by ULM)
143: - Death of the Clock Cycles (by Aggression)
144: - Dimensio (by Condemned)
145: - Flashback (by Carebears)
146: - Frenchies (by Frenchies, 96KB intro)
147: - Hallucinations (by Reservoir Gods)
148: - Overdose (by Aggression)
149: - Paradise (Dune Design)
150: - Phaleon Gigademo
151: - Posh (by Checkpoint)
152: - Soundtracker (by Equinox)
153: - Sweety (by DHS)
154: - Two in One (by DHS)
155: - YmRockerz musicdisks such as Popstars etc.
156:
157: Color games:
158: - Archon 4KB
159: - Alien Blockade
160: - Bellum*
161: - Bombs Away
162: - ChuChu Rocket*
163: - Clogged Up
164: - Crapman*
165: - Dave Munsie games (shareware)
166: - Entombed
167: - Flip'em* (4KB puzzle)
168: - Grav*
169: - Hackman II*
170: - Hang About (4KB mountain climbing)
171: - Haywire
172: - Hector*
173: - Jetpac
174: - Nibe 2
175: - Nova
176: - Pengy
177: - Punt II
178: - Rockfall*
179: - Robert in the Fire Factory
180: - Santafly
181: - Snowball Fight
182: - Spacewar
183: - Starball* (shareware)
184: - Sweeper
185: - Tankx*
186: - Teserae*
187: - Yak (4KB gridrunner)
188:
189: GEM games:
190: - Ballerburg*
191: - Biglife*
192: - Daleks*
193: - DBWH
194: - Drachen
195: - Gem_mind
196: - Isola
197: - Kensington
198: - Mars (corewars)
199: - Megaroid*
200: - Mathmaze
201: - Nethack*
202: - Orb
203: - Pacman
204: - Shanghai
205: - ST Concentration*
206: - Sudoku*
207: - Thrust
208: - Worm farm
209: - Wator (slow)
210:
211: Monochrome games:
212: - Balloons
213: - Delta patrol
214: - Eliza
215: - MiniGolf (GFA basic)*
216: - Monkey Business
217: - Mr Dash
218: - Punssi
219: - Pyro
220: - Qix
221: - Sbreak*
222: - Wallball
223: - Mandala
224:
225: Text games:
226: - Advent (Colossal Cave)
227: - Hack
228: - Larn
229: - Omega
230:
231:
232: Non-working free/shareware GEM/mono Atari ST games
233: --------------------------------------------------
234:
235: Although there are plenty of color demos and games, the number of
236: (even remotely fun) free GEM or monochrome games and demos is so low
237: that for those I list here non-working ones. Unless otherwise stated,
238: the issues in them are assumed to be Line-A related (graphics don't
239: show because they use Line-A drawing functions etc).
240:
241: GEM games:
242: - Awele
243: - Backgam
244: - Checkers
245: - Dte (mouse gets stuck)
246: - Emperor
247: - Fishes
248: - Fs
249: - Gemamigo*
250: - Gnuchess
251: - Invaders*
252: - Mines
253: - Othello
254: - Patience (dragging doesn't work)
255: - Risk (dragging doesn't work)*
256: - Robugs*
257: - Solitair
258: - Stello*
259: - Tricky yahoo
260: - Verrueck
261: - Yokon*
262:
263: Mono games:
264: - Bounce
265: - Columns*
266: - Crystal Caves*
267: - Domino
268: - Fun Face
269: - Go UP (stops at hi-score)
270: - Lasermon
271: - Lokomotive
272: - MacPan*
273: - Midimaze (joystick doesn't work)*
274: - MineFeld
275: - Pipeline*
276: - Pling II
277: - Poolmono (mouse gets stuck)*
278: - Roll X
279: - Sherlock*
280: - Space war*
281:
282:
283: Working free/shareware Atari STE programs
284: -----------------------------------------
285:
286: There are not that many freely available or even commercial programs
287: that would be STE specific (or even STE enhanced):
288: http://atari-ste.anvil-soft.com/html/archivapps.htm
289:
290: Missing blitter support in EmuTOS (XBios function etc) is an additional
291: reason why some programs/demos (such as Blittermania) don't work with it.
292: But following STE specific demos, games and apps work (mostly) fine
293: with EmuTOS.
294:
295: Demos:
296: - 1st Step (by Tobe/Mjjprod)
297: - 20 years megademo (by DHS), display issues in some screens
298: - Again (by Paradox)
299: - Armada is dead (by Aggression)
300: - Azed/Jungle demo (by Atari)
301: - Beat Demo (by Frontline)
302: - Birdie (by Zeal)
303: - CD-player (by Light)
304: - Core Flakes (by New Core)
305: - Dynamite (by Unit 17)
306: - E605 (by Light)
307: - Extacy (by ICE), breaks at the end
308: - French Kiss (by DHS)
309: - Illusion (by Next)
310: - Gobi Toons (by Dune)
311: - Grimey (by Reservoir Gods)
312: - Kick my assembler (by Orion), start doesn't look right
313: - Madness (by Cream)
314: - Mathematica (by Aura)
315: - More or Less Zero (by DHS)
316: - Maxymizer compo 2006 (by gwem)
317: - Meshake (by Spice Boys)
318: - Mind Rewind (by Reservoir Gods)
319: - MovieSTE (by Tony Barker)
320: - New Year -94 Intro (by Extream)
321: - Pacemaker (by Paradox), stops at end-part
322: - Paracon 6 & 7 remindtros (by Paradox)
323: - Powerrise (by Light)
324: - Reanimation (by Syntax)
325: - Sinfull Sinuses (by Chronicle)
326: - STE slideshow (by DHS)
327: - STE Wars (by Tony Barker)
328: - Vision (by POV)
329:
330: Color games:
331: - Alien Blast (demo)
332: - Battletris+
333: - Dynaplus*
334: - Frantick
335: - No Limit II (shareware pinball)
336: - Obsession* (demo of commercial pinball)
337: - Operation Garfield
338: - Pacman on E
339: - Power Up
340: - Skulls (shareware "minesweeper")
341: - Stardust* (tunnel sequence demo)
342: - STEtris
343: - STrEet Fighter II (incomplete)
344: - Stupid balloon game
345: - Substation* (demo)
346: - Tomtar
1.1.1.3 ! root 347: - Wolfenstein3D v0.8a (a bit unstable)
1.1.1.2 root 348:
349: Music Applications:
350: - Blipp Blopper
351: - Desktracker
352: - MaxYMizer
353: - Octalyzer
354: - Paula
355: - Sirius Player
356:
357: Most of the non-GEM ST tracker & chip music composer programs
358: work also with EmuTOS too (not just STe ones).
359:
360:
361: "Almost" working color STE games
362: --------------------------------
363:
364: There are some STE games that would appear otherwise to work perfectly,
365: but some part of the graphics just don't show. They are listed in case
366: someone, someday, starts to fix the EmuTOS line-A things (which I
367: think are preventing these from working properly).
368:
369: - Atari Scene Card Battle (card images don't show)
370: - Blat (main graphics don't show)
371: - Breakdance (another scene game, game freezes when playing)
372: - Mr Boomer (all graphics don't show)
373: - Pooz (all graphics don't show)
374:
375:
376: Working free/shareware Falcon demos, games and applications
377: -----------------------------------------------------------
378:
379: Missing Videl support in EmuTOS is probably the reason why many
380: of the demos and games get wrong video made and their graphics
381: look completely broken under EmuTOS. Following Falcon only
382: demos, games and apps work (mostly) fine though.
383:
384: Demos:
385: - Alive (by Fun Industries)
386: - Ascii (by Reservoir Gods)
387: - ATS (by DHS)
388: - Birdshow
389: - Blue & Flu 4k (by New Beat)
390: - Illusion 64 (by Paranoia)
391: - Game of Life 4k (by Aggression)
392: - Snowstorm (by Reservoir Gods)
393: - ZZ 9 Plural Z Alpha (by .tssc)
394:
395: Games:
396: - Blum
397: - Columns by Deadheart (demo)*
398: - Corsair
399: - DB 4K
400: - Dry Egg (needs >4MB RAM)
401: - FalcTron
402: - Impulse (Breakout clone)*
403: - Lamemine (needs "dummy" DSP mode in Hatari)
404: - Madtris
405: - Radical Race (demo)*
406: - Rave (needs "dummy" DSP mode in Hatari)
407: - SBM v0.8 (Bomberman clone)*
408: - Spice (Defender clone)*
409: - Static
410: - Steinbruch
411: - Tank Blaster
412: - Toy Man
413: - Vertical Mayhem (Columns clone)*
414: - Willie's Adventure (preview)*
415:
416: Mostly working applications:
417: - AceMidi demo (softsynth sounds needs DSP)
418: - FlaySID (sound needs DSP)
419: - Fractal Playground (parameter input doesn't work)
420: - Kronos (benchmark)
421: - Whip! (virtual light machine)
422:
423: Almost working demos & games:
424: - Bugger, Bunion, SkyFall, Switch, Sworm games* by Resorvoir Gods:
425: have issues with keyboard input in the main menus
426: - Heretic: screen is messed
427: - Nibe: screen is messed
428: - Virtual City (needs DSP): city is invisible with EmuTOS
429:
1.1 root 430:
1.1.1.2 root 431: - Eero
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.