Home / Autodocs / scsi.device
NAME
- HD_SCSICMD
-
issue a SCSI command to the drive
FUNCTION
This command issues a SCSI command to the drive, bypassing the translation from trackdisk to SCSI commands.
INPUTS
- io_Device
-
preset by the call to OpenDevice()
- io_Unit
-
preset by the call to OpenDevice()
- io_Command
-
HD_SCSICMD
- io_Data
-
pointer to a struct SCSICmd
- io_Length
-
sizeof(struct SCSICmd)
- io_Flags
-
0 or IOF_QUICK
- scsi_Data
-
word aligned buffer to be filled or transmitted during the data phase of the scsi command.
- scsi_Length
-
number of bytes to be transfered during the SCSI data phase
- scsi_Actual
-
filled upon return with the actual number of bytes transmitted
- scsi_Command
-
pointer to a word aligned buffer containing the bytes to be transmitted during the SCSI command phase. That is, this buffer contains the SCSI commands to be issued.
- scsi_CmdLength
-
number of bytes to be transmitted during the SCSI command phase, i.e. the byte size of the command.
- scsi_CmdActual
-
filled upon return with the actual number of bytes transfered during the command phase.
- scsi_Flags
-
various flags, such as: SCSIF_WRITE: transfer from RAM to disk SCSIF_READ: transfer from disk to RAM SCSIF_AUTOSENSE: automatically sense error status upon failure
- scsi_Status
-
returned status of the command, see <devices/scsidisk.h>
- scsi_SenseData
-
pointer to a word aligned buffer that is filled with sense data upon failure if the SCSIF_AUTOSENSE flag is set.
- scsi_SenseLength
-
size of the autosense buffer
- scsi_SenseActual
-
actual number of sense bytes returned
RESULT
- io_Error
-
0 for success, or an error code as defined in <devices/trackdisk.h> or <devices/scsidisk.h>
NOTES
The scsi.device may actually not be connected to a SCSI bus at all, but may emulate (some) SCSI commands through appropriate IDE commands. If the connected device speaks ATAPI, then the SCSI commands are directly dispatched as ATAPI commands. Note that ATAPI uses the same command set as SCSI.
However, for non-ATAPI devices, the following table lists which SCSI commands are emulated through ATA commands:
However, for non-ATAPI devices, the following table lists which SCSI commands are emulated through ATA commands:
READ(6) (0x08)
READ(10) (0x28)
WRITE(6) (0x0a)
WRITE(10) (0x2a)
REQUEST_SENSE (0x03)
FORMAT_UNIT(6) (0x04)
TEST_UNIT_READY (0x00)
SEEK(6) (0x0b)
SEEK(10) (0x2b)
READ_CAPACITY (0x25)
MODE_SENSE (0x1a)
INQUIRY (0x12)
REZERO_UNIT (0x01)
VERIFY (0x2f)
RESERVE (0x16)
SEND_DIAGNOSTIC (0x1d)
The following mode pages are emulated through MODE_SENSE:
READ(10) (0x28)
WRITE(6) (0x0a)
WRITE(10) (0x2a)
REQUEST_SENSE (0x03)
FORMAT_UNIT(6) (0x04)
TEST_UNIT_READY (0x00)
SEEK(6) (0x0b)
SEEK(10) (0x2b)
READ_CAPACITY (0x25)
MODE_SENSE (0x1a)
INQUIRY (0x12)
REZERO_UNIT (0x01)
VERIFY (0x2f)
RESERVE (0x16)
SEND_DIAGNOSTIC (0x1d)
The following mode pages are emulated through MODE_SENSE:
Page 3 (Format Device page)
Page 4 (Rigid Disk page)
Page 4 (Rigid Disk page)