RELEASE_NOTES

************************************
** FlashFloppy Release Notes
** Keir Fraser <keir.xen@gmail.com>
************************************

** v1.0 - 4 February 2019
 - Game/demo AutoSwap-disks feature
   - No manual disk swapping, at all!
   - Requires patching of host software titles
   - Amiga titles so far (github:keirf/FF_AutoSwap):
     - Beneath a Steel Sky
     - Indiana Jones and the Fate of Atlantis
     - The Secret of Monkey Island
     - Monkey Island 2: LeChuck's Revenge
 - FF.CFG: New OLED display-type sib-option "-narrower"
   - 16-character-wide display (c.w. "-narrow" 18-char-wide)
 - PC98: Direct support for HDM image files
 - HxC Compat: Small fixes to Amiga file selector

** v0.15 - 8 January 2019
 - Support Enhanced Gotek with SD card connector
   - Board requirements are in the wiki (Hardware Mods)
   - USB drive, if inserted, takes priority over SD card
   - SD card is not supported for firmware update

** v0.14 - 7 December 2018
 - Direct Access: Fix broken sector writes (USB corruption)
   - Primarily affected the CPC/ST file selectors (not Amiga)
   - Broken since v0.12

** v0.13 - 2 December 2018
 - IMG: Support Casio FZ-1 (host=casio)
 - IMG: Support SC Prophet 3000 (host=akai)
 - Display D-A/DA/"Host Direct Access" in host file selector

