[apple/xnu.git] / iokit / IOKit / IOPlatformExpert.h

/*
 * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 * 
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. The rights granted to you under the License
 * may not be used to create, or enable the creation or redistribution of,
 * unlawful or unlicensed copies of an Apple operating system, or to
 * circumvent, violate, or enable the circumvention or violation of, any
 * terms of an Apple operating system software license agreement.
 * 
 * Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this file.
 * 
 * The Original Code and all software distributed under the License are
 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
 */
/*
 * Copyright (c) 1998 Apple Computer, Inc.  All rights reserved. 
 *
 * HISTORY
 *
 */


#ifndef _IOKIT_IOPLATFORMEXPERT_H
#define _IOKIT_IOPLATFORMEXPERT_H

#ifdef __cplusplus
#include <IOKit/IOLib.h>
#include <IOKit/IOService.h>
#include <IOKit/IOInterrupts.h>
#include <IOKit/IOInterruptController.h>

extern "C" {
#endif

#include <libkern/OSTypes.h>

typedef enum {
    kCoprocessorVersionNone    =   0x00000000,
    kCoprocessorVersion1       =   0x00010000,
    kCoprocessorVersion2       =   0x00020000,
} coprocessor_type_t;


extern boolean_t PEGetMachineName( char * name, int maxLength );
extern boolean_t PEGetModelName( char * name, int maxLength );
extern int PEGetPlatformEpoch( void );

enum {
  kPEHaltCPU,
  kPERestartCPU,
  kPEHangCPU,
  kPEUPSDelayHaltCPU,
  kPEPanicRestartCPU,
  kPEPanicSync,
  kPEPagingOff,
  kPEPanicBegin,
  kPEPanicEnd,
  kPEPanicDiskShutdown
};
extern int (*PE_halt_restart)(unsigned int type);
extern int PEHaltRestart(unsigned int type);

// Save the Panic Info.  Returns the number of bytes saved.
extern UInt32 PESavePanicInfo(UInt8 *buffer, UInt32 length);
extern void PESavePanicInfoAction(void *buffer, UInt32 offset, UInt32 length);

/* 
 * SMC requires that all data is flushed in multiples of 16 bytes at 16 byte
 * boundaries.
 */
#define PANIC_FLUSH_BOUNDARY 16

extern long PEGetGMTTimeOfDay( void );
extern void PESetGMTTimeOfDay( long secs );
extern void PEGetUTCTimeOfDay( clock_sec_t * secs, clock_usec_t * usecs );
extern void PESetUTCTimeOfDay( clock_sec_t secs, clock_usec_t usecs );

/* unless it's a "well-known" property, these will read/write out the value as raw data */

extern boolean_t PEWriteNVRAMBooleanProperty(const char *symbol, boolean_t value);
extern boolean_t PEWriteNVRAMProperty(const char *symbol, const void *value, const unsigned int len);

extern boolean_t PEReadNVRAMProperty(const char *symbol, void *value, unsigned int *len);

extern boolean_t PERemoveNVRAMProperty(const char *symbol);

extern coprocessor_type_t PEGetCoprocessorVersion( void );

#ifdef __cplusplus
} /* extern "C" */

#define kIOPlatformMapperPresentKey "IOPlatformMapperPresent"


extern OSSymbol *               gPlatformInterruptControllerName;

extern const OSSymbol *		gIOPlatformSleepActionKey;
extern const OSSymbol *		gIOPlatformWakeActionKey;
extern const OSSymbol *		gIOPlatformQuiesceActionKey;
extern const OSSymbol *		gIOPlatformActiveActionKey;
extern const OSSymbol *		gIOPlatformHaltRestartActionKey;
extern const OSSymbol *		gIOPlatformPanicActionKey;

class IORangeAllocator;
class IONVRAMController;
class IOPMrootDomain;

class IOPlatformExpert : public IOService
{
    OSDeclareDefaultStructors(IOPlatformExpert);

private:
    long _peBootROMType;
    long _peChipSetType;
    long _peMachineType;

protected:
    IOPMrootDomain * root;
    int _pePMFeatures;
    int _pePrivPMFeatures;
    int _peNumBatteriesSupported;
    OSArray  * thePowerTree;

    bool       searchingForAdditionalParents;
    OSNumber * multipleParentKeyValue;
    int        numInstancesRegistered;

