home *** CD-ROM | disk | FTP | other *** search
/ The Games Machine 38 / ZGIDEMO.iso / Emulatori / free6401.zip / FREE64.DOC next >
Text File  |  1997-08-09  |  10KB  |  214 lines
  1.  
  2.  
  3.  
  4.                                    Free 64
  5.                                     -----
  6.                                  version .01
  7.                                   ---------
  8.                                Released 8-9-97
  9.                                 -------------
  10.  
  11.  
  12.  
  13.  
  14.  
  15. This document describes the basic use of this emulator.  I am only going to
  16. take about five minutes to write this, so if you need help with anything,
  17. please E-mail me.  (OK so the ASCII art took a little longer than that. :) )
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24. Command Line options:
  25. ____________________
  26.  
  27. free64 [t filename] [c]
  28.  
  29. *     t-tells Free64 you want to load a tape file into memory.  Filename is
  30.         the name of the T64 file.  You will later be prompted for the
  31.         file in the tape image you wish to load.  When the emulation starts,
  32.         typing RUN should execute the tape file.  (Note: t MUST be first on
  33.         command line.)
  34. *     c-On default, Free64 will ask to calibrate your joystick the first time
  35.         you run it only.  Use the c option to specify that you want to
  36.         calibrate anyway.  (Note: If used with 't', 'c' must come after both
  37.         't' and the filename.)
  38.  
  39. Joystick support:
  40. ________________
  41.  
  42. Support for one PC joystick is supported.  Use the NumLock key to change which
  43. C64 joystick you wish to use.  The keyboard indicator lights tell you which is
  44. currently enabled:
  45.  
  46.         _ Num     _ Caps    _ Scroll
  47.        |_|Lock   |_|Lock   |_|Lock
  48.       joy2      joy1       off
  49.  
  50. Joystick will be calibrated the first time you use Free64, after that the
  51. calibration data will be stored in FREE64.CFG.  If you delete or rename this
  52. file, Free64 will ask you to calibrate the Joystick again.  If you want to
  53. recalibrate the joystick, you can also pass the 'c' option to Free64.  (See
  54. above)
  55.  
  56. Serial Bus Support:
  57. __________________
  58. Note: Only a 1541 Disk Drive has been tested, but theoretically, any serial
  59. peripheral SHOULD work.
  60.  
  61. Free64's serial bus support uses a cable that connects to your PC's parallel
  62. port.  The pinout is below, but it is the same cable as is used in C64S (and
  63. its utilities, like COM1541), X1541, Trans64, and Star Commander, that I know
  64. of.  Please note that Free64 assumes that your parallel port is at 0x378.
  65. Maybe in the future I will let you specify other ports.  Also, If you have
  66. trouble with it, try setting your port to Normal mode, as opposed to EPP, ECP,
  67. ECP/EPP, etc.  It may work in those other modes, however it is untested. Both
  68. the port location and mode should be able to be set in your BIOS setup. If you
  69. need help with this let me know.
  70.  
  71.         Cable Pinout: (copied from LPT1541.DOC from C64S)
  72.         ____________
  73.  
  74.      IBM Lpt port Female:         CBM IEEE serial port Female:
  75.         ┌─────┐                          ╔════_════╗
  76. Strobe──┼─1■  └───┐                    ╔═╝         ╚═╗  _____
  77.         │      ■14┼──AutoFeed    Data──╫──■5     1■──╫──SrqIn  _____
  78. (Data 0)│ 2■─┐    │                    ║     6■──────╫─────────Reset
  79.         │    └─■15│(Error)      Clock──╫──■4     2■──╫──┐Ground
  80.         │ 3■      │  ____              ╚═╗   3■    ╔═╝ ─┴─
  81.         │      ■16┼──Init                ╚════╪════╝
  82.         │ 4■      │                       Atn─┘
  83.         │      ■17┼──SelectIn  ┌───────────┬───────────────────────────────┐
  84.         │ 5■      │            │ C64signal │  IBMsignal       Lpt port + 2 │
  85.         │     ┌■18│            │           │                               │
  86.         │ 6■  ├───┼──┐Ground   │  2 Ground │ 18..25 Ground                 │
  87.         │     ├■19│ ─┴─        │  3 Atn    │      1 Strobe      bit 0      │
  88.         │ 7■  │   │            │  4 Clock  │     14 AutoFeed    bit 1      │
  89.         ≈≈≈≈≈≈≈≈≈≈≈            │  5 Data   │     17 SelectIn    bit 3      │
  90.         │     └■25│            │  6 Reset  │     16 Init        bit 2      │
  91.         │13■  ┌───┘            └───────────┴───────────────────────────────┘
  92.         └─────┘
  93.  
  94. Here's how I made my cable:  I took an old serial cable:  (I apologize for
  95. sucky illustration :) )
  96.     _--------                       --------_
  97.    |_|       |==========//=========|       |_|
  98.      --------                       --------
  99. Cut off one end:                    ___
  100.     _--------                      /
  101.    |_|       |==========//=========----
  102.      --------                      \___
  103. And soldered the wires onto a 25 pin male connector:
  104.                                            _
  105.                                     ____O=| |_
  106.                                    |        | |
  107.                                    |        | |
  108.     _--------                      |        | |
  109.    |_|       |==========//=========|        | |
  110.      --------                      |        | |
  111.                                    |        | |
  112.                                    |______  |_|
  113.                                         O=|_|
  114. If you don't have a serial cable to cut up, I'm sure you could buy some kind
  115. of connector at Radio Shack or somewhere that is 6-pin male and will fit your
  116. 1541 (or other serial bus hardware).  As for the 25-pin male parallel port
  117. connector, I did get that at Radio Shack.
  118.  
  119. No, I'm sorry, I can't make you a cable.  If I can help in some other way, let
  120. me know.
  121.  
  122. Sound Support:
  123. -------------
  124.  
  125. Sucks. :)  Basically, it takes the first voice's frequency and puts it through
  126. the PC speaker.  It was not a serious attempt at sound emulation, it was
  127. mainly just so I could hear how the speed was, and whether certain programs
  128. were running, since the VIC emulation sucks so bad that sometimes its hard to
  129. tell. :)  I'm sorry, there's no way to turn it off, but if a certain sound
  130. seems to have stuck on (happens sometimes when a real SID's decay value would
  131. have made the note inaudible) you can hit F8 and the current sound will stop.
  132.  
  133. Video Support:
  134. _____________
  135.  
  136. Sucks. :)  Text mode only, supports character/background colors, but not very
  137. well:
  138.         Brown/Orange are same color
  139.         White appears grey on background
  140.         Yellow appears Brown/Orange on background
  141.         Dark Grey appears Black on background
  142.         Lite Blue/Cyan are same color(so cursor will be visible on blue)
  143.         Lite Red/Lite Green appear as Red and Green on background
  144.  
  145. This is due to the fact that the default 320x200 16 color text mode either
  146. doesn't have those colors or won't support the lighter versions in background
  147. colors.  Of course, these problems will all disappear when I make a scanline-
  148. based graphical VIC emulation. :)
  149.  
  150. Free64 does support VIC bank switching, but very little else.  In fact, the
  151. VIC emulation takes all of 12 lines in the source code. :)  The reason is that
  152. the 1541 support is the only thing that sets this emulator apart so it is the
  153. first thing I want to perfect.  When the 1541 works fine, THEN I'll worry
  154. about graphics, sound, etc. etc.
  155.  
  156. Keyboard support:
  157. ----------------
  158.  
  159. The keyboard is currently mapped as close to a real C64 as possible.
  160. Here are some of the special key definitions:
  161.         F8:     turn off the current sound playing.  Works if a note is stuck on,
  162.                 but not if music is playing.
  163.         F9:     RESTORE
  164.         F10:    Puts an abbreviation for `LOAD "*",8,1<RETURN>' into keyboard
  165.                 buffer.  This gets handy sometimes. :)
  166.         NumLock:Switches between joysticks (see above)
  167.         ESC:    Ends the emulation.
  168.  
  169.  
  170. Other notes:
  171. -----------
  172.  
  173. *   Keep these files in the same directory at all times:
  174.         ORIGINAL.64K    Kernal ROM file
  175.         ORIGINAL.64B    BASIC  ROM file
  176.         KEYTABLE.DAT    Convert PC keystrokes to C64
  177.         FREE64.CFG      Joystick calibration (Can safely be removed, if you
  178.                         want to recalibrate your joystick.)
  179.  
  180. *   I wouldn't put too much faith in the CPU usage report at the end.  I'm
  181.     not even sure I figured it right, because one time I saw 108%.  :)
  182.     Most of the time I get 50-60%, on my Pentium 166 with 83Mhz bus.  I
  183.     realize this is kind of bad, and will work on it when I can.  But, for
  184.     development purposes, it will probably only be speeded up when I can't
  185.     run it anymore. :)  Also, if your CPU usage hits 100%, the speed of the
  186.     emulation will fall.  Most of the time this happens during intense
  187.     reading/writing to either the SID or the serial bus.  The latter is bad
  188.     because the serial bus timing is sensitive and if speed drops below 100%
  189.     original, most likely the emulation will stop and wait for something the
  190.     disk already did.  No way around this, yet, but I am working...
  191.  
  192. *   I'm no lawyer, but here goes:
  193.         This software is released with NO WARRANTY OF ANY KIND, expressed or
  194.         implied.  I will try to help anyone that I can, but there is no
  195.         guarantee of support.  I also will not be responsible for any
  196.         hardware/software/physical/mental damage. :)
  197.  
  198.         All product names are trademarks/copyrights of their respective
  199.         companies.  Anyone who feels I have tread on their rights to their
  200.         product should contact me and I will remove references to your
  201.         product.  Keep in mind that I am 16 and don't have the kind of money
  202.         for a lawsuit. :)
  203.  
  204.         You may use this program in any way you want, as long as you don't
  205.         redistribute it in any other than its original form.  This includes
  206.         adding/removing files, hacking/editing files, etc.
  207.  
  208. Free64 v.01
  209. Written exclusively by Butcha
  210. Brad Martin <martin@gvi.net>
  211.  
  212. Check for new versions at:
  213. http://home.gvi.net/~martin/
  214.