Skip to content

Software Installation

Keir Fraser edited this page May 19, 2020 · 40 revisions

First download Greaseweazle. These instructions assume the download has been unzipped to the Greaseweazle folder.

Further steps depend on your host OS:

Windows

Greaseweazle is packaged as a Windows executable, hence there are no extra application components to download or install (unless you wish to be able to read IPF image files).

Greaseweazle uses Microsoft's usbser.sys device driver. The steps to install the driver depend on your Windows OS version.

Windows 10: The correct driver is automatically installed.

Windows 7 & 8: The driver must be manually installed as follows:

  1. Download and install Zadig
  2. Connect Greaseweazle via USB
  3. Start Zadig
  4. Select "List all devices" from the Options pull-down menu
  5. Select "Greaseweazle" in the dropdown list
  6. Select "USB Serial (CDC)" as the driver
  7. Select "Install driver" or "Replace driver"

Windows Vista and earlier (XP, 2000, ...): Follow the instructions for Windows 7 & 8, but you must download an older version of Zadig (zadig_xp-2.2.exe).

From now on Greaseweazle will automatically appear as a COM device (typically COM3). To run the Greaseweazle program and dump a disk:

Greaseweazle\gw read mydisk.scp

Mac OS

Download and run the Python v3 installer. Then, in a Terminal:

python3 -m pip install --user crcmod pyserial bitarray

Note that bitarray requires Xcode to be installed, as it is built from source. You can find Xcode in the App Store.

When you connect Greaseweazle it will automatically appear as a /dev/cu.usbmodem device. To run the Greaseweazle program and dump a disk:

python3 Greaseweazle/gw.py read mydisk.scp

Linux

The Greaseweazle control program requires Python v3 to be installed on your host PC. These instructions apply to Ubuntu:

sudo apt install gcc python3
python3 -m pip install --user crcmod pyserial bitarray

Ubuntu runs a daemon called ModemManager which will attempt to connect to Greaseweazle and probe it with modem commands. To avoid this, and to make the Greaseweazle device accessible as a normal user, you need to add some udev rules:

sudo cp Greaseweazle/scripts/49-greaseweazle.rules /etc/udev/rules.d/.
sudo udevadm control --reload-rules && udevadm trigger

When you connect Greaseweazle it will automatically appear as a /dev/ttyACM device (typically /dev/ttyACM0). To run the Greaseweazle program and dump a disk:

python3 Greaseweazle/gw.py read mydisk.scp

If you install the Ubuntu udev rules, Greaseweazle should also appear as /dev/greaseweazle (this is a symlink to the correct ttyACM device).