Manuals / Ciprico / Computer Equipment / Network Card

Ciprico Rimfire 3880 manual Board-control Commands General Status Block

Models: Rimfire 3880

1 230

Download 230 pages 41.83 Kb

Page 128

Chapter 7 Board-control Commands

Page 7 - 4

General Status Block

General Status Block

General

Status Block

Format

When a Board-control command does not return a special type of Status Block, it is assumed that its Status Block will take the general format. That format is described here for reference.

The format of the Status Block returned by most Board-control commands takes this form:

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

00H		Command Identifier

04H	Reserved		Error	Flags

08H		Reserved

0CH
0CH

Table 57: General Status Block

Description of Fields

Note

The Flags byte returned in the Status Block of a Board-control command reserves the bits other than ERR and CC. However, some of the reserved bit fields are used in the Flags byte returned in the Status Block of a Pass-through command. See Chapter 5 and 6 for more information.

Following is a brief description of each of the fields used to return General Status:

Command Identifier

This value is used to match a Status Block to its Parameter Block.

Flags

This field can be polled to ascertain whether, and in what condition, a command completed. It has this format:

BITS

7	6	5	4	3	2	1	0

CC	ERR	0	0	0	0	0	0

Table 58: Bit-meanings of Flags Field

ERR Error Status - Identifies when a command completes with an error.

0 ⇒ No error occurred.

1 ⇒ An error occurred.

CC Command Complete - Indicates whether a command has finished.

0 ⇒ Command not complete.

1 ⇒ Command complete.

Error

When an adapter-detected error occurs, this byte contains an error code to describe the condition. See Appendix A.

21020285 D

User’s Guide

Image 128

Ciprico Rimfire 3880 manual Board-control Commands General Status Block

Contents

