home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / amiga / vic_emu.txt < prev    next >
Text File  |  1995-08-16  |  4KB  |  164 lines
  1.     ==============================================================
  2.     VIC-Emu is (C) Copyright 1994 by Pieter van Leuven. All rights
  3.     reserved. Freely distributable, except that it may not be
  4.     distributed for profit without permission from the author. 
  5.     ==============================================================
  6.  
  7.  
  8.         VIC-20 Emulator 
  9.         (Very brief Read.Me)
  10.  
  11. Why:    Because I didn't had a C64 but a VIC-20 before I bought
  12.     an Amiga and to remember 'the good old days' I had to write 
  13.     my own emulator. So here it is ......
  14.  
  15. HowToUse:
  16.  
  17.     This package contains two binairies:
  18.  
  19.     vic-00:    For the 68000 amigas
  20.     vic-20: For the >=68020 amigas 
  21.  
  22.     Usage:
  23.  
  24.     vic-x0 [-k n] [-s n] [$xxxx file  ....]
  25.  
  26.     -k   n    number of Vertical Screen interrupts between
  27.         the VIC-interrupts for the Keyboard.
  28.         (default = 5 (10 per second. Real = 60 per second))
  29.  
  30.     -s   n    number of Vertical Screen interrupts between
  31.         two screen-updates. 
  32.         (default = 12 (4 per second))
  33.  
  34.     $xxxx    Start address where following file must be loaded.
  35.         E.g. vic $8000 char.rom
  36.         places the char.rom-file on address $8000 in the
  37.         VIC-memory map.
  38.  
  39.         There are 2 special filenames:
  40.         ramx:    add ram on the specified address. X stands
  41.             for the size of the memory in Kbytes.
  42.             E.G. vic $a000 pacman.a0
  43.  
  44.         nopx:    Define from address to address + x * 1024
  45.             no ram/rom/io. This can be used to overwrite
  46.             default values which are defined in the
  47.             vic-config file.
  48.             E.G. vic $0400 ram3
  49.             Add 3K with standard vic.
  50.     
  51.  
  52.     Vic-config:
  53.         In the 'vic-config' file is the default memory-map
  54.         defined. Each line contains one address and a file.
  55.  
  56.         E.G.
  57.         $8000    char.rom
  58.         $c000    basic.rom
  59.         $e000    kernal.rom
  60.  
  61.         $0400    ram3        (add 3K ram)
  62.         $2000    ram8        (add 8K ram)
  63.  
  64.  
  65. Keys:    Because the key-matrix is implemented very straight
  66.     forward not all keys have a logical place on the Amiga
  67.     keyboard. The most important differences are shown below:
  68.  
  69.     VIC    |    Amiga        VIC     |   Amiga
  70.     -------+---------        --------+--------
  71.     F2     | SHIFT-F1        "       | @
  72.     F4     | SHIFT-F2        +       | -
  73.     F6     | SHIFT-F4        -       | =
  74.     F8     | SHIFT-F5        =       | F10
  75.     <-     | ` (~)            &       | ^
  76.     '      | &            (       | *
  77.     )      | (            HOME    | <- (BackSpace)
  78.     @      | [            *       | ]
  79.     :      | ;                      [       | :
  80.     ;      | '            ]       | "
  81.     STOP   | CTRL            C=      | ALT
  82.     BACK-SP| DEL
  83.  
  84.     And of course you have to press SHIFT -> to move the
  85.     cursor to the left and SHIFT V(arrow-down) to move the
  86.     cursor upwards.
  87.  
  88. Speed:    On a 68000 system the next program takes 8.8 seconds
  89.  
  90.     10 FORI=1TO2000
  91.     20 NEXTI
  92.  
  93.     Please send information about other systems!!!
  94.  
  95. Working Games:
  96.     APE_ESCAPE    CAVE_IN            CHOPLIFTER.SYS_40961
  97.     COSMIC-CRUNCHER    COSMIC-JAILBREAK    GOLD_FEVER
  98.     MAZE        MENAGERIE        MOSQUITOS
  99.     ORBIT        PACMAN.ATARI        PREDATOR
  100.     QUAKERS        RAT_RACE        ROADRACE
  101.     ROBOT_PANIC    SARGON_II        SATELLITE_PATROL
  102.     SCORPION    SERPENTINE        TERRAGUARD
  103.     TRASHMAN    VC-EXTRA (No Game)    VIDEOMANIA
  104.     BUCK_ROGERS    DEFENDER        K-RAZY
  105.     LODERUNNER    POLE_POSITION        ROBOTRON
  106.     STAR_PATROL    UBOOT-COMMANDER
  107.  
  108. Not Working Games:
  109.     ARACHNOID    (Only intro screen)
  110.     CATCH_A_SNATCH
  111.     CENTIPEDE
  112.     CLOWNS        (Only intro-screen)
  113.     ET
  114.     FAST_EDDIE
  115.     GORF        (Only First 2 levels are working. Timers not emulated)
  116.     KONG
  117.     MONEY_WARS    (Only Intro Screen. Keys are not recognized)
  118.     STARPOST    (Joystick and Keyboard is not working??)
  119.     SUPER_AMOK    (Screen gets out of control)
  120.     TURMOIL        (Only first screen)
  121.     WACKY_WAITERS_SYS48896    (Works sometimes)
  122.  
  123. Programs:
  124.     Vic-programs can be found on:
  125.     
  126.     ftp.hrz.uni-kassel.de    (/pub/machines/vic-20)
  127.     
  128.     and
  129.  
  130.     nic.funet.fi        (/pub/cmb/vic  ??)
  131.  
  132. Todo:    Improve disk-support.
  133.     Implement 'White Noise'.
  134.     Implement NMI. (restore key)
  135.     Improve interrupts.
  136.     Emulate VIA's.
  137.     Improve Key-mapping
  138.     Find bug which causes guru's.
  139.     Make it faster. (or slower when it goes to fast)
  140.     Make a icon for it. (volunteers?)
  141.     Improve docs.
  142.  
  143.     
  144. Thanks:    Yacco de Leeuw         who supplied the ROM-images
  145.     Frank van Leeuwen    for giving hints for optimizing
  146.                 the 6502-code
  147.     Roeland Kamps        for the video optimizing and the other
  148.                 optimizing tricks
  149.     Andreas Heitmann    for transfering cartridges to files
  150.     Paul Kolenbrander    and his A4000 who showed me the first
  151.                 8MHz VIC ;-).
  152.  
  153. Bug reports, remarks, improvements, $$ (not by E-mail) or 
  154. comments (also positive):
  155.  
  156.     E-Mail etmpile@crosby.ericsson.se
  157.  
  158.     or
  159.     
  160.     Pieter van Leuven
  161.     Markt 19A
  162.     5688 AJ  Oirschot
  163.     Holland
  164.