Awesome

g64drive - a Windows/Linux/Mac tool for operating 64drive by Retroactive

Installation (binary)

Single-file executable download:

Through package managers:

Mac (x86/M1): brew install rasky/tap/g64drive
Arch Linux: install g64drive from AUR

No driver installation or udev configuration is required. On Linux/Mac, the binary works without sudo, thanks to libusb.

Installation (source)

Make sure you have:

Go 1.16 or newer
libftdi1-dev

installed on your system. Then, to download and build g64drive from source code, simply run:

    $ go install github.com/rasky/g64drive@latest

Usage quicksheet

Make sure you can reach your 64drive:

    $ g64drive list -v
    Found 1 64drive device(s):
    * 0: Retroactive 64drive USB device (serial: RA3B53SW)
      -> Hardware: HW2 (Rev B), Firmware: 2.05

Upload a ROM to the CARTROM bank (with byteswap and CIC type autodetection):

    $ g64drive upload myrom.v64 -v
    64drive serial: RA3B53SW
    upload bank: BankCARTROM
    byteswap: 2
    size: 33554432
    offset: 0
    myrom.z64 100% |████████████████████████████████████████|  [1s:0s]
    Autoset CIC type: CIC6102

Download data from the CARTROM bank:

    $ g64drive download myrom.v64 -v --size 32M
    64drive serial: RA3B53SW
    download bank: BankCARTROM
    byteswap: 0
    size: 33554432
    offset: 0
    myrom.z64 100% |████████████████████████████████████████|  [1s:0s]

See firmware pack information:

    $ g64drive firmware info 64drive_firm_hw2_205.rpk
    Key                | Value
    ---------------------------------------------------------------------------------
    Copyright          | (c) 2018 Retroactive LLC
    Date               | 2018-01-04
    File               | firmware.bin
    Type               | Firmware
    Product            | 64drive
    Device             | EP4CE10F17
    Device Magic       | UDEV
    Device Variant     | B
    Content Version    | 2.05
    Prerequisites      |
    Content Note       | Adds support for USB communication from N64, rewritable UFLC
                       | boards.
    Content Changes    | 1. Block-based USB communication pipe is now implemented,
                       | see Hardware Spec
                       | 2. Added standalone commands to allow read/write of UFLC
                       | boards intended for UltraHDMI upgrade distribution
    Content Errata     |
    Content Extra      |

Upgrade firmware:

    $ g64drive firmware upgrade 64drive_firm_hw2_205.rpk
    Ready to upgrade 64drive (serial RA3B53SW)
    Current firmware: 2.04
    New firmware 2.05 (2018-01-04) - Adds support for USB communication from N64, rewritable UFLC boards.
    Do you want to proceed (Y/N):y
    Finished 100% |████████████████████████████████████████|  [23s:0s]
    Firmware upgraded correctly -- power-cycle your 64drive unit

Features

Support 64drive HW1 and HW2
No "sudo" required
Upload and download data from any available bank
Transparent byteswapping (with autodetection from ROM header)
Transparent CIC detection when uploading a ROM, or later at any time
Transparent Save Type detection using mupen64 ROM database and the special ED64 ROM header for homebrew
Can specify sizes and offsets in decimal, hex, or even kilobytes/megabytes
Firmware upgrades (flashing .rpk file as distributed by Retroactive)
Debugging protocol compatible with libdragon and UNFLoader
CTRL+C clean shutdown during upload/download -- don't need to power-cycle 64drive after it
Shipped as static binary, very easy to install on any Linux and macOS system

What's missing:

Standalone mode

Bugs?

Please file an issue on GitHub.