camerauis/cameraxui/cxengine/tsrc/unit/unittest_cxememorymonitor/hal_data.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Thu, 02 Sep 2010 20:14:28 +0300
changeset 56 01e205c615b9
parent 48 42ba2d16bf40
permissions -rw-r--r--
Revision: 201033 Kit: 201035

// Copyright (c) 1995-2010 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// hal\inc\hal_data.h
// This is a test version of the header, for testing purposes only
//


#ifndef __HAL_DATA_H__
#define __HAL_DATA_H__
#define bitmask enum

class HALData
/**
@publishedPartner
@released

Sets of attributes and values used by HAL functions.
*/
	{
public:
    /**
    A set of enumerators that identifies hardware attributes.
    The enumerators are passed to HAL::Get() and HAL::Set().
    
    They are also used by the HAL accessor functions.
    
    Note: It is not recommended to use HAL attributes to pass handles from the  
	kernel to user-side clients due to resource overhead's that will affect 
	existing clients of HAL. HAL is designed to allow simply hardware parameters
	to be shared with user-side clients without resource allocation overheads.
    
    @see HAL::Get()
    @see HAL::Set()
    */
	enum TAttribute
		{
		/**
		Identifies the manufacturer of a device.
        If this is not enumerated in TManufacturer, then the manufacturer must
        obtain a value from the Symbian registry.
        
        @see HALData::TManufacturer
		*/
		EManufacturer,
		
		
		/**
		The device specific hardware version number, as defined by
		the device manufacturer.
		*/
		EManufacturerHardwareRev,
		
		
		/**
		The device specific version number, as defined by
		the device manufacturer.
		*/
		EManufacturerSoftwareRev,
		
		
		/**
		The device specific software version number, as defined by
		the device manufacturer.
		*/
		EManufacturerSoftwareBuild,

		
		/**
		The device specific model number, as defined by
		the device manufacturer.
		*/
		EModel,
		
				
		/**
		This is the device specific UID, It is unique to the class /model
		of device. A value must be obtained from Symbian's UID registry for
		this attribute.
		*/
		EMachineUid,
		
		
		/**
		The Symbian OS specified device family identifier.
		If the device family is not one of those enumerated by TDeviceFamily,
		then the licensee must obtain a UID from Symbian for this attribute.
		
		@see HALData::TDeviceFamily
		*/
		EDeviceFamily,

		
		/**
		The Symbian OS specified device family version.
		*/
		EDeviceFamilyRev,

		
		/**
		The CPU architecture used by this device. The values are enumerated
		by TCPU.
		
		@see HALData::TCPU
		*/
		ECPU,
		
		
		/**
		A revision number for the CPU architecture.
		*/
		ECPUArch,

		
		/**
		This is the default ABI used by CPU for user applications.
		The values are enumerated by HALData::TCPUABI.
		*/
		ECPUABI,

		
		/**
		The processor speed in KHz.
		*/
		ECPUSpeed,

		
		/**
		The reason for most recent system boot.
        This is dynamic and readonly; the values are enumerated by
        TSystemStartupReason.

		@see HALData::TSystemStartupReason
		*/
		ESystemStartupReason,

		
		/**
		This is the last exception code, in the case of system reboot.
		This is dynamic and readonly.
		*/
		ESystemException,
		
		
		/**
		The time between system ticks, in microseconds.
		*/
		ESystemTickPeriod,
		
		
		/** 
		The total system RAM, in bytes.
		*/
		EMemoryRAM,
		
		
		/**
		The currently free system RAM.
		
		This is dynamic and readonly.
		*/
		EMemoryRAMFree,

		
		/**
		The total System ROM, in bytes.
		*/
		EMemoryROM,
	
		
		/**
		The MMU page size in bytes.
		*/
		EMemoryPageSize,
	
		
		/**
		Indicates the state of the power supply.
        
        It has the values:
        1 = Power is good (i.e. external power is available,
        or the 'power' battery is >= low);
        0 = otherwise.
        
        This is dynamic and readonly.
		*/
		EPowerGood,
	
		
		/**
        The System (or 'Main') battery power level.
        The allowable values are enumerated by TPowerBatteryStatus

		This is dynamic and readonly,
		
		@see HALData::TPowerBatteryStatus
		*/
		EPowerBatteryStatus,
	
		
		/**
		Indicates whether a backup power supply is available.
        It has the values:
        0 = the device does not support (or need) a backup battery source;
        1 = a backup batter source is present.
		This is dynamic and readonly
		*/
		EPowerBackup,
	
		
		/**
        The power level for backup power.
        
        It has the values enumerated by TPowerBackupStatus.

		This is dynamic and readonly.
		
		@see HALData::TPowerBackupStatus
		*/
		EPowerBackupStatus,
	
		
		/**
		Indicates the state of the external power.

		It has the values:
		0 = external power is not in use;
		1 = external power is in use.
		        
        This is dynamic and readonly.
		*/
		EPowerExternal,
	
		
		/**
		A bitmask that describes the available keyboard types (it may support
		more than one).

        @see HALData::TKeyboard
		*/
		EKeyboard,
	
		
		/**
		*/
		EKeyboardDeviceKeys,
	
		
		/**
		*/
		EKeyboardAppKeys,
	
		
		/**
		Indicates whether the device can produce a click sound for
		each keypress.
		
		It has the values:
		0 = the device cannot produce a click sound for each keypress;
		1 = the device can produce a click sound.
		*/
		EKeyboardClick,
	
		
		/**
		The state of keyboard clicking.

        It has the values:
        0 = key click disabled;
        1 = key click enabled.
        
		This is dynamic and writeable.

		@capability WriteDeviceData needed to Set this attribute
		*/
		EKeyboardClickState,
	
		
		/**
		The keyboard click volume level.

		It can take a value in the range 0 to EKeyboardClickVolumeMax.
        
        This is dynamic and writeable.
        
        @see HALData::EKeyboardClickVolumeMax

		@capability WriteDeviceData needed to Set this attribute
		*/
		EKeyboardClickVolume,
	
		
		/**
		The maximum value for EKeyboardClickVolume.
		
		@see HALData::EKeyboardClickVolume
		*/
		EKeyboardClickVolumeMax,
	
		
		/**
		The screen horizontal dimension in pixels.
		*/
		EDisplayXPixels,
	
		
		/**
		The screen vertical dimension in pixels.
		*/
		EDisplayYPixels,
	
		
		/**
		The screen horizontal dimension in twips.
		*/
		EDisplayXTwips,
	
		
		/**
		The screen vertical dimension in twips.
		*/
		EDisplayYTwips,
	
		
		/**
		The number of hues (colors or shades of grey) displayable on
		the screen.
		*/
		EDisplayColors,
	
		
		/**
		The state of the display.
		
		It has the values:
		0 = screen is turned off;
		1 = screen is on.
		
		This is dynamic and writeable.

		@capability PowerMgmt needed to Set this attribute
		*/
		EDisplayState,
	
		
		/**
		The screen contrast level.
   		It can take a value in the range 0 to EDisplayContrastMax.
        
        This is dynamic and writeable

		@see HALData::EDisplayContrastMax

		@capability WriteDeviceData needed to Set this attribute
		*/
		EDisplayContrast,
	
		
		/**
		The maximum value for EDisplayContrast
		
		@see HALData::EDisplayContrast
		*/
		EDisplayContrastMax,
		
		
		/**
		Indicates whether there is a backlight on the device.

		It has the values:
		0 = there is no screen backlight;
		1 = a screen backlight is present.
		*/
		EBacklight,
			
		
		/**
		The current status of the backlight.

		It has the values:
		0 = off;
		1 = on.
        
        This is dynamic and writeable.

		@capability WriteDeviceData needed to Set this attribute
		*/
		EBacklightState,
			
		
		/**
		Indicates whether a pen or digitizer is available for input.

		It has the values:
		0 = a pen/digitizer is not available for input;
		1 = a pen/digitizeris present.
		*/
		EPen,
			
		
		/**
		The pen/digitizer horizontal resolution, in pixels.
		*/
		EPenX,
			
		
		/**
		The pen/digitizer vertical resolution, in pixels.
		*/
		EPenY,
			
		
		/**
		Indicates whether a pen tap will turn the display on.

        It has the values:
        0 = a pen tap has no effect;
        1 = a pent tap or press enables the display.
        
        This is dynamic and writeable.

		@capability WriteDeviceData needed to Set this attribute
		*/
		EPenDisplayOn,
			
		
		/**
		Indicates whether the device can produce a click sound for
		each pen tap.

		It has the values:
        0 = the device cannot produce a click sound
        1 = production of a click sound is supported by the device.
		*/
		EPenClick,
			
		
		/**
		The state of pen clicking.
		
		It has the values:
		0 = pen clicking is disabled;
		1 = pen clicking is enabled.
		
        This is dynamic and writable.

		@capability WriteDeviceData needed to Set this attribute
		*/
		EPenClickState,
			
		
		/**
		The pen click volume level.
        It can take a value in the range 0 to EPenClickVolumeMax.
        
        This value is dynamic and writable.
        
        @see HALData::EPenClickVolumeMax

		@capability WriteDeviceData needed to Set this attribute
		*/
		EPenClickVolume,
			
		
		/**
		The maximum value for EPenClickVolume.
		
		@see HALData::EPenClickVolume
		*/
		EPenClickVolumeMax,
			
		
		/**
		Indicates whether a mouse is available for input.
		
		It has the values:
		0 = there is no mouse available pen/digitizer is present;
		1 = a mouse is available for input.
		*/
		EMouse,
			
		
		/**
		The mouse horizontal resolution, in pixels.
		*/
		EMouseX,
			
		
		/**
		The mouse vertical resolution, in pixels.
		*/
		EMouseY,
			
		
		/**
		Describes the mouse cursor visibility.

        The value is enumerated by TMouseState.
        
		This is dynamic and writable.
		@see HALData::TMouseState
		
		@capability MultimediaDD needed to Set this attribute
		*/
		EMouseState,
			
		
		/**
        Reserved for future use.
		@capability MultimediaDD needed to Set this attribute
		*/
		EMouseSpeed,
		
		
		/**
		Reserved for future use.
		@capability MultimediaDD needed to Set this attribute
		*/
		EMouseAcceleration,
		
		
		/**
		The number of buttons on the mouse.
		*/
		EMouseButtons,
		
		
		/**
        A bitmask defining the state of each button.

        For each bit, it has values:
        0 = up;
        1 = down.
        
		This is dynamic and read only.
		*/
		EMouseButtonState,
		
		
		/**
		Defines the state of the case.
		
        It has the values:
        0 = case closed;
        1 = case opened.
        
        This is dynamic and read only.
		*/
		ECaseState,
		
		
		/**
		Indicates whether the device has a case switch, that actions when
		the case opens and closes.
		
        It has values:
        0 = no;
        1 = yes.
		*/
		ECaseSwitch,
		
		
		/**
		Indicates whether the device is to switch on when case opens.
		
		It has the values:
		0 = disable device switchon when the case opens;
		1 = enable device  switchon when the case opens.
        
        This is dynamic and writeable.

		@capability WriteDeviceData needed to Set this attribute
		*/
		ECaseSwitchDisplayOn,
		
		
		/**
        Indicates whether the device is to switch off when case close.

		It has the values:
		0 = disable device switchoff when the case closes;
		1 = enable device switchoff when the case closes.
        
        This is dynamic and writeable.

		@capability WriteDeviceData needed to Set this attribute
		*/
		ECaseSwitchDisplayOff,
		
		
		/**
		The number of LEDs on the device.
		*/
		ELEDs,
		
		
		/**
        A bitmask defining the state of each LED.

        For each bit, it has values:
        0 = off;
        1 = on.
		
		This is dynamic and writeable.
		*/
		ELEDmask,
		
		
		/**
		Indicates how the phone hardware is connected.
		
		It has the values:
		0 = phone hardware is not permanently connected;
		1 = phone hardware is permanently connected.
		*/
		EIntegratedPhone,
		
		
		/**
		@capability WriteDeviceData needed to Set this attribute
		*/
		EDisplayBrightness,
	
		
		/**
		*/
		EDisplayBrightnessMax,
	
		
		/**
		Indicates the state of the keyboard backlight.
        
        It has the values:
        0 = keyboard backlight is off;
        1 = keyboard backlight is on.

		This is dynamic and writeable.

		@capability PowerMgmt needed to Set this attribute
		*/
		EKeyboardBacklightState,
	
		
		/**
		Power supply to an accessory port.

        It has the values:
        0 = turn off power to an accessory port on the device;
        1 = turn on power.
        
        This is dynamic and writeable.

		@capability PowerMgmt needed to Set this attribute
		*/
		EAccessoryPower,
	
		
		/**
		A 2 decimal digit language index. 
		
		It is used as the two digit language number that is the suffix of
		language resource DLLs, e.g ELOCL.01.

		The locale with this language index is loaded the next time that
		the device boots.

        This is dynamic and writeable.

		@see TLanguage

		@capability WriteDeviceData needed to Set this attribute
		*/
		ELanguageIndex,
	
		
		/**
		A 2 decimal digit (decimal) language keyboard index.
		It is used as the two digit language number that is the suffix of
		language resource DLLs, e.g. EKDATA.01.
		
		@see TLanguage

		@capability WriteDeviceData needed to Set this attribute
		*/
		EKeyboardIndex,
	
		
		/**
		The maximum allowable size of RAM drive, in bytes.
		*/
		EMaxRAMDriveSize,
	
		
		/**
		Indicates the state of the keyboard.
		
		It has the values:
		0 = keyboard is disabled;
		1 = Keyboard is enabled.
        
        This is dynamic and writeable.

		@capability PowerMgmt needed to Set this attribute
		*/
		EKeyboardState,
	
		/**
  		Defines the system drive & custom resource drive. 
        Legacy attribute which is no longer supported.
  
  		@deprecated Attribute is no longer the primary mechanism to define the 
  		System Drive or the Custom Resource Drive.
        @see RFs::GetSystemDrive.
        @see BaflUtils::NearestLanguageFile
        @see HALData::ECustomResourceDrive
  		*/
		ESystemDrive,	
		
		/**
		Indicates the state of the pen or digitiser.

		It has the values:
		1 = pen/digitiser is enabled;
		0 = pen/digitiser is disabled.
		
        This is dynamic and writeable.

		@capability PowerMgmt needed to Set this attribute
		*/
		EPenState,
	
		
		/**
		On input: aInOut contains the mode number.
        On output: aInOut contains: 0 = display is colour;
                                    1 = display is black & white.
        
        aInOut is the 3rd parameter passed to accessor functions
        for derived attributes.
		*/
		EDisplayIsMono,
	
		
		/**
		On input: aInOut contains the mode number;
        On output, aInOut contains: 0 = display is not palettised;
                                    1 = display is palettised.
        
        aInOut is the 3rd parameter passed to accessor functions
        for derived attributes.
  		*/
		EDisplayIsPalettized,
	
		
		/**
		The display bits per pixel.
		
        On input, aInOut contains the mode number.
        On output, aInOut contains the bits per pixel for that mode.

        aInOut is the 3rd parameter passed to accessor functions
        for derived attributes.
        
        It is read only data.
		*/
		EDisplayBitsPerPixel,
	
		
		/**
		The number of display modes available.
		*/
		EDisplayNumModes,
	
		
		/**
		The address of the display memory.
		*/
		EDisplayMemoryAddress,
	
		
		/**
		The offset, in bytes, to the pixel area of the screen from the start of screen memory.
		
		This is used to account for the fact that the palette is sometimes at
		the beginning of the display memory.
		
        On input, aInOut contains the mode number.
        On output, aInOut contains the offset to the first pixel for that mode.

        aInOut is the 3rd parameter passed to accessor functions
        for derived attributes.
		*/
		EDisplayOffsetToFirstPixel,
	
		
		/**
		The separation, in bytes, of successive lines of display in memory.
        
        On input, aInOut contains the mode number.
        On output, aInOut contains the display offset between lines.

        aInOut is the 3rd parameter passed to accessor functions
        for derived attributes.
		*/
		EDisplayOffsetBetweenLines,
	
		
		/**
		@capability MultimediaDD needed to Set this attribute
		*/
		EDisplayPaletteEntry,
	
		
		/**
		It has the values:
		1 = order of pixels in display is RGB;
		0 = otherwise.
		*/
		EDisplayIsPixelOrderRGB,
	
		
		/**
		It has the values:
		1 = pixel order is landscape;
		0 = pixel order is portrait.
		*/
		EDisplayIsPixelOrderLandscape,
	
		
		/**
		This indicates or sets the current display mode where
		EDisplayNumModes-1 is the maximum value for the display mode.
		The properties of a particular display mode are entirely defined by
		the base port software associated with the hardware upon which the OS
		is running.

		@capability MultimediaDD needed to Set this attribute
		*/
		EDisplayMode,
	
		
		/**
		If the target hardware upon which Symbian OS is running has switches
		which can be read by the base port software, this interface allows
		the current status of those switches to be read. 
		*/
		ESwitches,
	
		
		/**
		The port number of the debug port.
		*/
		EDebugPort,
	
		
		/**
		The language code of the Locale which was loaded at device boot time.

        This is dynamic and writeable.

		@see ELanguageIndex

		@capability WriteSystemData needed to Set this attribute
		*/
		ELocaleLoaded,
	
		
		/**
		The drive number to use for storage of Clipboard data.
		0 = Drive A, 1 = Drive B, etc...
		*/
		EClipboardDrive,
	
		/**
		Custom restart
		@capability PowerMgmt
		*/
		ECustomRestart,

		/**
		Custom restart reason
		*/
		ECustomRestartReason,

		/**
		The number of screens.
		*/
		EDisplayNumberOfScreens,

		/**
		The time between nanokernel ticks, in microseconds.
		*/
		ENanoTickPeriod,

		/**
		The frequency of the fast counter.
		*/
		EFastCounterFrequency,

		/**
		Indicates the whether the fast counter counts up or down.
		*/
		EFastCounterCountsUp,

		/**		
		Indicates whether a 3 dimensional pointing device is available for input and Z coordinate
		is provided in appropriate pointer-related TRawEvents generated by the driver.

		It has the values:
		0 = a 3D pointer is not available for input and Z coordinate is not provided in TRawEvents;
		1 = a 3D pointer is present and Z coordinate is provided in TRawEvents.
		*/
		EPointer3D,

		/**		
		The furthest detectable 3D pointing device's proximity above the screen.
		As proximity values above the screen are negative, this will be a negative value.

		This is dynamic and writeable.
		*/
		EPointer3DMaxProximity,

		/**		
		Indicates whether a 3 dimensional pointing device supports Theta polar angle reading.

		It has the values:
		0 = a 3D pointer does not support Theta polar angle reading;
		1 = a 3D pointer supports Theta polar angle reading.
		*/
		EPointer3DThetaSupported,

		/**
		Indicates whether a 3 dimensional pointing device supports Phi polar angle reading.

		It has the values:
		0 = a 3D pointer does not support Phi polar angle reading;
		1 = a 3D pointer supports Phi polar angle reading.
		*/
		EPointer3DPhiSupported,

		/**
		Indicates whether a 3 dimensional pointing device supports rotation angle along its main axis reading.

		It has the values:
		0 = a 3D pointer does not support alpha (rotation) reading;
		1 = a 3D pointer supports alpha (rotation) reading.
		*/
		EPointer3DRotationSupported,

		/**
		Indicates whether a 3 dimensional pointing device supports readings of pressure applied on screen.

		It has the values:
		0 = a 3D pointer does not support pressure reading;
		1 = a 3D pointer supports pressure reading.
		*/
		EPointer3DPressureSupported,

		/**
		Indicates whether hardware floating point is available, and what type.
		
		If no hardware floating point is available, reading this attribute will return KErrNotSupported.
		If hardware floating point is available, reading this attribute will return KErrNone and the type
		available. These types are specified in TFloatingPointType.
		*/
		EHardwareFloatingPoint,

		/**
		The offset between secure and nonsecure clocks. If this attribute is undefined no secure clock
		will be available.
		*/
		ETimeNonSecureOffset,

		/**
		Persist startup mode.

		If no variant specific implementation exists, the startup mode will be stored in platform
		specific values.hda file.
		*/
		EPersistStartupModeKernel,

		/**
		Maximum restart reasons.

		Returns the maximum number of values that can be used to store the restart reason required for a custom restart.
		*/
		EMaximumCustomRestartReasons,

		/**
		Maximum startup modes.
		
		Returns the maximum number of values that can be used to store the startup mode requires for a system restart.
		*/
		EMaximumRestartStartupModes,
		
		/**
		Defines the custom resource drive.
		
		This drive attribute should be set if an additional drive is required for use in the search 
		algorithm for language files.  
        
        @see TDriveNumber
		@see BaflUtils::NearestLanguageFile for how this attribute is used
		@capability WriteDeviceData needed to Set this attribute
		*/
		ECustomResourceDrive,

		/**
		Step size of Z distance data.

		Returns the minimum size of the step between two resolvable z positions
		*/
		EPointer3DProximityStep,

		/**
		Maximum Number of Pointers supported by hardware/driver

		Returns the maximum number of pointers for a touch configuration (or KErrNotSupported or 0)
		*/
		EPointerMaxPointers,

		/**
		Maximum Number of Pointers
		
		Sets and reads back the number of pointers as requested by the UI (<=EPointerMaxPointers)
		*/
		EPointerNumberOfPointers,

		/**
		Maximum Pressure Value

		Returns the maximum pressure value
		*/
		EPointer3DMaxPressure,

		/**
		Step size of pressure data.

		Returns the minimum size of the step between two resolvable pressure readings			
		*/
		EPointer3DPressureStep,

		/**
		The threshold on pointer's Z coordinate above which EEnterHighPressure pointer event is sent to WSERV's clients.
		This value is intended to be preconfigured in build time and modified by Window Server only

		@prototype 9.5
		*/
		EPointer3DEnterHighPressureThreshold,
	
		/**
		The threshold on pointer's Z coordinate below which EExitHighPressure pointer event is sent to WSERV's clients.
		This value is intended to be preconfigured in build time and modified by Window Server only

		@prototype 9.5
		*/
		EPointer3DExitHighPressureThreshold,

		/**
		The threshold on pointer's Z coordinate above which EEnterCloseProximity pointer event is sent to WSERV's clients.
		This value is intended to be preconfigured in build time and modified by Window Server only

		@prototype 9.5
		*/
		EPointer3DEnterCloseProximityThreshold,

		
		/**
		The threshold on pointer's Z coordinate below which EExitCloseProximity pointer event is sent to WSERV's clients.
		This value is intended to be preconfigured in build time and modified by Window Server only

		@prototype 9.5
		*/
		EPointer3DExitCloseProximityThreshold,
		
		/**
		A Handle to the display memory.
		This attribute opens a chunk, the client is responsible for closing it.
		Using HAL attribtues to open handles is not recommended and this 
		attribute may be removed in the future. 

		@prototype 9.5
		*/
		EDisplayMemoryHandle,

		/**
		Serial number of this board
		*/
		ESerialNumber,
		
		
		/**
		Interrupt used by sampling profiler - applicable for SMP only. Each CPU_i is interrupted by interrupt number ECpuProfilingInterrupt + i
		*/
		ECpuProfilingDefaultInterruptBase,


		/**
		Number of processors present on the device. Returns 1 on unicore. This number is constant and does not take account of power management
		*/
		ENumCpus,

		/**
		The orientation of the Digitiser. Usually mirrors device orientation.
		
		@see TDigitiserOrientation for allowed values
		@capability WriteDeviceData needed to Set this attribute
		*/
		EDigitiserOrientation,

		/*
		 * NOTE:
		 * When updating this list, please also update hal/rom/hal.hby and hal/tsrc/t_newhal.cpp.
		 */

		/**
		
		The number of HAL attributes per screen.
		
		It is simply defined by its position in the enumeration.
		*/
		ENumHalAttributes		

		};



    /**
    Defines properties for the hardware attributes.
    
    @see HALData::TAttribute
    */
	enum TAttributeProperty
		{
		/**
		When set, means that an attribute is meaningful on this device.
				
		@see HAL::Get()
		@see HAL::Set()
		*/
		EValid=0x1,
		
		
		/**
		When set, means that an attribute is modifiable.
		A call to HAL::Set() for an attribute that does not have this property,
		returns KErrNotSupported.
		
		@see HAL::Get()
		@see HAL::Set()
		*/
		ESettable=0x2,
		};



    /**
    UIDs for a defined set of device manufacturers.
    
    Note that any manufacturer not represented in this list must obtain
    a value from the Symbian registry.
    
    @see HALData::TAttribute
    */
    enum TManufacturer // UID for manufacturer
		{
		EManufacturer_Ericsson=0x00000000,
		EManufacturer_Motorola=0x00000001,
		EManufacturer_Nokia=0x00000002,
		EManufacturer_Panasonic=0x00000003,
		EManufacturer_Psion=0x00000004,
		EManufacturer_Intel=0x00000005,
		EManufacturer_Cogent=0x00000006,
		EManufacturer_Cirrus=0x00000007,
		EManufacturer_Linkup=0x00000008,
		EManufacturer_TexasInstruments=0x00000009,
		// New manufacturers must obtain an official UID to identify themselves
		};



    /**
	Defines the Symbian OS device families.
	
    @see HALData::TAttribute
    */
	enum TDeviceFamily
		{
		EDeviceFamily_Crystal,
		EDeviceFamily_Pearl,
		EDeviceFamily_Quartz,
		};



    /**
    Defines the set of CPU architectures.
    
    @see HALData::TAttribute
    */
	enum TCPU
		{
		ECPU_ARM,
		ECPU_MCORE,
		ECPU_X86,
		};



    /**
    Defines the set of ABIs used by the CPU for user applications.
    
    @see HALData::TAttribute    
    */
	enum TCPUABI
		{
		ECPUABI_ARM4,
		ECPUABI_ARMI,
		ECPUABI_THUMB,
		ECPUABI_MCORE,
		ECPUABI_MSVC,
		ECPUABI_ARM5T,
		ECPUABI_X86,
		};



    /**
    Defines the set of reasons for a system boot.
    
    @see HALData::TAttribute
    */
	enum TSystemStartupReason
		{
		ESystemStartupReason_Cold,
		ESystemStartupReason_Warm,
		ESystemStartupReason_Fault,
		};



    /**
    Defines the set of available keyboard types.

    @see HALData::TAttribute
    */
	bitmask TKeyboard
		{
		EKeyboard_Keypad=0x1,
		EKeyboard_Full=0x2,
		};



    /**
    Defines the mouse cursor visibility.
    
    @see HALData::TAttribute
    */
	enum TMouseState
		{
		EMouseState_Invisible=0,
		EMouseState_Visible=1,
		};



    /**
    Defines a set of UIDs for specific devices, reference boards etc
    
    @see HALData::TAttribute
    */
	enum TMachineUid
		{
		EMachineUid_Series5mx=0x1000118a,
		EMachineUid_Brutus=0x10005f60,
		EMachineUid_Cogent=0x10005f61,
		EMachineUid_Win32Emulator=0x10005f62,
		EMachineUid_WinC=0x10005f63,
		EMachineUid_CL7211_Eval=0x1000604f,
		EMachineUid_LinkUp=0x00000000,
		EMachineUid_Assabet=0x100093f3,
		EMachineUid_Zylonite=0x101f7f27,
		EMachineUid_IQ80310=0x1000a681,
		EMachineUid_Lubbock=0x101f7f26,
		EMachineUid_Integrator=0x1000AAEA,
		EMachineUid_Helen=0x101F3EE3,
		EMachineUid_X86PC=0x100000ad,
		EMachineUid_OmapH2=0x1020601C,
		EMachineUid_OmapH4=0x102734E3,
		EMachineUid_NE1_TB=0x102864F7,
		EMachineUid_EmuBoard=0x1200afed,
		EMachineUid_OmapH6=0x10286564,
		EMachineUid_OmapZoom=0x10286565,
		EMachineUid_STE8500=0x101FF810,
		};



    /**
    Defines power levels for the system (or 'Main') battery.
    
    @see HALData::TAttribute
    */
	enum TPowerBatteryStatus
		{
		EPowerBatteryStatus_Zero,
		EPowerBatteryStatus_Replace,
		EPowerBatteryStatus_Low,
		EPowerBatteryStatus_Good,
		};



    /**
    Defines power levels for the backup power.

    @see HALData::TAttribute
    */
	enum TPowerBackupStatus
		{
		EPowerBackupStatus_Zero,
		EPowerBackupStatus_Replace,
		EPowerBackupStatus_Low,
		EPowerBackupStatus_Good,
		};
	
	
    /**
    Describes the orientation of the screen digitiser, usually mirrors the
    device orientation not necessarily the display rotation as this might be
	limited to upright and left 90 only. The values in degrees measures 
	the anti-clockwise angle from the left edge of the digitiser from the 
	normal default position of the device. 
	
	User-side clients can use attribute to inform the digitiser driver of the
	digitiser orientation. The driver may then use this information to adjust 
	X.Y sampling depending on input pointer type.
	
    @see HALData::TAttribute
    */
	enum TDigitiserOrientation
		{
		EDigitiserOrientation_default,	///< Driver using build-in default
		EDigitiserOrientation_000,		///< Device normal 'make-call' position
		EDigitiserOrientation_090,		///< Device rotated left 90 degrees
		EDigitiserOrientation_180,		///< Device rotated 180 degrees
		EDigitiserOrientation_270		///< Device rotated right 90 degrees
		};
	
	};

#endif