This document defines the ATTO FibreBridge services and applications available to customers including:
• ATTO FibreBridge configuration
• ATTO FibreBridge maintenance
• ATTO FibreBridge diagnostics
• System diagnostics
These services are available through the RS-232 interface and Ethernet. In the future, the services may
be accessed through Fibre Channel.Examples in this document will be shown using the RS-232
interface.
ATTO FibreBridge Configuration Services
ATTO FibreBridge configuration services allow configuration of all ATTO FibreBridge interfaces and
general firmware operational parameters. The following is an abbreviated list of ATTO FibreBridge
Configuration Services:
• Serial Port Configuration
• Fibre Channel Port Configuration
• SCSI Port 1 & 2 Configuration
• Firmware Operation
ATTO FibreBridge Maintenance Services
ATTO FibreBridge maintenance services allow the performance of basic maintenance services on the
ATTO FibreBridge. The following is an abbreviated list of ATTO FibreBridge maintenance services:
• SCSI Enclosure Services Information (temperature, P/S status, etc.)
• Restarting firmware (causes power-on diagnostics to be executed)
ATTO FibreBridge Diagnostic Services
ATTO FibreBridge Diagnostic Services allow diagnostic tasks to be performed on the ATTO FibreBridge.
The diagnostics should aid in validating the correct operation of an ATTO FibreBridge. The following is an
abbreviated list of ATTO FibreBridge diagnostic services:
•Viewing Internal Error Log
System Diagnostic Services
System Diagnostic Services allow the use of the ATTO FibreBridge in determining the correct operation of
the complete system or isolating system level problems. The following is an abbreviated list of System
Diagnostic Services:
There are two methods of operation: Menu Interface and Command Line Interface (CLI ). The Menu
Interface is designed for human interface and follows a standard menu / choice model. The Command
Line Interface provides access to ATTO FibreBridge services through ASCII command lines. CLI is
designed primarily for use by applications such as ATTO BridgeTools as well as “power-users”. The
services accessible through CLI are a superset of those available through the Menu Interface.
Initial Display (RS-232)
The initial display, after powering up the unit or restarting the firmware will contain the following
information:
Firmware version mm.mm release date dd mmm yyyy, hh:mm:ss Build zzzz
Power-On Self-Test Completion Status: GOOD.
xx Megabytes of RAM Installed.
1 1.0624 Gb/s Fibre Channel Interface.
2 Differential SCSI Interface Ports.
Power Supply A: OK
Power Supply B: OK
∗ not applicable to the ATTO FibreBridge 2200 R/D.
World Wide Name = xx xx xx xx xx xx xx xx
FibreBridge Name = xxxxxxxx
Internal Temperature = xx
Error Log Contents: NO ERRORS
For help, type HELP. To enable the menu interface, type MENU.
Ready.
This completes the ATTO FibreBridge initial display. Now the ATTO FibreBridge is in the Command Line
Interface mode of operation. Typing the MENU command enters the menu system.
Chapter 3: Command Line Interface (ATTO FibreBridge 2200R/D, 3100R and 3200R)
The command line interface (CLI) provides access to FibreBridge services through a set of ASCII based
command lines. CLI commands may be entered while in CLI mode and Menu Interface mode.
CLI commands are context sensitive and generally follow a standard format.
[Get | Set ] Command [Parameter 1 [Parameter 2 […]]]\n
Note: In this document, braces ([]) indicate a choice of fields and (<>) indicates optional fields. A
subsequent version of this document will clarify the differences between the Get and Set
command syntax. Generally, a Set command requires one additional parameter than the related
Get command.
Commands generally have four types of operation: immediate, get , set and usage. The Get form returns
the value of a parameter or setting. The Set form changes the value of a parameter or configuration
setting. Set and get commands do not take effect until a SaveConfiguration command is carried out.
Immediate commands (signified by the immediate keyword in this document) cause an instantaneous
action to be carried out, and are not preceeded by the ‘get’ or ‘set’ keyword. If the form of operation
cannot be determined, it is assumed to be the Usage form and a brief help message is displayed.
The strings “get” and “set” may be abbreviated by ‘g’ and ‘s’, respectively.
All commands are case insensitive unless specifically noted.
Decimal numbers may be entered as raw numerical input (e.g. 123).
Octal numbers must be preceded by the number 0 (e.g. 0713).
Hexadecimal numbers must be preceded by the C-style 0x prefix (e.g. 0x1FA4).
Quoted strings will be treated as a single parameter for any command which expects character input,
regardless of spaces in the string.
Several commands require a save before their modified parameters take effect. When such a command
is executed an asterisk will appear next to the command-line prompt. Similarly, an asterisk will appear
next to a menu title if any menu parameters have been modified. Save the current configuration to store
any modified parameters and remove the asterisk.
CLI responses can take several forms:
All Responses are followed by the string “Ready.\n”.
Responses to Set Commands are either the error message or “Ready.”
Responses to Get Commands are specified in the Results: field for each command, followed by
“Ready.\n”
The following sections describe commands available through the command line interface.
Specifies whether ACK0 or ACK1 will be returned in response to a Class 2 FC data frame or
Sequence. Enable this option to send ACK0 at the end of a Sequence. Disable this option to
return an ACK1 frame for each data frame.
FcAddressTranslation
Syntax: set FcAddressTranslation [enabled | disabled]
Specifies the Fibre Channel port type to which the ATTO FibreBridge will attempt to login. Set
FcConnMode to ‘loop’ to enable FL_Port logins and FC_AL communications and addressing. Set
FcConnMode to ‘ptp’ to enable Point-to-Point connections (i.e. F_Port fabric connections).
Specifies the maximum number of payload bytes in a Fibre Channel frame. If the frame length is
not specified, the current frame length is displayed. The default frame length is 2,048 bytes.
The FcFullDuplex command is used to enable or disable full duplex mode communications
between the ATTO FibreBridge and Fibre Channel hosts. When this option is enabled the ATTO
FibreBridge may transmit and receive Fibre Channel data simultaneously.
The Fchard command is used to turn on or off Fibre Channel hard address assignment . The
current state of hard addressing is displayed when the optional parameter is missing. The default
is off or soft addressing. Under soft addressing, the ATTO FibreBridge loop address is assigned
during loop initialization.
The FcHardAddress command is used to set the value used as the FC-AL hard address. When
the optional address is not present, the current value used for hard addressing will be displayed.
The FcInitiator command is used to allow the FibreBridge to operate as an initiator on the Fibre
Channel network. This functionality is necessary for features such as Extended Copy /
Serverless Backuo to locate and send commands to Fibre Channel devices.
Specifies the SCSI status value returned when the ATTO FibreBridge is unable to accept the
command due to a temporary lack of internal resources. The factory default setting is to return a
SCSI status of Queue Full.
Specifies the name assigned to the ATTO FibreBridge. This is not the World Wide Name (WWN).
The ATTO FibreBridge name is an eight character name used by applications to identify
individual ATTO FibreBridge units. The specified name will be padded with spaces to a maximum
of eight characters.
Specifies the soft Target ID to be used by the ATTO FibreBridge when addressed by the host.
This ID is only taken from NVRAM when the soft ID enable is set to “enabled” AND when LUN
Translation has been enabled. PORT1 indicates that the displayed value is taken from the value
of the port 1 SCSI initiator ID. NVRAM indicates that the displayed value is taken from NVRAM.
FORCED indicates that FC address translation is enabled while soft IDs are disabled so the
ATTO FiberBridge ID is forced to 0.
FibreBridgeSoftLUNEnable
Syntax: set FibreBridgeSoftLUNEnable [enabled | disabled]
Specifies whether the SCSI ID used by the ATTO FibreBridge when addressed by the host is
determined by the FibreBridgeSoftLUN setting, or the port 0 SCSI IIDsetting. If this is ‘enabled’
and LUN translation is enabled, the FibreBridge will report its Target ID as the value of the
FibreBridgeSoftLUN setting.
FcWWName
Syntax: get FcWWName
Returns:
(terse)"NN NN NN NN NN NN NN NN"
(verbose)FcWWName = "NN NN NN NN NN NN NN NN"
Reports the World Wide Name (WWN) of the FibreChannel interface. Set is not available for this
command. The least Significant 6 bits of the WWN are used as the ethernet MAC address.
Returns:
(terse)nn
(verbose)RequestQueue Length = nn
Specifies the number of entries in the internal Fibre Channel request queue data structure. When
no entry count is specified, the current number of request queue entries will be displayed. When
the specified number of queue entries is zero, the request queue size will be changed to the
factory default value.
Returns:
(terse)nn
(verbose)ResponseQueueLength = nn
Specifies the number of entries in the internal Fibre Channel response queue data structure. If
the number of entries is not specified, the current number of response queue entries will be
displayed. When the specified number of queue entries is zero, the response queue size will be
changed to the factory default value.
ScsiIdSwitch
Syntax: set ScsiIdSwitch [PortNumber [enabled | disabled]]
Specifies whether the SCSI initiator ID for the specified port should be obtained by reading the
external SCSI ID switch or through the value stored in non-volatile RAM.
Specifies the SCSI initiator ID to be used on the specified SCSI port. This field contains either
the hardware switch setting (if ScsiIdSwitch is ENABLED) or the value in NVRAM (if ScsiIdSwitch
is DISABLED.)
ScsiPortResetOnStartup
Syntax: set ScsiPortResetOnStartup [PortNumber [enabled | disabled]]
Specifies whether synchronous SCSI transfers should be negotiated with devices on the specified
SCSI port. The default setting is 'enabled', enabling the ATTO FibreBridge to attempt negotiating
synchronous SCSI transfers with devices supporting synchronous SCSI for maximum
performance.
Should this be extended to enable/disable synchronous transfers based upon the physical
interface (SE, LVD, HVD, Ultra3, etc.).
ScsiPortTaggedQueuing
Syntax: set ScsiPortTaggedQueing [PortNumber [enabled | disabled]]
Specifies whether tagged command queuing is allowed on the SCSI port. The default setting is
on, allowing tagged commands to be sent to devices that support tagged command queuing for
maximum performance.
SCSIPortBusSpeed
Syntax: set ScsiPortBusSpeed [PortNumber [fast | ultra | ultra2]]
This option controls the transfer rate at which the FibreBridge will attempt to negotiate with its
SCSI devices. Choices are Fast SCSI, Ultra SCSI, and Ultra2 SCSI. The Ultra2 option is only
valid if the current FibreBridge has LVD capable SCSI ports. An error will be if this parameter is
selected on a FibreBridge that does not support LVD.
Specifies whether WIDE SCSI transfers should be negotiated. The default setting is on, allowing
wide transfer negotiation with devices supporting wide SCSI transfers.
[ sb ] [ st ] [ sl ] [ Dev Type ] [ Vendor Id ] [ Product Id ]
[Rev.][Serial Number]
[Revision][Serial Number]
Command returns a list of the SCSI devices, which are operational, on the referenced SCSI port.
The line count indicates the number of data lines following. This command is only available on the
ATTO FibreBridge 3200R when they use the latest version of firmware.
Configures the baud rate for the ATTO FibreBridge RS-232 serial port . The number of data bits
per character is fixed at 8 with no parity. The serial port supports the following baud rates: 2400,
9600, 19200, 38400, 57600 and 115200. The factory default baud rate is 9600.
Configures the number of stop bits per character for the ATTO FibreBridge RS-232 serial port .
The number of data bits per character is fixed at 8 with no parity. The number of stop bits may be
set to 1 or 2. The factory default is 1 stop bit.
get SerialPortBaudRate
get SerialPortStopBits
SerialPortHandshake
Syntax: set SerialPortHandshake [hard | xon | none]
get SerialPortHandshake
Returns:
(terse)[hard | xon | none]
(verbose)SerialPortHandshake = [hard | xon | none]
Configures the data handshaking method used for controlling the flow between the transmitter
and receiver. Serial port flow control may be managed using hardware flow control, software flow
control (Xon/Xoff) or no flow control. The default setting is no flow control.
Resets the specified SCSI bus. There is no get version of this command.
Temperature
Syntax: get Temperature
Returns:
(terse)xx C
(verbose)Temperature = xx C
Reports the temperature of the unit, in C.
MaxEnclTempAlrm
Syntax: set MaxEnclTempAlrm [5 – 40]
get MaxEnclTempAlrm
Returns:
(terse)xx C
(verbose)MaxEnclTempAlrm = xx C
This option sets/displays the maximum enclosure temperature alarm of the unit in degrees
Celsius. Valid entries are between 5 and 40 degrees and above the current minimum enclosure
temperature alarm.
MinEnclTempAlrm
Syntax: set MinEnclTempAlrm [5 – 40]
get MinEnclTempAlrm
Returns:
(terse)xx C
(verbose)MinEnclTempAlrm = xx C
This option sets/displays the minimum enclosure temperature alarm of the unit in degrees
Celsius. Valid entries are between 5 and 40 degrees and below the current maximum enclosure
temperature alarm.
ATTO FibreBridge Diagnostic Service Commands
The ATTO FibreBridge Diagnostic commands are intended to aid in validating ATTO FibreBridge
operation and diagnosing / isolating ATTO FibreBridge faults.
ErrorLog for ATTO FibreBridge 2100R
Syntax: set ErrorLog clear
get ErrorLog
Returns:[ Error Logs Cleared |
The last error code saved was xx
A xxx type error was detected since last error log clearing
Specific error text ]
Where xxx is : [ 960 |Static Memory | Synchronous DRAM | ISP2100 |
Symbios 876 A | Symbios 876 B | FibreChannel | Software]
and Specific error text is one line of descriptive error text.
Enabling this option will cause the 'Ready' LED on the front panel of the FibreBridge to blink. The
LED will continue to blink until this parameter is disabled.
DispEvent
Syntax: set DispEvent [subsystem][event_level][status]
The DispEvent command sets the switches which control the filtering performed when displaying
events. The switches have the following meanings and possible settings:
[subsystem] switch is a mask that controls which subsystem’s events are displayed.
get IdentifyFibreBridge
get DispEvent
The mask is a byte value with the following bit patterns corresponding to the currently
supported subsystems:
01FCP Processor/i960
Interaction
02SCSI Processor/i960
Interaction
04Ethernet
10GBIC Connector
20NVRAM & Flash
To display the events from several different subsystems, use a mask value equal to
the logical OR of the corresponding subsystem values. To display events from all
subsystems enter the value 3Fh for the mask. The default value is 3Fh.
[event_level] switch is a mask that controls what reporting level events are displayed.
The mask is a byte value with the following bit patterns corresponding to the currently
supported reporting levels:
01Info; general information
02Warning; unexpected
situation/condition
04Critical; operation limited/curtailed
08Failure; hard failure
10Other; otherwise not categorisable
20Debug; ATTO tracking events
To display events from several different reporting levels, use a mask value equal to
the logical OR of the corresponding reporting levels. To display events for all
reporting levels enter the value 3Fh for the mask. The default value is 3Fh.
[status] switch has two values which correspond to the status of the events to be
displayed. The value all dictates that all events, regardless of their status values are
displayed. The value ngood dictates that only events with a status value other than
good are displayed. This switch only pertains to those events for which there is a
status value. The default value is all.
LogEvent
Syntax: set LogEvent [enabled | disabled]|[[subsystem][ event_level][status]]
Returns:
(terse)[enabled | disabled] XX XX [all | ngood]
(verbose)LogEvent=[enabled|disabled]SubSys:XXLvl:XXStatus:[all|ngood]
The LogEvent command sets the switches which control the filtering performed when logging
events. The switches have the following meanings and possible settings:
get LogEvent
[enabled | disabled] switch controls whether or not events logging is enabled or
disabled. The default value is disabled.
[subsystem] switch for LogEvent is the same as that described for DispEvent in the
previous section.
[event_level] switch for LogEvent is the same as that described for DispEvent in the
previous section.
[status] switch for LogEvent is the same as that described for DispEvent in the previous
section.
[type] switch for LogEvent is the same as that described for DispEvent in the previous
section section.
ClearEvent (Immediate)
Syntax: ClearEvent
Returns:n/a
The ClearEvent command clears the contents of the event log.
Returns:The contents of the event log, as filtered by the current switch settings
manipulated via DispEvent.
The DisplayEvent command results in a dump of the current contents of the event log to the
display. The log is filtered by the current switch settings as described in the DispEvent section. If
the optional all delimiter is provided, the display filtering is temporarily suspended and all logged
events are displayed regardless of the current event filter switch settings.
Ethernet Configuration Commands(ATTO FibreBridge 3100R and 3200R)
The ethernet configuration commands are meant to configure the ethernet and TCP/IP parameters.
Selecting DHCP allows the ATTO FibreBridge to request an IP address from the network. It
requires that the bridge be attached to a network with at least one DHCP server.
Set/Display the current IP address of the ATTO FibreBridge. Note that the ATTO FibreBridge’s
local hostname is the same as the FibreBridge Name specified above. If IPDHCP is enabled,
then the get command reports the current IP address assigned by the nameserver.
Set/Display the current subnet mask. If IPDHCP is enabled, then the get command reports the
current IP gateway assigned by the nameserver.
EthernetSpeed
Syntax: set EthernetSpeed [10 | 100 | auto]
get EthernetSpeed
Returns
(terse)[10 | 100 | auto ([10|100|UNKNOWN])]
(verbose)EthernetSpeed = [10 | 100 | auto ([10|100|UNKNOWN])]
Set/Display the ethernet speed. Auto will auto-negotiate speed (default).
If Auto is enabled the value in parentheses indicates the current speed of the ethernet
connection.
Device Version = xxxx
Device Build = xxxx
Build Date = Month Day Year 'Build Time'
NVRAM Revision = xx
CLI Revision = x.xx
FC Firmware Revision = x.xx.xx
SCSI Port 1 = "[SE | HVD | LVD]"
SCSI Port 2 = "[SE | HVD | LVD]"
This option displays version numbers and other product information for key components within
the ATTO FibreBridge.
Help (Immediate)
Syntax: Help [Command Name]
Returns:
(terse)usage
(verbose)usage + help text…
The Help command displays a list of available commands. When the optional command name is
present, detailed command-specific information will be displayed.
The Menu command turns the menu interface on or off. Turning on the menu interface will cause
the main menu to be displayed. In addition, other parameters will be enabled such as ECHO.
'Menu Disabled' will turn off the menu interface. Menu without any parameters will toggle the
current menu state.
RestoreConfiguration (Immediate)
Syntax: RestoreConfiguration [Default | Saved]
Returns: n/a
The ATTO FibreBridge configuration being edited will be restored to either the factory default
configuration or the configuration last saved into non-volatile memory. Note that this will not
impact the current operating ATTO FibreBridge configuration. This configuration must be saved
for the configuration changes to take effect.There is no get version of this command.
SaveConfiguration (Immediate)
Syntax: SaveConfiguration <Restart | NoRestart>
Returns:[Configuration Saved. |
Restart is necessary….
Do you wish to restart (y/n) ?|
Restarting…]
The configuration image being accessed by these services will be permanently saved in the
ATTO FibreBridge. This new configuration will become the active configuration immediately. If a
firmware restart is required to make the requested changed, the user will be prompted for a
confirmation of the restart. The user can override this confirmation request by indicating the
override value on the command line.
Note that the Restart or NoRestart parameter is optional.
Reservation of the ATTO FibreBridge is implicit: once the configuration image is changed by any
user of services (Serial/Ethernet/Etc.,) the ATTO FibreBridge becomes RESERVED. Executing a
SaveConfiguration, RestoreConfiguration or FcRestart will RELEASE the ATTO FibreBridge so
that other devices may access it.
When the ATTO FibreBridge services interface is reserved, Set commands are unavailable, but
Get commands are available. Note that at least one service interface must be available to the
ATTO FibreBridge at all times. This interface will always report RELEASED status, since it may
issue set commands.
Setting verbose mode will cause the command-line interface to display extended information
about a parameter when the 'help' command is given. Only the parameter value is output when
verbose mode is disabled.
Chapter 4: Menu Interface for ATTO FibreBridge 2200 R/D, 3100R and 3200R
Menu Interface
This section describes the Menu Interface method of accessing ATTO FibreBridge services. The ATTO
FibreBridge service options are accessible using a Command Line Interface (CLI). The CLI is designed
for advanced programmers and integrators. To see a list of available commands type 'help' at the Ready
prompt.
The menu interface provides a user-friendly way of configuring and managing the ATTO FibreBridge
product module and may be invoked at the CLI Ready prompt by typing 'menu'. CLI commands may NOT
be entered while the menu interface is enabled. Typing 'menu' at any menu prompt will return the user
back to the command-line interface. Any parameter modification prompts may be cancelled by pressing
'Enter' at the prompt without typing a value. Confirmation prompts must be answered with 'y' or 'n'.
To access menu options type the letter of the option as it appears on the display followed by a carriage
return or Enter. To return to a previous menu, type 'x' then carriage return or Enter. Note: The ATTO
FibreBridge Services Menu Interface is not case sensitive. (Use of upper or lower case letters is
permitted).
Main Menu
This is the starting point for the Menu Interface. All other menus are descendents of this menu.
FibreBridge Main MenuNotes
AFibreBridge Configuration…Provides option for configuring the
unit
BFibreBridge Maintenance…Provides options for performing
maintenance on the unit
CFibreBridge Diagnostics…Provides options to view or clear
the current error log
DSave / Restore Configuration…Restores the manufacturer’s
default settings
XExit Menu ModeExit the menu and return to the CLI
ATTO FibreBridge Configuration Menu
FibreBridge Configuration MenuNotes
AFibreBridge NamePrompt for FibreBridge name
BFibre Channel Configuration…Provides options for configuring
the Fibre Channel interface
CSCSI Port 1 Configuration…Provides options for configuring
SCSI port 1
DSCSI Port 2 Configuration…Provides options for configuring
SCSI port 2
ESerial (RS-232 ) Port Configuration…Provides options for reconfiguring
the RS-232 interface
FNetwork Configuration…Provides options for configuring
ALIP Fibre Channel PortForce LIP on Fibre Channel port
BDisplay FibreBridge Version InformationDisplay the initial status screen
CRestart FibreBridge FirmwareCause the unit to reload the firmware and restart
the ATTO FibreBridge
DReset SCSI Port 1Force reset on SCSI port 1
EReset SCSI Port 2Force reset on SCSI port 2
XReturn to previous menu…Return to the ATTO FibreBridge main menu
ATTO FibreBridge Diagnostic Menu
FibreBridge Diagnostic MenuNotes
ADisplay Error LogDisplay the current error log entries. Entries in the
log do not necessarily mean that the unit is
damaged or inoperable
BClear Error LogClears the current error log
CIdentify FibreBridgeIdentifies the ATTO FibreBridge in use
XReturn to previous menu…Return to the ATTO FibreBridge main menu
Save / Restore Configuration Menu
Save / Restore Configuration MenuNotes
ASave Configuration ChangesRestart/No Restart Prompt
BRestore Configuration to DefaultConfirmation Prompt
CRestore Configuration to Last SavedConfirmation Prompt
XReturn to previous menu…Return to the FibreBridge Main Menu
Fibre Channel Configuration Menu
Fibre Channel Configuration MenuNotes
AFC-AL Hard Addressing ModeDisplay, Enable or Disable FC-AL hard Addressing
BFC-AL Hard AddressDisplay or set the FC-AL hard address is Hard
Address mode is enabled
CFC-AL Arbitration FairnessDisplay, Enable or Disable Arbitration Fairness
DUnprocessed SCSI Command ReturnsProvides options for configuring SCSI port
1BUSY/QUEUE FULL response
EFibre Channel Frame LengthDisplay or set the Fibre Channel frame length
FPhysical Device Address DescriptorDisplay or set the PDAM descriptor
GLogical Unit Address DescriptorDisplay or set the LUAM descriptor
HVirtual Device Address DescriptorDisplay or set the VDAM descriptor
IFC-AL Address TranslationDisplay, Enable or Disable FC to SCSI Address
Translation
JFibreBridge Soft SCSI ID StatusDisplay, Enable or Disable weather the hardware
or software SCSI ID is used for the ATTO
FibreBridge unit
KFibreBridge SCSI IDDisplay or set the soft SCSI ID of the ATTO
FibreBridge unit. This is the target ID to which the
Service
PFibre Channel Initiator ModeEnable / Disable Initiator Mode
XReturn to previous menu…->FibreBridge Configuration Menu
SCSI Port Configuration Menu
SCSI Port x Configuration MenuNotes
AInitiator ID from Hardware SwitchDisplay, Enable or Disable use of the hardware
SCSI initiator ID for the SCSI bus. Note, this
differs from the ATTO FibreBridge SCSI ID option
which sets the use of a soft or hardware ID of the
ATTO FibreBridge itself
BSCSI Initiator IDDisplay or set the SCSI initiator ID of the SCSI bus
CReset SCSI Bus on StartupDisplay, Enable or Disable weather the SCSI bus
resets on startup of the unit
DTagged Command QueuingDisplay, Enable or Disable use of Tagged
Command Queuing
EWide SCSI TransfersDisplay, Enable or Disable forced (as opposed to
This chapter describes the SCSI commands that are processed by the ATTO FibreBridge.
INQUIRY command
The INQUIRY command requests that information regarding parameters of the target and a component
logical unit is sent to the application client.
If an INQUIRY command is received from an initiator with a pending unit attention condition (i.e., before
the ATTO FibreBridge reports CHECK CONDITION status), the ATTO FibreBridge will perform the
INQUIRY command and will not clear the unit attention condition.
0Peripheral QualifierPeripheral device type
10Reserved
2ISO versionECMA versionANSI version
3AERC0NACAHiSupResponse data format
4Additional length (n-4)
50Reserved
601000000
7000000TCQ0
8(MSB)
Peripheral qualifierThe peripheral qualifier is used with the peripheral device type field to
identify the device currently connected to the logical unit. The peripheral
qualifier field may take on the following values:
000b = The specified peripheral device type is currently
connected to this logical unit. This peripheral qualifier does not
mean that the device is ready for access by the initiator.
001b = The FibreBridge is capable of supporting the specified
peripheral device type on this logical unit. However, the physical
device is not currently connected to this logical unit.
011b = The FibreBridge is not capable of supporting a physical
device on this logical unit. For this peripheral qualifier, the
peripheral device type will be set to 1Fh.
Peripheral device
type
The peripheral device type field indicates the type of peripheral on this
logical unit.
03h = Processor type device. The FibreBridge responds as a
processor type device.
1Fh = Unknown or no device type.
ISO versionThe FibreBridge does not claim compliance with the ISO version of
SCSI. This field will be set to 00b.
ECMA versionThe FibreBridge does not claim compliance with the ECMA version of
SCSI. This field will be set to 00b.
ANSI versionThe ANSI version field will be set to 3h indicating compliance with ANSI
X3.301-1997.
AERCThe Asynchronous event reporting capability field will be set to 0b.
NACAThe Normal ACA Supported bit will be set to 0b.
HiSupThe Hierarchical support bit indicates if the FibreBridge is configured to
implement Hierarchical LUN addressing. See the section on LUN
Address Methods for additional information.
Additional lengthThe additional length field specifies the length in bytes of the
parameters. If the allocation length of the command descriptor block is
too small to transfer all of the parameters, the additional length is not be
adjusted to reflect the truncation.
TCQThe TCQ field will be set to 1b to indicate support for command queuing.
Vendor identificationThe Vendor identification field is set to ‘ATTO’ and padded with spaces.
Product identificationThe Product identification field is set to ‘FibreBridge xxxx’, where xxxx is
the four-digit ATTO model number of the specific FibreBridge.
Product revision levelThe product revision level field is set to the current firmware revision
level. The revision consists of four ASCII characters.
The Peripheral Qualifier and the Peripheral Device Type in the inquiry vital product data pages are
described in the standard Inquiry data format above.
When EVPD (Enable Vital Product Data) is 1, PageCode indicates which page of vital product data is to
be returned. The ATTO FibreBridge supports the following Vital Product Data pages:
PageCodeDescriptionComments
0x00Supported Vital Product Data Page Listreports valid PageCodes
0x82ASCII Implemented Operating Definition Pagesreports Model Information
0x83Device Identification Pagereports World Wide Name
5
...ASCII implemented operating definition description data
N
ASCII implemented operating definition page data is in the form <name>=<value><0>, where <name>
represents the entity name, <value> represents the ATTO FibreBridge model information, and <0>
represents a null separator. The supported names are:
• NAME optional user specified (8 characters) name associated with the ATTO FibreBridge
• Bsoftware build number (4 characters)
• Mtotal memory capacity including software space and data space, expressed in MBs.
• SCSISE (single ended) or DF (differential).
An example of ASCII Implemented Operating Definition page:
The READ BUFFER command is used in conjunction with the WRITE BUFFER command as a
maintenance function for reading and writing microcode and configuration information. The READ
BUFFER command provides access to microcode and configuration parameter storage.
Bit
Byte
76543210
0Operation code (3Ch)
1Reserved010
2Buffer ID
3(MSB)
4
5
Buffer Offset
(LSB)
6(MSB)
7
8
Allocation length
(LSB)
9Control
The function of the command and meaning of the returned data depends upon the contents of the Buffer
ID field. The Buffer ID field identifies a specific buffer within the ATTO FibreBridge from which data will be
transferred. The ATTO FibreBridge will transfer the complete buffer or the allocation length bytes,
whichever is less.
The Buffer Offset field contains the byte offset within the specified buffer from which data will be
transferred. If the specified buffer offset is invalid, the ATTO FibreBridge will return a CHECK
CONDITION status with a sense key of ILLEGAL REQUEST and additional sense code of INVALID
FIELD IN CDB.
If an unsupported Buffer ID code is selected, the ATTO FibreBridge will return a CHECK CONDITION
status with a sense key of ILLEGAL REQUEST and additional sense code of INVALID FIELD IN CDB.
REPORT LUNs command
The REPORT LUNS command requests that the peripheral device logical unit numbers of known logical
units in the ATTO FibreBridge be sent to the host. The REPORT LUNS command shall return information
about only those logical units to which commands may be sent. The REPORT LUNS command will only
be accepted by logical unit number zero.
The Allocation length shall be at least 16 bytes. If the Allocation length is less than 16 bytes, the ATTO
FibreBridge will return a CHECK CONDITION status. The sense key will be set to ILLEGAL REQUEST
and the additional sense data will be set to INVALID FIELD IN CDB.
If the Allocation length is not sufficient to contain the logical unit number values for all configured logical
units, the ATTO FibreBridge will report as many logical unit number values as will fit in the specified
Allocation length. This will not be considered an error.
The ATTO FibreBridge will report the logical unit numbers of configured logical units using the format
shown below.
REPORT LUNS parameter list format
Bit
Byte
0(MSB)
3
4(MSB)
7
76543210
LUN list length (n-7)
Reserved
(LSB)
(LSB)
LUN list
8(MSB)
15
First LUN
(LSB)
::
::
n-7(MSB)
N
Last LUN
(LSB)
The LUN list length will contain the length in bytes of the LUN list that is available to be transferred. The
LUN list length is the number of logical unit numbers reported multiplied by eight. If the allocation length in
the command descriptor block is too small to transfer information about all configured logical units, the
LUN list length value will not be adjusted to reflect the truncation.
The Request Sense command requests that the target transfer sense data to the initiator.
The sense data returned for a FibreBridge command is a subset of the sense data described in the SCSI
standard.
TEST UNIT READY command
The TEST UNIT READY command checks to see if the logical unit is ready. If the logical unit is able to
accept an appropriate medium-access command without returning CHECK CONDITION status, this
command shall return a GOOD status.
The WRITE BUFFER command is used in conjunction with the READ BUFFER command as a
maintenance function for reading and writing microcode and configuration information. The WRITE
BUFFER command allows microcode to be updated and configuration parameters to be modified.
Bit
Byte
76543210
0Operation code (3Bh)
1ReservedMode
2Buffer ID
3(MSB)
4
5
Buffer Offset
(LSB)
6(MSB)
7
8
Parameter list length
(LSB)
9Control
The function of the command and meaning of the returned data depends upon the contents of the Buffer
ID field. The Buffer ID field identifies a specific buffer within the ATTO FibreBridge from which data will be
transferred. The ATTO FibreBridge will transfer the complete buffer or allocation length bytes, whichever
is less.
The Buffer Offset field contains the byte offset within the specified buffer from which data will be
transferred. If the specified buffer offset is invalid, ATTO FibreBridge will return a CHECK CONDITION
status with a sense key of ILLEGAL REQUEST and additional sense code of INVALID FIELD IN CDB.
If an unsupported Buffer ID code is selected, the ATTO FibreBridge will return a CHECK CONDITION
status with a sense key of ILLEGAL REQUEST and additional sense code of INVALID FIELD IN CDB.
Read/Write Buffer buffer id descriptions and usage are provided in the ATTO Technology ATTO
FibreBridge NVRAM Specification. ATTO Technology provides the ATTO BridgeTools GUI-based utility
to facilitate managing the NVRAM parameters.
RECEIVE DIAGNOSTIC RESULTS command
The RECEIVE DIAGNOSTIC RESULTS command is used in conjunction with the SEND DIAGNOSTIC
command as a maintenance function for reading the status of the ATTO FibreBridge and/or results of any
previous SEND DIAGNOSTIC command.
A Page Code Valid (PCV) bit of zero indicates that the most recent SEND DIAGNOSTIC command shall
define the page code used for data returned by this command. A PCV bit of one indicates that the
contents of the Page code field shall define the data returned by this command. Page code values are as
follows:
Page CodeDefinition
00Supported Pages
01Configuration
02Enclosure Status
08Short Status
Pages are defined below:
Supported pages page (See 8.1.1 in T10/1236-D SPC-2)
Byte
0123
0000000Number of
4-nSupported Pages (variable length)
The ‘Supported Pages’ page allows the user to query for valid Page Code numbers.
The ‘Configuration’ page (following) describes the format of the Enclosure status page. There is one
entry in the configuration page for each Element Type described by the Enclosure status page.
Configuration Page
Byte
(decimal)
0123
00100Pg. Length
4Generation Code (Fixed at 00 00 00 00)
80000# Element
Types
Enclosure
Descriptor Len
(m)
12
Bridge WWN
16
20
“ATTO” space padded to right
24
28
32
36
“FibreBridge XXXX” space padded to right, where XXXX is the four-
digit ATTO model number of the specific FibreBridge
002Status Bits000x58
4Generation Code (fixed at 00 00 00 00)
8Overall Status – Device
12Element Status – Device
16Overall Status – Power Supply
20Element Status – Power Supply A
24Element Status – Power supply B
28Overall Status – Temperature Sensor
32Element Status – Temperature Sensor
36Overall Status – SCSI Ports
40Element Status – SCSI Port 1
44Element Status – SCSI Port 2
48Overall Status – Language
52Element Status - Language
56Overall Status – Fibre Port
60Element Status – Fibre Port
64Overall Status – Fibre Chain
68Element Status – Fibre Chain 1
72Element Status – Fibre Chain 2
76Overall Status – POST Code
80Element Status – POST Code
84Overall Control – NVRAM Reset
88Element Control – NVRAM Reset
The Enclosure Status Page contains one entry for each status element reported by the ATTO Fibre
Bridge. (See Element Definitions – Below.)
Enclosure Status Page for ATTO FibreBridge 2200R/D, 3100R and 3200R
Byte
0123
002Status Bits000x58
4Generation Code (fixed at 00 00 00 00)
8Overall Status – Device
12Element Status – Device
16Overall Status – Power Supply
20Element Status – Power Supply A
24Element Status – Power supply B
28Overall Status – Temperature Sensor
32Element Status – Temperature Sensor
36Overall Status – SCSI Ports
40Element Status – SCSI Port 1
44Element Status – SCSI Port 2
48Overall Status – Language
52Element Status - Language
56Overall Status – GBIC Ports
60Element Status – GBIC Port 1
64Element Status – GBIC Port 2
68Overall Status – POST Code
72Element Status – POST Code
76Overall Control – NVRAM Reset
80Element Control – NVRAM Reset
The Enclosure Status Page contains one entry for each status element reported by the ATTO Fibre
Bridge. See Element Definitions – Below.)
Short Status Page
Byte
0123
008Overall Status0000
The Short Status page Contains one Overall Status byte, which contains the same information as the
‘Common Status’ byte of the Overall Status – Device field from the Enclosure Status page.
Slot Address: SCSI ID of this bridge (thumbwheel switch #1).
Ident: Set to indicate the Identification control bit has been set.
Fault Sensed : Set to indicate a fault detected by this bridge.
Fault Reqst: Set to indicate that the RQST FAULT control bit has been set.
Power Supply Element for Status Page
Bit
Byte
76543210
0Common Status
1Reserved
2Reserved00
0
0
3000Off000DC Fail
Off: Set if this power supply is off.
DC Fail: Set if this power supply is not supplying DC Power.
Temperature Sensor Element for Status Page
Bit
Byte
76543210
0Common Status
1Reserved
2Temperature
3ReservedOT
FailureOTWarningUTFailureUTWarning
Temperature : Degrees Celsius-20. (cannot be 0)
OT Failure/Warning: Overtemperature status. Warning occurs at +40C. Error occurs at +50C.
UT Failure/Warning: Under Temperature status. Warning Occurs at +5C. Error occurs at 0C.
SCSI port/transceiver Element for Status Page
Bit
Byte
76543210
0Common Status
1Reserved
2Reserved0
3ReservedDisable
Reserved0Xmit fail
d
Disabled: Indicates that the port has been disabled.
POST Code : 1-byte value stored internally. May indicate an error which has been cleared. Is not cleared
by power-on or soft reset .
Type Error : 1-byte error type. May indicate an error which has been cleared. Is not cleared by poweron or soft reset .
NVRAM Reset Element for Status Page
Bit
Byte
76543210
0Common Status
100
200
300
(status is always 00)
SEND DIAGNOSTIC command
The SEND DIAGNOSTIC command is used as a maintenance function for commanding ATTO
FibreBridge reset , as well as en/disabling various ATTO FibreBridge components.
Bit
Byte
76543210
0Operation code (1Dh)
1ReservedPFReservdSelfTestDevOffLUnitOff
L
2Reserved
3(MSB)Parameter List length
4(LSB)
5Control
A Page Code Valid (PF) bit of one indicates that the parameters conform to the page structure as
specified in the standard. Users of the ATTO FibreBridge should always set PF to 1.
Setting the SelfTest bit in conjunction with the DevOffL bit causes the ATTO FibreBridge to reset itself,
perform power on self-test, then continue operation. To avoid possible command errors in multi-initiator
systems, The ATTO FibreBridge should be RESERVED before issuing a SelfTest Command.
The SEND DIAGNOSTIC parameter list must contain Control data, in the format of the Enclosure Control
page, in order to complete properly. Note that the complete Enclosure Control page must be sent with
every SEND DIAGNOSTIC command.
002Cond. Bits000x48
4Generation Code
8Overall Control – Device
12Element Control – Device
16Overall Control – Power Supply
20Element Control – Power Supply A
24Element Control – Power supply B
28Overall Control – Temperature Sensor
32Element Control – Temperature Sensor
36Overall Control – SCSI Ports
40Element Control – SCSI Port 1
44Element Control – SCSI Port 2
48Overall Control – Language
52Element Control – Language
56Overall Control – Fibre Port
60Element Control – Fibre Port
64Overall Control – Fibre Chain
68Element Control – Fibre Chain 1
72Element Control – Fibre Chain 2
76Overall Control – POST Code
82Element Control – POST Code
86Overall Control – NVRAM Reset
90Element Control – NVRAM Reset
Enclosure Control Page for ATTO FibreBridge 3100R and 3200R
Byte
0123
002Cond. Bits000x48
4Generation Code
8Overall Control – Device
12Element Control – Device
16Overall Control – Power Supply
20Element Control – Power Supply A
24Element Control – Power supply B
28Overall Control – Temperature Sensor
32Element Control – Temperature Sensor
36Overall Control – SCSI Ports
40Element Control – SCSI Port 1
44Element Control – SCSI Port 2
48Overall Control – Language
52Element Control – Language
56Overall Control – GBIC Ports
60Element Control – GBIC Port 1
64Element Control – GBIC Port 2
68Overall Control – POST Code
72Element Control – POST Code
76Overall Control – NVRAM Reset
80Element Control – NVRAM Reset
Generation Code – must be 0.
Every Control Element starts with a Common Control byte. The common control byte is used to choose
which fields to update based on the page. If an element should be ignored by the ATTO FibreBridge, the
Select bit must be 0. Conversely, to tell the ATTO FibreBridge to implement the changes specified in the
Control Element, the Select Bit should be set to 1.
Common Control is defined as follows:
Bit
Byte
0Select
76543210
ReservdDISABLEReservdReserved
SELECT – Set to 1, signals the ATTO FibreBridge that the Control Element should be used to change
ATTO FibreBridge Configruation. Set to 0, signals the ATTO FibreBridge to ignore the Control Element.
DISABLE – used in the Temperature Control Element to stop the ATTO FibreBridge from raising an
error based on over/undertemp status.
For Example, to Disable SCSI Port 1 only, and leave the rest of the configuration the same, All Overall
Control and Element Control Fields should have the Select bit CLEARED, except for the SCSI Port 1
Element, which should have the Select bit SET and the disable bit in byte 3 SET.
Rqst Ident: Causes the device front panel to flash an identification signal.
Rqst Fault: Causes the device front panel to flash a fault signal.
Device Off: Causes the device to perform a software reset .
Temperature Sensor Element for Control Page
Bit
Byte
76543210
0Common Control
1
2
Reserved
3
Common Control-Disable: If Disabled, will not report Warning or Error conditions based on temperature.
SCSI port/transceiver Element for Control Page
Bit
Byte
76543210
0Common Control
1
2
Reserved
3ReservedDisableReserved
ATTO FibreBridge GBIC Connector Element for Control Page (3100R and 3200R only)
Bit
Byte
76543210
0Common Control
1
Reserved
2
3ReservedOnline Mode
Online Mode:00 : Normal - FibreBridge determines Online/Offline status
01 : Force Online - Fibre Channel is always Online
02 : Force Offline - Fibre Channel is disabled until POR
The Tunnel CDB∗ command is a 16 byte Vendor Unique command which allows any 6 or 10 byte CDB to be
tunneled through the FibreBridge LUN to a device residing at a different LUN address. This capability is useful for
accessing SCSI devices when they are not known to the host. The Tunnel CDB can only be issued to the ATTO
FibreBridge device, which, in turn, issues the tunneled CDB to the lun specified in the tunnel CDB.
The Level 1 LUN field contains the 16-bit logical unit number of the device to which the tunneled command is to be
sent. This field should be set to bytes 0 (MSB) and 1 (LSB) of the LUN addresses returned by the REPORT LUNS
command.
76543210
Level 1 LUN
∗Available on firmware versions 1.1 and higher
LSB
The Tunneled CDB bytes contain the Command Descriptor Block being tunneled to the device. The length of the
Tunneled CDB is determined by examining the Group Code field of the operation code in Tunneled CDB Byte 0.
A tunnel CDB not addressed to the ATTO FibreBridge LUN results in a CHECK CONDITION with a sense key of
ILLEGAL REQUEST and additional sense code of INVALID COMMAND OPCODE.
This section provides information on updating the ATTO FibreBridge 2100R flash or nvram
parameters using updater.exe (MSDOS-based utility), SCSI Read Buffer or Write Buffer
commands. The buffer ID identifies the respective field for either updater input or via the
Read/Write Buffer commands. The nvram offset is provided to facilitate interpretation of nvram
contents directly.
Buffer ID nvram offset Buffer Description (default values*)
Consists of 3 hex bytes bb ll tt (bb=busid, ll=lun, tt=target id).
The left hex digit is the bit number of the rightmost field bit in the LUN.
The right hex digit is the number of bits in the field.
11:0x31 - 0x33Logical Unit Addressing Method (default 0x52 0x05 0x84)
Bit 5-7: Reserved.
Bit 4: Translate QUEUE FULL to BUSY, 0 = Disable, 1 = Enable
Bit 2-3: Reserved.
Bit 1: Enable/Disable Bridge Soft Fibre LUN,1 = Enable, 0 = Disable (FBE)
(uses FibreBridge Soft Fibre LUN byte to determine actual ID)
Bit 0: perform/suppress LUN translations, 1 = perform, 0 = suppress.
17:Reserved
18:0x37 - 3EATTO FibreBridge Name (default space characters (0x20)
User defined printable ASCII string intended to facilitate user identification
of each FibreBridge. This string is returned by the INQUIRY command in the
ASCII implemented operation definition page (0x82) when the EVPD bit is set
Bits 3-0: SCSI Lun at which the FibreBridge will respond (0x00 – 0xFF).
This parameter isonly enabled when LUN translations are performed AND
Bridge soft FibreLUNs are enabled in the FBOptions buffer.
1f:0x40SCSI Adapter 1 Soft SCSI ID (default 0x07)
20:0x41SCSI Adapter 2 Soft SCSI ID (default 0x07)
Bits 7-5: Reserved
Bit 4: Enable/Disable soft initiator SCSI IDs 1 = Enable soft IDs 0 = Disable
Soft IDs
Bits 3-0: SCSI ID at which the controller ID will appear on the SCSI bus (0x00-
0x0F).
This parameter is only enabled when the soft initiator SCSI IDs bit is enabled for the respective bus.
*Reserved fields/bits generally are set to 0 and are not user definable.
This section provides information regarding updating the ATTO FibreBridge 3100R flash or
nvram parameters using updater.exe (MSDOS-based utility), SCSI Read Buffer or Write Buffer
commands. The buffer ID identifies the respective field for either updater input or via the
Read/Write Buffer commands. The nvram offset is provided to facilitate interpretation of nvram
contents directly. Accessing the ATTO FibreBridge 3100R via ATTO FibreBridge services
precludes the need to reference this summary. Unless otherwise indicated, items described herein
apply to all models of the ATTO FibreBridge. Items marked FB apply only to the ATTO
FibreBridge 2100R Product Module while items marked FBE apply only to the ATTO
FibreBridge 3100R model (2 GBIC connectors).
Buffer ID nvram offset Buffer Description (default values*)
Consists of 3 hex bytes bb ll tt (bb=busid, ll=lun, tt=target id).
The left hex digit is the bit number of the rightmost field bit in the LUN.
The right hex digit is the number of bits in the field.
11:0x31 - 0x33Logical Unit Addressing Method (default 0x53 0x05 0x84)
Byte 3: FC Port Type 0x00 = Unknown 0x01 = DB9 0x02 = GBIC (FBE)
Byte 2-0: Reserved
18: 0x37 – 0x3EATTOFibreBridge Name (default space characters (0x20)
User defined printable ASCII string intended to facilitate user identification
of each FibreBridge. This string is returned by the INQUIRY command in the
ASCII implemented operation definition page (0x82) when the EVPD bit is set to
1c:0x04-0x05Reserved for Internal Use.
1d:0x42UART Options (default 0x01)
Bit 7-6: Hardware flow control 0 =None 1=Xon/Xoff 2=Hardware
Bit 5: Echo on/off0 =Echo off1=Echo on
Bit 4: Stop Bits:0 =1 Stop Bit1=2 Stop Bits
Bit 3-0: Baud Rate
Bits 7-4: Reserved
Bits 3-0: SCSI Lun at which the FibreBridge will respond (0x00 – 0x0F).
This parameter is only enabled when LUN translations are performed AND Bridgesoft SCSI LUN is enabled in the FBOptions buffer.
1f: 0x40SCSI Adapter 1 Soft SCSI ID (default 0x07)
20: 0x41SCSI Adapter 2 Soft SCSI ID (default 0x07)
Bits 7-5: Reserved
Bit 4: Enable/Disable soft initiator SCSI IDs1 = Enable soft IDs0 = Disable soft IDs
Bits 3-0: SCSI ID at which the controller ID will appear on the SCSI bus (0x00-
0x0F).
This parameter is only enabled when the soft initiator SCSI IDs bit is enabled for the
Respective bus.
Buffer ID nvram offset Buffer Description (default values*)
Bit0: Auto Speed Detect1=Speed Detection Enabled 0=SpeedDetection Disabled
25:0x51Temperature High Warning (default: 0x28)
A user definable SBYTE parameter that indicates when certain alarm flags should be set
within SCSI Enclosure Services with respect to excessive temperature. The default
Temperature High Warning is 40 degrees Celsius.
26:0x52Temperature Low Warning (default: 0x05)
A user definable SBYTE parameter that indicates when certain alarm flags should be set
within SCSI Enclosure Services with respect to excessive temperature. The default
Temperature Low Warning is 5 degrees Celsius.
27:0x53Event Logging Flags (default 0x02)
Bits 7-2: Reserved
Bit 1: Event Status Flag 1 = Log all events 0 = Log events with status other than good
Bit 0: Enabled Flag1 = Logging enabled 0 = Logging disabled
28:0x54Event Logging Subsystem (default 0x3F)
Bit 7-6: Reserved
Bit 5: NVRAM & Flash1 = Logging enabled 0 = Logging disabled
Bit 4: GBIC Connector1 = Logging enabled 0 = Logging disabled
Bit 3: Reserved
This section provides information regarding updating the FibreBridge 3200R flash or nvram
parameters using updater.exe (MSDOS-based utility) or SCSI Read Buffer or Write Buffer
commands. The buffer ID identifies the respective field for either updater input or via the
Read/Write Buffer commands. The nvram offset is provided to facilitate interpretation of nvram
contents directly. Accessing the FibreBridge 3200R via BridgeTools (WinNT and Mac based
utility) precludes the need to reference this summary.
Buffer ID nvram offset Buffer Description (default values*)
Buffer ID nvram offset Buffer Description (default values*)
8:0x44Firmware Options (default 0x0000)
Bits 15-10 Reserved
Bit 9 ACK0 Enable 1= Use ACK0 w/ Class20 = Use ACK1 w/ Class2
Bit 8 Class 2 Support1 = Class 2 Enabled0 = Class 2 Disabled
Bit 7 Reserved
Bits 6-4 Connection Mode
Consists of 3 hex bytes bb ll tt (bb=busid, ll=lun, tt=target id).
The left hex digit is the bit number of the rightmost field bit in the LUN.
The right hex digit is the number of bits in the field.
11:0x32 - 0x34Logical Unit Addressing Method (default 0x53 0x05 0x84)
Byte 3: FC Port Type0x00 = Unknown 0x01 = DB90x02 = GBIC
Byte 2-0: Reserved
18:0x38 – 0x3FATTO FibreBridge Name (default space characters (0x20))
A user defined printable ASCII string intended to facilitate user identification
of each FibreBridge. This string is returned by the INQUIRY command in the
ASCII implemented operation definition page (0x82) when the EVPD bit is set
to 1.
1c:0x04-0x05Reserved for Internal Use.
1d:0x43UART Options (default 0x01)
Bit 7-6: Hardware flow control 0 =None 1=Xon/Xoff 2=Hardware
Bit 5: Echo on/off 0 =Echo off 1=Echo on
Bit 4: Stop Bits:0 =1 Stop Bit 1=2 Stop Bits
Bit 3-0: Baud Rate
Bits 7-4: Reserved
Bits 3-0: SCSI Lun at which the FibreBridge will respond (0x00 – 0xFF). This
Parameter is only enabled when LUN translations are performed AND Bridge
soft SCSI LUN is enabled in the FBOptions buffer.
Bits 3-0: SCSI ID at which the controller ID will appear on the SCSI bus (0x00 0x0F). This parameter is only enabled when the soft initiator SCSI IDs bit is
enabled for the respective bus.
This four-byte field indicates the FibreBridge IP address for use with Ethernet
services.The address is stored in dotted-decimal notation (e.g. 0xC0 0xA8 0x01
0x00 represents the IP address 192.168.1.0).
22:0x4A – 0x4D IP Gateway (default 0x00 0x00 0x00 0x00)
This four-byte field indicates the address of a gateway for the FibreBridge
Ethernet services. The address is stored in dotted-decimal notation (e.g. 0xFF
0x00 represents the IP address 192.168.1.0).
This four-byte field indicates the subnet mask for FibreBridge Ethernet services. The
address is stored in dotted-decimal notation (e.g. 0xFF 0xFF 0xFF 0x00 represents the IPaddress 255.255.255.0).
240x52Ethernet Options (default 0x01)
Bits 7-5: Reserved
Bit 4: DHCP1=DHCP Enabled 0=DHCP Disabled
Bit 3: Reserved
Bit 2: 100 Base-T Speed1=100 Base-T Enabled 0=100 Base-T Disabled
Bit 1: 10 Base-T Speed1=10Base-T Enabled 0=10 Base-T Disabled
Bit 0: Auto Speed Detect 1=Speed Detection Enabled 0=Speed Detection Disabled
25:0x53Temperature High Warning (default: 0x28)
A user definable SBYTE parameter that indicates when certain alarm flags should be set
within SCSI Enclosure Services with respect to excessive temperature. The default
Temperature High Warning is 40 degrees Celsius.
26:0x54Temperature Low Warning (default: 0x05)
A user definable SBYTE parameter that indicates when certain alarm flags should be set
within SCSI Enclosure Services with respect to excessive temperature. The default
Temperature Low Warning is 5 degrees Celsius.
270x55Event Logging Flags (default 0x02)
Bits 7-2: Reserved
Bit 1: Event Status Flag1 = Log all events 0 = Logeventswithstatusotherthangood
Bit 0: Enabled Flag1 = Logging enabled 0 = Logging disabled
280x56Event Logging Subsystem (default 0x3F)
Bit 7-6: Reserved
Bit 5: NVRAM & Flash1 = Logging enabled0 = Logging disabled
Bit 4: GBIC Connector1 = Logging enabled0 = Logging disabled
Bit 3: Reserved
Bit 2: Ethernet1 = Logging enabled0 = Logging disabled
Bit 1: SCSI Processor/i960 1 = Logging enabled0 = Logging disabled
Bit 0: FCP Processor/i9601 = Logging enabled0 = Logging disabled
29 0x57 Event Logging Level (default 0x3F)
Bit 7-6: Reserved
Bit 5: Debug, ATTO tracking events 1 = Logging enabled 0 = Logging disabled
Bit 4: Other, otherwise not categorized 1 = Logging enabled 0 = Logging disabled
Bit 3: Failure, hard failure 1 = Logging enabled 0 = Logging disabled
Bit 2: Critical, operation limited/curtailed 1 = Logging enabled 0 = Logging disabled
Bit 1: Warning, unexpected situation/condition 1 = Logging enabled 0 = Logging
disabled
Bit 0: Info, general information 1 = Logging enabled0 = Logging disabled
2a0x58Event Displaying Flags (default 0x02)
Bits 7-2: Reserved
Bit 1: Event Status Flag1 = Display all events0 = Displayeventswithstatusother
The following is a list of Error Codes that may be present with the ATTO FibreBridge 2200R/D, 3100R
and 3200R.
Throughout the following description, references are made to the ATTO FibreBridge Services port, either
RS232 or Ethernet/telnet. Models of the ATTO FibreBridge support varying levels of such support:
1. RS232 output at power-up;
2. ATTO FibreBridge Services commands/menus over RS232;
3. ATTO FibreBridge Services commands/menus over telnet.
The ATTO FibreBridge Ready LED indicates normal operation or the occurrence of various ATTO
FibreBridge detected errors. In normal operation, the Ready LED remains constantly lighted. In the case
of the ATTO FibreBridge Services Identify Bridge command, or an ATTO FibreBridge-detected error, the
Ready LED displays a blink code pattern, consisting of a series of blinks, a 1-second pause, and a
second series of blinks. At the end of this second series of blinks, the ATTO FibreBridge pauses for 4
seconds, and displays the blink sequence again.
The Identify the ATTO FibreBridge blink pattern (m, n) is intended to help physically identify a specific
ATTO FibreBridge from among a pool.
In case of error, the first blink count indicates the ATTO FibreBridge component∗ encountering the
problem, and the second blink count indicates the specific error occurring. In general, any blink code
requires notification of ATTO for resolution or for instructions. The following first blink code values
indicate an ATTO FibreBridge situation as indicated. When you call ATTO to report an error code, please
provide both blink codes.
1, 2, 3 indicate a processor or memory problem
4indicates a Fibre Channel interface problem
5, 6indicate a SCSI port problem (5 = SCSI port 1, 6 = SCSI port 2)
7indicates a problem with the connection to the Fibre Channel
8indicates a general internal processing problem
9indicates a SCSI Enclosure Services problem.
Blink codes are saved internal to the ATTO FibreBridge, and additional information may be available
upon a power cycle of the bridge. The last error code is displayed to the RS232 port at power up, and
can be retrieved via RS232 or telnet via the Error Log command.
The only user action to resolve any blink code situation is to power cycle the ATTO FibreBridge. This
may clear the situation causing the blink code. All blink codes should be reported to ATTO Technology,
Inc.
∗ Although blink codes are present on the 2100R, Ethernet and RS-232 ports are not available. Therefore the user can not retrieve
error code. Contact ATTO Technology at (716) 691-1999 for more information on retrieving error code for the ATTO FibreBridge
2100R.
For customer service and sales information, call Monday through Friday, Eastern Standard Time 8:00 AM to 7:00
PM or by fax and web site 24 hours a day.
ATTO Technology Inc.
155 CrossPoint Parkway
Amherst, NY 14068
(716) 691-1999 - voice
(716) 691-9353 - fax
http://www.attotech.com
ATTO Technology can also be reached via e-mail at the following addresses: