Single Command Structure, Parameter Block | Ciprico Rimfire 3880

Chapter 4 Command Operation

Single Command Structure

Page 4 - 9

Single

Command

Structure

There are two ways to issue a command to the RF3880 adapter. The simplest method involves the use of the Single Command structure. This 52-byte structure combines a Parameter Block and a Status Block into a single structure along with a field that specifies an interrupt level and ID. This Single Command structure is shown below. The important things to remember about the Single Command structure are:

•It is designed to be used for initial set-up.

•The first command you issue to the board after power-up or reset must use this structure.

Format of

Single

Command

Structure

The Single Command structure is illustrated for you below:

	Address			Byte Memory Address
	Offset	Offset +0		Offset +1		Offset +2		Offset +3
		Offset +0		Offset +1		Offset +2		Offset +3

	00H

	04H

	08H			Parameter Block
	0CH	(detail for Initiator Pass-through commands on page 5 - 3,
	10H	see Chapter 7 for details on individual Board-control commands.)

	14H

	18H

	1CH	Reserved					Reserved

	20H				Reserved

	24H			Status Block
	28H			Status Block
	28H
		(detail for Initiator Pass-through status on page 5 - 12,
	2CH	(detail for Initiator Pass-through status on page 5 - 12,
		see Chapter 7 for detail on individual Board-control status.)
	30H
	30H

Table 20: Single Command Structure

Parameter Block

This section of the Single Command structure is where you build a Parameter Block containing information related to the command you wish to execute: Initiator Pass-through or Board-control.

Most of the fields are command-specific; if there is data to transfer, for example, an address, address modifier and transfer count must be provided. For details about the parameter block fields necessary for a Initiator Pass-through command refer to Chapter 5, Initiator Pass-through Commands and a SCSI specification. For details about a Board-control command see Chapter 7, Board- control Commands.

Reserved Fields

Reserved fields must be zeroed. If a non-zero value is permitted in a Reserved block, you may get an error.

User’s Guide

21020285 D

Image 67

Ciprico Rimfire 3880 Format Single Command Structure, Command Operation Single Command Structure, Parameter Block

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