- CBM-II Setup

This page will give you a detailed explanation of Vices CBM-II emulator and some idea on how to run software on it.

The GUI.

This is what you'll get when you run xcbm2 the CBM-II emulator...

By default it's 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 CBM-II 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...
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 CBM-II
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.
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.
Drive sync factor Lets you set your CBM-II 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.

 

Options Menu
Video settings...

Driver Lets you pick a video card to output Vices graphics if you have more then one.
Bitdepth Sets the colour depth of the fullscreen displayed by Vice.
Resolution Sets the resolution of the fullscreen displayed by Vice.
Refresh Rate Sets the display frequency of the fullscreen display in hz
VBLANK synchronization Can help stop "tearing" of scrolling games by synchronizing the display to your monitor.
Render to DX Primary surface Uses DirectX to display the emulator screen. Can help speed things up in some cases.

Lets you choose the colour used on the monochrome screen.

 

CBM-II Settings...

This screen lets you choose the model of the CBM-II to be emulated and how much RAM it has.

Memory Lets you choose between low and high res screen for the CBM-II.
RAM Banks Not sure. Somthing to do with memory addressing.

 

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.

Printer Emulation Sets how Vice emulates a printer attached to the CBM-II.
Printer driver

This option lets you set which printer is emulated. It can be ASCII for generic printing, the Commodore MPS803 printer or the Star NL10 printer. The latter two are better for graphic output.

Output Sets whether to output text or a graphic file.
Output to file # Sets which printer output file to use.
Output file #1 name Set up as a file called viceprnt.out which is saved as a file and can be edited later by you.
Output file #2 name Defaults to LPT1: which is your printer port.
Output file #3 name Defaults to LPT2: which is a second printer port if you have one.
Send Formfeed Sends a command to the printer to finish printing and feed out the paper.

Disk Image Lets you select a disk image file to put into your disk drive.
Directory Lets you use a folder as a "virtual" disk. The P00 bit is the file type used on Commodore disks.
Real IEC device This option is only highlighted if you have a real Commodore disk drive attached to your PC. This is done through a special interface. Read the Vice docs for more info.
None Says that there's nothing in the drive.

 

Drive settings...

Drive Type Vice emulates several Commodore disk drives. Here you can select which drive Vice emulates. If you're a bit of a techie then you can find details of the supported drives here.
40 track handling Floppy disks at the time of the CBM-II only used 40 tracks for data. This option lets Vice use more if it needs to.

VICII settings...

This option will only work when C500 support is emulated.

The options in here help with compatability in games with sprites. New colors sets the CBM-II colour palette to different 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 CBM-II.

Joystick settings...

Joystick in port #... Lets you set the keys/joystick that you wnat to use in Vice.
Select fire button Lets you set which joystick button is used for fire.
Autofire speed (1..32) Lets you set the speed of the autofire button on a joystick.
Menu 1 Lets you use an analog joystick axis to set the speed of the autofire,
Menu 2 Lets you select a controller button to use as the autofire button.
Config Keyset ...

Lets you set keys or controller movements as joystick movements in Vice.


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 CBM-II and positional which maps the keys on your keyboard the the key that is on the same position on the CBM-II keyboard. To do this it uses keyboard files which you can find documentation for in Vices help files.

Sound settings...

DirectX/WMM driver These are the drivers for your sound caqrd in windows. Each one has it's benefits on different sound cards. You'll just have to see which one siuts your card best.
Sample Frequency This is the quality of the sound produced by Vice. The higher the better but at the cost of speed on low end machines.
Sound Buffer Size The sound buffer size helps to stop sound stuttering by always keeping a bit in memory.
Oversampling Factor Boosts up the volume
Synchronization Method All this does is decide how Vice syncs the sound to the video being produced. Flexible is probably best unless you get sound problems.

 

SID setiings...

SID Engine This is the way the Vice emulates the SID sound chip used in the CBM-II. You have fastSID which is quick but not accurate, reSID which is very accurate but can slow things down and Catweazle/hardSID which are special bits of hardware for your PC to emulate C64 sound.
SID Model Selecte which SID chip to emulate.
SID Stereo Emulates a second SID chip giving stereo sound.
SID Filters Emulates programmable filters used in SID chips. Again can slow things down on ghetto PC's.

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 CBM-II. Over periods of time the ROMs get changed and updated for different revisions of the CBM-II 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!

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

The ACIA is the serial interface used by the CBM-II for communication. There isn't much documentation on it but it is required for certain serial devices to work.

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 CBM-II 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.