Abstracting the protocol processing of storage enclosure services from the control of enclosure hardware

A method for providing abstracted control of storage enclosure hardware using a SCSI Enclosure Services (SES) protocol, comprising:

• converting a SES command for controlling one or more general hardware operational capabilities to a series of function calls in SES protocol code;
• and
• executing a series of functions corresponding to the series of function calls in a SES Application Programming Interface (API) to control specific storage enclosure hardware, wherein the functions are tailored to the storage enclosure hardware and at least some of the functions are selected from the group consisting of
• sapi_initializeElementClasses, sapi_modePageExists, sapi_readVendorSpecificModePage, sapi_writeVendorSpecificModePage, sapi_inquiryPageExists, sapi_readVendorSpecificInquiryPage, sapi_getSESDeviceInfo, sapi_readStdInquiryDataVendorSpecificField2, sapi_getFRUInformation, sapi_getProductSerialNumber, sapi_getOperatingDefinitionDescription, sapi_getOperatingVendorSpecificDescription, sapi_getDeviceID, sapi_runSelfTest, sapi_diagnosticPageExists, sapi_getEnclosureInfo, sapi_getTypeDescriptorText, sapi_getHelpText, sapi_stringOut, sapi_stringIn, sapi_setThresholds, sapi_getThresholds, sapi_getElementDescriptorText, sapi_getShortStatus, sapi_readVendorSpecificDiagPage, sapi_writeVendorSpecificDiagPage, sapi_setUnspecifiedElementControl, sapi_getUnspecifiedElementStatus, sapi_setDeviceElementControl, sapi_getDeviceElementStatus, sapi_setDeviceElementArrayControl, sapi_getDeviceElementAmmayStatus, sapi_setPowerSupplyElementControl, sapi_getPowerSupplyElementStatus, sapi_setCoolingElementControl, sapi_getCoolingElementStatus, sapi_setTemperatureElementControl, sapi_getTemperatureElementStatus, sapi_setDoorlockElementControl, sapi_getDoorlockElementStatus, sapi_setAudibleAlarmElementControl, sapi_getAudibleAlarmElementStatus, sapi_setESControllerElementControl, sapi_getESControllerElementStatus, sapi_setSCCControllerElementControl, sapi_getSCCControllerElementStatus, sapi_setNVCacheElementControl, sapi_getNVCacheElementStatus, sapi_setUninterruptiblePSElementControl, sapi_getUninterruptiblePSElementStatus, sapi_setDisplayElementControl, sapi_getDisplayElementStatus, sapi_setKeypadElementControl, sapi_getKeypadElementStatus, sapi_setPortTransElementControl, sapi_getPortTransElementStatus, sapi_setLanguageElementControl, sapi_getLanguageElementStatus, sapi_setCommunicationPortElementControl, sapi_getCommunicationPortElementStatus, sapi_setVoltageSensorElementControl, sapi_getVoltageSensorElementStatus, sapi_setCurrentSensorElementControl, sapi_getCurrentSensorElementStatus, sapi_SetTargetPortElementControl, sapi_getTargetPortElementStatus, sapi_setInitiatorPortElementControl, sapi_getInitiatorPortElementStatus, sapi_SetSimpleSubEnclosureElementControl, sapi_getSimpleSubEnclosureElementStatus, sapi_SetVendorSpecificElementControl, sapi_getVendorSpecificElementStatus, and sapi_vendorImplementedScsiCmd.

One or more storage media including SCSI Enclosure Services (SES) protocol code which, when executed by one or more processors, causes the one or more processors to convert a SES command for controlling one or more general hardware operational capabilities to a series of function calls, at least some of the function calls corresponding to functions within a SES Application Programming Interface (API) that are tailored to control specific storage enclosure hardware and are selected from the group consisting of

