**************************************************************************
* This file contains important notes on HDDRIVER 11.09. Please read this *
* text carefully.                                                        *
*                                                                        *
* 1. The most important changes in the latest versions                   *
* 2. MagiC DMA background transfer                                       *
* 3. The SCSI Driver                                                     *
* 4. Phase Change drives                                                 *
* 5. Falcons with processor boards                                       *
* 6. GUID partition tables (GPT)                                         *
* 7. Other                                                               *
* 8. Note of thanks                                                      *
**************************************************************************


1. The most important changes in the latest versions

- HDDRIVER: With the integrated SCSI Driver not only SCSI drives but now
  also IDE and SATA hard disk drives > 2 TiB can be addressed with their
  full capacity. (10.00)
- HDDRIVER: The SCSI emulation for IDE drives supports
  READ/WRITE/VERIFY (16) and READ CAPACITY (16). (10.00)
- HDDRIVER: Improved mapping of IDE to SCSI error codes. (10.00)
- HDDRIVER/HDDRUTIL: Support for the "Reduced Block Commands" command set
  (RBC), for devices with limited features. (10.00)
- HDDRIVER/HDDRUTIL: Improved support for mass storage devices that do not
  support the READ/WRITE (6) commands. (10.00)
- HDDRIVER/HDDRUTIL: Numerous optimizations to reduce the memory
  footprint. (10.00)
- HDDRIVER/HDDRUTIL: HDDRIVER.SYS can be installed in TT-RAM by enabling
  the corresponding option in the "File->Preferences" dialog. This makes
  sense for Ataris with Fast RAM and IDE interface, in order to increase
  the IDE transfer rate. Note that hard disk drivers that reside in TT-RAM
  cannot be booted from the ACSI bus. (10.00) 
- HDDRUTIL: Support for 64 bit sector numbers. (10.00)
- HDDRUTIL: The functions for erasing, copying, loading, saving and
  testing sectors support media > 2 TiB. (10.00)
- HDDRUTIL: When loading or saving media images as well as when testing
  sectors the start sector and the number of sectors can be
  specified. (10.00)
- HDDRUTIL: In order to better support additional buses a new window with a
  list of all available buses has been added. (10.00)
- HDDRUTIL: All windows can be closed. Whether they are open or closed can
  be toggled in the new "Windows" menu. (10.00)
- HDDRUTIL: The device check sorts buses by their SCSI Driver ID. (10.00)
- HDDRUTIL: With "Scan Bus" only the selected bus is scanned for
  devices. (10.00)
- HDDRUTIL: When a bus, device or drive is selected all corresponding buses
  devices and drives are marked. (10.00)
- HDDRUTIL: If possible the capacity of a device/medium is displayed in
  the device window. (10.00)
- HDDRUTIL: "Device Information" displays whether the SCSI Driver supports
  all SCSI command classes for this device. (10.00) 
- HDDRUTIL: The new function "Medium Details" displays details for the
  selected mass storage medium. (10.00)
- HDDRUTIL: Improved capacity usage with Windows and TOS/Windows compatible
  partitioning. (10.00)
- HDDRUTIL: When partitioning TOS or TOS/Windows compatible media in sector
  mode there is no automatic adjustment of partition boundaries anymore.
  The sector mode is meant to only be used by experts. (10.00)
- HDDRUTIL: HDDRUTIL makes use of the REPORT LUNS command, if supported
  by a device, in order to optimize the check for available LUNs. (10.00)
- HDDRIVER: Up to 15% higher IDE transfer rates compared to all previous
  versions. (10.01)
- HDDRIVER: Faster byteswapping. (10.01)
- HDDRIVER: Optimizations to reduce the memory footprint. (10.01)
- HDDRIVER: Fixed a problem in HDDRIVER 10.00 that affected the automatic
  detection of ICD compatible adapters/devices with ACSI IDs > 0. (10.01)
- HDDRIVER: Higher IDE transfer rates to/from odd addresses for STs with
  68020 and newer. (10.02)
- HDDRIVER: The SCSI Driver does not convert the ATAPI/SATA packet commands
  READ/WRITE (6) to READ/WRITE (10) anymore. These commands are now
  passed through unchanged. (10.02)
- HDDRIVER: Further size optimizations. HDDRIVER 10 is the most compact
  HDDRIVER since HDDRIVER 6. (10.02)
- HDDRUTIL: "Show Details" also displays XHDI-related information about the
  selected drive. (10.02)
- HDDRUTIL: Partitioning does not anymore require an XHDI compatible driver
  to be installed, SCSI Driver compatibility is sufficient. (10.02)
- HDDRUTIL: Improved Windows compatibility of FAT32 partitions created by
  HDDRUTIL. (10.02)
