smartpqi.txt 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081
  1. SMARTPQI - Microsemi Smart PQI Driver
  2. -----------------------------------------
  3. This file describes the smartpqi SCSI driver for Microsemi
  4. (http://www.microsemi.com) PQI controllers. The smartpqi driver
  5. is the next generation SCSI driver for Microsemi Corp. The smartpqi
  6. driver is the first SCSI driver to implement the PQI queuing model.
  7. The smartpqi driver will replace the aacraid driver for Adaptec Series 9
  8. controllers. Customers running an older kernel (Pre-4.9) using an Adaptec
  9. Series 9 controller will have to configure the smartpqi driver or their
  10. volumes will not be added to the OS.
  11. For Microsemi smartpqi controller support, enable the smartpqi driver
  12. when configuring the kernel.
  13. For more information on the PQI Queuing Interface, please see:
  14. http://www.t10.org/drafts.htm
  15. http://www.t10.org/members/w_pqi2.htm
  16. Supported devices:
  17. ------------------
  18. <Controller names to be added as they become publically available.>
  19. smartpqi specific entries in /sys
  20. -----------------------------
  21. smartpqi host attributes:
  22. -------------------------
  23. /sys/class/scsi_host/host*/rescan
  24. /sys/class/scsi_host/host*/version
  25. The host rescan attribute is a write only attribute. Writing to this
  26. attribute will trigger the driver to scan for new, changed, or removed
  27. devices and notify the SCSI mid-layer of any changes detected.
  28. The version attribute is read-only and will return the driver version
  29. and the controller firmware version.
  30. For example:
  31. driver: 0.9.13-370
  32. firmware: 0.01-522
  33. smartpqi sas device attributes
  34. ------------------------------
  35. HBA devices are added to the SAS transport layer. These attributes are
  36. automatically added by the SAS transport layer.
  37. /sys/class/sas_device/end_device-X:X/sas_address
  38. /sys/class/sas_device/end_device-X:X/enclosure_identifier
  39. /sys/class/sas_device/end_device-X:X/scsi_target_id
  40. smartpqi specific ioctls:
  41. -------------------------
  42. For compatibility with applications written for the cciss protocol.
  43. CCISS_DEREGDISK
  44. CCISS_REGNEWDISK
  45. CCISS_REGNEWD
  46. The above three ioctls all do exactly the same thing, which is to cause the driver
  47. to rescan for new devices. This does exactly the same thing as writing to the
  48. smartpqi specific host "rescan" attribute.
  49. CCISS_GETPCIINFO
  50. Returns PCI domain, bus, device and function and "board ID" (PCI subsystem ID).
  51. CCISS_GETDRIVVER
  52. Returns driver version in three bytes encoded as:
  53. (DRIVER_MAJOR << 28) | (DRIVER_MINOR << 24) | (DRIVER_RELEASE << 16) | DRIVER_REVISION;
  54. CCISS_PASSTHRU
  55. Allows "BMIC" and "CISS" commands to be passed through to the Smart Storage Array.
  56. These are used extensively by the SSA Array Configuration Utility, SNMP storage
  57. agents, etc.