| /*************************************************************************/ /*! |
| @File |
| @Title RGX debug header file |
| @Copyright Copyright (c) Imagination Technologies Ltd. All Rights Reserved |
| @Description Header for the RGX debugging functions |
| @License MIT |
| |
| 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. |
| |
| 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(__RGXDEBUG_H__) |
| #define __RGXDEBUG_H__ |
| |
| #include "pvrsrv_error.h" |
| #include "img_types.h" |
| #include "device.h" |
| #include "pvr_notifier.h" |
| #include "pvrsrv.h" |
| #include "rgxdevice.h" |
| |
| |
| /** |
| * Debug utility macro for printing FW IRQ count and Last sampled IRQ count in |
| * LISR for each RGX FW thread. |
| * Macro takes pointer to PVRSRV_RGXDEV_INFO as input. |
| */ |
| #define RGXDEBUG_PRINT_IRQ_COUNT(psRgxDevInfo) \ |
| do \ |
| { \ |
| IMG_UINT32 ui32TID; \ |
| for (ui32TID = 0; ui32TID < RGXFW_THREAD_NUM; ui32TID++) \ |
| { \ |
| PVR_DPF((DBGPRIV_VERBOSE, \ |
| "RGX FW thread %u: FW IRQ count = %u, Last sampled IRQ count in LISR = %u)", \ |
| ui32TID, \ |
| (psRgxDevInfo)->psRGXFWIfTraceBuf->aui32InterruptCount[ui32TID], \ |
| (psRgxDevInfo)->aui32SampleIRQCount[ui32TID])); \ |
| } \ |
| } while(0) |
| |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXDumpDebugInfo |
| |
| @Description |
| |
| Dump useful debugging info. Dumps lesser information than PVRSRVDebugRequest. |
| Does not dump debugging information for all requester types.(SysDebug, ServerSync info) |
| |
| @Input pfnDumpDebugPrintf - Optional replacement print function |
| @Input pvDumpDebugFile - Optional file identifier to be passed to the |
| 'printf' function if required |
| @Input psDevInfo - RGX device info |
| |
| @Return void |
| |
| ******************************************************************************/ |
| void RGXDumpDebugInfo(DUMPDEBUG_PRINTF_FUNC *pfnDumpDebugPrintf, |
| void *pvDumpDebugFile, |
| PVRSRV_RGXDEV_INFO *psDevInfo); |
| |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXDebugRequestProcess |
| |
| @Description |
| |
| This function will print out the debug for the specificed level of |
| verbosity |
| |
| @Input pfnDumpDebugPrintf - Optional replacement print function |
| @Input pvDumpDebugFile - Optional file identifier to be passed to the |
| 'printf' function if required |
| @Input psDevInfo - RGX device info |
| @Input ui32VerbLevel - Verbosity level |
| |
| @Return void |
| |
| ******************************************************************************/ |
| void RGXDebugRequestProcess(DUMPDEBUG_PRINTF_FUNC *pfnDumpDebugPrintf, |
| void *pvDumpDebugFile, |
| PVRSRV_RGXDEV_INFO *psDevInfo, |
| IMG_UINT32 ui32VerbLevel); |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXDumpRGXRegisters |
| |
| @Description |
| |
| Dumps an extensive list of RGX registers required for debugging |
| |
| @Input pfnDumpDebugPrintf - Optional replacement print function |
| @Input pvDumpDebugFile - Optional file identifier to be passed to the |
| 'printf' function if required |
| @Input psDevInfo - RGX device info |
| |
| @Return PVRSRV_ERROR PVRSRV_OK on success, error code otherwise |
| |
| ******************************************************************************/ |
| PVRSRV_ERROR RGXDumpRGXRegisters(DUMPDEBUG_PRINTF_FUNC *pfnDumpDebugPrintf, |
| void *pvDumpDebugFile, |
| PVRSRV_RGXDEV_INFO *psDevInfo); |
| |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXDumpFirmwareTrace |
| |
| @Description Dumps the decoded version of the firmware trace buffer. |
| |
| Dump useful debugging info |
| |
| @Input pfnDumpDebugPrintf - Optional replacement print function |
| @Input pvDumpDebugFile - Optional file identifier to be passed to the |
| 'printf' function if required |
| @Input psDevInfo - RGX device info |
| |
| @Return void |
| |
| ******************************************************************************/ |
| void RGXDumpFirmwareTrace(DUMPDEBUG_PRINTF_FUNC *pfnDumpDebugPrintf, |
| void *pvDumpDebugFile, |
| PVRSRV_RGXDEV_INFO *psDevInfo); |
| |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXReadWithSP |
| |
| @Description |
| |
| Reads data from a memory location (FW memory map) using the META Slave Port |
| |
| @Input psDevInfo - Pointer to RGX DevInfo to be used while reading |
| @Input ui32FWAddr - 32 bit FW address |
| @Input pui32Value - When the read is successful, value at above FW address |
| is returned at this location |
| |
| @Return PVRSRV_ERROR PVRSRV_OK if read success, error code otherwise. |
| ******************************************************************************/ |
| PVRSRV_ERROR RGXReadWithSP(PVRSRV_RGXDEV_INFO *psDevInfo, IMG_UINT32 ui32FWAddr, IMG_UINT32 *pui32Value); |
| |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXWriteWithSP |
| |
| @Description |
| |
| Writes data to a memory location (FW memory map) using the META Slave Port |
| |
| @Input psDevInfo - Pointer to RGX DevInfo to be used while writing |
| @Input ui32FWAddr - 32 bit FW address |
| |
| @Input ui32Value - 32 bit Value to write |
| |
| @Return PVRSRV_ERROR PVRSRV_OK if write success, error code otherwise. |
| ******************************************************************************/ |
| PVRSRV_ERROR RGXWriteWithSP(PVRSRV_RGXDEV_INFO *psDevInfo, IMG_UINT32 ui32FWAddr, IMG_UINT32 ui32Value); |
| |
| #if defined(SUPPORT_EXTRA_METASP_DEBUG) |
| /*! |
| ******************************************************************************* |
| |
| @Function ValidateFWImageWithSP |
| |
| @Description Compare the Firmware image as seen from the CPU point of view |
| against the same memory area as seen from the META point of view |
| |
| @Input psDevInfo - Device Info |
| |
| @Return PVRSRV_ERROR |
| ******************************************************************************/ |
| PVRSRV_ERROR ValidateFWImageWithSP(PVRSRV_RGXDEV_INFO *psDevInfo); |
| #endif /* defined(SUPPORT_EXTRA_METASP_DEBUG) */ |
| |
| /*! |
| ******************************************************************************* |
| |
| @Function RGXDumpRGXDebugSummary |
| |
| @Description |
| |
| Dump a summary in human readable form with the RGX state |
| |
| @Input pfnDumpDebugPrintf - The debug printf function |
| @Input pvDumpDebugFile - Optional file identifier to be passed to the |
| 'printf' function if required |
| @Input psDevInfo - RGX device info |
| @Input bRGXPoweredON - IMG_TRUE if RGX device is on |
| |
| @Return void |
| |
| ******************************************************************************/ |
| void RGXDumpRGXDebugSummary(DUMPDEBUG_PRINTF_FUNC *pfnDumpDebugPrintf, |
| void *pvDumpDebugFile, |
| PVRSRV_RGXDEV_INFO *psDevInfo, |
| IMG_BOOL bRGXPoweredON); |
| |
| #endif /* __RGXDEBUG_H__ */ |