- HDDRUTIL: Fixed problem with loading/saving partition images. (10.02)
- HDDRIVER: Timeouts are now dynamically calculated, based on the number of
  bytes to be transferred. (10.03)
- HDDRUTIL: "Show Details" also displays XHDI-related information for
  drives with an invalid BPB. (10.03)
- HDDRUTIL: Improved detection of byteswapped TOS compatible media. (10.03)
- HDDRUTIL: When opening the partitioning dialog or using the
  "Edit Partitions" function for a medium with a GUID partition table (GPT)
  a warning is displayed. (10.03)
- HDDRIVER: Support for UEFI GUID partition tables (GPT). (10.10)
- HDDRUTIL: With "Devices and Partitions" unknown GUID types can be mapped to
  the XHDI RAW type. (10.10)
- HDDRUTIL: The new menu item "Check Boot Sector" checks whether a partition
  is compatible with the currently running operating system and the current
  XHDI limits. It displays the boot sector parameters and, in brackets, the
  limits. Parameters that are not compatible with the limits are displayed
  disabled. Affected partitions may require a newer version of TOS or software
  like Big-DOS in order to be usable. (10.11)
- HDDRUTIL: Clicking on "Save" in the HDDRUTIL preferences dialog saves the
  preferences and closes the dialog. The "Save Preferences Now" button has
  been removed. (10.12)
- HDDRUTIL: The "Partition" dialog displays the byte swapping status. (10.12)
- HDDRUTIL: Fixed a bug that affected the TOS/Windows compatible partitioning
  and could result in wrong partition data being calculated for other
  partitions than the first one. This bug only affected operating systems
  that support more than one Windows compatible partition per medium. (10.14)
- HDDRIVER/HDDRUTIL: Improved handling of boot sectors of media with a super
  floppy layout (media without a root sector). (10.15)
- HDDRUTIL: Ejecting media works with any device, e.g. also with
  streamers. (10.15)
- HDDRIVER: The SCSI emulation for IDE/SATA devices reports an error when
  trying to format drives compliant with ATA-4 or newer. ATA-4 and newer do
  not support the FORMAT command anymore. (10.16) 
- HDDRUTIL: In order to save space on the screen the information displayed
  in the info bars was moved to the window titles. (10.16) 
- HDDRUTIL: Partition, drive and bus window do not have a minimum width
  anymore. (10.16)
- HDDRIVER: More than 4 partitions in the root sector without XGM structure
  (not AHDI compatible) are no longer supported. (10.17)
- HDDRIVER/HDDRUTIL: Fixed a regression (since HDDRIVER 10.00) that could
  result in a crash or freeze on a Milan when booting or when running a
  device check. (10.17)
- HDDRUTIL: When re-starting the system after partitioning MiNT is properly
  shut down. (10.17)
- HDDRIVER: Optional blitter support speeds up IDE transfers up to 20%,
  in particular with STs. (11.00)
- HDDRIVER: Support for 4Kn SATA hard disk drives with 4096 physical bytes
  per sector (Advanced Format Drive, AFD). Note that TOS cannot boot from
  these drives: The IDE interface will be blocked, so that such a drive
  cannot be operated as master drive at the primary IDE port. (11.00)  
- HDDRIVER: HDDRIVER only reports its name on the SCSI bus when its target
  ID (usually 7) is explicitly enabled in "Devices and Partitions" and
  the SCSI Driver Target Interface is available (see below). (11.00)
- HDDRIVER/HDDRUTIL: Numerous code optimizations. (11.00)
- HDDRIVER/HDDRUTIL: Support for media with a physical sector size of up to
  4096 bytes. (Previous versions supported up to 2048 bytes.) (11.00)
- HDDRIVER/HDDRUTIL: HDDRUTIL now can install two flavors of HDDRIVER: One
  with and one with SCSI Driver Target Interface. The version without target
  interface support is almost 3 KiB smaller. Only with target interface
  HDDRIVER with TT and Falcon acts as SCSI target and can execute SCSI
  commands sent by other devices connected to the SCSI bus. The HDDRUTIL
  settings offer an option to select the desired HDDRIVER flavor to be
  installed with "Install HDDRIVER". (11.00)
- HDDRIVER/HDDRUTIL: If HDDRIVER is installed with the "Execute HDDRIVER
  Modules" option enabled, before loading HDDRIVER.SYS driver modules are
  executed. Such modules are in particular meant to install additional
  device drivers. More information on HDDRIVER modules is available on the
  HDDRIVER website. (11.00)
- HDDRIVER/HDDRUTIL: HDDRIVER can extend the cookie jar by an additional
  number of entries, which is configurable with the "Basic Settings". Just
  like before HDDRIVER extends the cookie jar automatically if required to
  set all of its own cookies. (11.00) 
