Return to emutos.txt CVS log

Up to [HATARI the Atari ST Emulator] / hatari / doc

Annotation of hatari/doc/emutos.txt, revision 1.1.1.2

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: - Wolfenstein3D v0.5 (titlescreen colors are not right)
        !           330:   - the playable v0.8 doesn't work at all
        !           331: 
        !           332: Color games:
        !           333: - Alien Blast (demo)
        !           334: - Battletris+
        !           335: - Dynaplus*
        !           336: - Frantick
        !           337: - No Limit II (shareware pinball)
        !           338: - Obsession* (demo of commercial pinball)
        !           339: - Operation Garfield
        !           340: - Pacman on E
        !           341: - Power Up
        !           342: - Skulls (shareware "minesweeper")
        !           343: - Stardust* (tunnel sequence demo)
        !           344: - STEtris
        !           345: - STrEet Fighter II (incomplete)
        !           346: - Stupid balloon game
        !           347: - Substation* (demo)
        !           348: - Tomtar
        !           349: 
        !           350: Music Applications:
        !           351: - Blipp Blopper
        !           352: - Desktracker
        !           353: - MaxYMizer
        !           354: - Octalyzer
        !           355: - Paula
        !           356: - Sirius Player
        !           357: 
        !           358: Most of the non-GEM ST tracker & chip music composer programs
        !           359: work also with EmuTOS too (not just STe ones).
        !           360: 
        !           361: 
        !           362: "Almost" working color STE games
        !           363: --------------------------------
        !           364: 
        !           365: There are some STE games that would appear otherwise to work perfectly,
        !           366: but some part of the graphics just don't show.  They are listed in case
        !           367: someone, someday, starts to fix the EmuTOS line-A things (which I
        !           368: think are preventing these from working properly).
        !           369: 
        !           370: - Atari Scene Card Battle (card images don't show)
        !           371: - Blat (main graphics don't show)
        !           372: - Breakdance (another scene game, game freezes when playing)
        !           373: - Mr Boomer (all graphics don't show)
        !           374: - Pooz (all graphics don't show)
        !           375: 
        !           376: 
        !           377: Working free/shareware Falcon demos, games and applications
        !           378: -----------------------------------------------------------
        !           379: 
        !           380: Missing Videl support in EmuTOS is probably the reason why many
        !           381: of the demos and games get wrong video made and their graphics
        !           382: look completely broken under EmuTOS.  Following Falcon only
        !           383: demos, games and apps work (mostly) fine though.
        !           384: 
        !           385: Demos:
        !           386: - Alive (by Fun Industries)
        !           387: - Ascii (by Reservoir Gods)
        !           388: - ATS (by DHS)
        !           389: - Birdshow
        !           390: - Blue & Flu 4k (by New Beat)
        !           391: - Illusion 64 (by Paranoia)
        !           392: - Game of Life 4k (by Aggression)
        !           393: - Snowstorm (by Reservoir Gods)
        !           394: - ZZ 9 Plural Z Alpha (by .tssc)
        !           395: 
        !           396: Games:
        !           397: - Blum
        !           398: - Columns by Deadheart (demo)*
        !           399: - Corsair
        !           400: - DB 4K
        !           401: - Dry Egg (needs >4MB RAM)
        !           402: - FalcTron
        !           403: - Impulse (Breakout clone)*
        !           404: - Lamemine (needs "dummy" DSP mode in Hatari)
        !           405: - Madtris
        !           406: - Radical Race (demo)*
        !           407: - Rave (needs "dummy" DSP mode in Hatari)
        !           408: - SBM v0.8 (Bomberman clone)*
        !           409: - Spice (Defender clone)*
        !           410: - Static
        !           411: - Steinbruch
        !           412: - Tank Blaster
        !           413: - Toy Man
        !           414: - Vertical Mayhem (Columns clone)*
        !           415: - Willie's Adventure (preview)*
        !           416: 
        !           417: Mostly working applications:
        !           418: - AceMidi demo (softsynth sounds needs DSP)
        !           419: - FlaySID (sound needs DSP)
        !           420: - Fractal Playground (parameter input doesn't work)
        !           421: - Kronos (benchmark)
        !           422: - Whip! (virtual light machine)
        !           423: 
        !           424: Almost working demos & games:
        !           425: - Bugger, Bunion, SkyFall, Switch, Sworm games* by Resorvoir Gods:
        !           426:   have issues with keyboard input in the main menus
        !           427: - Heretic: screen is messed
        !           428: - Nibe: screen is messed
        !           429: - Virtual City (needs DSP): city is invisible with EmuTOS
        !           430: 
1.1       root      431: 
1.1.1.2 ! root      432:        - Eero

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.