** v0.12 - 27 November 2018
 - IMG: Support Nascom 1 & 2 (host=nascom)
 - Direct Access: Support FM/SD access on cylinder 254
 - Direct Access: Support CMD_SELECT_IMAGE (cmd #4)
 - HxC Compat: Fix occasional "LBA Change Test Failed" error
 - Improvements to ribbon-upside-down checks

** v0.11 - 1 November 2018
 - Detect and report upside-down data ribbon cable
 - FF.CFG: Configurable OLED brightness/contrast (oled-contrast=)
 - FF.CFG: Configurable head settle time (head-settle-ms=)
 - FF.CFG: Fix comma-separated-list parsing (eg. rotary=)

** v0.10 - 30 October 2018
 - FF.CFG: Allow up/down inputs to be reversed
   - Reverse original two buttons (twobutton-action=reverse)
   - Reverse rotary encoder direction (rotary=reverse)
 - Modified version numbering scheme and remove alpha status

** v0.9.31a - 28 October 2018
 - HFE: Sanity-check critical header fields
 - FF.CFG: Better docs on pin02/pin34 options
 - HxC Compat: File selector updates

** v0.9.30a - 9 October 2018
 - TI99: Fix V9T9/DSK double-sided images
 - HxC Compat: Enter slot-based mode even with no AUTOBOOT.HFE
 - HFE: Support HFEv2 images

** v0.9.29a - 17 September 2018
 - New and improved image handlers:
   - ST: Fix 80-cyl single-sided images
   - IMG: Kaypro (host=kaypro)
   - IMG: MSX fix 40-cyl/5.25" formats (host=msx)
   - IMG: PC-DOS fix missing IAM (host=pc-dos)
   - IMG: All: Support long sectors (>1024k)
 - Indexed mode: Don't require DSKA0000 image

** v0.9.28a - 26 August 2018
 - New image types supported:
   - IMG: Fluke 9100 (host=fluke)
   - MBD: Spectrum MB02
 - LCD/OLED: Display folder names in brackets

** v0.9.27a - 27 July 2018
 - Direct Navigation: Fix hidden-file and dot-file filtering
 - Direct Navigation: Filter __MACOSX/ resource-fork folders

** v0.9.26a - 24 July 2018
 - DSK (CPC): More fixes for copy-protected tracks
 - New image types supported:
   - JVC, DSK: Tandy Coco (host=tandy-coco)
   - VDK: Dragon

** v0.9.25a - 18 July 2018
 - DSK (Spectrum, CPC, Sam Coupe): Fix tracks with little or no data in them
 - FF.CFG: New options pin02= and pin34= allow precise interface configuration

** v0.9.24a - 9 July 2018
 - DSK (Spectrum, CPC, Sam Coupe): Bug fixes. Please upgrade!

** v0.9.23a - 6 July 2018
 - DSK (Spectrum, CPC): Support weak-data copy protection
   - Used on most of the top commercial titles
 - OLED: Utilise all rows on 128x64 displays
 - LCD: Support up to 40x2 displays
 - SSD, DSD (BBC): Add correct sector skew across tracks
 - IMG: 1680kB DMF has 2:1 sector interleave

** v0.9.22a - 20 June 2018
 - OLED: Support SH1106 controller (1.3-inch displays)
   - FF.CFG: display-type = oled-128x64-sh1106
 - Support a wider range of rotary encoders
   - FF.CFG: rotary = quarter | half | full
 - New image types supported:
   - D81: Commodore 64 1581
   - IMG: DEC RX33, RX50 (host=dec)

** v0.9.21a - 11 June 2018
 - New default 6x13 font (Codec, by Chris Cannam)
 - IMG: Support MSX (host=msx)
 - Accelerate the stock Gotek buttons when using a rotary encoder
   - FF.CFG: "twobutton-action = rotary-fast"
 - HxC-Compat File Selectors:
   - New font on Amiga and Atari ST
   - Faster folder navigation on Amiga

** v0.9.20a - 6 June 2018
 - New image types supported:
   - IMG: UKNC/DVK (Soviet PDP-11 clones) (host=uknc)
   - IMG/FDI: NEC PC-98 (host=pc98)
   - IMG: Common retro IBM/PC formats work out of the box
   - IMG: Detect disk layout from PC DOS BPB (host=pc-dos)
 - Auto-extend truncated images (SSD, DSD, TRD images only)
   - "extend-image=no" disables this feature

** v0.9.19a - 1 May 2018
 - Amiga: Support high-density disk images
   - ADF: 1760kB images
   - Generate HD-ID pattern on pin 34 (interface=amiga)
 - DSK: Fixes for Sam Coupe, and others with long tracks

** v0.9.18a - 19 April 2018
 - Fix HxC compatibility mode ("LBA change test failed")
 - SDU: Improve geometry detection
 - More bug fixes to read-data ring-buffer handling
 - LED 888 Display: Show firmware version when right/up button pressed
 - LCD/OLED: When browsing through images, reset scroll to start of each file

** v0.9.17a - 17 April 2018
 - New image types supported:
   - Acorn DFS SSD/DSD
   - Acorn ADFS 'S' (160kB)
   - Akai 800kB (host=akai)
   - Memotech IMG (host=memotech)
   - SAB Diskette Utility (SDU)
   - TI-99/4A DSK/V9T9 (host=ti99)
 - New interface types supported:
   - Akai S950 (interface=akai-s950)
 - Bug fixes to read-data ring-buffer handling
 - HFE: Improve write performance (batch reads/writes up to 8 blocks)
 - OLED: Increase default initialisation probe to 3s
 - USB: Respect volume write-protect status

** v0.9.16a - 16 March 2018
 - Support ADFS D/E/F images (suffix *.ADF, FF.CFG: host=acorn)
 - Direct Access: Fix sector data CRCs
 - Reliability improvements for Acorn systems (index-suppression=no)
 - Rearrange floppy read/write buffering to avoid corruptions

** v0.9.15a - 9 March 2018
 - UI: Fix subfolder navigation when returning to parent folder (#66)
 - OLED: Auto-detect OLED displays at I2C address 0x3d
 - ST: Mimic TOS by applying track skew to ST image files (#44)
 - 7-Seg LED: Allow write protection to be toggled as on LCD/OLED
 - Support Ensoniq DD/HD custom IMG formats (host=ensoniq)
 - Support IBM PC interface with density select (interface=ibmpc-hdout)
 - Direct Access: Support track with fewer than 8 data sectors (#62)

** v0.9.14a - 4 March 2018
 - Fix write pipeline: record track number for delayed write processing
 - General Music (GEM): New host option "host=gem" for direct IMG support
 - Direct support for Spectrum Opus Discovery (OPD) image files
 - HFE, ADF: Batch writeback to the USB drive where possible
 - FF.CFG: Replace "index-during-seek" with "index-suppression"
 - Direct Access: Restart read at correct track position after a write

** v0.9.13a - 1 March 2018
 - HFE: Emulate non-standard drive speeds (eg. Sony 600 RPM drive)
 - HFE: Fix single-sector writes (broken since v0.9.8a)
 - Direct Access: Support up to 64-sector track (Atari ST HxC Mount)
 - Direct support for Spectrum TR-DOS (TRD) image files

** v0.9.12a - 27 February 2018
 - LCD/OLED: Long filenames scroll during navigation
 - LCD/OLED: Make filename scrolling more configurable
   - FF.CFG: {nav,display}-scroll-{rate,pause}
 - Direct navigation: ".." returns to subfolder position within parent
 - Fix head-seek settle time emulation
 - ADF: Generate longer tracks, like a real Amiga would

** v0.9.11a - 23 February 2018
 - Fix Direct-Acesss mode (as used by HxC Autoboot, broken in v0.9.10a)

** v0.9.10a - 22 February 2018
 - New default OLED font 6x13 displays more text per line
   - 7x16 font removed
   - 8x16 font MAY be removed, let me know if you use it!!
 - Narrow OLED view (default Gotek display cutout) supported
   - FF.CFG: display-type = oled-128x32-narrow
 - All images can be write-protected by default
   - FF.CFG: write-protect = yes
 - Write-protect switchable by holding eject for 2 seconds

** v0.9.9a - 19 February 2018
 - Fix write problems present in v0.9.8a (issue #53)
 - Support rotary encoders with proper Gray code output
   - FF.CFG: rotary = none | simple | gray

** v0.9.8a - 8 February 2018
 - Pipelined writes
   - New writes are buffered while older ones are written to the USB drive
   - More reliable write/format/disk-copy operation with slower USB drives
 - FF.CFG: Allow OLED display to be rotated 180 degrees (upside down)
   - display-type = oled-128x32-rotate
 - FF.CFG: Support BBC Micro with 8271 controller
   - Index pulses must continue during seek (index-during-seek = yes)
   - Index pulses must not be delayed by seek (track-change = realtime)

** v0.9.7a - 29 January 2018
 - Performance & reliability improvements (eg. Github issues #35, #44):
   - Sync data read after writes, prevents host missing next sector
   - FF.CFG: Sync data read after track change (track-change=instant)
     - Prevents host missing the first sector
     - Old behaviour is configurable (track-change=realtime)
 - FF.CFG: host=akai, support Akai synths with 1.6MB HD IMG files

** v0.9.6a - 17 January 2018
 - USB: Fix power-on initialisation for some USB sticks
 - FAT: Write-protect image files marked with read-only attribute
 - ST: Support 11-sector .ST images

** v0.9.5a - 1 December 2017
 - FF.CFG: New button assignment for rotary-encoder setup
   - twobutton-action = rotary
 - FF.CFG: Allow navigation mode to be specified
   - nav-mode = native | indexed | default

** v0.9.4a - 30 November 2017
 - Automatic support for crippled 'diymore' OLED displays
   - FF.CFG: New option display-probe-ms (replaces startup-delay)
 - FF.CFG: New option twobutton-action allows eject on two-button press

** v0.9.3a - 22 November 2017
 - DSK: Fix disk write handling
 - HFE: Improve read speed for HD images, reduce buffer underruns

** v0.9.2a - 21 November 2017
 - DSK: Improve handling of per-sector status codes
 - Fix bugs in front-end file handling & folder navigation

** v0.9.1a - 16 November 2017
 - Acorn ADFS image support (ADM, ADL) [Daniel Jameson]
 - Better detection of DSK image type (CPC-DSK vs raw sector file)

** v0.9.0a - 15 November 2017
** Amstrad CPC / Spectrum +3 DSK support
 - DSK directly supported for read and write. Please report any issues!
 - Improved error reporting
 - New FF.CFG option "startup-delay = N"

-------------------------------------------------------------------------

** v0.8.8a - 7 November 2017
 - Better error reporting (filesystem, media, power, image handling)
 - Optional feature enhancements for Gotek clones
 - Third button (select) may be used instead of prev/next for firmware
   update and factory reset

** v0.8.7a - 17 October 2017
 - Start in ejected state if button pressed or image previously
   ejected (when "image-on-startup = last")
 - Divide the configuration flash page into multiple slots to
   reduce the number of erase cycles when FF.CFG is repeatedly
   modified

** v0.8.6a - 13 October 2017
 - New FF.CFG option image-on-startup
 - Rename LASTDISK.IDX to IMAGE_A.CFG
 - If image-on-startup is a folder, go directly into image selector

** v0.8.5a - 13 October 2017
 - Cache FF.CFG values in Flash memory for next power on, replacing
   'factory defaults'. Restore defaults by pressing both buttons.
 - Glitch filter for SIDE-select signal (Kingstener)
 - Small improvements to FF.CFG option and value naming

** v0.8.4a - 11 October 2017
 - Bootloader OLED Display Fix (display was not enabled in update mode)
 - Integrate 7x16 OLED font into main build, configurable in FF.CFG

** v0.8.3a - 10 October 2017
 - Always search for HXCSDFE.CFG/AUTOBOOT.HFE in root folder, even
   when FF/ subfolder exists

** v0.8.2a - 10 October 2017
 - Parse FF.CFG file (see examples/FF.CFG for options)
 - LCD/OLED: Don't display bogus 'folder depth' in Autoboot mode

** v0.8.1a - 30 September 2017
 - Fix config-less navigation with simple digit displays
 - Respond to USB stick pull when in ejected state
 - LCD/OLED: Increase activity timeout to 60 seconds
 - LCD/OLED: Turn on display on drive activity

** v0.8.0a - 29 September 2017
** Subfolder support
 - Navigate subfolders in config-less mode
 - All config files can now be stored in FF subfolder
 - LASTDISK.IDX file now stores full path to the selected image
 - OLED: Display turns off after timeout (same as LCD backlight)
 - Wrap slot number at 0 and max when navigating
 - Easter egg for Anders Kling. Thanks for your support!

-------------------------------------------------------------------------

** v0.7.4a - 25 September 2017
 - Fix RDATA handling, specifically when drive B on an Amstrad CPC.
   Reported by ikonsgr (EAB / Ebay) -- Thanks!

** v0.7.3a - 24 September 2017
 - HxC: Respect autoboot- and ejected-on-startup flags
 - Support 3rd button for eject and for immediate (re-)insert
 - Do not wrap slot number at 0 and max.

** v0.7.2a - 21 September 2017
 - Fixes to track timing and index position
 - Properly emulate a single-headed drive

** v0.7.1a - 21 September 2017
 - HFE: HFEv3 support
 - HFE: Correctly set bitcell size for writes
 - HFE: Reliability fix, read whole USB-disk sectors
 - ADF: Support a wider range of ADF sizes

** v0.7.0a - 19 September 2017
** IMG/ST image handling. Rotary Encoder support.
 - IMG and ST image files directly supported for read and write.
   Please report any issues!
 - Connect a rotary encoder to use in place of directional
   buttons: Thanks to Fook42 (A1K/EAB). Documentation describes
   how to connect.

-------------------------------------------------------------------------

** v0.6.3a - 18 September 2017
 - Remove Amiga AUTOBOOT.HFE and config files from the distribution.
   The HxC original files work fine, so forking is unnecessary.
 - Resync index pulse after write handling: this dramatically
   speeds up FAT filesystem access in the AUTOBOOT file selectors.
 - Reorganise and update the documentation.

** v0.6.2a - 13 September 2017
 - Prettier 7x16 'narrow' LED font (Kingstener)
 - Remember last-selected slot in no-config mode (LASTDISK.IDX file
   must exist). Thanks to Fook42 (A1K/EAB).
 - Ignore glitches on SIDE-select signal (fix for Eric Gustafson's A3000)
 - Various fixes for file selector on Atari ST and Amstrad CPC
 - Suppress index pulse when writing to USB stick. Makes slow writes
   more reliable (avoids timeouts on the host).
 - Optimised memory copying and clearing

** v0.6.1a - 31 August 2017
 - Support 2-digit LED display
 - Suppress LCD update of side number when another drive is selected

** v0.6.0a - 24 August 2017
** PC Interface Support. OLED Fixes & Narrower Font Support.
 - Allow PC Floppy Interface (DSKCHG on pin 34) to be selected via a
   jumper at position JC. Default interface (no jumper at JC) remains
   Shugart, as compatible with many non-PC systems including Amiga.
 - Kingstener: Support narrower 7x16 OLED font. Allows entire display to be
   visible through the 3-digit cutout in the Gotek case. This is a separate
   firmware build, update file is in distribution subfolder alt/.
 - OLED reliability fixes.

-------------------------------------------------------------------------

** v0.5.0a - 15 August 2017
** Greater stability on A1200 and accelerated Amigas
 - I/O latency reduced on drive select/deselect. Results in more reliable
   drive detection on A1200, with and without accelerator, and on warm
   and cold reboots.

-------------------------------------------------------------------------

** v0.4.4a - 14 August 2017
 - Improvements to power-on initialisation: initialise the floppy
   interface earlier, start on cylinder 0, and don't trigger a spurious
   step command

** v0.4.3a - 13 August 2017
 - Fix DSKCHG handling. Should make disk insertion more reliable,
   especially on Amiga with noclick patch.

** v0.4.2a - 11 August 2017
 - More efficient I2C handling for OLED and fix synch during flash
   update process.

** v0.4.1a - 11 August 2017
 - Improve I2C robustness

** v0.4.0a - 10 August 2017
** 128x32 I2C OLED Display support
 - Support for 0.91" I2C OLED (128x32, SSD1306 controller).
 - Various optimisations and bug fixes.

-------------------------------------------------------------------------

** v0.3.2a - 7 August 2017
 - Fix buffer overrun in HFE image handler when cannot read data from
   USB stick fast enough.
 - Update the Amiga AUTOBOOT.HFE with latest changes from upstream,
   and bump version number.

** v0.3.1a - 7 August 2017
 - Fix buffer overflow when copying long filenames in no-config mode.

** v0.3.0a - 6 August 2017
** Config-less & indexed operation
 - Operate with no AUTOBOOT.HFE (requires HXCSDFE.CFG in 'indexed
   mode'): files must be called DSKA0000.HFE, DSKA0001.HFE, and so
   on. ADF images are also supported.
 - Operate with no HXCSDFE.CFG! Buttons will cycle through all valid
   images in the USB root folder.
 - Step-pulse speaker is supported on output JB. Recommend buffering
   through an NPN transistor unless using a piezo speaker (high
   resistance).
 - Long filenames scroll on the 1602 LCD
 - LCD backlight timer, scroll speed, and step speaker volume all
   configured via HXCSDFE.CFG (when available)
 - Hack workaround for X-Copy problems. Verified writes/copies are now
   reliable!

-------------------------------------------------------------------------

** v0.2.1a - 26 July 2017
** Fixes for LCD handling
 - More reliable startup
 - Fix crashes and deadlocks in operation
 - More efficient command transmission (one I2C transaction for
   successive commands)
 - Support 0x38-0x3F I2C addresses

** v0.2.a - 25 July 2017
** 1602 LCD + Drive Logic Fixes
 - 1602 LCD handling: Will recognise a 1602 LCD with "I2C backpack" as
   used (and connected) for the usual "HxC LCD mod". Does not yet
   scroll long filenames, this will be added shortly.
 - Drive Logic: Will now play nicely in multi-drive systems and make
   AmigaDOS much less confused (no more DF1-3:BAD type messages!)
 - The bootloader is also modified to talk to the 1602 LCD: if you
   want this feature then you must also update the bootloader by doing
   a full serial or USB/DFU flash of the main HEX file.

-------------------------------------------------------------------------

** v0.1a - 21 July 2017
** Initial release
 - Works only as sole drive in a host system (eg disconnect external
   drives!)