mirror of
https://github.com/elliotnunn/sys7.1-doc-wip.git
synced 2024-12-12 04:29:09 +00:00
320 lines
8.3 KiB
C
320 lines
8.3 KiB
C
/*
|
||
File: UniversalEqu.h
|
||
|
||
Contains: low-level equates for accessing the Universal ROM information
|
||
|
||
Written by: Craig Prouse
|
||
|
||
Copyright: © 1993 by Apple Computer, Inc., all rights reserved.
|
||
|
||
Change History (most recent first):
|
||
|
||
<1> 11/10/93 fau first checked in
|
||
|
||
*/
|
||
|
||
#ifndef __UNIVERSALEQU__
|
||
#define __UNIVERSALEQU__
|
||
|
||
|
||
/* private low-memory globals for Universal info */
|
||
|
||
enum {
|
||
AddrMapFlags = 0x0DD0, // RAM copy of the machine’s BasesValid flags
|
||
AddrMapFlags1 = 0x2400,
|
||
AddrMapFlags2 = 0x2404,
|
||
UnivROMFlags = 0x0DD4, // RAM copy of the machine’s ExtValid flags
|
||
UnivROMFlags1 = 0x2408,
|
||
UnivROMFlags2 = 0x240C,
|
||
UnivInfoPtr = 0x0DD8 // points to the machine’s ProductInfo record
|
||
};
|
||
|
||
|
||
|
||
// --------------------------------------------------------------------------------------------
|
||
// DecoderInfo Record
|
||
//
|
||
// This record contains information pertaining to the memory decoder
|
||
// of a particular machine.
|
||
//
|
||
// If you change the DecoderInfo record, bump the version up by 1.
|
||
//--------------------------------------------------------------------------------------------
|
||
|
||
#define DecoderInfoVersion 1
|
||
|
||
|
||
// This record actually precedes the DecoderInfo record below. Normally accessed only
|
||
// from assembly language using negative offsets, a pointer to this information can
|
||
// also be generated by subtracting the size of this record from the address of the
|
||
// DecoderInfo record.
|
||
|
||
struct DecoderInfoPrivate {
|
||
unsigned long defaultBases;
|
||
unsigned long defaultBases1;
|
||
unsigned long defaultBases2;
|
||
unsigned long defExtFeatures;
|
||
unsigned long defExtFeatures1;
|
||
unsigned long defExtFeatures2;
|
||
unsigned char avoidVIA1A;
|
||
unsigned char avoidVIA1B;
|
||
unsigned char avoidVIA2A;
|
||
unsigned char avoidVIA2B;
|
||
long checkForProc;
|
||
unsigned char addrMap;
|
||
unsigned char decoderInfoVers;
|
||
unsigned char filler [2];
|
||
};
|
||
|
||
|
||
struct DecoderInfo {
|
||
|
||
void * ROMAddr;
|
||
void * DiagROMAddr;
|
||
void * VIA1Addr;
|
||
void * SCCRdAddr;
|
||
void * SCCWrAddr;
|
||
void * IWMAddr;
|
||
void * PWMAddr;
|
||
void * SoundAddr;
|
||
void * SCSIAddr;
|
||
void * SCSIDackAddr;
|
||
void * SCSIHskAddr;
|
||
void * VIA2Addr;
|
||
void * ASCAddr;
|
||
void * RBVAddr;
|
||
void * VDACAddr;
|
||
void * SCSIDMAAddr;
|
||
void * SWIMIOPAddr;
|
||
void * SCCIOPAddr;
|
||
void * OSSAddr;
|
||
void * FMCAddr;
|
||
void * RPUAddr;
|
||
void * OrwellAddr;
|
||
void * JAWSAddr;
|
||
void * SonicAddr;
|
||
void * SCSI96Addr1;
|
||
void * SCSI96Addr2;
|
||
void * DAFBAddr;
|
||
void * PSCAddr;
|
||
void * ROMPhysAddr;
|
||
void * PatchROMAddr;
|
||
void * NewAgeAddr;
|
||
void * Unused31Addr;
|
||
|
||
void * SingerAddr;
|
||
void * DSPAddr;
|
||
void * MACEAddr;
|
||
void * MUNIAddr;
|
||
void * AMICAddr;
|
||
void * PrattAddr;
|
||
void * SWIM3Addr;
|
||
void * AwacsAddr;
|
||
void * CivicAddr;
|
||
void * SebastianAddr;
|
||
void * BARTAddr;
|
||
void * GrandCentralAddr;
|
||
void * Unused44Addr;
|
||
void * Unused45Addr;
|
||
void * Unused46Addr;
|
||
void * Unused47Addr;
|
||
void * Unused48Addr;
|
||
void * Unused49Addr;
|
||
void * Unused50Addr;
|
||
void * Unused51Addr;
|
||
void * Unused52Addr;
|
||
void * Unused53Addr;
|
||
void * Unused54Addr;
|
||
void * Unused55Addr;
|
||
void * Unused56Addr;
|
||
void * Unused57Addr;
|
||
void * Unused58Addr;
|
||
void * Unused59Addr;
|
||
void * Unused60Addr;
|
||
void * Unused61Addr;
|
||
void * FooAddr;
|
||
void * Unused63Addr;
|
||
|
||
void * Unused64Addr;
|
||
void * BarAddr;
|
||
void * Unused66Addr;
|
||
void * Unused67Addr;
|
||
void * Unused68Addr;
|
||
void * Unused69Addr;
|
||
void * Unused70Addr;
|
||
void * Unused71Addr;
|
||
void * Unused72Addr;
|
||
void * Unused73Addr;
|
||
void * Unused74Addr;
|
||
void * Unused75Addr;
|
||
void * Unused76Addr;
|
||
void * Unused77Addr;
|
||
void * Unused78Addr;
|
||
void * Unused79Addr;
|
||
void * Unused80Addr;
|
||
void * Unused81Addr;
|
||
void * Unused82Addr;
|
||
void * Unused83Addr;
|
||
void * Unused84Addr;
|
||
void * Unused85Addr;
|
||
void * Unused86Addr;
|
||
void * Unused87Addr;
|
||
void * Unused88Addr;
|
||
void * Unused89Addr;
|
||
void * Unused90Addr;
|
||
void * Unused91Addr;
|
||
void * Unused92Addr;
|
||
void * Unused93Addr;
|
||
void * Unused94Addr;
|
||
void * Unused95Addr;
|
||
};
|
||
typedef struct DecoderInfo DecoderInfo;
|
||
|
||
|
||
enum DecoderKinds {
|
||
UnknownDecoder,
|
||
MacPALDecoder,
|
||
BBUDecoder,
|
||
NormandyDecoder,
|
||
GLUEDecoder,
|
||
MDUDecoder,
|
||
OSSFMCDecoder,
|
||
VISADecoder,
|
||
OrwellDecoder,
|
||
JAWSDecoder,
|
||
MSCDecoder,
|
||
SonoraDecoder,
|
||
NiagraDecoder,
|
||
YMCADecoder,
|
||
djMEMCDecoder,
|
||
HMCDecoder,
|
||
PrattDecoder,
|
||
HHeadDecoder
|
||
};
|
||
|
||
|
||
enum BasesValidFlags {
|
||
ROMExists,
|
||
DiagROMExists,
|
||
VIA1Exists,
|
||
SCCRdExists,
|
||
SCCWrExists,
|
||
IWMExists,
|
||
PWMExists,
|
||
SoundExists,
|
||
SCSIExists,
|
||
SCSIDackExists,
|
||
SCSIHskExists,
|
||
VIA2Exists,
|
||
ASCExists,
|
||
RBVExists,
|
||
VDACExists,
|
||
SCSIDMAExists,
|
||
SWIMIOPExists,
|
||
SCCIOPExists,
|
||
OSSExists,
|
||
FMCExists,
|
||
RPUExists,
|
||
OrwellExists,
|
||
JAWSExists,
|
||
SonicExists,
|
||
SCSI96_1Exists,
|
||
SCSI96_2Exists,
|
||
DAFBExists,
|
||
PSCExists,
|
||
ROMPhysAddrExists,
|
||
PatchROMExists,
|
||
NewAgeExists,
|
||
|
||
SingerExists = 32,
|
||
DSPExists,
|
||
MACEExists,
|
||
MUNIExists,
|
||
AMICExists,
|
||
PrattExists,
|
||
SWIM3Exists,
|
||
AwacsExists,
|
||
CivicExists,
|
||
SebastianExists,
|
||
BARTExists,
|
||
GrandCentralExists
|
||
};
|
||
|
||
|
||
// This macro is equivalent in part to the assembly language TestFor macro,
|
||
// although it only works for features listed in DecoderInfo. It requires a
|
||
// BasesValidFlag (enumerated above) and returns a boolean value. Example:
|
||
// if (TestForBaseAddr(GrandCentralExists)) { }
|
||
|
||
#define TestForBaseAddr(bvFlag) \
|
||
((1 << ((bvFlag) & 0x1F) & \
|
||
((bvFlag) < 32 ? *(unsigned long *) AddrMapFlags : \
|
||
((bvFlag) < 64 ? *(unsigned long *) AddrMapFlags1 : \
|
||
((bvFlag) < 96 ? *(unsigned long *) AddrMapFlags2 : \
|
||
0)))) != 0)
|
||
|
||
|
||
// This macro is used to conveniently recover a base address from the DecoderInfo
|
||
// table in one easy-to-read operation. Assuming that the corresponding BasesValid
|
||
// flag is true, the base address can be recovered directly by its field name in
|
||
// the DecoderInfo record. The macro handles all the arcane offsets, casts, and
|
||
// dereferences. Example:
|
||
// void *gcBase = GetUnivInfoBaseAddr(GrandCentralAddr);
|
||
|
||
#define GetUnivInfoBaseAddr(fieldName) \
|
||
(((DecoderInfo *) (*(unsigned long *) UnivInfoPtr \
|
||
+ (**(ProductInfo **) UnivInfoPtr).decoderInfoPtr)) \
|
||
->##fieldName)
|
||
|
||
|
||
|
||
//--------------------------------------------------------------------------------------------
|
||
// ProductInfo Record
|
||
//
|
||
// This record contains information specific to a particular machine.
|
||
// The lowmem UnivInfoPtr is a pointer to this data structure.
|
||
//
|
||
// If you change the ProductInfo record, bump the version up by 1.
|
||
//--------------------------------------------------------------------------------------------
|
||
|
||
#define ProductInfoVersion 1
|
||
|
||
|
||
struct ProductInfo {
|
||
|
||
long decoderInfoPtr; // offset to address decoder info
|
||
long ramInfoPtr; // offset to RAM bank base/size info
|
||
long videoInfoPtr; // offset to built-in video info
|
||
long nubusInfoPtr; // offset to NuBus slot info
|
||
unsigned short hwCfgWord; // value to load into hwCfgFlags
|
||
unsigned char productKind; // unique ID of this product (boxFlag value)
|
||
unsigned char decoderKind; // unique ID of associated address decoder
|
||
unsigned short rom85Word; // value to load into ROM85
|
||
unsigned char defaultRSRCs; // default ROM resource configuration
|
||
unsigned char productInfoVers; // version number of ProductInfo record
|
||
|
||
unsigned long basesValid; // valid flags for base addresses 0-31
|
||
unsigned long basesValid1; // valid flags for base addresses 32-63
|
||
unsigned long basesValid2; // valid flags for base addresses 64-95
|
||
unsigned long extValid; // valid flags for external features 0-31
|
||
unsigned long extValid1; // valid flags for external features 32-63
|
||
unsigned long extValid2; // valid flags for external features 64-95
|
||
unsigned long viaIDMask; // mask for VIA1/2 port A/B inputs
|
||
unsigned long viaIDMatch; // value to match to identify this product
|
||
long via1InitPtr; // offset to VIA1 initialization info
|
||
long via2InitPtr; // offset to VIA2 initialization info
|
||
|
||
long sndControlPtr; // offset to low level sound vector table
|
||
long clockPRAMPtr; // offset to low level clock/PRAM vector table
|
||
long adbDebugUtilPtr; // offset to low level ADB/DebugUtil vector table
|
||
long powerManagerPtr; // offset to low level Power Manager vector table
|
||
long intHandlerPtr; // offset to low level interrupt handler setup table
|
||
|
||
unsigned short cpuIDValue; // expected contents of CPU ID register
|
||
unsigned short filler;
|
||
long iconInfoPtr; // offset to icon info table
|
||
};
|
||
typedef struct ProductInfo ProductInfo;
|
||
|
||
|
||
#endif __UNIVERSALEQU__
|