    struct ExpansionData { };
    ExpansionData *reserved;

    virtual void setBootROMType(long peBootROMType);
    virtual void setChipSetType(long peChipSetType);
    virtual void setMachineType(long peMachineType);

    virtual bool CheckSubTree (OSArray * inSubTree, IOService * theNub, IOService * theDevice, OSDictionary * theParent);
    virtual bool RegisterServiceInTree (IOService * theService, OSDictionary * theTreeNode, OSDictionary * theTreeParentNode, IOService * theProvider);

    virtual void PMInstantiatePowerDomains ( void );

public:
    virtual bool attach( IOService * provider ) APPLE_KEXT_OVERRIDE;
    virtual bool start( IOService * provider ) APPLE_KEXT_OVERRIDE;
    virtual bool configure( IOService * provider );
    virtual IOService * createNub( OSDictionary * from );

    virtual bool compareNubName( const IOService * nub, OSString * name,
				 OSString ** matched = 0 ) const;
    virtual IOReturn getNubResources( IOService * nub );

    virtual long getBootROMType(void);
    virtual long getChipSetType(void);
    virtual long getMachineType(void);

    virtual bool getModelName( char * name, int maxLength );
    virtual bool getMachineName( char * name, int maxLength );

    virtual int haltRestart(unsigned int type);
    virtual void sleepKernel(void);

    virtual long getGMTTimeOfDay( void );
    virtual void setGMTTimeOfDay( long secs );

    virtual IOReturn getConsoleInfo( PE_Video * consoleInfo );
    virtual IOReturn setConsoleInfo( PE_Video * consoleInfo, unsigned int op );

    virtual void registerNVRAMController( IONVRAMController * nvram );

    virtual IOReturn registerInterruptController(OSSymbol *name, IOInterruptController *interruptController);
    virtual IOInterruptController *lookUpInterruptController(OSSymbol *name);
    virtual void setCPUInterruptProperties(IOService *service);
    virtual bool atInterruptLevel(void);

    virtual IOReturn callPlatformFunction(const OSSymbol *functionName,
					  bool waitForFunction,
					  void *param1, void *param2,
					  void *param3, void *param4) APPLE_KEXT_OVERRIDE;

    virtual IORangeAllocator * getPhysicalRangeAllocator(void);

    virtual bool platformAdjustService(IOService *service);

    virtual void PMRegisterDevice(IOService * theNub, IOService * theDevice);
    virtual void PMLog ( const char *,unsigned long, unsigned long, unsigned long );

    virtual bool hasPMFeature (unsigned long featureMask);
    virtual bool hasPrivPMFeature (unsigned long privFeatureMask);
    virtual int  numBatteriesSupported (void);

    virtual IOByteCount savePanicInfo(UInt8 *buffer, IOByteCount length);

    virtual OSString* createSystemSerialNumberString(OSData* myProperty);

    virtual IOReturn deregisterInterruptController(OSSymbol *name);

    virtual void getUTCTimeOfDay( clock_sec_t * secs, clock_nsec_t * nsecs );
    virtual void setUTCTimeOfDay( clock_sec_t secs, clock_nsec_t nsecs );

    OSMetaClassDeclareReservedUsed(IOPlatformExpert,  0);
    OSMetaClassDeclareReservedUsed(IOPlatformExpert,  1);
    OSMetaClassDeclareReservedUsed(IOPlatformExpert,  2);
    OSMetaClassDeclareReservedUsed(IOPlatformExpert,  3);
    OSMetaClassDeclareReservedUsed(IOPlatformExpert,  4);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert,  5);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert,  6);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert,  7);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert,  8);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert,  9);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert, 10);
    OSMetaClassDeclareReservedUnused(IOPlatformExpert, 11);
};

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

class IODTNVRAM;

class IODTPlatformExpert : public IOPlatformExpert
{
    OSDeclareAbstractStructors(IODTPlatformExpert);

private:
    IODTNVRAM *dtNVRAM;

    struct ExpansionData { };
    ExpansionData *reserved;

public:
    virtual IOService * probe(	IOService * 	provider,
				SInt32 	  *	score ) APPLE_KEXT_OVERRIDE;
    virtual bool configure( IOService * provider ) APPLE_KEXT_OVERRIDE;

