11c11 < 5 May, 2008 --- > 15 May, 2008 15d14 < [2] Sun_Microsystems_HDD_LED_Requirements_Rev_1_8 71a71,74 > As the ioctl is generic in nature and directed to devctl nodes, > additional LED types may be supported by the driver implementing > this ioctl. > 106c109 < DEVCTL_SETLED | consolidation-private | Turn ON/OFF drive --- > DEVCTL_SET_LED | consolidation-private | Turn ON/OFF 109,110c112,113 < --------------------------------------------------------------- < DEVCTL_GETLED | consolidation-private | Get status of drive --- > -------------------------------------------------------------- > DEVCTL_GET_LED | consolidation-private | Get status of 113a117,120 > DEVCTL_NUM_LEDS | consolidation-private | Get number of > | | supported indicator > | | LEDs > --------------------------------------------------------------- 130c137 < The request is DEVCTL_SETLED or DEVCTL_GETLED --- > The request is DEVCTL_SET_LED, DEVCTL_GET_LED or DEVCTL_NUM_LEDS 133c140,141 < #define DEVCTL_GET_LEDSTATE (DEVCTL_IOC | 40) --- > #define DEVCTL_GET_LED (DEVCTL_IOC | 40) > #define DEVCTL_NUM_LEDS (DEVCTL_IOC | 41) 140,141c148,149 < uint32_t led_type : 3; /* LED type */ < uint32_t led_state: 4; /* LED ON/OFF/Blink state */ --- > uint32_t led_type : 9; /* LED type */ > uint32_t led_state: 6; /* LED ON/OFF/Blink state */ 149,150c157,158 < #define DCL_TYPE_FAIL 1 /* FAIL LED type */ < #define DCL_TYPE_OK2RM 2 /* OK2RM LED type */ --- > #define DCL_TYPE_DEVICE_FAIL 1 /* Device FAIL LED type */ > #define DCL_TYPE_DEVICE_OK2RM 2 /* Device OK2RM LED type */ 156c164,166 < #define DCL_STATE_FAST_BLNK 3 /* LED Fast blink */ --- > #define DCL_STATE_FAST_BLNK 4 /* LED Fast blink */ > > For DEVCTL_GET_LED and DEVCTL_SET_LED requests: 159c169,170 < to which the LED indicator is related. In practical terms --- > to which the LED indicator is related. > For requesst is related to SGPIO-controlled LEDs 170a182,187 > For requests related to other type of leds, the led_num > value is specific for the devctl node supporting it. > > The request may specify only one LED type and number at > a time. > 175,178c192,194 < ignored and HBA should make SPGIO inactive (put SGPIO < in tri-state) for all devices controlled by the HBA. < Slow blink and fast blink rates are defined by Sun < document Sun_Microsystems_HDD_LED_Requirements_Rev_1_8. --- > ignored and HBA should make an LED interface inactive > (in case of SGPIO, put SGPIO in tri-state) for all LEDs > controlled by the HBA. 181a198,200 > Slow blink and fast blink rates are defined as follow: > SLow Blinking - 1Hz 50% ON/OFF LED cycles > Fast Blinking - 4Hz 50% ON/OFF LED cycles 183c202 < For DEVCTL_GET_LEDSTATE request: --- > For DEVCTL_GET_LED request: 188,189c207,208 < If the SGPIO control interface was not explicitly enabled < via DEVCTL_SET_LED with DCL_CNTRL_ON request, the LED state --- > If the LED state was not explicitly changed via > DEVCTL_SET_LED with DCL_CNTRL_ON request, the LED state 191a211,229 > For DEVCTL_NUM_LEDS request: > > Following information is returned in dc_led_ctl structure: > led_num --- number of supported LEDs > For devctl nodes controlling device LEDs via > SGPIO interface this is a number of LEDs tuples > supported by the HBA instance. > For other devctl nodes this number is devctl node > specific. > led_ctl_active --- non-zero value indicates that the LED > control interface is active, ie. LEDs are > controlled by this HBA instance. > led_type --- indication of supporting device FAIL and OK2RM LEDs > (0x3 constant for SGPIO-controlled device LEDS); > led_state --- indication of supporting device LED lighting patterns, > as defined by DCL_STATE_XXX ; > > > For devctl nodes controlling SGPIO interface: 193d230 < IOCTL may specify one LED type and device number at a time. 195c232 < by the HBA). In such state the default LED setting as provided --- > by the HBA). In such state the default LED setting provided 203c240 < interface, an explicit ioctl has to be sent to eenable the --- > interface, an explicit ioctl has to be sent to enable the 207c244 < Some HBAs (such as hardware RAID HBAs) may be actively control --- > Some HBAs (such as hardware RAID HBAs) may be actively controlling 209c246 < LEDs is HBA-specific and cntrl_active field of the dc_led_ctl --- > LEDs is HBA-specific and led_ctl_active field of the dc_led_ctl 213c250 < without an explicit request to activate the control. --- > without an explicit prior request to activate the control. 221,223c258,259 < The SATA HBA driver should maintain the state of LEDs for the < purpose of providing LEDs state in response to DEVCTL_GET_LEDSTATE < request. --- > The driver implementing the LED control ioctl should maintain the state > of LEDs for the life of the HBA instance. 227,228d262 < PRIV_ALL privilege is required to invoke DEVCTL_LED_CTL ioctl. < 252,253c286 < 6.4.1. Consolidation C-team Name: < ON --- > 6.4.1. Consolidation C-team Name: ON