• sapi_initializeElementClasses, sapi_modePageExists, sapi_readVendorSpecificModePage, sapi_writeVendorSpecificModePage, sapi_inquiryPageExists, sapi_readVendorSpecificInquiryPage, sapi_getSESDeviceInfo, sapi_readStdInquiryDataVendorSpecificField2, sapi_getFRUInformation, sapi_getProductSerialNumber, sapi_getOperatingDefinitionDescription, sapi_getOperatingVendorSpecificDescription, sapi_getDeviceID, sapi_runSelfTest, sapi_diagnosticPageExists, sapi_getEnclosureInfo, sapi_getTypeDescriptorText, sapi_getHelpText, sapi_stringOut, sapi_stringIn, sapi_setThresholds, sapi_getThresholds, sapi_getElementDescriptorText, sapi_getShortStatus, sapi_readVendorSpecificDiagPage, sapi_writeVendorSpecificDiagPage, sapi_setUnspecifiedElementControl, sapi_getUnspecifiedElementStatus, sapi_setDeviceElementControl, sapi_getDeviceElementStatus, sapi_setDeviceElementArrayControl, sapi_getDeviceElementArrayStatus, sapi_setPowerSupplyElementControl, sapi_getPowerSupplyElementStatus, sapi_setCoolingElementControl, sapi_getCoolingElementStatus, sapi_setTemperatureElementControl, sapi_getTemperatureElementStatus, sapi_setDoorlockElementControl, sapi_getDoorlockElementStatus, sapi_setAudibleAlarmElementControl, sapi_getAudibleAlarmElementStatus, sapi_setESControllerElementControl, sapi_getESControllerElementStatus, sapi_setSCCControllerElementControl, sapi_getSCCControllerElementStatus, sapi_setNVCacheElementControl, sapi_getNVCacheElementStatus, sapi_setUninterruptiblePSElementControl, sapi_getUninterruptiblePSElementStatus, sapi_setDisplayElementControl, sapi_getDisplayElementStatus, sapi_setKeypadElementControl, sapi_getKeypadElementStatus, sapi_setPortTransElementControl, sapi_getPortTransElementStatus, sapi_setLanguageElementControl, sapi_getLanguageElementStatus, sapi_setCommunicationPortElementControl, sapi_getCommunicationPortElementStatus, sapi_setVoltageSensorElementControl, sapi_getVoltageSensorElementStatus, sapi_setCurrentSensorElementControl, sapi_getCurrentSensorElementStatus, sapi_SetTargetPortElementControl, sapi_getTargetPortElementStatus, sapi_setInitiatorPortElementControl, sapi_getInitiatorPortElementStatus, sapi_setSimpleSubEnclosureElementControl, sapi_getSimpleSubEnclosureElementStatus, sapi_setVendorSpecificElementControl, sapi_getVendorSpecificElementStatus, and sapi_vendorImplementedScsiCmd.

One or more storage media including a SCSI Enclosure Services (SES) Application Programming Interface (API) containing one or more user-tailorable functions for controlling specific storage enclosure hardware selected from the group consisting of

• sapi_initializeElementClasses, sapi_modePageExists, sapi_readVendorSpecificModePage, sapi_writeVendorSpecificModePage, sapi_inquiryPageExists, sapi_readVendorSpecificInquiryPage, sapi_getSESDeviceInfo, sapi_readStdInquiryDataVendorSpecificField2, sapi_getFRUInformation, sapi_getProductSerialNumber, sapi_getOperatingDefintionDescription, sapi_getOperatingVendorSpecificDescription, sapi_getDeviceID, sapi_runSelfTest, sapi_diagnosticPageExists, sapi_getEnclosureInfo, sapi_getTypeDescriptorText, sapi_getHelpText, sapi_stringOut, sapi_stringIn, sapi_setThresholds, sapi_getThresholds, sapi_getElementDescriptorText, sapi_getShortStatus, sapi_readVendorSpecificDiagPage, sapi_writeVendorSpecificDiagPage, sapi_setUnspecifiedElementControl, sapi_getUnspecifiedElementStatus, sapi_setDeviceElementControl, sapi_getDeviceElementStatus, sapi_setDeviceElementArrayControl, sapi_getDeviceElementArrayStatus, sapi_setPowerSupplyElementControl, sapi_getPowerSupplyElementStatus, sapi_setCoolingElementControl, sapi_getCoolingElementStatus, sapi_setTemperatureElementControl, sapi_getTemperatureElementStatus, sapi_setDoorlockElementControl, sapi_getDoorlockElementStatus, sapi_setAudibleAlarmElementControl, sapi_getAudibleAlarmElementStatus, sapi_setESControllerElementControl, sapi_getESControllerElementStatus, sapi_setSCCControllerElementControl, sapi_getSCCControllerElementStatus, sapi_setNVCacheElementControl, sapi_getNVCacheElementStatus, sapi_setUninterruptiblePSElementControl, sapi_getUninterruptiblePSElementStatus, sapi_setDisplayElementControl, sapi_getDisplayElementStatus, sapi_setKeypadElementControl, sapi_getKeypadElementStatus, sapi_setPortTransElementControl, sapi_getPortTransElementStatus, sapi_setLanguageElementControl, sapi_getLanguageElementStatus, sapi_setCommunicationPortElementControl, sapi_getCommunicationPortElementStatus, sapi_setVoltageSensorElementControl, sapi_getVoltageSensorElementStatus, sapi_setCurrentSensorElementControl, sapi_getCurrentSensorElementStatus, sapi_setTargetPortElementControl, sapi_getTargetPortElementStatus, sapi_SetInitiatorPortElementControl, sapi_getInitiatorPortElementStatus, sapi_SetSimpleSubEnclosureElementControl, sapi_getSimpleSubEnclosureElementStatus, sapi_setVendorSpecificElementControl, sapi_getVendorSpecificElementStatus, and sapi_vendorImplementedScsiCmd.