    virtual void processTopLevel( IORegistryEntry * root );
    virtual const char * deleteList( void ) = 0;
    virtual const char * excludeList( void ) = 0;
    virtual IOService * createNub( IORegistryEntry * from );
    virtual bool createNubs( IOService * parent, OSIterator * iter );

    virtual bool compareNubName( const IOService * nub, OSString * name,
				 OSString ** matched = 0 ) const APPLE_KEXT_OVERRIDE;

    virtual IOReturn getNubResources( IOService * nub ) APPLE_KEXT_OVERRIDE;

    virtual bool getModelName( char * name, int maxLength ) APPLE_KEXT_OVERRIDE;
    virtual bool getMachineName( char * name, int maxLength ) APPLE_KEXT_OVERRIDE;
    
    virtual void registerNVRAMController( IONVRAMController * nvram ) APPLE_KEXT_OVERRIDE;

    virtual int haltRestart(unsigned int type) APPLE_KEXT_OVERRIDE;

    /* virtual */ IOReturn readXPRAM(IOByteCount offset, UInt8 * buffer,
				     IOByteCount length);

    /* virtual */ IOReturn writeXPRAM(IOByteCount offset, UInt8 * buffer,
				      IOByteCount length);

    virtual IOReturn readNVRAMProperty(
	IORegistryEntry * entry,
	const OSSymbol ** name, OSData ** value );

    virtual IOReturn writeNVRAMProperty(
	IORegistryEntry * entry,
	const OSSymbol * name, OSData * value );

    // This returns a dictionary describing all the NVRAM partitions.
    // The keys will be the partitionIDs of the form "0x52,nvram".
    // The values will be OSNumbers of the partition's byte count.
    /* virtual */ OSDictionary *getNVRAMPartitions(void);

    /* virtual */ IOReturn readNVRAMPartition(const OSSymbol * partitionID,
					      IOByteCount offset, UInt8 * buffer,
					      IOByteCount length);

    /* virtual */ IOReturn writeNVRAMPartition(const OSSymbol * partitionID,
					       IOByteCount offset, UInt8 * buffer,
					       IOByteCount length);

    virtual IOByteCount savePanicInfo(UInt8 *buffer, IOByteCount length) APPLE_KEXT_OVERRIDE;
    virtual OSString* createSystemSerialNumberString(OSData* myProperty) APPLE_KEXT_OVERRIDE;

    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  0);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  1);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  2);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  3);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  4);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  5);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  6);
    OSMetaClassDeclareReservedUnused(IODTPlatformExpert,  7);
};

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

/* generic root nub of service tree */

class IOPlatformExpertDevice : public IOService
{
    OSDeclareDefaultStructors(IOPlatformExpertDevice)

private:
    IOWorkLoop *workLoop;

    struct ExpansionData { };
    ExpansionData *reserved;

public:
    virtual bool initWithArgs( void * p1, void * p2,
					void * p3, void *p4 );
    virtual bool compareName( OSString * name, OSString ** matched = 0 ) const APPLE_KEXT_OVERRIDE;

    virtual IOWorkLoop *getWorkLoop() const APPLE_KEXT_OVERRIDE;
    virtual IOReturn setProperties( OSObject * properties ) APPLE_KEXT_OVERRIDE;

    virtual void free() APPLE_KEXT_OVERRIDE;

    virtual IOReturn newUserClient( task_t owningTask, void * securityID,
                                    UInt32 type,  OSDictionary * properties,
                                    IOUserClient ** handler) APPLE_KEXT_OVERRIDE;


    OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice,  0);
    OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice,  1);
    OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice,  2);
    OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice,  3);
};

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

/* generic nub for motherboard devices */

class IOPlatformDevice : public IOService
{
    OSDeclareDefaultStructors(IOPlatformDevice)

    struct ExpansionData { };
    ExpansionData *reserved;

public:
    virtual bool compareName( OSString * name, OSString ** matched = 0 ) const APPLE_KEXT_OVERRIDE;
    virtual IOService * matchLocation( IOService * client ) APPLE_KEXT_OVERRIDE;
    virtual IOReturn getResources( void ) APPLE_KEXT_OVERRIDE;

    OSMetaClassDeclareReservedUnused(IOPlatformDevice,  0);
    OSMetaClassDeclareReservedUnused(IOPlatformDevice,  1);
    OSMetaClassDeclareReservedUnused(IOPlatformDevice,  2);
    OSMetaClassDeclareReservedUnused(IOPlatformDevice,  3);
};

