******************************************************************************
* This file contains important notes on HDDRIVER 9.02. Please read this text *
* carefully before installing the software.                                  *
*                                                                            *
* 1. The most important changes in the latest versions                       *
* 2. Background transfers                                                    *
* 3. The SCSI Driver                                                         *
* 4. Phase Change drives                                                     *
* 5. UltraSatan                                                              *
* 6. Falcons with processor boards                                           *
* 7. Other                                                                   *
* 8. Note of thanks                                                          *
******************************************************************************


1. The most important changes in the latest versions.

- HDDRUTIL provides for a bus rescan. As a result devices switched on
  after booting will be detected by HDDRUTIL and other programs (except
  HDDRIVER). The IDs of these devices must have been known to HDDRIVER when
  booting, i.e. they must have been configured with "Devices and
  Partitions" (7.70).
- Support for the SCSI Driver's target interface (TT/Falcon only). TT and
  Falcon are visible for other computers connected to the same bus and can
  execute the mandatory commands for processor devices listed in the
  SCSI-3 specification.	(7.80)
- The function "Partition Assignment" is now available under "Devices and
  Partitions", after double clicking on the button for the respective device.
  The device IDs are specified by the common syntax for Atari compatibles. A
  device is identified by its bus ID and its device ID. For devices connected
  to the ACSI or SCSI bus the device ID is the same as the SCSI ID. For IDE
  devices master 0 means device ID 0, slave 1 means device ID 1. Master 1 is
  identical with device ID 2, slave 1 with device ID 3. (7.80)
- HDDRUTIL supports creating partitions in the FAT32 format. When creating
  TOS compatible FAT32 partitions enter the partition type "F32", for PC
  compatible partitions the type is "$0b". For partitions of more than 1
  GiB HDDRUTIL automatically creates FAT32 partitions. (7.90)
- HDDRIVER and all of its tools now support any platform for which a SCSI
  Driver is available. HDDRIVER must be launched after the SCSI Driver for
  these platforms. (8.00)
- FAT32 partitions are supported when initializing partitions. Before the
  initialization the partition type should be set to "F32" and the "---"
  fields of the popups have to be selected. (8.00)
- Improved compatibility with the Afterburner fast RAM. Please add the
  AB040FIX program from the folder FIXES as the first program to the AUTO
  folder. (8.10)
- HDDRUTIL provides for activating and deactivating partitions under
  "Change Partition Type". This way partitions can be hidden. (8.10)
- Improved support for memory cards. (8.16)
- Support for IDE drives with a capacity of up to 2048 GiB (2 TiB). (8.20)
- Fixed a bug in HDDRUTIL that could result in FATs of FAT32 partitions
  being one sector too small. It is recommended that users of MagiC recreate
  their FAT32 partitions. MiNT detects the problem automatically and reports
  an error. If nothing is reported the FAT size is correct. (8.23)
- HDDRUTIL supports the complete and partial copying of harddisks. (8.30)
- HDDRUTIL supports the saving and loading of hard disk and partition
  images. (8.30)
- When copying sectors and saving or loading drive or partition images the
  byte order can be changed. (8.31)
- When partitioning the display can be switched between MB/MiB values based
  on 1000 or 1024 bytes per KB/KiB. (8.31)
- HDDRUTIL-specific settings can be configured with "Preferences" in the
  "File" menu. These settings are saved when leaving HDDRUTIL. (8.40)
- The limitation of only one partition with TOS/Windows compatible media was
  lifted. Note that on removable media Windows only supports one partition.
  With Windows several partitions on one medium are only possible with fixed
  disk drives. (8.40)
- When creating Windows compatible media optionally no primary but only
  logical partitions are created. Windows checks for logical partitions
  only after all primary partitions have been handled. This setting
  influences the drive order under Windows when several devices are
  connected. TOS can only boot from primary partitions. (8.40)
- HDDRIVER can now boot from non-byteswapped TOS/Windows compatible media
  without pressing any key. (8.40)
- Up to 8 logical SCSI units (LUNs) are supported by HDDRIVER and HDDRUTIL.
  (The SCSI Driver interface has already supported up to 8 units.) Note
  that TOS can only boot from LUN0. (8.40)
