home *** CD-ROM | disk | FTP | other *** search
/ Emulator Universe CD / emulatoruniversecd1998.iso / Atari_ST / Emus / stonxdos / README.DOS < prev    next >
Encoding:
Text File  |  1997-10-25  |  4.1 KB  |  110 lines

  1.     ,-===================-.
  2. ,---| Notes for STonX DOS |---------------------------------------------------.
  3. |   `-===================-'                                                   |
  4. '                                                                             `
  5.     STonX was written by Marinos Yannikos and Martin D. Griffiths.
  6.     This DOS conversion was done by Dirk Jansen.
  7.  
  8.     STonX is free software. Read the file COPYING for more information!
  9.  
  10.     You can find the latest version of STonX DOS at "emulation camp":
  11.     http://www.mygale.org/~zoop/stonx
  12.     Thanks to Zoop for maintaining this page!
  13.  
  14. -------------------------------------.
  15.  to run STonX you need these things: |
  16. -------------------------------------'
  17.  
  18.     1. a TOS image file.
  19.     ~~~~~~~~~~~~~~~~~~~~
  20.     You need a TOS image file to run STonX. Because of copyright reasons this 
  21.     file is not included in this package. 
  22.     If you have access to a ST, you can use TOSDUMP.EXE by Tony Smolar to 
  23.     create the TOS.IMG file.
  24.     There are three version of STonX DOS:
  25.     stonx1.exe is for 192kb TOS (1.00, 1.02, 1.04), stonx2.exe is for 256kb TOS
  26.     (1.62, 2.0x) and stonx2b.exe for 256kb TOS and 14 MB RAM.
  27.  
  28.     2. Min. 16 MB RAM memory.
  29.     ~~~~~~~~~~~~~~~~~~~~~~~~~
  30.     3. A fast cpu.
  31.     ~~~~~~~~~~~~~~
  32.     A Pentium CPU is recommended, but it also runs on a 486. 
  33.  
  34.     4. A sound blaster card or compatible for audio emulation.
  35.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36.     Only sound blaster cards are supported (or compatible). Try the switch 
  37.     "-noaudio" if you have problems. If your soundcard does not use IRQ 5, 
  38.     DMA 1 and port 220h, you must set the environment with 
  39.     "set BLASTER=A220 I7 D1" (This uses a sound blaster card on port 220h, 
  40.     IRQ 7 and DMA 1). 
  41.  
  42.     5. A mouse driver.
  43.     ~~~~~~~~~~~~~~~~~~
  44.  
  45. ------------------------------------.
  46.  some useful command line switches: |
  47. ------------------------------------'
  48.  
  49.     Start STonX with "-h" for help. STonX also writes internal messages into 
  50.     a file named DEBUG.TXT. If STonX does not run, it would be useful to take 
  51.     a look into this file.
  52.  
  53.     using PC file system:
  54.     ~~~~~~~~~~~~~~~~~~~~~
  55.     If you want to access your PC hard disk, use "-fs <X>:<path>".
  56.     for example "-fs C:D:\TEMP" uses your PC directory D:\TEMP as Atari 
  57.     drive C. 
  58.     If you use this switch, you should have at least TOS 1.4. 
  59.     With TOS 1.0 or TOS 1.2 better use the next switch:
  60.  
  61.     using disk images:
  62.     ~~~~~~~~~~~~~~~~~~
  63.     You can use disk images with "-disk <X>:<filename>".
  64.     for example "-disk A:C:\IMAGES\MYDISK.ST" uses MYDISK.ST as a disk image 
  65.     for drive A. 
  66.  
  67.     graphics switches:
  68.     ~~~~~~~~~~~~~~~~~~
  69.     With the switch "-size 800x600" you can use a greater resolution. 
  70.     You can use colour with "-color" (color is slow with 800x600).
  71.     Only 800x600 is supported. If you try other resolutions, it may not work.
  72.  
  73.     parallel port or serial port:
  74.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  75.     "-para lpt1" uses LPT1 as parallel port. You can also print to a file.
  76.     "-serial com2" uses COM2 as serial port with 19200 baud (RTS/CTS handshake
  77.     is not supported). You can use COM1 to COM4.
  78.  
  79. ----------------------.
  80.  Configuration files: |
  81. ----------------------'
  82.  
  83.     You can also use a config file for the options. write the options into
  84.     a file named stonx.cfg without "-". You can use comments with "#". Use only
  85.     one option per line. Use comments only at the beginning of a line. Example:
  86.  
  87.               # STonX example config file
  88.               #
  89.               mono
  90.               fs c:c:\atari
  91.               size 800x600
  92.  
  93.  
  94. -------------------.
  95.  Some final words: |
  96. -------------------'
  97.  
  98.     - The source code of STonX is also available. 
  99.  
  100.     - Take a look at Nino's homepage. Here you can find more information about 
  101.       STonX: http://www.complang.tuwien.ac.at/nino/index.html
  102.  
  103. -------------------------------------------------------------------------------
  104.  
  105. My e-mail address: jansen@uni-paderborn.de
  106.  
  107. Have fun!
  108.  
  109. Dirk Jansen
  110.