#endif /* __cplusplus */

#endif /* ! _IOKIT_IOPLATFORMEXPERT_H */
Commit	Line	Data
1c79356b A	1	/*
	2	* Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
	3	*
2d21ac55	4	* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
1c79356b	5	*
2d21ac55 A	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. The rights granted to you under the License
	10	* may not be used to create, or enable the creation or redistribution of,
	11	* unlawful or unlicensed copies of an Apple operating system, or to
	12	* circumvent, violate, or enable the circumvention or violation of, any
	13	* terms of an Apple operating system software license agreement.
8f6c56a5	14	*
2d21ac55 A	15	* Please obtain a copy of the License at
	16	* http://www.opensource.apple.com/apsl/ and read it before using this file.
	17	*
	18	* The Original Code and all software distributed under the License are
	19	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
8f6c56a5 A	20	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
8f6c56a5 A	21	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
2d21ac55 A	22	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	23	* Please see the License for the specific language governing rights and
	24	* limitations under the License.
8f6c56a5	25	*
2d21ac55	26	* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
1c79356b A	27	*/
	28	/*
	29	* Copyright (c) 1998 Apple Computer, Inc. All rights reserved.
	30	*
	31	* HISTORY
	32	*
	33	*/
	34
	35
	36	#ifndef _IOKIT_IOPLATFORMEXPERT_H
	37	#define _IOKIT_IOPLATFORMEXPERT_H
	38
	39	#ifdef __cplusplus
	40	#include <IOKit/IOLib.h>
	41	#include <IOKit/IOService.h>
	42	#include <IOKit/IOInterrupts.h>
	43	#include <IOKit/IOInterruptController.h>
	44
	45	extern "C" {
	46	#endif
	47
b0d623f7 A	48	#include <libkern/OSTypes.h>
b0d623f7 A	49
5c9f4661 A	50	typedef enum {
	51	kCoprocessorVersionNone = 0x00000000,
	52	kCoprocessorVersion1 = 0x00010000,
	53	kCoprocessorVersion2 = 0x00020000,
	54	} coprocessor_type_t;
	55
	56
1c79356b A	57	extern boolean_t PEGetMachineName( char * name, int maxLength );
	58	extern boolean_t PEGetModelName( char * name, int maxLength );
	59	extern int PEGetPlatformEpoch( void );
	60
	61	enum {
	62	kPEHaltCPU,
9bccf70c	63	kPERestartCPU,
0c530ab8	64	kPEHangCPU,
2d21ac55 A	65	kPEUPSDelayHaltCPU,
2d21ac55 A	66	kPEPanicRestartCPU,
6d2010ae	67	kPEPanicSync,
5ba3f43e A	68	kPEPagingOff,
5ba3f43e A	69	kPEPanicBegin,
cc8bc92a A	70	kPEPanicEnd,
cc8bc92a A	71	kPEPanicDiskShutdown
1c79356b A	72	};
	73	extern int (*PE_halt_restart)(unsigned int type);
	74	extern int PEHaltRestart(unsigned int type);
	75
9bccf70c	76	// Save the Panic Info. Returns the number of bytes saved.
b0d623f7	77	extern UInt32 PESavePanicInfo(UInt8 *buffer, UInt32 length);
5c9f4661 A	78	extern void PESavePanicInfoAction(void *buffer, UInt32 offset, UInt32 length);
	79
	80	/*
	81	* SMC requires that all data is flushed in multiples of 16 bytes at 16 byte
	82	* boundaries.
	83	*/
	84	#define PANIC_FLUSH_BOUNDARY 16
9bccf70c	85
1c79356b A	86	extern long PEGetGMTTimeOfDay( void );
1c79356b A	87	extern void PESetGMTTimeOfDay( long secs );
fe8ab488 A	88	extern void PEGetUTCTimeOfDay( clock_sec_t * secs, clock_usec_t * usecs );
	89	extern void PESetUTCTimeOfDay( clock_sec_t secs, clock_usec_t usecs );
	90
6d2010ae A	91	/* unless it's a "well-known" property, these will read/write out the value as raw data */
6d2010ae A	92
3e170ce0	93	extern boolean_t PEWriteNVRAMBooleanProperty(const char *symbol, boolean_t value);
6d2010ae A	94	extern boolean_t PEWriteNVRAMProperty(const char symbol, const void value, const unsigned int len);
	95
	96	extern boolean_t PEReadNVRAMProperty(const char symbol, void value, unsigned int *len);
	97
39236c6e A	98	extern boolean_t PERemoveNVRAMProperty(const char *symbol);
39236c6e A	99
5c9f4661 A	100	extern coprocessor_type_t PEGetCoprocessorVersion( void );
5c9f4661 A	101
1c79356b A	102	#ifdef __cplusplus
	103	} /* extern "C" */
	104