- The computer's SCSI ID is now configured with "SCSI Driver". (8.40)
- The setting "Unlock after Reset" was moved to "Removable Media". (8.41)
- The number of reserved partitions for removable media can be set to 0.
  This can be useful for devices with several logical units (LUNs), in
  particular for SCSI card readers with only one slot being used. Note that
  with this setting the removable medium must be inserted before booting in
  order to access any partition at all on this medium. (8.43)  
- The file "HDDRUTIL.INF" is now saved to the same folder HDDRUTIL is
  located in. (8.44)
- The language used by HDDRUTIL can be set in the "Preferences". (8.44)
- HDDRUTIL remembers the path of the HDDRIVER driver file configured last.
  Only when a different file is to be configured "Locate HDDRIVER" has to
  be used. (8.44)
- When creating TOS/Windows compatible media for each PC compatible Linux
  partition (ID $83) an Atari compatible Linux partition (ID 'LNX') is
  created. (8.44)
- XHDI calls do not accept BIOS device numbers anymore that are higher
  than the current GEMDOS limits maximum device number. (8.47)
- Fixed a potential freeze of HDDRUTIL when accessing media with more
  partitions than supported by the current GEMDOS version. (8.47)
- Fixed a bug that caused an address error (3 bombs) on STs when with IDE
  drives data were transferred to odd addresses. (8.48)
- Fixed a bug that caused ACSI and IDE devices with the same ID as the
  SCSI initiator ID to be checked when booting. (8.49)
- The XHDI functions XHInqTarget() and XHInqTarget2() also report the
  device name when there is no medium in a drive. (8.49)
- With a suitable hardware extension (e. g. "The Doubler") up to 4 IDE
  ports with up to 8 devices (addresses $FFF00000, $FFF00040, $FFF00080
  and $FFF000C0) are supported. The additional ports must be compatible
  with the Falcon's IDE port. (9.00)
- The functions "Create Boot Disk" and "Modify HDDRIVER" for exotic IDE
  drives are no longer supported. (9.00)
- Extended support for multimedia commands (MMC) of CD-ROM/DVD/BD drives
  and burners. In addition to DVD-RAM media with many drives (MRW) HDDRUTIL
  and HDDRIVER can now also format and write to DVD+RW and BD-RE
  media. (9.00)
- The "IDE READ/WRITE MULTIPLE" settings were moved to the SCSI Driver
  settings and renamed to "Accelerated Access". (9.00)
- ICD compatible hardware, which supports drives with a capacity of more
  than 1 GiB connected to the ACSI bus, is now detected automatically.
  Therefore also for GigaFile, UltraSatan and Hatari there is no special
  setting required anymore. (9.00)
- The option "Ignore PC Compatible Partitions" was removed. Affected devices
  can be deselected in "Devices and Partitions" instead. (9.00) 
- HDDRUTIL displays two windows with all known devices and drives. The
  device or drive to operate on can be selected from these lists. The
  operations available for the selected item are enabled in the main menu
  and are also offered by a context menu, which is displayed when selecting
  an item with the right mouse button.
  Devices that can directly be managed by HDDRIVER are marked with a leading
  '.'. Other devices can be managed by the SCSI Driver included in HDDRIVER,
  but require additional third party drivers, e. g. CD-ROM drives. MMC
  devices can partially be managed by HDDRIVER, depending on the medium
  currently inserted.
  Sectors/Media can be copied by dragging the source device onto the target
  device with the mouse (Drag&Drop). Source and target device may be
  identical.
  A device rescan updates the device list. Only the device IDs the currently
  running HDDRIVER was configured with are scanned. A drive rescan updates
  the list of drives. A rescan is recommended after changing a removable
  medium while HDDRUTIL is running.
  HDDRIVER can be installed by double-clicking on a drive. If a driver file
  HDDRIVER.SYS already exists it will be renamed to HDDRIVER.OLD. The
  (primary) partitions suitable for an installation are marked with a
  leading '.'. (9.00)
- The new function "Device Information" displays detailed information on a
  device. Double-clicking a device also displays this information. (9.00)
- Details regarding the buses managed by the SCSI Driver can be displayed
  with "Bus Information". (9.00)
- Cache parameters can be configured for more ATAPI and SATA devices than
  before. (9.00)
- Changing partition IDs and initializing partitions is now offered by
  "Edit Partitions". (9.00)
- The new function "Execute Self-test" starts the built-in self-test of a
  device. (9.00)
- The new function "Eject" ejects a medium if this is supported by the
  respective device. (9.00)
