Stcdone | Ciprico Rimfire 3880 specification

Chapter 4 Command Operation

Page 4 - 24

Example ‘C’ Routines for Command List

BYTE cdb[12];	/* cdb - Command Descriptor Block/
} parameter_block;

/* status_block - a structure used to hold the status information that is returned from

*the adapter. */

typedef struct

{

	DWORD	sb_ident;		/* sb_ident - status block identifier. */
	BYTE	sb_res;		/* sb_res - reserved field. */
	BYTE	sb_status;		/* sb_status - command SCSI status type. */
	BYTE	sb_error;		/* sb_error - error code number. */
	BYTE	sb_flag;		/* sb_flag - command completion flag. */
/* possible values for sb_flag */
#define	ST_CDONE		0x80		/command complete. /
#define	ST_ERROR		0x40		/command error. /
#define	ST_RETRY		0x20		/retry required. /
#define	ST_TRUNCATED		0x10 /* data transfer truncated. */
#define	ST_CONTINUED		0x04 /* block continued from previous. */
	BYTE sb_info[8]		/* sb_info[8] SCSI request sense info. */
	} status_block;
/* clist - a Command List structure
*/
typedef struct
	{
	DWORD	pbin;		/* parameter block IN pointer. */
	DWORD	pbout;		/* parameter block OUT pointer. */
	DWORD	sbin;		/* status block IN pointer. */
	DWORD	sbout;		/* status block OUT pointer. */
	DWORD	number_pbs;		/* number of parameter blocks. */
	DWORD	number_sbs;		/* number of status blocks. */
	DWORD	reserved[2];		/* two RESERVED fields. */
	parameter_blockpblist[NPB];/Parameter Block area. /
	status_block	sblist[NSB};/* Status Block area. */

}command_list; /* Functions: */

/*_______________________________________________________________

* put_parameter_block - A function to add a command to the Command List

*______________________________________________________________*/

void put_parameter_block(pb,clist) parameter_block pb; command_list *clist;

21020285 D

User’s Guide

Image 82

Ciprico Rimfire 3880 manual Stcdone

Contents

