uata(7D) Devices uata(7D)NAMEuata - IDE Host Bus Adapter Driver
SYNOPSIS
ide@unit-address
DESCRIPTION
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 sup‐
ports ultra DMA mode-4 (ATA66).
Currently, the uata driver supports the CMD646U, Sil680a and Acer
Southbridge M5229 IDE controllers. The uata driver supports two chan‐
nels 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 status
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 available
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.
FILES
/kernel/drv/uata
32-bit ELF kernel module.
/kernel/drv/uata.conf
Driver configuration file.
SEE ALSOprtconf(1M), driver.conf(4), attributes(5)
Writing Device Drivers
X3T10 ATA-4 specifications
DIAGNOSTICS
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 pro‐
grammed and features cannot be set. (During the driver initializa‐
tion 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=<num‐
ber>) 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 com‐
mands, which are issued when the drive transitions between power
management states).
ATAPI drive reset failed for target: <number>;Continuing the recovery
process.
If this message is displayed after you modify /ker‐
nel/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> repre‐
sents 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 chang‐
ing speed to lower values and retrying the command. This message
indicates 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 chang‐
ing speed to lower values and retrying the command. This message
indicates 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 automat‐
ically unless there is a fatal error.
SunOS 5.10 20 April 2005 uata(7D)
