Repository navigation
ffemu v1.3
Introducing ffemu, a build of FlashFloppy's user interface for a PC
The Gotek firmware inside this release is the stock FlashFloppy, upstream master as of 2026-10-07, commit 822b6e3. Every firmware image built from this release is byte-identical to the upstream's.
ffemu runs the FlashFloppy user interface in a terminal, with no Gotek hardware. The firmware's own code is compiled natively: it draws on an emulated display, reads an emulated USB drive, and takes the keyboard for its buttons, its rotary encoder and the host computer's signals on the floppy interface.
What's new since 1.2
At a glance: version 1.3 emulates the character LCD and the 7-segment LED displays, writes FF.CFG from the configuration dialog, and explains every option there.
- Character LCD displays of 16x2, 20x2, 20x4 and 40x2 characters, chosen in the Display dialog (key 0): an HD44780 on a PCF8574 I2C backpack, drawn dark on its lit panel, with two character ROMs to choose from: CYR, Latin and Cyrillic, the default, from MELT's modules, whose codes the other Cyrillic modules share, and A00, Latin and Japanese, the ROM of most other modules.
- 7-segment LED displays, 3 digits on a TM1651 or 2 digits on 74HC164 shift registers, also in the Display dialog; the unlit segments are faint, as on the real thing.
- The Flash mem dialog (key 9) writes FF.CFG on the USB drive: Save all writes every option, Save diff-from-flash only the options whose value differs from flash, which is all the firmware needs. The file is made from the firmware's own example FF.CFG, each option below the comments that explain it; the old file is kept as
FF.CFG.BAK. This works on a USB drive made from a directory or a mounted physical one; an image file is not written. - Help in the Flash mem dialog: its last row explains the option or the value under the cursor.
- FF.CFG no longer undoes changes: the firmware applies FF.CFG over flash on every boot, so a change made in the Flash mem dialog, or the
display-typethat fitting another display offers, used to last one boot when the file set the option too. Now ffemu says so, and offers to change the file as well. - IMAGE_A.CFG in the Status window, as the firmware wrote it.
- Ctrl+Home resets ffemu and the device together, as starting ffemu again would: the host computer's signals back at their defaults, latching off, the firmware's writes to the USB drive dropped. Home still power-cycles the device alone, and now keeps the latched buttons down too, so that a function the firmware checks at power-on can be reached.
- Fixed minor issues:
- Esc acts after 25 ms instead of 200 ms, which stays over ssh.
- Errors are shown in bright magenta, and the display's frame widens to fit its title.
- The display-type suffix boxes (
rotate,hflipand the rest) are disabled, empty and gray while the display type is not an OLED, since FF.CFG cannot hold them then; until now a ticked one was dropped silently. - The Display dialog's radio buttons look as the Flash mem dialog's do.
Commits since 1.2
- ffemu: Draw Display type dialog's radio buttons as Flash mem dialog does
- ffemu: Disable display-type suffix boxes while display type is not OLED
- ffemu: Bump version to 1.2+
- ffemu: Add Save all and Save diff-from-flash to FF.CFG buttons to Flash mem dialog
- ffemu: Show IMAGE_A.CFG in Status
- ffemu: Shorten Esc delay to 25 ms, keeping 200 ms over ssh
- ffemu: Emulate 7-segment LED display, 3 digits on TM1651 or 2 on 74HC164
- ffemu: Show errors in bright magenta, fit display frame to its title
- ffemu: Change display-type in FF.CFG too when display change needs it
- ffemu: Check FF.CFG on OK of Flash mem dialog for options it would undo
- ffemu: Show help inside Flash mem dialog, explaining item under cursor
- ffemu: Say in Flash mem dialog that only options ffemu supports are offered
- ffemu: Emulate HD44780 character LCD on I2C backpack, CYR and A00 ROMs
- ffemu: Draw disabled check boxes empty, light gray on dark gray
- ffemu: Bump version to 1.3
- ffemu: Keep LCD character ROM choice enabled whatever display is chosen
- ffemu: Keep latched buttons through power cycle, reset all with Ctrl+Home
Downloads
- Linux (x86-64, Ubuntu 22.04+):
ffemu-1.3-linux-x86_64.tar.gz,ffemu-apple2-1.3-linux-x86_64.tar.gz - Windows (Git Bash, MSYS2 or Cygwin):
ffemu-1.3-windows.exe,ffemu-apple2-1.3-windows.exe
Running
ffemu [ <directory> | <usb-drive-image> | /dev/sd<usb-drive-dev>1 ]
ffemu-apple2 [ <directory> | <usb-drive-image> | /dev/sd<usb-drive-dev>1 ]
Without an argument, the physical USB drive attached is taken. See ffemu/README.md for the details.