Rimfire 3880 Scsi Host Bus Adapter Page Page 21020285 D User’s Guide Preface Organization Organization Initiator Mode Pass-through Commands DescribesOverview of the RF3880 User’s Guide Conventions ConventionsNotational Graphic Graphic Representation of Parameter Block Reference Documents 21020285 D Reference Documents Contents Scsi ID Status Block Format LUN LUN Table of Contents Description of Fields Command Identifier Diagnostic/Self-test 09H Table of Contents Table of Contents Introduction Summary Specifications Index O d u c t O v e r v i e w Buffering scheme Latest Bus SpecificationsAbout Rimfire Design Product Overview About the Rimfire 3880 Design Target Mode Implementation Buffer Management What next? Product Overview What next? R d w a r e E s s e n t i a l s Summary IntroductionHardware Essentials Introduction QLogic FAS Hardware Structure DescriptionIntel 80186XL Pipelined System Interface Data Buffer Hardware Essentials Block DiagramGenerator blocks are part of the PSI Choosing a VMEbus Address Board AddressingChoosing an Address Modifier Hardware Essentials Board Addressing Hardware Essentials Hardware Ports General Hardware Port AddressesOverview of the Ports Hardware Port Addresses Hardware Essentials Hardware Ports General Address Buffer Port Writes Address Buffer PortHardware Essentials Address Buffer Port Address Modifier Field Hardware Essentials Address Buffer Port Control Field Control Field of Address Buffer Port Channel Attention Port Single Command Structure Address FieldsHardware Essentials Channel Attention Port Channel Format Channel Attention Status Port Status Port Reset FormatStatus Port Reset Hardware Essentials Status Port Status Port Error Codes Status Port Error Codes Status Port General Format Status Port General Status Port Catastrophic Error Codes Chapter Hardware Essentials Status Port Reset Port Hardware Essentials Reset Port Descriptions of Port Usage Hardware Essentials Descriptions of Port Usage Hardware Essentials R d w a r e Installation Hardware Installation Introduction Overview Installation Process Step Unpacking Board Hardware Installation Unpacking the BoardShipping Damage Unpacking the Board Hardware Installation Jumpers and Termination Step Jumpers Termination Configuration Jumpers Default Jumper Settings Bus Request/ Grant Jumper Bus Request/Grant and Sysfail Jumpers Sysfail Jumper Addresses Example Base Address Jumper SettingsExample For the Address Modifier Jumper Replacement Fuse Scsi bus Termination Hardware Installation Board Insertion General Steps Hardware Installation Apply power and observe LEDs Power-up SequenceMeaning LED’s Error Conditions Selectable Options Step Configure Connect Scsi DevicesHardware Installation Configure and Connect Scsi Devices Options Scsi Cable Connector Cabling Hardware Installation M m a n d O p e r a t i o n Command Operation Introduction Command Operation What the Adapter must accomplish What the Adapter must accomplish Block BaseParameter Parameter Command Descriptor Block Status Block Format Command Operation Base Status BlockBase Status Block Base Status Block Command Operation Base Status Block Setting up Unit Options Multiple Status Blocks Command Operation Single Command Structure Single Command StructureFormat Single Command Structure Parameter Block Command Operation Single Command Structure Interrupt Bit-meanings of Interrupt Field Using a Single Command Structure Command Operation Using a Single Command Structure Command Operation Some Example Single Commands Some Example Single CommandsExample Start Command List Board-control Command Identifier = 822F4H Command = 01H Interrupt = 0300H 21020285 D User’s Guide Example 2Inquiry Pass-through Command Example Pass-through command PB Command Operation Command Operation Some Example Single Commands Format Command List Structure Command List StructureDescription of the Fields Parameter Block Space Number of Parameter BlocksNumber of Status Blocks Status Block Space Creating Command List Structure Command Operation Creating the Command List Structure Command Operation Using a Command List Structure Using a Command List StructureCommand Guidelines Index Guidelines Adding a Parameter Block Removing a Status Block Example ‘C’ Routines for Command List Command Operation Example ‘C’ Routines for Command List Stcdone Command Operation Example ‘C’ Routines for Command List Command Operation I t i a t o r t h r o u g h D e P a s s C o m m a n d s Initiator Mode Pass-through Commands Introduction Introduction Summary Target ID Command FormatInitiator Pass- through Parameter Block Format Address Modifier Bit-meanings of Flags-1 Field Example DAT and DIR bit settings Setting DBV DAT and DIR Bits Using Table ValuesDIR and DAT Settings, Vendor-unique Table of DAT DIR Automatic Settings DAT and DIR Automatic Settings 4EH Initiator Mode Pass-through Commands Bit-meanings of Flag-2 Field Flags-2Meaning of TAG Opts Bits VME Memory Address Scsi Command Descriptor BlockTransfer Count Pass-through Message Parameter Block Message FormatMessage Code Scsi Pass-through Status Block Description of FieldsBit-meanings of Flags Field Error Bit-meanings of Scsi Status Field Scsi Status Field during Unexpected Scsi PhaseMeaning of Status Byte Code Three signals. This is described below Meaning of Status Byte Unexpected Phase Up to 32 Sequential Sense Bytes Default Ordering of Sense BytesOrdering of 1st 16 Sequential Sense Bytes Example of Selected Sense Bytes Initiator Mode Pass-through Commands R g e t t h r o u g h D e P a s s C o m m a n d s Target Mode Pass-through Commands Introduction What is Target Mode? Target Mode Pass-through Commands Overview of Target Mode Adapter must have a means of handling Scsi protocol issues Target Mode Pass-through CommandsWhat must the adapter accomplish in Target Mode? Target Mode Enable Command Overview Special Target Mode CommandsNew commands Target Mode Disable Command Command Descriptor Block Group Codes Scsi Command Descriptor Block Groups Sequence Events Enabling Target Mode Command OperationTarget Mode Pass-through Commands Command Operation Sequence Events Receiving a Command From an Initiator Sequence of Events Responding to an Initiator Target Selection Data Structure Target Selection Data Structure Meaning of Flags Field Meaning of Scsi Flags Field Initiator Identifier Command Descriptor Block LengthIdentify Message Received Message Bytes Received Semaphore Field Target Mode Response Parameter Block Target Mode Response CommandInitiator ID ⇒ Target Mode Response command Meaning of Response Control Flags Field Message Byte Status or 1st Message Byte First TM Response Command Status Block Target Mode Response Command Status BlockSecond TM Response Command Status Block Meaning of Status Block Flags Field Meaning of Command Status Flags Field Target Mode Error Sequence Codes Message Byte Received A r d c o n t r o l C o m m a n d s Board-control Commands Introduction Using the Reference Board-control Commands Using the Reference General Status Block Format Board-control Commands General Status BlockGeneral Status Block General Status Block Board-control Commands List of Commands List of CommandsBoard-control Commands Command List Memory Address Board-control Commands Start Command List 01HStart Command List Parameter Block Adapter ID Board-control Commands Start Command List 01H Interrupt Command Code Board-control Commands Stop Command List 02H Stop Command List Parameter Block Identify Command Parameter Block Board-control Commands Identify 05HIdentify 05H Engineering Revision Identify Command Status BlockIdentify Command Status Block Firmware Revision Adapter Scsi ID Bits Board-control Commands Identify 05H Option FlagsOption Flags Field Identify Status Block Day, Month, Year Board Statistics Command Parameter Block Board-control Commands Board Statistics 06HBoard Statistics 06H Board-control Commands Board Statistics 06H Options Options Field Target Mode Selection Count Total Commands ProcessedTotal Scsi Commands issued to an ID Statistics Data Structure General Options Command Parameter Block Command Format Description of FieldsBoard-control Commands General Options 07H General Options 07H Select Flags Bus ThrottleBus Throttle Field Values Select Flags Byte Command code for this command is 07H Unit Options 08H Board-control Commands Unit Options 08HUnit Options Command Parameter Block Unit Scsi ID Retry Control Board-control Commands Unit Options 08H Disconnect Time-outRetry Limit Retry Control Unit Flags Select Time-outUnit Flags Initiator Mode Sense Count Selected Sense Bytes Example Use of Selected Sense Bytes Fields Example Selection of Sense Bytes Diagnostic/Self-test Parameter Block Diagnostic/ Self-test 09HBoard-control Commands Diagnostic/Self-test 09H Diagnostics Command Test Flags Field Command code for this operation is 09H Flags Byte Diagnostic Command Status BlockBit-meanings of Flags Byte in Status Block Target Mode Enable Parameter Block Target Mode Enable 0AHBoard-control Commands Target Mode Enable 0AH Pointer to the Target Selection Data Structure Meaning of Selection Interrupt Field Target Mode Disable Parameter Block Target Mode Disable 0BHBoard-control Commands Target Mode Disable 0BH Meaning of Flags-1 Field Abort 0DH Board-control Commands Abort 0DHCommand Identifier of CMD to be Aborted Abort Parameter Block Board-control Commands Scsi Hard Reset 10H Scsi Hard Reset 10HScsi Hard Reset Parameter Block Board-control Commands Board Information 15H Board Information 15H Board Information Options Field Board-control Commands Board Information 15H OptionsBoard Information Data Structure Board Information Data Structure Board Information Select Flags Field Board-control Commands Board Information 15H Bus Throttle Board-control Commands Board Information 15H Option Flags RST Reset Jumper Scsi Cfig Block Board-control Commands Board Information 15H TerminationAdapter Base Model # Per Target Device Flags Per Target Retry LimitPer Target Sense Count Bit-meanings of Device Flags Field Per Target Synch Period Per Target Width Per Target Selected Sense Bytes Extended Board Statistics 16H Board-control Commands Extended Board Statistics 16HExtended Board Statistics Parameter Block Board-control Commands Extended Board Statistics 16H Options Extended Board Options Field Per Scsi Target Number of Commands Total Commands IssuedNumber of Scsi Parity Errors Extended Statistics Data Structure Per Scsi Target Queue Full Count Board-control CommandsPer Scsi Target Maximum Queued Extended Unit Options 18H Board-control Commands Extended Unit Options 18HExtended Unit Options Parameter Block Extended Unit Options Data Structure Description of Fields Extended Unit Options Data Structure Bit-meanings of Retry Control Field Board-control Commands Extended Unit Options 18H Unit Flags Unit Flags of Extended Unit Options Board-control Commands Extended Unit Options 18H Selected Sense Bytes T a i l s o f U s a g e Details of Usage Introduction Example of Memory Differences Need for SwappingDetails of Usage Byte and Word Swapping Variations in Intel and Motorola Memory Pass-through command Parameters Intel Ordering Motorola Ordering RF3880 Swapping Options Command Structure SwappingIntel Ordered Parameter Block Sharing Tapes Data SwappingDual Initiators Queuing How to UseTagged Tagged Meaning of Flags-2 Field Details of Usage Tagged Queuing Choose a tag messageRF3880 sends the tag message Queue Full Status UsageQueue Tag Numbers Message Reject Scsi Bus Reset Handling Target Mode Usage Scsi Protocol HandlingSelection Queue Target Mode Disable Command Handling Abort Command Handling Synchronous Data Transfer Requests Wide Data Transfer Requests Initiator-detected Error messages Parity error conditionsMessage parity errors Target Routines Message Handling Disconnect PrivilegeMessage Bytes Received from the Initiator 21020285 D User’s Guide User’s Guide 21020285 D Details of Usage Error codes Appendix a Error Codes Introduction Status Block Error CodesCodes Reported in Status Block and Status Port Appendix a Error Codes Summary Error Codes Appendix a Error Codes 2BH A1H Catastrophic Error Codes Status Port Error CodesAppendix a Error Codes Status Port Error Codes Self-test Error Codes Diagnostic Command Self-test Status Port Error Codes 8CH B l e s a n d C o n n e c t o r s Appendix B Cables and Connectors Introduction Cable Connector Pin-outs for the RF3886 ConnectorAppendix B Cables and Connectors Scsi Connector Maximum Cable Length Appendix B Cables and Connectors VMEbus Connector Pinouts VMEbus Connector PinoutsP1 Connector P2 Connector Retry Appendix B Cables and Connectors Specification s Appendix C Specifications Introduction Appendix C Specifications SpecificationsSpecifications for the Rf3880 Appendix C Specifications 21020285 D User’s Guide Fault s Appendix D Defaults Introduction Hardware Defaults Jumpers Hardware DefaultsAppendix D Defaults Hardware Defaults Defaults for Hardware Ports Appendix D Defaults DefaultsCommand Defaults TAG Appendix D Defaults S i g n D i f f e r e n c e s Appendix E Design Differences Introduction Scatter/Gather Operations Features no longer SupportedAppendix E Design Differences Features no longer Supported Byte and Word Swapping of Data Width of Data Transfers on the VMEbus Status Port Error Codes and Test FlagsAppendix E Design Differences Implementation Differences Extended Scsi ID’s Block Mode Transfers Scsi Data Widths How to Maximize Performance Odd-byte Addressing D e Index User’s Guide 21020285 D PSI Scsi ID Index Page 21020285 D