Skip to content

Firmware Programming

Keir Fraser edited this page May 8, 2018 · 34 revisions

The first installation of this firmware onto Gotek can be done either by serial or USB link to a host PC.

Method 1: Serial Programming

A nice video summary of this method using programming software on Windows is available on Youtube courtesy of Kris Cochrane. It also includes the OLED Display and Piezo Sounder mods:

FlashFloppy custom firmware install

Serial programming requires a USB-TTL adapter, readily available on Ebay or from project webstores:

USB-TTL Adapter

The Gotek is then jumpered in system-bootloader mode and programmed from the host PC. See the below picture for wiring and jumper selection. This Gotek has had pins soldered to the programming header. It is possible to make the required connections with no soldering, but be careful that all wires are sufficiently well connected. Also note that the ordering of the connections (5V,GND,TX,RX) can vary across adapters, so be careful to note the ordering on your own.

Programming header

The programming process is described, along with suitable Windows software, on the Cortex firmware webpage. Of course, rather than using the Cortex HEX file, use the *.hex file contained in the FlashFloppy distribution.

If programming on Linux, you can follow the Cortex instructions to physically set up your serial connection and bootstrap the Gotek, and then use stm32flash to do the programming:

 # sudo stm32flash -k /dev/ttyUSB0
 # sudo stm32flash -vw flashfloppy_fw/FF_Gotek*.hex /dev/ttyUSB0

Troubleshooting

  • On Windows, ensure the driver has correctly detected the USB-TTL adapter. In particular, PL2303 clones have trouble with the official Prolific driver.
  • Ensure you have TX and RX wires the correct way round.
  • Sometimes the STM32 bootloader gets confused or negotiates the wrong baud rate. Try resetting the Gotek by touching NRST to GND, or by removing and reapplying power.
  • Some serial adapters require pull-up resistors on the TX and RX wires. See AN2606 ("STM32 microcontroller system memory boot mode"), Section 3.3, Figure 1. A suitable resistor value (R) is 10K; these can safely be connected to VCC/+V of 3.3V or 5V.

Method 2: USB Programming

This method requires a USB-A to USB-A cable, and you should program the *.dfu file contained in the FlashFloppy distribution.

Windows

For more details read Nick Lines' how-to guide, or watch the following Youtube video. Note: The *.dfu file is now included in the FlashFloppy distribution; there is no need to create it from the *.hex file and those steps can be skipped.

Flash Gotek without Serial Adapter

Linux / Mac

Requires the dfu-util command-line tool which can be downloaded via your package manager (Linux), or Homebrew (on MacOS). Programming is then as simple as (for v0.9.19a in this example):

sudo dfu-util -a 0 -D flashfloppy_v0.9.19a/FF_Gotek-v0.9.19a.dfu