====== Firmware upgrading ======

==== Upgrade ====

Upgrading the firmware on the device requires use of the command line interface.


 * To begin, place the new firmware on an SD card or USB drive, and attach them to the device.
 * As per the Command Line instructions, connect to the device, and enter the following command, replacing "filename" with the file you copied onto your Flash drive. Include the name of the device, such as //sd:/firmware1.fw// or //usb1:/firmware3.fw//:
<code>
flash upgrade (filename)
</code>
 * Firmware upgrade progress will be displayed on the screen. When complete, if successful, enter the following command:
<code>
flash reboot
</code>
 * The device should now be using the new firmware.

==== Flash functionality ====

The device supports two separate firmware banks, and whenever you upgrade, the previous version will still be available. You can inspect the contents of Flash using the following command:
<code>
firmware status
</code>
If you'd like to try the previous version, or restore to the newest version after doing so, use the following command:
<code>
firmware boot (desired bank)
</code>

====== Available Firmware ======

{{mantis:ide_simulator:firmware:2021-04-01.fw?linkonly}}

  * CLI upgraded to support cursor keys, including command history
  * Experimental "Ultra High Density Floppy"/Roland SB808 support
  * Reworked audio playback, including improved volume support
  * Autorun files
    * autorun.txt - command line commands to run at boot
    * autoonce.txt - command line commands are run at boot, then autoonce.txt is deleted
  * Various bugfixes and improvements
  * Device 0 or 1 mode
    * 'interface set master' or 'interface set slave'
  * Support for CrystalFontz LCD to provide built-in ISO display/selection UI

{{mantis:ide_simulator:firmware: 2021-12-23.fw?linkonly}}

  * Improved ISA PC compatibility (e.g. ISA Super I/O card)
  * USB writing fixed for ZIP drive emulation (e.g. Roland SP-808)
  * Improved Namco 2x6 compatibility
  * Fix CUE multibin support, and add WAV file support to it
  * Other bugfixes