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