If you want to install OpenCBM as fast as possible, but you are not interested
in the details, just use the instructions from this section and ignore the rest
of this chapter unless you encounter any problems.
If you are more interested for a clean installation, skip this section and read
the rest of this chapter.
Linux installation walk-through
Perform the following steps to install OpenCBM on your Linux machine:
Unpack them into a directory (i.e., ~/opencbm-0.4.99.99, with
0.4.99.99 being the version number of OpenCBM).
cd into the directory: cd ~/opencbm-0.4.99.99
Compile OpenCBM and the appropriate plugin: make -f LINUX/Makefile
opencbm plugin-XXX, with XXX being one of xa1541, xu1541 or
xum1541, depending upon which adapter you are using:
Now, install the OpenCBM package. You must perform this as root, either
by using sudo, or by explicitly becoming root with su. The following
command assumes you are using sudo: sudo make -f LINUX/Makefile
install install-plugin-XXX, with XXX being the same one of
xa1541, xu1541 or xum1541 as above:
XUM1541 + Zoomfloppy only:sudo make -f LINUX/Makefile install install-plugin-xum1541
XU1541 only:sudo make -f LINUX/Makefile install install-plugin-xu1541
XA1541 + XM1541 only:sudo make -f LINUX/Makefile install install-plugin-xa1541
Connect your cable (XU1541, XUM1541, XA1541, XM1541) to your CBM IEC
device:
XUM1541 + Zoomfloppy + XU1541 only: Plug your XU1541 or XUM1541 into the USB port
XA1541 + XM1541 only: Plug your XA1541 or XM1541 cable to the parallel port
Switch on your CBM IEC device.
XA1541 + XM1541 only: Load the kernel module:
sudo /sbin/depmod -a
sudo /sbin/modprobe parport (this one might fail if you
have the parallelport compiled into the kernel instead of being a module)
sudo /sbin/insmod cbm
Now, check the file /var/log/messages if your cable was
correctly recognized.
You are almost done. Check if the command cbmctrl reset resets your
drive, or if the command cbmctrl detect prints out your device with your
device number. If this works, you are done! If not, please proceed:
If you get an error message that libopencbm cannot be found, you must add
it to your linker path. In order to do so, enter the command make -f
LINUX/Makefile ldconfig
Now, everything should be working, and you should be able to use the
OpenCBM tools even as non-root.
Mac OS X installation walk-through
Please check the instructions at
http://lallafa.de/blog/c64-projects/opencbm-on-mac/ available on the
blog of Christian Vogelgsang, who actually ported OpenCBM to the Mac. His site
should be your primary source for instructions.
For Windows, you have to install the USB drivers first if you want to use the ZoomFloppy, XUM1541 or XU1541 devices.
USB driver installation
For previous version of OpenCBM and 64 bit versions of Windows, that meant you had to fiddle around with the
driver signature enforcement in order to get this done.
For v0.4.99.99, we rely on an external tool which makes it much easier for you.
Please proceed as follows:
Attach your XUM1541/ZoomFloppy or XU1541 device to your PC via USB.
Download the zadig tool from
http://zadig.akeo.ie/.
Note that there are different versions for Windows XP and later versions for Windows; download the appropriate one!
Unpack the tool in a directory and start it. You might get an UAC prompt (Vista and later,
zadig-uac
), which you must confirm.
You should see your USB device (XUM1541, XU1541) mentioned in the screen.
If you do not, please select,
zadig-listalldevices
. This is
especially true if you installed the drivers for the USB device before.
Now, adjust some settings.
XUM1541 + ZoomFloppy only: Make sure that zadig tells you it found the "xum1541 floppy adapter", and that it
wants to install the WinUSB driver. The USB id is 16D0 (vendor) and 0504 (product).
Your screen should look like figure
zadig-xum1541
.
XU1541 only: Make sure that zadig tells you it found the "xu1541", and that it
wants to install the WinUSB driver. The USB id is 0403 (vendor) and C632 (product).
Your screen should look like figure
zadig-xu1541
.
Now, press "install driver".
Wait until you get the message "The driver was installed successfully."
zadig-success
Note: zadig does not rely on the OpenCBM files at all! Specifically, it contains its own version of the
USB drivers embedded into the executable; thus, you do not have to specify a link to the driver files,
or put them at a specific location. Just use it "as is".
UAC for zadig which must be confirmed
Enable "List all devices" for zadig
zadig settings for installing an xum1541 device
zadig settings for installing an xu1541 device
zadig message that it installed the driver successfully
Now, proceed with installation the OpenCBM tools.
OpenCBM tool installation
In order to install OpenCBM, proceed as follows:
Download the OpenCBM package binary for Windows from
http://www.trikaliotis.net/Download/opencbm-0.4.99.99/opencbm-0.4.99.99.zip
Note that unlike previous versions of OpenCBM, v0.4.99.99 now contains one package for
all supported architectures (i386 vs. amd64, 32 bit vs. 64 bit). You do not have to
choose which one to get.
Unpack it into a directory of your liking
Start a cmd.exe shell as administrator. The exact procedure varies among the different Windows versions.
Go to the directory where you unpacked the OpenCBM installation package (with the "cd" command)
Enter
ZoomFloppy only:install zoomfloppy (this is also default, that it, it suffices if you enter install only)
XUM1541 only:install xum1541
XU1541 only:install xu1541
XA1541 only:install xa1541
If you want to use the OpenCBM tool whenever you are in the cmd.exe
shell, you have to add the directory that is printed in the last line of
the install.cmd output to your PATH environment variable. In many cases,
it will be C:\Program Files\OpenCBM.