This utility handles instrument files for the Ensoniq EPS, EPS16+, and ASR
series. Both EFA and EFE can be supplied, and the instruments will be copied
to the desired floppy image type for use within either floppy emulators or
writing to physical 3.5" DD/HD floppies.

Ensoniq compatible disk image files are automatically generated during
conversion in the specified target (ASR/EPS16/EPS) format.

For conversion of entire disk images (EDE & EDA) rather than single instrument
files, HxCFloppyEmulator software is a very good option for batch conversion
to/from both IMG and HFE...

https://hxc2001.com/download/floppy_drive_emulator/HxCFloppyEmulator_soft.zip

...or use the EDE/EDA to IMG and HFE tools which should be available near or
around where this tool is available for download.

Both Windows and macOS are now supported, so use the commands within the
"macOS" folder when on macOS, and the commands within the "Windows" folder
when on a Windows operating system. The "tools" subfolders should never be
altered, moved, deleted, or otherwise touched.

On macOS, an "unidentified developer" message will typically appear when trying
to run any software not downloaded through the App Store. To avoid this, make
sure to use control-click (or right click) then "Open" on the first run. The
message will no longer appear on subsequent runs of the same program.

===============================================================================
    EFA2IMG & EFE2IMG - Ensoniq EFA/EFE to raw IMG (Omniflop) and HFE (HxC)
===============================================================================

- Move/copy all input files (EDA/EFE/INS) to the [EFE_IN] folder.

For ASR users:
        - To convert EFA/EFE/INS files into ASR HD type images, run
          "EFA and EFE2IMG & HFE (for ASR)"
        - To convert EFA/EFE/INS files into ASR SuperDisk type HFEs, run
          "EFA and EFE2HFE (for ASR SuperDisk)"

For EPS/EPS16 users:
        - To convert EFE/INS files into EPS DD type images, run
          "EFE2IMG & HFE (for EPS & EPS16)"

For EPS16 users:
        - To convert EFE/INS files into EPS16 SuperDisk type HFEs, run
          "EFE2HFE (for EPS16 SuperDisk)"

For TS10/TS12 users:
		- Same as ASR, except that EFA/EFE files over 4MB will not be able
		  to be loaded by the keyboard. This is a hardware limitation.

- Large EFA/EFE files will be automatically split into multiple disk images.

IMG files can be used directly on properly configured floppy emulators, or
written to physical 3.5" floppy disks using Omniflop installed on a desktop PC
with an internal floppy drive.

Also, most Ensoniq-capable software (Translator, EnsoniqFS, et al.) will allow
mounting of IMG files for further manipulation.

HFE files can be used with floppy emulators such as Lotharek HxC, Gotek/HxC,
and Gotek/FlashFloppy.

--------------------------------
 SPECIAL NOTES & CONSIDERATIONS
--------------------------------

DISK CAPACITY:

The ASR can read 800K EPS disks, so it is technically possible to write the
output images from the EPS specific converter to 3.5" DD floppies for use in
an ASR-10/ASR-88, but in actual practice this is nearly pointless as HD floppy
disks have a greater capacity and are much more plentiful and easy to acquire.

As such, the ASR specific EFA/EFE converters always generate HD-type images.


SUPERDISK:

SuperDisk format has three times the capacity of standard format disks, but
only works with floppy emulators, and must be in HFE format. As such, any of
the SuperDisk commands will avoid creating IMGs and only provide HFE output.

Because ASR SuperDisk can hold more than 4MB, this allows TS10/TS12 to always
avoid needing to split large EFA/EFEs over multiple disks.

Likewise, EPS16 SuperDisk holds more than 2MB, so there is never any reason
to split larger EFEs because anything larger than EPS16 SuperDisk would not
be loadable into EPS16 RAM.


DISK SPLITTING / VOLUME SPANNING:

Very large instruments are best handled through SCSI (if available) and some
other Ensoniq-capable software such as Translator, EnsoniqFS, EDM, or EPSm.

However, these converter tools do handle multi-disk creation for sampler units
without SCSI, or users needing to trade disks with other floppy-only units.

Although large instruments are automatically split to match the maximum disk
capacity of the target system (EPS/EPS16 = 800K, ASR = 1600K), the amount of
sampler RAM available may be insufficient for loading them.

This hardware limitation will be especially problematic on EPS classic models
without any memory expansion add-on due to the relatively small amount of RAM
when compared to upgraded EPS16+, and especially a fully expanded ASR-10.


VERIFICATION:

Optionally, any IMG file placed within the [IMG_CHK_IN] folder can be examined
with the "Verify Ensoniq IMGs" tool. This will display information per image,
such as disk label, used/free blocks, and if there is an OS present.

This is handy to run after conversions to double-check that the output is sane
and/or as desired.

Note: *Any* Ensoniq IMG file can be copied/moved into the [IMG_CHK_IN] folder,
so it is not limited to only checking the output of these specific conversion
tools, nor is it limited to only ASR or EPR; the utility recognizes both.
