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

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
1.1.1.8 ! root        8:   - EmuTOS debug output and debug symbols
        !             9:   - Debugging panics
        !            10:   - Debugging freezes
1.1.1.2   root       11: - EmuTOS compatibility lists
                     12:   - Working free/shareware Atari ST demos and games
                     13:   - Non-working free/shareware GEM/mono Atari ST games
1.1.1.8 ! root       14:   - Atari ST drawing programs / image viewers
        !            15:   - Atari ST MIDI programs
1.1.1.2   root       16:   - Working free/shareware Atari STE programs
1.1.1.8 ! root       17:   - "Almost" working color Atari STE programs
        !            18:   - Atari TT programs
        !            19:   - Falcon free/shareware demos, games and applications
1.1.1.2   root       20: 
                     21: 
                     22: Hatari and EmuTOS
                     23: =================
                     24: 
1.1.1.7   root       25: To run the emulator, a TOS ROM image is needed.  EmuTOS, a free
1.1.1.2   root       26: implementation of TOS, is shipped with the official releases of
                     27: Hatari.
                     28: 
                     29: This tos.img ROM image is identical to the official binary package of
                     30: EmuTOS, which is available at the SourceForge website of EmuTOS.  For
                     31: downloading other versions or the source code of EmuTOS, please visit
                     32: the EmuTOS website.
                     33: 
1.1.1.8 ! root       34: The tos.img file included with the latest Hatari releases is
        !            35: the etos512k.img[1] from a preceeding EmuTOS release:
        !            36: - Hatari v1.6.2:
        !            37:   http://sourceforge.net/projects/emutos/files/emutos/0.8.7/
1.1.1.7   root       38: - Hatari v1.6.0:
                     39:   http://sourceforge.net/projects/emutos/files/emutos/0.8.6/
                     40: - Hatari v1.4.0, v1.5.0:
                     41:   http://sourceforge.net/projects/emutos/files/emutos/0.8.5/
                     42: - Hatari v1.1.0, v1.2.0, v1.3.0, v1.3.1:
                     43:   http://sourceforge.net/projects/emutos/files/emutos/0.8.4/
                     44: - Hatari v1.0.0, v1.0.1:
                     45:   http://sourceforge.net/projects/emutos/files/emutos/0.8.3/
                     46: - Hatari v0.95:
                     47:   http://sourceforge.net/projects/emutos/files/emutos/0.8.2/
                     48: 
                     49: Earlier Hatari binary releases have included one of the smaller
                     50: EmuTOS image files.
                     51: 
1.1.1.8 ! root       52: [1] the "all languages" version intended mainly for TT & Falcon.
        !            53:     While the 192k and 256k version on some cases work better
        !            54:     for ST and STE programs, only the 512k image contains
        !            55:     support for all the hardware and languages.
        !            56: 
        !            57: Note for EmuTOS before 0.8.6:
1.1.1.7   root       58:   In order to work with Hatari, EmuTOS 0.8.5 and earlier require
                     59:   the FastBoot option to be enabled. This is used to skip some memory
