IOPSKeys.h   [plain text]


/*
 * Copyright (c) 2002 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
 * 
 * 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. 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_LICENSE_HEADER_END@
 */

/*
 *** UPS Power Management claimed ***
 * If a third-party app manages UPS power it should set this key in the SCDynamicStore.
 * Set it with a value of kCFBooleanTrue.
 * If this key is not set, OS X will provide a minimal default UPS Power Management
 * implementation that includes clean shutdown if the attached UPS falls below 20%
 * remaining battery power.
 * It should be used with the State: prefix, as in "State:/IOKit/UPSPowerManagementClaimed"
 */
#define kIOPSUPSManagementClaimed       "/IOKit/UPSPowerManagementClaimed"


/*
 * UPS settings keys
 * These define the power level (units are %) to take action like warning the user
 * or shutting down.
 */
#define kIOPSLowWarnLevelKey           "Low Warn Level"
#define kIOPSDeadWarnLevelKey          "Shutdown Level"


/*
 *** SCDynamicStore keys ***
 * kIOPSDynamicStorePath should be used with the "State:" prefix, as in "State:/IOKit/PowerSources"
 */
#define kIOPSDynamicStorePath          "/IOKit/PowerSources"


/*
 * Power Source data keys
 * These keys specify the values in a dictionary of PowerSource details.
 * Use these keys in conjunction with the dictionary returned by 
 * IOPSGetPowerSourceDescription()
 */ 
// Type CFString, value is kIOPSACPowerValue or kIOPSBatteryPowerValue
#define kIOPSPowerSourceStateKey       "Power Source State"

// Type CFNumber (signed integer), units are %
#define kIOPSCurrentCapacityKey        "Current Capacity"

// Type CFNumber (signed integer), units are %
#define kIOPSMaxCapacityKey            "Max Capacity"

// Type CFNumber (signed integer), units are minutes
// Only valid if the value of kIOPSIsChargingKey is false.
// -1 indicates "Still Calulating"
#define kIOPSTimeToEmptyKey            "Time to Empty"

// Type CFNumber (signed integer), units are minutes. 
// Only valid if the value of kIOPSIsChargingKey is true.
// -1 indicates "Still Calulating"
#define kIOPSTimeToFullChargeKey       "Time to Full Charge"

// Type CFBoolean - kCFBooleanTrue or kCFBooleanFalse
#define kIOPSIsChargingKey             "Is Charging"

// Type CFBoolean - kCFBooleanTrue or kCFBooleanFalse
#define kIOPSIsPresentKey              "Is Present"

// Type CFNumber (signed integer) - units are mV
#define kIOPSVoltageKey                "Voltage"

// Type CFNumber (signed integer) - units are mA
#define kIOPSCurrentKey                "Current"

// Type CFStringRef
#define kIOPSNameKey                   "Name"

// Type CFStringRef - value is one of the transport types below
#define kIOPSTransportTypeKey          "Transport Type"


/*
 * Transport types
 */
#define kIOPSSerialTransportType       "Serial"
#define kIOPSUSBTransportType          "USB"
#define kIOPSNetworkTransportType      "Ethernet"
#define kIOPSInternalType              "Internal"

/*
 * PS state 
 */
#define kIOPSOffLineValue              "Off Line"
#define kIOPSACPowerValue              "AC Power"
#define kIOPSBatteryPowerValue         "Battery Power"