home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 January / CHIP_1_2000.ISO / exe / ccs64109.exe / Ccs64.txt < prev    next >
Encoding:
Text File  |  1997-10-19  |  18.7 KB  |  479 lines

  1. ****************************************************************************
  2.            DOCUMENTATION FOR CCS64 V1.09 SHAREWARE
  3.            (C) 1997 PER H┼KAN SUNDELL
  4.            (C) 1997 COMPUTERBRAINS
  5.            All rights reserved. 19 October 1997
  6. ****************************************************************************
  7.  
  8. COPYRIGHT
  9. ---------
  10. This version is shareware.
  11.  
  12.  
  13. DISCLAIMER
  14. ----------
  15.  
  16.   The installation and use of this product is done completely under your own
  17. responsibility. Under no circumstances should the producers of this product
  18. be held responsible for any damages or costs, that this product in any way
  19. could cause you or your equipment.
  20.  
  21.  
  22. INTRODUCTION
  23. ------------
  24.  
  25.   Welcome to the world of CCS64. This a software emulator for the
  26. Commodore 64 computer. You may say this is not the first program trying
  27. to emulate the C64. But this is planned to be the finale C64 emulator. I
  28. have worked in several years with this product, studying the C64 into its
  29. innermost secrets. This shareware version should run perfectly with all
  30. games or demos, even those using the 1541 disk drive.
  31.  
  32. REGISTRATION
  33. ------------
  34.  
  35.   As this is SHAREWARE, if you like and use this program you are supposed
  36. to register it. Of course you then will get a registered version of this
  37. program with additional features and bonuses. At the moment the register fee
  38. is 30 USD, or equal amount in GBP,DEM or SEK. Credit cards or CHEQUES can NOT
  39. be used. Please consult your local post office or bank for proper ways of
  40. sending money to Sweden.
  41.  
  42.   To register you send a international postal money order or cash money,
  43. together with your name, address and/or e-mail to:
  44.  
  45.   Per Håkan Sundell
  46.   Sundell Consulting
  47.   Nygatan 5A IV
  48. S-231 43 TRELLEBORG
  49.   SWEDEN
  50.  
  51.   Or you can transfer the money directly to my bank account. Please pay via
  52. Eurogiro or SWIFT to our (Sundell Consulting) account number 607 85 52-4
  53. with Postgirot Bank AB (publ) S-105 06 Stockholm, Sweden.
  54. SWIFT address: PGSI SESS
  55.  
  56.   Note that registered users are entitled to unlimited number of updates of
  57. CCS64 without any further costs. The product will be continously updated as
  58. long as there is any features or bugs to be fixed. This means that you could
  59. safely register now, even if some special feature is not ready yet, as you will
  60. not miss the update when that special feature is ready.
  61.  
  62.  
  63. SYSTEM REQUIREMENTS
  64. -------------------
  65.  
  66. Minimum requirements:
  67. * Pentium processor or equal.
  68. * 8 Mb of internal memory.
  69. * VGA graphics.
  70. * DOS 5.0 or later.
  71.  
  72. Additional support:
  73. * Soundblaster 8/16 or compatibles.
  74. * Gravis Ultrasound.
  75. * Windows 95.
  76.  
  77.  
  78. INFORMATION
  79. -----------
  80.  
  81. The emulation of the C64 computer supports:
  82.  
  83. * 99.9% 6510 CPU. All imaginable programs should work. The emulation of CPU
  84.   is cycle exact and considers all strange side-effects.
  85.  
  86. * 99.9% 6567 VIC - PAL. All imaginable graphics modes and effect should work.
  87.   The emulation of VIC is pixel exact and considers all strange effects,
  88.   both known and unknown, as it emulates the inner workings of the VIC chip.
  89.  
  90. * 6581 SID. Nearly 100% except for filters. The emulation of SID is cycle
  91.   exact and constructs fully synthetic samples in 8 or 16 bits resolution.
  92.  
  93. * 99.9% 6526 CIAS. All features of the I/O circuits. The emulation of CIA is
  94.   cycle exact.
  95.  
  96. * 99% Commodore 1541 Diskdrive. The emulation of 1541 is cycle exact.
  97.  
  98. * C64 Keyboard. All keys including Restore.
  99.  
  100.  
  101. To make it easier to use the program supports:
  102.  
  103. * Graphics output for VGA in resolutions 384x282,384x246,368x240 and 320x200.
  104.  
  105. * Sound output for Soundblaster or Ultrasound in quality up to the maximum
  106.   the soundcard manages (45454 Hz in 16 bit).
  107.  
  108. * 'Reset and Load' of one-parted programs in .PRG or .T64 file formats.
  109.  
  110. * Screen snap-shot, saves an image of the whole current C64 screen
  111.   (504x312 pixels).
  112.  
  113. * Joystick emulation, both with keys and real PC joysticks.
  114.  
  115. * Options menu.
  116.  
  117. * True tape emulation including turbotape and tape images (use originals on
  118.   tape). Sorry but for the true tape images, I am the only on able to create
  119.   them, as I use special hardware and program on my AMIGA computer.
  120.  
  121. * Freeze function, to save or restore the status of the emulator. This feature
  122.   is under development so use with care...
  123.  
  124. * Machine code monitor. This feature is under development so use with care...
  125.  
  126.  
  127. The registered version of the program will in near future (or already does)
  128. support:
  129.  
  130. * Ability to actually save the currently used .D64 file that is used for
  131. 1541 emulation. This enables you to save hiscores etc. from games that
  132. saves data to the 1541 diskdrive. *** This feature is ready ***
  133.  
  134. * Create empty .D64 files. *** This feature is ready ***
  135.  
  136. * Better options menu.
  137.  
  138. * Making wave-files from C64 music. *** This feature is ready ***
  139.  
  140. * Cartridge support.
  141.  
  142. * Speed control. *** This feature is ready ***
  143.  
  144. * Support for different file formats like LYNX and extended 1541.
  145.  
  146. * Memory expansion unit REU 1750 (16Mb).
  147.  
  148. * Commodore 1351 Mouse emulation.
  149.  
  150.  
  151.   The registered version is on the working stage and will be ready as fast
  152. as users register. Thus, more support from you gives better program.
  153.  
  154.  
  155. INSTRUCTIONS
  156. ------------
  157.  
  158.   To start the program from Windows, just double-click the C64 icon. If you
  159. want to run from DOS, change to correct directory and type CCS64. If you
  160. have any problems with running the program from Windows, then reboot and run
  161. the program from DOS instead.
  162.  
  163.   To change the program preferences either use the program menu by pressing
  164. the key F9 from the program, or edit the C64.CFG file:
  165.  
  166.   If you have any problems with the settings and want the factory default
  167. settings back, just delete C64.CFG file and it will be restored next time
  168. you run CCS64.
  169.  
  170.   SCREENMODE=
  171.     1 - 320 horizontal pixels and 200 vertical lines Chained mode in 70 Hz.
  172.     2 - 368 horizontal pixels and 240 vertical lines Planar mode in 60 Hz.
  173.     3 - 384 horizontal pixels and 246 vertical lines Planar mode in 60 Hz.
  174.     4 - 384 horizontal pixels and 282 vertical lines Planar mode in 50 Hz.
  175.     5 - 384 horizontal pixels and 282 vertical lines Planar mode with Scanlines
  176.       in 60 Hz.
  177.     Note that the PAL Television standard is most like mode 4. If you change
  178.     to a mode that doesn't work (or look nice) on your equipment, immediately
  179.     (this is VERY important, or your equipment can be damaged) quit the
  180.     CCS64 program by pressing PAUSE or shut of the computer.
  181.  
  182.   SOUNDENABLE=
  183.     YES - On.
  184.     NO - Off.
  185.  
  186.   SAMPLEFREQ=
  187.     11111,22222,45454 etc. recommended on Soundblaster.
  188.     11025,22050,44100 etc. recommended on Ultrasound.
  189.     any other value (ex. 17923) if your soundcard can manage it.
  190.  
  191.   SAMPLEBITS=
  192.     16 - Tries to use 16 bits samples, otherwise uses 8.
  193.     8 - 8 bits samples.
  194.  
  195.   LOADPATH=
  196.     the path where you have your C64 games and demos.
  197.  
  198.   RGBCOLOR0=
  199.   RGBCOLOR1=
  200.   ...
  201.   RGBCOLOR15=
  202.     the RGB color values that should be used for emulating the C64 colors.
  203.  
  204.  
  205.   To use PC joysticks you don't have to calibrate, just plug it in anytime.
  206. If you still have problems you have the possibility to calibrate in the menu.
  207.  
  208.   The keyboard is emulated almost like a real C64 keyboard except for these
  209. keys:
  210.  
  211.     PAUSE        = Exit CCS64.
  212.     F9            = Options menu.
  213.     F10            = Captures the interlaced screen as an image in 256
  214.               colors (ccs??.bmp).
  215.     F11            = Restores a frozen emulator state.
  216.     F12            = Freezes (saves) the emulator state.
  217.     Print Screen     = Captures the screen as an image (ccs??.bmp).
  218.     Scroll Lock        = Reinitialize screen mode. Sometime Windows
  219.               manages to distort colors when switching between
  220.               programs.
  221.     Left CTRL        = Commodore.
  222.     Escape        = Run/Stop.
  223.     Delete        = Arrow Up.
  224.     Insert        = Pound.
  225.     Home        = Clr/Home.
  226.     Page Up             = RESTORE. Observe that you must HIT this key like
  227.               on a real C64! Hitting means holding down key for
  228.               very short moment.
  229.  
  230.   The default joystick emulation in keys is as follows:
  231.  
  232.     C64 Joystick Port 1 -
  233.       Fire  - Right ALT (ALT GR)
  234.       Up    - Keypad %
  235.       Down  - Keypad 5
  236.       Left  - Keypad 7
  237.       Right - Keypad 9
  238.  
  239.     C64 Joystick Port 2 -
  240.       Fire  - Right CTRL
  241.       Up    - Keypad 8
  242.       Down  - Keypad 2
  243.       Left  - Keypad 4
  244.       Right - Keypad 6
  245.  
  246.   To use the Options menu press F9 and then use the cursor keys to select. Use
  247.   cursor right, space or enter to enter a choice. Use cursor left to go back to
  248.   the previous menu from a submenu. Use cursor up or down to change selection.
  249.   In a directory listing you could also use PageUp or PageDown to scroll faster
  250.   through the selections.
  251.  
  252.   The MENU is organized as follows:
  253.  
  254.   CONTINUE - Go back to C64 mode.
  255.   LOAD PROGRAM - Load a C64 program file, select a .D64 disk image or start a
  256.     Tape emulation session.
  257.   RESET C64 (HARD) - Reset the C64, as it would be turned off and on again.
  258.   RESET C64 (SOFT) - Reset the C64, as you would have a reset button.
  259.   CCSMON ON/OFF - Enable or disable the CCS-MON ROM cartridge emulation.
  260.   OPTIONS - A submenu of special options and features.
  261.   QUIT - Quits the CCS64 emulator.
  262.  
  263.   The submenu OPTIONS is organized as follows:
  264.  
  265.   SCREENMODE - A submenu where you could select a different resolution.
  266.   JOYSTICK - A submenu where you could select from different possible joystick
  267.     emulation combinations (real joystick and/or keyboard).
  268.   JOYSTICK CALIBRATION - A submenu where you could calibrate your joystick for
  269.     use with CCS64. Useful if you have problems with your PC joystick like not
  270.     responding to movement or going in the wrong direction.
  271.   C1541 ON/OFF - Enable or disable the Commodore 1541 diskdrive emulation.
  272.     Useful for some games that don't allow the C64 computer to be connected to
  273.     a 1541 diskdrive.
  274. *** Registered version only ! ***
  275.   SAVE CURRENT DISK - As the 1541 diskdrive emulation don't save directly to
  276.     the PC filesystem when you save something to device 8 from the C64 mode,
  277.     you have to force saving to PC with this selection. In this way you could
  278.     decide not to save for example hiscores or a adventure game state which you
  279.     don't like.
  280. *** Registered version only ! ***
  281.   SPEED 100% - This selection will allow you to change the maximum speed which
  282.     CCS64 will run in, compared to a real C64. To change the value, select this
  283.     selection and then use cursor left or right to increase or decrease the
  284.     value. When your satisfied, press cursor up or down.
  285. *** Registered version only ! ***
  286.   CREATE EMPTY DISK - This will create a new .D64 fileimage in the current
  287.     directory as the CCS64 package lies in. Nice if you're writing a program
  288.     and want to save it. Just select this option, and go back to C64 mode and
  289.     type SAVE "PRGRAMNAME",8 .
  290. *** Registered version only ! ***
  291.   SOUND SAMPLING START/STOP - This will create a new .WAV file in the current
  292.     directory as the CCS64 package lies in. After starting of this feature, all
  293.     sound output from the C64 will be saved to this file continously. Note that
  294.     this file will increase in size very quickly, and should therefore be used
  295.     with care so you won't run out of diskspace.
  296.  
  297.   To actually start a program after 'Reset and Load' you have to type RUN
  298.   and pressing Enter. This is because 'Reset and Load' only loads the
  299.   program into C64's memory banks.
  300.  
  301.   To change 1541 disk just select the .D64 file and enter its directory. Note
  302.   that you should not select 'Reset and Load', just press Escape to exit the
  303.   menu.
  304.  
  305.   Note that when your sampling the C64's audio output to a .WAV file, the sample
  306.   rate and bit resolution will be the same as selected in the C64.CFG file.
  307.  
  308.   Note that on a german keyboard, the keys Y and Z will have changed place when
  309.   using under CCS64.
  310.  
  311. KNOWN PROBLEMS
  312. --------------
  313.  
  314.   Sometimes special games on .D64 images will behave badly when you use
  315. the 'Reset and Load' feature. To solve this problems do like this.
  316. 1). Reset the C64. 2). Enter menu and select the correct .D64 and enter its
  317. contents listing, but do not select a filename when the contents shows up,
  318. just go back to the main menu and select Continue. 3). From the BASIC type:
  319. LOAD"*",8,1
  320.  
  321.   If you do not have a CD-ROM in your CD-drive or a disk in your diskdrive, the
  322. emulator will hang up if you select this device in the menu. So please, always
  323. be sure that you have a initialized (sometimes you have to wait some seconds
  324. after instering it) CD-ROM in your CD-drive before trying to use the CD device
  325. from the menu.
  326.  
  327.   The option load as Turbo tape should only be used when you get a message like
  328. "PRESS PLAY ON TAPE" on your C64-screen, and you're shure about that the second
  329. part should be loaded as turbo tape. Otherwise nothing useful will happen.
  330.  
  331.   Note that when you use 'Reset and Load' from the menu, the program will not
  332. be started directly, just loaded into memory. Please type RUN to actually start
  333. the program afterwards.
  334.  
  335.   Some programs are made for the american version of C64 that supports the
  336. american TV system NTSC. As CCS64 only emulates the european C64 version that
  337. uses TV system PAL, those NTSC programs could behave badly with the emulator,
  338. just as they would on a real C64 PAL system.
  339.  
  340.   Using the emulator under Windows with old and outdated sound drivers can
  341. sometimes cause the system to hang, or getting no sound at all. In these
  342. cases, run in DOS if possible.
  343.  
  344.  
  345. NOTES
  346. -----
  347.  
  348.   The C64 roms is under copyright (C) by Commodore Business Machines. If you
  349. don't want these original roms you could replace the files KERNAL.ROM,
  350. BASIC.ROM and CHAR.ROM.
  351.  
  352.  
  353. CONTACT ADDRESS
  354. ---------------
  355.  
  356.   If you have any emulation problems or suggestions, that don't concern
  357. SID filters or NTSC, please contact me. Note that I get a lot of e-mail, so
  358. perhaps don't count on that I will reply to it. But of course I will read it.
  359.  
  360.   e-mail: Hakan.Sundell@xpress.se
  361.  
  362.   CCS64 homepage: http://www.fatal-design.com/ccs64
  363.  
  364.   Note that these addresses can change within near future, and when so have
  365. happended you most certainly can find my new addresses by searching the
  366. Internet.
  367.  
  368.  
  369. CCS-MON
  370. -------
  371.  
  372.   CCS-MON is a machine code monitor made for the C64 on a cartridge. CCS64
  373. support emulation of this cartridge. You should mainly use this cartridge
  374. when you want to look or enter something in a c64 program. It also includes
  375. a disk turbo, turbo tape and some other utilities.
  376.  
  377.   Here is a list of the commands used in CCS-MON. The <xxxx>,<yyyy> etcetera
  378. means a memory address location in hexadecimal notation. Things in [] are
  379. optional and do not have to be given.
  380.  
  381.   A <xxxx> <mnemonic>           - Assemble machine code at address xxxx.
  382.   B <xxxx>                      - Set Breakpoint (see Q,W commands) at xxxx.
  383.   C <xxxx> <yyyy> <zzzz>        - Compare the memory contents between addresses
  384.                 xxxx to yyyy with the contents at zzzz and on.
  385.                 If there are any differences these will be shown
  386.   D <xxxx> [<yyyy>]             - Disassemble the machine code instruction at
  387.                 xxxx, and optional each succeeding lines until
  388.                 yyyy.
  389.   E                             - Installs extended interrupt handlers at RAM
  390.                 adresses FFE0-FFFF, so that tracing at normally
  391.                 hidden RAM is possible.
  392.   F <xxxx> <yyyy> <zz>          - Fills the memory at xxxx to yyyy with the
  393.                 byte zz.
  394.   G [<xxxx>]                    - Executes the machine code at the current PC
  395.                 (see R command) or optional at adress xxxx.
  396.   H <xxxx> <yyyy> <zz> ...      - Hunts the memory at xxxx to yyyy for the
  397.                 occurances of the byte sequence of one or more
  398.                 bytes.
  399.   I <xxxx> [<yyyy>]             - Interpret the memory at xxxx to yyyy as
  400.                 ASCII text.
  401.   L "filename" <zz> [<xxxx>]    - Loads a file from device zz into memory xxxx
  402.                 or default address.
  403.   M <xxxx> [<yyyy>]             - Shows the memory contents at xxxx to yyyy.
  404.   O "command"                   - Output a command to the 1541 diskdrive.
  405.   Q [<xxxx>]                    - Quicktraces the machine code at the current
  406.                 PC (see R command) or optional at adress xxxx.
  407.   R                             - Show the contents of the internal register
  408.                 of the 6510 cpu.
  409.   S "filename" <zz> <xxxx> <yyyy>
  410.                 - Saves a file from memory xxxx to yyyy, to
  411.                 device zz.
  412.   T <xxxx> <yyyy> <zzzz>        - Copies the memory contents of xxxx to yyyy,
  413.                 to zzzz and on.
  414.   W [<xxxx>]                    - Traces the machine code at the current
  415.                 PC (see R command) or optional at adress xxxx.
  416.   X                             - Exit and enter BASIC.
  417.   XC                            - Exit and enter initialized BASIC.
  418.   XZ                            - Exit and enter initialized BASIC and screen.
  419.   @                             - Shows the status of the 1541 diskdrive.
  420.   *                             - Changes the contents of the 6510 memory bank
  421.                 register to allow access to special RAM areas.
  422.  
  423.   The following keys have special meanings in CCS-MON.
  424.  
  425.   F1                            - Show the directory contents of the current
  426.                 inserted 1541 disk.
  427.   F3                            - Alternative color set.
  428.   F5                            - Used with F1 to load the filename on the
  429.                 current line.
  430.   F8                            - Clears all RAM at adressen 0800-FFFF.
  431.  
  432.   The following keys have special meanings in CCS-MON when you do RESET and
  433. are holding down these.
  434.  
  435.   Space                         - Copies the memory at adresses at 0000-07FF
  436.                 to the RAM at D000-D7FF.
  437.  
  438.   The following keys have special meanings in CCS-MON when you do RESET or
  439. hitting RESTORE and are holding down these.
  440.  
  441.   Commodore                     - The same as the XZ command.
  442.  
  443.  
  444. TURBO TAPE
  445. ----------
  446.  
  447.   Some programs in two or more parts in a .T64 archive uses Turbo Tape to
  448. load the second Part. When the C64 shows a message on the screen like 'Press
  449. play on tape' you should enter the Menu and select the second (or another)
  450. filename in the archive and select 'Load as Turbo Tape'. Thereafter CCS64
  451. will behave like you would have a cassette player connected to your C64.
  452.  
  453.  
  454. TIPS AND TRICKS
  455. ---------------
  456.  
  457.   As the CCS-MON has built in 1541 disk-turbo, you could speed up the
  458. loading time on some games. Just enable CCS-MON and Reset the C64 while
  459. holding down the commodore key. Thereafter you select the correct .D64
  460. images, and the load the correct files with the BASIC load command,
  461. just like on a real C64.
  462.  
  463.   If you have some problems with the configuration of CCS64, and want to go
  464. back to the default settings, just delete the C64.CFG file.
  465.  
  466. FILENAMES
  467. ---------
  468.  
  469.   When you use the Screen-Shot function, the image will be saved as CCS0.BMP
  470. or CCS1.BMP,CCS2.BMP and so on.
  471.  
  472.   When you create a new empty .D64 file, the image will be saved as CCS0.D64
  473. or CCS1.D64,CCS2.D64 and so on.
  474.  
  475.   When you uses sound sampling the audio file will be saved as CCS0.WAV
  476. or CCS1.WAV,CCS2.WAV and so on.
  477.  
  478.  
  479.