- C128 Setup

This page will give you a detailed explanation of Vices C128 emulator and some idea on how to run software on it.
The GUI.
This is what you'll get when you run x128 the C128 emulator...

Oh and...
"So why two screens?" I hear you cry. Well the C128 had the ability to output a high resolution 80 column screen in monochrome as well as the normal 40 column screen. So to support both screens Vice needs to open two windows.
By default Vice is pretty well set up so you could start running software straight away but it's best to read on as there's setting you'll need to know.
The Menus
| File Menu | |
| Autostart Disk/Tape Image... | This option will open a dialog box where you can select a tape or disk image file and Vice will automatically run it without you typing in any commands. |
| Attach Disk Image... | Lets you attach a disk image file to one on Vices virtual disk drives. Just the same as putting in a disk. If you know anything about C128 basic you can access the disk as you would on the real machine. |
| Detach Disk Image | Ejects your virtual disk. |
| Flip List | Lets you create a set of disk images that will be inserted in order into the virtual drive. |
| Attach Tape Image... | Puts a tape image file into Vices virtual tape recorder. |
| Detach Tape Image | Ejects the tape. |
| Datassette Control | These are the controls for the virtual cassette player used by Vice and is needed to play multiload games etc... |
| Attach Cartridge Image... | Inserts a rom cartridge file into the C128 cartridge slot ready for use. |
| Detach Cartridge Image | Ejects the cartridge. |
| Pause | Pauses Vice |
| Monitor | Opens the memory monitor screen used to help debug stuff and see what's going on in your program. Expert use only! |
| Reset | Hard or Soft resets Vice. Difference being soft is like a key combo where as hard is like physically unplugging the C128 |
| Debug | Open Vices debug winow. Expert use only! |
| Exit | Exits Vice. |
| Snapshot Menu | |
| Load snapshot image... | Loads a saved snapshot file. |
| Save snapshot image... | Saves a copy of the complete status of the emulator to a file you can specify. |
| Load quicksnapshot image | Loads a quicksnapshot image. |
| Save quicksnapshot image | Saves a copy of the emulator to a preset quicksave file. |
| Start/Stop Recording History | This option lets you record you action in the emulator including any options you change and how you effect the system you are running. |
| Start/Stop Playback History | This lets you play back your recorded actions. |
| Set Recording Milestone | Lets you put a save a point in a recording you're making that you can return to at a later time. Useful if you're playing a game, die and want to go back to the beginning of the level. |
| Return to Milestone | Takes you back to the milestone and continues recording. |
| Recording start mode | This option lets you select how Vice starts to make a recording. It can save a snapshot, load a saved snapshot, reset the emulator first or overwrite an existing playback file with a new one. |
| Select History files/directory | This option lets you set a specific folder to record/play history files from. This is useful if you have loads of saved histories in stored different folders. |
| Save/stop media file... | Lets you save the output from vice to a file be it sound or even video. The video part of it needs a file called ffmpeg. You can get it from here. All you need to do is extract it to your C:\Vice folder, restart the emulator and Vice will pick up it's there and let you record video. |
| Options Menu | |
| Refresh Rate | Sets the amount of times that Vice refreshes it's screen. It does it by missing out frames to be drawn which in turn speeds up the emulator. 1/1 will draw every fame whilst 1/5 will only draw one out of every five frames. This is only needed if you have a slower computer and want to maintain the correct software speed. |
| Maximum Speed | Maximum sets just how fast Vice runs. 200% would let Vice run at twice it's normal spped if your system can handle it whilst 50% would halve the speed Vice runs at. (good if your crap at games ;p ) |
| Warp Mode | Warp mode cuts of all restrictions in Vice including sound and runs your software as fast as it possibly can. (Great for slow loading tape games!) |
| Fullscreen | Runs Vice using the whole screen. |
| Video cache | Vice uses your video cards memory for drawing it's screen. |
| Double size | Doubles the size of Vices window. |
| Double Scan | Removes the "scanline" effect on doubled windows. |
| PAL Emulation | Adds a blurry effect like a TV signal would. |
| Scale2x | Takes the doubled screen and smoothes out the edges of anthing on screen. |
| VDC settings | Lets you set up the second VDC screen. |
| Swap Joystick | Swaps the joystick from port a to port b and vice versa. This is sometimes needed by games |
| Sound Playback | Enables/Disables sound in Vice |
| True Drive Emulation | Emulates the hardware that run the drives in Vice as accurately as possible. Used for compatability. |
| Virtual device traps | Emulates accurately how the drives in Vice work. Used again for compatability. |
| Video standard | Lets you set your C128 to PAL(UK/EUROPE) or NTSC (US/JAP) |
| Emulator Identification | Lets certain programs know that they are being run in an emulator not on the real machine. |
| IEEE488 Interface Emulation | Emulates the parallel port on the C128. |
| 1351 mouse emulation | This emulates the 1351 mouse device for the C128 which was used in some software (art packages etc). |
| Options Menu | |||||||||||||||||||||||||||||||
| Video settings... |
OK it says VICII in x64 but I though I'd save some time and reuse the Vic 20 shot. Oh VIC and VICII are the graphics chip.
The VDC palette option lets you load a palette file to set the colours used in the VDC
|
||||||||||||||||||||||||||||||
| Peripheral settings... | Before I start to shorten things a bit because on each page there is a button called "Use IEC Device". This button enables the device for Vice to use. The following will describe what the options for the printer and drive pages do.
|
||||||||||||||||||||||||||||||
| Drive settings... |
|
||||||||||||||||||||||||||||||
| Datasette settings... |
All this window really does is set the speed of the datasette motor. Use only if you are sure you know what your doing. Oh the Reset Datasette with CPU option will "rewind" the tape if you reset the C128. |
||||||||||||||||||||||||||||||
| VICII settings... |
The options in here help with compatability in games with sprites. New colors sets the C128 colour palette to different settings. |
||||||||||||||||||||||||||||||
| Joystick settings... |
|
||||||||||||||||||||||||||||||
| Keyboard settings... |
This screen lets you use alternative keymaps for use in Vice. This is useful if you don't have a standard US/UK keyboard. The two types are symbolic which means it maps a key combination to a single key on the C128 and positional which maps the keys on your keyboard the the key that is on the same position on the C128 keyboard. To do this it uses keyboard files which you can find documentation for in Vices help files. |
||||||||||||||||||||||||||||||
| Sound settings... |
|
||||||||||||||||||||||||||||||
| SID setiings... |
The ReSID lets you set up how accurate the ReSID emualtion is and the HardSID tab lets you set up your HardSID device if you have one. |
||||||||||||||||||||||||||||||
| ROM Settings... |
This window lets you change the ROMS use in the C128. Over periods of time the ROMs get changed and updated for different revisions of the C128 and if you can get hold of them you can use them in Vice. |
||||||||||||||||||||||||||||||
| RAM settings... |
As you can see this is for experts only. I haven't got a clue either! |
||||||||||||||||||||||||||||||
| C128 settings... |
Lets you set the country of the C128 that you want to emulate. I cant find any documents on the function ROMs yet so I don't know. |
||||||||||||||||||||||||||||||
| RS232 settings... |
This window sets up Vices RS232 (serial port) output. Like the printer you can send the output to a file or a device connected to your computers serial port. This again is more for the expert but you may find it more familiar as you get more used to Vice and the computers it emulates. |
||||||||||||||||||||||||||||||
| Cartridge/IO settings |
REU stands for Ram Expansion Unit and fitted into the back of the C128 expanding the ram up to 16MB. You can select the size of the expansion with the REU size menu. The REU file is used as a backup image of the contents of the REU.
This window lets you set up the emulation of an IDE64 hard drive in Vice. This requires a specific cartridge ROM image to be running on the C128 which you can get from here. Download the firmware which is zipped and open it. In the archive there is another zip file called perper01.zip. Open that one and extract the peron64.prg to your C:\Vice folder. Now attach the perom64.prg file as a cartridge image from the file menu. To use it you'll need to read the instruction on the IDE64 site.
This is what you'll see if you try and open the Ethernet settings option. If you really want to use ethernet emulation then you'll neet to install some software on your PC. It's calles WinPCAP and you can get it from here. I'm not going into this option as the guide is for beginners so you'll need to investigate this yourself.
The ACIA is a special serial interface used by the C128 for communication. There isn't much documentation on it but it is required for certain serial devices to work.
This window lets you select which serial device you want to use and the speed at which Vice accesses it. |
||||||||||||||||||||||||||||||
| Save current settings | Saves the current settings to a file | ||||||||||||||||||||||||||||||
| Load saved settings | Loads saved settings. | ||||||||||||||||||||||||||||||
| Set default settings | Sets the current settings as the default for the C128 emulator. | ||||||||||||||||||||||||||||||
| Save settings on exit | Automatically saves your settings as default when Vice exits. | ||||||||||||||||||||||||||||||
| Confirm on exit | Enables the "Are you sure you want to quit" window when you exit Vice. | ||||||||||||||||||||||||||||||
How to play a game
Use the options above to set up vice how you want. Once that's done go to the file menu and select "Autostart tape/disk image", select the file you want to play and Vice will load it. If you are loading a tape image you can speed loading up by using Warp Mode.
©2000-2005 MrV2K.