- HDDRUTIL: All settings to improve the data transfer rates are now
  located under "Performance". (11.00)
- HDDRUTIL: The SCSI specific settings for TT and Falcon are now configured
  with "Boot Parameters". (11.00)
- HDDRUTIL: "Show Details" displays the physical and logical sector sizes.
  With AFD drives (Advanced Format Drive) these can differ, e.g. with 512e
  SATA drives. (11.00)
- HDDRUTIL: When editing partitions of TOS/Windows compatible media you
  can choose whether to edit the TOS or Windows partition data. (11.00)
- HDDRUTIL: By selecting a device while the [Control] key is being pressed
  (until the "Format" dialog appears), the format function is available
  regardless of the device status. (11.00)
- HDDRUTIL: "Export Configuration" now also exports the SCSI ID configured
  in the NVRAM. (11.00)
- HDDRUTIL: Help text updates. (11.00)
- HDDRUTIL: Fixed a bug in the driver installation that could lead to a
  crash when booting HDDRIVER 11 from the ACSI bus with TOS versions
  older than TOS 2.0. (11.01)
- HDDRIVER: Fixed a bug in the XHDI implementation which caused an issue
  when using byteswapped media with Big-DOS or MiNT (11.02)
- AUTOPARK: Fixed a problem when being initialized as an accessory instead
  of an application, which could cause a crash when displaying the desktop
  info. (11.02)
- HDDRIVER: Fixed a problem that could result in feigned keystrokes during
  mouse movements when combining accelerated IDE transfers with blitter
  support. (11.03)
- HDDRUTIL: With "Devices and Partitions" the bus and device IDs are
  editable for any device and not only for devices with a bus ID higher than
  2. (11.03)
- HDDRIVER: Improved compatibility with some Delock IDE DOMs. (11.04)
- HDDRUTIL: Fixed a bug in the evaluation of the sector count input for the
  sector test and for copying media. (11.05)
- HDDRUTIL: Improved error messages when evaluating the sector inputs for
  the sector test and for copying media. (11.05)
- HDDRUTIL: During the sector test the total number of sectors is
  displayed. (11.05)
- HDDRUTIL: Fixed a partitioning bug that prevented TOS/Windows compatible
  partitions < 16 MB from actually being Windows compatible. (11.06)
- HDDRIVER: Fixed a bug affecting IDE transfers to odd addresses with
  blitter support. (11.07)
- HDDRUTIL: Faster copying of media by making better use of the available
  main memory. (11.08)
- HDDRUTIL: More intelligent device information query for devices which are
  not mass storage devices. (11.08)
- HDDRUTIL: Fixed a bug affecting creating TOS/Windows compatible partitions
  > 32 MB with TOS 1.00/1.02 compatibility. (11.09)

This list only comprises a subset of changes. More information on changes is
available on http://www.hddriver.net. As needed a new manual based on the
current version of HDDRIVER can be ordered.

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

2. MagiC DMA background transfer

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 also ATAPI, IDE and SATA) with the Atari
and the Milan.
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.
When using the PD drive in the Mac compatible mode the setting "Manage
Multimedia Drives" must be enabled in HDDRUTIL. In the PC comaptible mode
this setting should be turned off.

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

5. 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.

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

6. GUID partition tables (GPT)

HDDRIVER supports partitions which are defined in GUID partition tables,
provided that their sector numbers are within the 32 bit range. (See Wikipedia,
for instance, for detailed information on GUID partition tables.)
When partitioning HDDRUTIL displays GUID partitions, but can only create MBR
partition tables.

HDDRIVER maps GUID types to MBR types like this:

 GUID type                            | Windows/Linux or TOS type
--------------------------------------|----------------------------------
 EBD0A0A2-B9E5-4433-87C0-68B6B72699C7 | $0E (FAT16 LBA), $0C (FAT32 LBA)
--------------------------------------|----------------------------------
 0FC63DAF-8483-4772-8E79-3D69D8477DE4 | $83
--------------------------------------|----------------------------------
 734E5AFE-F61A-11E6-BC64-92361F002671 | "BGM", "F32"

Optionally with "Devices and Partitions" all other GUID types can be mapped
to the XHDI RAW type by enabling the respective option.
										
******************************************************************************

7. Other notes

Before installing HDDRIVER on drives with more than four partitions, where the
ICD hard disk software is 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 and under certain circumstances (see above) with the Afterburner.
HDDRIVER should 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
HDDRIVER forum on the HDDRIVER website:

  https://www.hddriver.net


    Uwe Seimet, October 23rd, 2021
