LSI - MR-Fusion controller driver <mrsas> patch and man page

[Desai, Kashyap]

Hi,

Please consider attached patch for FreeBSD upstream check-in.

Please find attached patch for <mrsas> driver for LSI's MegaRaid Controllers. This driver supports Thunderbolt onwards Device IDs of MR controllers.
Currently it supports 0x005B and 0x005D Device IDs.

NOTE : This driver will not eliminate or by pass any functionality of <mfi> driver which already support above to Device IDs to keep existing user experience unchanged.
 
<mfi> Driver will be always given priority over <mrsas> driver and only if customer/user wants to use/migrate from <mfi> to <mrsas>, it will hook up into kernel via device.hint rules. (Attached is mrsas man page for more info.)

LSI will continue to update <mrsas> driver in future in timely bases. We have another set of patch in pipeline to be submitted for <mrsas>, but need first go ahead for attached patch and later we will continue to keep <mrsas> up-to-date (In sync with LSI released driver which is available at lsi's external site)

Apply patch with "patch -p0 < patchname.patch" from head directory. 

-- Few notes for user--
LSI recommends using fusion_force bit In hint settings at start of the day, if they want to use <mrsas>. ( <mfi> will be a default choice for MR-Fusion HBA), if will be changed only with fusion_force hint settings. (See mrsas man page) Changing any default behavior is well tested for most of the condition.
Switching from <mfi> to <mrsas> for MR-Fusion options is designed to allow user as one time choice, though multiple time switch from <mfi> to <mrsas> is possible, it is not recommended. So, user needs to decide from start of the day, which driver they want to use for MR-Fusion  card.

-- Implementation details --
To support this feature, we have modify <mfi> code to change default return type from probe. Currently <mfi> driver return "BUS_PROBE_DEFAULT". <mfi> driver has been be changed to return "BUS_PROBE_LOW_PRIORITY" if fusion_force hint from device.hints  is set.
Please notice, above mentioned implementation in <mfi> driver is only applicable in case of  MR-Fusion controller detection. For any other controllers, supported by <mfi> driver, the behavior of probe return will remain same as before.


-- High level feature list of <mrsas> --
1. Supports Fast Path feature of LSI controllers.
2. Supports 4K sector Drives.
3. CAM layer based interface. All VDs will be attached to CAM layer (Expected storage will be visible in "camcontroll")
4. Complete support of Online Controller Reset. (OCR)
5.  OCR on Fimrware fault and IO timeout case.
6. Work well with <storcli> management application which is generic application provided by LSI for all other Operating system.
7. Supporst DIF enabled VDs (Same support as provided in Linux and other OSes in FreeBSD)
8. Fast Path Load balance support.

- In summary, this driver is in part with Linux based MR drivers and all other features will be available to <mrsas> as planned activity from LSI

This code is well tested by LSI Q/A team on 32 bit and 64 bit FreeBSD Released OSes.


Thanks, Kashyap

-------------- next part --------------
A non-text attachment was scrubbed...
Name: upstream_mrsas_fusion_force.patch
Type: application/octet-stream
Size: 315504 bytes
Desc: upstream_mrsas_fusion_force.patch
URL: <http://lists.freebsd.org/pipermail/freebsd-scsi/attachments/20131206/6b1d7cca/attachment-0001.obj>