Hangar.All the Amiga software, ready to install

WBFFcontrol 1.5

Control a FlashFloppy Gotek from AmigaOS

Short:        Control a FlashFloppy Gotek from AmigaOS
Author:       Alvaro M & Claude (Anthropic)
Uploader:
Type:         disk/misc
Version:      1.5
Requires:     Gotek with FlashFloppy firmware, AmigaOS 2.04+
Architecture: m68k-amigaos >= 2.0.4
Distribution: Aminet
Kurz:         FlashFloppy-Gotek unter AmigaOS steuern

==========================================================================
 WBFFcontrol 1.5 / FFcontrol 1.5
==========================================================================

  ESPAÑOL (English below)

WBFFcontrol (ventana de Workbench) y FFcontrol (orden de Shell) controlan
un Gotek con FlashFloppy desde el propio Amiga, sin tocar sus botones:

  * ver el contenido del pendrive del Gotek, con sus carpetas
  * montar imágenes (modo nativo) o asignarlas a slots (modo HxC),
    una o una lista entera en slots seguidos
  * ver los slots de FlashFloppy, con el montado en negrita
  * copiar archivos del USB al Amiga y del Amiga al USB
  * borrar archivos y carpetas (con todo su contenido) y crear carpetas
  * diagnóstico del Gotek
  * español e inglés (automático según el idioma del sistema)

Las dos versiones hacen lo mismo: comparten todo el código de trabajo.
La guía WBFFcontrol.guide explica el uso con detalle.

¡AVISO! Copiar al USB, borrar y crear carpetas ESCRIBEN en el pendrive.
Son operaciones experimentales: si se interrumpen o algo falla, el pendrive
puede quedar dañado. Haz antes una copia de seguridad del pendrive en un
PC, y antes de que el Amiga escriba en el disco montado en el Gotek,
desconecta y vuelve a conectar su USB.

Requisitos
  * AmigaOS 2.04 o superior, de 68000 a PiStorm/Emu68.
  * ReAction (AmigaOS 3.2, 3.5, 3.9 o ClassAct) para la ventana de dos
    paneles; sin él se usa una ventana GadTools más sencilla.
  * Gotek con FlashFloppy, interfaz Shugart (lo normal en un Amiga), con
    "max-cyl = 255" en FF.CFG (es el valor por defecto).
  * Pendrive FAT12, FAT16 o FAT32 (FlashFloppy no admite exFAT).

Instalación
  Copia el cajón donde quieras. FFcontrol puede ir a C: si quieres
  usarlo desde cualquier sitio. La configuración (unidad e idioma) se
  guarda sola en ENVARC:FFcontrol.prefs; FFcontrol usa la misma unidad
  pero habla en inglés salvo que se le diga LANG=ES.

Tooltypes de WBFFcontrol (también como argumentos desde el Shell)
  DRIVE=DF1:   unidad del Gotek
  LANG=ES      idioma: ES, EN o AUTO
  DEBUG        escribe un registro de todo en RAM:WBFFcontrol.log
               (sin DEBUG no se escribe ningún registro)
  El icono los trae desactivados entre paréntesis como ejemplo.

Hecho por una IA
  Este programa lo ha escrito Claude, una inteligencia artificial de
  Anthropic, mediante "vibe coding": Alvaro M propuso la idea, decidió qué
  debía hacer, lo probó en su Amiga real y describió los fallos; Claude
  escribió todo el código, las pruebas y esta documentación.

  ENGLISH

WBFFcontrol (Workbench window) and FFcontrol (Shell command) control a
FlashFloppy Gotek from the Amiga itself, without touching its buttons:

  * browse the Gotek's USB stick, folders included
  * mount images (native mode) or assign them to slots (HxC mode),
    one or a whole list into consecutive slots
  * see FlashFloppy's slots, the mounted one in bold
  * copy files from USB to the Amiga and from the Amiga to USB
  * delete files and folders (with everything in them), create folders
  * Gotek diagnostics
  * Spanish and English (automatic, from the system language)

Both programs do the same: they share all the working code. The guide
WBFFcontrol.guide explains everything in detail.

