6b9fa5bd1c
Removed mainpage. Signed-off-by: Durga challa <vnsldurg@xilinx.com> Acked-by: Srikanth Vemula <svemula@xilinx.com>
664 lines
24 KiB
C
Executable file
664 lines
24 KiB
C
Executable file
/******************************************************************************
|
|
*
|
|
* (c) Copyright 2011 - 2014 Xilinx, Inc. All rights reserved.
|
|
*
|
|
* 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.
|
|
*
|
|
* Use of the Software is limited solely to applications:
|
|
* (a) running on a Xilinx device, or
|
|
* (b) that interact with a Xilinx device through a bus or interconnect.
|
|
*
|
|
* 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. IN NO EVENT SHALL THE
|
|
* XILINX CONSORTIUM 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.
|
|
*
|
|
* Except as contained in this notice, the name of the Xilinx shall not be used
|
|
* in advertising or otherwise to promote the sale, use or other dealings in
|
|
* this Software without prior written authorization from Xilinx.
|
|
*
|
|
******************************************************************************/
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* @file xccm.h
|
|
*
|
|
* This header file contains identifiers and register-level driver functions (or
|
|
* macros), range macros, structure typedefs that can be used to access the
|
|
* Xilinx Color Correction Matrix (CCM) core instance.
|
|
*
|
|
* The Color Correction Matrix core offers a 3x3 matrix multiplication for a
|
|
* variety of color correction applications.
|
|
* CCM core provides following features:
|
|
* - Fully programmable coefficient matrix.
|
|
* - Offset compensation.
|
|
* - Clipping and
|
|
* - Clamping of the output.
|
|
*
|
|
* <b>Initialization & Configuration</b>
|
|
*
|
|
* The device driver enables higher layer software (e.g., an application) to
|
|
* communicate to the CCM core.
|
|
*
|
|
* XCcm_CfgInitialize() API is used to initialize the CCM core.
|
|
* The user needs to first call the XCcm_LookupConfig() API which returns
|
|
* the Configuration structure pointer which is passed as a parameter to the
|
|
* XCcm_CfgInitialize() API.
|
|
*
|
|
* <b> Interrupts </b>
|
|
*
|
|
* The driver provides an interrupt handler XCcm_IntrHandler for handling
|
|
* the interrupt from the CCM core. The users of this driver have to
|
|
* register this handler with the interrupt system and provide the callback
|
|
* functions by using XCcm_SetCallBack API.
|
|
*
|
|
* <b> Virtual Memory </b>
|
|
*
|
|
* This driver supports Virtual Memory. The RTOS is responsible for calculating
|
|
* the correct device base address in Virtual Memory space.
|
|
*
|
|
* <b> Threads </b>
|
|
*
|
|
* This driver is not thread safe. Any needs for threads or thread mutual
|
|
* exclusion must be satisfied by the layer above this driver.
|
|
*
|
|
* <b> Asserts </b>
|
|
*
|
|
* Asserts are used within all Xilinx drivers to enforce constraints on argument
|
|
* values. Asserts can be turned off on a system-wide basis by defining, at
|
|
* compile time, the NDEBUG identifier. By default, asserts are turned on and it
|
|
* is recommended that users leave asserts on during development.
|
|
*
|
|
* <b> Building the driver </b>
|
|
*
|
|
* The XCcm driver is composed of several source files. This allows the user
|
|
* to build and link only those parts of the driver that are necessary.
|
|
*
|
|
* <pre>
|
|
* MODIFICATION HISTORY:
|
|
*
|
|
* Ver Who Date Changes
|
|
* ----- ------ -------- ---------------------------------------------------
|
|
* 2.00a jo 05/1/10 Updated for CCM V2.0.
|
|
* 3.00a ren 09/11/11 Updated for CCM V3.0.
|
|
* 4.00a jj 12/18/12 Converted from xio.h to xil_io.h,translating
|
|
* basic types,MB cache functions, exceptions
|
|
* and assertions to xil_io format.
|
|
* 5.0 adk 19/12/13 Updated as per the New Tcl API's.
|
|
* 6.0 adk 03/06/14 Changed file name ccm.h to xccm.h.
|
|
* Moved register offsets and bit definitions to
|
|
* xccm_hw.h file.
|
|
* Defined the following handler types as enum values:
|
|
* XCCM_HANDLER_PROCSTART ,XCCM_HANDLER_FRAMEDONE and
|
|
* XCCM_HANDLER_ERROR.
|
|
*
|
|
* Added the following range macros:
|
|
* XCCM_VSIZE_FIRST, XCCM_VSIZE_LAST
|
|
* XCCM_HSIZE_FIRST, XCCM_HSIZE_LAST
|
|
* XCCM_COEF_FIRST,XCCM_COEF_LAST
|
|
* XCCM_OFFSET_FIRST,XCCM_OFFSET_LAST
|
|
* XCCM_CLAMP_FIRST,XCCM_CLAMP_LAST
|
|
* XCCM_CLIP_FIRST,XCCM_CLIP_LAST.
|
|
*
|
|
* Added the following structure type definitions:
|
|
* XCcm_Config and XCcm.
|
|
*
|
|
* Removed the following functional macros:
|
|
* CCM_Enable, CCM_Disable, CCM_RegUpdateEnable
|
|
* CCM_RegUpdateDisable, CCM_Reset, CCM_AutoSyncReset
|
|
* CCM_ClearReset.
|
|
*
|
|
* Added the following macros:
|
|
* XCcm_Enable, XCcm_Disable,XCcm_RegUpdateEnable,
|
|
* XCcm_SyncReset, XCcm_Reset, XCcm_IntrGetPending,
|
|
* XCcm_IntrEnable, XCcm_IntrDisable,
|
|
* XCcm_StatusGetPending, XCcm_IntrClear, XCcm_Start,
|
|
* XCcm_Stop.
|
|
*
|
|
* Modification history from xccm_hw.h
|
|
* First release.
|
|
* Added the register offsets and bit masks for the
|
|
* registers.
|
|
* Added backward compatibility macros.
|
|
*
|
|
* Modifications in the file xccm.c are:
|
|
* Changed filename ccm to xccm.c.
|
|
* Implemented the following functions:
|
|
* XCcm_CfgInitialize, XCcm_Setup, XCcm_GetVersion,
|
|
* XCcm_EnableDbgByPass, XCcm_IsDbgByPassEnabled,
|
|
* XCcm_DisableDbgByPass, XCcm_EnableDbgTestPattern,
|
|
* XCcm_IsDbgTestPatternEnabled,
|
|
* XCcm_DisableDbgTestPattern, XCcm_GetDbgFrameCount,
|
|
* XCcm_GetDbgLineCount, XCcm_GetDbgPixelCount,
|
|
* XCcm_SetActiveSize, XCcm_GetActiveSize,
|
|
* XCcm_SetCoefMatrix, XCcm_GetCoefMatrix,
|
|
* XCcm_SetRgbOffset, XCcm_GetRgbOffset,
|
|
* XCcm_SetClip, XCcm_GetClip,
|
|
* XCcm_SetClamp XCcm_GetClamp XCcm_FloatToFixedConv,
|
|
* and XCcm_FixedToFloatConv.
|
|
*
|
|
* Modifications in the file xccm_selftest.c are:
|
|
* Implemented XCcm_SelfTest function.
|
|
*
|
|
* Modifications in the file xccm_sinit.c are:
|
|
* Implemented XCcm_LookupConfig function.
|
|
*
|
|
* Modifications in the file xccm_intr.c are:
|
|
* Implemented the following functions:
|
|
* XCcm_IntrHandler
|
|
* XCcm_SetCallBack
|
|
*
|
|
* </pre>
|
|
*
|
|
******************************************************************************/
|
|
|
|
#ifndef XCCM_H_
|
|
#define XCCM_H_ /**< Prevent circular inclusions
|
|
* by using protection macros */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/***************************** Include Files *********************************/
|
|
|
|
#include "xccm_hw.h"
|
|
#include "xil_assert.h"
|
|
#include "xstatus.h"
|
|
|
|
/************************** Constant Definitions *****************************/
|
|
|
|
/** @name Handler Types
|
|
* @{
|
|
*/
|
|
/**
|
|
* These constants specify different types of handler and used to differentiate
|
|
* interrupt requests from core.
|
|
*
|
|
*/
|
|
enum {
|
|
XCCM_HANDLER_PROCSTART = 1, /**< A processing start event interrupt
|
|
* type */
|
|
XCCM_HANDLER_FRAMEDONE, /**< A frame done event interrupt type */
|
|
XCCM_HANDLER_ERROR /**< An error condition interrupt type */
|
|
} ;
|
|
/*@}*/
|
|
|
|
/** @name Active Size Ranges
|
|
* @{
|
|
*/
|
|
#define XCCM_ACT_SIZE_FIRST 32 /**< Active Size starting value */
|
|
#define XCCM_ACT_SIZE_LAST 7680 /**< Active Size ending value */
|
|
|
|
/*@}*/
|
|
|
|
/** @name Coefficient ranges
|
|
* @{
|
|
*/
|
|
#define XCCM_COEF_FIRST -8.0 /**< Coefficient starting
|
|
* value */
|
|
#define XCCM_COEF_LAST 8.0 /**< Coefficient ending
|
|
* value */
|
|
/*@}*/
|
|
|
|
/** @name Offset ranges
|
|
* @{
|
|
*/
|
|
#define XCCM_OFFSET_FIRST 0xFFFFFF00 /**< Offset starting value */
|
|
#define XCCM_OFFSET_LAST 255 /**< Offset ending value */
|
|
/*@}*/
|
|
|
|
/** @name Clamp ranges
|
|
* @{
|
|
*/
|
|
#define XCCM_CLAMP_FIRST 0 /**< Clamp starting value */
|
|
#define XCCM_CLAMP_LAST 255 /**< Clamp ending value */
|
|
/*@}*/
|
|
|
|
/** @name Clip ranges
|
|
* @{
|
|
*/
|
|
#define XCCM_CLIP_FIRST 0 /**< Clip starting value */
|
|
#define XCCM_CLIP_LAST 255 /**< Clip ending value */
|
|
/*@}*/
|
|
|
|
/***************** Macros (Inline Functions) Definitions *********************/
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro enables the CCM core.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_Enable(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_Enable(InstancePtr) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET), \
|
|
((XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET))) | (XCCM_CTL_SW_EN_MASK)))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro disables the CCM core.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_Disable(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_Disable(InstancePtr) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET), \
|
|
((XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET))) & (~(XCCM_CTL_SW_EN_MASK))))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro enables/starts the CCM core.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be
|
|
* worked on
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_Start(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_Start XCcm_Enable
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro disables/stops the CCM core.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_Stop(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_Stop XCcm_Disable
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro commits all the register value changes made so far by
|
|
* the software to the CCM core instance.
|
|
*
|
|
* This macro only works when the CCM core is enabled.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_RegUpdateEnable(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_RegUpdateEnable(InstancePtr) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET), \
|
|
((XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET))) | (XCCM_CTL_RUE_MASK)))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro prevents the CCM core instance from committing recent
|
|
* changes made so far by the software. When disabled, changes to other
|
|
* configuration registers are stored, but do not effect the behavior of the
|
|
* core.
|
|
*
|
|
* This macro only works when the CCM core is enabled.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_RegUpdateDisable(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_RegUpdateDisable(InstancePtr) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET), \
|
|
((XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET))) & (~(XCCM_CTL_RUE_MASK))))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro resets a CCM core at the end of the frame being
|
|
* processed. It enables core automatically synchronizes to the SOF of the core
|
|
* to prevent image tearing. This macro is differ from XCcm_Reset().
|
|
*
|
|
* On the next rising-edge of SOF following a call to XCcm_SyncReset,
|
|
* all of the core's configuration registers and outputs will be reset, then the
|
|
* reset flag will be immediately released, allowing the core to immediately
|
|
* resume default operation.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_SyncReset(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_SyncReset(InstancePtr) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET), \
|
|
(XCCM_CTL_AUTORESET_MASK))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro resets a CCM core. This reset effects the core
|
|
* immediately and may cause image tearing.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_Reset(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_Reset(InstancePtr) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_CONTROL_OFFSET), \
|
|
(XCCM_CTL_RESET_MASK))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro enables individual interrupts of the CCM core by updating
|
|
* the IRQ_ENABLE register.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
* @param IntrType is the type of the interrupts to enable. Use OR'ing of
|
|
* XCCM_IXR_*_MASK constants defined in xccm_hw.h to create this
|
|
* parameter value.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note The existing enabled interrupt(s) will remain enabled.
|
|
* C-style signature:
|
|
* void XCcm_IntrEnable(XCcm *InstancePtr, u32 IntrType)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_IntrEnable(InstancePtr, IntrType) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_IRQ_EN_OFFSET), \
|
|
(((IntrType) & (XCCM_IXR_ALLINTR_MASK)) | \
|
|
(XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_IRQ_EN_OFFSET)))))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro disables individual interrupts of the CCM core by
|
|
* updating the IRQ_ENABLE register.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
* @param IntrType is the type of the interrupts to disable. Use OR'ing
|
|
* of XCCM_IXR_*_MASK constants defined in xccm_hw.h to create
|
|
* this parameter value.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note Any other interrupt not covered by parameter IntrType,
|
|
* if enabled before this macro is called, will remain enabled.
|
|
* C-style signature:
|
|
* void XCcm_IntrDisable(XCcm *InstancePtr, u32 IntrType)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_IntrDisable(InstancePtr, IntrType) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_IRQ_EN_OFFSET), \
|
|
((XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_IRQ_EN_OFFSET))) & ((~(IntrType)) & \
|
|
(XCCM_IXR_ALLINTR_MASK))))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro returns the pending interrupt status of the CCM core
|
|
* by reading from Status register.
|
|
*
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return The pending interrupts of the CCM. Use XCCM_IXR_*_MASK
|
|
* constants defined in xccm_hw.h to interpret this value.
|
|
*
|
|
* @note C-style signature:
|
|
* u32 XCcm_StatusGetPending(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_StatusGetPending(InstancePtr) \
|
|
XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_STATUS_OFFSET)) & (XCCM_IXR_ALLINTR_MASK)
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro returns the pending interrupts of the CCM core for the
|
|
* interrupts that have been enabled.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
*
|
|
* @return The pending interrupts of the CCM. Use XCCM_IXR_*_MASK
|
|
* constants defined in xccm_hw.h to interpret this value.
|
|
* The returned value is a logical AND of the contents of the
|
|
* STATUS Register and the IRQ_ENABLE Register.
|
|
*
|
|
* @note C-style signature:
|
|
* u32 XCcm_IntrGetPending(XCcm *InstancePtr)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_IntrGetPending(InstancePtr) \
|
|
XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_IRQ_EN_OFFSET)) & \
|
|
((XCcm_ReadReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_STATUS_OFFSET))) & (XCCM_IXR_ALLINTR_MASK))
|
|
|
|
/*****************************************************************************/
|
|
/**
|
|
*
|
|
* This macro clears/acknowledges pending interrupts of the CCM core
|
|
* in the Status register. Bit positions to 1 will be cleared.
|
|
*
|
|
* @param InstancePtr is a pointer to the XCcm instance to be worked on.
|
|
* @param IntrType is the pending interrupts to clear/acknowledge.
|
|
* Use OR'ing of XCCM_IXR_*_MASK constants defined in xccm_hw.h to
|
|
* create this parameter value.
|
|
*
|
|
* @return None.
|
|
*
|
|
* @note C-style signature:
|
|
* void XCcm_IntrClear(XCcm *InstancePtr, u32 IntrType)
|
|
*
|
|
******************************************************************************/
|
|
#define XCcm_IntrClear(InstancePtr, IntrType) \
|
|
XCcm_WriteReg((InstancePtr)->Config.BaseAddress, \
|
|
(XCCM_STATUS_OFFSET), ((IntrType) & (XCCM_IXR_ALLINTR_MASK)))
|
|
|
|
/**************************** Type Definitions *******************************/
|
|
|
|
/**
|
|
* This typedef contains configuration information for a CCM core.
|
|
* Each CCM core should have a configuration structure associated.
|
|
*/
|
|
typedef struct {
|
|
u16 DeviceId; /**< DeviceId is the unique ID of the
|
|
* device */
|
|
u32 BaseAddress; /**< BaseAddress is the physical base address
|
|
* of the device's registers */
|
|
u32 SlaveAxisVideoFormat; /**< Slave Axis Video Format */
|
|
u32 MasterAxisVideoFormat; /**< Master Axis Video Format */
|
|
u32 MaxColumns; /**< Maximum Columns */
|
|
u32 ActiveColumns; /**< Active Columns */
|
|
u32 ActiveRows; /**< Active rows */
|
|
u16 HasDebug; /**< Has Debug GUI specified */
|
|
u16 HasIntcIf; /**< Has Interrupt Control */
|
|
u16 Clip; /**< Clip value */
|
|
u16 Clamp; /**< Clamp value */
|
|
u32 K11; /**< Element of Coefficient matrix */
|
|
u32 K12; /**< Element of Coefficient matrix */
|
|
u32 K13; /**< Element of Coefficient matrix */
|
|
u32 K21; /**< Element of Coefficient matrix */
|
|
u32 K22; /**< Element of Coefficient matrix */
|
|
u32 K23; /**< Element of Coefficient matrix */
|
|
u32 K31; /**< Element of Coefficient matrix */
|
|
u32 K32; /**< Element of Coefficient matrix */
|
|
u32 K33; /**< Element of Coefficient matrix */
|
|
u32 ROffset; /**< Red color offset value */
|
|
u32 GOffset; /**< Green color offset value */
|
|
u32 BOffset; /**< Blue color offset value */
|
|
u32 SlaveAxiClkFreqHz; /**< Slave Clock Frequency in Hz */
|
|
} XCcm_Config;
|
|
|
|
/******************************************************************************/
|
|
/**
|
|
*
|
|
* Callback type for all interrupts except error interrupt.
|
|
*
|
|
* @param CallBackRef is a callback reference passed in by the upper
|
|
* layer when setting the callback functions, and passed back to
|
|
* the upper layer when the callback is invoked.
|
|
*/
|
|
typedef void (*XCcm_CallBack)(void *CallBackRef);
|
|
|
|
/******************************************************************************/
|
|
/**
|
|
*
|
|
* Callback type for Error interrupt.
|
|
*
|
|
* @param CallBackRef is a callback reference passed in by the upper
|
|
* layer when setting the callback functions, and passed back to
|
|
* the upper layer when the callback is invoked.
|
|
* @param ErrorMask is a bit mask indicating the cause of the error. Its
|
|
* value equals 'OR'ing one or more XCCM_IXR_*_MASK values defined
|
|
* in xccm_hw.h.
|
|
*/
|
|
typedef void (*XCcm_ErrorCallBack)(void *CallBackRef, u32 ErrorMask);
|
|
|
|
/******************************************************************************/
|
|
/**
|
|
*
|
|
* The XCcm driver instance data structure. A pointer to an instance data
|
|
* structure is passed around by functions to refer to a specific driver
|
|
* instance.
|
|
*/
|
|
typedef struct {
|
|
XCcm_Config Config; /**< Hardware configuration */
|
|
u32 IsReady; /**< Device and the driver instance
|
|
* are initialized */
|
|
u16 HSize; /**< Active Video Horizontal Size */
|
|
u16 VSize; /**< Active Video Vertical Size */
|
|
|
|
/* IRQ Callbacks */
|
|
XCcm_CallBack ProcStartCallBack;/**< Call back for Processing
|
|
* Start interrupt */
|
|
void *ProcStartRef; /**< To be passed to the Process Start
|
|
* interrupt callback */
|
|
XCcm_CallBack FrameDoneCallBack;/**< Call back for Frame Done
|
|
* interrupt */
|
|
void *FrameDoneRef; /**< To be passed to the Frame Done
|
|
* interrupt callback */
|
|
XCcm_ErrorCallBack ErrCallBack; /**< Call back for Error interrupt */
|
|
void *ErrRef; /**< To be passed to the Error
|
|
* interrupt callback */
|
|
} XCcm;
|
|
|
|
/**
|
|
* This typedef contains matrix coefficients of Color Correction Matrix(CCM)
|
|
* core which can be accessed for setting coefficients by using XCcm_SetCoefMatrix
|
|
* and for getting coefficient values by using XCcm_GetCoefMatrix.
|
|
*/
|
|
typedef struct {
|
|
float K11; /**< Matrix Coefficient */
|
|
float K12; /**< Matrix Coefficient */
|
|
float K13; /**< Matrix Coefficient */
|
|
float K21; /**< Matrix Coefficient */
|
|
float K22; /**< Matrix Coefficient */
|
|
float K23; /**< Matrix Coefficient */
|
|
float K31; /**< Matrix Coefficient */
|
|
float K32; /**< Matrix Coefficient */
|
|
float K33; /**< Matrix Coefficient */
|
|
} XCcm_Coefs;
|
|
|
|
/************************** Function Prototypes ******************************/
|
|
|
|
/* Initialization functions in xccm_sinit.c */
|
|
XCcm_Config *XCcm_LookupConfig(u16 DeviceId);
|
|
|
|
/* Initialization and control functions implemented in xccm.c */
|
|
int XCcm_CfgInitialize(XCcm *InstancePtr, XCcm_Config *CfgPtr,
|
|
u32 EffectiveAddr);
|
|
u32 XCcm_GetVersion(XCcm *InstancePtr);
|
|
void XCcm_Setup(XCcm *InstancePtr);
|
|
void XCcm_EnableDbgByPass(XCcm *InstancePtr);
|
|
int XCcm_IsDbgByPassEnabled(XCcm *InstancePtr);
|
|
void XCcm_DisableDbgByPass(XCcm *InstancePtr);
|
|
void XCcm_EnableDbgTestPattern(XCcm *InstancePtr);
|
|
int XCcm_IsDbgTestPatternEnabled(XCcm *InstancePtr);
|
|
void XCcm_DisableDbgTestPattern(XCcm *InstancePtr);
|
|
u32 XCcm_GetDbgFrameCount(XCcm *InstancePtr);
|
|
u32 XCcm_GetDbgLineCount(XCcm *InstancePtr);
|
|
u32 XCcm_GetDbgPixelCount(XCcm *InstancePtr);
|
|
void XCcm_SetActiveSize(XCcm *InstancePtr, u16 HSize, u16 VSize);
|
|
void XCcm_GetActiveSize(XCcm *InstancePtr, u16 *HSize, u16 *VSize);
|
|
void XCcm_SetCoefMatrix(XCcm *InstancePtr, XCcm_Coefs *CoefValues);
|
|
void XCcm_GetCoefMatrix(XCcm *InstancePtr, XCcm_Coefs *CoefValues);
|
|
void XCcm_SetRgbOffset(XCcm *InstancePtr, s32 ROffset, s32 GOffset,
|
|
s32 BOffset);
|
|
void XCcm_GetRgbOffset(XCcm *InstancePtr, s32 *ROffset, s32 *GOffset,
|
|
s32 *BOffset);
|
|
void XCcm_SetClip(XCcm *InstancePtr, u32 Clip);
|
|
u32 XCcm_GetClip(XCcm *InstancePtr);
|
|
void XCcm_SetClamp(XCcm *InstancePtr, u32 Clamp);
|
|
u32 XCcm_GetClamp(XCcm *InstancePtr);
|
|
|
|
/* Self - Test function implemented in xccm_selftest.c */
|
|
int XCcm_SelfTest(XCcm *InstancePtr);
|
|
|
|
/* Interrupt related functions implemented in xccm_intr.c */
|
|
void XCcm_IntrHandler(void *InstancePtr);
|
|
int XCcm_SetCallBack(XCcm *InstancePtr, u32 HandlerType,
|
|
void *CallBackFunc, void *CallBackRef);
|
|
|
|
/************************** Variable Declarations ****************************/
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif /* End of protection macro */
|