Hermes – Floppy Disk Device

Skip to main content

Intro

Hermes, the messenger of the gods, is able to move quickly and freely between the worlds of the mortal and the divine.

This is a computer museum peripheral that serves the ability to read and write complete floppy disk images for all varieties of vintage computer systems.

Hermes floppy device
Hermes Floppy Device

#project-computer-museum and #help-vintage-pc are the Slack channels for this tool.

Install

You need a USB-C host computer (a laptop) and to install Python and Java software. The USB C port is in the back of the unit and powers a USB serial device. The power button for the disk drives is a beige oval in front on the bottom right and latches in. The lens across the bottom of the case lights up amber once the power is on. Your USB host powers the actual microcontroller board connected inside to the three floppy disk drives. It is USB 2.0 class, so USB C to A and other adapters will work fine. Sampling magnetic flux from the contents of a floppy disk is at most 80 MB of data capture depending on format.

  • Greaseweazle
    • pip install git+https://github.com/keirf/greaseweazle@latest
  • Fluxengine
    • (See the site, it's now a java app)

About the Hardware

Greaseweazle is a hardware project and has an accompanying software program “gw” on the command line. This system accesses floppy disk media at the magnetic flux level. It is a serial device that can capture or record complete container images of a variety of floppy disk media. It is a misnomer to simply think of it as a “USB floppy drive.” This peripheral only serves complete disk containers–not filesystems, individual files, blocks, or bytes. It’s all or nothing. Fluxengine is another software suite that can control the Greaseweazle hardware.

This peripheral is a Greaseweazle v4.1 board (USB C) connected with a 3-disk Shugart floppy cable (34-pin IDC) to three different kinds of IBM-specification floppy drives.

Disk Drives Installed

  • Top drive: 48 TPI 5.25″ IBM DSDD Floppy (2)
  • Center drive: 3.5″ IBM DSHD Floppy (1)
  • Bottom drive: 96 TPI 5.25″ IBM DSHD Floppy (0)

The 48 TPI drive on top is an older standard that writes physically wider magnetic tracks on the disk. Disks it creates will be more compatible and easier to read in older systems that do not support QD (quad ~720k) or HD (high ~1.2M) storage densities. This will be the preferred drive for most computers made before 1987.

Disk sizes such as 360kB, 720kB, 1.44MB don’t apply as cleanly here. We’re used to IBM’s 720 and 1.44 numbers, but other microcomputers used different schemes and thus had different capacities. That’s why they’re not cross-compatible with each other. That’s why we have Hermes!

Disk Types

The initialisms on the disk media themselves indicate its format. Here’s what those letters indicate:

  • SS = Single-Sided
  • DS = Double-Sided
  • SD = Single-Density (This is from the 8″ floppy disk era)
  • DD = Double-Density
  • QD = Quad-Density (colloquially, uncommon)
  • HD = High-Density
  • ED = Extended-Density (Very rare; only IBM & NeXT officially used)
  • FD = Floppy Disk 8″ form factor (We don’t have functionality for this at denhac)
  • MD = Mini Floppy Disk 5.25″ form factor
  • MF/MFD = Micro Floppy (Disk) 3.5″ form factor

 

  • Full Initialism Examples:
    • MF2DD = micro floppy (3.5″) two-sided, double-density (~720 – 880kB)
    • 3.5 DSHD = micro floppy (3.5″) two-sided, high-density (~1.44MB – 1.76MB)
    • MD2HD = mini floppy (5.25″) two-sided, high-density (~1.2MB)

Most Common Disk Types

  • 3.5″ DSHD (1.44MB IBM, 1.44MB Apple Mac, 1.76MB Amiga)
  • 3.5″ DSDD (720kB IBM, 800kB Apple Mac, 880kB Amiga)
  • 5.25″ DSHD (1.2MB IBM) common, but that system probably supports a 3.5″ drive upgrade
  • 5.25″ DSDD (360kB IBM)
  • 5.25″ Flippy (A SSDD with a second notch cut that gets physically flipped over by the user)
    • Use a DSDD in drive 2
  • 5.25″ SSDD (180kB IBM, 140kB Apple ProDOS 3.3, 191kB KayproII/CPM)
    • Use a DSDD in drive 2
  • Commodore 64? We don’t have a C64 floppy drive, so the Pi1541 is used in place.
  • There’s many other formats and capacities not listed. fluxengine and gw will indicate if they support them.
  • 3.5″ Microsoft DMF (DSHD with 1680kB for IBM) used by later software releases
    • Use a Windows 9x machine, like the Dell T500, for file system access.

Examples

Apple II+

Usually the top “drive 2″ would be used, for 48 TPI 5.25” disks.

Reading an Apple II Floppy Disk to A Modern Host Computer

Read & Save A Disk Image File

fluxengine read -c apple2 --140 -s drive:2 -o disk-image-name.dsk
Most of the disks will be SSSD (single-sided, single density) 140kB. The Apple II plus systems we have are from 1983, which is 6&2 GCR. Flippy Disks would be convention/preference. The lab bench drives are double-sided, so reading flippies as one DS-image or two SS-images would work.

Writing an Apple II Disk

Confirmed working from an internet disk image with the newer java-based fluxengine!

fluxengine write -c apple2 --appledos -i "oregontrail.dsk" -d drive:2 --bus=shugart --drivetype=40

Amiga 1000

Use the gw software. Make sure the write protect switch on the floppy disk is not enabled. It is fine to use either DD or HD disks in this drive. The Amiga 1000 itself is a DD drive, so only 880kB images will work on the actual computer. Tape can be placed over the hole of HD disks to trick an HD drive into think it’s DD.

gw write --drive 1 my_disk_image.adf

gw read --drive 1 my_disk_save.adf

Macintosh SE, SE/30, Classic, Classic II

gw cannot handle this 3.5″ format yet. Maybe fluxengine does better? AppleSauces are expensive and constantly sold out. We have various ways of networking the museum Macs to write out any arbitrary floppy disks if necessary. Usually we’re dumping stuff on with BlueSCSI.

Questions and Thoughts

Aren’t there way more drives you’re missing? Not really. You might be thinking of stuff like: Zip100, Zip250, Zip750, 3.5″ DSED, LS120, LS240, FD32, and DMF. Right?! And the 3-mode Japan used on their 360rpm 3.5″ disks? These technologies actually did not have multiple track layouts on themselves. Zip disk was proprietary, so there only ever was one format other than the larger sizes that came out. LS 120 and 240 go on the IDE or SCSI bus, so they’re always going to be a block device, no exotic formats. FD32 is a specialty of LS240 devices. DMF can be read in a standard IBM disk drive through Windows (but not by a USB floppy drive you can buy today). As far as I know, the IBMs and NeXTs both used the same 2.88MB format. Most of these also did not have retail releases of software, but would just be user files. USB floppy disk drives will not do DSDD or DMF, they only do IBM 1.44MB. There were more formats than this, but those only exist in magazines and perhaps some retired engineer’s basement storage. I have seen ~3.5 MB 5.25″ disk drives show up on eBay for who knows what CNC or train or airline thing? If you can find this stuff, we can make it a project to try and use it!

Future

Something more automated to select images or dump a disk. Getting it this far is already a big lift as far as getting media and software running on old machines.

Ancient Wisdom

EXEs that want to write their own floppy disk media

Back in the 1980’s, this type of routine was probably like changing a flat tire. Computer users were comfortable with it and it was not esoteric or confusing. But because technology has changed so much, there’s a lot of missing tools and knowledge gaps.

Context: What are these?

Software was often distributed as an executable that would run a self-extracting routine. This kind of software is a file which runs a compiled program using a decompression algorithm for expanding data that is stored within itself. For the sake of explaining further, we will assume we’re talking about the MS-DOS operating system on an x86 IBM-compatible (the dominant microcomputer platform by the late-1980’s). A software program file (such as an .EXE or .COM) runs in DOS (Disk Operating System) to copy files somewhere else. That somewhere else was usually the computer’s second floppy drive or into RAM, and then back out into the floppy drive on another disk.

Why? Computers were barebones and expensive

Today we benefit from tar, gzip, zip, and other programs being already present from a stock install of MacOS, Windows, and Linux. Or we simply grab from an internet-backed repository the kind of tool we need. But in the 80’s and 90’s, this was not the case. It wasn’t until the early 2000’s that Windows XP (2001) and Mac OS X 10.3 (2003) would have baked-in zip support. It would have been careless to assume in, say 1989, that the end-user would have Pkzip or tar already on their DOS computer. Nobody really had “internet” to “just grab the requisite program really quick” either. Every dependency had to come along with the software. It was standard practice for the software provider to include tooling for decompressing and copying files–that’s what an “install” was.

Why is the install forced to the floppy disk?

The first microcomputers did not have hard drives. Everything was done mostly from floppy disks and tapes. This is why the older systems had two floppy drives. That was less expensive than having a hard drive. Also many systems did not have an expansion capability for adding a hard drive. Part of what made the IBM PC and AT and XT systems special, were their open and generic expansion capabilities. That is also why the Apple II platform endured for so long. But it wasn’t until the late 1980’s that hard drives started becoming standard equipment or expected future upgrades. And because it was expected that a computer did NOT have a hard drive, software installers would commonly have it hard-coded to write out to a floppy disk drive. On any IBM clone or IBM compatible running MS-DOS, that usually selected the A: drive.

Why do we care today about these programs writing to a floppy disk?

Depending the application, sometimes these “write to floppy” tools address the disk MEDIA at a lower level than the MS-DOS or Windows 3.x & 9x file API would do. That means even if you binwalk the installer and decompress the files yourself, simply copying them over at the file system-level would not create the “correct” type of floppy disk media. The software is designed to do lower level writes to the floppy I/O controller to do special techniques on the disk outside of the FAT12 file system. It’s writing special sectors for some reason. Microsoft’s DMF format is an example of deviating from the 1.44 MB IBM format. That makes a requirement to have a compatible platform that can run these programs and output to its expected destination disk drive. In say, 1987, this made sense. Today? It creates a lot of confusion and wrong information found out there in discussion forums. This might be a program that creates a CMOS flasher, or a MIDI Piano system disk, or CNC control software. They don’t necessarily use a standard (because maybe that standard didn’t exist yet).

Where is Hermes positioned in this?

It’s not. It cannot be used for this. The software-hardware environment has to be recreated to run the program and get the resulting disk. But then Hermes can make dumps of that resulting disk!

  • Level 1: At denhac’s museum, we have the option to brute force these by gathering up the required hardware. It’s possible here in Denver, but not reproducible until physical actions take place. The resulting disks may then be binary dumped by Hermes.
  • Level 2: Standing up a virtual machine environment that can run the program and produce a binary blob that’s a compatible Gotek image. Documenting this workflow.
  • Level 3: Completely reverse engineering the binary to churn out a compatible Gotek image or something that Greaseweazel or Fluxengine may ingest to output a physical disk. This would make a good computer science student semester project.

Why is this talked about here?

It’s on this article page because it’s a related problem to encounter with vintage computers and floppy disks. Hermes can at least dump the results as a disk image and that could be shared online. Most people would be willing to buy a Gotek or Greaseweazel, but not a shelving unit full of computers.

This section came to be written from the process of getting a CMOS disk created for a Compaq Portable III that has only an upgraded 3.5″ floppy drive. Once its CMOS battery dies, it cannot boot from its own hard drive or a 3.5″ drive. The hard-coded default it falls back to is a 360K DSDD 5.25″. And Compaq’s specific program to create these setup disks also detects 96TPI drives and tells you not to use it. So then you need a DOS machine with a 48TPI drive to properly do this. The CMOS setup program was not built into ROM on those systems like we’re used to (the “press del” to enter the setup BIOS thing). It turns out many other computers did this.

Other Resources

AppleSauce Wiki

Wikipedia on Floppy Disks

A Related Bukowski Poem

16-bit Intel 8088 chip

with an Apple Macintosh
you can’t run Radio Shack programs
in its disc drive.
nor can a Commodore 64
drive read a file
you have created on an
IBM Personal Computer.
both Kaypro and Osborne computers use
the CP/M operating system
but can’t read each other’s
handwriting
for they format (write
on) discs in different
ways.
the Tandy 2000 runs MS-DOS but
can’t use most programs produced for
the IBM Personal Computer
unless certain
bits and bytes are
altered
but the wind still blows over
Savannah
and in the Spring
the turkey buzzard struts and
flounces before his
hens.

— Charles Bukowski

Installing fluxengine on Arch Linux

Sept 2026 the project converted to Java. This software will allow Hermes to write Apple II format floppies to 5.25″ DSDD.

https://github.com/davidgiven/fluxengine/blob/master/doc/building-client.md

sudo pacman -S git jdk-openjdk bazelisk
git clone https://github.com/davidgiven/fluxengine.git && cd fluxengine
bazelisk build //:fluxengine_app_image

> Target //java/com/cowlark/fluxengine:fluxengine_app_image up-to-date:
> bazel-bin/java/com/cowlark/fluxengine/fluxengine.tar.xz
> INFO: Elapsed time: 624.523s, Critical Path: 144.92s
> INFO: 1088 processes: 355 internal, 673 linux-sandbox, 62 worker.
> INFO: Build completed successfully, 1088 total actions

mkdir ~/bin && cp ./bazel-out/k8-fastbuild/bin/java/com/cowlark/fluxengine/fluxengine.tar.xz ~/bin/
cd ~/bin/ && tar -xf fluxengine.tar.xz
cd fluxengine/bin && ./fluxengine # or ./fluxengine-gui

Move the binaries where ever you'd like, as they're currently in ~/bin/fluxengine/bin/ from this guide



Table of Contents