Commit 6315e6fc authored by Steven Song's avatar Steven Song
Browse files

SCSI: SSSRAID: Support 3SNIC 3S5XX serial RAID/HBA controllers

3snic inclusion
category: feature
feature: sssraid
bugzilla: https://gitee.com/openeuler/kernel/issues/I64M90


CVE: NA

------------------------------------------

This commit is to support 3SNIC 3S5XX RAID/HBA controllers.
RAID controllers support RAID 0/1/5/6/10/50/60 modes;
HBA controlllers support RAID 0/1/10 modes.
RAID/HBA support SAS/SATA HDD/SSD.

Signed-off-by: default avatarliangry <liangry1@3snic.com>
Reviewed-by: default avatarJiang <Yu&lt;yujiang@3snic.com>
Reviewed-by: default avatarSteven Song <steven.song@3snic.com>
Signed-off-by: default avatarSteven Song <steven.song@3snic.com>
parent f5784b3d
Loading
Loading
Loading
Loading
+83 −0
Original line number Diff line number Diff line
.. SPDX-License-Identifier: GPL-2.0

==============================================
SSSRAID - 3SNIC SCSI RAID Controller driver
==============================================

This file describes the SSSRAID SCSI driver for 3SNIC
(http://www.3snic.com) RAID controllers. The SSSRAID
driver is the first generation RAID driver for 3SNIC Corp.

For 3SNIC SSSRAID controller support, enable the SSSRAID driver
when configuring the kernel.

SSSRAID specific entries in /sys
=================================

SSSRAID host attributes
------------------------
  - /sys/class/scsi_host/host*/csts_pp
  - /sys/class/scsi_host/host*/csts_shst
  - /sys/class/scsi_host/host*/csts_cfs
  - /sys/class/scsi_host/host*/csts_rdy
  - /sys/class/scsi_host/host*/fw_version

  The host csts_pp attribute is a read only attribute. This attribute
  indicates whether the controller is processing commands. If this attribute
  is set to ‘1’, then the controller is processing commands normally. If
  this attribute is cleared to ‘0’, then the controller has temporarily stopped
  processing commands in order to handle an event (e.g., firmware activation).

  The host csts_shst attribute is a read only attribute. This attribute
  indicates status of shutdown processing.The shutdown status values are defined
  as:
        ======     ==============================
        Value      Definition
        ======     ==============================
        00b        Normal operation
	01b        Shutdown processing occurring
	10b        Shutdown processing complete
	11b        Reserved
        ======     ==============================
  The host csts_cfs attribute is a read only attribute. This attribute is set to
  ’1’ when a fatal controller error occurred that could not be communicated in the
  appropriate Completion Queue. This bit is cleared to ‘0’ when a fatal controller
  error has not occurred.

  The host csts_rdy attribute is a read only attribute. This attribute is set to
  ‘1’ when the controller is ready to process submission queue entries.

  The fw_version attribute is read-only and will return the driver version and the
  controller firmware version.

SSSRAID scsi device attributes
------------------------------
  - /sys/class/scsi_device/X\:X\:X\:X/device/raid_level
  - /sys/class/scsi_device/X\:X\:X\:X/device/raid_state
  - /sys/class/scsi_device/X\:X\:X\:X/device/raid_resync

  The device raid_level attribute is a read only attribute. This attribute indicates
  RAID level of scsi device(will dispaly "NA" if scsi device is not virtual disk type).

  The device raid_state attribute is read-only and indicates RAID status of scsi
  device(will dispaly "NA" if scsi device is not virtual disk type).

  The device raid_resync attribute is read-only and indicates RAID rebuild processing
  of scsi device(will dispaly "NA" if scsi device is not virtual disk type).

Supported devices
=================

        ===================     ======= =======================================
        PCI ID (pci.ids)        OEM     Product
        ===================     ======= =======================================
        1F3F:2100               3SNIC 	3S510(HBA:8Ports,1G DDR)
        1F3F:2100               3SNIC 	3S520(HBA:16Ports,1G DDR)
        1F3F:2100               3SNIC 	3S530(HBA:32Ports,1G DDR)
        1F3F:2100               3SNIC 	3S540(HBA:40Ports,1G DDR)
        1F3F:2200               3SNIC 	3S580(RAID:16Ports,2G cache)
        1F3F:2200               3SNIC 	3S585(RAID:16Ports,4G cache)
        1F3F:2200               3SNIC 	3S590(RAID:32Ports,4G cache)
        1F3F:2200               3SNIC 	3S5A0(RAID:40Ports,2G cache)
        1F3F:2200               3SNIC 	3S5A5(RAID:40Ports,4G cache)
        ===================     ======= =======================================
+7 −0
Original line number Diff line number Diff line
@@ -16669,6 +16669,13 @@ M: Jan-Benedict Glaw <jbglaw@lug-owl.de>
S:	Maintained
F:	arch/alpha/kernel/srm_env.c
SSSRAID SCSI/Raid DRIVERS
M:	Steven Song <steven.song@3snic.com>
L:	linux-scsi@vger.kernel.org
S:	Maintained
F:	Documentation/scsi/sssraid.rst
F:	drivers/scsi/sssraid/
ST LSM6DSx IMU IIO DRIVER
M:	Lorenzo Bianconi <lorenzo.bianconi83@gmail.com>
L:	linux-iio@vger.kernel.org
+1 −0
Original line number Diff line number Diff line
@@ -2394,6 +2394,7 @@ CONFIG_SCSI_HISI_SAS_DEBUGFS_DEFAULT_ENABLE=y
# CONFIG_MEGARAID_NEWGEN is not set
# CONFIG_MEGARAID_LEGACY is not set
CONFIG_MEGARAID_SAS=m
CONFIG_SCSI_3SNIC_SSSRAID=m
CONFIG_SCSI_MPT3SAS=m
CONFIG_SCSI_MPT2SAS_MAX_SGE=128
CONFIG_SCSI_MPT3SAS_MAX_SGE=128
+1 −0
Original line number Diff line number Diff line
@@ -2355,6 +2355,7 @@ CONFIG_SCSI_AACRAID=m
# CONFIG_MEGARAID_LEGACY is not set
CONFIG_MEGARAID_SAS=m
CONFIG_SCSI_MPT3SAS=m
CONFIG_SCSI_3SNIC_SSSRAID=m
CONFIG_SCSI_MPT2SAS_MAX_SGE=128
CONFIG_SCSI_MPT3SAS_MAX_SGE=128
CONFIG_SCSI_MPT2SAS=m
+1 −0
Original line number Diff line number Diff line
@@ -481,6 +481,7 @@ config SCSI_ARCMSR

source "drivers/scsi/esas2r/Kconfig"
source "drivers/scsi/megaraid/Kconfig.megaraid"
source "drivers/scsi/sssraid/Kconfig"
source "drivers/scsi/mpt3sas/Kconfig"
source "drivers/scsi/smartpqi/Kconfig"
source "drivers/scsi/ufs/Kconfig"
Loading