55e303ae A	105	#define kIOPlatformMapperPresentKey "IOPlatformMapperPresent"
55e303ae A	106
2d21ac55	107
5c9f4661 A	108
5c9f4661 A	109
2d21ac55 A	110	extern OSSymbol * gPlatformInterruptControllerName;
	111
	112	extern const OSSymbol * gIOPlatformSleepActionKey;
	113	extern const OSSymbol * gIOPlatformWakeActionKey;
	114	extern const OSSymbol * gIOPlatformQuiesceActionKey;
	115	extern const OSSymbol * gIOPlatformActiveActionKey;
fe8ab488	116	extern const OSSymbol * gIOPlatformHaltRestartActionKey;
3e170ce0	117	extern const OSSymbol * gIOPlatformPanicActionKey;
1c79356b A	118
	119	class IORangeAllocator;
	120	class IONVRAMController;
	121	class IOPMrootDomain;
	122
	123	class IOPlatformExpert : public IOService
	124	{
	125	OSDeclareDefaultStructors(IOPlatformExpert);
	126
	127	private:
	128	long _peBootROMType;
	129	long _peChipSetType;
	130	long _peMachineType;
	131
	132	protected:
	133	IOPMrootDomain * root;
	134	int _pePMFeatures;
	135	int _pePrivPMFeatures;
	136	int _peNumBatteriesSupported;
	137	OSArray * thePowerTree;
	138
	139	bool searchingForAdditionalParents;
	140	OSNumber * multipleParentKeyValue;
	141	int numInstancesRegistered;
	142
	143	struct ExpansionData { };
	144	ExpansionData *reserved;
	145
	146	virtual void setBootROMType(long peBootROMType);
	147	virtual void setChipSetType(long peChipSetType);
	148	virtual void setMachineType(long peMachineType);
	149
	150	virtual bool CheckSubTree (OSArray * inSubTree, IOService * theNub, IOService * theDevice, OSDictionary * theParent);
	151	virtual bool RegisterServiceInTree (IOService * theService, OSDictionary * theTreeNode, OSDictionary * theTreeParentNode, IOService * theProvider);
	152
	153	virtual void PMInstantiatePowerDomains ( void );
	154
	155	public:
3e170ce0 A	156	virtual bool attach( IOService * provider ) APPLE_KEXT_OVERRIDE;
3e170ce0 A	157	virtual bool start( IOService * provider ) APPLE_KEXT_OVERRIDE;
1c79356b A	158	virtual bool configure( IOService * provider );
	159	virtual IOService * createNub( OSDictionary * from );
	160
	161	virtual bool compareNubName( const IOService * nub, OSString * name,
	162	OSString ** matched = 0 ) const;
	163	virtual IOReturn getNubResources( IOService * nub );
	164
	165	virtual long getBootROMType(void);
	166	virtual long getChipSetType(void);
	167	virtual long getMachineType(void);
	168
	169	virtual bool getModelName( char * name, int maxLength );
	170	virtual bool getMachineName( char * name, int maxLength );
	171
	172	virtual int haltRestart(unsigned int type);
	173	virtual void sleepKernel(void);
	174
	175	virtual long getGMTTimeOfDay( void );
	176	virtual void setGMTTimeOfDay( long secs );
	177
	178	virtual IOReturn getConsoleInfo( PE_Video * consoleInfo );
	179	virtual IOReturn setConsoleInfo( PE_Video * consoleInfo, unsigned int op );
	180
	181	virtual void registerNVRAMController( IONVRAMController * nvram );
	182
	183	virtual IOReturn registerInterruptController(OSSymbol name, IOInterruptController interruptController);
	184	virtual IOInterruptController lookUpInterruptController(OSSymbol name);
	185	virtual void setCPUInterruptProperties(IOService *service);
	186	virtual bool atInterruptLevel(void);
	187
	188	virtual IOReturn callPlatformFunction(const OSSymbol *functionName,
	189	bool waitForFunction,
	190	void param1, void param2,
3e170ce0	191	void param3, void param4) APPLE_KEXT_OVERRIDE;
1c79356b A	192
	193	virtual IORangeAllocator * getPhysicalRangeAllocator(void);
	194
	195	virtual bool platformAdjustService(IOService *service);
	196
	197	virtual void PMRegisterDevice(IOService * theNub, IOService * theDevice);
	198	virtual void PMLog ( const char *,unsigned long, unsigned long, unsigned long );
	199
	200	virtual bool hasPMFeature (unsigned long featureMask);
	201	virtual bool hasPrivPMFeature (unsigned long privFeatureMask);
	202	virtual int numBatteriesSupported (void);
	203
9bccf70c A	204	virtual IOByteCount savePanicInfo(UInt8 *buffer, IOByteCount length);
9bccf70c A	205
55e303ae	206	virtual OSString* createSystemSerialNumberString(OSData* myProperty);
fe8ab488 A	207
	208	virtual IOReturn deregisterInterruptController(OSSymbol *name);
	209
	210	virtual void getUTCTimeOfDay( clock_sec_t * secs, clock_nsec_t * nsecs );
	211	virtual void setUTCTimeOfDay( clock_sec_t secs, clock_nsec_t nsecs );
	212
9bccf70c	213	OSMetaClassDeclareReservedUsed(IOPlatformExpert, 0);
55e303ae	214	OSMetaClassDeclareReservedUsed(IOPlatformExpert, 1);
fe8ab488 A	215	OSMetaClassDeclareReservedUsed(IOPlatformExpert, 2);
	216	OSMetaClassDeclareReservedUsed(IOPlatformExpert, 3);
	217	OSMetaClassDeclareReservedUsed(IOPlatformExpert, 4);
1c79356b A	218	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 5);
	219	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 6);
	220	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 7);
	221	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 8);
	222	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 9);
	223	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 10);
	224	OSMetaClassDeclareReservedUnused(IOPlatformExpert, 11);
	225	};
	226
	227	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
	228
	229	class IODTNVRAM;
	230
	231	class IODTPlatformExpert : public IOPlatformExpert
	232	{
	233	OSDeclareAbstractStructors(IODTPlatformExpert);
	234
	235	private:
	236	IODTNVRAM *dtNVRAM;
	237
	238	struct ExpansionData { };
	239	ExpansionData *reserved;
	240
	241	public:
	242	virtual IOService * probe( IOService * provider,
3e170ce0 A	243	SInt32 * score ) APPLE_KEXT_OVERRIDE;
3e170ce0 A	244	virtual bool configure( IOService * provider ) APPLE_KEXT_OVERRIDE;
1c79356b A	245
	246	virtual void processTopLevel( IORegistryEntry * root );
	247	virtual const char * deleteList( void ) = 0;
	248	virtual const char * excludeList( void ) = 0;
	249	virtual IOService * createNub( IORegistryEntry * from );
	250	virtual bool createNubs( IOService * parent, OSIterator * iter );
	251
	252	virtual bool compareNubName( const IOService * nub, OSString * name,
3e170ce0	253	OSString ** matched = 0 ) const APPLE_KEXT_OVERRIDE;
1c79356b	254
3e170ce0	255	virtual IOReturn getNubResources( IOService * nub ) APPLE_KEXT_OVERRIDE;
1c79356b	256
3e170ce0 A	257	virtual bool getModelName( char * name, int maxLength ) APPLE_KEXT_OVERRIDE;
3e170ce0 A	258	virtual bool getMachineName( char * name, int maxLength ) APPLE_KEXT_OVERRIDE;
1c79356b	259
3e170ce0	260	virtual void registerNVRAMController( IONVRAMController * nvram ) APPLE_KEXT_OVERRIDE;
1c79356b	261
3e170ce0	262	virtual int haltRestart(unsigned int type) APPLE_KEXT_OVERRIDE;
1c79356b A	263
	264	/* virtual / IOReturn readXPRAM(IOByteCount offset, UInt8 buffer,
	265	IOByteCount length);
d52fe63f	266
1c79356b A	267	/* virtual / IOReturn writeXPRAM(IOByteCount offset, UInt8 buffer,
	268	IOByteCount length);
	269
	270	virtual IOReturn readNVRAMProperty(
	271	IORegistryEntry * entry,
	272	const OSSymbol name, OSData value );
	273
	274	virtual IOReturn writeNVRAMProperty(
	275	IORegistryEntry * entry,
	276	const OSSymbol * name, OSData * value );
	277
d52fe63f A	278	// This returns a dictionary describing all the NVRAM partitions.
	279	// The keys will be the partitionIDs of the form "0x52,nvram".
	280	// The values will be OSNumbers of the partition's byte count.
	281	/* virtual / OSDictionary getNVRAMPartitions(void);
	282
	283	/* virtual / IOReturn readNVRAMPartition(const OSSymbol partitionID,
	284	IOByteCount offset, UInt8 * buffer,
	285	IOByteCount length);
	286
	287	/* virtual / IOReturn writeNVRAMPartition(const OSSymbol partitionID,
	288	IOByteCount offset, UInt8 * buffer,
	289	IOByteCount length);
1c79356b	290
3e170ce0 A	291	virtual IOByteCount savePanicInfo(UInt8 *buffer, IOByteCount length) APPLE_KEXT_OVERRIDE;
3e170ce0 A	292	virtual OSString* createSystemSerialNumberString(OSData* myProperty) APPLE_KEXT_OVERRIDE;
9bccf70c	293
1c79356b A	294	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 0);
	295	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 1);
	296	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 2);
	297	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 3);
	298	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 4);
	299	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 5);
	300	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 6);
	301	OSMetaClassDeclareReservedUnused(IODTPlatformExpert, 7);
	302	};
	303
	304	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
	305
	306	/* generic root nub of service tree */
	307
	308	class IOPlatformExpertDevice : public IOService
	309	{
	310	OSDeclareDefaultStructors(IOPlatformExpertDevice)
	311
	312	private:
	313	IOWorkLoop *workLoop;
	314
	315	struct ExpansionData { };
	316	ExpansionData *reserved;
	317
	318	public:
	319	virtual bool initWithArgs( void * p1, void * p2,
	320	void * p3, void *p4 );
3e170ce0 A	321	virtual bool compareName( OSString * name, OSString ** matched = 0 ) const APPLE_KEXT_OVERRIDE;
	322
	323	virtual IOWorkLoop *getWorkLoop() const APPLE_KEXT_OVERRIDE;
	324	virtual IOReturn setProperties( OSObject * properties ) APPLE_KEXT_OVERRIDE;
	325
	326	virtual void free() APPLE_KEXT_OVERRIDE;
1c79356b	327
3e170ce0 A	328	virtual IOReturn newUserClient( task_t owningTask, void * securityID,
	329	UInt32 type, OSDictionary * properties,
	330	IOUserClient ** handler) APPLE_KEXT_OVERRIDE;
1c79356b	331
1c79356b A	332
	333	OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice, 0);
	334	OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice, 1);
	335	OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice, 2);
	336	OSMetaClassDeclareReservedUnused(IOPlatformExpertDevice, 3);
	337	};
	338
	339	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
	340
	341	/* generic nub for motherboard devices */
	342
	343	class IOPlatformDevice : public IOService
	344	{
	345	OSDeclareDefaultStructors(IOPlatformDevice)
	346
	347	struct ExpansionData { };
	348	ExpansionData *reserved;
	349
	350	public:
3e170ce0 A	351	virtual bool compareName( OSString * name, OSString ** matched = 0 ) const APPLE_KEXT_OVERRIDE;
	352	virtual IOService * matchLocation( IOService * client ) APPLE_KEXT_OVERRIDE;
	353	virtual IOReturn getResources( void ) APPLE_KEXT_OVERRIDE;
1c79356b A	354
	355	OSMetaClassDeclareReservedUnused(IOPlatformDevice, 0);
	356	OSMetaClassDeclareReservedUnused(IOPlatformDevice, 1);
	357	OSMetaClassDeclareReservedUnused(IOPlatformDevice, 2);
	358	OSMetaClassDeclareReservedUnused(IOPlatformDevice, 3);
	359	};
	360
	361	#endif /* __cplusplus */
	362
	363	#endif /* ! _IOKIT_IOPLATFORMEXPERT_H */