![[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
1.1.1.5 ! root 35: the TOS images typically needed today for using the emulators and it is
! 36: also running on some real hardware, like the Atari Mega STE and Atari
! 37: ColdFire. All the source code is open and free, licensed under the
! 38: GNU General Public License (GPL). A copy of the GNU GPL can be found
! 39: in the gpl.txt 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:
1.1.1.5 ! root 48: There are various reasons for using EmuTOS instead of the original
! 49: TOS ROM images:
1.1.1.2 root 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
1.1.1.5 ! root 54: see what kind of software the Atari machines had. EmuTOS gives
! 55: them a legal way to test Hatari with free demos, games etc.
1.1.1.2 root 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:
1.1.1.5 ! root 62: * This includes users of new "Atari" machines like Atari ColdFire project,
! 63: which isn't 100% compatible at HW level to the original Atari machines:
! 64: http://acp.atari.org/
! 65:
! 66: * EmuTOS also allows using ACSI disk images with Hatari TT/Falcon
1.1.1.4 root 67: emulation, whereas TOS 3 & 4 support only IDE and SCSI disks.
68: Hard disk images are needed mainly for running MiNT.
1.1.1.2 root 69:
70:
71: EmuTOS compatibility
72: ====================
73:
1.1.1.5 ! root 74: These comments apply to EmuTOS v0.8.5.
! 75:
1.1.1.2 root 76: Many commercial games and applications work fine with EmuTOS. This is
77: because games (like Bombjack, Nebulus, Oids, Super Hang-On, Turrican,
78: Xenon...) use directly the hardware which Hatari emulates just fine
79: and applications use the correct higher level APIs (AES/VDI) for which
80: EmuTOS has implementations.
81:
1.1.1.5 ! root 82: EmuTOS AES support is somewhat buggy (mouse clicks and dragging
! 83: doesn't always work properly) and VDI support is slowish. Anybody
! 84: wanting proper AES/VDI support should install replacement for these,
! 85: either the free XaAES + fVDI, or the earlier commercial solutions like
! 86: NVDI.
1.1.1.2 root 87:
88: Free games have the issue that they often use the Line-A functionality
89: which is not supported by EmuTOS[1] unlike AES/VDI. This is partly a
90: problem with the tools that they've been done with (for example older
91: STOS and GFA basic version liked to use Line-A for graphics). There
1.1.1.4 root 92: are also many old demos which use it for convenience.
1.1.1.2 root 93:
1.1.1.4 root 94: [1] EmuTOS has some old/partial implementations for some of the Line-A
1.1.1.2 root 95: functionality, but these are so buggy that they aren't enabled in
96: EmuTOS releases except for mouse on/off functionality.
97:
1.1.1.4 root 98: Joystick doesn't work in some (STOS) games that access it through
1.1.1.2 root 99: other means than XBIOS function Kbdvbase() or by hooking into the IKBD
1.1.1.4 root 100: interrupt vector. They probably use some unofficial system variables
1.1.1.2 root 101: which location depends on the TOS version.
102:
103:
104: Debugging issues with EmuTOS
105: ============================
106:
1.1.1.5 ! root 107: To debug problems with EmuTOS, you have to recompile it from source
! 108: after enabling the MIDI debug output in its config.h header file. Then
! 109: start Hatari with the "--midi-out /dev/stderr" optio and you will see
! 110: the EmuTOS debug output such as calls to missing Line-A functions.
! 111:
! 112: To inspect EmuTOS issues with the Hatari debugger, you'll need symbols
! 113: for the EmuTOS image you're using. If you've compiled EmuTOS with
! 114: AHCC[2], you can get suitable symbols with its "-n" linker flag, or
! 115: you can use a script coming with Hatari (ahcc-symbols-convert.sh) to
! 116: convert AHCC *.map file to "nm" format supported by the Hatari
! 117: debugger.
! 118:
! 119: After loading the symbols to the debugger, disassembling the problematic
! 120: address should provide more clues for the problem. Or you can just look
! 121: up the program counter value given in panic message from the AHCC
! 122: emutos.map file.
! 123:
! 124: Hatari profiling support (see patches on hatari-devel) can be used to
! 125: debug OS freezes. If EmuTOS gets stuck, just profile it for a while
! 126: and then ask debugger for a profile that tells where it's looping and
! 127: then disasm that part with symbols directly in Hatari.
! 128:
! 129: [2] AHCC: http://members.chello.nl/h.robbers/
1.1.1.2 root 130:
131:
132: EmuTOS compatibility lists
133: ==========================
134:
135: The compatibility lists below cater for users who don't have Atari HW
136: and therefore won't have (legal) version of commercial Atari software
137: and most likely lack motivation to investigate applications very
138: deeply (Linux offers better alternatives nowadays for most of that).
139: I.e. the list skips commercial software and concentrates on EmuTOS
140: compatibility of freely available games and demos.
141:
142: Games that are considered good quality & fun, are marked with "*".
143: All the listed demos are quite OK. Most demos can be downloaded from
144: http://pouet.net/ .
145:
146: First are listed ST demos and games, then STE demos, games and music
147: applications and last Falcon demos, games and (music) applications.
148:
149:
150: Working free/shareware Atari ST demos and games
151: -----------------------------------------------
152:
153: There are so many freely available color games and demos that from
154: those only the ones found working with EmuTOS are listed. Often the
155: non-working ones "Panic" EmuTOS.
156:
157: Demos:
158: - 4getful (by gwEm, 4KB intro)
159: - 4kker (by Checkpoint, 4KB intro)
160: - Anomaly (by MMJ-Prod)
161: - Breath (by Mystic Bytes)
162: - Darktrip (by Legend, doesn't work with >2MB of RAM)
163: - Dark Side of the Spoon (by ULM)
164: - Death of the Clock Cycles (by Aggression)
165: - Dimensio (by Condemned)
166: - Flashback (by Carebears)
167: - Frenchies (by Frenchies, 96KB intro)
168: - Hallucinations (by Reservoir Gods)
1.1.1.5 ! root 169: - Outline 2008 invite (by DHS)
! 170: - Outline 2010 invite (by Checkpoint)
1.1.1.2 root 171: - Overdose (by Aggression)
1.1.1.4 root 172: - Paradise (by Dune Design)
1.1.1.2 root 173: - Phaleon Gigademo
174: - Posh (by Checkpoint)
1.1.1.4 root 175: - Rebirth (by MMJ production)
1.1.1.5 ! root 176: - Save The Earth (by Defence Force)
1.1.1.2 root 177: - Soundtracker (by Equinox)
178: - Sweety (by DHS)
1.1.1.4 root 179: - Tut! (by Wildfire)
1.1.1.2 root 180: - Two in One (by DHS)
181: - YmRockerz musicdisks such as Popstars etc.
1.1.1.5 ! root 182: - Xmas2000 (by Paranoid)
1.1.1.2 root 183:
184: Color games:
185: - Archon 4KB
186: - Alien Blockade
187: - Bellum*
188: - Bombs Away
1.1.1.5 ! root 189: - ChuChu Rocket* (Lite version for STFM)
1.1.1.2 root 190: - Clogged Up
191: - Crapman*
192: - Dave Munsie games (shareware)
193: - Entombed
194: - Flip'em* (4KB puzzle)
195: - Grav*
196: - Hackman II*
197: - Hang About (4KB mountain climbing)
198: - Haywire
199: - Hector*
200: - Jetpac
201: - Nibe 2
202: - Nova
203: - Pengy
204: - Punt II
205: - Rockfall*
206: - Robert in the Fire Factory
207: - Santafly
208: - Snowball Fight
209: - Spacewar
210: - Starball* (shareware)
211: - Sweeper
212: - Tankx*
213: - Teserae*
214: - Yak (4KB gridrunner)
215:
216: GEM games:
1.1.1.5 ! root 217: - 4 Gewinnt* (Connect four)
1.1.1.4 root 218: - Abalone
1.1.1.5 ! root 219: - Ballerburg* (bug: mouse-over acts like click)
1.1.1.2 root 220: - Biglife*
1.1.1.5 ! root 221: - Chess* (works only from floppy)
1.1.1.4 root 222: - Clicks*
1.1.1.2 root 223: - Daleks*
1.1.1.4 root 224: - Dame
1.1.1.2 root 225: - DBWH
226: - Drachen
227: - Gem_mind
1.1.1.5 ! root 228: - Gnuchess
1.1.1.2 root 229: - Isola
230: - Kensington
231: - Mars (corewars)
232: - Mathmaze
1.1.1.5 ! root 233: - Megaroid*
1.1.1.4 root 234: - Mines*
1.1.1.2 root 235: - Nethack*
236: - Orb
237: - Pacman
238: - Shanghai
1.1.1.4 root 239: - Snake
1.1.1.5 ! root 240: - Stello*
1.1.1.2 root 241: - ST Concentration*
1.1.1.5 ! root 242: - Solitair*
1.1.1.2 root 243: - Sudoku*
1.1.1.4 root 244: - Tartan* (chess)
1.1.1.2 root 245: - Thrust
1.1.1.5 ! root 246: - Tricky yahoo
1.1.1.2 root 247: - Worm farm
248: - Wator (slow)
1.1.1.4 root 249: - zSudoku
1.1.1.2 root 250:
251: Monochrome games:
252: - Balloons
1.1.1.5 ! root 253: - Bounce
1.1.1.2 root 254: - Delta patrol
1.1.1.5 ! root 255: - Emperor (v1.0 & v1.5)
! 256: - Fun Face (playable demo)
! 257: - Go UP
1.1.1.4 root 258: - HASCS
1.1.1.5 ! root 259: - Lasermon (bug: some lines are not drawn)
! 260: - MiniGolf* (GFA basic)
1.1.1.2 root 261: - Monkey Business
262: - Mr Dash
1.1.1.5 ! root 263: - Poolmono*
1.1.1.2 root 264: - Punssi
265: - Pyro
266: - Qix
1.1.1.5 ! root 267: - Sbreak* (by Mark Overmars)
1.1.1.2 root 268: - Wallball
269: - Mandala
270:
271: Text games:
272: - Advent (Colossal Cave)
1.1.1.4 root 273: - Eliza
1.1.1.2 root 274: - Hack
275: - Larn
276: - Omega
277:
278:
279: Non-working free/shareware GEM/mono Atari ST games
280: --------------------------------------------------
281:
282: Although there are plenty of color demos and games, the number of
283: (even remotely fun) free GEM or monochrome games and demos is so low
284: that for those I list here non-working ones. Unless otherwise stated,
285: the issues in them are assumed to be Line-A related (graphics don't
286: show because they use Line-A drawing functions etc).
287:
288: GEM games:
1.1.1.5 ! root 289: - Awele (menus close immediately after opening)
1.1.1.2 root 290: - Checkers
291: - Dte (mouse gets stuck)
1.1.1.5 ! root 292: - Fs (panic)
! 293: - Gemamigo* (panic or double bus error)
! 294: - Invaders* (shots go through buildings/shields)
1.1.1.2 root 295: - Othello
1.1.1.5 ! root 296: - Patience* (dragging doesn't work, arrowheads drawn wrong)
! 297: - Risk* (dragging doesn't work)
! 298: - Verrueck (?)
! 299: - Yukon* (dragging doesn't work)
! 300:
! 301: Games that mix GEM UI and non-VDI drawing:
! 302: - Backgam
! 303: - Fishes
1.1.1.2 root 304: - Robugs*
305:
306: Mono games:
1.1.1.5 ! root 307: - Columns* (keyboard input issues)
1.1.1.2 root 308: - Crystal Caves*
309: - Domino
310: - Lokomotive
311: - MacPan*
1.1.1.5 ! root 312: - Midimaze* (joystick doesn't work)
1.1.1.2 root 313: - MineFeld
314: - Pipeline*
315: - Pling II
316: - Roll X
317: - Sherlock*
318: - Space war*
319:
320:
321: Working free/shareware Atari STE programs
322: -----------------------------------------
323:
324: There are not that many freely available or even commercial programs
325: that would be STE specific (or even STE enhanced):
326: http://atari-ste.anvil-soft.com/html/archivapps.htm
327:
328: Missing blitter support in EmuTOS (XBios function etc) is an additional
329: reason why some programs/demos (such as Blittermania) don't work with it.
330: But following STE specific demos, games and apps work (mostly) fine
331: with EmuTOS.
332:
333: Demos:
1.1.1.5 ! root 334: - 1st Step (by Tobe/MJJ Prod)
! 335: - 20 years megademo (by Atari scene collective), issues in some screens
! 336: - 20 years Atari STE megademo (by Paradox), some screen don't work
1.1.1.2 root 337: - Again (by Paradox)
338: - Armada is dead (by Aggression)
339: - Azed/Jungle demo (by Atari)
340: - Beat Demo (by Frontline)
341: - Birdie (by Zeal)
342: - CD-player (by Light)
1.1.1.5 ! root 343: - Cernit Trandafir (by DHS)
1.1.1.2 root 344: - Core Flakes (by New Core)
345: - Dynamite (by Unit 17)
346: - E605 (by Light)
1.1.1.4 root 347: - Ecstacy A (by ICE), breaks at the end
1.1.1.2 root 348: - French Kiss (by DHS)
349: - Illusion (by Next)
350: - Gobi Toons (by Dune)
351: - Grimey (by Reservoir Gods)
352: - Kick my assembler (by Orion), start doesn't look right
353: - Madness (by Cream)
354: - Mathematica (by Aura)
355: - More or Less Zero (by DHS)
1.1.1.4 root 356: - Maxymizer compo 2006 (by gwEm)
1.1.1.2 root 357: - Meshake (by Spice Boys)
358: - Mind Rewind (by Reservoir Gods)
359: - MovieSTE (by Tony Barker)
360: - New Year -94 Intro (by Extream)
361: - Pacemaker (by Paradox), stops at end-part
362: - Paracon 6 & 7 remindtros (by Paradox)
363: - Powerrise (by Light)
364: - Reanimation (by Syntax)
1.1.1.5 ! root 365: - Realtime (by MJJ Prod)
1.1.1.2 root 366: - Sinfull Sinuses (by Chronicle)
367: - STE slideshow (by DHS)
368: - STE Wars (by Tony Barker)
1.1.1.5 ! root 369: - Sommarhack (by DHS)
1.1.1.2 root 370: - Vision (by POV)
1.1.1.4 root 371: - XiTEC Presentation (by Omega)
1.1.1.2 root 372:
373: Color games:
374: - Alien Blast (demo)
375: - Battletris+
1.1.1.5 ! root 376: - ChuChu Rocket* (full version)
1.1.1.2 root 377: - Dynaplus*
378: - Frantick
379: - No Limit II (shareware pinball)
380: - Obsession* (demo of commercial pinball)
381: - Operation Garfield
382: - Pacman on E
383: - Power Up
384: - Skulls (shareware "minesweeper")
1.1.1.4 root 385: - Spy 4k
1.1.1.2 root 386: - Stardust* (tunnel sequence demo)
387: - STEtris
388: - STrEet Fighter II (incomplete)
389: - Stupid balloon game
390: - Substation* (demo)
391: - Tomtar
1.1.1.5 ! root 392: - Wolfenstein3D v0.8a* (a bit unstable)
1.1.1.2 root 393:
394: Music Applications:
395: - Blipp Blopper
396: - Desktracker
397: - MaxYMizer
398: - Octalyzer
399: - Paula
400: - Sirius Player
401:
402: Most of the non-GEM ST tracker & chip music composer programs
403: work also with EmuTOS too (not just STe ones).
404:
405:
406: "Almost" working color STE games
407: --------------------------------
408:
409: There are some STE games that would appear otherwise to work perfectly,
410: but some part of the graphics just don't show. They are listed in case
411: someone, someday, starts to fix the EmuTOS line-A things (which I
412: think are preventing these from working properly).
413:
414: - Atari Scene Card Battle (card images don't show)
415: - Blat (main graphics don't show)
416: - Breakdance (another scene game, game freezes when playing)
417: - Mr Boomer (all graphics don't show)
418: - Pooz (all graphics don't show)
419:
420:
1.1.1.4 root 421: Working TT specific demos
422: -------------------------
423:
424: - 256mbrot, Glasstro, Orion-B, Yabt (TT/Falcon intros by ray//.tSCc)
425: - 4getful (by gwEm, 4KB intro TT-version)
426: - Adebug 3DTT demo (by Brainstorm)
427: - TT highres slideshow (by .tSCc)
428: - XiTEC presentation (by Omega)
429:
430:
1.1.1.2 root 431: Working free/shareware Falcon demos, games and applications
432: -----------------------------------------------------------
433:
1.1.1.4 root 434: Missing Videl and DSP support in EmuTOS is probably the reason why
435: many of the demos and games get wrong video made and their graphics
1.1.1.2 root 436: look completely broken under EmuTOS. Following Falcon only
437: demos, games and apps work (mostly) fine though.
438:
439: Demos:
1.1.1.4 root 440: - A Rh Positive 4k (by tSSc)
1.1.1.2 root 441: - Alive (by Fun Industries)
442: - Ascii (by Reservoir Gods)
443: - ATS (by DHS)
444: - Birdshow
445: - Blue & Flu 4k (by New Beat)
1.1.1.4 root 446: - DBA Magazine 14 intro (by Lazer)
1.1.1.2 root 447: - Illusion 64 (by Paranoia)
448: - Game of Life 4k (by Aggression)
449: - Snowstorm (by Reservoir Gods)
1.1.1.4 root 450: - Terrorize Your Soul (by tSSc)
451: - fonts and colors aren't right on all screens
452: - ZZ 9 Plural Z Alpha (by tSSc)
1.1.1.2 root 453:
454: Games:
1.1.1.4 root 455: - Aces High (preview)
1.1.1.2 root 456: - Blum
457: - Columns by Deadheart (demo)*
458: - Corsair
459: - DB 4K
460: - Dry Egg (needs >4MB RAM)
461: - FalcTron
1.1.1.4 root 462: - Heretic (lower part of screen flickers, I think EmuTOS screen is too high)
1.1.1.2 root 463: - Impulse (Breakout clone)*
464: - Lamemine (needs "dummy" DSP mode in Hatari)
465: - Madtris
1.1.1.4 root 466: - Running*
1.1.1.2 root 467: - Radical Race (demo)*
468: - Rave (needs "dummy" DSP mode in Hatari)
469: - SBM v0.8 (Bomberman clone)*
470: - Spice (Defender clone)*
471: - Static
472: - Steinbruch
473: - Tank Blaster
474: - Toy Man
475: - Vertical Mayhem (Columns clone)*
476: - Willie's Adventure (preview)*
477:
1.1.1.5 ! root 478: Utilities:
! 479: - Cecile hard disk (image) driver
! 480:
1.1.1.2 root 481: Mostly working applications:
482: - AceMidi demo (softsynth sounds needs DSP)
483: - FlaySID (sound needs DSP)
484: - Fractal Playground (parameter input doesn't work)
485: - Kronos (benchmark)
486: - Whip! (virtual light machine)
487:
488: Almost working demos & games:
489: - Bugger, Bunion, SkyFall, Switch, Sworm games* by Resorvoir Gods:
1.1.1.4 root 490: - have issues with keyboard input in the main menus, doesn't get input
491: or input freezes the game
492: - Motion (unfinished demo by Aggression)
493: - only writer screens work
494: - Nibe:
495: - screen is messed, I suspect EmuTOS is missing resolution change function
1.1.1.2 root 496: - Virtual City (needs DSP): city is invisible with EmuTOS
497:
1.1 root 498:
1.1.1.2 root 499: - Eero
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.