home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1994 October / IMM1094.ISO / share / tools / atari_em / xf2.doc < prev    next >
Text File  |  1994-06-20  |  30KB  |  635 lines
  1.  
  2. PC Xformer 2.0 - The Atari 400/800 Emulator For MS-DOS Compatible PCs
  3. =====================================================================
  4.  
  5. June 20, 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 the cool programming tricks, and to Nick 
  16. Kennedy for developing the SIO2PC cable which makes life so much easier. 
  17.  
  18.  
  19. Copy this program!
  20. ------------------
  21.  
  22. PC Xformer 2.0 is a free emulator for MS-DOS users who wish to run their old
  23. Atari 400/800 software. The file XF2.ZIP may be freely redistributed under the
  24. condition that the contents of the ZIP file are not modified in any way, and
  25. that no fee is charged for the software other than reasonable long distance
  26. and online charges for downloads.
  27.  
  28. These files must be present in the XF2.ZIP archive:
  29.  
  30.     XF2.EXE     - an MS-DOS program that is the PC Xformer 2.0 emulator
  31.     XF2.DOC     - this documentation file
  32.     DOS25.XFD   - an ST Xformer virtual disk containing Atari DOS 2.5 files
  33.     MYDOS45.ATR - an SIO2PC virtual disk containing MyDOS 4.5 files
  34.     DEMOS.XFD   - an ST Xformer virtual disk containing Atari 8-bit demos
  35.  
  36. PC Xformer 2.0 is NOT shareware. You can freely use it to your hearts delight
  37. without having to feel guilty about not paying for it, just as the original
  38. ST Xformer program has been freely available for 7 years.
  39.  
  40. Future upgrades of PC Xformer will be available for $29.95 for those people
  41. who want the additional features, extra documentation, and product support.
  42.  
  43. I do ask one thing. Every user of PC Xformer 2.0 needs to send me a letter
  44. or postcard describing the PC that you are using the emulator on (brand,
  45. memory, processor, video card, etc), a list of the Atari 8-bit software that
  46. you are running on it, and how well each program runs. And of course, feel
  47. free to comment and make suggestions for future versions of PC Xformer. Also
  48. include a list of other computers you own or plan to purchase.
  49.  
  50.  
  51. Quick Start
  52. -----------
  53.  
  54. To just quickly run PC Xformer 2.0, type XF2 from the DOS prompt. The familiar
  55. blue and white Atari Basic screen will appear with the READY prompt. Type
  56. in a small Basic program and you'll see it's just like an Atari 400/800!
  57.  
  58. If you specify virtual disk files and/or MS-DOS files after the XF2, those
  59. will be installed as Atari disk drives. For example, type:
  60.  
  61. XF2 DOS25.XFD DEMOS.XFD
  62.  
  63. to boot up DOS 2.5 from D1: and then access demo files from D2:. Using the
  64. same example, once you are in Atari Basic type:
  65.  
  66. RUN"D2:ATARI800.BAS"
  67.  
  68. to run a demo program. Or type DOS to go to the DOS 2.5 file manager.
  69. Machine language programs (typically files ending with .OBJ or .COM) should
  70. be run with Basic disabled by pressing Shift+F10 to reboot without Basic.
  71.  
  72. Press F5 to exit back to the DOS prompt. Then read the rest of this document!
  73.  
  74.  
  75. Features
  76. --------
  77.  
  78. Many of the limitations of the ST Xformer emulator are gone thanks to the much
  79. faster processing power of the PC and its superior VGA graphics capablities. 
  80. If you previously used ST Xformer you'll find much faster emulation of Atari 
  81. 8-bit programs with much greater compatibility.
  82.  
  83. PC Xformer 2.0 is the first and only Atari 8-bit emulator for either the ST or
  84. PC that supports all these features:
  85.  
  86.     - 48K RAM with built-in Atari 400/800 operating system and Atari BASIC
  87.  
  88.     - displays all ANTIC text and graphics modes, including GTIA modes
  89.  
  90.     - displays player missile graphics (no collision detection)
  91.  
  92.     - handles display list interrupts, IRQ, and NMI interrupts
  93.  
  94.     - 256 color GTIA palette
  95.  
  96.     - reads and writes to ST Xformer and SIO2PC generated disk images
  97.  
  98.     - reads MS-DOS files directly and automatically converts to disk image
  99.  
  100.     - switches Atari Basic on/off with one keystroke
  101.  
  102.     - joystick emulation using the keyboard
  103.  
  104.     - full speed emulation on a 386/33 or faster
  105.  
  106.     - slow and fast modes of emulation
  107.  
  108. Features that will be found in future versions of PC Xformer (described later
  109. in this document) are:
  110.  
  111.     - 800XL/130XE memory bank switching
  112.  
  113.     - player missile graphics collision detection
  114.  
  115.     - sound card, joystick port, modem port, and printer port support
  116.  
  117. The speed of Atari 8-bit emulation is proportional to the speed of your PC,
  118. with a 33 Mhz 386 approximately giving the normal speed of an Atari 800.
  119.  
  120. Below is a list of processors and the approximate speed of emulation relative
  121. to an Atari 800:
  122.  
  123.     - 286/16    - 0.3
  124.     - 386SX/20  - 0.5
  125.     - 386DX/33  - 1.0
  126.     - 486DX/33  - 2.0
  127.     - 486DX2/66 - 4.0
  128.     - Pentium   - 7+
  129.  
  130. 486 and Pentium users can use the slow/fast option to slow down the emulator
  131. to normal speed if necessary.
  132.  
  133.  
  134. Hardware requirements
  135. ---------------------
  136.  
  137. PC Xformer 2.0 is a 16-bit MS-DOS application. It is designed to run on most
  138. PCs with minimum hardware requirements. It requires only a 286 compatible CPU,
  139. so it is compatible with all 286, 386, 486 and Pentium based PC, as well as any
  140. PC that can emulate the 286. For example, the Mac running SoftAT, the PowerMac
  141. running SoftWindows, and any Windows NT based RISC machine.
  142.  
  143. PC Xformer 2.0 also requires a VGA compatible display, and about 200K of RAM.
  144.  
  145.  
  146. History
  147. -------
  148.  
  149. The whole idea of emulating an Atari 800 computer on another computer popped
  150. into my head about 8 years ago while working at a job developing Apple II
  151. software. It occured to me that the Apple II was so super simple, so utterly
  152. primitive a machine, that it shouldn't be too hard to emulate it on my (then)
  153. brand new Atari 1040ST.
  154.  
  155. So I set about doing that and a couple months later had an Apple II emulator
  156. up and running. The next obvious step was to emulate an Atari 400, which I had
  157. prior to the ST. The Atari 400 and Apple II, while both 6502 based machines,
  158. were radically different in the rest of their hardware. The Atari 400 in 
  159. effect has two microprocessors - the 6502, and the ANTIC chip which handles 
  160. all the cool graphics, and so the end result required an emulator that was 
  161. really two emulators - a 6502 emulator to execute the programs, and an 
  162. ANTIC/GTIA/POKEY emulator to handle the video and other Atari 400 hardware.
  163.  
  164. The result was a not so spectacular Atari 400/800 emulator which I called
  165. ST Xformer (pronounced ST Transformer because it transforms your computer
  166. into an Atari 8-bit computer). The main problem was speed. The Atari ST's
  167. 68000 processor was too slow to interpreter 6502 machine language in real-time
  168. and the Atari ST's graphics capabilities were inadequate to handle the 256
  169. color displays of most Atari 8-bit software.
  170.  
  171. In the summer of 1988, I rewrote ST Xformer from scratch and ended up with a
  172. much improved and much faster ST Xformer II, which did things a lot better
  173. but still lacked the processing speed required to emulate an Atari 400.
  174.  
  175. In 1989 I released the last version of ST Xformer II for the Atari ST, a
  176. version that emulated the 130XE and ran as fast as I could make it. I used my
  177. new found skill at writing really fast 68000 machine language to move on to
  178. developing other Atar ST programs such as Quick ST, Quick Index, Quick View
  179. (kind of a Quick theme, eh?) MonSTer, and others.
  180.  
  181. Emulators are a fairly common thing now (the PowerPC emulating a Mac, the MIPS
  182. emulating a 286, the PC emulating an Atari ST, etc) and the general rule of
  183. thumb is that you need at least a 10:1 speed ratio to successfully emulate
  184. one machine on another. In other words, computer A can emulate computer B if
  185. computer A is at least 10 times faster than computer B. As it was, the 8 Mhz
  186. 68000 chip in the Atari ST was only about 5 times more powerful than a 6502
  187. and add to that the extra task of emulating the ANTIC chip and it was quite
  188. obvious that ST Xformer II could only be improved so far. I even release the
  189. source code to ST Xformer and to this day no one has ever managed to speed it
  190. up or significantly improve it. A few have tried, once even in GFA Basic!
  191.  
  192. In 1990 I moved to developing on PCs and as my first project I decided to
  193. rewrite ST Xformer from 68000 machine language to 8086 machine language to
  194. see what sort of speed I'd get. So was born PC Xformer 1.0 in late 1990 during
  195. one of Seattle's few major snow storms that shut down the city for a few days.
  196. (Not that it was that major a snow storm, and being from the east coast I've
  197. seen real snow storms, but drop 6 inches of snow on the ground here and people
  198. freak out to no end).
  199.  
  200. Running on a few 20 and 25 Mhz 386 machines I had, PC Xformer did quite well.
  201. The 386 chip is several times more powerful than a 68000 and so it does meet
  202. the 10:1 speed requirement and does allow for full speed real-time emulation
  203. of the 6502. Major progress! PC Xformer 1.0 did not emulate the ANTIC chip or
  204. any of the other custom chips of the 8-bit Atari, so it was limited to running
  205. in text mode (graphics mode 0) only.
  206.  
  207. This re-kindled my interest in emulators enough to go back to the Atari and
  208. try to run ST Xformer II on the then new Atari TT computer. Unfortunately
  209. ST Xformer was heavily optimized for the 68000 chip and used tricks that
  210. prevented it from running on the TT's 68030 chip directly. With a few minor
  211. modification and disabling the 68030's cache, I was able to run ST Xformer II
  212. on the TT, only to find out that it ran no quicker on a 16 Mhz 68030 than on
  213. a 16 Mhz 68000. A major rewrite of ST Xformer into 68030 code was required
  214. which I decided not to do at the time.
  215.  
  216. Throughout 1991, I showed PC Xformer 1.0 at various Atari shows and at the
  217. time there was not much interest in it. Back then even a slow 386 machine
  218. cost over $2000, and why pay $2000 to buy a PC to then emulate a text-only
  219. Atari 400 when a real Atari 400 costs about $50?
  220.  
  221. But several people did start bringing up the idea of emulating an Atari ST
  222. on the PC. After all, buying a $2000 computer to emulate a $1000 computer
  223. made a little more sense. Other people dared me to do it, as if emulating a
  224. lowly Atari 400 was one thing but emulating a powerful Atari ST was another.
  225.  
  226. So I set out to write a totally new emulator, Gemulator, which would emulate
  227. the 68000 chip as well as all of the Atari ST hardware. Gemulator took over
  228. a year to write (as a 68000 is several orders of magnitude more complex than
  229. a 6502 chip). But nothing is impossible in software!
  230.  
  231. In 1992 I released Gemulator, and by then for $2000 you could buy the more
  232. powerful 486 based computers which could not only emulate the 68000 in real
  233. time, but even faster. Over the next year I fine tuned Gemulator to the point
  234. where in many ways it was a better Atari ST than a real Atari ST - faster,
  235. better graphics, higher disk and memory capacity, etc. And the 486 kept 
  236. getting cheaper, and cheaper, and cheaper, and the 386 even cheaper.
  237.  
  238. So in late 1993, after releasing the major Gemulator 3.0 upgrade I took a look
  239. back at PC Xformer. With all the new tricks I had learned developing Gemulator,
  240. I now saw solutions to what previously were difficult technical problems with
  241. regards to emulating the Atari 8-bit's ANTIC and other custom chips.
  242.  
  243. With 386 machines selling in the under $500 range now, it also because quite
  244. obvious that there would be plenty of people out there who were one time
  245. (or still are) Atari 8-bit users who had PCs and would seriously consider
  246. using a $500 PC to emulate a $50 Atari. Whether for real work or just for the
  247. hell of it, it would be a cool thing to use and for me to write.
  248.  
  249. I also happen to run across a few other people on the internet who had similar
  250. ideas and planned to write their own Atari 8-bit emulators for the PC, but who
  251. obviously lacked the technical knowledge and experience to do such a thing.
  252. One Atari 8-bit emulator from Germany already making its rounds on the internet
  253. is such a pathetic piece of work that it makes emulators look bad.
  254.  
  255. So once again it was time to write a brand new emulator! Taking the existing
  256. PC Xformer 1.0 code written for the 8-bit 8086 chip, I rewrote it for the 286
  257. chip (let's face it, how many people still use an 8086 based computer?) to 
  258. take advantage of its 16-bit power. That resulted in faster 6502 emulation 
  259. and enough power to emulate the custom chips even on a 386.
  260.  
  261. And that is how PC Xformer 2.0 came into being! Some of you are probably
  262. thinking "Poor boy, he should get a life". Well don't worry, there is reason
  263. behind the madness. Just as with Quick ST and Gemulator, I want your money.
  264. Then I can afford to go have a life!
  265.  
  266. Back in March I demoed it for the first time at an Atari show in Sacramento.
  267. This time around the people who saw it were quite interested. "How much, I'll
  268. buy it" was the typical response after seeing it. I'd respond with "How about
  269. $30?" and usually the person would still be standing there, still interested.
  270. But first I have to get people interested.
  271.  
  272. So I decided to do what many software companies are starting to do - give away
  273. the first version of the product for free (or pretty close to it) and then
  274. charge for upgrades.
  275.  
  276. That way everybody has a chance to use the product and decide if they like it
  277. and want to continue using it. But unlike demos and shareware, the product is
  278. not crippled, does not have a time limit, does not constantly interrupt your
  279. work to give you an in your face reminder that you have not paid for it yet.
  280.  
  281. The goal with PC Xformer 2.0 is to run Atari 8-bit software reasonably well
  282. on most of the PCs now out there, all 100 million or so of them. So it has
  283. very few special needs. If you have a PC that is 286 compatible and can
  284. display VGA graphics, you can run PC Xformer 2.0. No special video cards,
  285. sound cards, game cards or anything like that required. Every person on the
  286. face of the planet who has access to some sort of PC should be able to run
  287. PC Xformer 2.0 and get hands on experience with it. And then get hooked on it.
  288.  
  289. Ok, now that I've bored everyone to tears, let's get started!
  290.  
  291.  
  292. Running PC Xformer 2.0
  293. ----------------------
  294.  
  295. Running PC Xformer 2.0 is extremely simple. From an MS-DOS (or compatible)
  296. prompt, type XF2 followed by an optional one or two virtual disk image files.
  297. The first file will be installed as Atari disk drive D1: and the second file
  298. will be installed as disk drive D2. The virtual disk image files may be either
  299. in ST Xformer (.SD, .DD, .XFD files) or SIO2PC format (.ATR files).
  300.  
  301. If PC Xformer 2.0 is unable to access a virtual disk in read/write mode, it
  302. will try to open it in read mode. In that case, any attempt to save or delete
  303. files in the virtual disk will result in an error 144 (write protect error).
  304.  
  305. PC Xformer 2.0 is compatible with any MS-DOS compatible operating system,
  306. including Windows 3.1, OS/2 2.1, and Windows NT 3.1. When running in a
  307. windowed environment, you'll get the most speed out of PC Xformer 2.0 if you
  308. set Exclusive mode and run in a full screen instead of a window. Most Windows
  309. VGA drivers do not allow graphical DOS programs to even run in a window.
  310.  
  311. If you find that PC Xformer 2.0 is running too fast (because you are using a
  312. Pentium or other fast computer) press the Scroll Lock key. This will slow down
  313. the emulator to a more reasonable speed.
  314.  
  315.  
  316. The keyboard, cursor keys, and joystick emulation
  317. -------------------------------------------------
  318.  
  319. All letter and number keys function as on the 400/800 keyboard. Punctuation
  320. keys will give the characters shown on the PC keyboard, not the characters
  321. that appear on the Atari keyboard. i.e. Shift+2 gives the @ character, not ".
  322.  
  323. If you are used to using the Atari keyboard and want keys to work as they
  324. do on the Atari keyboard, keep in mind that PC keyboards come in every style
  325. and layout and so it is impossible to do that. Simply spend a few minutes
  326. looking at they keys as you type and you will get used to your particular
  327. PC's keyboard layout.
  328.  
  329. F1 F2 F3 F4 function as cursor keys (up, down, left, right), similar to the
  330. four function keys on a 1200XL.
  331.  
  332. F5 exits back to DOS. Remember this when you want to exit PC Xformer!!
  333.  
  334. F6 is the BREAK key.
  335.  
  336. F7 is the START key.
  337.  
  338. F8 is the SELECT key.
  339.  
  340. F9 is the OPTION key.
  341.  
  342. F10 is RESET. Press Shift+F10 to coldboot the 400/800 and toggle Basic.
  343.  
  344. Insert and Delete insert and delete a character.
  345.  
  346. Shift+Insert and Shift+Delete insert and delete a line of text.
  347.  
  348. Home is the CLEAR key.
  349.  
  350. End is also the BREAK key.
  351.  
  352. The ` key is the Atari logo key used to toggle inverse text on/off.
  353.  
  354. Page Up and Page Down are used to move the display window up or down a pixel
  355. at a time. This allows you to center the screen for programs whose display
  356. extends either too far up or too far down.
  357.  
  358. The numeric keypad functions in two modes. When the Num Lock is set, the
  359. numeric keypad produces numbers. When Num Lock is not set, the keys 2 4 6 8
  360. function as a 4 direction joystick. 0 on the keypad is the fire button.
  361.  
  362. If your keyboard has an "inverted T" set of cursor keys, those also function
  363. in two modes. By themselves they function as a 4 direction joystick. When
  364. pressed with the Ctrl key, they act as cursor keys (same as F1 F2 F3 F4).
  365.  
  366. Due to differences in the layout of the Atari 400/800 and PC keyboards,
  367. the keys + - = * do not function as cursor keys. You must use F1 F2 F3 F4 or
  368. the PC's cursor keys.
  369.  
  370. Some PC keyboards have an 8-way set of cursor keys, containing the usual
  371. up down left and right cursor keys, plus four diagonal keys. Pressing those
  372. diagonal keys will generate diagonal joystick movements as expected.
  373.  
  374. Pressing Ctrl and a letter key will give you the graphics characters as on
  375. the Atari 400/800. However, the two graphics characters produced by pressing
  376. Ctrl+, and Ctrl+. can be obtained on the PC keyboard by typing Ctrl+[ and
  377. Ctrl+].
  378.  
  379. Caps Lock functions as the Atari's Caps key, not as a true Caps Lock. Press
  380. Caps Lock once to enter lower case mode, then press Shift+Caps Lock to go
  381. back to upper case mode.
  382.  
  383. Scroll Lock toggles fast/slow mode. Scroll Lock on is the slow mode. Use this
  384. feature only on 486 and Pentium machine. On slower machines it will cause the
  385. emulator to slow down too much. See below.
  386.  
  387. To pause a program or a listing, press the PC's Pause key instead of Ctrl+1.
  388.  
  389. In place of Ctrl+3 press break.
  390.  
  391. Ok, got that? Just spend a few minutes playing around with the PC's keyboard
  392. and things will start to make sense.
  393.  
  394.  
  395. Slow/Fast modes
  396. ---------------
  397.  
  398. Scroll Lock toggles the slow/fast speed of the emulator. By default the
  399. emulator is in fast mode, meaning it runs as fast as possible. On a 286 or
  400. 386 based PC, PC Xformer 2.0 should run at or slightly below the speed of an
  401. 8-bit Atari so leave it in the default setting. On a 486 or Pentium, the speed
  402. may be too fast for some games, although the faster speed may be just what is
  403. needed for some slow BASIC games. In any case, if you do need to slow down the
  404. emulator, activate Scroll Lock to place the emulator into slow speed mode.
  405. At this point the emulator "applies the brakes" and attempts to drop down to
  406. about normal speed. Press Scroll Lock again to switch back to fast mode.
  407.  
  408.  
  409. Disk drive emulation
  410. --------------------
  411.  
  412. Now we come to what to some people is the most confusing part about using an
  413. emulator, whether PC Xformer, ST Xformer, DOS emulators on UNIX, or the many
  414. different Apple II emulators out there - disks. It's quite simple once you
  415. understand the concepts so let me try to explain.
  416.  
  417. With Gemulator I lucked out. Both the Atari ST and most PCs use the exact same
  418. 3.5 inch floppy disks and they even format the disks the exact same way. What
  419. that means to you is that you can take a disk from an Atari ST and just pop
  420. it into a PC and just read the files directly. No special cables, no special
  421. adjustments to your disk drive.
  422.  
  423. Not so with most computers. A PC's 5.25" floppy disk drive can't directly
  424. read an Apple II's 5.25" floppy disks. An old Mac II can't directly read
  425. Atari ST disks. And of course, the bummer, a PC's 5.25" floppy disk drive 
  426. can't read Atari 8-bit floppy disks.
  427.  
  428. So what to do? The same problem existed on the Atari ST with ST Xformer. I
  429. tried several different techniques. ST Xformer 1.0 emulated Atari DOS and
  430. faked up the D: device, so that whatever filename you specified actually
  431. accessed that file on the Atari ST's disk. ST Xformer II did the same thing
  432. but called it the F: device.
  433.  
  434. Unfortunately most (well, a lot) of Atari 8-bit software bypasses Atari DOS
  435. and read sectors from the disk directly. So the F: thing doesn't work too well
  436. for them, or boot disk that don't use a DOS at all.
  437.  
  438. So I did what all of the Apple II emulators and most other emulators do: use
  439. virtual disks. A virtual disk is just a large data file that contains all the
  440. information of a single floppy disk.
  441.  
  442. A virtual disk containing all the information of an Atari 8-bit single density
  443. disk must hold all the information from the 720 sectors on that disk. At
  444. 128 bytes per sector, 720*128 = 92160 bytes. And that is exactly how large
  445. ST Xformer virtual disk files are. 92160 bytes. Every byte in the file
  446. corresponds to a byte originally found on the disk.
  447.  
  448. The question still remains how to create a virtual disk file. Shortly after
  449. releasing ST Xformer II, I realized that the Atari ST's parallel printer port
  450. is very much like the Atari 800's serial port. One has 25 pins, the other has
  451. 13 pins. Big deal. What the pins do is very similar, and so I developed a
  452. cable known as the ST Xformer Cable (what else!) which allowed you to directly
  453. connect an Atari 810 or 1050 disk drive to the Atari ST. Then using some 
  454. software, the ST read each of the 720 sectors on the Atari 8-bit disk and
  455. stored those 92160 bytes into a file (usually with a .SD or .XFD extender).
  456.  
  457. And that is how you create a virtual disk on the Atari ST. If you are an Atari
  458. ST user and have user ST Xformer II in the past, then all of your Atari 8-bit
  459. software is already in virtual disk format and ready for use on PC Xformer!
  460.  
  461. If not, and you don't know any Atari ST users who have the ST Xformer Cable,
  462. don't despair. There are still plenty of ways to transfer a file to the PC.
  463.  
  464. About 4 years ago an Atari user by the name of Nick Kennedy tackled exactly
  465. this problem. And he developed a cable called the SIO2PC cable, to directly
  466. connect an Atari 8-bit computer to the PC.
  467.  
  468. Now of course he had no clue that 4 years later someone would come around and
  469. write an emulator, so the reason for his cable was to use a PC with its big
  470. PC hard disk to store Atari 8-bit files. Basically, using a PC as a very large
  471. hard disk for an Atari 800. By daisy chaining both a PC as well as a real
  472. Atari 8-bit disk drive onto the cable you are then able to copy files from
  473. the 8-bit disk drive to the PC.
  474.  
  475. As it happens, guess how the SIO2PC software stores the 8-bit files on the PC
  476. once they're transfered over the cable? In virtual disks of course! In fact,
  477. virtual disks created by SIO2PC are almost identical to those created by
  478. the ST Xformer cable, and so PC Xformer 2.0 supports both types of virtual
  479. disk files. (The difference is an extra 16 byte header that SIO2PC uses).
  480.  
  481. The SIO2PC cable has been around for 4 years and is fairly well known in
  482. the Atari 8-bit community, so this document will not describe how to build
  483. or use the SIO2PC cable. Contact your local Atari dealer, your user group,
  484. download files #5281 and #6414 from the Atari 8-bit roundtable on GEnie, or
  485. best yet, contact Nick Kennedy directly at 501-967-3843 or write to him at:
  486.  
  487. Nick Kennedy
  488. 300 South Vancouver St.
  489. Russellville, AR  72801
  490.  
  491. There is one other very common way to transfer a file between any two
  492. computers, and that is to use a null modem cable or two modems. Whenever you
  493. call a BBS with your modem and download a file, you are transfering a file
  494. from one computer (whether it be a PC or Mac or ST) to another.
  495.  
  496. There are thousands of public domain and shareware Atari 8-bit programs
  497. available for download from BBSs and online services. Download these files
  498. to your PC using whatever DOS or Windows based terminal software you normally
  499. used (that's most likely how you obtained this copy of PC Xformer 2.0)
  500.  
  501. Once the file is on your PC, copy it to the same directory that you run
  502. PC Xformer 2.0 from. Then specify the file on the XF2 command line as the
  503. second file. For example, let's say you downloaded a file called BUDGET.BAS.
  504. Typing this:
  505.  
  506. XF2 DOS25.XFD BUDGET.BAS
  507.  
  508. causes PC Xformer 2.0 to boot up using DOS25.XFD as drive D1:, and the file
  509. BUDGET.BAS will appear as the only file on drive D2:. Then using DOS 2.5
  510. (or any other Atari DOS) copy the file from D2: to D1: so that it is now
  511. on a virtual disk. You want to eventually copy all your Atari 8-bit files into 
  512. virtual disk image files. 
  513.  
  514. PC Xformer 2.0 allows for up to 8 files to be specified on the XF2 command
  515. line. The first file MUST be a virtual disk, since it must contain a valid
  516. DOS on it to install as drive D1:. The remaining 7 files may either specify
  517. other virtual disk files, or MS-DOS files which will automatically appear
  518. as virtual disks as described above.
  519.  
  520. Note that by default DOS 2.5 will only access 2 disk drives (D1: and D2:).
  521. See you DOS manual on how to expand that, or use a different DOS (such as
  522. MyDOS 4.5) which supports up to 8 drives.
  523.  
  524. Note that there is one other method to transfer 8-bit files to the PC. It
  525. seems that the PC's 5.25 inch floppy disk drive actually CAN read Atari disks
  526. if they are formatted double density and you run a special utility. I have not
  527. seen this work reliably, but people claim it works. So try it out if you can.
  528.  
  529. And now you are set to run PC Xformer 2.0 to your heart's content! But don't
  530. stop reading yet.
  531.  
  532.  
  533. PC Xformer 3.0: 32-bit Atari 130XE emulator
  534. -------------------------------------------
  535.  
  536. Currently in the works and available later this summer is PC Xformer 3.0,
  537. an upgrade from PC Xformer that features a 32-bit emulator that supports
  538. emulation of the 800XL, 65XE, and 130XE computers. The 32-bit code makes it
  539. faster than PC Xformer 2.0, and thus is capable of handling player missile
  540. graphics collision detection, sound, and other new features.
  541.  
  542. The PC Xformer 3.0 upgrade costs $29.95 and will be available both directly
  543. from Branch Always Software and through your favorite Atari dealer.
  544.  
  545. To order the PC Xformer 3.0 upgrade directly from us, send a personal check
  546. or money order (made out to Branch Always Software for $34.95 U.S. to cover
  547. shipping costs) to:
  548.  
  549. Branch Always Software
  550. 14150 N.E. 20th Street
  551. Suite 302
  552. Bellevue, WA  98007
  553. U.S.A.
  554.  
  555. or include your VISA or Mastercard number, expiry date, and the name as it
  556. appears on the card and your card will be charged $34.95.
  557.  
  558.  
  559. Future versions of Xformer for other computers
  560. ----------------------------------------------
  561.  
  562. Most computers now on the market use 32-bit processors such as the 386, 486,
  563. Pentium, 68030, 68040, PowerPC, MIPS, Alpha, etc. 8 years ago when I first
  564. started writing ST Xformer, the top of the line home computers were 16-bit
  565. machines, such as 286 based ATs, or 68000 based Macintoshes and Ataris.
  566.  
  567. So all versions of Xformer up until now, including PC Xformer 2.0, have been
  568. geared towards running on 16-bit machines. Rewriting things for a 32-bit
  569. processor takes a bit of work, one of the reasons why I have not done the
  570. 68030 rewrite of ST Xformer for the Falcon. But starting with PC Xformer 3.0,
  571. all new versions of Xformer will be 32-bit. With so many 32-bit machines to
  572. choose from now, the question is what are people actually going to be using
  573. and thus, what machines should Xformer be ported to?
  574.  
  575. PC Xformer 3.0 will obviously find a home with many PC people simple because
  576. there are so many 386/486 type machines out there. Most of you will probably
  577. be running PC Xformer 2.0 on a 386 or higher. But the same can't be said of
  578. new machines like the Falcon and PowerPC since they are so new. Will people
  579. use them in large enough numbers?
  580.  
  581. So, when you send in your letters describing the machine you are currently
  582. using, also place your vote for what machine you might plan to buy in the
  583. future and would like to see a version of Xformer for. Below is a list of
  584. various new 32-bit machines with various OS combinations, but feel free
  585. to add other machines to your list. Please vote for one or more of these
  586. systems, and I'll publish the results in our next newsletter. Your voting
  587. will help decide what new versions of Xformer will be developed in the future.
  588.  
  589.     - 386/486/Pentium running Chicago
  590.     - 386/486/Pentium running Windows NT
  591.     - 68030/68040 Mac running System 7.x
  592.     - PowerPC Mac running System 7.x
  593.     - PowerPC IBM running Windows NT
  594.     - MIPS R4000 running Windows NT
  595.     - DEC Alpha running Windows NT
  596.     - 68030 Atari TT running GEM/TOS
  597.     - 68030 Atari Falcon running GEM/TOS
  598.  
  599.  
  600. Report bugs!
  601. ------------
  602.  
  603. If while using PC Xformer 2.0 you come across anything out of the ordinary,
  604. such as some Atari 400/800 program that does not run properly, a keyboard
  605. that doesn't work properly, or even a typo in this document, please let me
  606. know about it. Don't assume somebody else will. If possible, include a disk
  607. contaning the software that does not work.
  608.  
  609. If you don't like the way I explained something in this document, let me know
  610. what part and what is confusing about it and how I can make it clearer.
  611.  
  612. Report bugs and suggestions by mail directly to me at this address:
  613.  
  614. Darek Mihocka, c/o
  615. Branch Always Software
  616. 14150 N.E. 20th Street
  617. Suite 302
  618. Bellevue, WA  98007
  619. U.S.A.
  620.  
  621. or fax me at 206-885-5893. I can also be reached by GEnie email as BRASOFT,
  622. and on Compuserve as 73657,2714.
  623.  
  624.  
  625.  
  626. Well thank you for reading through this and enjoy using PC Xformer 2.0. Don't
  627. forget to write! And remember, I frequently travel to Atari shows and visit 
  628. Atari user groups around the country, so if you have a show or meeting 
  629. scheduled and would like to arrange for a demonstration of either Gemulator or 
  630. PC Xformer, please contact me.
  631.  
  632.  
  633. Darek Mihocka, owner of Branch Always Software
  634.  
  635.