1.1.1.8 ! root       60:   tests (that Hatari doesn't support yet) when EmuTOS tries to
        !            61:   determine the available RAM size.
        !            62: 
1.1.1.2   root       63: 
                     64: What is EmuTOS
                     65: ==============
                     66: 
                     67: EmuTOS is a single-user single-tasking operating system for the 32-bit
                     68: Atari computers and emulators.  It can be used as a replacement for
1.1.1.5   root       69: the TOS images typically needed today for using the emulators and it is
                     70: also running on some real hardware, like the Atari Mega STE and Atari
                     71: ColdFire.  All the source code is open and free, licensed under the
                     72: GNU General Public License (GPL).  A copy of the GNU GPL can be found
                     73: in the gpl.txt file.
1.1       root       74: 
                     75: EmuTOS has its home at SourceForge:
1.1.1.2   root       76:        http://sourceforge.net/projects/emutos
                     77: 
                     78: 
                     79: EmuTOS usage
                     80: ============
                     81: 
1.1.1.5   root       82: There are various reasons for using EmuTOS instead of the original
                     83: TOS ROM images:
1.1.1.2   root       84: 
                     85: * Users who don't have Atari HW or other legal means to obtain the
                     86:   original Atari TOS ROMs (for all of the Hatari supported Atari
                     87:   versions: ST/STE/TT/Falcon), but would like to try out Hatari and
1.1.1.5   root       88:   see what kind of software the Atari machines had.  EmuTOS gives
                     89:   them a legal way to test Hatari with free demos, games etc.
1.1.1.2   root       90: 
                     91: * Users who want to continue using Atari compatible operating systems
1.1.1.7   root       92:   and need an open source replacement of TOS for modifications. Beside
1.1.1.2   root       93:   EmuTOS they typically alse use FreeMiNT, XaAES and fVDI as operating
                     94:   system replacements/improvements.
                     95: 
1.1.1.5   root       96: * This includes users of new "Atari" machines like Atari ColdFire project,
                     97:   which isn't 100% compatible at HW level to the original Atari machines:
                     98:        http://acp.atari.org/
                     99: 
                    100: * EmuTOS also allows using ACSI disk images with Hatari TT/Falcon
1.1.1.4   root      101:   emulation, whereas TOS 3 & 4 support only IDE and SCSI disks.
                    102:   Hard disk images are needed mainly for running MiNT.
1.1.1.2   root      103: 
                    104: 
                    105: EmuTOS compatibility
                    106: ====================
                    107: 
1.1.1.7   root      108: These comments apply to EmuTOS v0.8.x.
1.1.1.5   root      109: 
1.1.1.2   root      110: Many commercial games and applications work fine with EmuTOS. This is
                    111: because games (like Bombjack, Nebulus, Oids, Super Hang-On, Turrican,
                    112: Xenon...) use directly the hardware which Hatari emulates just fine
                    113: and applications use the correct higher level APIs (AES/VDI) for which
                    114: EmuTOS has implementations.
                    115: 
1.1.1.5   root      116: EmuTOS AES support is somewhat buggy (mouse clicks and dragging
                    117: doesn't always work properly) and VDI support is slowish. Anybody
                    118: wanting proper AES/VDI support should install replacement for these,
                    119: either the free XaAES + fVDI, or the earlier commercial solutions like
                    120: NVDI.
1.1.1.2   root      121: 
1.1.1.8 ! root      122: Free games have the issue that some of them use the Line-A functionality
1.1.1.2   root      123: which is not supported by EmuTOS[1] unlike AES/VDI.  This is partly a
                    124: problem with the tools that they've been done with (for example older
                    125: STOS and GFA basic version liked to use Line-A for graphics). There
1.1.1.4   root      126: are also many old demos which use it for convenience.
1.1.1.2   root      127: 
1.1.1.4   root      128: [1] EmuTOS has some old/partial implementations for some of the Line-A
1.1.1.2   root      129:     functionality, but these are so buggy that they aren't enabled in
                    130:     EmuTOS releases except for mouse on/off functionality.
                    131: 
1.1.1.4   root      132: Joystick doesn't work in some (STOS) games that access it through
1.1.1.2   root      133: other means than XBIOS function Kbdvbase() or by hooking into the IKBD
1.1.1.4   root      134: interrupt vector.  They probably use some unofficial system variables
1.1.1.2   root      135: which location depends on the TOS version.
                    136: 
                    137: 
                    138: Debugging issues with EmuTOS
                    139: ============================
                    140: 
1.1.1.8 ! root      141: EmuTOS debug output and debug symbols
        !           142: -------------------------------------
        !           143: 
        !           144: To get EmuTOS's own debug output, you need to recompile it from the source
1.1.1.5   root      145: after enabling the MIDI debug output in its config.h header file. Then
1.1.1.8 ! root      146: start Hatari with the "--midi-out /dev/stderr" option and you will see
        !           147: the EmuTOS debug output (such as calls to missing Line-A functions).
        !           148: 
        !           149: If you've compiled EmuTOS with AHCC[1], you can get suitable symbols
        !           150: with its "-n" linker flag, or you can use a script coming with Hatari
        !           151: (ahcc-symbols-convert.sh) to convert AHCC *.map file to "nm" format
        !           152: supported by the Hatari debugger.
        !           153: 
        !           154: [1] AHCC: http://members.chello.nl/h.robbers/
        !           155: 
        !           156: After loading the symbols to the debugger, disassembling the
        !           157: problematic address should provide more clues for the problem.  Or you
        !           158: can just look up the program counter value given in the EmuTOS panic
        !           159: message from the AHCC emutos.map file.
        !           160: 
        !           161: Debugging panics
        !           162: ----------------
        !           163: 
        !           164: When debugging EmuTOS panics, the best option is to start Hatari with
        !           165: --bios-intercept (to be able to track Bios & XBios calls) and ask
        !           166: Hatari debugger to stop when the program is started:
        !           167: -----------
        !           168: > b pc=TEXT
        !           169: CPU condition breakpoint 1 with 1 condition(s) added:
        !           170: pc = TEXT
        !           171: > c
        !           172: Returning to emulation...
        !           173: -----------
        !           174: '>' in above example indicates what you type to debugger.
        !           175: 
        !           176: Then when the debugger is invoked at program startup, you can then ask
        !           177: it to:
        !           178: - collect CPU instruction history,
        !           179: - break on exceptions that trigger the panic, and
        !           180: - trace all OS calls and line-A opcodes leading to it
        !           181: with:
        !           182: -----------
        !           183: > history on
        !           184: > setopt -D
        !           185: Exception debugging enabled.
        !           186: > trace os_all
        !           187: > b LineAOpcode ! LineAOpcode :trace
        !           188: CPU condition breakpoint 2 with 1 condition(s) added:
        !           189: LineAOpcode ! LineAOpcode
        !           190: -> Track value changes, show value(s) when matched.
        !           191: -> Trace instead of breaking, but show still hits.
        !           192: > c
        !           193: Returning to emulation...
        !           194: -----------
        !           195: 
        !           196: So that when the exception causing the panic triggers the debug, you
        !           197: see the OS calls and line-A opcodes leading to it. You can then ask
        !           198: what the register values are at that point and the CPU instructions
        !           199: leading to that with the "r" and "history" commands.  Memory state and
        !           200: addresses accessed by the instructions can be inspected with the "m"
        !           201: command.
        !           202: 
        !           203: For more info on Hatari debugger usage, see the Hatari manual section
        !           204: on it.
1.1.1.5   root      205: 
1.1.1.8 ! root      206: Debugging freezes
        !           207: -----------------
1.1.1.5   root      208: 
1.1.1.6   root      209: Hatari profiling support can be used to debug OS freezes.  If EmuTOS gets
                    210: stuck, just profile it for a while and then ask debugger for a profile
                    211: that tells where it's looping and then disassemble that part with symbols
1.1.1.8 ! root      212: directly in Hatari.
1.1.1.5   root      213: 
1.1.1.8 ! root      214: With EmuTOS debug symbols, you can also ask debugger to "trace
        !           215: cpu_symbols" to get trace of all the EmuTOS function calls.
1.1.1.2   root      216: 
                    217: 
                    218: EmuTOS compatibility lists
                    219: ==========================
                    220: 
                    221: The compatibility lists below cater for users who don't have Atari HW
                    222: and therefore won't have (legal) version of commercial Atari software
                    223: and most likely lack motivation to investigate applications very
                    224: deeply (Linux offers better alternatives nowadays for most of that).
1.1.1.8 ! root      225: I.e. the lists skip commercial software and concentrate on EmuTOS
1.1.1.2   root      226: compatibility of freely available games and demos.
                    227: 
                    228: Games that are considered good quality & fun, are marked with "*".
1.1.1.8 ! root      229: All the listed demos are quite OK. Most demos can be downloaded from:
        !           230:        http://pouet.net/
1.1.1.2   root      231: 
1.1.1.8 ! root      232: First are listed ST demos, games graphics and MIDI applications,
        !           233: then STE demos, games and music applications, then TT programs
        !           234: and last Falcon demos, games and (mostly music) applications.
1.1.1.2   root      235: 
                    236: 
                    237: Working free/shareware Atari ST demos and games
                    238: -----------------------------------------------
                    239: 
                    240: There are so many freely available color games and demos that from
                    241: those only the ones found working with EmuTOS are listed. Often the
                    242: non-working ones "Panic" EmuTOS.
                    243: 
1.1.1.8 ! root      244: For best compatibility with ST emulation, one should use 192kB
        !           245: or 256kB version of EmuTOS.
        !           246: 
        !           247: Additionally, several of the demos below (on floppy images) need
        !           248: EmuTOS v0.8.7 or newer.
        !           249: 
        !           250: 
1.1.1.2   root      251: Demos:
1.1.1.6   root      252: - 2011 (by Positivity & Sector One, 4kB intro)
1.1.1.2   root      253: - 4getful (by gwEm, 4KB intro)
                    254: - 4kker (by Checkpoint, 4KB intro)
                    255: - Anomaly (by MMJ-Prod)
                    256: - Breath (by Mystic Bytes)
1.1.1.8 ! root      257: - Beyond Imagination (by NLC), in GFA basic
        !           258: - Calimer-o (by Oxygene)
        !           259: - Charts Compilation (by Next)
1.1.1.6   root      260: - Coast II Coast (by Sector One, 4kB intro)
1.1.1.8 ! root      261: - Cuddly Demos (by CareBears)
        !           262: - Darktrip (by Legend), doesn't work with >2MB of RAM
1.1.1.2   root      263: - Dark Side of the Spoon (by ULM)
                    264: - Death of the Clock Cycles (by Aggression)
                    265: - Dimensio (by Condemned)
1.1.1.8 ! root      266: - Eat my bollocks (by Equinox)
        !           267: - Fantasia (by Dune)
1.1.1.2   root      268: - Flashback (by Carebears)
1.1.1.8 ! root      269: - Flipo (by Oxygene)
1.1.1.2   root      270: - Frenchies (by Frenchies, 96KB intro)
1.1.1.8 ! root      271: - Grafik -und Sounddemo (by Eckhard Kruse), font issues
1.1.1.2   root      272: - Hallucinations (by Reservoir Gods)
1.1.1.8 ! root      273: - Illusion (by Dune)
        !           274: - No Cooper (by 1984)
        !           275: - Odd Stuff (by Dune)
        !           276: - Ooh Crikey (by Lost Boys)
1.1.1.5   root      277: - Outline 2008 invite (by DHS)
                    278: - Outline 2010 invite (by Checkpoint)
1.1.1.2   root      279: - Overdose (by Aggression)
1.1.1.7   root      280: - Pandemonium (by Chaos)
1.1.1.4   root      281: - Paradise (by Dune Design)
1.1.1.8 ! root      282: - Phaleon Gigademo (by Next), select "fast loader"
1.1.1.2   root      283: - Posh (by Checkpoint)
1.1.1.8 ! root      284: - Punish your machine (by Delta Force)
1.1.1.4   root      285: - Rebirth (by MMJ production)
1.1.1.5   root      286: - Save The Earth (by Defence Force)
1.1.1.6   root      287: - SillyVenture 2k10 & 2k11 (invitros by Mystic Bytes & Aggression)
                    288: - Sommarhack 2011 (invite by DHS)
1.1.1.2   root      289: - Soundtracker (by Equinox)
1.1.1.8 ! root      290: - SoWatt (by CareBears)
        !           291: - ST NICCC (by Oxygene)
1.1.1.6   root      292: - ST soccer (intro by Exceptions)
                    293: - Stone tower (by FUN)
                    294: - Superstar! (intro by Positivity/Dma-Sc/Ukko)
1.1.1.2   root      295: - Sweety (by DHS)
1.1.1.8 ! root      296: - Syntax Terror (by Delta Force)
        !           297: - Transbeauce II (by BushWacKers)
1.1.1.4   root      298: - Tut! (by Wildfire)
1.1.1.8 ! root      299: - Twelve (by Paulo Simoes)
1.1.1.2   root      300: - Two in One (by DHS)
1.1.1.8 ! root      301: - Virtual (by Equinox)
1.1.1.6   root      302: - Visualize (by Checkpoint)
1.1.1.8 ! root      303: - Vodka demo (by Equinox)
1.1.1.6   root      304: - YmRockerz musicdisks from "Wave upon Wave" to "Seven"
1.1.1.5   root      305: - Xmas2000 (by Paranoid)
1.1.1.2   root      306: 
                    307: Color games:
                    308: - Archon 4KB
                    309: - Alien Blockade
                    310: - Bellum*
                    311: - Bombs Away
1.1.1.5   root      312: - ChuChu Rocket* (Lite version for STFM)
1.1.1.2   root      313: - Clogged Up
                    314: - Crapman*
                    315: - Dave Munsie games (shareware)
                    316: - Entombed
                    317: - Flip'em* (4KB puzzle)
                    318: - Grav*
                    319: - Hackman II*
                    320: - Hang About (4KB mountain climbing)
                    321: - Haywire
                    322: - Hector*
                    323: - Jetpac
                    324: - Nibe 2
                    325: - Nova
                    326: - Pengy
                    327: - Punt II
                    328: - Rockfall*
                    329: - Robert in the Fire Factory
                    330: - Santafly
                    331: - Snowball Fight
                    332: - Spacewar
                    333: - Starball* (shareware)
                    334: - Sweeper
1.1.1.8 ! root      335: - Tanx*
1.1.1.2   root      336: - Teserae*
                    337: - Yak (4KB gridrunner)
                    338: 
1.1.1.7   root      339: Med-rez games:
                    340: - Poker solitaire
                    341: 
1.1.1.2   root      342: GEM games:
1.1.1.5   root      343: - 4 Gewinnt* (Connect four)
1.1.1.7   root      344: - Awele v1.02 (in v1.01 menus close immediately after opening)
1.1.1.5   root      345: - Ballerburg* (bug: mouse-over acts like click)
1.1.1.2   root      346: - Biglife*
1.1.1.7   root      347: - Centi
1.1.1.5   root      348: - Chess* (works only from floppy)
1.1.1.7   root      349: - Clicks* (needs wdialog)
1.1.1.8 ! root      350: - Corewar (needs EmuTOS >= 0.8.7)
1.1.1.2   root      351: - Daleks*
1.1.1.4   root      352: - Dame
1.1.1.2   root      353: - DBWH
                    354: - Drachen
1.1.1.7   root      355: - Flipside (fs, othello)
1.1.1.8 ! root      356: - Frix
1.1.1.2   root      357: - Gem_mind
1.1.1.8 ! root      358: - GEMcell
        !           359: - Gemamigo* (needs EmuTOS >= 0.8.7)
1.1.1.5   root      360: - Gnuchess
1.1.1.7   root      361: - Gobang* (needs EmuTOS >= v0.8.6)
1.1.1.8 ! root      362: - Halma (needs EmuTOS >= 0.8.7)
1.1.1.7   root      363: - Invers
1.1.1.2   root      364: - Isola
                    365: - Kensington
1.1.1.7   root      366: - Magic Stones* (m_stones: tetris, 2x tetris, columns)
1.1.1.2   root      367: - Mars (corewars)
                    368: - Mathmaze
1.1.1.5   root      369: - Megaroid*
1.1.1.4   root      370: - Mines*
1.1.1.7   root      371: - Mosaik
1.1.1.8 ! root      372: - Nanjing
1.1.1.2   root      373: - Nethack*
1.1.1.8 ! root      374: - Never Mind
1.1.1.2   root      375: - Orb
                    376: - Pacman
1.1.1.8 ! root      377: - Planet (celectial body calculations)
1.1.1.2   root      378: - Shanghai
1.1.1.8 ! root      379: - Sixteen (puzzle)
        !           380: - Sliders
1.1.1.4   root      381: - Snake
1.1.1.7   root      382: - Solitair*
1.1.1.8 ! root      383: - Spiegel ("mirrormagic")
1.1.1.5   root      384: - Stello*
1.1.1.2   root      385: - ST Concentration*
                    386: - Sudoku*
1.1.1.4   root      387: - Tartan* (chess)
1.1.1.7   root      388: - Thor (Othello, unstable)
1.1.1.2   root      389: - Thrust
1.1.1.5   root      390: - Tricky yahoo
1.1.1.7   root      391: - Verrueck (labyrinth)
1.1.1.2   root      392: - Wator (slow)
1.1.1.7   root      393: - WindowBall (breakout)
                    394: - Worm farm
                    395: - Wormania
1.1.1.4   root      396: - zSudoku
1.1.1.2   root      397: 
                    398: Monochrome games:
                    399: - Balloons
1.1.1.8 ! root      400: - Bouncing boubles
        !           401: - Columns* (needs EmuTOS >= 0.8.6, some text issues)
1.1.1.2   root      402: - Delta patrol
1.1.1.8 ! root      403: - Diamond miner
1.1.1.5   root      404: - Emperor (v1.0 & v1.5)
                    405: - Fun Face (playable demo)
                    406: - Go UP
1.1.1.4   root      407: - HASCS
1.1.1.7   root      408: - Lasermon (laser "chess")
1.1.1.6   root      409: - Mandala
1.1.1.5   root      410: - MiniGolf* (GFA basic)
1.1.1.2   root      411: - Monkey Business
                    412: - Mr Dash
1.1.1.5   root      413: - Poolmono*
1.1.1.2   root      414: - Punssi
1.1.1.8 ! root      415: - Puzzlepuzzle
1.1.1.2   root      416: - Pyro
                    417: - Qix
1.1.1.5   root      418: - Sbreak* (by Mark Overmars)
1.1.1.8 ! root      419: - Skull diggery
1.1.1.7   root      420: - Sherlock* (needs EmuTOS >= 0.8.6, some text issues)
1.1.1.6   root      421: - Space war (bug: score missing)
1.1.1.7   root      422: - Wallball
1.1.1.2   root      423: 
                    424: Text games:
                    425: - Advent (Colossal Cave)
1.1.1.4   root      426: - Eliza
1.1.1.2   root      427: - Hack
                    428: - Larn
                    429: - Omega
1.1.1.8 ! root      430: - Quix
1.1.1.2   root      431: 
                    432: 
                    433: Non-working free/shareware GEM/mono Atari ST games
                    434: --------------------------------------------------
                    435: 
                    436: Although there are plenty of color demos and games, the number of
                    437: (even remotely fun) free GEM or monochrome games and demos is so low
1.1.1.8 ! root      438: that for those I list here non-working ones.  Typically the issues
        !           439: are either use of unsupported line-A functions or with user input.
1.1.1.2   root      440: 
                    441: GEM games:
1.1.1.7   root      442: - Abalone   (dragging doesn't work)
1.1.1.8 ! root      443: - Anduril   ('h' and 'j' keys don't work)
        !           444: - Bombs     (minesweeper, mouse clicks almost never work)
1.1.1.7   root      445: - Checkers  (dragging doesn't work)
1.1.1.6   root      446: - Dte       (mouse gets stuck)
1.1.1.8 ! root      447: - Invaders* ('-' key doesn't work)
        !           448: - Minds     (minesweeper, mouse clicks almost never work)
1.1.1.7   root      449: - Patience* (dragging doesn't work, dialog selection persists)
                    450: - Risky*    (dragging doesn't work)
1.1.1.8 ! root      451: - Yams      (minesweeper, mouse clicks don't work)
1.1.1.6   root      452: - Yukon*    (dragging doesn't work)
1.1.1.5   root      453: 
                    454: Games that mix GEM UI and non-VDI drawing:
1.1.1.7   root      455: - Backgam   (line-A bitblit)
                    456: - Fishes    (line-A line and filled rectangle)
                    457: - Robugs*   (line-A filled rectangle and draw sprite)
1.1.1.2   root      458: 
                    459: Mono games:
1.1.1.8 ! root      460: - Big Blow      (line-A bitblit)
        !           461: - Crystal Caves* (line-A bitblit and draw/clear sprite)
        !           462: - CW Puzzle     (line-A bitblit + line & point draw in start)
1.1.1.6   root      463: - Domino       (line-A bitblit)
1.1.1.8 ! root      464: - Gluckrad      (line-A bitblit)
1.1.1.6   root      465: - Lokomotive   (line-A bitblit)
1.1.1.8 ! root      466: - MacPan*      (line-A draw/clear sprite)
        !           467: - Macrowar     (line-A bitblit)
1.1.1.6   root      468: - Midimaze*    (joystick doesn't work)
1.1.1.8 ! root      469: - MineFeld     (line-A draw/clear sprite)
        !           470: - Minigolf*     (line-A draw/clear sprite)
        !           471: - Pacballs      (line-A bitblit + panic)
1.1.1.6   root      472: - Pipeline*    (line-A line and filled rectangle)
1.1.1.8 ! root      473: - Pling II     (line-A bitblit and draw/clear sprite)
        !           474: - Ramses*       (panic after Mediach())
1.1.1.6   root      475: - Roll X       (line-A bitblit and get pixel)
1.1.1.8 ! root      476: - Take2*        (line-A bitblit)
        !           477: 
        !           478: 
        !           479: Atari ST drawing programs / image viewers
        !           480: -----------------------------------------
        !           481: 
        !           482: Working:
        !           483: - iffcnv, IFF convertor/viewer
        !           484: - spslide, Spec512 viewer
        !           485: - ImCon v1.1, image converter/viewer
        !           486: - Photochrome v4 (all buttons don't work)
        !           487: 
        !           488: Not working:
        !           489: - Neochrome master (uses most of line-A functions)
        !           490: - Speed of Light v3.8 (complains of not supporting TrueColor and exits)
        !           491: 
        !           492: 
        !           493: Atari ST MIDI programs
        !           494: ----------------------
        !           495: 
        !           496: Working:
        !           497: - Dr T's KCS v4
        !           498: - Dr T's Tiger Cub v2.0
        !           499: - EditTrack
        !           500: - EZ-Score
        !           501: - Henry Cosh's Accompanist
        !           502: - Ludwig
        !           503: 
        !           504: Not working:
        !           505: - Cubase lite (guesses etv_timer vector wrong -> panic)
        !           506: - FinalCut Pro demo (panic on MIDI play)
        !           507: - Music Mouse (uses line-A hline for cursor)
        !           508: 
        !           509: MIDI programs are available from Tim's MIDI world:
        !           510:        http://tamw.atari-users.net/
1.1.1.2   root      511: 
                    512: 
                    513: Working free/shareware Atari STE programs
                    514: -----------------------------------------
                    515: 
                    516: There are not that many freely available or even commercial programs
                    517: that would be STE specific (or even STE enhanced):
                    518:     http://atari-ste.anvil-soft.com/html/archivapps.htm
                    519: 
1.1.1.8 ! root      520: But following STE specific & enhanced demos, games and apps work
        !           521: (mostly) fine with EmuTOS.
        !           522: 
        !           523: Note: STE emulation needs 256kB version of EmuTOS.  If you use 60Hz
        !           524: EmuTOS version (etos256us.img), you may get screen flicker and music
        !           525: playback issues with demos and games.
1.1.1.2   root      526: 
                    527: Demos:
1.1.1.5   root      528: - 1st Step (by Tobe/MJJ Prod)
                    529: - 20 years megademo (by Atari scene collective), issues in some screens
                    530: - 20 years Atari STE megademo (by Paradox), some screen don't work
1.1.1.8 ! root      531: - 32768 colors showdown (by Tronic of Effect)
1.1.1.2   root      532: - Again (by Paradox)
1.1.1.8 ! root      533: - AltParty 2008 intro (by Paradox)
        !           534: - Amiga Demo 2 (by Oxygene), music disk
1.1.1.2   root      535: - Armada is dead (by Aggression)
                    536: - Azed/Jungle demo (by Atari)
                    537: - Beat Demo (by Frontline)
1.1.1.8 ! root      538: - Bird Mad Girl Show (by Fraggle's)
1.1.1.2   root      539: - Birdie (by Zeal)
1.1.1.6   root      540: - Blue Period (by Paradox)
1.1.1.2   root      541: - CD-player (by Light)
1.1.1.5   root      542: - Cernit Trandafir (by DHS)
1.1.1.2   root      543: - Core Flakes (by New Core)
1.1.1.8 ! root      544: - Devotion (by Excellence in Art)
1.1.1.2   root      545: - Dynamite (by Unit 17)
                    546: - E605 (by Light)
1.1.1.4   root      547: - Ecstacy A (by ICE), breaks at the end
1.1.1.2   root      548: - French Kiss (by DHS)
                    549: - Gobi Toons (by Dune)
                    550: - Grimey (by Reservoir Gods)
1.1.1.6   root      551: - High Fidelity Dreams (by Aura)
                    552: - HighResMode (by Paradox)
1.1.1.8 ! root      553: - Illusion (by Next)
        !           554: - Jam-Cols (by ICE)
        !           555: - Just Musix 2 (by DHS)
1.1.1.2   root      556: - Kick my assembler (by Orion), start doesn't look right
                    557: - Madness (by Cream)
                    558: - Mathematica (by Aura)
                    559: - More or Less Zero (by DHS)
1.1.1.4   root      560: - Maxymizer compo 2006 (by gwEm)
1.1.1.2   root      561: - Meshake (by Spice Boys)
                    562: - Mind Rewind (by Reservoir Gods)
                    563: - MovieSTE (by Tony Barker)
1.1.1.8 ! root      564: - Necrosys (by Hemoroids)
1.1.1.2   root      565: - New Year -94 Intro (by Extream)
1.1.1.6   root      566: - No Monkey (by Tomchi), some extra pixels in first text scroller
1.1.1.8 ! root      567: - Pacemaker (by Paradox), end part works only from floppy image
1.1.1.2   root      568: - Paracon 6 & 7 remindtros (by Paradox)
1.1.1.6   root      569: - Power Rise (by Light)
1.1.1.2   root      570: - Reanimation (by Syntax)
1.1.1.5   root      571: - Realtime (by MJJ Prod)
1.1.1.8 ! root      572: - RGBeast (by Aggression)
        !           573: - Save the Earth (by Defence Force)
1.1.1.2   root      574: - Sinfull Sinuses (by Chronicle)
1.1.1.8 ! root      575: - Sierpinski overdose 4K (by GGN), med-rez+blitter only
1.1.1.6   root      576: - Sommarhack (by DHS)
1.1.1.8 ! root      577: - Songs Of The Unexpected (by OUCH)
1.1.1.2   root      578: - STE slideshow (by DHS)
                    579: - STE Wars (by Tony Barker)
1.1.1.8 ! root      580: - Summer Delights (by DHS)
1.1.1.6   root      581: - Sventure intro (by Paradox)
1.1.1.8 ! root      582: - Techno drugs (by NLC)
1.1.1.2   root      583: - Vision (by POV)
1.1.1.4   root      584: - XiTEC Presentation (by Omega)
1.1.1.2   root      585: 
                    586: Color games:
1.1.1.6   root      587: - 4K Pacman (bug: background not cleared to black)
                    588: - Aerial Combat 3
1.1.1.2   root      589: - Alien Blast (demo)
1.1.1.8 ! root      590: - Astrodia
1.1.1.2   root      591: - Battletris+
1.1.1.5   root      592: - ChuChu Rocket* (full version)
1.1.1.2   root      593: - Dynaplus*
                    594: - Frantick
1.1.1.8 ! root      595: - Micromachines preview (by .tscc)
1.1.1.2   root      596: - No Limit II (shareware pinball)
                    597: - Obsession* (demo of commercial pinball)
                    598: - Operation Garfield
                    599: - Pacman on E
                    600: - Power Up
                    601: - Skulls (shareware "minesweeper")
1.1.1.4   root      602: - Spy 4k
1.1.1.2   root      603: - Stardust* (tunnel sequence demo)
                    604: - STEtris
                    605: - STrEet Fighter II (incomplete)
1.1.1.8 ! root      606: - Stupid balloon game (joysticks swapped?)
1.1.1.2   root      607: - Substation* (demo)
1.1.1.8 ! root      608: - The chronicles of Omega
1.1.1.2   root      609: - Tomtar
1.1.1.6   root      610: - Utopos* (demo)
1.1.1.5   root      611: - Wolfenstein3D v0.8a* (a bit unstable)
1.1.1.8 ! root      612: - Zero-5 (demo)
1.1.1.2   root      613: 
1.1.1.8 ! root      614: STE (enhanced) color music applications:
1.1.1.2   root      615: - Blipp Blopper
1.1.1.8 ! root      616: - DeskTracker MT
1.1.1.6   root      617: - Hextracker
1.1.1.2   root      618: - MaxYMizer
                    619: - Octalyzer
                    620: - Paula
1.1.1.8 ! root      621: - Protracker 2 STE
1.1.1.2   root      622: - Sirius Player
                    623: 
                    624: Most of the non-GEM ST tracker & chip music composer programs
1.1.1.8 ! root      625: work also with EmuTOS too (not just STe ones), most even with
        !           626: the 512kB EmuTOS version.
1.1.1.6   root      627: 
1.1.1.2   root      628: 
1.1.1.8 ! root      629: "Almost" working color Atari STE programs
        !           630: -----------------------------------------
1.1.1.2   root      631: 
1.1.1.8 ! root      632: There are some STE (enhanced) programs that would appear otherwise to
1.1.1.6   root      633: work perfectly, but some part of the graphics just don't show.  They
                    634: are listed in case someone, someday, starts to fix the EmuTOS line-A
1.1.1.8 ! root      635: things (mainly bitblt), or fixes the games to use e.g. VDI.
1.1.1.2   root      636: 
1.1.1.8 ! root      637: - Alien Thing preview (no-line A functions, but all sprites are missing)
        !           638: - Art for Kids (line-A sprite enable function -> cursor doesn't show;
        !           639:   rectangle drawing -> screen corruption + panic)
        !           640: - Atari Scene Card Battle (card images missing due to line-A bitblit)
        !           641: - AttackWave (most graphics missing due to line-A bitblit)
        !           642: - Blat (main graphics missing due to line-A bitblit)
1.1.1.2   root      643: - Breakdance (another scene game, game freezes when playing)
1.1.1.8 ! root      644: - Cameleon (all graphics missing due to line-A bitblit) 
        !           645: - Mr Boomer (graphics missing due to Line-A bitblit and no music)
        !           646: - H Mec 2 (no graphics due to line-A bitblit)
        !           647: - Kolmik (tiles don't show due to line-A bitblit)
        !           648: - Poker Square (graphics don't show due to line-A bitblit)
        !           649: - Pooz (graphics don't show due to line-A bitblit)
        !           650: - R0x (main menu graphics don't show due to line-A bitblit)
        !           651: - Roger (no graphics except bg show, line-A bitblits)
        !           652: 
        !           653: Several of these (and Falcon) games are by Paradize:
        !           654:        http://paradize.final-memory.org/games.shtml
        !           655: 
        !           656: 
        !           657: Atari TT programs
        !           658: -----------------
        !           659: 
        !           660: Broken applications:
        !           661: - PixArt4, clicks to windows don't work
        !           662:   http://www.1632systems.co.uk/www/html/Product/pixart.htm
1.1.1.4   root      663: 
1.1.1.8 ! root      664: Working demos:
1.1.1.4   root      665: - 256mbrot, Glasstro, Orion-B, Yabt (TT/Falcon intros by ray//.tSCc)
                    666: - 4getful (by gwEm, 4KB intro TT-version)
                    667: - Adebug 3DTT demo (by Brainstorm)
1.1.1.8 ! root      668: - Mandelbrot explorer (by .tSCc)
1.1.1.4   root      669: - TT highres slideshow (by .tSCc)
1.1.1.8 ! root      670: - Shiny Bubbles TT (by Xanth FX)
        !           671: - XiTEC demos (by Omega)
1.1.1.2   root      672: 
1.1.1.8 ! root      673: Problematic demos:
        !           674: - Swing (by Omega), instead of just showing bombs on exit,
        !           675:   there's panic with priviledge violation
        !           676: 
        !           677: 
        !           678: Falcon free/shareware demos, games and applications
        !           679: ---------------------------------------------------
        !           680: 
        !           681: Falcon emulation requires 512kB version of EmuTOS
        !           682: (the one shipped with Hatari).
        !           683: 
        !           684: Partial Videl/VsetMode() implementation, missing VDI 256-color &
        !           685: HiColor support and missing Falcon sound matrix & DSP XBios functions
        !           686: in EmuTOS probably explain why graphics in many of the demos & games
        !           687: look broken or they freeze at startup.  Following Falcon only demos,
        !           688: games and apps work (mostly) fine though.
        !           689: 
        !           690: Working demos:
        !           691: - 1600x600
        !           692: - 30l coke, needs DSP
        !           693: - A Rh Positive 4k (by tSCc), needs DSP
        !           694: - Ascii (by Reservoir Gods), disable DSP
1.1.1.2   root      695: - ATS (by DHS)
1.1.1.8 ! root      696: - Autowachen Verboten (by Lazer)
1.1.1.2   root      697: - Birdshow
1.1.1.8 ! root      698: - Bugs from outer space (by Impulse)
        !           699:   - bad sound
        !           700: - Cebit 93 (by Respectables)
        !           701:   - needs WinUAE CPU core
        !           702: - Cooler than ever (by ICE)
        !           703:   - bad sound
1.1.1.4   root      704: - DBA Magazine 14 intro (by Lazer)
1.1.1.8 ! root      705: - Earth (by Gaston)
        !           706: - Falcon Flight (by Opium)
        !           707: - Firestarter (by Shadows)
        !           708: - Flu 4k (by New Beat)
        !           709: - Fungle beats (by FUN)
        !           710:   - needs WinUAE CPU core
1.1.1.2   root      711: - Game of Life 4k (by Aggression)
1.1.1.8 ! root      712: - Illusion 64 (by Paranoia)
        !           713:   - plasma screen has garbage on right side,
        !           714:     end screen at top & bottom
        !           715: - Mouse (animation + music)
        !           716: - RGB Reine (by New Beat)
        !           717: - Rock Solid (by Paranoia)
        !           718: - Six Sievert (by tSCc)
        !           719: - Snowstorm (by Reservoir Gods), disable DSP
        !           720: - Sonolumineszenz (by Avena)
        !           721:   - No sound
        !           722: - Terrorize Your Soul (by tSCc)
1.1.1.4   root      723:   - fonts and colors aren't right on all screens
1.1.1.8 ! root      724: - Videl visions slideshow
        !           725: - Virtual City, needs DSP
        !           726:   - freezes at exit
        !           727: - Warum (by Lazer)
        !           728: - Weltchmerz (by Avena)
        !           729: - ZZ 9 Plural Z Alpha (by tSCc)
        !           730: 
        !           731: Demos regressed in EmuTOS v0.8.6:
        !           732: - Blue (by New Beat)
        !           733:   - just exits to bus error
        !           734: 
        !           735: Partly working demos:
        !           736: - Agony (by DNT crew)
        !           737:   - freezes after a while
        !           738:     XBIOS 109 (Dsp_ExecProg)
        !           739:     Bus error bget at 00400000
        !           740: - Built-in Obsolescence (by Digital Chaos)
        !           741:   - requires WinUAE core
        !           742:   - Eventually dies to Dsp Stack Over/underflow  
        !           743: - Motion (unfinished demo by Aggression)
        !           744:   - only writer screens work
        !           745: - Gurkensalat (by Lazer)
        !           746:   - freezes after a while
        !           747: - Illness (by Escape)
        !           748:   - freezes after a while to
        !           749:     Bus error lget at 4e700cb9
        !           750: - Jesterday (by POV)
        !           751:   - Music demo, but no music as it needs DSP
        !           752: - Oergs (by Lazer)
        !           753:   - Music is bad
        !           754: - Schlumpf invtro (by Lazer)
        !           755:   - Music is bad
        !           756:   - Colors are wrong
        !           757:   - Input doesn't work to advance next screen
        !           758: 
        !           759: Demos that with normal TOS work without DSP,
        !           760: but don't work with EmuTOS at all:
        !           761: - GEM demo (by DHS & AssemSoft):
        !           762:   - needs HiColor mode
        !           763: - Gourand demos:
        !           764:   - panic with bus error
        !           765:     M68000 Bus Error reading at address $ffa5f8.
        !           766:   - these have asm sources!
        !           767: - Beams (by .tscc):
        !           768:   panic with bus error:
        !           769:   M68000 Bus Error reading at address $3b4.
        !           770: 
1.1.1.2   root      771: 
1.1.1.8 ! root      772: Working games:
1.1.1.4   root      773: - Aces High (preview)
1.1.1.2   root      774: - Blum
1.1.1.8 ! root      775: - Cavemania (demo version)
1.1.1.2   root      776: - Corsair
                    777: - DB 4K
1.1.1.8 ! root      778: - Double Bobble 2000* (by Reservoir Gods), disable DSP
1.1.1.2   root      779: - Dry Egg (needs >4MB RAM)
                    780: - FalcTron
1.1.1.8 ! root      781: - Ganymed (start with F1)
        !           782: - Heretic (very slow)
        !           783: - Hexogan (use number pad)
1.1.1.2   root      784: - Impulse (Breakout clone)*
1.1.1.8 ! root      785: - Lamemine
        !           786: - Les Dinosaures (demo)
        !           787: - LlamaZap free version (requires joypad, not joystick)
1.1.1.2   root      788: - Madtris
1.1.1.8 ! root      789: - Nibe
        !           790: - Running (demo)*
1.1.1.2   root      791: - Radical Race (demo)*
                    792: - Spice (Defender clone)*
1.1.1.8 ! root      793: - Static (Patience by Reservoir Gods), disable DSP
1.1.1.2   root      794: - Steinbruch
1.1.1.8 ! root      795: - Switch
1.1.1.2   root      796: - Tank Blaster
1.1.1.8 ! root      797: - Tautology (by Reservoir Gods)
        !           798: - Tautology II* (by Reservoir Gods)
1.1.1.2   root      799: - Toy Man
1.1.1.8 ! root      800: - Willie's Adventure (preview1), disable DSP
        !           801: 
        !           802: Games regressed in EmuTOS v0.8.6:
        !           803: - Columns by Deadheart* (demo)
        !           804:   - Colors/graphics are wrong
        !           805: - Rave*
        !           806:   - Colors/graphics are wrong
        !           807: - SBM v0.8 (Bomberman clone)*, doesn't work anymore
        !           808:   - Bus error wget at 00400000
        !           809: - Vertical Mayhem (Columns clone)*, black screen at start
        !           810:   - maybe due to missing sound matrix calls
1.1.1.2   root      811: 
1.1.1.6   root      812: Games working with extra hacks:
                    813: - Bugger, Bunion, SkyFall, Sworm games by Resorvoir Gods:
                    814:   - use an undocumented TOS4 vector for keyboard input instead of accessing
                    815:     kbdvec correctly which use causes EmuTOS to panic.  This can be worked
                    816:     around with the following hack.prg:
                    817:     http://sourceforge.net/mailarchive/message.php?msg_id=26841274
                    818:   - with EmuTOS enabling DSP freezes the games right at startup
                    819:     (with normal TOS4, DSP is used for background music)
                    820: 
1.1.1.8 ! root      821: Mostly working games:
        !           822: - Multibriques: colors are wrong
        !           823: - Santarun (GEM): just too slow
        !           824: - TUM, GEM minesweeper: says "sorry, sound system is locked"
        !           825:   on every click
        !           826: - Willie's Adventure* (preview2), gfx leave garbage on screen
        !           827: 
        !           828: Games that might be possible to get working (they
        !           829: show something and/or don't use DSP / sound matrix):
        !           830: - Block Blizzard preview: stops when loading
        !           831: - Bomb Squad: crashes to bus error
        !           832: - Conquest of Elysium: doesn't start
        !           833: - Des Lazers & des Hommes: game area graphics are missing
        !           834:   (AFAIK they're rendered with DSP)
        !           835: - It's Great: bus errors, requires ST-med resolution
        !           836: - Jeu de Poker: colors wrong, freezes at menu, needs VGA
        !           837: - Masters of Chaos: starts, but then doesn't react to input
        !           838: - Neurobot: just exits
        !           839: - Painium: Intro works, but game itself exits to corrupted desktop
        !           840: - Tetrhex: says it's unable to change resolution, on OK panics
        !           841: - TsccTron: M68000 Bus Error reading at address $0.
        !           842: - Zodiax: after VsetMode(0x0), white corrupted screen
        !           843: 
        !           844: Games using Line-A bitblit not supported by EmuTOS:
        !           845: - Chainz
        !           846: - Confusion (demos 1 & 2)
        !           847: - Gold island (demo)
        !           848: - Jewelz
        !           849: - Let's play Shanghai (demo)
        !           850: - Men at War
        !           851: - Tron 2
        !           852: - Ultimate Arena Falcon edition
        !           853: - Sweety Things
        !           854: 
        !           855: 
        !           856: Working applications:
        !           857: - Aniplayer v2.22
        !           858: - BIQ codec / player (by .tscc, has sources)
1.1.1.5   root      859: - Cecile hard disk (image) driver
1.1.1.8 ! root      860: - DSP-debug debugger
        !           861: - Godpaint (by Reservoir Gods)
        !           862: - ICDraw, .ICO and .IB3 GEM viewer
        !           863: - Kronos v1.91 benchmark
        !           864: - Rainbow 2 multimedia, needs WinUAE CPU core for MMU
        !           865: 
        !           866: Partly working applications:
        !           867: - Centurbo benchmark:
        !           868:   - DSP speed 0, with normal TOS the correct 32Mhz
        !           869:    (bogus speed values for FPU & CPU as with normal TOS)
        !           870: - Fractal Playground
        !           871:   - DSP needs to be disabled, keyboard input doesn't work
        !           872: - Smurf (GEM image viewer)
        !           873:   - loaded images are totally white
1.1.1.2   root      874: - Whip! (virtual light machine)
1.1.1.8 ! root      875:   - Cursor is frozen unless DSP is disabled,
        !           876:     non-DSP effects work
        !           877: - Winrec (direct to disk GEM audio recorder/effects)
        !           878:   - Starts fine and GUI works, but I didn't try recording,
        !           879:     may actually work fine
1.1.1.2   root      880: 
1.1.1.8 ! root      881: Broken applications:
        !           882: - AceMidi demo (softsynth sounds need DSP)
        !           883:   - freezes after loading sound bank
        !           884: - AceTracker:
        !           885:   - exits after starting
        !           886: - Centview (GEM image viewer)
        !           887:   - For JPG images, requires running jpegd.prg first
        !           888:   - Says "Ce fichier n'a pu etre ouvert"
        !           889: - Delmpaint (GFA)
        !           890:    - screen wrong, freezes
        !           891:    - needs 256-colors not supported by EmuTOS
        !           892: - DSPdit (by .tscc)
        !           893:   - panic with bus error
        !           894: - Escape paint (GEM)
        !           895:   - Starts, but file selector doesn't open when one
        !           896:     tries to open an image
        !           897: - FalcAMP (GEM)
        !           898:   - panic with bus error
        !           899: - FlaySID
        !           900:   - says "cannot connect with DSP matrix" when playing
        !           901:     (has no sound with Hatari even with real TOS)
        !           902: - Flextracker
        !           903:   - black screen after pressing space at startup
        !           904:    (With normal TOS needs WinUAE Hatari CPU core)
        !           905: - Gemplay v1.49, v1.92 and v1.95
        !           906:   - Says "needs Falcon 030 to run"
        !           907: - Indypaint
        !           908:   - cursor moves, but screen is black, F1-F4 keys don't work
        !           909:   - needs HiColor mode
        !           910: - MP2 player:
        !           911:   - Says that DSP and audio subsystem are already in use
        !           912:   - When playing is forced, there's no sound
        !           913:   - Time runs in large jumps
1.1.1.2   root      914: 
1.1       root      915: 
1.1.1.2   root      916:        - Eero

unix.superglobalmegacorp.com

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