home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / atari / xf25.txt < prev    next >
Text File  |  1994-11-10  |  18KB  |  418 lines
  1.  
  2. PC Xformer 2.5 - The Atari 800XL Emulator For MS-DOS Compatible PCs
  3. ===================================================================
  4.  
  5. November 10, 1994.
  6.  
  7. Branch Always Software
  8. 14150 N.E. 20th Street
  9. Suite 302
  10. Bellevue, WA  98007
  11. U.S.A.
  12.  
  13. Program by Darek Mihocka. Many thanks to Danny Miller and Bob Woolley for 
  14. their beta testing and technical help, to Greg Tibbets for the many Rana 
  15. drives, to Jan Gray for sharing cool programming tricks, to Bill Kendrick
  16. for writing the very cool manual for 3.0, and to Nick Kennedy for developing
  17. the SIO2PC cable which makes life so much easier. 
  18.  
  19.  
  20. Copy this program!
  21. ------------------
  22.  
  23. PC Xformer 2.5 is a free emulator for MS-DOS users who wish to run their old
  24. Atari 400/800 and Atari 800XL software on their PCs. The file XF25.ZIP may be
  25. freely redistributed under the condition that the contents of the ZIP file are
  26. not modified in any way, and that no fee is charged for the software other than
  27. reasonable long distance and online charges for downloads.
  28.  
  29. These files must be present in the XF25.ZIP archive:
  30.  
  31.     XF25.EXE     - an MS-DOS program that is the PC Xformer 2.5 emulator
  32.     XF25.DOC     - this documentation file
  33.     DOS25.XFD    - ST Xformer disk image containing Atari DOS 2.5 files
  34.     MYDOS45.ATR  - SIO2PC disk image containing MyDOS 4.5 files
  35.     ATARIOSB.ROM - Atari 800 operating system
  36.     ATARIXL.ROM  - Atari 800XL operating system
  37.     ATARIBAS.ROM - Atari Basic
  38.     DEMOS1.XFD   - disk image containing Atari 800XL BASIC demos
  39.     DEMOS2.XFD   - disk image containing Atari 800XL machine language demos
  40.  
  41.  
  42. Quick Start
  43. -----------
  44.  
  45. If you have previously used PC Xformer 2.0, then using 2.5 is exactly the same!
  46. The only new key you have to learn is F12, describled below. Otherwise,
  47. everything will work as before, only better!
  48.  
  49. To just quickly run PC Xformer 2.5, type XF25 from the DOS prompt. The familiar
  50. blue and white Atari Basic screen will appear with the READY prompt. Type in a
  51. small Basic program and you'll see it's just like an Atari 400/800 or 800XL!
  52.  
  53. Use the F12 key on the PC's keyboard to switch between Atari 800XL mode and
  54. Atari 800 mode. The current mode is displayed at the bottom of the screen.
  55.  
  56. Use the F10 key to "system reset". Press F10 while holding the Shift key to
  57. toggle Atari Basic on or off.
  58.  
  59. In Atari 800XL mode you have access to the new graphics modes (GR.9 through
  60. GR.15), plus you can run the newer software designed for the 800XL. Switch
  61. back to Atari 800 mode to run older software.
  62.  
  63. Press F5 to exit back to the DOS prompt. Then read the rest of this document!
  64.  
  65.  
  66. Hardware requirements
  67. ---------------------
  68.  
  69. PC Xformer 2.5 is a 16-bit MS-DOS application. It is designed to run on most
  70. PCs with minimum hardware requirements. It requires only a 286 compatible CPU,
  71. so it is compatible with all 286, 386, 486 and Pentium based PC, as well as any
  72. PC that can emulate the 286. For example, the Mac running SoftAT, the PowerMac
  73. running SoftWindows, and any Windows NT based RISC machine.
  74.  
  75. PC Xformer 2.5 also requires a VGA compatible display, and about 300K of RAM.
  76.  
  77.  
  78. Installing Disks
  79. ----------------
  80.  
  81. PC Xformer 2.5 uses the same 90K, 130K, and 180K disk images used by our
  82. older ST Xformer 8-bit emulator, and it also supports reading and writing
  83. to SIO2PC generated disk images.
  84.  
  85. If you don't know what SIO2PC is, call your Atari dealer and ask. It's a
  86. cool cable that you connect between your real Atari 800 computer and your
  87. PC which allows you to blast over all of your 8-bit disks to your PC and
  88. store them as disk images (the 90K, 130K, or 180K data files).
  89.  
  90. If you specify virtual disk files and/or MS-DOS files after the XF25, those
  91. will be installed as Atari disk drives. For example, type:
  92.  
  93. XF25 DOS25.XFD DEMOS1.XFD
  94.  
  95. to boot up DOS 2.5 from D1: and then access demo files from D2:. Using the
  96. same example, once you are in Atari Basic type:
  97.  
  98. RUN"D2:ATARI800.BAS"
  99.  
  100. to run a demo program. Or type DOS to go to the DOS 2.5 file manager.
  101. Machine language programs (typically files ending with .OBJ or .COM) should
  102. be run with Basic disabled by pressing Shift+F10 to reboot without Basic.
  103.  
  104.  
  105. Features
  106. --------
  107.  
  108. Many of the limitations of our old ST Xformer emulator and other clone Atari
  109. emulators have been eliminated in PC Xformer. PC Xformer is written mostly
  110. in machine language and takes full advantage of the PC hardware.
  111.  
  112. Features common to both PC Xformer 2.5 and PC Xformer 3.0 include:
  113.  
  114.     - 48K Atari 400/800 emulation
  115.  
  116.     - 64K Atari 800XL emulation with "RAM under ROM" memory
  117.  
  118.     - allows user installable patches to the OS and BASIC
  119.  
  120.     - displays all ANTIC text and graphics modes, including GTIA modes
  121.  
  122.     - 256 color GTIA color palette
  123.  
  124.     - displays player missile graphics (no collision detection)
  125.  
  126.     - horizontal and vertical fine scrolling
  127.  
  128.     - supports display list interrupts, IRQ, and NMI interrupts
  129.  
  130.     - reads and writes to ST Xformer and SIO2PC generated disk images
  131.  
  132.     - reads MS-DOS files directly from within Atari DOS
  133.  
  134.     - switch Atari BASIC on/off with one keystroke
  135.  
  136.     - switch between Atari 400/800 and Atari 800XL emulation with one keystroke
  137.  
  138.     - joystick emulation using the keyboard cursor keys
  139.  
  140.     - full speed emulation on a 386/33 or faster
  141.  
  142.     - slow and fast modes of emulation to take advantage of fast PCs
  143.  
  144.     - compatible with all VGA cards
  145.  
  146.  
  147. In addition, PC Xformer 3.0 adds features including these:
  148.  
  149.     - 130XE emulation with 256K of extended XE memory
  150.  
  151.     - player missile graphics with full collision detection
  152.  
  153.     - on-the-fly disk image swapping
  154.  
  155.     - 4 voices of sound, printer, and modem support
  156.  
  157.     - real joystick support
  158.  
  159.     - 386 optimized code for faster speed
  160.  
  161.     - over 1 megabyte of sample Atari 8-bit programs
  162.  
  163.     - over 40 pages of 8-bit Atari reference documentation
  164.  
  165.  
  166. Below is a list of processors and the approximate speed of emulation relative
  167. to an Atari 800:
  168.  
  169.     - 286/16     - 0.3
  170.     - 386SX/20   - 0.5
  171.     - 386DX/33   - 1.0
  172.     - 486DX/33   - 2.0
  173.     - 486DX2/66  - 4.0
  174.     - Pentium/90 - 8.0
  175.  
  176. 486 and Pentium users can use the slow/fast option to slow down the emulator
  177. to normal Atari 800 speed or let it run as fast as possible.
  178.  
  179.  
  180. Upgrading to PC Xformer 3.0
  181. ---------------------------
  182.  
  183. PC Xformer 3.0 can be ordered for $29.95 U.S. directly from Branch Always
  184. Software at the address above, or from these and other fine Atari dealers:
  185.  
  186.     ACN (Holland and Germany)        phone: +31 23351100   fax: +31 23361444
  187.     B & C Computervisions (U.S.A.)   phone: 408-986-9960   fax: 408-986-9968
  188.     FaST Club (U.K.)                 phone: +44 602445250  fax: +44 602445305
  189.     Mid Cities Computers (U.S.A.)    phone: 310-867-0626   fax: 310-920-8933
  190.     Ordosoft (France)                phone: +33 47547942   fax: +33 47513726
  191.     Paragon Computers (Australia)    phone: +61 92213216   fax: +61 93258251
  192.     Rising Star Computers (U.S.A.)   phone: 800-252-2787   fax: 513-254-7970
  193.     Toad Computers (U.S.A.)          phone: 800-448-TOAD   fax: 410-544-1329
  194.  
  195.  
  196. The keyboard, cursor keys, and joystick emulation
  197. -------------------------------------------------
  198.  
  199. All letter and number keys function as on the 800XL keyboard. Punctuation
  200. keys will give the characters shown on the PC keyboard, not the characters
  201. that appear on the Atari keyboard. i.e. Shift+2 gives the @ character, not ".
  202.  
  203. If you are used to using the Atari keyboard and want keys to work as they
  204. do on the Atari keyboard, keep in mind that PC keyboards come in every style
  205. and layout and so it is impossible to do that. Simply spend a few minutes
  206. looking at they keys as you type and you will get used to your particular
  207. PC's keyboard layout.
  208.  
  209. F1 F2 F3 F4 function as cursor keys (up, down, left, right), similar to the
  210. four function keys on a 1200XL.
  211.  
  212. F5 exits back to DOS. Remember this when you want to exit PC Xformer!!
  213.  
  214. F6 is the HELP key.
  215.  
  216. F7 is the START key.
  217.  
  218. F8 is the SELECT key.
  219.  
  220. F9 is the OPTION key.
  221.  
  222. F10 is RESET. Press Shift+F10 to reset and toggle Basic on or of