*************************************************************************
* This file contains important notes about HDDRIVER 8.03 supplementing  *
* the manual. Please read this text carefully before installing the     *
* driver.                                                               *
*                                                                       *
* 1. Background transfer                                                *
* 2. The SCSI Driver                                                    *
* 3. Phase-change devices                                               *
* 4. ATAPI CD-ROM devices                                               *
* 5. Falcons with Afterburner                                           *
* 6. Miscellaneous                                                      *
* 7. Thanks                                                             *
* 8. What's new in the current version of HDDRIVER                      *
*************************************************************************


1. Background transfer

The transfer mode "Background Transfer" in conjunction with MagiC on the 
Atari may only be used when all the drivers for devices on the ACSI or
SCSI bus use the SCSI Driver integrated into HDDRIVER. Those who disregard 
this direction risk faulty operation of HDDRIVER or other programs that 
use the SCSI bus, which may lead to data losses. METADOS is not suitable 
for background-DMA. Remedy is to use a newer CD-ROM driver such as SPIN! 
(see below) or the current version of ExtenDOS.
The line containing the keyword "_TSL" must be removed from the file 
MAGX.INF when background-DMA is to be used.
With a TT and Falcon background-DMA is only possible when the option 
"SCSI Processor Device" is active in the "Settings->SCSI DRIVER" dialog.

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

2. The SCSI Driver

The SCSI Driver is a standardised software interface that makes it possible 
to control SCSI peripheral devices on Atari, Milan, MagiCMac and MagiCPC 
operating systems. HDDRIVER contains an integrated SCSI Driver for the 
ACSI, SCSI and IDE interface of all Ataris and the IDE interface of the 
Milan. In addition HDDRIVER supports the so-called "Target interface".
With the option "SCSI Processor Device" active, a TT or Falcon will be 
recognised as a SCSI-3-compatible device by other devices that are 
connected to the same SCSI bus, and can be addressed as such. With the 
Target interface one can implement any desired SCSI commands, which are 
then handled by the TT/Falcon. Based on HDDRIVER it should then be possible 
to write SCSI network software for the TT and Falcon, for instance.
Sample code in C for the implementation of custom SCSI commands is available
from the author on request. Note that this is only suitable for programmers 
who are thoroughly familiar with SCSI and know how the Target interface of 
the SCSI Driver works.
For proper functioning of the Target interface it is imperative that all 
drivers that access SCSI peripherals do this via the SCSI Driver integrated 
into HDDRIVER. Those that use SCSI software working with its own SCSI
routines should switch off the option "SCSI Processor Device" in HDDRUTIL.

HDDRIVER and all its tools may also be used under MagiCMac and MagiCPC. A 
prerequisite is that a SCSI Driver for these systems has been installed.
This is available from Steffen Engel:

Steffen Engel
Mhlentrift 5
38126 Braunschweig

E-Mail: Steffen.Engel@t-online.de, Steffen_Engel@sz2.maus.de
WWW: http://home.t-online.de/home/Steffen.Engel/

These web pages also contain the official documentation for SCSI Driver 
in version 1.01. Please direct any questions about SCSI Driver directly
to Herr Engel.

A note for MagiCPC: When using HDDRIVER, neither CBHD.PRG nor CBHD.CPX 
should be installed, but only SCSIDRV.PRG. Otherwise starting HDDRIVER can 
lead to a crash. Furthermore, the installation of CBHD in addition to 
HDDRIVER results in loss of functionality, particularly for XHDI support.

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

3. Phase-change devices

Phase-change drives (Phasewriter Dual, PD/CD) are a combination of an 
optical drive and a CD-ROM drive. They can be set to two operating modes: 
Mac-compatible and PC-compatible. Both can be used on an Atari. In 
Mac-compatible mode the PD drive occupies a single SCSI-ID with logical 
device number 0 (LUN0). In order to be able to address PD media as well as 
CD-ROMs in this mode, both the hard disk driver and the CD-ROM driver must 
manage the same device. In the PC-compatible mode the PD drive registers 
itself twice, namely as an optical drive under LUN0 as well as a CD-ROM 
drive under LUN1. In order to use a PD drive in PC-compatible mode one 
needs a CD-ROM driver that can access CD-ROM drives with the SCSI logical 
unit number 1 (LUN1), for instance SPIN! (see below). If the PD drive is 
used in Mac-mode, you have to switch on "CD-ROM Drives like Removable Disk 
Drives" in the "Removable Media" dialog. In PC-mode this option should be 
switched off.

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