- The new function "Export Configuration" saves an overview of all HDDRIVER
  settings. (9.00)
- The new function "Erase All Data" overwrites any data on a medium. (9.00)
- The new function "Show Details" displays important data regarding the
  layout of TOS compatible partitions. (9.00)
- The option "SCSI Reset when Booting" was moved to the boot parameter
  settings. (9.00)
- The supported LUNs can be configured separately for each device after
  double-clicking a device in the "Devices and Partitions" settings. If for
  an active device no LUN is configured this device is managed by the SCSI
  Driver, but HDDRIVER does not search for partitions. When booting,
  information about each configured device ID is displayed, even when no
  device is found. (9.00)
- "Recover Data" was renamed to "Restore Root Sector". (9.00)
- In addition to the predefined XHDI compatible partition types ("RAW",
  "MIX", "LNX", "F32", $0b, $0c and $83) a user-defined type is supported.
  This type can be entered in the "Devices and Partitions" dialog The former
  "Partition Types" menu item has been removed. The types "MIX", "LNX" and
  $83 (PC Linux) are only supported when "Manage Linux and Minix Partitions"
  is enabled. (9.00)
- When formatting SH/Megafile drives HDDRUTIL automatically uses an
  interleave of 1, for other drives the interleave is 0. (9.00)
- The SCSI target interface supports all mandatory processor device
  commands of the SPC-2 specification. (9.00)
- The SCSI emulation for IDE drives supports all mandatory commands of
  the SBC-3 specification and returns more precise error codes. (9.00)
- The "TOS & Windows Combined" checkbos was removed. In order to create
  TOS/Windows compatible media simply select both the "TOS" and "Windows"
  checkboxes. (9.00)
- The two options "Protect Root Sectors" and "Protect Boot Sectors" were
  combined to a single option "Protect Root and Boot Sectors". (9.00)
- The "Change Partition IDs" dialog window was extended. (9.00)
- In the error information dialog HDDRCONF.CPX additionally displays the
  Sense Key. (9.00)
- Automatically saving the HDDRUTIL preferences is optional. (9.00)
- Numerous help dialog texts were updated and some settings were renamed to
  less technical terms. (9.00)
- Fixed a bug in HDDRUTIL that could result in partitions vanishing after
  initializing a partition on a medium with more than 4 partitions. (9.01)
- The "SCSI Processor Device" setting, which enables the SCSI Driver's
  target interface, is optional again. Note that this setting is required
  for background transfers with MagiC. (9.01)
- Improved compatibility with special SCSI hardware combinations (Acard
  AEC-7720U combined with IDE-to-SATA adapter). (9.01)
- Fixed a problem with detecting SH/Megafile drives, which was caused by the
  Acard-related change in HDDRIVER 9.01. (9.02)

This list only comprises a subset of changes. If required a new manual based
on the current version of HDDRIVER can be ordered.

******************************************************************************

2. Background transfers

The transfer mode "Background DMA (MagicAtari)" may only be used when all
drivers for devices connected to the ACSI or SCSI bus make use of the SCSI
Driver integrated in HDDRIVER. Not taking care of this may result in loss of
data. METADOS is not compatible with background transfers. Use the CD-ROM
driver ExtenDOS pro or SPIN! instead.
The line with the keyword "_TSL" has to be removed from the MAGX.INF file.

******************************************************************************

3. The SCSI Driver

The SCSI Driver is a standardized software interface that provides for using
any SCSI peripheral (with HDDRIVER ATAPI and IDE as well) with the Atari, the
Milan, MagiCMac and MagiCPC. For the Atari compatible ACSI, SCSI and IDE ports
and the Milan's second IDE port a SCSI Driver is included in HDDRIVER.
Additionally HDDRIVER supports the SCSI Driver's target interface. A TT or
Falcon is detected as a SCSI-3 compatible device by other devices connected to
the SCSI bus.
Using the target interface TT and Falcon can execute proprietary SCSI commands.
Using HDDRIVER it should be possible to write SCSI-based networking software,
for instance. Sample code in the C programming language for implementing
proprietary SCSI command is available on request. Note that this only makes
sense for programmers with a thorough knowledge of SCSI and know how the
target interface of the SCSI Driver works.
In order for the target interface to work flawlessly all drivers accessing
SCSI peripherals must use the SCSI Driver integrated in HDDRIVER.

