|
|
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.6 ! root 107: To debug problems with EmuTOS, you have to recompile it from the source
1.1.1.5 root 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
1.1.1.6 ! root 121: up the program counter value given in the EmuTOS panic message from
! 122: the AHCC emutos.map file.
1.1.1.5 root 123:
1.1.1.6 ! root 124: Hatari profiling support can be used to debug OS freezes. If EmuTOS gets
! 125: stuck, just profile it for a while and then ask debugger for a profile
! 126: that tells where it's looping and then disassemble that part with symbols
! 127: directly in Hatari. More information on the debugger and profiling is
! 128: in the Hatari manual.
1.1.1.5 root 129:
130: [2] AHCC: http://members.chello.nl/h.robbers/
1.1.1.2 root 131:
132:
133: EmuTOS compatibility lists
134: ==========================
135:
136: The compatibility lists below cater for users who don't have Atari HW
137: and therefore won't have (legal) version of commercial Atari software
138: and most likely lack motivation to investigate applications very
139: deeply (Linux offers better alternatives nowadays for most of that).
140: I.e. the list skips commercial software and concentrates on EmuTOS
141: compatibility of freely available games and demos.
142:
143: Games that are considered good quality & fun, are marked with "*".
144: All the listed demos are quite OK. Most demos can be downloaded from
145: http://pouet.net/ .
146:
147: First are listed ST demos and games, then STE demos, games and music
148: applications and last Falcon demos, games and (music) applications.
149:
150:
151: Working free/shareware Atari ST demos and games
152: -----------------------------------------------
153:
154: There are so many freely available color games and demos that from
155: those only the ones found working with EmuTOS are listed. Often the
156: non-working ones "Panic" EmuTOS.
157:
158: Demos:
1.1.1.6 ! root 159: - 2011 (by Positivity & Sector One, 4kB intro)
1.1.1.2 root 160: - 4getful (by gwEm, 4KB intro)
161: - 4kker (by Checkpoint, 4KB intro)
162: - Anomaly (by MMJ-Prod)
163: - Breath (by Mystic Bytes)
1.1.1.6 ! root 164: - Coast II Coast (by Sector One, 4kB intro)
1.1.1.2 root 165: - Darktrip (by Legend, doesn't work with >2MB of RAM)
166: - Dark Side of the Spoon (by ULM)
167: - Death of the Clock Cycles (by Aggression)
168: - Dimensio (by Condemned)
169: - Flashback (by Carebears)
170: - Frenchies (by Frenchies, 96KB intro)
1.1.1.6 ! root 171: - Grafik -und Sounddemo (by Eckhard Kruse, font issues)
1.1.1.2 root 172: - Hallucinations (by Reservoir Gods)
1.1.1.5 root 173: - Outline 2008 invite (by DHS)
174: - Outline 2010 invite (by Checkpoint)
1.1.1.2 root 175: - Overdose (by Aggression)
1.1.1.4 root 176: - Paradise (by Dune Design)
1.1.1.2 root 177: - Phaleon Gigademo
178: - Posh (by Checkpoint)
1.1.1.4 root 179: - Rebirth (by MMJ production)
1.1.1.5 root 180: - Save The Earth (by Defence Force)
1.1.1.6 ! root 181: - SillyVenture 2k10 & 2k11 (invitros by Mystic Bytes & Aggression)
! 182: - Sommarhack 2011 (invite by DHS)
1.1.1.2 root 183: - Soundtracker (by Equinox)
1.1.1.6 ! root 184: - ST soccer (intro by Exceptions)
! 185: - Stone tower (by FUN)
! 186: - Superstar! (intro by Positivity/Dma-Sc/Ukko)
1.1.1.2 root 187: - Sweety (by DHS)
1.1.1.6 ! root 188: - Twelve (by Paulo Simoes)
1.1.1.4 root 189: - Tut! (by Wildfire)
1.1.1.2 root 190: - Two in One (by DHS)
1.1.1.6 ! root 191: - Visualize (by Checkpoint)
! 192: - YmRockerz musicdisks from "Wave upon Wave" to "Seven"
1.1.1.5 root 193: - Xmas2000 (by Paranoid)
1.1.1.2 root 194:
195: Color games:
196: - Archon 4KB
197: - Alien Blockade
198: - Bellum*
199: - Bombs Away
1.1.1.5 root 200: - ChuChu Rocket* (Lite version for STFM)
1.1.1.2 root 201: - Clogged Up
202: - Crapman*
203: - Dave Munsie games (shareware)
204: - Entombed
205: - Flip'em* (4KB puzzle)
206: - Grav*
207: - Hackman II*
208: - Hang About (4KB mountain climbing)
209: - Haywire
210: - Hector*
211: - Jetpac
212: - Nibe 2
213: - Nova
214: - Pengy
215: - Punt II
216: - Rockfall*
217: - Robert in the Fire Factory
218: - Santafly
219: - Snowball Fight
220: - Spacewar
221: - Starball* (shareware)
222: - Sweeper
223: - Tankx*
224: - Teserae*
225: - Yak (4KB gridrunner)
226:
227: GEM games:
1.1.1.5 root 228: - 4 Gewinnt* (Connect four)
1.1.1.4 root 229: - Abalone
1.1.1.5 root 230: - Ballerburg* (bug: mouse-over acts like click)
1.1.1.2 root 231: - Biglife*
1.1.1.5 root 232: - Chess* (works only from floppy)
1.1.1.4 root 233: - Clicks*
1.1.1.2 root 234: - Daleks*
1.1.1.4 root 235: - Dame
1.1.1.2 root 236: - DBWH
237: - Drachen
238: - Gem_mind
1.1.1.5 root 239: - Gnuchess
1.1.1.2 root 240: - Isola
241: - Kensington
242: - Mars (corewars)
243: - Mathmaze
1.1.1.5 root 244: - Megaroid*
1.1.1.4 root 245: - Mines*
1.1.1.2 root 246: - Nethack*
247: - Orb
248: - Pacman
249: - Shanghai
1.1.1.4 root 250: - Snake
1.1.1.5 root 251: - Stello*
1.1.1.2 root 252: - ST Concentration*
1.1.1.5 root 253: - Solitair*
1.1.1.2 root 254: - Sudoku*
1.1.1.4 root 255: - Tartan* (chess)
1.1.1.2 root 256: - Thrust
1.1.1.5 root 257: - Tricky yahoo
1.1.1.2 root 258: - Worm farm
259: - Wator (slow)
1.1.1.4 root 260: - zSudoku
1.1.1.2 root 261:
262: Monochrome games:
263: - Balloons
1.1.1.5 root 264: - Bounce
1.1.1.2 root 265: - Delta patrol
1.1.1.5 root 266: - Emperor (v1.0 & v1.5)
267: - Fun Face (playable demo)
268: - Go UP
1.1.1.4 root 269: - HASCS
1.1.1.6 ! root 270: - Lasermon
! 271: - Mandala
1.1.1.5 root 272: - MiniGolf* (GFA basic)
1.1.1.2 root 273: - Monkey Business
274: - Mr Dash
1.1.1.5 root 275: - Poolmono*
1.1.1.2 root 276: - Punssi
277: - Pyro
278: - Qix
1.1.1.5 root 279: - Sbreak* (by Mark Overmars)
1.1.1.2 root 280: - Wallball
1.1.1.6 ! root 281: - Space war (bug: score missing)
1.1.1.2 root 282:
283: Text games:
284: - Advent (Colossal Cave)
1.1.1.4 root 285: - Eliza
1.1.1.2 root 286: - Hack
287: - Larn
288: - Omega
289:
290:
291: Non-working free/shareware GEM/mono Atari ST games
292: --------------------------------------------------
293:
294: Although there are plenty of color demos and games, the number of
295: (even remotely fun) free GEM or monochrome games and demos is so low
296: that for those I list here non-working ones. Unless otherwise stated,
297: the issues in them are assumed to be Line-A related (graphics don't
298: show because they use Line-A drawing functions etc).
299:
300: GEM games:
1.1.1.6 ! root 301: - Awele (menus close immediately after opening)
1.1.1.2 root 302: - Checkers
1.1.1.6 ! root 303: - Dte (mouse gets stuck)
! 304: - Fs (panic)
1.1.1.5 root 305: - Gemamigo* (panic or double bus error)
1.1.1.6 ! root 306: - Invaders* (shots go through buildings/shields???)
1.1.1.2 root 307: - Othello
1.1.1.5 root 308: - Patience* (dragging doesn't work, arrowheads drawn wrong)
1.1.1.6 ! root 309: - Risk* (dragging doesn't work)
! 310: - Verrueck (?)
! 311: - Yukon* (dragging doesn't work)
1.1.1.5 root 312:
313: Games that mix GEM UI and non-VDI drawing:
1.1.1.6 ! root 314: - Backgam (line-A bitblit)
! 315: - Fishes (line-A line and filled rectangle)
! 316: - Robugs* (line-A filled rectangle and draw sprite)
1.1.1.2 root 317:
318: Mono games:
1.1.1.6 ! root 319: - Columns* (keyboard input issues)
! 320: - Crystal Caves* (Line-A bitblit and draw/clear sprite)
! 321: - Domino (line-A bitblit)
! 322: - Lokomotive (line-A bitblit)
! 323: - MacPan* (Line-A draw/clear sprite)
! 324: - Midimaze* (joystick doesn't work)
! 325: - MineFeld (Line-A draw/clear sprite)
! 326: - Pipeline* (line-A line and filled rectangle)
! 327: - Pling II (Line-A bitblit and draw/clear sprite)
! 328: - Roll X (line-A bitblit and get pixel)
! 329: - Sherlock* (many of the texts missing, not line-A issue)
1.1.1.2 root 330:
331:
332: Working free/shareware Atari STE programs
333: -----------------------------------------
334:
335: There are not that many freely available or even commercial programs
336: that would be STE specific (or even STE enhanced):
337: http://atari-ste.anvil-soft.com/html/archivapps.htm
338:
1.1.1.6 ! root 339: Missing DMA and Blitter support in EmuTOS (XBios functions etc) is
! 340: an additional reason why some programs/demos (such as Blittermania)
! 341: don't work with it. But following STE specific demos, games and apps
! 342: work (mostly) fine with EmuTOS.
1.1.1.2 root 343:
344: Demos:
1.1.1.5 root 345: - 1st Step (by Tobe/MJJ Prod)
346: - 20 years megademo (by Atari scene collective), issues in some screens
347: - 20 years Atari STE megademo (by Paradox), some screen don't work
1.1.1.2 root 348: - Again (by Paradox)
349: - Armada is dead (by Aggression)
350: - Azed/Jungle demo (by Atari)
351: - Beat Demo (by Frontline)
352: - Birdie (by Zeal)
1.1.1.6 ! root 353: - Blue Period (by Paradox)
1.1.1.2 root 354: - CD-player (by Light)
1.1.1.5 root 355: - Cernit Trandafir (by DHS)
1.1.1.2 root 356: - Core Flakes (by New Core)
357: - Dynamite (by Unit 17)
358: - E605 (by Light)
1.1.1.4 root 359: - Ecstacy A (by ICE), breaks at the end
1.1.1.2 root 360: - French Kiss (by DHS)
361: - Illusion (by Next)
362: - Gobi Toons (by Dune)
363: - Grimey (by Reservoir Gods)
1.1.1.6 ! root 364: - High Fidelity Dreams (by Aura)
! 365: - HighResMode (by Paradox)
1.1.1.2 root 366: - Kick my assembler (by Orion), start doesn't look right
367: - Madness (by Cream)
368: - Mathematica (by Aura)
369: - More or Less Zero (by DHS)
1.1.1.4 root 370: - Maxymizer compo 2006 (by gwEm)
1.1.1.2 root 371: - Meshake (by Spice Boys)
372: - Mind Rewind (by Reservoir Gods)
373: - MovieSTE (by Tony Barker)
374: - New Year -94 Intro (by Extream)
1.1.1.6 ! root 375: - No Monkey (by Tomchi), some extra pixels in first text scroller
1.1.1.2 root 376: - Pacemaker (by Paradox), stops at end-part
377: - Paracon 6 & 7 remindtros (by Paradox)
1.1.1.6 ! root 378: - Power Rise (by Light)
1.1.1.2 root 379: - Reanimation (by Syntax)
1.1.1.5 root 380: - Realtime (by MJJ Prod)
1.1.1.2 root 381: - Sinfull Sinuses (by Chronicle)
1.1.1.6 ! root 382: - Sommarhack (by DHS)
1.1.1.2 root 383: - STE slideshow (by DHS)
384: - STE Wars (by Tony Barker)
1.1.1.6 ! root 385: - Summer Delights (by DHS), sound missing
! 386: - Sventure intro (by Paradox)
1.1.1.2 root 387: - Vision (by POV)
1.1.1.4 root 388: - XiTEC Presentation (by Omega)
1.1.1.2 root 389:
390: Color games:
1.1.1.6 ! root 391: - 4K Pacman (bug: background not cleared to black)
! 392: - Aerial Combat 3
1.1.1.2 root 393: - Alien Blast (demo)
394: - Battletris+
1.1.1.5 root 395: - ChuChu Rocket* (full version)
1.1.1.2 root 396: - Dynaplus*
397: - Frantick
398: - No Limit II (shareware pinball)
399: - Obsession* (demo of commercial pinball)
400: - Operation Garfield
401: - Pacman on E
402: - Power Up
403: - Skulls (shareware "minesweeper")
1.1.1.4 root 404: - Spy 4k
1.1.1.2 root 405: - Stardust* (tunnel sequence demo)
406: - STEtris
407: - STrEet Fighter II (incomplete)
408: - Stupid balloon game
409: - Substation* (demo)
410: - Tomtar
1.1.1.6 ! root 411: - Utopos* (demo)
1.1.1.5 root 412: - Wolfenstein3D v0.8a* (a bit unstable)
1.1.1.2 root 413:
1.1.1.6 ! root 414: STE (enhanced) music applications:
1.1.1.2 root 415: - Blipp Blopper
416: - Desktracker
1.1.1.6 ! root 417: - Hextracker
1.1.1.2 root 418: - MaxYMizer
419: - Octalyzer
420: - Paula
421: - Sirius Player
422:
423: Most of the non-GEM ST tracker & chip music composer programs
424: work also with EmuTOS too (not just STe ones).
425:
1.1.1.6 ! root 426: Protracker STE complains about missing DMA.
! 427:
1.1.1.2 root 428:
429: "Almost" working color STE games
430: --------------------------------
431:
1.1.1.6 ! root 432: There are some STE (enhanced) games that would appear otherwise to
! 433: work perfectly, but some part of the graphics just don't show. They
! 434: are listed in case someone, someday, starts to fix the EmuTOS line-A
! 435: things (mainly bitblt).
1.1.1.2 root 436:
437: - Atari Scene Card Battle (card images don't show)
438: - Blat (main graphics don't show)
439: - Breakdance (another scene game, game freezes when playing)
440: - Mr Boomer (all graphics don't show)
1.1.1.6 ! root 441: - Kolmik (tiles don't show)
1.1.1.2 root 442: - Pooz (all graphics don't show)
443:
444:
1.1.1.4 root 445: Working TT specific demos
446: -------------------------
447:
448: - 256mbrot, Glasstro, Orion-B, Yabt (TT/Falcon intros by ray//.tSCc)
449: - 4getful (by gwEm, 4KB intro TT-version)
450: - Adebug 3DTT demo (by Brainstorm)
451: - TT highres slideshow (by .tSCc)
452: - XiTEC presentation (by Omega)
453:
454:
1.1.1.2 root 455: Working free/shareware Falcon demos, games and applications
456: -----------------------------------------------------------
457:
1.1.1.4 root 458: Missing Videl and DSP support in EmuTOS is probably the reason why
1.1.1.6 ! root 459: many of the demos and games get wrong video mode and their graphics
1.1.1.2 root 460: look completely broken under EmuTOS. Following Falcon only
461: demos, games and apps work (mostly) fine though.
462:
463: Demos:
1.1.1.4 root 464: - A Rh Positive 4k (by tSSc)
1.1.1.2 root 465: - Alive (by Fun Industries)
466: - Ascii (by Reservoir Gods)
467: - ATS (by DHS)
468: - Birdshow
469: - Blue & Flu 4k (by New Beat)
1.1.1.4 root 470: - DBA Magazine 14 intro (by Lazer)
1.1.1.2 root 471: - Illusion 64 (by Paranoia)
472: - Game of Life 4k (by Aggression)
473: - Snowstorm (by Reservoir Gods)
1.1.1.4 root 474: - Terrorize Your Soul (by tSSc)
475: - fonts and colors aren't right on all screens
1.1.1.6 ! root 476: - Virtual City (needs DSP)
1.1.1.4 root 477: - ZZ 9 Plural Z Alpha (by tSSc)
1.1.1.2 root 478:
479: Games:
1.1.1.4 root 480: - Aces High (preview)
1.1.1.2 root 481: - Blum
482: - Columns by Deadheart (demo)*
483: - Corsair
484: - DB 4K
485: - Dry Egg (needs >4MB RAM)
486: - FalcTron
1.1.1.4 root 487: - Heretic (lower part of screen flickers, I think EmuTOS screen is too high)
1.1.1.2 root 488: - Impulse (Breakout clone)*
489: - Lamemine (needs "dummy" DSP mode in Hatari)
490: - Madtris
1.1.1.4 root 491: - Running*
1.1.1.2 root 492: - Radical Race (demo)*
493: - Rave (needs "dummy" DSP mode in Hatari)
494: - SBM v0.8 (Bomberman clone)*
495: - Spice (Defender clone)*
1.1.1.6 ! root 496: - Static (Patience by Reservoir Gods)
1.1.1.2 root 497: - Steinbruch
498: - Tank Blaster
499: - Toy Man
500: - Vertical Mayhem (Columns clone)*
501: - Willie's Adventure (preview)*
502:
1.1.1.6 ! root 503: Games working with extra hacks:
! 504: - Bugger, Bunion, SkyFall, Sworm games by Resorvoir Gods:
! 505: - use an undocumented TOS4 vector for keyboard input instead of accessing
! 506: kbdvec correctly which use causes EmuTOS to panic. This can be worked
! 507: around with the following hack.prg:
! 508: http://sourceforge.net/mailarchive/message.php?msg_id=26841274
! 509: - with EmuTOS enabling DSP freezes the games right at startup
! 510: (with normal TOS4, DSP is used for background music)
! 511:
1.1.1.5 root 512: Utilities:
513: - Cecile hard disk (image) driver
514:
1.1.1.2 root 515: Mostly working applications:
1.1.1.6 ! root 516: - AceMidi demo (softsynth sounds need DSP)
1.1.1.2 root 517: - FlaySID (sound needs DSP)
518: - Fractal Playground (parameter input doesn't work)
519: - Kronos (benchmark)
520: - Whip! (virtual light machine)
521:
522: Almost working demos & games:
1.1.1.6 ! root 523: - Double Bobble 2000, Tautlogy & Tautology II by Reservoir Gods, Nibe:
! 524: - screen is messed, I suspect EmuTOS is missing resolution change function
1.1.1.4 root 525: - Motion (unfinished demo by Aggression)
526: - only writer screens work
1.1.1.2 root 527:
1.1 root 528:
1.1.1.2 root 529: - Eero
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.