uata(7D)																  uata(7D)

NAME

       uata - IDE Host Bus Adapter Driver

SYNOPSIS

       ide@unit-address

       The  uata host bus adapter driver is a nexus driver that supports the ide interface on SPARC platforms. The driver attempts to set the disk
       and ATAPI CD-ROM drive to maximum supported speed. The uata driver supports ultra DMA mode-4 (ATA66).

       Currently, the uata driver supports the CMD646U, Sil680a and Acer Southbridge M5229 IDE controllers. The uata driver supports two  channels
       concurrently with two devices connected per channel.  The devices are logically numbered from 0 to 3:

       0	 Master disk on primary channel.

       1	 Slave disk on primary channel.

       2	 Master disk on secondary channel.

       3	 Slave disk on secondary channel.

       For  ATAPI devices, an ATAPI DRIVE RESET command is issued to facilitate recovery from timeouts and errors. The BSY bit of the drive's sta-
       tus register is polled to check for the drive reset completion. If the drive reset fails, a warning message is displayed and  the  recovery
       process continues. This logic is subject to change.

       To control the maximum time spent waiting for the ATAPI drive reset to complete, the atapi-device-reset-waittime tunable property is avail-
       able through the /kernel/drv/uata.conf file. The default and maximum/minimum values are shown below. Please see	/kernel/drv/uata.conf  for
       more info.

       Default value:	 3000000
       Minimum value:	 20
       Maximum value:	 3000000

       The atapi-device-reset-waittime property units are in microseconds.

       /kernel/drv/uata

	   32-bit ELF kernel module.

       /kernel/drv/uata.conf

	   Driver configuration file.

       prtconf(1M), driver.conf(4), attributes(5)

       X3T10 ATA-4 specifications

       In addition to being logged, the following messages may appear on the system console:

       ddi_get_iblock_cookie failed.

	   The driver could not obtain the interrupt cookie. The attach may fail.

       Drive not ready before set_features.

	   Indicates  a  fatal	problem.  The  drives are not ready to be programmed and features cannot be set. (During the driver initialization
	   process, the driver must set the features for the drive, including dma and pio).

       Error set after issuing Set Feature command.

	   Indicates a fatal problem. The driver's error bit was set after the set feature command was issued. (During the  driver  initialization
	   process, the driver must set the features for the drive, including dma and pio).

       Interrupt not seen after set_features.

	   Indicates a fatal problem with the drive. Features cannot be set.

       ata_controller - set features failed.

	   Indicates a fatal problem with the drive. Features cannot be set.

       ? target <number> lun 0.

	   Displayed at boot up time to indicate that the target <number> was identified, where <number> is a decimal value.

       resid

	   Residual number of bytes in data transfer and the I/O operation could not be finished completely.

       ghd_timer_newstate: HBA reset failed.

	   Generally indicates a fatal condition. I/O operation cannot be  completed following reset of the channel.

       timeout: <message> chno =<number> target=<number>.

	    A  timeout	occured  because  of   <message> on device (target=<number>) on  channel (chno =<number). Where  <message> could be either
	   early  abort, early timeout, abort request, abort device, reset target or reset bus.

       ata_controller - Drive not ready before command <number>.

	   The drive did not respond before issuing the command  <number> to the controller; command <number> will not be  issued  to  the  drive.
	   (<number>  is  the hexadecimal opcode for the sleep or standby commands, which are issued when the drive transitions between power man-
	   agement states).

       ATAPI drive reset failed for target: <number>;Continuing the recovery process.

	   If this message is displayed after you modify /kernel/drv/uata.conf, try to increase  the  atapi-device-reset-waittime  property  value
	   within the maximum value allowed, otherwise contact Sun support.

       ata_controller - Command <number> failed.

	   Command  <number> failed on the drive. (<number> is the hexadecimal opcode for the sleep or standby commands, which are issued when the
	   drive transitions between power management states).

       ata_controller - Command <number> returned error.

	   The command returned an error.  (<number> is the hexadecimal opcode for the sleep or standby commands, which are issued when the  drive
	   transitions between power management states).

       ata_controller - Cannot take drive <number> to sleep.

	   The	disk  will not transition to sleep state. (Indicates that the driver could not set the device to sleep mode while performing power
	   management functions).

       ata_controller - Cannot reset secondary/primary channel.

	   The disk will not transition from sleep to active state.

       ata_controller - Unsupported Controller Vendor 0x13d0, Device 0x43f1, Revision 0x034.

	   An unsupported ata controller was found on the system and prints <ID>, device id and revision of the controller, where <ID>	represents
	   the hexidecimal vendor ID.

       Changing the mode of targ: <number> to Ultra DMA mode: <number>.

	   For the timedout command, the driver attempts to recover by changing speed to lower values and retrying the command. This message indi-
	   cates to which mode the driver is attempting to re-program the drive, where <number> is a decimal value.

       Changing the mode of targ: <number> to Multi DMA mode: <number>.

	   For the timedout command, the driver attempts to recover by changing speed to lower values and retrying the command. This message indi-
	   cates to which mode the driver is attempting to re-program the drive, where <number> is a decimal value.

       These  messages	are informational and indicate that a timeout occured for a I/O request. The  uata driver recovers from these states auto-
       matically unless there is a fatal error.

								   20 April 2005							  uata(7D)