HDDRIVER and all tools can also be used under MagiCMac and MagicPC, provided a
SCSI Driver for these platforms is installed.
A note on MagiCPC: When using HDDRIVER neither CBHD.PRG nor CBHD.CPX but only
SCSIDRV.PRG should be installed. Otherwise HDDRIVER may crash. Installing CBHD
in addition to HDDRIVER is not recommended because this leads to a loss of
functionality since CBHD does not support the latest revisions of the XHDI and
SCSI Driver specifications.

******************************************************************************

4. Phase Change drives

Phase Change drives (Phasewriter Dual, PD/CD) are a combination of an optical
drive and a CD-ROM drive. They support two operating modes: Mac compatible and
PC compatible. With the Atari both modes can be used. In the Mac compatible
mode the PD drive uses a single SCSI-ID with the logical device number 0
(LUN 0). In order to access both PD and CD-ROM media the hard disk driver and
the CD-ROM driver must manage the same device. In the PC compatible mode the
PD drive uses two logical IDs, namely LUN 0 for optical media and LUN 1 for
CD-ROMs. Using a PD drive in the PC compatible mode requires a CD-ROM driver
that can manage CD-ROM drives with LUN 1.
Whe using the PD drive in the Mac compatible mode the setting "CD-ROM Drives
like Removable Disk Drives" must be enabled in HDDRUTIL. In the PC comaptible
mode this setting should be turned off.

******************************************************************************

5. UltraSatan

Due to incompatibilities with the SCSI standard in old UltraSatan firmware
versions HDDRIVER only supports UltraSatan firmware versions 1.20 or newer.
It is recommended that UltraSatan users flash the latest firmware.
Just like for any device with removable media, for the UltraSatan the
settings for removable media drives, which can be configured with HDDRUTIL,
are relevant.

******************************************************************************

6. Falcons with processor boards

None of the available processor boards for the Falcon is fully compatible with
an unmodified Falcon.

The Afterburner does not integrate the 68040 correctly, in particular with
respect to handling the processor cache. As a result accessing the SCSI bus
often fails, depending on the software used to initialize the Afterburner.
This means that booting from a SCSI drive may be impossible.
A suggestion for Falcons with the Afterburner board: Install HDDRIVER and only
enable the internal IDE drive. Now place the Afterburner software at the
beginning of the AUTO folder, HDDRIVER.PRG must be placed after that. Now use
HDDRUTIL to configure the HDDRIVER.PRG file in the AUTO folder instead of the
HDDRIVER.SYS file, which remains unchanged. Also follow the notes on AB040FIX
included in the FIXES folder on the HDDRIVER floppy disk.

CT060 boards with old firmware do not work properly with respect to the
interrupt handling. With the current CT060 firmware HDDRIVER has been tested
successfully. If you have any problems you need to get a current CT060 firmware
update.

******************************************************************************

7. Other notes

Before installing HDDRIVER on hard drives with more than four partitions,
where the ICD hard disk software is still running modify the partition table
with the ICD2AHDI program. This software is located in the CONTRIB folder of
the HDDRIVER distribution. Old versions of the ICD software did not create an
Atari compatible partitioning scheme but a proprietary one. The README of the
ICD2AHDI software provides more information. 

HDDRIVER must not be copied to the AUTO folder, except when running MagiCMac,
MagiCPC or Hatari, and under certain circumstances (see above) with the
Afterburner. HDDRIVER should always be installed with "Install HDDRIVER" and
by no other means.

When booting from a partition other than C: it is recommended that you move all
of your accessory files (.ACC) to your new boot partition and not use C: as a
boot partition at all. Note, though, that under TOS certain device drivers may
not find (looking for them on C:) their configuration files in this case.

******************************************************************************

8. Note of thanks

I would like to thank all those who have helped with testing HDDRIVER and
those who contributed the software in the CONTRIB folder. Please direct any
questions regarding this software to the authors.
Thank you to Karl-Ludwig Dietsch and Sascha Uhlig for contributing the icons
in the file ICONS.RSC.

******************************************************************************

In case of troubles with HDDRIVER please consult the help texts accessible in
the dialog windows. Information is also available in the FAQ and in the forum
on the HDDRIVER website:

  http://hddriver.seimet.de

In case of a support request please provide your HDDRIVER serial number.


    Uwe Seimet, April 2nd, 2014