Rimfire 3880 Scsi Host Bus Adapter Page Page 21020285 D User’s Guide Preface Organization Overview of the RF3880 User’s Guide Initiator Mode Pass-through Commands DescribesOrganization Conventions Notational GraphicConventions Graphic Representation of Parameter BlockReference Documents 21020285 D Reference DocumentsContents 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 Latest Bus Specifications About Rimfire DesignBuffering scheme Product Overview About the Rimfire 3880 DesignTarget Mode Implementation Buffer ManagementWhat next? Product Overview What next?R d w a r e E s s e n t i a l s Hardware Essentials Introduction IntroductionSummary Hardware Structure Description Intel 80186XLQLogic FAS Pipelined System Interface Data BufferGenerator blocks are part of the PSI Block DiagramHardware Essentials Board Addressing Choosing an Address ModifierChoosing a VMEbus Address Hardware Essentials Board AddressingHardware Port Addresses Overview of the PortsHardware Essentials Hardware Ports General Hardware Port AddressesHardware Essentials Hardware Ports General Address Buffer Port Hardware Essentials Address Buffer PortAddress Buffer Port Writes Address Modifier FieldHardware Essentials Address Buffer Port Control Field Control Field of Address Buffer PortHardware Essentials Channel Attention Port Single Command Structure Address FieldsChannel Attention Port Channel Format Channel AttentionStatus Port Reset Format Status Port ResetStatus Port Hardware Essentials Status PortStatus Port Error Codes Status Port Error CodesStatus Port General Format Status Port GeneralStatus Port Catastrophic Error Codes Chapter Hardware Essentials Status PortReset Port Hardware Essentials Reset PortDescriptions of Port Usage Hardware Essentials Descriptions of Port UsageHardware Essentials R d w a r e Installation Hardware Installation Introduction Overview Installation Process Shipping Damage Unpacking the Board Hardware Installation Unpacking the BoardStep Unpacking Board Hardware Installation Jumpers and Termination Step Jumpers TerminationConfiguration Jumpers Default Jumper SettingsBus Request/ Grant Jumper Bus Request/Grant and Sysfail JumpersSysfail JumperExample Base Address Jumper Settings ExampleAddresses For the Address Modifier JumperReplacement Fuse Scsi bus TerminationHardware Installation Board Insertion General StepsMeaning LED’s Power-up SequenceHardware Installation Apply power and observe LEDs Error Conditions Step Configure Connect Scsi Devices Hardware Installation Configure and Connect Scsi DevicesSelectable Options OptionsScsi Cable Connector CablingHardware 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 accomplishBase ParameterBlock ParameterCommand Descriptor Block Command Operation Base Status Block Base Status BlockStatus Block Format Base Status BlockCommand Operation Base Status Block Setting up Unit Options Multiple Status BlocksSingle Command Structure Format Single Command StructureCommand Operation Single Command Structure Parameter BlockCommand Operation Single Command Structure Interrupt Bit-meanings of Interrupt FieldUsing a Single Command Structure Command Operation Using a Single Command StructureSome Example Single Commands Example Start Command List Board-controlCommand Operation Some Example Single Commands Command Identifier = 822F4HCommand = 01H Interrupt = 0300H21020285 D User’s Guide Example 2Inquiry Pass-through Command Example Pass-through command PBCommand Operation Command Operation Some Example Single Commands Description of the Fields Command List StructureFormat Command List Structure Number of Parameter Blocks Number of Status BlocksParameter Block Space Status Block SpaceCreating Command List Structure Command Operation Creating the Command List StructureUsing a Command List Structure Command GuidelinesCommand Operation Using a Command List Structure Index GuidelinesAdding a Parameter Block Removing a Status Block Example ‘C’ Routines for Command List Command Operation Example ‘C’ Routines for Command ListStcdone 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 SummaryCommand Format Initiator Pass- through Parameter Block FormatTarget ID Address ModifierBit-meanings of Flags-1 Field DIR and DAT Settings, Vendor-unique Setting DBV DAT and DIR Bits Using Table ValuesExample DAT and DIR bit settings Table of DAT DIR Automatic Settings DAT and DIR Automatic Settings4EH Initiator Mode Pass-through Commands Meaning of TAG Opts Bits Flags-2Bit-meanings of Flag-2 Field Transfer Count Scsi Command Descriptor BlockVME Memory Address Message Code Message FormatPass-through Message Parameter Block Bit-meanings of Flags Field Description of FieldsScsi Pass-through Status Block Error Meaning of Status Byte Code Scsi Status Field during Unexpected Scsi PhaseBit-meanings of Scsi Status Field Three signals. This is described below Meaning of Status Byte Unexpected PhaseOrdering of 1st 16 Sequential Sense Bytes Default Ordering of Sense BytesUp to 32 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 ModeWhat must the adapter accomplish in Target Mode? Target Mode Pass-through CommandsAdapter must have a means of handling Scsi protocol issues Overview Special Target Mode Commands New commandsTarget Mode Enable Command Target Mode Disable CommandCommand Descriptor Block Group Codes Scsi Command Descriptor Block GroupsTarget Mode Pass-through Commands Command Operation Command OperationSequence Events Enabling Target Mode Sequence Events Receiving a Command From an Initiator Sequence of Events Responding to an Initiator Target Selection Data Structure Target Selection Data StructureMeaning of Flags Field Meaning of Scsi Flags Field Command Descriptor Block Length Identify Message ReceivedInitiator Identifier Message Bytes ReceivedSemaphore Field Initiator ID Target Mode Response CommandTarget Mode Response Parameter Block ⇒ Target Mode Response command Meaning of Response Control Flags Field Message Byte Status or 1st Message ByteSecond TM Response Command Status Block Target Mode Response Command Status BlockFirst TM Response Command Status Block Meaning of Status Block Flags Field Meaning of Command Status Flags Field Target Mode Error Sequence Codes Message Byte ReceivedA 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 ReferenceBoard-control Commands General Status Block General Status BlockGeneral Status Block Format General Status BlockBoard-control Commands List of CommandsBoard-control Commands List of Commands Board-control Commands Start Command List 01H Start Command List Parameter BlockCommand List Memory Address Adapter IDBoard-control Commands Start Command List 01H Interrupt Command CodeBoard-control Commands Stop Command List 02H Stop Command List Parameter BlockIdentify 05H Board-control Commands Identify 05HIdentify Command Parameter Block Identify Command Status Block Identify Command Status BlockEngineering Revision Firmware RevisionBoard-control Commands Identify 05H Option Flags Option Flags Field Identify Status BlockAdapter Scsi ID Bits Day, Month, YearBoard Statistics 06H Board-control Commands Board Statistics 06HBoard Statistics Command Parameter Block Board-control Commands Board Statistics 06H Options Options FieldTotal Commands Processed Total Scsi Commands issued to an IDTarget Mode Selection Count Statistics Data StructureCommand Format Description of Fields Board-control Commands General Options 07HGeneral Options Command Parameter Block General Options 07HBus Throttle Bus Throttle Field ValuesSelect Flags Select Flags ByteCommand code for this command is 07H Board-control Commands Unit Options 08H Unit Options Command Parameter BlockUnit Options 08H Unit Scsi IDBoard-control Commands Unit Options 08H Disconnect Time-out Retry LimitRetry Control Retry ControlUnit Flags Select Time-outUnit Flags Initiator Mode Sense CountSelected Sense Bytes Example Use of Selected Sense Bytes Fields Example Selection of Sense BytesDiagnostic/ Self-test 09H Board-control Commands Diagnostic/Self-test 09HDiagnostic/Self-test Parameter Block Diagnostics Command Test Flags FieldCommand code for this operation is 09H Bit-meanings of Flags Byte in Status Block Diagnostic Command Status BlockFlags Byte Target Mode Enable 0AH Board-control Commands Target Mode Enable 0AHTarget Mode Enable Parameter Block Pointer to the Target Selection Data StructureMeaning of Selection Interrupt Field Target Mode Disable 0BH Board-control Commands Target Mode Disable 0BHTarget Mode Disable Parameter Block Meaning of Flags-1 FieldBoard-control Commands Abort 0DH Command Identifier of CMD to be AbortedAbort 0DH Abort Parameter BlockScsi Hard Reset Parameter Block Scsi Hard Reset 10HBoard-control Commands Scsi Hard Reset 10H Board-control Commands Board Information 15H Board Information 15HBoard-control Commands Board Information 15H Options Board Information Data StructureBoard Information Options Field Board Information Data StructureBoard Information Select Flags Field Board-control Commands Board Information 15H Bus Throttle Board-control Commands Board Information 15H Option Flags RST Reset JumperAdapter Base Model # Board-control Commands Board Information 15H TerminationScsi Cfig Block Per Target Retry Limit Per Target Sense CountPer Target Device Flags Bit-meanings of Device Flags FieldPer Target Synch Period Per Target Width Per Target Selected Sense BytesExtended Board Statistics Parameter Block Board-control Commands Extended Board Statistics 16HExtended Board Statistics 16H Board-control Commands Extended Board Statistics 16H Options Extended Board Options FieldTotal Commands Issued Number of Scsi Parity ErrorsPer Scsi Target Number of Commands Extended Statistics Data StructurePer Scsi Target Maximum Queued Board-control CommandsPer Scsi Target Queue Full Count Extended Unit Options Parameter Block Board-control Commands Extended Unit Options 18HExtended Unit Options 18H Extended Unit Options Data Structure Description of Fields Extended Unit Options Data StructureBit-meanings of Retry Control Field Board-control Commands Extended Unit Options 18H Unit Flags Unit Flags of Extended Unit OptionsBoard-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 Need for Swapping Details of Usage Byte and Word SwappingExample of Memory Differences Variations in Intel and Motorola MemoryPass-through command Parameters Intel Ordering Motorola OrderingIntel Ordered Parameter Block Command Structure SwappingRF3880 Swapping Options Dual Initiators Data SwappingSharing Tapes How to Use TaggedQueuing TaggedRF3880 sends the tag message Details of Usage Tagged Queuing Choose a tag messageMeaning of Flags-2 Field Usage Queue Tag NumbersQueue Full Status Message RejectSelection Queue Target Mode Usage Scsi Protocol HandlingScsi Bus Reset Handling Target Mode Disable Command Handling Abort Command Handling Synchronous Data Transfer RequestsWide Data Transfer Requests Parity error conditions Message parity errorsInitiator-detected Error messages Target RoutinesMessage Bytes Received from the Initiator Disconnect PrivilegeMessage Handling 21020285 D User’s Guide User’s Guide 21020285 D Details of Usage Error codes Codes Reported in Status Block and Status Port Status Block Error CodesAppendix a Error Codes Introduction Appendix a Error Codes Summary Error CodesAppendix a Error Codes 2BHA1H Appendix a Error Codes Status Port Error Codes Status Port Error CodesCatastrophic Error Codes Self-test Error Codes Diagnostic Command Self-test Status Port Error Codes 8CHB l e s a n d C o n n e c t o r s Appendix B Cables and Connectors Introduction Connector Appendix B Cables and Connectors Scsi ConnectorCable Connector Pin-outs for the RF3886 Maximum Cable LengthP1 Connector VMEbus Connector PinoutsAppendix B Cables and Connectors VMEbus Connector Pinouts P2 Connector RetryAppendix B Cables and Connectors Specification s Appendix C Specifications Introduction Specifications for the Rf3880 SpecificationsAppendix C Specifications Appendix C Specifications 21020285 D User’s Guide Fault s Appendix D Defaults Introduction Hardware Defaults Appendix D Defaults Hardware DefaultsHardware Defaults Jumpers Defaults for Hardware PortsCommand Defaults DefaultsAppendix D 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 Features no longer Supported Appendix E Design Differences Features no longer SupportedScatter/Gather Operations Byte and Word Swapping of DataStatus Port Error Codes and Test Flags Appendix E Design Differences Implementation DifferencesWidth of Data Transfers on the VMEbus Extended Scsi ID’sBlock Mode Transfers Scsi Data WidthsHow to Maximize Performance Odd-byte AddressingD e Index User’s Guide 21020285 D PSI Scsi ID Index Page 21020285 D