initial releasecm-13.0

1 files changed, 314 insertions, 0 deletions

diff --git a/kernel-headers/bits_api.h b/kernel-headers/bits_api.h
new file mode 100644
index 0000000..845b6d1
--- /dev/null
+++ b/kernel-headers/bits_api.h
@@ -0,0 +1,314 @@
+#ifndef _BITS_API_H_
+#define _BITS_API_H_
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "val_types_public.h"
+#include "hal_api.h"
+
+typedef VAL_UINT32_T(*fgPrepare32FN)(VAL_HANDLE_T * a_phBitsHandle);
+
+/**
+ * @par Structure
+ *  VBITS_HANDLE_T
+ * @par Description
+ *  This is a parameter for bitstream parsing utility related function
+ */
+typedef struct __VBITS_HANDLE_T {
+	VAL_HANDLE_T    hHALHandle;                             /* /< HAL Handle */
+	VAL_HANDLE_T    hVALHandle;                             /* /< VAL Handle */
+	VAL_MEM_ADDR_T  BitsStart;                              /* /< Bits Start */
+	VAL_MEMORY_T    rHandleMem;                             /* /< Handle memory */
+	VAL_UINT32_T    nReadingMode;                           /* /< 0 for software, 1 for mmap, 2 for hardware */
+	VAL_ULONG_T     StartAddr;                              /* /< used for software mode fast access */
+	VAL_ULONG_T     nSize;                                  /* /< Size */
+	VAL_UINT32_T    nBitCnt;                                /* /< bits count */
+	VAL_UINT32_T    nZeroCnt;                               /* /< zero count */
+	VAL_UINT32_T    Cur32Bits;                              /* /< current 32 bits */
+	VAL_UINT32_T    CurBitCnt;                              /* /< current bits count */
+	VAL_UINT32_T    n03RemoveCount;                         /* /< 03 Remove Count */
+	VAL_UINT32_T    n03CountBit;                            /* /< 03 Count Bit */
+	VAL_INT32_T     n03FirstIndex;                          /* /< 03 First Index */
+	VAL_INT32_T     n03SecondIndex;                         /* /< 03 Second Index */
+	VAL_UINT32_T    n03RemoveIgnore;                        /* /< 03 Remove Ignore */
+	VAL_BOOL_T      bFirstCheck;                            /* /< First Check */
+	VAL_BOOL_T      bEverRemove;                            /* /< Ever Remove */
+	VAL_BOOL_T      bIgnoreByBS;                            /* /< Ignore By BS */
+	VAL_BOOL_T      bEOF;                                   /* /< EOF */
+	fgPrepare32FN   Prepare32Bits;                          /* /< Prepare 32 Bits */
+	VAL_DRIVER_TYPE_T vFormat;                              /* /< Format */
+	VAL_UINT32_T    value;                                  /* /< value */
+} VBITS_HANDLE_T;
+
+
+/**
+ * @par Enumeration
+ *   VBITS_READTYPE_T
+ * @par Description
+ *   This is the item used for bits read type
+ */
+typedef enum VBITS_READTYPE_T {
+	VBITS_SOFTWARE = 0,         /* /< software */
+	VBITS_MMAP,                 /* /< mmap */
+	VBITS_HARDWARE,             /* /< hardware */
+	VBITS_MAX                   /* /< MAX value */
+} VBITS_READTYPE_T;
+/*=============================================================================
+ *                             Function Declaration
+ *===========================================================================*/
+
+
+/**
+ * @par Function
+ *   eBufEnable
+ * @par Description
+ *   The hal init & HW enable function
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   hHALHandle         [IN/OUT] The hal handle
+ * @param
+ *   nMode              [IN] VBITS_READTYPE_T
+ * @param
+ *   vFormat            [IN] VAL_DRIVER_TYPE_T
+ * @par Returns
+ *   VAL_UINT32_T, return VAL_RESULT_NO_ERROR if success, return VAL_RESULT_UNKNOWN_ERROR if failed
+ */
+VAL_UINT32_T eBufEnable(
+	VAL_HANDLE_T *a_phBitsHandle,
+	VAL_HANDLE_T hHALHandle,
+	VAL_UINT32_T nMode,
+	VAL_DRIVER_TYPE_T vFormat
+);
+
+
+/**
+ * @par Function
+ *   eBufEnable
+ * @par Description
+ *   The HW disable function
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   hHALHandle         [IN/OUT] The hal handle
+ * @param
+ *   nMode              [IN] VBITS_READTYPE_T
+ * @param
+ *   vFormat            [IN] VAL_DRIVER_TYPE_T
+ * @par Returns
+ *   VAL_UINT32_T, return VAL_RESULT_NO_ERROR if success, return VAL_RESULT_UNKNOWN_ERROR if failed
+ */
+VAL_UINT32_T eBufDisable(
+	VAL_HANDLE_T *a_phBitsHandle,
+	VAL_HANDLE_T hHALHandle,
+	VAL_UINT32_T nMode,
+	VAL_DRIVER_TYPE_T vFormat
+);
+
+
+/**
+ * @par Function
+ *   eBufInit
+ * @par Description
+ *   The common init function
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   hVALHandle         [IN/OUT] The val handle
+ * @param
+ *   hHALHandle         [IN/OUT] The hal handle
+ * @param
+ *   rBufAddrStart      [IN] The buffer start address
+ * @param
+ *   nMode              [IN] VBITS_READTYPE_T
+ * @param
+ *   vFormat            [IN] VAL_DRIVER_TYPE_T
+ * @par Returns
+ *   VAL_RESULT_T, return VAL_RESULT_NO_ERROR if success, return others if failed
+ */
+VAL_RESULT_T eBufInit(
+	VAL_HANDLE_T *a_phBitsHandle,
+	VAL_HANDLE_T hVALHandle,
+	VAL_HANDLE_T hHALHandle,
+	VAL_MEM_ADDR_T rBufAddrStart,
+	VAL_UINT32_T nMode,
+	VAL_DRIVER_TYPE_T vFormat
+);
+
+
+/**
+ * @par Function
+ *   eBufDeinit
+ * @par Description
+ *   The common deinit function
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_RESULT_T, return VAL_RESULT_NO_ERROR if success, return others if failed
+ */
+VAL_RESULT_T eBufDeinit(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   eBufGetBitCnt
+ * @par Description
+ *   The function is used to get current bit count
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_UINT32_T, return current bit count
+ */
+VAL_UINT32_T eBufGetBitCnt(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   eBufGetBits
+ * @par Description
+ *   The function is used to get current bits by numBits
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   numBits            [IN] The number bits
+ * @par Returns
+ *   VAL_UINT32_T, return current bits by numBits
+ */
+VAL_UINT32_T eBufGetBits(VAL_HANDLE_T *a_phBitsHandle, VAL_UINT32_T numBits);
+
+
+/**
+ * @par Function
+ *   eBufNextBits
+ * @par Description
+ *   The function is used to show current bits by numBits
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   numBits            [IN] The number bits
+ * @par Returns
+ *   VAL_UINT32_T, return current bits by numBits
+ */
+VAL_UINT32_T eBufNextBits(VAL_HANDLE_T *a_phBitsHandle, VAL_UINT32_T numBits);
+
+
+/**
+ * @par Function
+ *   eBufGetUEGolomb
+ * @par Description
+ *   The function is used to get unsigned EGolomb bits
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_UINT32_T, return current unsigned EGolomb bits
+ */
+VAL_UINT32_T eBufGetUEGolomb(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   eBufGetSEGolomb
+ * @par Description
+ *   The function is used to get signed EGolomb bits
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_INT32_T, return current signed EGolomb bits
+ */
+VAL_INT32_T  eBufGetSEGolomb(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   eBufCheckEOF
+ * @par Description
+ *   The function is used to check EOF bitstream
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_BOOL_T, return EOF or not
+ */
+VAL_BOOL_T   eBufCheckEOF(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   eBufGetBufSize
+ * @par Description
+ *   The function is used to get buffer size
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_BOOL_T, return buffer size
+ */
+VAL_UINT32_T eBufGetBufSize(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   NextBytesAlignment
+ * @par Description
+ *   The function is used to jump bitstream pointer to next bytesalignment
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   nBytesAlignment    [IN] BytesAlignment
+ * @par Returns
+ *   void
+ */
+void NextBytesAlignment(VAL_HANDLE_T *a_phBitsHandle, VAL_UINT32_T nBytesAlignment);
+
+
+/**
+ * @par Function
+ *   eBufInitBS
+ * @par Description
+ *   The function is used to init bit stream
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   cmd_queue          [IN] command queue
+ * @param
+ *   pIndex             [IN] command queue index
+ * @par Returns
+ *   VAL_BOOL_T, return VAL_TRUE if success, return VAL_FALSE if failed
+ */
+VAL_BOOL_T   eBufInitBS(VAL_HANDLE_T *a_phBitsHandle, P_VCODEC_DRV_CMD_T cmd_queue, VAL_UINT32_T *pIndex);
+
+
+/**
+ * @par Function
+ *   eBufGetPAddr
+ * @par Description
+ *   The function is used to get physical address
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @par Returns
+ *   VAL_UINT32_T, return physical address
+ */
+VAL_UINT32_T eBufGetPAddr(VAL_HANDLE_T *a_phBitsHandle);
+
+
+/**
+ * @par Function
+ *   eBufGetPAddr
+ * @par Description
+ *   The function is used to re init
+ * @param
+ *   a_phBitsHandle     [IN/OUT] The bits handle
+ * @param
+ *   nBytes             [IN] The Bytes
+ * @param
+ *   nBits              [IN] The Bits
+ * @par Returns
+ *   VAL_BOOL_T, return VAL_TRUE if success, return VAL_FALSE if failed
+ */
+VAL_BOOL_T eBufReInite(VAL_HANDLE_T *a_phBitsHandle, VAL_UINT32_T nBytes, VAL_UINT32_T nBits);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* #ifndef _VAL_API_H_ */