2002-08-11 23:34:20 +00:00
|
|
|
/* $FreeBSD$ */
|
2005-01-06 01:43:34 +00:00
|
|
|
/*-
|
2012-03-24 16:23:21 +00:00
|
|
|
* Copyright (c) 2000-2010, LSI Logic Corporation and its contributors.
|
Massive overhaul of MPT Fusion driver:
o Add timeout error recovery (from a thread context to avoid
the deferral of other critical interrupts).
o Properly recover commands across controller reset events.
o Update the driver to handle events and status codes that
have been added to the MPI spec since the driver was
originally written.
o Make the driver more modular to improve maintainability and
support dynamic "personality" registration (e.g. SCSI Initiator,
RAID, SAS, FC, etc).
o Shorten and simplify the common I/O path to improve driver
performance.
o Add RAID volume and RAID member state/settings reporting.
o Add periodic volume resynchronization status reporting.
o Add support for sysctl tunable resync rate, member write cache
enable, and volume transaction queue depth.
Sponsored by
----------------
Avid Technologies Inc:
SCSI error recovery, driver re-organization, update of MPI library
headers, portions of dynamic personality registration, and misc bug
fixes.
Wheel Open Technologies:
RAID event notification, RAID member pass-thru support, firmware
upload/download support, enhanced RAID resync speed, portions
of dynamic personality registration, and misc bug fixes.
Detailed Changes
================
mpt.c mpt_cam.c mpt_raid.c mpt_pci.c:
o Add support for personality modules. Each module exports
load, and unload module scope methods as well as probe, attach,
event, reset, shutdown, and detach per-device instance
methods
mpt.c mpt.h mpt_pci.c:
o The driver now associates a callback function (via an
index) with every transaction submitted to the controller.
This allows the main interrupt handler to absolve itself
of any knowledge of individual transaction/response types
by simply calling the callback function "registered" for
the transaction. We use a callback index instead of a
callback function pointer in each requests so we can
properly handle responses (e.g. event notifications)
that are not associated with a transaction. Personality
modules dynamically register their callbacks with the
driver core to receive the callback index to use for their
handlers.
o Move the interrupt handler into mpt.c. The ISR algorithm
is bus transport and OS independent and thus had no reason
to be in mpt_pci.c.
o Simplify configuration message reply handling by copying
reply frame data for the requester and storing completion
status in the original request structure.
o Add the mpt_complete_request_chain() helper method and use
it to implement reset handlers that must abort transactions.
o Keep track of all pending requests on the new
requests_pending_list in the softc.
o Add default handlers to mpt.c to handle generic event
notifications and controller reset activities. The event
handler code is largely the same as in the original driver.
The reset handler is new and terminates any pending transactions
with a status code indicating the controller needs to be
re-initialized.
o Add some endian support to the driver. A complete audit is
still required for this driver to have any hope of operating
in a big-endian environment.
o Use inttypes.h and __inline. Come closer to being style(9)
compliant.
o Remove extraneous use of typedefs.
o Convert request state from a strict enumeration to a series
of flags. This allows us to, for example, tag transactions
that have timed-out while retaining the state that the
transaction is still in-flight on the controller.
o Add mpt_wait_req() which allows a caller to poll or sleep
for the completion of a request. Use this to simplify
and factor code out from many initialization routines.
We also use this to sleep for task management request
completions in our CAM timeout handler.
mpt.c:
o Correct a bug in the event handler where request structures were
freed even if the request reply was marked as a continuation
reply. Continuation replies indicate that the controller still owns
the request and freeing these replies prematurely corrupted
controller state.
o Implement firmware upload and download. On controllers that do
not have dedicated NVRAM (as in the Sun v20/v40z), the firmware
image is downloaded to the controller by the system BIOS. This
image occupies precious controller RAM space until the host driver
fetches the image, reducing the number of concurrent I/Os the
controller can processes. The uploaded image is used to
re-program the controller during hard reset events since the
controller cannot fetch the firmware on its own. Implementing this
feature allows much higher queue depths when RAID volumes
are configured.
o Changed configuration page accessors to allow threads to sleep
rather than busy wait for completion.
o Removed hard coded data transfer sizes from configuration page
routines so that RAID configuration page processing is possible.
mpt_reg.h:
o Move controller register definitions into a separate file.
mpt.h:
o Re-arrange includes to allow inlined functions to be
defined in mpt.h.
o Add reply, event, and reset handler definitions.
o Add softc fields for handling timeout and controller
reset recovery.
mpt_cam.c:
o Move mpt_freebsd.c to mpt_cam.c. Move all core functionality,
such as event handling, into mpt.c leaving only CAM SCSI
support here.
o Revamp completion handler to provide correct CAM status for
all currently defined SCSI MPI message result codes.
o Register event and reset handlers with the MPT core. Modify
the event handler to notify CAM of bus reset events. The
controller reset handler will abort any transactions that
have timed out. All other pending CAM transactions are
correctly aborted by the core driver's reset handler.
o Allocate a single request up front to perform task management
operations. This guarantees that we can always perform a
TMF operation even when the controller is saturated with other
operations. The single request also serves as a perfect
mechanism of guaranteeing that only a single TMF is in flight
at a time - something that is required according to the MPT
Fusion documentation.
o Add a helper function for issuing task management requests
to the controller. This is used to abort individual requests
or perform a bus reset.
o Modify the CAM XPT_BUS_RESET ccb handler to wait for and
properly handle the status of the bus reset task management
frame used to reset the bus. The previous code assumed that
the reset request would always succeed.
o Add timeout recovery support. When a timeout occurs, the
timed-out request is added to a queue to be processed by
our recovery thread and the thread is woken up. The recovery
thread processes timed-out command serially, attempting first
to abort them and then falling back to a bus reset if an
abort fails.
o Add calls to mpt_reset() to reset the controller if any
handshake command, bus reset attempt or abort attempt
fails due to a timeout.
o Export a secondary "bus" to CAM that exposes all volume drive
members as pass-thru devices, allowing CAM to perform proper
speed negotiation to hidden devices.
o Add a CAM async event handler tracking the AC_FOUND_DEVICE event.
Use this to trigger calls to set the per-volume queue depth once
the volume is fully registered with CAM. This is required to avoid
hitting firmware limits on volume queue depth. Exceeding the
limit causes the firmware to hang.
mpt_cam.h:
o Add several helper functions for interfacing to CAM and
performing timeout recovery.
mpt_pci.c:
o Disable interrupts on the controller before registering and
enabling interrupt delivery to the OS. Otherwise we risk
receiving interrupts before the driver is ready to receive
them.
o Make use of compatibility macros that allow the driver to
be compiled under 4.x and 5.x.
mpt_raid.c:
o Add a per-controller instance RAID thread to perform settings
changes and query status (minimizes CPU busy wait loops).
o Use a shutdown handler to disable "Member Write Cache Enable"
(MWCE) setting for RAID arrays set to enable MWCE During Rebuild.
o Change reply handler function signature to allow handlers to defer
the deletion of reply frames. Use this to allow the event reply
handler to queue up events that need to be acked if no resources
are available to immediately ack an event. Queued events are
processed in mpt_free_request() where resources are freed. This
avoids a panic on resource shortage.
o Parse and print out RAID controller capabilities during driver probe.
o Define, allocate, and maintain RAID data structures for volumes,
hidden member physical disks and spare disks.
o Add dynamic sysctls for per-instance setting of the log level, array
resync rate, array member cache enable, and volume queue depth.
mpt_debug.c:
o Add mpt_lprt and mpt_lprtc for printing diagnostics conditioned on
a particular log level to aid in tracking down driver issues.
o Add mpt_decode_value() which parses the bits in an integer
value based on a parsing table (mask, value, name string, tuples).
mpilib/*:
o Update mpi library header files to latest distribution from LSI.
Submitted by: gibbs
Approved by: re
2005-07-10 15:05:39 +00:00
|
|
|
* All rights reserved.
|
|
|
|
|
*
|
2002-08-30 03:36:50 +00:00
|
|
|
* Redistribution and use in source and binary forms, with or without
|
Massive overhaul of MPT Fusion driver:
o Add timeout error recovery (from a thread context to avoid
the deferral of other critical interrupts).
o Properly recover commands across controller reset events.
o Update the driver to handle events and status codes that
have been added to the MPI spec since the driver was
originally written.
o Make the driver more modular to improve maintainability and
support dynamic "personality" registration (e.g. SCSI Initiator,
RAID, SAS, FC, etc).
o Shorten and simplify the common I/O path to improve driver
performance.
o Add RAID volume and RAID member state/settings reporting.
o Add periodic volume resynchronization status reporting.
o Add support for sysctl tunable resync rate, member write cache
enable, and volume transaction queue depth.
Sponsored by
----------------
Avid Technologies Inc:
SCSI error recovery, driver re-organization, update of MPI library
headers, portions of dynamic personality registration, and misc bug
fixes.
Wheel Open Technologies:
RAID event notification, RAID member pass-thru support, firmware
upload/download support, enhanced RAID resync speed, portions
of dynamic personality registration, and misc bug fixes.
Detailed Changes
================
mpt.c mpt_cam.c mpt_raid.c mpt_pci.c:
o Add support for personality modules. Each module exports
load, and unload module scope methods as well as probe, attach,
event, reset, shutdown, and detach per-device instance
methods
mpt.c mpt.h mpt_pci.c:
o The driver now associates a callback function (via an
index) with every transaction submitted to the controller.
This allows the main interrupt handler to absolve itself
of any knowledge of individual transaction/response types
by simply calling the callback function "registered" for
the transaction. We use a callback index instead of a
callback function pointer in each requests so we can
properly handle responses (e.g. event notifications)
that are not associated with a transaction. Personality
modules dynamically register their callbacks with the
driver core to receive the callback index to use for their
handlers.
o Move the interrupt handler into mpt.c. The ISR algorithm
is bus transport and OS independent and thus had no reason
to be in mpt_pci.c.
o Simplify configuration message reply handling by copying
reply frame data for the requester and storing completion
status in the original request structure.
o Add the mpt_complete_request_chain() helper method and use
it to implement reset handlers that must abort transactions.
o Keep track of all pending requests on the new
requests_pending_list in the softc.
o Add default handlers to mpt.c to handle generic event
notifications and controller reset activities. The event
handler code is largely the same as in the original driver.
The reset handler is new and terminates any pending transactions
with a status code indicating the controller needs to be
re-initialized.
o Add some endian support to the driver. A complete audit is
still required for this driver to have any hope of operating
in a big-endian environment.
o Use inttypes.h and __inline. Come closer to being style(9)
compliant.
o Remove extraneous use of typedefs.
o Convert request state from a strict enumeration to a series
of flags. This allows us to, for example, tag transactions
that have timed-out while retaining the state that the
transaction is still in-flight on the controller.
o Add mpt_wait_req() which allows a caller to poll or sleep
for the completion of a request. Use this to simplify
and factor code out from many initialization routines.
We also use this to sleep for task management request
completions in our CAM timeout handler.
mpt.c:
o Correct a bug in the event handler where request structures were
freed even if the request reply was marked as a continuation
reply. Continuation replies indicate that the controller still owns
the request and freeing these replies prematurely corrupted
controller state.
o Implement firmware upload and download. On controllers that do
not have dedicated NVRAM (as in the Sun v20/v40z), the firmware
image is downloaded to the controller by the system BIOS. This
image occupies precious controller RAM space until the host driver
fetches the image, reducing the number of concurrent I/Os the
controller can processes. The uploaded image is used to
re-program the controller during hard reset events since the
controller cannot fetch the firmware on its own. Implementing this
feature allows much higher queue depths when RAID volumes
are configured.
o Changed configuration page accessors to allow threads to sleep
rather than busy wait for completion.
o Removed hard coded data transfer sizes from configuration page
routines so that RAID configuration page processing is possible.
mpt_reg.h:
o Move controller register definitions into a separate file.
mpt.h:
o Re-arrange includes to allow inlined functions to be
defined in mpt.h.
o Add reply, event, and reset handler definitions.
o Add softc fields for handling timeout and controller
reset recovery.
mpt_cam.c:
o Move mpt_freebsd.c to mpt_cam.c. Move all core functionality,
such as event handling, into mpt.c leaving only CAM SCSI
support here.
o Revamp completion handler to provide correct CAM status for
all currently defined SCSI MPI message result codes.
o Register event and reset handlers with the MPT core. Modify
the event handler to notify CAM of bus reset events. The
controller reset handler will abort any transactions that
have timed out. All other pending CAM transactions are
correctly aborted by the core driver's reset handler.
o Allocate a single request up front to perform task management
operations. This guarantees that we can always perform a
TMF operation even when the controller is saturated with other
operations. The single request also serves as a perfect
mechanism of guaranteeing that only a single TMF is in flight
at a time - something that is required according to the MPT
Fusion documentation.
o Add a helper function for issuing task management requests
to the controller. This is used to abort individual requests
or perform a bus reset.
o Modify the CAM XPT_BUS_RESET ccb handler to wait for and
properly handle the status of the bus reset task management
frame used to reset the bus. The previous code assumed that
the reset request would always succeed.
o Add timeout recovery support. When a timeout occurs, the
timed-out request is added to a queue to be processed by
our recovery thread and the thread is woken up. The recovery
thread processes timed-out command serially, attempting first
to abort them and then falling back to a bus reset if an
abort fails.
o Add calls to mpt_reset() to reset the controller if any
handshake command, bus reset attempt or abort attempt
fails due to a timeout.
o Export a secondary "bus" to CAM that exposes all volume drive
members as pass-thru devices, allowing CAM to perform proper
speed negotiation to hidden devices.
o Add a CAM async event handler tracking the AC_FOUND_DEVICE event.
Use this to trigger calls to set the per-volume queue depth once
the volume is fully registered with CAM. This is required to avoid
hitting firmware limits on volume queue depth. Exceeding the
limit causes the firmware to hang.
mpt_cam.h:
o Add several helper functions for interfacing to CAM and
performing timeout recovery.
mpt_pci.c:
o Disable interrupts on the controller before registering and
enabling interrupt delivery to the OS. Otherwise we risk
receiving interrupts before the driver is ready to receive
them.
o Make use of compatibility macros that allow the driver to
be compiled under 4.x and 5.x.
mpt_raid.c:
o Add a per-controller instance RAID thread to perform settings
changes and query status (minimizes CPU busy wait loops).
o Use a shutdown handler to disable "Member Write Cache Enable"
(MWCE) setting for RAID arrays set to enable MWCE During Rebuild.
o Change reply handler function signature to allow handlers to defer
the deletion of reply frames. Use this to allow the event reply
handler to queue up events that need to be acked if no resources
are available to immediately ack an event. Queued events are
processed in mpt_free_request() where resources are freed. This
avoids a panic on resource shortage.
o Parse and print out RAID controller capabilities during driver probe.
o Define, allocate, and maintain RAID data structures for volumes,
hidden member physical disks and spare disks.
o Add dynamic sysctls for per-instance setting of the log level, array
resync rate, array member cache enable, and volume queue depth.
mpt_debug.c:
o Add mpt_lprt and mpt_lprtc for printing diagnostics conditioned on
a particular log level to aid in tracking down driver issues.
o Add mpt_decode_value() which parses the bits in an integer
value based on a parsing table (mask, value, name string, tuples).
mpilib/*:
o Update mpi library header files to latest distribution from LSI.
Submitted by: gibbs
Approved by: re
2005-07-10 15:05:39 +00:00
|
|
|
* modification, are permitted provided that the following conditions are
|
|
|
|
|
* met:
|
2002-08-30 03:36:50 +00:00
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
Massive overhaul of MPT Fusion driver:
o Add timeout error recovery (from a thread context to avoid
the deferral of other critical interrupts).
o Properly recover commands across controller reset events.
o Update the driver to handle events and status codes that
have been added to the MPI spec since the driver was
originally written.
o Make the driver more modular to improve maintainability and
support dynamic "personality" registration (e.g. SCSI Initiator,
RAID, SAS, FC, etc).
o Shorten and simplify the common I/O path to improve driver
performance.
o Add RAID volume and RAID member state/settings reporting.
o Add periodic volume resynchronization status reporting.
o Add support for sysctl tunable resync rate, member write cache
enable, and volume transaction queue depth.
Sponsored by
----------------
Avid Technologies Inc:
SCSI error recovery, driver re-organization, update of MPI library
headers, portions of dynamic personality registration, and misc bug
fixes.
Wheel Open Technologies:
RAID event notification, RAID member pass-thru support, firmware
upload/download support, enhanced RAID resync speed, portions
of dynamic personality registration, and misc bug fixes.
Detailed Changes
================
mpt.c mpt_cam.c mpt_raid.c mpt_pci.c:
o Add support for personality modules. Each module exports
load, and unload module scope methods as well as probe, attach,
event, reset, shutdown, and detach per-device instance
methods
mpt.c mpt.h mpt_pci.c:
o The driver now associates a callback function (via an
index) with every transaction submitted to the controller.
This allows the main interrupt handler to absolve itself
of any knowledge of individual transaction/response types
by simply calling the callback function "registered" for
the transaction. We use a callback index instead of a
callback function pointer in each requests so we can
properly handle responses (e.g. event notifications)
that are not associated with a transaction. Personality
modules dynamically register their callbacks with the
driver core to receive the callback index to use for their
handlers.
o Move the interrupt handler into mpt.c. The ISR algorithm
is bus transport and OS independent and thus had no reason
to be in mpt_pci.c.
o Simplify configuration message reply handling by copying
reply frame data for the requester and storing completion
status in the original request structure.
o Add the mpt_complete_request_chain() helper method and use
it to implement reset handlers that must abort transactions.
o Keep track of all pending requests on the new
requests_pending_list in the softc.
o Add default handlers to mpt.c to handle generic event
notifications and controller reset activities. The event
handler code is largely the same as in the original driver.
The reset handler is new and terminates any pending transactions
with a status code indicating the controller needs to be
re-initialized.
o Add some endian support to the driver. A complete audit is
still required for this driver to have any hope of operating
in a big-endian environment.
o Use inttypes.h and __inline. Come closer to being style(9)
compliant.
o Remove extraneous use of typedefs.
o Convert request state from a strict enumeration to a series
of flags. This allows us to, for example, tag transactions
that have timed-out while retaining the state that the
transaction is still in-flight on the controller.
o Add mpt_wait_req() which allows a caller to poll or sleep
for the completion of a request. Use this to simplify
and factor code out from many initialization routines.
We also use this to sleep for task management request
completions in our CAM timeout handler.
mpt.c:
o Correct a bug in the event handler where request structures were
freed even if the request reply was marked as a continuation
reply. Continuation replies indicate that the controller still owns
the request and freeing these replies prematurely corrupted
controller state.
o Implement firmware upload and download. On controllers that do
not have dedicated NVRAM (as in the Sun v20/v40z), the firmware
image is downloaded to the controller by the system BIOS. This
image occupies precious controller RAM space until the host driver
fetches the image, reducing the number of concurrent I/Os the
controller can processes. The uploaded image is used to
re-program the controller during hard reset events since the
controller cannot fetch the firmware on its own. Implementing this
feature allows much higher queue depths when RAID volumes
are configured.
o Changed configuration page accessors to allow threads to sleep
rather than busy wait for completion.
o Removed hard coded data transfer sizes from configuration page
routines so that RAID configuration page processing is possible.
mpt_reg.h:
o Move controller register definitions into a separate file.
mpt.h:
o Re-arrange includes to allow inlined functions to be
defined in mpt.h.
o Add reply, event, and reset handler definitions.
o Add softc fields for handling timeout and controller
reset recovery.
mpt_cam.c:
o Move mpt_freebsd.c to mpt_cam.c. Move all core functionality,
such as event handling, into mpt.c leaving only CAM SCSI
support here.
o Revamp completion handler to provide correct CAM status for
all currently defined SCSI MPI message result codes.
o Register event and reset handlers with the MPT core. Modify
the event handler to notify CAM of bus reset events. The
controller reset handler will abort any transactions that
have timed out. All other pending CAM transactions are
correctly aborted by the core driver's reset handler.
o Allocate a single request up front to perform task management
operations. This guarantees that we can always perform a
TMF operation even when the controller is saturated with other
operations. The single request also serves as a perfect
mechanism of guaranteeing that only a single TMF is in flight
at a time - something that is required according to the MPT
Fusion documentation.
o Add a helper function for issuing task management requests
to the controller. This is used to abort individual requests
or perform a bus reset.
o Modify the CAM XPT_BUS_RESET ccb handler to wait for and
properly handle the status of the bus reset task management
frame used to reset the bus. The previous code assumed that
the reset request would always succeed.
o Add timeout recovery support. When a timeout occurs, the
timed-out request is added to a queue to be processed by
our recovery thread and the thread is woken up. The recovery
thread processes timed-out command serially, attempting first
to abort them and then falling back to a bus reset if an
abort fails.
o Add calls to mpt_reset() to reset the controller if any
handshake command, bus reset attempt or abort attempt
fails due to a timeout.
o Export a secondary "bus" to CAM that exposes all volume drive
members as pass-thru devices, allowing CAM to perform proper
speed negotiation to hidden devices.
o Add a CAM async event handler tracking the AC_FOUND_DEVICE event.
Use this to trigger calls to set the per-volume queue depth once
the volume is fully registered with CAM. This is required to avoid
hitting firmware limits on volume queue depth. Exceeding the
limit causes the firmware to hang.
mpt_cam.h:
o Add several helper functions for interfacing to CAM and
performing timeout recovery.
mpt_pci.c:
o Disable interrupts on the controller before registering and
enabling interrupt delivery to the OS. Otherwise we risk
receiving interrupts before the driver is ready to receive
them.
o Make use of compatibility macros that allow the driver to
be compiled under 4.x and 5.x.
mpt_raid.c:
o Add a per-controller instance RAID thread to perform settings
changes and query status (minimizes CPU busy wait loops).
o Use a shutdown handler to disable "Member Write Cache Enable"
(MWCE) setting for RAID arrays set to enable MWCE During Rebuild.
o Change reply handler function signature to allow handlers to defer
the deletion of reply frames. Use this to allow the event reply
handler to queue up events that need to be acked if no resources
are available to immediately ack an event. Queued events are
processed in mpt_free_request() where resources are freed. This
avoids a panic on resource shortage.
o Parse and print out RAID controller capabilities during driver probe.
o Define, allocate, and maintain RAID data structures for volumes,
hidden member physical disks and spare disks.
o Add dynamic sysctls for per-instance setting of the log level, array
resync rate, array member cache enable, and volume queue depth.
mpt_debug.c:
o Add mpt_lprt and mpt_lprtc for printing diagnostics conditioned on
a particular log level to aid in tracking down driver issues.
o Add mpt_decode_value() which parses the bits in an integer
value based on a parsing table (mask, value, name string, tuples).
mpilib/*:
o Update mpi library header files to latest distribution from LSI.
Submitted by: gibbs
Approved by: re
2005-07-10 15:05:39 +00:00
|
|
|
* notice, this list of conditions and the following disclaimer.
|
|
|
|
|
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
|
|
|
* substantially similar to the "NO WARRANTY" disclaimer below
|
|
|
|
|
* ("Disclaimer") and any redistribution must be conditioned upon including
|
|
|
|
|
* a substantially similar Disclaimer requirement for further binary
|
|
|
|
|
* redistribution.
|
|
|
|
|
* 3. Neither the name of the LSI Logic Corporation nor the names of its
|
|
|
|
|
* contributors may be used to endorse or promote products derived from
|
|
|
|
|
* this software without specific prior written permission.
|
|
|
|
|
*
|
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
|
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
2002-08-30 03:36:50 +00:00
|
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
Massive overhaul of MPT Fusion driver:
o Add timeout error recovery (from a thread context to avoid
the deferral of other critical interrupts).
o Properly recover commands across controller reset events.
o Update the driver to handle events and status codes that
have been added to the MPI spec since the driver was
originally written.
o Make the driver more modular to improve maintainability and
support dynamic "personality" registration (e.g. SCSI Initiator,
RAID, SAS, FC, etc).
o Shorten and simplify the common I/O path to improve driver
performance.
o Add RAID volume and RAID member state/settings reporting.
o Add periodic volume resynchronization status reporting.
o Add support for sysctl tunable resync rate, member write cache
enable, and volume transaction queue depth.
Sponsored by
----------------
Avid Technologies Inc:
SCSI error recovery, driver re-organization, update of MPI library
headers, portions of dynamic personality registration, and misc bug
fixes.
Wheel Open Technologies:
RAID event notification, RAID member pass-thru support, firmware
upload/download support, enhanced RAID resync speed, portions
of dynamic personality registration, and misc bug fixes.
Detailed Changes
================
mpt.c mpt_cam.c mpt_raid.c mpt_pci.c:
o Add support for personality modules. Each module exports
load, and unload module scope methods as well as probe, attach,
event, reset, shutdown, and detach per-device instance
methods
mpt.c mpt.h mpt_pci.c:
o The driver now associates a callback function (via an
index) with every transaction submitted to the controller.
This allows the main interrupt handler to absolve itself
of any knowledge of individual transaction/response types
by simply calling the callback function "registered" for
the transaction. We use a callback index instead of a
callback function pointer in each requests so we can
properly handle responses (e.g. event notifications)
that are not associated with a transaction. Personality
modules dynamically register their callbacks with the
driver core to receive the callback index to use for their
handlers.
o Move the interrupt handler into mpt.c. The ISR algorithm
is bus transport and OS independent and thus had no reason
to be in mpt_pci.c.
o Simplify configuration message reply handling by copying
reply frame data for the requester and storing completion
status in the original request structure.
o Add the mpt_complete_request_chain() helper method and use
it to implement reset handlers that must abort transactions.
o Keep track of all pending requests on the new
requests_pending_list in the softc.
o Add default handlers to mpt.c to handle generic event
notifications and controller reset activities. The event
handler code is largely the same as in the original driver.
The reset handler is new and terminates any pending transactions
with a status code indicating the controller needs to be
re-initialized.
o Add some endian support to the driver. A complete audit is
still required for this driver to have any hope of operating
in a big-endian environment.
o Use inttypes.h and __inline. Come closer to being style(9)
compliant.
o Remove extraneous use of typedefs.
o Convert request state from a strict enumeration to a series
of flags. This allows us to, for example, tag transactions
that have timed-out while retaining the state that the
transaction is still in-flight on the controller.
o Add mpt_wait_req() which allows a caller to poll or sleep
for the completion of a request. Use this to simplify
and factor code out from many initialization routines.
We also use this to sleep for task management request
completions in our CAM timeout handler.
mpt.c:
o Correct a bug in the event handler where request structures were
freed even if the request reply was marked as a continuation
reply. Continuation replies indicate that the controller still owns
the request and freeing these replies prematurely corrupted
controller state.
o Implement firmware upload and download. On controllers that do
not have dedicated NVRAM (as in the Sun v20/v40z), the firmware
image is downloaded to the controller by the system BIOS. This
image occupies precious controller RAM space until the host driver
fetches the image, reducing the number of concurrent I/Os the
controller can processes. The uploaded image is used to
re-program the controller during hard reset events since the
controller cannot fetch the firmware on its own. Implementing this
feature allows much higher queue depths when RAID volumes
are configured.
o Changed configuration page accessors to allow threads to sleep
rather than busy wait for completion.
o Removed hard coded data transfer sizes from configuration page
routines so that RAID configuration page processing is possible.
mpt_reg.h:
o Move controller register definitions into a separate file.
mpt.h:
o Re-arrange includes to allow inlined functions to be
defined in mpt.h.
o Add reply, event, and reset handler definitions.
o Add softc fields for handling timeout and controller
reset recovery.
mpt_cam.c:
o Move mpt_freebsd.c to mpt_cam.c. Move all core functionality,
such as event handling, into mpt.c leaving only CAM SCSI
support here.
o Revamp completion handler to provide correct CAM status for
all currently defined SCSI MPI message result codes.
o Register event and reset handlers with the MPT core. Modify
the event handler to notify CAM of bus reset events. The
controller reset handler will abort any transactions that
have timed out. All other pending CAM transactions are
correctly aborted by the core driver's reset handler.
o Allocate a single request up front to perform task management
operations. This guarantees that we can always perform a
TMF operation even when the controller is saturated with other
operations. The single request also serves as a perfect
mechanism of guaranteeing that only a single TMF is in flight
at a time - something that is required according to the MPT
Fusion documentation.
o Add a helper function for issuing task management requests
to the controller. This is used to abort individual requests
or perform a bus reset.
o Modify the CAM XPT_BUS_RESET ccb handler to wait for and
properly handle the status of the bus reset task management
frame used to reset the bus. The previous code assumed that
the reset request would always succeed.
o Add timeout recovery support. When a timeout occurs, the
timed-out request is added to a queue to be processed by
our recovery thread and the thread is woken up. The recovery
thread processes timed-out command serially, attempting first
to abort them and then falling back to a bus reset if an
abort fails.
o Add calls to mpt_reset() to reset the controller if any
handshake command, bus reset attempt or abort attempt
fails due to a timeout.
o Export a secondary "bus" to CAM that exposes all volume drive
members as pass-thru devices, allowing CAM to perform proper
speed negotiation to hidden devices.
o Add a CAM async event handler tracking the AC_FOUND_DEVICE event.
Use this to trigger calls to set the per-volume queue depth once
the volume is fully registered with CAM. This is required to avoid
hitting firmware limits on volume queue depth. Exceeding the
limit causes the firmware to hang.
mpt_cam.h:
o Add several helper functions for interfacing to CAM and
performing timeout recovery.
mpt_pci.c:
o Disable interrupts on the controller before registering and
enabling interrupt delivery to the OS. Otherwise we risk
receiving interrupts before the driver is ready to receive
them.
o Make use of compatibility macros that allow the driver to
be compiled under 4.x and 5.x.
mpt_raid.c:
o Add a per-controller instance RAID thread to perform settings
changes and query status (minimizes CPU busy wait loops).
o Use a shutdown handler to disable "Member Write Cache Enable"
(MWCE) setting for RAID arrays set to enable MWCE During Rebuild.
o Change reply handler function signature to allow handlers to defer
the deletion of reply frames. Use this to allow the event reply
handler to queue up events that need to be acked if no resources
are available to immediately ack an event. Queued events are
processed in mpt_free_request() where resources are freed. This
avoids a panic on resource shortage.
o Parse and print out RAID controller capabilities during driver probe.
o Define, allocate, and maintain RAID data structures for volumes,
hidden member physical disks and spare disks.
o Add dynamic sysctls for per-instance setting of the log level, array
resync rate, array member cache enable, and volume queue depth.
mpt_debug.c:
o Add mpt_lprt and mpt_lprtc for printing diagnostics conditioned on
a particular log level to aid in tracking down driver issues.
o Add mpt_decode_value() which parses the bits in an integer
value based on a parsing table (mask, value, name string, tuples).
mpilib/*:
o Update mpi library header files to latest distribution from LSI.
Submitted by: gibbs
Approved by: re
2005-07-10 15:05:39 +00:00
|
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
|
|
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
|
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
|
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
|
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
|
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
|
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF THE COPYRIGHT
|
|
|
|
|
* OWNER OR CONTRIBUTOR IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
2007-06-03 22:58:27 +00:00
|
|
|
*
|
2006-01-21 00:29:52 +00:00
|
|
|
* Name: mpi_init.h
|
2002-08-11 23:34:20 +00:00
|
|
|
* Title: MPI initiator mode messages and structures
|
|
|
|
|
* Creation Date: June 8, 2000
|
|
|
|
|
*
|
2007-06-03 22:58:27 +00:00
|
|
|
* mpi_init.h Version: 01.05.09
|
2002-08-11 23:34:20 +00:00
|
|
|
*
|
|
|
|
|
* Version History
|
|
|
|
|
* ---------------
|
|
|
|
|
*
|
|
|
|
|
* Date Version Description
|
|
|
|
|
* -------- -------- ------------------------------------------------------
|
|
|
|
|
* 05-08-00 00.10.01 Original release for 0.10 spec dated 4/26/2000.
|
|
|
|
|
* 05-24-00 00.10.02 Added SenseBufferLength to _MSG_SCSI_IO_REPLY.
|
|
|
|
|
* 06-06-00 01.00.01 Update version number for 1.0 release.
|
|
|
|
|
* 06-08-00 01.00.02 Added MPI_SCSI_RSP_INFO_ definitions.
|
|
|
|
|
* 11-02-00 01.01.01 Original release for post 1.0 work.
|
|
|
|
|
* 12-04-00 01.01.02 Added MPI_SCSIIO_CONTROL_NO_DISCONNECT.
|
|
|
|
|
* 02-20-01 01.01.03 Started using MPI_POINTER.
|
|
|
|
|
* 03-27-01 01.01.04 Added structure offset comments.
|
|
|
|
|
* 04-10-01 01.01.05 Added new MsgFlag for MSG_SCSI_TASK_MGMT.
|
|
|
|
|
* 08-08-01 01.02.01 Original release for v1.2 work.
|
|
|
|
|
* 08-29-01 01.02.02 Added MPI_SCSITASKMGMT_TASKTYPE_LOGICAL_UNIT_RESET.
|
|
|
|
|
* Added MPI_SCSI_STATE_QUEUE_TAG_REJECTED for
|
|
|
|
|
* MSG_SCSI_IO_REPLY.
|
|
|
|
|
* 09-28-01 01.02.03 Added structures and defines for SCSI Enclosure
|
|
|
|
|
* Processor messages.
|
|
|
|
|
* 10-04-01 01.02.04 Added defines for SEP request Action field.
|
2003-06-03 17:47:48 +00:00
|
|
|
* 05-31-02 01.02.05 Added MPI_SCSIIO_MSGFLGS_CMD_DETERMINES_DATA_DIR define
|
|
|
|
|
* for SCSI IO requests.
|
|
|
|
|
* 11-15-02 01.02.06 Added special extended SCSI Status defines for FCP.
|
Massive overhaul of MPT Fusion driver:
o Add timeout error recovery (from a thread context to avoid
the deferral of other critical interrupts).
o Properly recover commands across controller reset events.
o Update the driver to handle events and status codes that
have been added to the MPI spec since the driver was
originally written.
o Make the driver more modular to improve maintainability and
support dynamic "personality" registration (e.g. SCSI Initiator,
RAID, SAS, FC, etc).
o Shorten and simplify the common I/O path to improve driver
performance.
o Add RAID volume and RAID member state/settings reporting.
o Add periodic volume resynchronization status reporting.
o Add support for sysctl tunable resync rate, member write cache
enable, and volume transaction queue depth.
Sponsored by
----------------
Avid Technologies Inc:
SCSI error recovery, driver re-organization, update of MPI library
headers, portions of dynamic personality registration, and misc bug
fixes.
Wheel Open Technologies:
RAID event notification, RAID member pass-thru support, firmware
upload/download support, enhanced RAID resync speed, portions
of dynamic personality registration, and misc bug fixes.
Detailed Changes
================
mpt.c mpt_cam.c mpt_raid.c mpt_pci.c:
o Add support for personality modules. Each module exports
load, and unload module scope methods as well as probe, attach,
event, reset, shutdown, and detach per-device instance
methods
mpt.c mpt.h mpt_pci.c:
o The driver now associates a callback function (via an
index) with every transaction submitted to the controller.
This allows the main interrupt handler to absolve itself
of any knowledge of individual transaction/response types
by simply calling the callback function "registered" for
the transaction. We use a callback index instead of a
callback function pointer in each requests so we can
properly handle responses (e.g. event notifications)
that are not associated with a transaction. Personality
modules dynamically register their callbacks with the
driver core to receive the callback index to use for their
handlers.
o Move the interrupt handler into mpt.c. The ISR algorithm
is bus transport and OS independent and thus had no reason
to be in mpt_pci.c.
o Simplify configuration message reply handling by copying
reply frame data for the requester and storing completion
status in the original request structure.
o Add the mpt_complete_request_chain() helper method and use
it to implement reset handlers that must abort transactions.
o Keep track of all pending requests on the new
requests_pending_list in the softc.
o Add default handlers to mpt.c to handle generic event
notifications and controller reset activities. The event
handler code is largely the same as in the original driver.
The reset handler is new and terminates any pending transactions
with a status code indicating the controller needs to be
re-initialized.
o Add some endian support to the driver. A complete audit is
still required for this driver to have any hope of operating
in a big-endian environment.
o Use inttypes.h and __inline. Come closer to being style(9)
compliant.
o Remove extraneous use of typedefs.
o Convert request state from a strict enumeration to a series
of flags. This allows us to, for example, tag transactions
that have timed-out while retaining the state that the
transaction is still in-flight on the controller.
o Add mpt_wait_req() which allows a caller to poll or sleep
for the completion of a request. Use this to simplify
and factor code out from many initialization routines.
We also use this to sleep for task management request
completions in our CAM timeout handler.
mpt.c:
o Correct a bug in the event handler where request structures were
freed even if the request reply was marked as a continuation
reply. Continuation replies indicate that the controller still owns
the request and freeing these replies prematurely corrupted
controller state.
o Implement firmware upload and download. On controllers that do
not have dedicated NVRAM (as in the Sun v20/v40z), the firmware
image is downloaded to the controller by the system BIOS. This
image occupies precious controller RAM space until the host driver
fetches the image, reducing the number of concurrent I/Os the
controller can processes. The uploaded image is used to
re-program the controller during hard reset events since the
controller cannot fetch the firmware on its own. Implementing this
feature allows much higher queue depths when RAID volumes
are configured.
o Changed configuration page accessors to allow threads to sleep
rather than busy wait for completion.
o Removed hard coded data transfer sizes from configuration page
routines so that RAID configuration page processing is possible.
mpt_reg.h:
o Move controller register definitions into a separate file.
mpt.h:
o Re-arrange includes to allow inlined functions to be
defined in mpt.h.
o Add reply, event, and reset handler definitions.
o Add softc fields for handling timeout and controller
reset recovery.
mpt_cam.c:
o Move mpt_freebsd.c to mpt_cam.c. Move all core functionality,
such as event handling, into mpt.c leaving only CAM SCSI
support here.
o Revamp completion handler to provide correct CAM status for
all currently defined SCSI MPI message result codes.
o Register event and reset handlers with the MPT core. Modify
the event handler to notify CAM of bus reset events. The
controller reset handler will abort any transactions that
have timed out. All other pending CAM transactions are
correctly aborted by the core driver's reset handler.
o Allocate a single request up front to perform task management
operations. This guarantees that we can always perform a
TMF operation even when the controller is saturated with other
operations. The single request also serves as a perfect
mechanism of guaranteeing that only a single TMF is in flight
at a time - something that is required according to the MPT
Fusion documentation.
o Add a helper function for issuing task management requests
to the controller. This is used to abort individual requests
or perform a bus reset.
o Modify the CAM XPT_BUS_RESET ccb handler to wait for and
properly handle the status of the bus reset task management
frame used to reset the bus. The previous code assumed that
the reset request would always succeed.
o Add timeout recovery support. When a timeout occurs, the
timed-out request is added to a queue to be processed by
our recovery thread and the thread is woken up. The recovery
thread processes timed-out command serially, attempting first
to abort them and then falling back to a bus reset if an
abort fails.
o Add calls to mpt_reset() to reset the controller if any
handshake command, bus reset attempt or abort attempt
fails due to a timeout.
o Export a secondary "bus" to CAM that exposes all volume drive
members as pass-thru devices, allowing CAM to perform proper
speed negotiation to hidden devices.
o Add a CAM async event handler tracking the AC_FOUND_DEVICE event.
Use this to trigger calls to set the per-volume queue depth once
the volume is fully registered with CAM. This is required to avoid
hitting firmware limits on volume queue depth. Exceeding the
limit causes the firmware to hang.
mpt_cam.h:
o Add several helper functions for interfacing to CAM and
performing timeout recovery.
mpt_pci.c:
o Disable interrupts on the controller before registering and
enabling interrupt delivery to the OS. Otherwise we risk
receiving interrupts before the driver is ready to receive
them.
o Make use of compatibility macros that allow the driver to
be compiled under 4.x and 5.x.
mpt_raid.c:
o Add a per-controller instance RAID thread to perform settings
changes and query status (minimizes CPU busy wait loops).
o Use a shutdown handler to disable "Member Write Cache Enable"
(MWCE) setting for RAID arrays set to enable MWCE During Rebuild.
o Change reply handler function signature to allow handlers to defer
the deletion of reply frames. Use this to allow the event reply
handler to queue up events that need to be acked if no resources
are available to immediately ack an event. Queued events are
processed in mpt_free_request() where resources are freed. This
avoids a panic on resource shortage.
o Parse and print out RAID controller capabilities during driver probe.
o Define, allocate, and maintain RAID data structures for volumes,
hidden member physical disks and spare disks.
o Add dynamic sysctls for per-instance setting of the log level, array
resync rate, array member cache enable, and volume queue depth.
mpt_debug.c:
o Add mpt_lprt and mpt_lprtc for printing diagnostics conditioned on
a particular log level to aid in tracking down driver issues.
o Add mpt_decode_value() which parses the bits in an integer
value based on a parsing table (mask, value, name string, tuples).
mpilib/*:
o Update mpi library header files to latest distribution from LSI.
Submitted by: gibbs
Approved by: re
2005-07-10 15:05:39 +00:00
|
|
|
* 06-26-03 01.02.07 Added MPI_SCSI_STATUS_FCPEXT_UNASSIGNED define.
|
2006-01-21 00:29:52 +00:00
|
|
|
* 05-11-04 01.03.01 Original release for MPI v1.3.
|
|
|
|
|
* 08-19-04 01.05.01 Added MsgFlags defines for EEDP to SCSI IO request.
|
|
|
|
|
* Added new word to MSG_SCSI_IO_REPLY to add TaskTag field
|
|
|
|
|
* and a reserved U16.
|
|
|
|
|
* Added new MSG_SCSI_IO32_REQUEST structure.
|
|
|
|
|
* Added a TaskType of Clear Task Set to SCSI
|
|
|
|
|
* Task Management request.
|
|
|
|
|
* 12-07-04 01.05.02 Added support for Task Management Query Task.
|
|
|
|
|
* 01-15-05 01.05.03 Modified SCSI Enclosure Processor Request to support
|
|
|
|
|
* WWID addressing.
|
|
|
|
|
* 03-11-05 01.05.04 Removed EEDP flags from SCSI IO Request.
|
|
|
|
|
* Removed SCSI IO 32 Request.
|
|
|
|
|
* Modified SCSI Enclosure Processor Request and Reply to
|
|
|
|
|
* support Enclosure/Slot addressing rather than WWID
|
|
|
|
|
* addressing.
|
|
|
|
|
* 06-24-05 01.05.05 Added SCSI IO 32 structures and defines.
|
|
|
|
|
* Added four new defines for SEP SlotStatus.
|
|
|
|
|
* 08-03-05 01.05.06 Fixed some MPI_SCSIIO32_MSGFLGS_ defines to make them
|
|
|
|
|
* unique in the first 32 characters.
|
2007-06-03 22:58:27 +00:00
|
|
|
* 03-27-06 01.05.07 Added Task Management type of Clear ACA.
|
|
|
|
|
* 10-11-06 01.05.08 Shortened define for Task Management type of Clear ACA.
|
|
|
|
|
* 02-28-07 01.05.09 Defined two new MsgFlags bits for SCSI Task Management
|
|
|
|
|
* Request: Do Not Send Task IU and Soft Reset Option.
|
2002-08-11 23:34:20 +00:00
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef MPI_INIT_H
|
|
|
|
|
#define MPI_INIT_H
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
*
|
|
|
|
|
* S C S I I n i t i a t o r M e s s a g e s
|
|
|
|
|
*
|
|
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
/****************************************************************************/
|
2006-01-21 00:29:52 +00:00
|
|
|
/* SCSI IO messages and associated structures */
|
2002-08-11 23:34:20 +00:00
|
|
|
/****************************************************************************/
|
|
|
|
|
|
|
|
|
|
typedef struct _MSG_SCSI_IO_REQUEST
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U8 ChainOffset; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 CDBLength; /* 04h */
|
|
|
|
|
U8 SenseBufferLength; /* 05h */
|
|
|
|
|
U8 Reserved; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U8 LUN[8]; /* 0Ch */
|
|
|
|
|
U32 Control; /* 14h */
|
|
|
|
|
U8 CDB[16]; /* 18h */
|
|
|
|
|
U32 DataLength; /* 28h */
|
|
|
|
|
U32 SenseBufferLowAddr; /* 2Ch */
|
|
|
|
|
SGE_IO_UNION SGL; /* 30h */
|
|
|
|
|
} MSG_SCSI_IO_REQUEST, MPI_POINTER PTR_MSG_SCSI_IO_REQUEST,
|
|
|
|
|
SCSIIORequest_t, MPI_POINTER pSCSIIORequest_t;
|
|
|
|
|
|
|
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
/* SCSI IO MsgFlags bits */
|
2002-08-11 23:34:20 +00:00
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
#define MPI_SCSIIO_MSGFLGS_SENSE_WIDTH (0x01)
|
|
|
|
|
#define MPI_SCSIIO_MSGFLGS_SENSE_WIDTH_32 (0x00)
|
|
|
|
|
#define MPI_SCSIIO_MSGFLGS_SENSE_WIDTH_64 (0x01)
|
2006-01-21 00:29:52 +00:00
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
#define MPI_SCSIIO_MSGFLGS_SENSE_LOCATION (0x02)
|
|
|
|
|
#define MPI_SCSIIO_MSGFLGS_SENSE_LOC_HOST (0x00)
|
|
|
|
|
#define MPI_SCSIIO_MSGFLGS_SENSE_LOC_IOC (0x02)
|
2006-01-21 00:29:52 +00:00
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
#define MPI_SCSIIO_MSGFLGS_CMD_DETERMINES_DATA_DIR (0x04)
|
2002-08-11 23:34:20 +00:00
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
/* SCSI IO LUN fields */
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
#define MPI_SCSIIO_LUN_FIRST_LEVEL_ADDRESSING (0x0000FFFF)
|
|
|
|
|
#define MPI_SCSIIO_LUN_SECOND_LEVEL_ADDRESSING (0xFFFF0000)
|
|
|
|
|
#define MPI_SCSIIO_LUN_THIRD_LEVEL_ADDRESSING (0x0000FFFF)
|
|
|
|
|
#define MPI_SCSIIO_LUN_FOURTH_LEVEL_ADDRESSING (0xFFFF0000)
|
|
|
|
|
#define MPI_SCSIIO_LUN_LEVEL_1_WORD (0xFF00)
|
|
|
|
|
#define MPI_SCSIIO_LUN_LEVEL_1_DWORD (0x0000FF00)
|
|
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
/* SCSI IO Control bits */
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_DATADIRECTION_MASK (0x03000000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_NODATATRANSFER (0x00000000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_WRITE (0x01000000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_READ (0x02000000)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_ADDCDBLEN_MASK (0x3C000000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_ADDCDBLEN_SHIFT (26)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_TASKATTRIBUTE_MASK (0x00000700)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_SIMPLEQ (0x00000000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_HEADOFQ (0x00000100)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_ORDEREDQ (0x00000200)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_ACAQ (0x00000400)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_UNTAGGED (0x00000500)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_NO_DISCONNECT (0x00000700)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_TASKMANAGE_MASK (0x00FF0000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_OBSOLETE (0x00800000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_CLEAR_ACA_RSV (0x00400000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_TARGET_RESET (0x00200000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_LUN_RESET_RSV (0x00100000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_RESERVED (0x00080000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_CLR_TASK_SET_RSV (0x00040000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_ABORT_TASK_SET (0x00020000)
|
|
|
|
|
#define MPI_SCSIIO_CONTROL_RESERVED2 (0x00010000)
|
|
|
|
|
|
|
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
/* SCSI IO reply structure */
|
2002-08-11 23:34:20 +00:00
|
|
|
typedef struct _MSG_SCSI_IO_REPLY
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U8 MsgLength; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 CDBLength; /* 04h */
|
|
|
|
|
U8 SenseBufferLength; /* 05h */
|
|
|
|
|
U8 Reserved; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U8 SCSIStatus; /* 0Ch */
|
|
|
|
|
U8 SCSIState; /* 0Dh */
|
|
|
|
|
U16 IOCStatus; /* 0Eh */
|
|
|
|
|
U32 IOCLogInfo; /* 10h */
|
|
|
|
|
U32 TransferCount; /* 14h */
|
|
|
|
|
U32 SenseCount; /* 18h */
|
|
|
|
|
U32 ResponseInfo; /* 1Ch */
|
2006-01-21 00:29:52 +00:00
|
|
|
U16 TaskTag; /* 20h */
|
|
|
|
|
U16 Reserved1; /* 22h */
|
2002-08-11 23:34:20 +00:00
|
|
|
} MSG_SCSI_IO_REPLY, MPI_POINTER PTR_MSG_SCSI_IO_REPLY,
|
|
|
|
|
SCSIIOReply_t, MPI_POINTER pSCSIIOReply_t;
|
|
|
|
|
|
|
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
/* SCSI IO Reply SCSIStatus values (SAM-2 status codes) */
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
#define MPI_SCSI_STATUS_SUCCESS (0x00)
|
|
|
|
|
#define MPI_SCSI_STATUS_CHECK_CONDITION (0x02)
|
|
|
|
|
#define MPI_SCSI_STATUS_CONDITION_MET (0x04)
|
|
|
|
|
#define MPI_SCSI_STATUS_BUSY (0x08)
|
|
|
|
|
#define MPI_SCSI_STATUS_INTERMEDIATE (0x10)
|
|
|
|
|
#define MPI_SCSI_STATUS_INTERMEDIATE_CONDMET (0x14)
|
|
|
|
|
#define MPI_SCSI_STATUS_RESERVATION_CONFLICT (0x18)
|
|
|
|
|
#define MPI_SCSI_STATUS_COMMAND_TERMINATED (0x22)
|
|
|
|
|
#define MPI_SCSI_STATUS_TASK_SET_FULL (0x28)
|
|
|
|
|
#define MPI_SCSI_STATUS_ACA_ACTIVE (0x30)
|
|
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
#define MPI_SCSI_STATUS_FCPEXT_DEVICE_LOGGED_OUT (0x80)
|
|
|
|
|
#define MPI_SCSI_STATUS_FCPEXT_NO_LINK (0x81)
|
Massive overhaul of MPT Fusion driver:
o Add timeout error recovery (from a thread context to avoid
the deferral of other critical interrupts).
o Properly recover commands across controller reset events.
o Update the driver to handle events and status codes that
have been added to the MPI spec since the driver was
originally written.
o Make the driver more modular to improve maintainability and
support dynamic "personality" registration (e.g. SCSI Initiator,
RAID, SAS, FC, etc).
o Shorten and simplify the common I/O path to improve driver
performance.
o Add RAID volume and RAID member state/settings reporting.
o Add periodic volume resynchronization status reporting.
o Add support for sysctl tunable resync rate, member write cache
enable, and volume transaction queue depth.
Sponsored by
----------------
Avid Technologies Inc:
SCSI error recovery, driver re-organization, update of MPI library
headers, portions of dynamic personality registration, and misc bug
fixes.
Wheel Open Technologies:
RAID event notification, RAID member pass-thru support, firmware
upload/download support, enhanced RAID resync speed, portions
of dynamic personality registration, and misc bug fixes.
Detailed Changes
================
mpt.c mpt_cam.c mpt_raid.c mpt_pci.c:
o Add support for personality modules. Each module exports
load, and unload module scope methods as well as probe, attach,
event, reset, shutdown, and detach per-device instance
methods
mpt.c mpt.h mpt_pci.c:
o The driver now associates a callback function (via an
index) with every transaction submitted to the controller.
This allows the main interrupt handler to absolve itself
of any knowledge of individual transaction/response types
by simply calling the callback function "registered" for
the transaction. We use a callback index instead of a
callback function pointer in each requests so we can
properly handle responses (e.g. event notifications)
that are not associated with a transaction. Personality
modules dynamically register their callbacks with the
driver core to receive the callback index to use for their
handlers.
o Move the interrupt handler into mpt.c. The ISR algorithm
is bus transport and OS independent and thus had no reason
to be in mpt_pci.c.
o Simplify configuration message reply handling by copying
reply frame data for the requester and storing completion
status in the original request structure.
o Add the mpt_complete_request_chain() helper method and use
it to implement reset handlers that must abort transactions.
o Keep track of all pending requests on the new
requests_pending_list in the softc.
o Add default handlers to mpt.c to handle generic event
notifications and controller reset activities. The event
handler code is largely the same as in the original driver.
The reset handler is new and terminates any pending transactions
with a status code indicating the controller needs to be
re-initialized.
o Add some endian support to the driver. A complete audit is
still required for this driver to have any hope of operating
in a big-endian environment.
o Use inttypes.h and __inline. Come closer to being style(9)
compliant.
o Remove extraneous use of typedefs.
o Convert request state from a strict enumeration to a series
of flags. This allows us to, for example, tag transactions
that have timed-out while retaining the state that the
transaction is still in-flight on the controller.
o Add mpt_wait_req() which allows a caller to poll or sleep
for the completion of a request. Use this to simplify
and factor code out from many initialization routines.
We also use this to sleep for task management request
completions in our CAM timeout handler.
mpt.c:
o Correct a bug in the event handler where request structures were
freed even if the request reply was marked as a continuation
reply. Continuation replies indicate that the controller still owns
the request and freeing these replies prematurely corrupted
controller state.
o Implement firmware upload and download. On controllers that do
not have dedicated NVRAM (as in the Sun v20/v40z), the firmware
image is downloaded to the controller by the system BIOS. This
image occupies precious controller RAM space until the host driver
fetches the image, reducing the number of concurrent I/Os the
controller can processes. The uploaded image is used to
re-program the controller during hard reset events since the
controller cannot fetch the firmware on its own. Implementing this
feature allows much higher queue depths when RAID volumes
are configured.
o Changed configuration page accessors to allow threads to sleep
rather than busy wait for completion.
o Removed hard coded data transfer sizes from configuration page
routines so that RAID configuration page processing is possible.
mpt_reg.h:
o Move controller register definitions into a separate file.
mpt.h:
o Re-arrange includes to allow inlined functions to be
defined in mpt.h.
o Add reply, event, and reset handler definitions.
o Add softc fields for handling timeout and controller
reset recovery.
mpt_cam.c:
o Move mpt_freebsd.c to mpt_cam.c. Move all core functionality,
such as event handling, into mpt.c leaving only CAM SCSI
support here.
o Revamp completion handler to provide correct CAM status for
all currently defined SCSI MPI message result codes.
o Register event and reset handlers with the MPT core. Modify
the event handler to notify CAM of bus reset events. The
controller reset handler will abort any transactions that
have timed out. All other pending CAM transactions are
correctly aborted by the core driver's reset handler.
o Allocate a single request up front to perform task management
operations. This guarantees that we can always perform a
TMF operation even when the controller is saturated with other
operations. The single request also serves as a perfect
mechanism of guaranteeing that only a single TMF is in flight
at a time - something that is required according to the MPT
Fusion documentation.
o Add a helper function for issuing task management requests
to the controller. This is used to abort individual requests
or perform a bus reset.
o Modify the CAM XPT_BUS_RESET ccb handler to wait for and
properly handle the status of the bus reset task management
frame used to reset the bus. The previous code assumed that
the reset request would always succeed.
o Add timeout recovery support. When a timeout occurs, the
timed-out request is added to a queue to be processed by
our recovery thread and the thread is woken up. The recovery
thread processes timed-out command serially, attempting first
to abort them and then falling back to a bus reset if an
abort fails.
o Add calls to mpt_reset() to reset the controller if any
handshake command, bus reset attempt or abort attempt
fails due to a timeout.
o Export a secondary "bus" to CAM that exposes all volume drive
members as pass-thru devices, allowing CAM to perform proper
speed negotiation to hidden devices.
o Add a CAM async event handler tracking the AC_FOUND_DEVICE event.
Use this to trigger calls to set the per-volume queue depth once
the volume is fully registered with CAM. This is required to avoid
hitting firmware limits on volume queue depth. Exceeding the
limit causes the firmware to hang.
mpt_cam.h:
o Add several helper functions for interfacing to CAM and
performing timeout recovery.
mpt_pci.c:
o Disable interrupts on the controller before registering and
enabling interrupt delivery to the OS. Otherwise we risk
receiving interrupts before the driver is ready to receive
them.
o Make use of compatibility macros that allow the driver to
be compiled under 4.x and 5.x.
mpt_raid.c:
o Add a per-controller instance RAID thread to perform settings
changes and query status (minimizes CPU busy wait loops).
o Use a shutdown handler to disable "Member Write Cache Enable"
(MWCE) setting for RAID arrays set to enable MWCE During Rebuild.
o Change reply handler function signature to allow handlers to defer
the deletion of reply frames. Use this to allow the event reply
handler to queue up events that need to be acked if no resources
are available to immediately ack an event. Queued events are
processed in mpt_free_request() where resources are freed. This
avoids a panic on resource shortage.
o Parse and print out RAID controller capabilities during driver probe.
o Define, allocate, and maintain RAID data structures for volumes,
hidden member physical disks and spare disks.
o Add dynamic sysctls for per-instance setting of the log level, array
resync rate, array member cache enable, and volume queue depth.
mpt_debug.c:
o Add mpt_lprt and mpt_lprtc for printing diagnostics conditioned on
a particular log level to aid in tracking down driver issues.
o Add mpt_decode_value() which parses the bits in an integer
value based on a parsing table (mask, value, name string, tuples).
mpilib/*:
o Update mpi library header files to latest distribution from LSI.
Submitted by: gibbs
Approved by: re
2005-07-10 15:05:39 +00:00
|
|
|
#define MPI_SCSI_STATUS_FCPEXT_UNASSIGNED (0x82)
|
2002-08-11 23:34:20 +00:00
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
|
|
|
|
|
/* SCSI IO Reply SCSIState values */
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
#define MPI_SCSI_STATE_AUTOSENSE_VALID (0x01)
|
|
|
|
|
#define MPI_SCSI_STATE_AUTOSENSE_FAILED (0x02)
|
|
|
|
|
#define MPI_SCSI_STATE_NO_SCSI_STATUS (0x04)
|
|
|
|
|
#define MPI_SCSI_STATE_TERMINATED (0x08)
|
|
|
|
|
#define MPI_SCSI_STATE_RESPONSE_INFO_VALID (0x10)
|
|
|
|
|
#define MPI_SCSI_STATE_QUEUE_TAG_REJECTED (0x20)
|
|
|
|
|
|
2003-06-03 17:47:48 +00:00
|
|
|
/* SCSI IO Reply ResponseInfo values */
|
2002-08-11 23:34:20 +00:00
|
|
|
/* (FCP-1 RSP_CODE values and SPI-3 Packetized Failure codes) */
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_FUNCTION_COMPLETE (0x00000000)
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_FCP_BURST_LEN_ERROR (0x01000000)
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_CMND_FIELDS_INVALID (0x02000000)
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_FCP_DATA_RO_ERROR (0x03000000)
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_TASK_MGMT_UNSUPPORTED (0x04000000)
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_TASK_MGMT_FAILED (0x05000000)
|
|
|
|
|
#define MPI_SCSI_RSP_INFO_SPI_LQ_INVALID_TYPE (0x06000000)
|
|
|
|
|
|
2006-01-21 00:29:52 +00:00
|
|
|
#define MPI_SCSI_TASKTAG_UNKNOWN (0xFFFF)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************/
|
|
|
|
|
/* SCSI IO 32 messages and associated structures */
|
|
|
|
|
/****************************************************************************/
|
|
|
|
|
|
|
|
|
|
typedef struct
|
|
|
|
|
{
|
|
|
|
|
U8 CDB[20]; /* 00h */
|
|
|
|
|
U32 PrimaryReferenceTag; /* 14h */
|
|
|
|
|
U16 PrimaryApplicationTag; /* 18h */
|
|
|
|
|
U16 PrimaryApplicationTagMask; /* 1Ah */
|
|
|
|
|
U32 TransferLength; /* 1Ch */
|
|
|
|
|
} MPI_SCSI_IO32_CDB_EEDP32, MPI_POINTER PTR_MPI_SCSI_IO32_CDB_EEDP32,
|
|
|
|
|
MpiScsiIo32CdbEedp32_t, MPI_POINTER pMpiScsiIo32CdbEedp32_t;
|
|
|
|
|
|
|
|
|
|
typedef struct
|
|
|
|
|
{
|
|
|
|
|
U8 CDB[16]; /* 00h */
|
|
|
|
|
U32 DataLength; /* 10h */
|
|
|
|
|
U32 PrimaryReferenceTag; /* 14h */
|
|
|
|
|
U16 PrimaryApplicationTag; /* 18h */
|
|
|
|
|
U16 PrimaryApplicationTagMask; /* 1Ah */
|
|
|
|
|
U32 TransferLength; /* 1Ch */
|
|
|
|
|
} MPI_SCSI_IO32_CDB_EEDP16, MPI_POINTER PTR_MPI_SCSI_IO32_CDB_EEDP16,
|
|
|
|
|
MpiScsiIo32CdbEedp16_t, MPI_POINTER pMpiScsiIo32CdbEedp16_t;
|
|
|
|
|
|
|
|
|
|
typedef union
|
|
|
|
|
{
|
|
|
|
|
U8 CDB32[32];
|
|
|
|
|
MPI_SCSI_IO32_CDB_EEDP32 EEDP32;
|
|
|
|
|
MPI_SCSI_IO32_CDB_EEDP16 EEDP16;
|
|
|
|
|
SGE_SIMPLE_UNION SGE;
|
|
|
|
|
} MPI_SCSI_IO32_CDB_UNION, MPI_POINTER PTR_MPI_SCSI_IO32_CDB_UNION,
|
|
|
|
|
MpiScsiIo32Cdb_t, MPI_POINTER pMpiScsiIo32Cdb_t;
|
|
|
|
|
|
|
|
|
|
typedef struct
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U16 Reserved1; /* 02h */
|
|
|
|
|
U32 Reserved2; /* 04h */
|
|
|
|
|
} MPI_SCSI_IO32_BUS_TARGET_ID_FORM, MPI_POINTER PTR_MPI_SCSI_IO32_BUS_TARGET_ID_FORM,
|
|
|
|
|
MpiScsiIo32BusTargetIdForm_t, MPI_POINTER pMpiScsiIo32BusTargetIdForm_t;
|
|
|
|
|
|
|
|
|
|
typedef union
|
|
|
|
|
{
|
|
|
|
|
MPI_SCSI_IO32_BUS_TARGET_ID_FORM SCSIID;
|
|
|
|
|
U64 WWID;
|
|
|
|
|
} MPI_SCSI_IO32_ADDRESS, MPI_POINTER PTR_MPI_SCSI_IO32_ADDRESS,
|
|
|
|
|
MpiScsiIo32Address_t, MPI_POINTER pMpiScsiIo32Address_t;
|
|
|
|
|
|
|
|
|
|
typedef struct _MSG_SCSI_IO32_REQUEST
|
|
|
|
|
{
|
|
|
|
|
U8 Port; /* 00h */
|
|
|
|
|
U8 Reserved1; /* 01h */
|
|
|
|
|
U8 ChainOffset; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 CDBLength; /* 04h */
|
|
|
|
|
U8 SenseBufferLength; /* 05h */
|
|
|
|
|
U8 Flags; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U8 LUN[8]; /* 0Ch */
|
|
|
|
|
U32 Control; /* 14h */
|
|
|
|
|
MPI_SCSI_IO32_CDB_UNION CDB; /* 18h */
|
|
|
|
|
U32 DataLength; /* 38h */
|
|
|
|
|
U32 BidirectionalDataLength; /* 3Ch */
|
|
|
|
|
U32 SecondaryReferenceTag; /* 40h */
|
|
|
|
|
U16 SecondaryApplicationTag; /* 44h */
|
|
|
|
|
U16 Reserved2; /* 46h */
|
|
|
|
|
U16 EEDPFlags; /* 48h */
|
|
|
|
|
U16 ApplicationTagTranslationMask; /* 4Ah */
|
|
|
|
|
U32 EEDPBlockSize; /* 4Ch */
|
|
|
|
|
MPI_SCSI_IO32_ADDRESS DeviceAddress; /* 50h */
|
|
|
|
|
U8 SGLOffset0; /* 58h */
|
|
|
|
|
U8 SGLOffset1; /* 59h */
|
|
|
|
|
U8 SGLOffset2; /* 5Ah */
|
|
|
|
|
U8 SGLOffset3; /* 5Bh */
|
|
|
|
|
U32 Reserved3; /* 5Ch */
|
|
|
|
|
U32 Reserved4; /* 60h */
|
|
|
|
|
U32 SenseBufferLowAddr; /* 64h */
|
|
|
|
|
SGE_IO_UNION SGL; /* 68h */
|
|
|
|
|
} MSG_SCSI_IO32_REQUEST, MPI_POINTER PTR_MSG_SCSI_IO32_REQUEST,
|
|
|
|
|
SCSIIO32Request_t, MPI_POINTER pSCSIIO32Request_t;
|
|
|
|
|
|
|
|
|
|
/* SCSI IO 32 MsgFlags bits */
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_SENSE_WIDTH (0x01)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_32_SENSE_WIDTH (0x00)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_64_SENSE_WIDTH (0x01)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_SENSE_LOCATION (0x02)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_SENSE_LOC_HOST (0x00)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_SENSE_LOC_IOC (0x02)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_CMD_DETERMINES_DATA_DIR (0x04)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_SGL_OFFSETS_CHAINS (0x08)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_MULTICAST (0x10)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_BIDIRECTIONAL (0x20)
|
|
|
|
|
#define MPI_SCSIIO32_MSGFLGS_LARGE_CDB (0x40)
|
|
|
|
|
|
|
|
|
|
/* SCSI IO 32 Flags bits */
|
|
|
|
|
#define MPI_SCSIIO32_FLAGS_FORM_MASK (0x03)
|
|
|
|
|
#define MPI_SCSIIO32_FLAGS_FORM_SCSIID (0x00)
|
|
|
|
|
#define MPI_SCSIIO32_FLAGS_FORM_WWID (0x01)
|
|
|
|
|
|
|
|
|
|
/* SCSI IO 32 LUN fields */
|
|
|
|
|
#define MPI_SCSIIO32_LUN_FIRST_LEVEL_ADDRESSING (0x0000FFFF)
|
|
|
|
|
#define MPI_SCSIIO32_LUN_SECOND_LEVEL_ADDRESSING (0xFFFF0000)
|
|
|
|
|
#define MPI_SCSIIO32_LUN_THIRD_LEVEL_ADDRESSING (0x0000FFFF)
|
|
|
|
|
#define MPI_SCSIIO32_LUN_FOURTH_LEVEL_ADDRESSING (0xFFFF0000)
|
|
|
|
|
#define MPI_SCSIIO32_LUN_LEVEL_1_WORD (0xFF00)
|
|
|
|
|
#define MPI_SCSIIO32_LUN_LEVEL_1_DWORD (0x0000FF00)
|
|
|
|
|
|
|
|
|
|
/* SCSI IO 32 Control bits */
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_DATADIRECTION_MASK (0x03000000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_NODATATRANSFER (0x00000000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_WRITE (0x01000000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_READ (0x02000000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_BIDIRECTIONAL (0x03000000)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_ADDCDBLEN_MASK (0xFC000000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_ADDCDBLEN_SHIFT (26)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_TASKATTRIBUTE_MASK (0x00000700)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_SIMPLEQ (0x00000000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_HEADOFQ (0x00000100)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_ORDEREDQ (0x00000200)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_ACAQ (0x00000400)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_UNTAGGED (0x00000500)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_NO_DISCONNECT (0x00000700)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_TASKMANAGE_MASK (0x00FF0000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_OBSOLETE (0x00800000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_CLEAR_ACA_RSV (0x00400000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_TARGET_RESET (0x00200000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_LUN_RESET_RSV (0x00100000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_RESERVED (0x00080000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_CLR_TASK_SET_RSV (0x00040000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_ABORT_TASK_SET (0x00020000)
|
|
|
|
|
#define MPI_SCSIIO32_CONTROL_RESERVED2 (0x00010000)
|
|
|
|
|
|
|
|
|
|
/* SCSI IO 32 EEDPFlags */
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_MASK_OP (0x0007)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_NOOP_OP (0x0000)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_CHK_OP (0x0001)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_STRIP_OP (0x0002)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_CHKRM_OP (0x0003)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_INSERT_OP (0x0004)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_REPLACE_OP (0x0006)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_CHKREGEN_OP (0x0007)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_PASS_REF_TAG (0x0008)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_8_9THS_MODE (0x0010)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_T10_CHK_MASK (0x0700)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_T10_CHK_GUARD (0x0100)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_T10_CHK_REFTAG (0x0200)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_T10_CHK_LBATAG (0x0400)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_T10_CHK_SHIFT (8)
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_INC_SEC_APPTAG (0x1000)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_INC_PRI_APPTAG (0x2000)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_INC_SEC_REFTAG (0x4000)
|
|
|
|
|
#define MPI_SCSIIO32_EEDPFLAGS_INC_PRI_REFTAG (0x8000)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* SCSIIO32 IO reply structure */
|
|
|
|
|
typedef struct _MSG_SCSIIO32_IO_REPLY
|
|
|
|
|
{
|
|
|
|
|
U8 Port; /* 00h */
|
|
|
|
|
U8 Reserved1; /* 01h */
|
|
|
|
|
U8 MsgLength; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 CDBLength; /* 04h */
|
|
|
|
|
U8 SenseBufferLength; /* 05h */
|
|
|
|
|
U8 Flags; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U8 SCSIStatus; /* 0Ch */
|
|
|
|
|
U8 SCSIState; /* 0Dh */
|
|
|
|
|
U16 IOCStatus; /* 0Eh */
|
|
|
|
|
U32 IOCLogInfo; /* 10h */
|
|
|
|
|
U32 TransferCount; /* 14h */
|
|
|
|
|
U32 SenseCount; /* 18h */
|
|
|
|
|
U32 ResponseInfo; /* 1Ch */
|
|
|
|
|
U16 TaskTag; /* 20h */
|
|
|
|
|
U16 Reserved2; /* 22h */
|
|
|
|
|
U32 BidirectionalTransferCount; /* 24h */
|
|
|
|
|
} MSG_SCSIIO32_IO_REPLY, MPI_POINTER PTR_MSG_SCSIIO32_IO_REPLY,
|
|
|
|
|
SCSIIO32Reply_t, MPI_POINTER pSCSIIO32Reply_t;
|
|
|
|
|
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
/****************************************************************************/
|
|
|
|
|
/* SCSI Task Management messages */
|
|
|
|
|
/****************************************************************************/
|
|
|
|
|
|
|
|
|
|
typedef struct _MSG_SCSI_TASK_MGMT
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U8 ChainOffset; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 Reserved; /* 04h */
|
|
|
|
|
U8 TaskType; /* 05h */
|
|
|
|
|
U8 Reserved1; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U8 LUN[8]; /* 0Ch */
|
|
|
|
|
U32 Reserved2[7]; /* 14h */
|
|
|
|
|
U32 TaskMsgContext; /* 30h */
|
|
|
|
|
} MSG_SCSI_TASK_MGMT, MPI_POINTER PTR_SCSI_TASK_MGMT,
|
|
|
|
|
SCSITaskMgmt_t, MPI_POINTER pSCSITaskMgmt_t;
|
|
|
|
|
|
|
|
|
|
/* TaskType values */
|
|
|
|
|
|
|
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_ABORT_TASK (0x01)
|
|
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_ABRT_TASK_SET (0x02)
|
|
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_TARGET_RESET (0x03)
|
|
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_RESET_BUS (0x04)
|
|
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_LOGICAL_UNIT_RESET (0x05)
|
2006-01-21 00:29:52 +00:00
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_CLEAR_TASK_SET (0x06)
|
|
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_QUERY_TASK (0x07)
|
2007-06-03 22:58:27 +00:00
|
|
|
#define MPI_SCSITASKMGMT_TASKTYPE_CLR_ACA (0x08)
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
/* MsgFlags bits */
|
2007-06-03 22:58:27 +00:00
|
|
|
#define MPI_SCSITASKMGMT_MSGFLAGS_DO_NOT_SEND_TASK_IU (0x01)
|
|
|
|
|
|
2002-08-11 23:34:20 +00:00
|
|
|
#define MPI_SCSITASKMGMT_MSGFLAGS_TARGET_RESET_OPTION (0x00)
|
|
|
|
|
#define MPI_SCSITASKMGMT_MSGFLAGS_LIP_RESET_OPTION (0x02)
|
|
|
|
|
#define MPI_SCSITASKMGMT_MSGFLAGS_LIPRESET_RESET_OPTION (0x04)
|
|
|
|
|
|
2007-06-03 22:58:27 +00:00
|
|
|
#define MPI_SCSITASKMGMT_MSGFLAGS_SOFT_RESET_OPTION (0x08)
|
|
|
|
|
|
2002-08-11 23:34:20 +00:00
|
|
|
/* SCSI Task Management Reply */
|
|
|
|
|
typedef struct _MSG_SCSI_TASK_MGMT_REPLY
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U8 MsgLength; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
2006-01-21 00:29:52 +00:00
|
|
|
U8 ResponseCode; /* 04h */
|
2002-08-11 23:34:20 +00:00
|
|
|
U8 TaskType; /* 05h */
|
|
|
|
|
U8 Reserved1; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U8 Reserved2[2]; /* 0Ch */
|
|
|
|
|
U16 IOCStatus; /* 0Eh */
|
|
|
|
|
U32 IOCLogInfo; /* 10h */
|
|
|
|
|
U32 TerminationCount; /* 14h */
|
|
|
|
|
} MSG_SCSI_TASK_MGMT_REPLY, MPI_POINTER PTR_MSG_SCSI_TASK_MGMT_REPLY,
|
|
|
|
|
SCSITaskMgmtReply_t, MPI_POINTER pSCSITaskMgmtReply_t;
|
|
|
|
|
|
2006-01-21 00:29:52 +00:00
|
|
|
/* ResponseCode values */
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_TM_COMPLETE (0x00)
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_INVALID_FRAME (0x02)
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_TM_NOT_SUPPORTED (0x04)
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_TM_FAILED (0x05)
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_TM_SUCCEEDED (0x08)
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_TM_INVALID_LUN (0x09)
|
|
|
|
|
#define MPI_SCSITASKMGMT_RSP_IO_QUEUED_ON_IOC (0x80)
|
|
|
|
|
|
2002-08-11 23:34:20 +00:00
|
|
|
|
|
|
|
|
/****************************************************************************/
|
|
|
|
|
/* SCSI Enclosure Processor messages */
|
|
|
|
|
/****************************************************************************/
|
|
|
|
|
|
|
|
|
|
typedef struct _MSG_SEP_REQUEST
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U8 ChainOffset; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 Action; /* 04h */
|
2006-01-21 00:29:52 +00:00
|
|
|
U8 Flags; /* 05h */
|
|
|
|
|
U8 Reserved1; /* 06h */
|
2002-08-11 23:34:20 +00:00
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U32 SlotStatus; /* 0Ch */
|
2006-01-21 00:29:52 +00:00
|
|
|
U32 Reserved2; /* 10h */
|
|
|
|
|
U32 Reserved3; /* 14h */
|
|
|
|
|
U32 Reserved4; /* 18h */
|
|
|
|
|
U16 Slot; /* 1Ch */
|
|
|
|
|
U16 EnclosureHandle; /* 1Eh */
|
2002-08-11 23:34:20 +00:00
|
|
|
} MSG_SEP_REQUEST, MPI_POINTER PTR_MSG_SEP_REQUEST,
|
|
|
|
|
SEPRequest_t, MPI_POINTER pSEPRequest_t;
|
|
|
|
|
|
|
|
|
|
/* Action defines */
|
|
|
|
|
#define MPI_SEP_REQ_ACTION_WRITE_STATUS (0x00)
|
|
|
|
|
#define MPI_SEP_REQ_ACTION_READ_STATUS (0x01)
|
|
|
|
|
|
2006-01-21 00:29:52 +00:00
|
|
|
/* Flags defines */
|
|
|
|
|
#define MPI_SEP_REQ_FLAGS_ENCLOSURE_SLOT_ADDRESS (0x01)
|
|
|
|
|
#define MPI_SEP_REQ_FLAGS_BUS_TARGETID_ADDRESS (0x00)
|
|
|
|
|
|
2002-08-11 23:34:20 +00:00
|
|
|
/* SlotStatus bits for MSG_SEP_REQUEST */
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_NO_ERROR (0x00000001)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_DEV_FAULTY (0x00000002)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_DEV_REBUILDING (0x00000004)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_IN_FAILED_ARRAY (0x00000008)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_IN_CRITICAL_ARRAY (0x00000010)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_PARITY_CHECK (0x00000020)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_PREDICTED_FAULT (0x00000040)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_UNCONFIGURED (0x00000080)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_HOT_SPARE (0x00000100)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_REBUILD_STOPPED (0x00000200)
|
2006-01-21 00:29:52 +00:00
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_REQ_CONSISTENCY_CHECK (0x00001000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_DISABLE (0x00002000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_REQ_RESERVED_DEVICE (0x00004000)
|
2002-08-11 23:34:20 +00:00
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_IDENTIFY_REQUEST (0x00020000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_REQUEST_REMOVE (0x00040000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_REQUEST_INSERT (0x00080000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_DO_NOT_MOVE (0x00400000)
|
2006-01-21 00:29:52 +00:00
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_ACTIVE (0x00800000)
|
2002-08-11 23:34:20 +00:00
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_B_ENABLE_BYPASS (0x04000000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_A_ENABLE_BYPASS (0x08000000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_DEV_OFF (0x10000000)
|
|
|
|
|
#define MPI_SEP_REQ_SLOTSTATUS_SWAP_RESET (0x80000000)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
typedef struct _MSG_SEP_REPLY
|
|
|
|
|
{
|
|
|
|
|
U8 TargetID; /* 00h */
|
|
|
|
|
U8 Bus; /* 01h */
|
|
|
|
|
U8 MsgLength; /* 02h */
|
|
|
|
|
U8 Function; /* 03h */
|
|
|
|
|
U8 Action; /* 04h */
|
|
|
|
|
U8 Reserved1; /* 05h */
|
|
|
|
|
U8 Reserved2; /* 06h */
|
|
|
|
|
U8 MsgFlags; /* 07h */
|
|
|
|
|
U32 MsgContext; /* 08h */
|
|
|
|
|
U16 Reserved3; /* 0Ch */
|
|
|
|
|
U16 IOCStatus; /* 0Eh */
|
|
|
|
|
U32 IOCLogInfo; /* 10h */
|
|
|
|
|
U32 SlotStatus; /* 14h */
|
2006-01-21 00:29:52 +00:00
|
|
|
U32 Reserved4; /* 18h */
|
|
|
|
|
U16 Slot; /* 1Ch */
|
|
|
|
|
U16 EnclosureHandle; /* 1Eh */
|
2002-08-11 23:34:20 +00:00
|
|
|
} MSG_SEP_REPLY, MPI_POINTER PTR_MSG_SEP_REPLY,
|
|
|
|
|
SEPReply_t, MPI_POINTER pSEPReply_t;
|
|
|
|
|
|
|
|
|
|
/* SlotStatus bits for MSG_SEP_REPLY */
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_NO_ERROR (0x00000001)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_DEV_FAULTY (0x00000002)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_DEV_REBUILDING (0x00000004)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_IN_FAILED_ARRAY (0x00000008)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_IN_CRITICAL_ARRAY (0x00000010)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_PARITY_CHECK (0x00000020)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_PREDICTED_FAULT (0x00000040)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_UNCONFIGURED (0x00000080)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_HOT_SPARE (0x00000100)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_REBUILD_STOPPED (0x00000200)
|
2006-01-21 00:29:52 +00:00
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_CONSISTENCY_CHECK (0x00001000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_DISABLE (0x00002000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_RESERVED_DEVICE (0x00004000)
|
2002-08-11 23:34:20 +00:00
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_REPORT (0x00010000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_IDENTIFY_REQUEST (0x00020000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_REMOVE_READY (0x00040000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_INSERT_READY (0x00080000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_DO_NOT_REMOVE (0x00400000)
|
2006-01-21 00:29:52 +00:00
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_ACTIVE (0x00800000)
|
2002-08-11 23:34:20 +00:00
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_B_BYPASS_ENABLED (0x01000000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_A_BYPASS_ENABLED (0x02000000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_B_ENABLE_BYPASS (0x04000000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_A_ENABLE_BYPASS (0x08000000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_DEV_OFF (0x10000000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_FAULT_SENSED (0x40000000)
|
|
|
|
|
#define MPI_SEP_REPLY_SLOTSTATUS_SWAPPED (0x80000000)
|
|
|
|
|
|
|
|
|
|
#endif
|
