home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / falcon / backw143 / read_me.txt < prev   
Text File  |  1993-05-27  |  13KB  |  342 lines
  1. *************************************************************************
  2. *                                    *
  3. *        Backward, the ST emulator for FALCON O3O        *
  4. *                                    *
  5. *************************************************************************
  6.  
  7. PRELIMINARY NOTE : THIS IS CERTAINLY THE LAST FREEWARE VERSION OF BACKWARD.
  8. The next one will be Shareware. See chapter XIII for further information.
  9.  
  10.                 --------
  11.                 |V 1.43|
  12.                 --------
  13.  
  14. Summary :
  15.  
  16.  I)        Introduction.
  17.  II)        Inventory.
  18.  III)        How to run Backward.
  19.  IV)        Backward's options.
  20.  V)        Tips.
  21.  VI)        Notes.
  22.  VII)        Technical explaination.
  23.  VIII)        Future improvements.
  24.  IX)          Address.
  25.  X)        Backward history.
  26.  XI)        Thanks.
  27.  XII)        Bugs report.
  28.  XIII)        BACKWARD II.
  29.  
  30.  
  31. -----------------
  32. I) INTRODUCTION :
  33. -----------------
  34.  
  35.     Since most of FALCON's owners are former ST's owners (and sometimes
  36. still ones, like me), they want their ST games to run on the FALCON. Yes, but
  37. if the GEM compatibility is good enough for as much as 90% GEM programms, 
  38. hardware differences prevent about 75% games to work. That's why I created 
  39. Backward. It is supposed to handle hardware differences so that good old games
  40. can still run. So far I tested it, it has offered me something like 70% 
  41. compatibility. I hope you enjoy it as much as I do.
  42.  
  43.  
  44.  
  45. ---------------
  46. II) INVENTORY :
  47. ---------------
  48.     With the backward package file you must found :
  49.      - READ_ME.TXT             file, this one.
  50.      - BACKWARD.PRG            the program itself.
  51.      - BACKWARD.RSC            its ressource file.
  52.      - CORONER.PRG            the error analyst.
  53.  
  54.  
  55. --------------------------
  56. III) HOW TO RUN BACKWARD :
  57. --------------------------
  58.     First, you'll have to run it on a FALCON with at least 4 Megs
  59. (simple no ?). Use a video mode that offers at least 16 colors. 
  60. Double click on BACKWARD.PRG. You reach than a dialog box with three choices :
  61. - Information     : Click on it and you'll see.
  62. - Set Up    : Access to the configuration's dialog box.
  63. - Quit        : Leave Backward.
  64.  
  65.     Click on Set Up to choose configuration (it will be explained later
  66.  in this text) then choose a boot mode :
  67. - Boot now    : Run immediatly a ST disk.
  68. - Set up now    : Configure Falcon with curent choices.
  69. - Quit        : Back to first box.
  70.  
  71.     If you select [Set up now] then [Quit], your Falcon will be configured
  72. accordingly to the options selected.
  73.  
  74.     If you select [Boot now], an alert box will give a last chance to 
  75. refuse. REMOVE now ANY DISK which stands in the floppy DRIVE.
  76.  
  77.     If you continue onward, your FALCON will reboot. The ATARI logo will 
  78. appear after a few seconds. Then your drive led will flash once, you have now
  79. to keep pressed ALTERNATE until the BACKWARD infos come on screen.
  80.     Backward tells you the options selected and the operations it has
  81.     undertaken. You can now INSERT YOUR DISK. Press a key. That's all.
  82.  
  83.  
  84. -----------------------
  85. IV) BACKWARDS OPTIONS :
  86. -----------------------
  87.  
  88.     This dialog box allows you to alter the FALCON set up. Feel free to 
  89. try as many configuration as you want when attempting to run a programm.
  90.  
  91.     Each option will now be explained with advice to know when it have
  92. to be selected.
  93.  
  94. - 68O3O Frequency : This option allows you to slow down the microprocessor
  95.         down to 8 Mhz. It should be use when games run too fast, or
  96.         for some disk protections that refuse to run.
  97.         NOTE : this option has little effect on compatibility, so
  98.         keep your 68O3O at 16 Mhz and enjoy light speed !
  99.  
  100. - Blitter Frequency : This option allows you to alter Blitter Frequency. I
  101.         don't think it changes anything for compatibility, but it
  102.         offers you another way to slow down your computer.
  103.  
  104. - Instruction Cache : With this option you can turn Instruction Cache off.
  105.         This a great incompatibility cause for demos and disk
  106.         protection. But it seems that some FALCON TOS turn this
  107.         cache on whatever you do !
  108.  
  109. - Speaker : With this you can turn the internal speaker on/off
  110.         ( I must admit I have decided to unplugged it).
  111.  
  112. - Ram Size : I don't think you'll need a lot of explaination for this one.
  113.  
  114. - DMA sound interrupt : This should select Timer A pin or MFP input port 7 pin
  115.         for sound interrupt.If you haven't any sound with a program
  116.         or the sound begin then stop, try alter this option.
  117.  
  118. - Bus error : This is the most important option I think. Due to hardware
  119.         differences beteween ST and  FALCON, access to the ST
  120.         sound processor (YM 2149) may cause Bus error. So you can :
  121.             - Left : don't do anything when it happens.
  122.             - Corr. : this is the best handling mode so far.
  123.             When it's selected, Backward will attempt to
  124.             modify programs which cause errors. May doesn't work
  125.             with some programs.
  126.             - Simul. : correct the access to the YM2149, the 
  127.             middle choice but it slows everything down a bit.
  128.         If your programm cause a bus error (two bombs!), it's may
  129.         be because of the YM2149 access. So try the Corr. choice.
  130.         If it still crashes, select Simul.
  131.  
  132.  
  133. - Advanced Options : This one let you access to another panel which offer
  134.         more options. You don't have to use them in normal case.
  135.         They are :
  136.             - Move Exception Table : Normally on. Moving
  137.         exception table prevents programs to disable my own
  138.         error-handling routines, but it slows down the computer
  139.         a little bit. If your program seems not to like it
  140.         (very bugged sounds, flashing colors...) turn it off.
  141.             - Emulate Line F calls : let my routine
  142.         emulate some Line F calls. Use it when the programm show
  143.         11 bombs.
  144.             - Move Pmmu's Tree : Well there is absolutly no
  145.         reason for you to turn it off. Try it as a last solution.
  146.             - Emulate St Ram Bug : Accessing a memory space
  147.         where nothing was connected (no RAM, no chips' register)
  148.         had no effect on a ST. It's no longer the case. Use it
  149.         when your programm doesn't work. WARNING : Simul., correc.
  150.         YM access won't work anymore with this option turned on, 
  151.         YM access will be skipped (it means disturbed digisound).
  152.             - Data Cache : Normaly on, turn it off as a last
  153.         solution (effects of Data Cache are uneasy to see).
  154.             - Old screen address : Normally turned on, it
  155.         moves the screen base to improve compatibility. No reason
  156.         to change it.
  157.  
  158.     The last options will be implemented in the future, so are *not*
  159.     useable.
  160.  
  161. --------
  162. V) TIPS:
  163. --------
  164.     In most cases you won't have to alter any option because they're
  165. already set for a good compatibility.
  166.  
  167. a) Best compatibility:
  168.     - Turn 68030 and Blitter to 8Mhz.
  169.     - Turn both caches (instruction and data) off.
  170.     - Keep pmmu's tree moved away.
  171.     - Turn ST RAM Bug on (sorry that mean bad sound).
  172.     - Don't care for Bus error (due to ST RAM bug).
  173.     - Select 1 Meg (some old games may require 512K).
  174.     - Turn Line F calls on.
  175.     - Keep Old screen address on.
  176.     - Try each Interrupt source for DMA sound if there's still nothing.
  177.     
  178. b) How to decide configuration:
  179.     - First of all, it's a game written before 1989 (before STE), and
  180.     it use's digisound -> Use corrected YM Access.
  181.         Then :
  182.         - it's allright. Nothing to do.
  183.         - The game slows too much or it stops -> try simulated
  184.         access and if it's inneficient - >enable STRAM bug emulation.
  185.     (you may recognize such games because they show 2 bombs).
  186.  
  187.     - The game has been written after 1989 and YM access options don't
  188.     let the game keep running -> alter DMA sound interrupt.
  189.     (such games may have a bit of music before silence, or a long
  190.     whistle).
  191.  
  192.     - The game shows 11 bombs ->select Line F calls.
  193.  
  194.     - The game does *not* load itself-> turn 68030 to 8Mhz
  195.         If there are still problems -> turn on ST RAM Bug.
  196.  
  197.     - There are still problems, try the Best Compatibility set up.
  198.  
  199. ----------
  200. VI) NOTES:
  201. ----------
  202.  - Booting with Backward will cause a cold reset (power on) on the next restart
  203.      to let the Falcon reconfigure itself.
  204.  
  205.  - Memory Size and Bus handling have effects only if you select [Boot Now].
  206.      I may change it a day, but I'm tired.
  207.  
  208.  - As said before, Cache option may have no effect.
  209.  
  210.  - You may keep the Harddisk boot (by *not* pressing alternate key), but
  211.      most of the time, harddisk is a major cause of incompatibility.
  212.  
  213.  
  214. ------------------------------
  215. VII) TECHNICAL EXPLAINATIONS :
  216. ------------------------------
  217.     - Frequency configurations are made throught an undocumented address,
  218.  so Backward may not work on future FALCONs. I refuse to give this address (you
  219.  can still disassemble BACKWARD to see) because it's undocumented, it should
  220.  be used only for emulations, no for special FXs or anything else.
  221.     - Backward was written using DEVPAC ST II.
  222.     - YM corrected access option uses TRAP calls (#3 to #10).
  223.     - Attempts are made to recover from format error. It's luck if it 
  224.     works.
  225.     - Disabling both caches launch a special mode : cache are kept off
  226.     through PMMU.
  227.     - _memtop sysvar is also modified. It's equal to _phystop on Falcon
  228.     and to _v_bas_ad on ST(E). It's corrected.
  229.     - they aren't bombs anymore. Falcon will reboot instead and they're
  230.     is Coroner which can read my own error information structure in $380.
  231.     People who undertands such things could use it to set up Backward.
  232.     It has been created for my own purposes.
  233.  
  234. --------------------------
  235. VIII) FUTURE IMPROVEMENTS:
  236. --------------------------
  237.  
  238.     - Improved memory configuration (use of PMMU).
  239.     - Handling routines for TOS changes.
  240.  
  241. This improvements will be done only if this program is satisfying.So please
  242. send donations or appreciations. Donators will be registered users and
  243. they'll get the latest version of Backward.
  244.  
  245. ------------
  246. IX) ADDRESS:
  247. ------------
  248.     You may send any donation, advice, question, bug reports etc...
  249. to this adress:
  250.  
  251.     Mr Cyrille Dupuydauby
  252.  
  253.     53 domaine des aigles
  254.     60500 Chantilly
  255.     FRANCE
  256.  
  257.                 See you soon for V2.0.
  258.  
  259.  
  260. --------------------
  261. X) BACKWARD HISTORY:
  262. --------------------
  263.  
  264. - Idea : 5 april 1993.
  265. - beta version : 10 april 1993.
  266. - V 1.00 running : 12 april 1993.
  267. - V 1.10 running : 16 april 1993.
  268. - V 1.20 running (first release) : 21 April 1993.
  269. - V 1.30 running : 28 april 1993.
  270. - V 1.32 running : 1 May 1993.
  271. - V 1.40 running : 1 May 1993 (yeah the same day, two versions).
  272. - V 1.43 running : 21 May 1993.
  273.  
  274. ------------
  275. XI) THANKS :
  276. ------------
  277.     Thanks are sent to Mathias AGOPIAN, who's article help me a lot
  278. to improve BACKWARD (essentially moving PMMU and Blitter frequency).
  279.     Thanks to the Falcon for the still unused soundtrack and the
  280.  uploading.
  281.  
  282. --------------------
  283.  XII) BUGS REPORT : 
  284. --------------------
  285.  
  286. V 1.43
  287. ------
  288. Bugs :
  289. - Sometimes backward crashes for no reason. Try again.
  290. - 512 Ko option will certainly never be coded.
  291. Bugs corrected :
  292. - Ym correc access code has been improved. Trap vectors are set only when
  293. they're used.
  294. - A lot of minor bugs have been corrected from the unreleased V1.41 and V1.42.
  295. - Screen address emulation was only effective after a resolution change on
  296. Desktop. It has been fixed.
  297.  
  298. V 1.40
  299. ------
  300. Bugs :
  301. - Still nothing for 512 Ko.
  302.  
  303. V 1.31
  304. ------
  305. Bugs:
  306. - 512 Ko Option still disabled.
  307. - Cache options were wrong till version 1.30 (flushing them instead of turning
  308. them off). It's corrected now. But the TOS seems to reset them!
  309.  
  310. V 1.30
  311. ------
  312. Bugs:
  313. - 512 Ko Option doesn't work. It seems that the Falcon refuses to run with
  314. so little memory. Not yet corrected (if ever).
  315. Bugs corrected:
  316. - Setting DMA Sound Interrupt Timer A may had no effect in V1.20. It's
  317. corrected since V1.30.
  318. - Turning off DATA cache hadn't any effect. Corrected since V1.30
  319.  
  320. -------------------
  321. XIII) BACKWARD II :
  322. -------------------
  323.     As mentionned before this may be the last freeware version of BACKWARD.
  324. It will be supported (i.e. unknown bugs will be corrected, but they will be no
  325. improvements, no release 1.50). Backward takes me a lot of time  trying to run
  326. programs which crash the system, and I think they can't be great improvement of
  327. the compatibility rate.
  328.     But Backward may still be improved, and it will be, but it won't be
  329. free. BACKWARD II will feature :
  330.  - ehanced user interface, with preset set ups (like best compatibility for
  331.      example) and multilingual (english, français and maybe Deutsch).
  332.  - it will be installable. You'll only have to insert your disk in drive then
  333.      run Backward. There will be a configuration library.
  334.  - it will be REAL-TIME configurable by pressing keys.
  335.  - it will have a resident option.
  336.  - it will offer you snapshot (on any game!).
  337.  - memory save (for game saving).
  338.  
  339.      Backward II will be released in the next months during summer 93.
  340.  Get registered now ! You will receive Backward II freely with a lot of
  341.  configuration files.
  342.