WARNING! Copying to USB, deleting and creating folders WRITE to the stick.
They are experimental: if interrupted, or if something fails, the stick
may be damaged. Back it up on a PC first, and before the Amiga writes to
the disk mounted in the Gotek, unplug and re-plug its USB stick.

Requirements
  * AmigaOS 2.04 or later, 68000 up to PiStorm/Emu68.
  * ReAction (AmigaOS 3.2, 3.5, 3.9 or ClassAct) for the two-pane window;
    without it a simpler GadTools window is used.
  * Gotek with FlashFloppy, Shugart interface (the usual on an Amiga),
    "max-cyl = 255" in FF.CFG (the default).
  * FAT12, FAT16 or FAT32 USB stick (FlashFloppy does not support exFAT).

Installation
  Copy the drawer anywhere. FFcontrol may go to C: to use it from
  anywhere. Settings (drive and language) are saved automatically in
  ENVARC:FFcontrol.prefs; FFcontrol uses the same drive but speaks
  English unless told LANG=ES.

WBFFcontrol tooltypes (also as Shell arguments)
  DRIVE=DF1:   the Gotek's drive
  LANG=EN      language: ES, EN or AUTO
  DEBUG        log everything to RAM:WBFFcontrol.log
               (without DEBUG no log is written)
  The icon has them disabled in brackets as examples.

Made by an AI
  This program was written by Claude, an artificial intelligence by
  Anthropic, by "vibe coding": Alvaro M had the idea, decided what it
  should do, tested it on his real Amiga and reported the problems;
  Claude wrote all the code, the tests and this documentation.

==========================================================================
 History / Historia
==========================================================================

1.5 (10.10.2026)
  * Project menu: About, Snapshot window (size and position saved in
    ENVARC:FFcontrol.prefs) and Quit. The version is in the window
    title. / Menú Proyecto: Acerca de, Guardar tamaño y posición de la
    ventana y Salir. La versión aparece en el título.

1.4 (10.10.2026)
  * Empty several selected slots at once; if the mounted one is among
    them it is unmounted (the Gotek goes to slot 0: "(Empty)", or the
    HxC selector if AUTOBOOT.HFE exists), with a clear warning.
    FFcontrol: CLEARSLOT=3,5,8-10. / Vaciar varios slots seleccionados a
    la vez; si incluye el montado, se desmonta (el Gotek pasa al slot 0),
    con un aviso claro.

1.3 (09.10.2026)
  * Delete: the mounted image is asked to the Gotek itself right before
    deleting; neither it nor a folder containing it can be deleted. /
    Borrar: lo montado se pregunta al Gotek en el momento; no se borra la
    imagen montada ni una carpeta que la contenga.
  * HxC: several images selected in the file list are assigned to
    consecutive slots from the active one, with a warning listing the
    slots in use that get replaced (and the mounted one). FFcontrol:
    SLOT=n ASSIGN p1 p2 ... / HxC: varias imágenes seleccionadas se
    asignan a slots seguidos desde el activo, avisando de los slots
    ocupados que se reemplazan (y del montado).

1.2 (09.10.2026)
  * Removed the "Assign to slot >" button: "Mount / Enter" already does
    it. / Quitado el botón "Asignar al slot >": "Montar / Entrar" ya lo
    hace.
  * New DEBUG tooltype/argument: RAM:WBFFcontrol.log is only written with
    it. / Nuevo tooltype DEBUG: el registro solo se escribe con él.
  * FFcontrol speaks English by default (LANG=ES for Spanish). / FFcontrol
    habla en inglés por defecto (LANG=ES para español).

1.1 (09.10.2026)
  * The "Reading the USB stick... KB" counter restarts with every
    operation (it kept growing). / El contador de KB empieza de cero en
    cada operación (antes solo crecía).
  * A harmless "priming" write at the start of every session: on some
    Amigas the first disk write DMA does not start (seen in Alvaro M's
    logs); now that one is a dummy. Shorter waits before a DMA retry. /
    Escritura de cebado inofensiva al empezar cada sesión y esperas más
    cortas antes de reintentar una DMA.
  * Clearer re-plug advice, shown once per session. / Aviso de reconectar
    el USB más preciso, una vez por sesión.

