aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorbuddy.liong <buddy.budiono@ti.com>2014-03-20 15:33:55 -0500
committerPradeep Venkatasubbarao <pradeepv@ti.com>2014-03-26 09:40:00 +0530
commite3cdd16151a180079775acb16c649b6570284076 (patch)
tree873c5524d170e064d9a7f0c16b5787c9cde44667 /README
parent52068e53c7eee945b060496aa308bd0f3e9e0524 (diff)
downloaddce-e3cdd16151a180079775acb16c649b6570284076.tar.gz
Updating README3.00.04.01
The command to build libdce on QNX requires additional information. Instead of "make clean" and "make install", due to the renaming of Makefile to Makefile.qnx, the command becomes "make -f Makefile.qnx clean" and "make -f Makefile.qnx install". Updates the "Supported API Information" to point to the header files instead of listed it again here. Change-Id: Ied47d812eb8b0a6c9a9bb0cace3f6241f91d7325 Signed-off-by: buddy.liong <buddy.budiono@ti.com>
Diffstat (limited to 'README')
-rw-r--r--README94
1 files changed, 6 insertions, 88 deletions
diff --git a/README b/README
index 515606f..84c2882 100644
--- a/README
+++ b/README
@@ -1,13 +1,13 @@
****************************** LIBDCE README ******************************
-The libDCE component provides an interface for applications running on the
+The LIBDCE component provides an interface for applications running on the
MPU (HLOS) to invoke the Codec Engine APIs on the remote core (IPU). It
enables the Video Encode/Decode Usecases. Apart from the exposed CE APIs,
it provides a memplugin utility to allocate memory that can be read/written
from the remote IPU core.
This ReadMe file comprises:
-1. LibDCE Build Information
+1. LIBDCE Build Information
a. For QNX
b. For Linux
c. For Android
@@ -62,10 +62,10 @@ $(IPCHEADERS)/usr/include/ti/shmemallocator
$(IPCHEADERS)/usr/include/
Building:
-make install
+make -f Makefile.qnx install
Clean:
-make clean
+make -f Makefile.qnx clean
Location of Binaries:
INSTALL_ROOT/armle-v7/usr/lib/libdce.so
@@ -319,94 +319,12 @@ Void Engine_close(Engine_Handle engine)
############################ libDCE APIs ############################
-/*==================================================================*/
-/** dce_alloc : Allocate the Data structures passed to
- * codec-engine APIs except Input/Output buffers.
- * @ param sz [in] : Size of memory to be allocated.
- * @ return : Pointer to allocated memory.
- */
-void *dce_alloc(int sz)
-
-
-/*==================================================================*/
-/** dce_free : Free the Data structures passed to codec-engine APIs
- * allocated through the dce_alloc() API.
- * @ param ptr [in] : Pointer to allocated memory.
- */
-void dce_free(void *ptr)
-
-
-/*================ The below APIs are LINUX specifc ================*/
-/*==================================================================*/
-/** dce_init : Initialize DCE. Only Linux applications
- * should call this API.
- * @ return : Pointer to omap_device structure.
- */
-void *dce_init(void)
-
-
-/*===============================================================*/
-/** dce_deinit : Deinitialize DCE. Only Linux applications
- * should call this API.
- * @ param dev [in] : Pointer to omap_device structure.
- */
-void dce_deinit(void *dev)
-
-
-/*===============================================================*/
-/** dce_buf_lock : Pin or lock Tiler Buffers which would be
- * used by the codec as reference buffers.
- * Only Linux applications should call this API.
- * @ param num [in] : Number of buffers to be locked.
- * @ param handle [in] : Pointer to array of DMA Buf FDs of the
- * buffers to be locked.
- * @ return : DCE error status is returned.
- * #DCE_EOK [0] : Success.
- * #DCE_EOUT_OF_MEMORY [-2] : Out of Shared/Tiler Memory.
- * #DCE_EIPC_CALL_FAIL [-5] : MmRpc Call failed.
- * #DCE_EINVALID_INPUT [-6] : Invalid Inputs.
- */
-int dce_buf_lock(int num, size_t *handle)
-
-
-/*===============================================================*/
-/** dce_buf_unlock : Unpin or unlock Tiler Buffers which were
- * locked to be used by the codec as
- * reference buffers. Only Linux
- * applications should call this API.
- * @ param num [in] : Number of buffers to be unlocked.
- * @ param handle [in] : Pointer to array of DMA Buf FDs of
- * the buffers to be unlocked.
- * @ return : DCE error status is returned.
- * #DCE_EOK [0] : Success.
- * #DCE_EXDM_FAIL [-1] : XDM Failure.
- * #DCE_EOUT_OF_MEMORY [-2] : Out of Shared/Tiler Memory.
- * #DCE_EXDM_UNSUPPORTED [-3] : Unsupported XDM request.
- * #DCE_EIPC_CALL_FAIL [-5] : MmRpc Call failed.
- * #DCE_EINVALID_INPUT [-6] : Invalid Inputs.
- */
-int dce_buf_unlock(int num, size_t *handle)
-
-
-/*===============================================================*/
-/** dce_get_fd : Get OMAP DRM File Descriptor. Only Linux
- * applications should call this API.
- * @ return : OMAP DRM File Descriptor.
- */
-int dce_get_fd()
-
-
-/*===============================================================*/
-/** dce_set_fd : Set OMAP DRM File Descriptor. Only Linux
- * applications should call this API.
- * @ param fd [in] : OMAP DRM File Descriptor.
- */
-void dce_set_fd(int fd)
+See libdce.h
******************************* API call flow ******************************
-// For a Decoder Application
+// For example of a Decoder Application - using CE video3 interfaces to IPU (IVA-HD)
If (BUILDOS_LINUX) {
dev = dce_init()
}