4. ATAPI CD-ROM devices

With CD-ROM drives on the IDE interface we are dealing with devices that 
support the ATAPI standard. With HDDRIVER the programs based on the 
integrated SCSI Driver are, besides SCSI peripherals, also usable for 
ATAPI devices.
Note that we are talking here exclusively about software that uses the
SCSI Driver integrated in HDDRIVER. Do not forget to activate the IDs of 
your ATAPI devices in HDDRUTIL in "Devices and Partitions", so that 
these are supported by the SCSI Driver. Good results with CD-ROM drivers 
for SCSI and ATAPI devices have been achieved with the driver SPIN!.
SPIN! is available in various Maus mailboxes as well as on the Internet:

http://www.muenster.de/~reschke/

If you have no net access, the author will be pleased to send you a floppy 
disk with SPIN! for a contribution to expenses of 10 DM in notes or a 
(German) cheque:

Julian F. Reschke
Hensenstrae 142
48161 Mnster

Please specify whether your computer can read HD floppy disks.

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

5. Falcons with Afterburner

The Afterburner for the Falcon does not integrate the 68040 CPU correctly 
into the whole system, particularly with regard to the processor cache.
Depending on the initialisation of the Afterburner (there are several 
programs available for this) this may result in accesses to the SCSI bus 
not being performed correctly, and so direct booting from SCSI drives is 
often not possible.
If SCSI devices on Falcons with Afterburner are not recognised, a small 
trick can help: First install HDDRIVER and activate only the internal IDE 
drive in "Devices and Partitions". Copy the initialisation software for 
the Afterburner as the first program into the AUTO folder. Then place
HDDRIVER.PRG as the second program in the AUTO folder and configure this 
file instead of HDDRIVER.SYS with HDDRUTIL.

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

6. Miscellaneous

Before installing HDDRIVER on hard disks with more than four partitions 
on which the ICD driver was installed previously, one has to use the 
program ICD2AHDI (in the CONTRIB directory of the HDDRIVER driver floppy). 
This is due to the fact that old versions of the ICD software did not use 
Atari-compatible partitioning, but their own format. More information is 
provided in the README for software ICD2AHDI.

HDDRIVER does not belong in the AUTO folder, except under MagiCMac and 
MagiCPC. The driver installation proceeds exactly as described in the 
manual. No further steps are required.

The IDs of SLM laser printers should not be activated in "Devices and 
Partitions".

HDDRIVER supports version 1.01 of the SCSI Driver interface. Some programs 
contain an error when enquiring about the version number and refuse to work 
with the 1.01 version. In such cases, please contact the relevant authors.

When booting from a partition other than C:, desk accessories will only be 
loaded from another drive to C: if there are no accessories on C:. This is 
due to the fact that HDDRIVER does not encroach on the system routines to 
load the accessories from the desired drive. So if you arrange for multiple 
boot-partitions, you should forego using C: as a boot-partition and also 
not put any desk accesssories on it. It should be noted, however, that 
under TOS (though not under MagiC) some device drivers that load files 
subsequently may in some circumstances not find these files.

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

7. Thanks

My thanks go to everyone who has vigorously taken part in beta-testing 
HDDRIVER, as well as those from whom the software in the CONTRIB folder 
originates. If any questions arise about this software, please do not 
contact me but get in touch directly with the relevant authors.

I would like to express special thanks to Rainer Seitel and Thomas Binder 
for their support during realisation of the DOS-compatible partitioning, to 
Axel Gehringer for making hardware available and to Carl-Michael Ewert for 
tests with a DVD-RAM drive.

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

8. What's new in the current version of HDDRIVER

Bracketed numbers show the version where the function was first introduced.