1.0 (09.10.2026)  First release / primera versión.
  * WBFFcontrol: ReAction window with two panes (USB stick / slots), the
    mounted slot in bold; GadTools fallback. Spanish/English.
  * FFcontrol: the same operations from the Shell.
  * New: delete files and folders (recursive), create folders.
  * New: safety checks (never deletes FlashFloppy's own files, the mounted
    image or FlashFloppy's current folder; empties HxC slots that pointed
    to deleted files). FSInfo free count kept exact.
  * Faster USB access: 21-sector (10.5 KB) windows, one track read per
    window, right-sized reads, 1 ms steps, fast software resync.

Development builds before 1.0 (FFSel 1.0-1.8, FFSelect 1.0-1.9), tested
by Alvaro M on real hardware:
  * Direct Access protocol, Shell tool; raw reads with software sync
    (fixed reads on Alvaro M's Amiga); DIAG; detection of "no image
    mounted"; DSKLEN double write separated by a chipset read (fixed
    occasional DMA stalls); HxC slot support (V1/V2); FAT reader and
    writer; copying both ways; ReAction GUI; speed from ~3.5 to ~20 KB/s
    (calculated).

==========================================================================
 Sources and credits / Fuentes y agradecimientos
==========================================================================

  * FlashFloppy by Keir Fraser - https://github.com/keirf/flashfloppy
    (public domain / Unlicense). Everything about talking to the Gotek
    comes from reading its source: the Direct Access protocol
    (src/image/da.c, inc/da.h), the HxC compatibility mode and the
    HXCSDFE.CFG slot format (inc/hxc.h, src/main.c), native navigation
    rules, IMAGE_A.CFG, valid image types, the D-A track layout. The MFM
    and CRC tables in the test simulator (test/ff_tables.h) are copied
    verbatim from src/image/mfm.c and src/crc.c, and the simulator ports
    FlashFloppy's track generation and write parsing.
  * HxC Floppy Emulator by Jean-François Del Nero - https://hxc2001.com
    - creator of the Direct Access idea and the HXCSDFE.CFG format that
    FlashFloppy implements.
  * FatFs by ChaN - http://elm-chan.org/fsw/ff/ - FlashFloppy's file
    system library; its file-name rules (long names in CP437, 8.3 names
    with NT case flags) are reproduced so names match exactly. No FatFs
    code is copied.
  * Microsoft's FAT specification (FAT12/16/32, long names, FSInfo) and
    IBM code page 437, for the FAT reader/writer.
  * Commodore's Amiga Hardware Reference Manual and AmigaOS autodocs
    (Paula disk DMA, CIA drive lines, disk.resource, trackdisk.device,
    GadTools, ReAction classes).
  * Toolchain: m68k-amigaos-gcc by Stefan "Bebbo" Franke, prebuilt by
    AmigaPorts - https://github.com/AmigaPorts/m68k-amigaos-gcc - (GCC
    16.2, libnix, AmigaOS 3.2 NDK headers by Hyperion Entertainment).
  * Testing on Linux: dosfstools (mkfs.vfat, fsck.fat), mtools, and
    amitools/vamos by Christian Vogelgsang -
    https://github.com/cnvogelg/amitools
  * Idea, decisions and real-hardware testing: Alvaro M.
  * Code, tests and documentation: Claude (Anthropic).

Source code is included in src/ (Makefile, sources, test suite).

This is free and unencumbered software released into the public domain
(see the Unlicense, https://unlicense.org). The files copied from
FlashFloppy are public domain too.

Project website ↗

Download 232 KB

From the Amiga: open Hangar and search for WBFFcontrol.

AuthorAlvaro M & Claude (Anthropic)
Categorydisk/misc
Size232 KB
Downloads0 through Hangar
Date2026-11-22
Form68k-amigaos >= 2.0.4
RequiresGotek with FlashFloppy firmware, AmigaOS 2.04+
SourceAminet (not reviewed by us)