123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162 |
- /*************************************************************************/ /*!
- @File
- @Title Services definitions required by external drivers
- @Copyright Copyright (c) Imagination Technologies Ltd. All Rights Reserved
- @Description Provides services data structures, defines and prototypes
- required by external drivers
- @License Dual MIT/GPLv2
- The contents of this file are subject to the MIT license as set out below.
- Permission is hereby granted, free of charge, to any person obtaining a copy
- of this software and associated documentation files (the "Software"), to deal
- in the Software without restriction, including without limitation the rights
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- copies of the Software, and to permit persons to whom the Software is
- furnished to do so, subject to the following conditions:
- The above copyright notice and this permission notice shall be included in
- all copies or substantial portions of the Software.
- Alternatively, the contents of this file may be used under the terms of
- the GNU General Public License Version 2 ("GPL") in which case the provisions
- of GPL are applicable instead of those above.
- If you wish to allow use of your version of this file only under the terms of
- GPL, and not to allow others to use your version of this file under the terms
- of the MIT license, indicate your decision by deleting the provisions above
- and replace them with the notice and other provisions required by GPL as set
- out in the file called "GPL-COPYING" included in this distribution. If you do
- not delete the provisions above, a recipient may use your version of this file
- under the terms of either the MIT license or GPL.
- This License is also included in this distribution in the file called
- "MIT-COPYING".
- EXCEPT AS OTHERWISE STATED IN A NEGOTIATED AGREEMENT: (A) THE SOFTWARE IS
- PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
- BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
- PURPOSE AND NONINFRINGEMENT; AND (B) IN NO EVENT SHALL THE AUTHORS OR
- COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
- IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
- CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- */ /**************************************************************************/
- #if !defined(SERVICESEXT_H)
- #define SERVICESEXT_H
- /* include/ */
- #include "pvrsrv_error.h"
- #include "img_types.h"
- #include "img_3dtypes.h"
- #include "pvrsrv_device_types.h"
- /*
- * Lock buffer read/write flags
- */
- #define PVRSRV_LOCKFLG_READONLY (1) /*!< The locking process will only read the locked surface */
- /*!
- *****************************************************************************
- * Services State
- *****************************************************************************/
- typedef enum _PVRSRV_SERVICES_STATE_
- {
- PVRSRV_SERVICES_STATE_UNDEFINED = 0,
- PVRSRV_SERVICES_STATE_OK,
- PVRSRV_SERVICES_STATE_BAD,
- } PVRSRV_SERVICES_STATE;
- /*!
- *****************************************************************************
- * States for power management
- *****************************************************************************/
- /*!
- System Power State Enum
- */
- typedef enum _PVRSRV_SYS_POWER_STATE_
- {
- PVRSRV_SYS_POWER_STATE_Unspecified = -1, /*!< Unspecified : Uninitialised */
- PVRSRV_SYS_POWER_STATE_OFF = 0, /*!< Off */
- PVRSRV_SYS_POWER_STATE_ON = 1, /*!< On */
- PVRSRV_SYS_POWER_STATE_FORCE_I32 = 0x7fffffff /*!< Force enum to be at least 32-bits wide */
- } PVRSRV_SYS_POWER_STATE, *PPVRSRV_SYS_POWER_STATE; /*!< Typedef for ptr to PVRSRV_SYS_POWER_STATE */
- /*!
- Device Power State Enum
- */
- typedef enum _PVRSRV_DEV_POWER_STATE_
- {
- PVRSRV_DEV_POWER_STATE_DEFAULT = -1, /*!< Default state for the device */
- PVRSRV_DEV_POWER_STATE_OFF = 0, /*!< Unpowered */
- PVRSRV_DEV_POWER_STATE_ON = 1, /*!< Running */
- PVRSRV_DEV_POWER_STATE_FORCE_I32 = 0x7fffffff /*!< Force enum to be at least 32-bits wide */
- } PVRSRV_DEV_POWER_STATE, *PPVRSRV_DEV_POWER_STATE; /*!< Typedef for ptr to PVRSRV_DEV_POWER_STATE */ /* PRQA S 3205 */
- /*!
- Power Flags Enum
- */
- typedef enum _PVRSRV_POWER_FLAGS_
- {
- PVRSRV_POWER_FLAGS_NONE = 0, /*!< No flags */
- PVRSRV_POWER_FLAGS_FORCED = 1 << 0, /*!< Power the transition should not fail */
- PVRSRV_POWER_FLAGS_SUSPEND = 1 << 1, /*!< Power transition is due to OS suspend request */
- } PVRSRV_POWER_FLAGS;
- /* Clock speed handler prototypes */
- /*!
- Typedef for a pointer to a Function that will be called before a transition
- from one clock speed to another. See also PFN_POST_CLOCKSPEED_CHANGE.
- */
- typedef PVRSRV_ERROR (*PFN_PRE_CLOCKSPEED_CHANGE) (IMG_HANDLE hDevHandle,
- PVRSRV_DEV_POWER_STATE eCurrentPowerState);
- /*!
- Typedef for a pointer to a Function that will be called after a transition
- from one clock speed to another. See also PFN_PRE_CLOCKSPEED_CHANGE.
- */
- typedef PVRSRV_ERROR (*PFN_POST_CLOCKSPEED_CHANGE) (IMG_HANDLE hDevHandle,
- PVRSRV_DEV_POWER_STATE eCurrentPowerState);
- /*!
- Typedef for a pointer to a function that will be called to transition the
- device to a forced idle state. Used in unison with (forced) power requests,
- DVFS and cluster count changes.
- */
- typedef PVRSRV_ERROR (*PFN_FORCED_IDLE_REQUEST) (IMG_HANDLE hDevHandle,
- IMG_BOOL bDeviceOffPermitted);
- /*!
- Typedef for a pointer to a function that will be called to cancel a forced
- idle state and return the firmware back to a state where the hardware can be
- scheduled.
- */
- typedef PVRSRV_ERROR (*PFN_FORCED_IDLE_CANCEL_REQUEST) (IMG_HANDLE hDevHandle);
- typedef PVRSRV_ERROR (*PFN_GPU_UNITS_POWER_CHANGE) (IMG_HANDLE hDevHandle,
- IMG_UINT32 ui32SESPowerState);
- /*!
- *****************************************************************************
- * This structure is used for OS independent registry (profile) access
- *****************************************************************************/
- typedef struct PVRSRV_REGISTRY_INFO_TAG
- {
- IMG_UINT32 ui32DevCookie;
- IMG_PCHAR pszKey;
- IMG_PCHAR pszValue;
- IMG_PCHAR pszBuf;
- IMG_UINT32 ui32BufSize;
- } PVRSRV_REGISTRY_INFO, *PPVRSRV_REGISTRY_INFO;
- #endif /* SERVICESEXT_H */
- /******************************************************************************
- End of file (servicesext.h)
- ******************************************************************************/
|