- With "TOS & Windows Combined", partitioning can create media that can be 
  used without additional software under TOS as well as under DOS/Windows. 
  These media may only have a single partition. (7.10)
- DOS-compatible FAT32 partitions are treated as partitions of the type RAW 
  (see XHDI documentation). For TOS-compatible FAT32 partitions the new 
  type "F32" exists, which is treated by HDDRIVER also as the type RAW.
  With FreeMiNT 1.15 or MagiC 6.1 this permits access to FAT32 partitions.
  These are large Windows-compatible partitions with long file names. (7.55)
- Partitions can now also be assigned the IDs A: and B:. (7.60)
- For ZIP and JAZ drives, Auto-Sleep and for ZIP also Auto-Park may be 
  configured. These settings are lost when switching off the devices.
  Therefore it is recommended to make the changes with the ZIPCTRL.CPX and 
  to save them. ZIPCTRL activates the saved settings during booting. (7.60)
- DVD-RAM media and media of LS-120 drives may be fornmatted with HDDRUTIL.
  Diskettes that were formatted as floppies may not be accepted by the 
  LS-120 in some circumstances. This depends on the software that was used 
  for formatting. When partitioning diskettes with the LS-120 drive, one 
  should take care not to enter *any* partitions. This is the only way to 
  obtain a medium that can be used like a floppy diskette. (7.63)
- LBA-addressing for IDE drives ensures general support for large disks 
  with a capacity above 8 GByte. (7.70)
- For IDE drives the integrated SCSI Driver emulates all SCSI-3 commands 
  specified for hard drives, as well as some others. (7.70)
- Optional creation of byte-swapped media during partitioning, as required 
  for data exchange with PCs via IDE hard disks (but not ATAPI or SCSI). 
  (7.70)
- HDDRUTIL permits a Bus Rescan. This ensures that devices switched on 
  subsequently are recognised by HDDRUTIL and other programs (except 
  HDDRIVER). The SCSI-IDs of these devices must have been known to HDDRIVER 
  already during booting, i.e. they must have been set previously in 
  "Devices and Partitions". (7.70)
- Support for the Target interface of the SCSI Driver (TT/Falcon only) with 
  the option "SCSI Processor Device" in "Settings->SCSI Driver" and 
  complete implementation of SCSI target routines for SCSI-3-compatible 
  processor devices. With this the TT/Falcon is visible to other computers 
  on the bus and can execute the commands specified in the SCSI-3 standard 
  for processor devices. More about this below. (7.80)
- The "Partition Assignment" function has been removed. These settings can 
  now be made with "Devices and Partitions" after a double-click on the 
  button for the relevant device. (7.80)
- The input of device-IDs in "Devices and Partitions" now takes place with 
  the syntax that has in the meantime become usual for Atari compatibles. A 
  device is identified by the bus to which is is connected (Bus-ID), and 
  the device-ID. For devices on the ACSI and SCSI bus the device ID 
  corresponds to the SCSI-ID, and with IDE devices Master 0 corresponds to 
  the device-ID 0, Slave 0 corresponds to device-ID 1, Master 1 equates to 
  device-ID 2, Slave 1 with device-ID 3. The names and IDs of all available 
  busses are displayed by HDDRUTIL in a dialog window. (7.80)
- WARNING: IF THE ROOT- AND BOOT-SECTORS ARE WRITE-PROTECTED AND AN 
  HDDRIVER < 7.81 IS INSTALLED, HDDRUTIL >= 7.81 WILL COMPLAIN DURING 
  DRIVER INSTALLATION ABOUT THE WRITE-PROTECTION. THIS MESSAGE IS DUE TO 
  TECHNICAL REASONS AND CAN BE IGNORED IN THIS CASE. PLEASE MAKE SURE THAT 
  OLD VERSIONS OF ZIPCTRL.CPX AND HDDRCONF.CPX ARE REPLACED BY THE CURRENT  
  VERSIONS. (7.81)
- SCSI Initiator identification is now required. If no SCSI-ID has been 
  set for the TT/Falcon ("Boot Parameters"), HDDRIVER will use the ID 7 
  automatically. One should note that SCSI-IDs must be unique, i.e. may 
  not be duplicated. (7.81)
