supermario/base/SuperMarioProj.1994-02-09/OS/SCSIMgr4pt3/HALc96.c

418 lines
12 KiB
C
Raw Normal View History

2019-06-29 15:17:50 +00:00
/*********************************************************************************
File: HALc96.c
Contains: routines that implement the HAL for 53c96 HBAs (Quadras)
Notes:
This HAL follows the rules for SCSI HALs. That means it:
has 1 Action entry point
has 1 Bus Inquiry entry point
It also has its own rules:
has 1 software and 1 hardware init entry point
these entry points expect a ptr to a CONSTANTs structure that contains addresses
and characteristics of the HBA that it is responsible for. This structure is
called HBADesc_c96.
the 53c96 registers are offset $10 from one another (i.e. reg2 = $20+base)
Entry points:
Written by: Paul Wolf
Copyright: © 1992-1994 by Apple Computer, Inc., all rights reserved.
Change History (most recent first):
<SM24> 2/2/94 DCB Adding another bit to SCSIWeirdStuff - this time to indicate a
need for scsiHandshaking.
<SM23> 2/1/94 DCB Added scsiBusErrorsUnsafe to BusInquiry on emulated pseudo-DMA
machines.
<SM22> 1/28/94 chp Make TNT unconditionally oldCallCapable.
<SM21> 11/22/93 pdw Rolling in from <MCxx>.
<SM20> 11/22/93 pdw Added TNT debug flags around setting of oldCallCapable flag.
<SM19> 11/19/93 chp Nothing to worry about. Just removed a commented-out line of TNT
code.
<SMG3> 9/29/93 chp Clean up header. Remove unnecessary includes. Add a switch case
to initialize the Grand Central HBA software.
<SMG2> 9/22/93 chp Classify the interrupt handler for Grand Central.
<SM17> 10/14/93 pdw Added support for Synchronous data transfers, rewrote State
Machine, message handling etc.
<SM16> 9/12/93 pdw Add ReInit (reregister) stuff.
<SM15> 9/9/93 pdw
<SM14> 7/17/93 pdw Lots of little things.
<SM13> 7/8/93 pdw Got rid of an unnecessary local variable somewhere.
<SM12> 6/29/93 pdw Massive checkins: Change asynchronicity mechanism to CallMachine
stack switching mechanism. Adding support for Cold Fusion.
Rearranging HW/SW Init code. Some code optimizations.
<SM11> 5/25/93 DCB Rollin from Ludwig. (The next item below)
<LW9> 5/21/93 PW Fixed BusInquiry (we weren't filling everything in)
<SM10> 5/5/93 PW Converted names to meanies-friendly names.
<LW8> 4/30/93 DCB Adding entry point for BusInquiry.
<LW6> 3/26/93 PW Changed name of busOldAPICapable to scsiBusOldCallCapable. Wow!
<LW5> 3/1/93 DCB Added slot and srsrc fields to bus inquiry
<LW4> 2/17/93 PW Began to add dual-interrupt support for Quadras.
<SM7> 1/31/93 PW Update from the latest of Ludwig. Also changes required for PDM
(will update Ludwig with these as needed myself).
<LW3> 1/27/93 PW Changing busNoExtern to scsiBusInternalExternal.
<LW2> 1/27/93 PW Changed some fields in BusInquiry including scsiIOFlagsSupported
and scsiFlagsSupported.
<SM6> 12/5/92 PW Changed some field names.
<SM5> 11/20/92 DCB Minor changes to the data returned in BusInquiry
<SM4> 10/30/92 DCB Changed to reflect new acam.h
<SM3> 10/8/92 PW Lots of trivial name changes.
<SM2> 7/28/92 PW Resolved differences in sources.
<SM1> 7/26/92 PW Initial check-in.
**********************************************************************************/
#include <Errors.h>
#include "SCSIGlue.h"
#include "XPTpriv.h"
#include "SIMCorePriv.h"
#include "HALc96.h"
#define PRIVATE_STACK_SIZE 16*1024
extern long HAL_NoISR(HALc96Globals *HALg);
void HALInitCommon( HBADesc_53c9x *hwDescPtr, HALinitInfo * HALinfoPtr);
/*********************************************************************************
Init53c9xHW - Initialize HBA
Initialize 53c96
PSC?
VIA int?
NOTE: For now (3/2/92) I will assume that HW was init'd by InitSCSIMgrHW
*********************************************************************************/
#if 0
long
Init53c9xHW(HBADesc_53c9x *hwDesc)
{
ClearSCSIIRQ(hwDesc);
EnableSCSIInt();
return (0);
}
#endif
/*********************************************************************************
Init53c9xSW - Initialize HAL for 53c96
Register HBA with SIMCore (which will then register with XPT)
*********************************************************************************/
void * // HALg
Init53c9xSW(HBADesc_53c9x *hwDescPtr)
{
HALinitInfo HALinfo;
HALc96Globals * HALg;
// Put our values into registration parameter block
HALInitCommon( hwDescPtr, &HALinfo);
HALinfo.supported_scFlags = SUPPORTED_scFlags;
HALinfo.supported_scIOFlags = SUPPORTED_scIOFlags;
HALinfo.supported_scDataTypes = SUPPORTED_scDataTypes;
// Make call then get HALg from pb
if (SIMRegisterHAL( &HALinfo))
return (0);
HALg = (HALc96Globals *)HALinfo.HALstaticPtr;
return (HALg);
}
/*********************************************************************************
ReInitHAL - Initialize HAL for 53c96
Reregister HBA with SIMCore (which will then reregister with XPT)
*********************************************************************************/
void * // HALg
ReInitHAL(HBADesc_53c9x *hwDescPtr, ushort busID)
{
HALinitInfo HALinfo;
HALc96Globals * HALg;
// Put our values into registration parameter block
HALInitCommon( hwDescPtr, &HALinfo);
HALinfo.busID = busID;
HALinfo.supported_scFlags = SUPPORTED_scFlags;
HALinfo.supported_scIOFlags = SUPPORTED_scIOFlags;
HALinfo.supported_scDataTypes = SUPPORTED_scDataTypes;
// Make call then get HALg from pb
if (SIMReregisterHAL( &HALinfo))
return (0);
HALg = (HALc96Globals *)HALinfo.HALstaticPtr;
return (HALg);
}
/*********************************************************************************
HALInitCommon
ReRegister HBA with SIMCore (which will then reregister with XPT)
*********************************************************************************/
void
HALInitCommon( HBADesc_53c9x *hwDescPtr, HALinitInfo * HALinfoPtr)
{
// Set up HALinfo for call to SIMRegisterHAL
// -> num bytes HAL needs for static vars
HALinfoPtr->staticSize = SizeOfGlobals();
HALinfoPtr->HALstaticPtr = 0;
HALinfoPtr->HALinit = HALinit; // -> ptr to HAL init routine
HALinfoPtr->HALaction = HALaction; // -> ptr to HAL action routine
HALinfoPtr->HALBusInquiry = GetHalInfo; // -> ptr to BusInquiry routine
HALinfoPtr->HALIntPoll = HALIntPoll; // -> ptr to HAL interrupt polling routine
HALinfoPtr->HALResetBus = HALResetBus; // -> ptr to HAL ResetBus routine
HALinfoPtr->HALAssertATN = HALAssertATN; // -> ptr to HAL AssertATN routine
HALinfoPtr->HALTeardownIO = HALTeardownIO; // -> ptr to HAL TeardownIO routine
HALinfoPtr->HALSyncConfig = HALSyncConfig; // -> ptr to HAL SyncConfig routine
// -> ptr to HAL interrupt service routine
switch (hwDescPtr->intTypeSCSI) {
case SHARED_VIA:
HALinfoPtr->HAL_ISR = HAL_DualISR;
break;
case INDEPENDENT_VIA:
HALinfoPtr->HAL_ISR = HAL_SingleISR;
break;
case SECOND_SHARED_VIA:
HALinfoPtr->HAL_ISR = HAL_NoISR;
break;
case GRAND_CENTRAL:
HALinfoPtr->HAL_ISR = HAL_SingleISR;
break;
}
// -> true if this HAL can handle old-API calls
HALinfoPtr->oldCallCapable = true;
// Set up synchronous parameters
HALinfoPtr->HBAisSync = true;
HALinfoPtr->HBAisFast = hwDescPtr->HBAisFast;
if (hwDescPtr->usesThreshold8)
HALinfoPtr->syncRAoffset = 7;
else
HALinfoPtr->syncRAoffset = 15;
if (hwDescPtr->HBAisFast)
HALinfoPtr->minPeriodFactor = 25;
else
HALinfoPtr->minPeriodFactor = 50;
// -- put hwDescPtr in HALinfo so that HALinit can get at it
HALinfoPtr->hwDescPtr = hwDescPtr;
}
/*********************************************************************************
HALinit -
*********************************************************************************/
long
HALinit( HALinitInfo * HALinfoPtr)
{
HALc96Globals * HALg;
HBADesc_53c9x * hwDescPtr;
Ptr privateStack;
OSErr err;
// Get results out of HALinfo and put them in HALglobals
// get HALg ptr from static ptr allocated by SIM
HALg = (HALc96Globals *)(HALinfoPtr->HALstaticPtr);
hwDescPtr = HALinfoPtr->hwDescPtr;
// store entire HWDesc into our globals
HALg->hwDesc = *hwDescPtr;
// If DMA is used, call the Init DMA routine
switch (hwDescPtr->dmaType)
{
case dmaTypePSC:
if (err = InitSW_PSC( HALg))
return (err);
break;
case dmaTypeAMIC:
if (err = InitSW_AMIC( HALg))
return (err);
break;
case dmaTypeGC:
if (err = InitSW_GC( HALg))
return (err);
break;
case dmaTypeNone:
break;
}
HALg->supported_scFlags = HALinfoPtr->supported_scFlags;
HALg->supported_scIOFlags = HALinfoPtr->supported_scIOFlags;
HALg->supported_scDataTypes = HALinfoPtr->supported_scDataTypes;
// store busID as returned from register
HALg->busID = HALinfoPtr->busID;
// store SIMstaticPtr for use in callbacks to SIMCore
HALg->SIMstaticPtr = HALinfoPtr->SIMstaticPtr;
HALg->ReconnectISRptr = HALinfoPtr->ReconnectISR;
HALg->XPT_ISRptr = HALinfoPtr->XPT_ISR;
// Allocate our private stack
privateStack = NewPtrSysClear( PRIVATE_STACK_SIZE);
if (! privateStack )
return (memFullErr);
HALg->privStackTop = privateStack+PRIVATE_STACK_SIZE;
*(--(long *)(HALg->privStackTop)) = 0xDEADFACE;
// initialize Asm stuff
Initc96Asm( HALg);
return (0);
}
/*********************************************************************************
HAL_NoISR
*********************************************************************************/
long
HAL_NoISR( HALc96Globals *HALg)
{
#pragma unused(HALg)
return (0);
}
/*********************************************************************************
GetHalInfo - fill in info parameter block
*********************************************************************************/
long
GetHalInfo( HALc96Globals * HALg, SCSIBusInquiryPB * infoPB )
{
ulong HalFeatures;
HalFeatures = scsiBusOldCallCapable;
// if we've got 2 buses and this is bus 0 then it's an Internal only bus.
if (TestFor_SCSI96_2Exists() ) {
if (HALg->busID == 0)
HalFeatures |= scsiBusInternal;
else
HalFeatures |= scsiBusInternalExternal;
}
else
HalFeatures = scsiBusInternalExternal;
if( HALg->hwDesc.HBAhasDMA )
HalFeatures |= scsiBusDMAavailable;
if( HALg->hwDesc.HBAisFast && (HALg->supported_scFlags & scsiInitiateSyncData) )
HalFeatures |= scsiBusFastSCSI;
if( HALg->hwDesc.HBAisDiff )
HalFeatures |= scsiBusDifferential;
infoPB->scsiFeatureFlags = HalFeatures;
infoPB->scsiFlagsSupported = HALg->supported_scFlags;
infoPB->scsiIOFlagsSupported = HALg->supported_scIOFlags;
infoPB->scsiWeirdStuff = scsiTargetDrivenSDTRSafe;
if ( HALg->hwDesc.usesThreshold8) {
infoPB->scsiWeirdStuff |= scsiOddDisconnectUnsafeWrite1;
}
if( HALg->hwDesc.using601Emulator == true && HALg->hwDesc.HBAhasDMA == false ) {
infoPB->scsiWeirdStuff |= scsiBusErrorsUnsafe;
}
if( HALg->hwDesc.HBAhasDMA == false ) {
infoPB->scsiWeirdStuff |= scsiRequiresHandshake;
}
infoPB->scsiMaxTransferType = kMaxTransferType;
infoPB->scsiDataTypes = HALg->supported_scDataTypes;
infoPB->scsiVersionNumber = scsiVERSION;
infoPB->scsiHBAInquiry = scsiBusSoftReset + 0;
infoPB->scsiTargetModeFlags = 0;
infoPB->scsiScanFlags = 0; // !!! ?
infoPB->scsiHBAslotNumber = 0; // Motherboard Bus
infoPB->scsiSIMsRsrcID = infoPB->scsiDevice.bus; // We don't have an srsrc so we use bus ID
infoPB->scsiEngineCount = 0;
infoPB->scsiAsyncFlags = 0;
infoPB->scsiSIMPrivatesPtr = 0;
infoPB->scsiSIMPrivatesSize = 0;
infoPB->scsiMaxTarget = 7;
infoPB->scsiMaxLUN = 7;
infoPB->scsiInitiatorID = GetInitiatorID( (HBADesc_53c9x *)HALg);
// If anybody cares about this version stuff then we should put the
// version number in a public header somewhere. Otherwise...
infoPB->scsiSIMversion[0] = 0;
infoPB->scsiSIMversion[1] = 1; // version = 1.00
infoPB->scsiSIMversion[2] = 0;
infoPB->scsiSIMversion[3] = 0;
infoPB->scsiHBAversion[0] = 0;
infoPB->scsiHBAversion[1] = 1; // version = 1.00
infoPB->scsiHBAversion[2] = 0;
infoPB->scsiHBAversion[3] = 0;
BlockMove("Apple Computer \0",infoPB->scsiSIMVendor,16);
BlockMove("Apple Computer \0",infoPB->scsiHBAVendor,16);
BlockMove("NCR 53c96 \0",infoPB->scsiControllerFamily,16);
BlockMove("Unknown... \0",infoPB->scsiControllerType,16);
infoPB->scsiAdditionalLength = 0;
return(0);
}