In a storage enclosure for connecting networked storage devices, the storage enclosure including storage enclosure hardware, one or more processors programmed for providing abstracted control of the storage enclosure hardware using a SCSI Enclosure Services (SES) protocol by performing the steps of:

• converting a SES command for controlling one or more general hardware operational capabilities to a series of function calls in SES protocol code;
• and
• executing a series of functions corresponding to the series of function calls in a SES Application Programming Interface (API) to control specific storage enclosure hardware, wherein the functions are tailored to the storage enclosure hardware and at least some of the functions are for performing operations selected from the group consisting of
• querying the existence of an enclosure element, querying the status of an enclosure element, controlling an enclosure element, querying the existence of a sub-enclosure, querying and controlling elements in a sub-enclosure, querying the existence of vendor-defined mode pages, reading vendor-defined mode pages, writing vendor-defined mode pages, filling in various vendor-defined fields in standard mode pages, querying the existence of vendor-defined diagnostics pages, reading vendor-defined mode pages, writing vendor-defined mode pages, querying the existence of vendor-defined Inquiry pages, and reading vendor-defined Inquiry pages.

In a storage enclosure for connecting networked storage devices, the storage enclosure including storage enclosure hardware, one or more processors programmed for providing abstracted control of the storage enclosure hardware using a SCSI Enclosure Services (SES) protocol by performing the steps of:

• converting a SES command for controlling one or more general hardware operational capabilities to a series of function calls in SES protocol code;
• and
• executing a series of functions corresponding to the series of function calls in a SES Application Programming Interface (API) to control specific storage enclosure hardware, wherein the functions are tailored to the storage enclosure hardware and at least some of the functions are selected from the group consisting of
• sapi_initializeElementClasses, sapi_modePageExists, sapi_readVendorSpecificModePage, sapi_writeVendorSpecificModePage, sapi_inquiryPageExists, sapi_readVendorSpecificInquiryPage, sapi_getSESDeviceInfo, sapi_readStdInquiryDataVendorSpecificField2, sapi_getFRUInformation, sapi_getProductSerialNumber, sapi_getOperatingDefinitionDescription, sapi_getOperatingVendorSpecificDescription, sapi_getDeviceID, sapi_runSelfTest, sapi_diagnosticPageExists, sapi_getEnclosureInfo, sapi_getTypeDescriptorText, sapi_getHelpText, sapi_stringOut, sapi_stringIn, sapi_setThresholds, sapi_setThresholds, sapi_getElementDescriptorText, sapi_getShortStatus, sapi_readVendorSpecificDiagPage, sapi_writeVendorSpecificDiagPage, sapi_SetUnspecifiedElementControl, sapi_getUnspecifiedElementStatus, sapi_setDeviceElementControl, sapi_getDeviceElementStatus, sapi_setDeviceElementArrayControl, sapi_getDeviceElementArrayStatus, sapi_setPowerSupplyElementControl, sapi_getPowerSupplyElementStatus, sapi_setCoolingElementControl, sapi_getCoolingElementStatus, sapi_setTemperatureElementControl, sapi_getTemperatureElementStatus, sapi_setDoorlockElementControl, sapi_getDoorlockElementStatus, sapi_setAudibleAlarmElementControl, sapi_getAudibleAlarmElementStatus, sapi_setESControllerElementControl, sapi_getESControllerElementStatus, sapi_setSCCControllerElementControl, sapi_getSCCControllerElementStatus, sapi_setNVCacheElementControl, sapi_getNVCacheElementStatus, sapi_setUninterruptiblePSElementControl, sapi_getUninterruptiblePSElementStatus, sapi_setDisplayElementControl, sapi_getDisplayElementStatus, sapi_setKeypadElementControl, sapi_getKeypadElementStatus, sapi_setPortTransElementControl, sapi_getPortTransElementStatus, sapi_setLanguageElementControl, sapi_getLanguageElementStatus, sapi_setCommunicationPortElementControl, sapi_getCommunicationPortElementStatus, sapi_setVoltageSensorElementControl, sapi_getVoltageSensorElementStatus, sapi_setCurrentSensorElementControl, sapi_setCurrentSensorElementStatus, sapi_setTargetPortElementControl, sapi_getTargetPortElementStatus, sapi_setInitiatorPortElementControl, sapi_getInitiatorPortElementStatus, sapi_setSimpleSubEnclosureElementControl, sapi_getSimpleSubEnclosureElementStatus, sapi_SetVendorSpecificElementControl, sapi_getVendorSpecificElementStatus, and sapi_vendorImplementedScsiCmd.

