| /*************************************************************************/ /*! |
| @File rgx_compact_bvnc.c |
| @Title BVNC compatibility check utilities |
| @Copyright Copyright (c) Imagination Technologies Ltd. All Rights Reserved |
| @Description Utility functions used for packing BNC and V. |
| @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. |
| */ /**************************************************************************/ |
| |
| #include "rgx_compat_bvnc.h" |
| #if defined(RGX_FIRMWARE) |
| #include "rgxfw_utils.h" |
| #elif !defined(RGX_BUILD_BINARY) |
| #include "pvr_debug.h" |
| #endif |
| |
| #if defined(RGX_FIRMWARE) |
| #define PVR_COMPAT_ASSERT RGXFW_ASSERT |
| #elif !defined(RGX_BUILD_BINARY) |
| #define PVR_COMPAT_ASSERT PVR_ASSERT |
| #else |
| #include <assert.h> |
| #define PVR_COMPAT_ASSERT assert |
| #endif |
| |
| /**************************************************************************//** |
| * C library strlen function. |
| *****************************************************************************/ |
| static INLINE __maybe_unused IMG_UINT32 OSStringLength(const IMG_CHAR* pszInput) |
| { |
| const IMG_CHAR* pszTemp = pszInput; |
| |
| while (*pszTemp) |
| pszTemp++; |
| |
| return (pszTemp - pszInput); |
| } |
| |
| /**************************************************************************//** |
| * Utility function for packing BNC |
| *****************************************************************************/ |
| static INLINE IMG_UINT64 rgx_bnc_pack(IMG_UINT32 ui32B, IMG_UINT32 ui32N, |
| IMG_UINT32 ui32C) |
| { |
| /* |
| * Test for input B, N and C exceeding max bit width. |
| */ |
| PVR_COMPAT_ASSERT((ui32B & (~(RGX_BVNC_PACK_MASK_B >> RGX_BVNC_PACK_SHIFT_B))) == 0); |
| PVR_COMPAT_ASSERT((ui32N & (~(RGX_BVNC_PACK_MASK_N >> RGX_BVNC_PACK_SHIFT_N))) == 0); |
| PVR_COMPAT_ASSERT((ui32C & (~(RGX_BVNC_PACK_MASK_C >> RGX_BVNC_PACK_SHIFT_C))) == 0); |
| |
| return (((IMG_UINT64)ui32B << RGX_BVNC_PACK_SHIFT_B) | |
| ((IMG_UINT64)ui32N << RGX_BVNC_PACK_SHIFT_N) | |
| ((IMG_UINT64)ui32C << RGX_BVNC_PACK_SHIFT_C)); |
| } |
| |
| /**************************************************************************//** |
| * Utility function for packing BNC and V to be used by compatibility check. |
| * BNC is packed into 48 bit format. |
| * If the array pointed to by pszV is a string that is shorter than |
| * ui32OutVMaxLen characters, null characters are appended to the copy in the |
| * array pointed to by pszOutV, until 'ui32OutVMaxLen' characters in all have |
| * been written. |
| * |
| * @param: pui64OutBNC Output containing packed BNC. |
| * @param pszOutV Output containing version string. |
| * @param ui32OutVMaxLen Max characters that can be written to |
| pszOutV (excluding terminating null character) |
| * @param ui32B Input 'B' value |
| * @param pszV Input 'V' string |
| * @param ui32N Input 'N' value |
| * @param ui32C Input 'C' value |
| * @return None |
| *****************************************************************************/ |
| void rgx_bvnc_packed(IMG_UINT64 *pui64OutBNC, IMG_CHAR *pszOutV, IMG_UINT32 ui32OutVMaxLen, |
| IMG_UINT32 ui32B, IMG_CHAR *pszV, IMG_UINT32 ui32N, IMG_UINT32 ui32C) |
| { |
| *pui64OutBNC = rgx_bnc_pack(ui32B, ui32N, ui32C); |
| |
| if (!pszOutV) |
| return; |
| |
| if (pszV) |
| { |
| /* |
| * Assert can fail for two reasons |
| * 1. Caller is passing invalid 'V' string or |
| * 2. Dest buffer does not have enough memory allocated for max 'V' size. |
| */ |
| PVR_COMPAT_ASSERT(OSStringLength(pszV) <= ui32OutVMaxLen); |
| |
| |
| for (; ui32OutVMaxLen > 0 && *pszV != '\0'; --ui32OutVMaxLen) |
| { |
| /* When copying the V, omit any characters as these would cause |
| * the compatibility check against the V read from HW to fail |
| */ |
| if (*pszV && (*pszV >= '0') && (*pszV <='9')) |
| { |
| *pszOutV++ = *pszV++; |
| } |
| else |
| { |
| pszV++; |
| } |
| } |
| } |
| |
| do |
| { |
| *pszOutV++ = '\0'; |
| }while(ui32OutVMaxLen-- > 0); |
| } |
| |
| /**************************************************************************//** |
| * Utility function for packing BNC and V to be used by compatibility check. |
| * Input B,N and C is packed into 48 bit format. |
| * Input V is converted into string. If number of characters required to |
| * represent 16 bit wide version number is less than ui32OutVMaxLen, than null |
| * characters are appended to pszOutV, until ui32OutVMaxLen characters in all |
| * have been written. |
| * |
| * @param: pui64OutBNC Output containing packed BNC. |
| * @param pszOutV Output containing version string. |
| * @param ui32OutVMaxLen Max characters that can be written to |
| pszOutV (excluding terminating null character) |
| * @param ui32B Input 'B' value (16 bit wide) |
| * @param ui32V Input 'V' value (16 bit wide) |
| * @param ui32N Input 'N' value (16 bit wide) |
| * @param ui32C Input 'C' value (16 bit wide) |
| * @return .None |
| *****************************************************************************/ |
| void rgx_bvnc_pack_hw(IMG_UINT64 *pui64OutBNC, IMG_CHAR *pszOutV, IMG_UINT32 ui32OutVMaxLen, |
| IMG_UINT32 ui32B, IMG_UINT32 ui32V, IMG_UINT32 ui32N, IMG_UINT32 ui32C) |
| { |
| /* |
| * Allocate space for max digits required to represent 16 bit wide version |
| * number (including NULL terminating character). |
| */ |
| IMG_CHAR aszBuf[6]; |
| IMG_CHAR *pszPointer = aszBuf; |
| |
| *pui64OutBNC = rgx_bnc_pack(ui32B, ui32N, ui32C); |
| |
| if (!pszOutV) |
| return; |
| |
| /* |
| * Function only supports 16 bits wide version number. |
| */ |
| PVR_COMPAT_ASSERT((ui32V & ~0xFFFF) == 0); |
| |
| if (ui32V > 9999) |
| pszPointer+=5; |
| else if (ui32V > 999) |
| pszPointer+=4; |
| else if (ui32V > 99) |
| pszPointer+=3; |
| else if (ui32V > 9) |
| pszPointer+=2; |
| else |
| pszPointer+=1; |
| |
| *pszPointer-- = '\0'; |
| *pszPointer = '0'; |
| |
| while (ui32V > 0) |
| { |
| *pszPointer-- = (ui32V % 10) + '0'; |
| ui32V /= 10; |
| } |
| |
| for (pszPointer = aszBuf; ui32OutVMaxLen > 0 && *pszPointer != '\0'; --ui32OutVMaxLen) |
| *pszOutV++ = *pszPointer++; |
| |
| /* |
| * Append NULL characters. |
| */ |
| do |
| { |
| *pszOutV++ = '\0'; |
| }while(ui32OutVMaxLen-- > 0); |
| } |
| |