IOSCSIBlockCommandsDevicePM.cpp [plain text]
#include <IOKit/IOBufferMemoryDescriptor.h>
#include <IOKit/IOMessage.h>
#include <IOKit/pwr_mgt/RootDomain.h>
#include <IOKit/scsi/SCSITask.h>
#include "IOSCSIBlockCommandsDevice.h"
#define DEBUG 0
#define DEBUG_ASSERT_COMPONENT_NAME_STRING "SBCPower"
#if DEBUG
#define SCSI_SBC_DEVICE_DEBUGGING_LEVEL 0
#endif
#include "IOSCSIArchitectureModelFamilyDebugging.h"
#define SCSI_SBC_DEVICE_DEBUGGING_LEVEL 0
#if ( SCSI_SBC_DEVICE_DEBUGGING_LEVEL >= 1 )
#define PANIC_NOW(x) IOPanic x
#else
#define PANIC_NOW(x)
#endif
#if ( SCSI_SBC_DEVICE_DEBUGGING_LEVEL >= 2 )
#define ERROR_LOG(x) IOLog x
#else
#define ERROR_LOG(x)
#endif
#if ( SCSI_SBC_DEVICE_DEBUGGING_LEVEL >= 3 )
#define STATUS_LOG(x) IOLog x
#else
#define STATUS_LOG(x)
#endif
#define super IOSCSIPrimaryCommandsDevice
static IOPMPowerState sPowerStates[kSBCNumPowerStates] =
{
{ kIOPMPowerStateVersion1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
{ kIOPMPowerStateVersion1, 0, IOPMPowerOn, IOPMPowerOn, 0, 0, 0, 0, 0, 0, 0, 0 },
{ kIOPMPowerStateVersion1, (IOPMDeviceUsable | kIOPMPreventIdleSleep), IOPMPowerOn, IOPMPowerOn, 0, 0, 0, 0, 0, 0, 0, 0 },
{ kIOPMPowerStateVersion1, (IOPMDeviceUsable | kIOPMPreventIdleSleep), IOPMPowerOn, IOPMPowerOn, 0, 0, 0, 0, 0, 0, 0, 0 },
{ kIOPMPowerStateVersion1, (IOPMDeviceUsable | IOPMMaxPerformance | kIOPMPreventIdleSleep), IOPMPowerOn, IOPMPowerOn, 0, 0, 0, 0, 0, 0, 0, 0 }
};
static IOReturn
IOSCSIBlockCommandsDevicePowerDownHandler ( void * target,
void * refCon,
UInt32 messageType,
IOService * provider,
void * messageArgument,
vm_size_t argSize );
static IOReturn
IOSCSIBlockCommandsDevicePowerDownHandler ( void * target,
void * refCon,
UInt32 messageType,
IOService * provider,
void * messageArgument,
vm_size_t argSize )
{
return ( ( IOSCSIBlockCommandsDevice * ) target )->PowerDownHandler (
refCon,
messageType,
provider,
messageArgument,
argSize );
}
IOReturn
IOSCSIBlockCommandsDevice::PowerDownHandler ( void * refCon,
UInt32 messageType,
IOService * provider,
void * messageArgument,
vm_size_t argSize )
{
if ( messageType == kIOMessageSystemWillPowerOff )
setProperty ( "Power Off", true );
return kIOReturnSuccess;
}
UInt32
IOSCSIBlockCommandsDevice::GetInitialPowerState ( void )
{
return kSBCPowerStateActive;
}
UInt32
IOSCSIBlockCommandsDevice::GetNumberOfPowerStateTransitions ( void )
{
return ( kSBCPowerStateActive - kSBCPowerStateSleep );
}
void
IOSCSIBlockCommandsDevice::InitializePowerManagement ( IOService * provider )
{
fCurrentPowerState = kSBCPowerStateActive;
super::InitializePowerManagement ( provider );
registerPowerDriver ( this, sPowerStates, kSBCNumPowerStates );
fPowerDownNotifier = registerPrioritySleepWakeInterest (
( IOServiceInterestHandler ) IOSCSIBlockCommandsDevicePowerDownHandler,
this );
changePowerStateTo ( kSBCPowerStateSleep );
}
void
IOSCSIBlockCommandsDevice::HandleCheckPowerState ( void )
{
if ( IsDeviceAccessEnabled ( ) )
{
super::HandleCheckPowerState ( kSBCPowerStateActive );
}
}
void
IOSCSIBlockCommandsDevice::TicklePowerManager ( void )
{
( void ) super::TicklePowerManager ( kSBCPowerStateActive );
}
void
IOSCSIBlockCommandsDevice::HandlePowerChange ( void )
{
SCSIServiceResponse serviceResponse = kSCSIServiceResponse_SERVICE_DELIVERY_OR_TARGET_FAILURE;
SCSITaskIdentifier request = NULL;
STATUS_LOG ( ( "IOSCSIBlockCommandsDevice::HandlePowerChange called\n" ) );
request = GetSCSITask ( );
while ( ( fProposedPowerState != fCurrentPowerState ) && ( isInactive ( ) == false ) )
{
STATUS_LOG ( ( "fProposedPowerState = %ld, fCurrentPowerState = %ld\n",
fProposedPowerState, fCurrentPowerState ) );
if ( ( fCurrentPowerState <= kSBCPowerStateSleep ) &&
( fProposedPowerState > kSBCPowerStateSleep ) )
{
STATUS_LOG ( ( "We think we're in sleep\n" ) );
if ( fDeviceIsShared == false )
{
if ( START_STOP_UNIT ( request, 0x00, 0x00, 0x00, 0x01, 0x00 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
}
STATUS_LOG ( ( "calling ClearPowerOnReset\n" ) );
if ( ClearPowerOnReset ( ) == false )
break;
STATUS_LOG ( ( "calling ClearNotReadyStatus\n" ) );
if ( ClearNotReadyStatus ( ) == false )
break;
if ( fMediaIsRemovable == true )
{
if ( fMediumPresent == true )
{
bool mediaPresent = false;
for ( UInt32 index = 0; index < 100; index++ )
{
STATUS_LOG ( ( "Calling VerifyMediumPresence\n" ) );
mediaPresent = VerifyMediumPresence ( );
if ( mediaPresent )
break;
IOSleep ( 200 );
}
if ( mediaPresent != fMediumPresent )
{
PANIC_NOW ( ( "Unexpected Media Removal when waking up from sleep\n" ) );
}
else
{
fMediumRemovalPrevented = PreventMediumRemoval ( );
if ( fMediumRemovalPrevented == false )
{
fPollingMode = kPollingMode_MediaRemoval;
EnablePolling ( );
}
}
}
else
{
fPollingMode = kPollingMode_NewMedia;
EnablePolling ( );
}
}
}
switch ( fProposedPowerState )
{
case kSBCPowerStateSystemSleep:
{
UInt32 previousPowerState;
STATUS_LOG ( ( "case kSBCPowerStateSystemSleep\n" ) );
if ( fPollingMode != kPollingMode_Suspended )
{
STATUS_LOG ( ( "Disabling polling\n" ) );
DisablePolling ( );
}
previousPowerState = fCurrentPowerState;
fCurrentPowerState = fProposedPowerState;
while ( fNumCommandsOutstanding > 1 )
{
IOSleep ( 1 );
}
if ( previousPowerState != kSBCPowerStateSleep )
{
if ( fDeviceIsShared == false )
{
if ( fDeviceSupportsPowerConditions )
{
STATUS_LOG ( ( "Sending START_STOP_UNIT to drive to turn it off\n" ) );
if ( START_STOP_UNIT ( request, 1, 0x05, 0, 0, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
}
else
{
STATUS_LOG ( ( "Power conditions not supported, make sure drive is spun down\n" ) );
if ( START_STOP_UNIT ( request, 1, 0, 0, 0, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
}
IOSleep ( 500 );
}
}
fCurrentPowerState = kSBCPowerStateSystemSleep;
}
break;
case kSBCPowerStateSleep:
{
STATUS_LOG ( ( "case kSBCPowerStateSleep\n" ) );
if ( fCurrentPowerState < kSBCPowerStateSleep )
{
STATUS_LOG ( ( "TicklePowerManager.\n" ) );
TicklePowerManager ( );
STATUS_LOG ( ( "Wakeup path completed.\n" ) );
fCurrentPowerState = fProposedPowerState;
break;
}
if ( ( fCurrentPowerState > kSBCPowerStateSleep ) && ( fDeviceIsShared == false ) )
{
STATUS_LOG ( ( "At minimum, make sure drive is spun down.\n" ) );
if ( START_STOP_UNIT ( request, 1, 0, 0, 0, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
IOSleep ( 500 );
}
fCurrentPowerState = kSBCPowerStateSleep;
}
break;
case kSBCPowerStateStandby:
{
STATUS_LOG ( ( "case kSBCPowerStateStandby\n" ) );
STATUS_LOG ( ( "At minimum, make sure drive is spun down.\n" ) );
if ( ( fCurrentPowerState > kSBCPowerStateStandby ) && ( fDeviceIsShared == false ) )
{
if ( START_STOP_UNIT ( request, 1, 0, 0, 0, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
IOSleep ( 500 );
}
fCurrentPowerState = kSBCPowerStateStandby;
}
break;
case kSBCPowerStateIdle:
{
STATUS_LOG ( ( "case kSBCPowerStateIdle\n" ) );
fCurrentPowerState = kSBCPowerStateIdle;
}
break;
case kSBCPowerStateActive:
{
STATUS_LOG ( ( "case kSBCPowerStateActive\n" ) );
if ( fDeviceIsShared == false )
{
if ( START_STOP_UNIT ( request, 0, 0, 0, 1, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
}
fCurrentPowerState = kSBCPowerStateActive;
fCommandGate->commandWakeup ( &fCurrentPowerState, false );
}
break;
default:
PANIC_NOW ( ( "Undefined power state issued\n" ) );
break;
}
}
if ( isInactive ( ) )
{
fCurrentPowerState = fProposedPowerState;
fCommandGate->commandWakeup ( &fCurrentPowerState, false );
}
ReleaseSCSITask ( request );
}
bool
IOSCSIBlockCommandsDevice::VerifyMediumPresence ( void )
{
SCSI_Sense_Data senseBuffer = { 0 };
IOMemoryDescriptor * bufferDesc = NULL;
SCSITaskIdentifier request = NULL;
bool mediaPresent = false;
bool driveReady = false;
SCSIServiceResponse serviceResponse = kSCSIServiceResponse_SERVICE_DELIVERY_OR_TARGET_FAILURE;
STATUS_LOG ( ( "%s::%s called\n", getName ( ), __FUNCTION__ ) );
bufferDesc = IOMemoryDescriptor::withAddress ( ( void * ) &senseBuffer,
kSenseDefaultSize,
kIODirectionIn );
require_nonzero ( bufferDesc, ErrorExit );
request = GetSCSITask ( );
require_nonzero ( request, ReleaseDescriptor );
do
{
if ( TEST_UNIT_READY ( request, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
if ( serviceResponse == kSCSIServiceResponse_TASK_COMPLETE )
{
bool validSense = false;
if ( GetTaskStatus ( request ) == kSCSITaskStatus_CHECK_CONDITION )
{
validSense = GetAutoSenseData ( request, &senseBuffer );
if ( validSense == false )
{
if ( REQUEST_SENSE ( request, bufferDesc, kSenseDefaultSize, 0 ) == true )
{
serviceResponse = SendCommand ( request, 0 );
}
if ( serviceResponse == kSCSIServiceResponse_TASK_COMPLETE )
{
validSense = true;
}
}
if ( validSense == true )
{
STATUS_LOG ( ( "sense data: %01x, %02x, %02x\n",
( senseBuffer.SENSE_KEY & kSENSE_KEY_Mask ),
senseBuffer.ADDITIONAL_SENSE_CODE,
senseBuffer.ADDITIONAL_SENSE_CODE_QUALIFIER ) );
if ( ( ( senseBuffer.SENSE_KEY & kSENSE_KEY_Mask ) == kSENSE_KEY_NOT_READY ) ||
( ( senseBuffer.SENSE_KEY & kSENSE_KEY_Mask ) == kSENSE_KEY_MEDIUM_ERROR ) )
{
if ( ( senseBuffer.ADDITIONAL_SENSE_CODE == 0x04 ) &&
( senseBuffer.ADDITIONAL_SENSE_CODE_QUALIFIER == 0x02 ) )
{
if ( START_STOP_UNIT ( request, 0x00, 0x00, 0x00, 0x01, 0x00 ) == true )
{
STATUS_LOG ( ( "Sending START_STOP_UNIT.\n" ) );
serviceResponse = SendCommand ( request, 0 );
}
STATUS_LOG ( ( "%s::drive NOT READY\n", getName ( ) ) );
IOSleep ( 200 );
continue;
}
else if ( ( senseBuffer.ADDITIONAL_SENSE_CODE == 0x3A ) &&
( senseBuffer.ADDITIONAL_SENSE_CODE_QUALIFIER == 0x00 ) )
{
STATUS_LOG ( ( "No Media.\n" ) );
driveReady = true;
mediaPresent = false;
}
else
{
STATUS_LOG ( ( "%s::drive NOT READY\n", getName ( ) ) );
IOSleep ( 200 );
continue;
}
}
else
{
STATUS_LOG ( ( "%s::drive READY, media present\n", getName ( ) ) );
driveReady = true;
mediaPresent = true;
}
}
}
else
{
STATUS_LOG ( ( "%s::drive READY, media present\n", getName ( ) ) );
driveReady = true;
mediaPresent = true;
}
}
else
{
IOSleep ( 200 );
}
} while ( ( driveReady == false ) && ( isInactive ( ) == false ) );
ReleaseSCSITask ( request );
ReleaseDescriptor:
require_nonzero ( bufferDesc, ErrorExit );
bufferDesc->release ( );
bufferDesc = NULL;
ErrorExit:
return mediaPresent;
}