- Besides pressing the [Alternate] key when launching the program, the 
  language of the HDDRUTIL user interface may be switched between German 
  and English by passing "-g" or "--german" or respectively "-e" or 
  "--english" at program start. (7.82)
- As an additional safety measure, it is a prerequisite for background-DMA 
  transfer on TTs and Falcons that the option "SCSI Processor Device" is 
  switched on. (7.82)
- If possible, a new installation of HDDRIVER adopts the settings of a 
  previously installed version without further queries. (7.83)
- HDDRUTIL supports installation of partitions in the FAT32 format. For 
  this it is sufficient to enter for TOS-compatible partition types "F32" 
  or for creating PC-compatible partitions the type "$0b". For partition 
  sizes larger than 2 GByte HDDRUTIL automatically creates FAT32 
  partitions. (7.90)
- HDDRCONF.CPX now displays besides the Additional Sense Code for "Last 
  Error" also the Additional Sense Code Qualifier. (7.90)
- Error in Bus Rescan on the Milan removed that resulted in particular 
  in the computer hanging when starting SoundPool's CD-Recorder. (7.93)
- HDDRIVER and all its tools now support all platforms for which a SCSI 
  Driver exists. So besides Atari and Milan also MagiCMac and MagiCPC. 
  Under MagiCMac/MagiCPC, HDDRIVER is installed by HDDRUTIL in the AUTO 
  folder of drive C: and must be started after the SCSI Driver for these 
  platforms (see below). (8.00)
- On the Milan the communication between HDDRIVER and SCSI Driver for PCI 
  SCSI no longer takes place via a proprietary interface, but via the SCSI 
  Driver. (8.00)
- Faster Verify with devices that do not support Verify with ByteCheck. 
  (8.00)
- Extended ID-check. This now takes into account all busses for which a 
  SCSI Driver exists, not just the busses 0 to 2. In addition the complete 
  bus names are displayed. (8.00)
- During initialisation of partitions, FAT32 partitions are now supported 
  as well. Before initialisation the partition type should be set to "F32".
  After this one has to select "---" for all fields from the popups during 
  initialisation. (8.00)
- Comprehensive optimisation and clearing up undertaken. Thus HDDRIVER 8 is 
  several KByte smaller than HDDRIVER 7.9, with greater capabilities. The 
  same applies to HDDRUTIL. (8.00)
- Error removed that resulted in HDDRIVER not being installed if at the 
  time of installation an older installation was not present already. The 
  same error resulted in a report during installation under MagiCPC that 
  the root sector could not be read. (8.01)
- When HDDRUTIL is launched, it checks to see that the user has sufficient 
  access rights, and if not outputs an error message. This is relevant 
  under MiNT if a Securelevel > 0 has been set. (8.02)
- Error in SCSI Driver removed that could lead to the computer hanging when 
  reading Audio-CDs. (8.02)
- Wie schon HDDRUTIL berprft nun auch HDDRIVER beim Start die
  Benutzerrechte. (8.03)
- Fehler in HDDRUTIL beseitigt, der bei Platten mit sehr vielen Partitionen
  zu Abstrzen oder falscher Anzeige der Plattenkapazitt beim Partitionieren
  fhren konnte. (8.03)
- Fehler in den SCSI-Routinen fr den Falcon beseitigt, der zu fehlerhaft
  gebrannten Audio-CDs fhrte. (8.03)  

This list encompasses only some of the improvements. The new English manual 
covers HDDRIVER version 8.02.

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

If problems should arise, please consult the manual first, and the Help 
texts of individual dialog windows. From experience this will clear up most 
questions.

Demo versions of HDDRIVER provide information about new versions. The 
current demo version is available via the MausNet as well as the Internet:

Maus KA2, 0721-358887 (HDDRIV??.ZIP)
http://home.nikocity.de/nogfradelt/atari_german.html

And I wish you effective working with HDDRIVER.


    Uwe Seimet, 2nd January 2001
    
******************************************************************************
English translation: Peter West for Atari Workshop    