An interface protocol operable between two segments of SCSI Enclosure Services (SES) software executable by a processor, the first software segment for communicating via SES commands to devices external to the processor and the second software segment for controlling specific storage enclosure hardware, the interface protocol characterized by having at least some function calls selected from the group consisting of:

• sapi_initializeElementClasses, sapi_modePageExists, sapi_readVendorSpecificModePage, sapi_writeVendorSpecificModePage, sapi_inquiryPageExists, sapi_readVendorSpecificInquiryPage, sapi_getSESDeviceInfo, sapi_readStdInquiryDataVendorSpecificField2, sapi_getFRUInformation, sapi_getProductSerialNumber, sapi_getOperatingDefinitionDescription, sapi_getOperatingVendorSpecificDescription, sapi_getDeviceID, sapi_runSelfTest, sapi_diagnosticPageExists, sapi_getEnclosureInfo, sapi_getTypeDescriptorText, sapi_getHelpText, sapi_stringOut, sapi_stringIn, sapi_setThresholds, sapi_getThresholds, sapi_getElementDescriptorText, sapi_getShortStatus, sapi_readVendorSpecificDiagPage, sapi_writeVendorSpecificDiagPage, sapi_setUnspecifiedElementControl, sapi_getUnspecifiedElementStatus, sapi_setDeviceElementControl, sapi_getDeviceElementStatus, sapi_setDeviceElementArrayControl, sapi_getDeviceElementArrayStatus, sapi_setPowerSupplyElementControl, sapi_getPowerSupplyElementStatus, sapi_setCoolingElementControl, sapi_getCoolingElementStatus, sapi_setTemperatureElementControl, sapi_getTemperatureElementStatus, sapi_setDoorlockElementControl, sapi_getDoorlockElementStatus, sapi_setAudibleAlarmElementControl, sapi_getAudibleAlarmElementStatus, sapi_setESControllerElementControl, sapi_getESControllerElementStatus, sapi_setSCCControllerElementControl, sapi_getSCCControllerElementStatus, sapi_setNVCacheElementControl, sapi_getNVCacheElementStatus, sapi_setUninterruptiblePSElementControl, sapi_getUninterruptiblePSElementStatus, sapi_setDisplayElementControl, sapi_getDisplayElementStatus, sapi_setKeypadElementControl, sapi_getKeypadElementStatus, sapi_setPortTransElementControl, sapi_getPortTransElementStatus, sapi_setLanguageElementControl, sapi_getLanguageElementStatus, sapi_setCommunicationPortElementControl, sapi_getCommunicationPortElementStatus, sapi_setVoltageSensorElementControl, sapi_getVoltageSensorElementStatus, sapi_setCurrentSensorElementControl, sapi_getCurrentSensorElementStatus, sapi_getTargetPortElementControl, sapi_getTargetPortElementStatus, sapi_setInitiatorPortElementControl, sapi_getInitiatorPortElementStatus, sapi_setSimpleSubEnclosureElementControl, sapi_getSimpleSubEnclosureElementStatus, sapi_SetVendorSpecificElementControl, sapi_getVendorSpecificElementStatus, and sapi_vendorImplementedScsiCmd.