-
Notifications
You must be signed in to change notification settings - Fork 102
Software Installation
First download Greaseweazle. These instructions assume the download has been unzipped to the Greaseweazle folder.
Further steps depend on your host OS:
Greaseweazle is packaged as a Windows executable, hence there are no extra application components to download or install.
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:
- Download and install Zadig
- Connect Greaseweazle via USB
- Start Zadig
- Select "List all devices" from the Options pull-down menu
- Select "Greaseweazle" in the dropdown list
- Select "USB Serial (CDC)" as the driver
- 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
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.
Big Sur (macOS v11.0): The latest macOS release breaks pyserial.
This has been fixed in the pre-release package, which can be installed
as follows: python3 -m pip install --user --force pyserial --pre
When you connect Greaseweazle it will automatically appear as a /dev/cu.usbmodem device. To run the Greaseweazle program and dump a disk:
Greaseweazle/gw read mydisk.scp
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:
Greaseweazle/gw 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).