xtouchscreen.c

基于powerPC405处理器的触摸显示屏驱动程序

/*-----------------------------------------------------------------------------
*     $Date: 2004/01/05 16:58:54 $
*     $RCSfile: xtouchscreen.c,v $
*----------------------------------------------------------------------------*/

/*****************************************************************************
*
*     XILINX IS PROVIDING THIS DESIGN, CODE, OR INFORMATION "AS IS"
*     SOLELY FOR USE IN DEVELOPING PROGRAMS AND SOLUTIONS FOR
*     XILINX DEVICES.  BY PROVIDING THIS DESIGN, CODE, OR INFORMATION
*     AS ONE POSSIBLE IMPLEMENTATION OF THIS FEATURE, APPLICATION
*     OR STANDARD, XILINX IS MAKING NO REPRESENTATION THAT THIS
*     IMPLEMENTATION IS FREE FROM ANY CLAIMS OF INFRINGEMENT,
*     AND YOU ARE RESPONSIBLE FOR OBTAINING ANY RIGHTS YOU MAY REQUIRE
*     FOR YOUR IMPLEMENTATION.  XILINX EXPRESSLY DISCLAIMS ANY
*     WARRANTY WHATSOEVER WITH RESPECT TO THE ADEQUACY OF THE
*     IMPLEMENTATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OR
*     REPRESENTATIONS THAT THIS IMPLEMENTATION IS FREE FROM CLAIMS OF
*     INFRINGEMENT, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
*     FOR A PARTICULAR PURPOSE.
*     
*     (c) Copyright 2004 Xilinx, Inc.
*     All rights reserved.
*
*****************************************************************************/
/****************************************************************************/
/**
*
* @file xtouchscreen.c
*
* This file contains the required functions for the touchscreen driver.
* Refer to the header file xtouchscreen.h for more detailed information.
*
* <pre>
* MODIFICATION HISTORY:
*
* Ver   Who  Date     Changes
* ----- ---- -------- -----------------------------------------------
* 1.00a ch   08/15/02 First release
* </pre>
*
*****************************************************************************/

/***************************** Include Files ********************************/

#include "xenv.h"
#include "xstatus.h"
#include "xparameters.h"
#include "xtouchscreen.h"
#include "xtouchscreen_i.h"
#include "xtouchscreen_l.h"
#include "xio.h"

/************************** Constant Definitions ****************************/

/**************************** Type Definitions ******************************/

/***************** Macros (Inline Functions) Definitions ********************/

/************************** Variable Definitions ****************************/

/************************** Function Prototypes *****************************/

static void XTouchscreen_StubHandler (void *CallBackRef, Xuint32 Event,
                                      unsigned int ByteCount);

/****************************************************************************/
/**
*
* Initializes a specific touchscreen instance such that it is ready to be used.
* The default operating mode of the driver is polled mode.
*
* @param    InstancePtr is a pointer to the XTouchscreen instance to be 
*           worked on.
* @param    DeviceId is the unique id of the device controlled by this
*           XTouchscreen instance. Passing in a device id associates the
*           generic XTouchscreen instance to a specific device, as chosen 
*           by the caller or application developer.
*
* @return
*
* - XST_SUCCESS if initialization was successful
* - XST_DEVICE_NOT_FOUND if the device ID could not be found in the
*           configuration table
*
* @note
*
* None.
*
*****************************************************************************/
XStatus XTouchscreen_Initialize (XTouchscreen *InstancePtr, Xuint16 DeviceId)
{
    XTouchscreen_Config *TouchscreenConfigPtr;

    /* 
     * Assert validates the input arguments
     */
    XASSERT_NONVOID(InstancePtr != XNULL);

    /*
     * Lookup the device configuration in the temporary CROM table. Use this
     * configuration info down below when initializing this component.
     */
    TouchscreenConfigPtr = XTouchscreen_LookupConfig(DeviceId);

    if (TouchscreenConfigPtr == (XTouchscreen_Config *)XNULL)
    {
        return XST_DEVICE_NOT_FOUND;
    }

    /*
     * Setup the data that is from the configuration information
     */
    InstancePtr->BaseAddress = TouchscreenConfigPtr->BaseAddress;

    /*
     * Initialize the instance data to some default values and setup a default
     * handler
     */
    InstancePtr->Handler = XTouchscreen_StubHandler;

    InstancePtr->CurrentState = XTOUCHSCREEN_STATE_PEN_UP;

    /*
     * Enable Touchscreen
     */
    XTouchscreen_mWriteCtrlReg(InstancePtr->BaseAddress, 0xd3);
    XENV_USLEEP(100);
    XTouchscreen_mWriteCtrlReg(InstancePtr->BaseAddress, 0xd0);
    XENV_USLEEP(100);


    /*
     * Clear all interrupts
     */
    XTouchscreen_mClearIntr(InstancePtr->BaseAddress, 
                            XTOUCHSCREEN_INT_PEN_DOWN | 
                            XTOUCHSCREEN_INT_PEN_UP);

    /*
     * Indicate the instance is now ready to use, initialized without error
     */
    InstancePtr->IsReady = XCOMPONENT_IS_READY;

    return XST_SUCCESS;
}

/****************************************************************************/
/**
*
* Looks up the device configuration based on the unique device ID. A table
* contains the configuration info for each device in the system.
*
* @param    DeviceId contains the ID of the device to look up the configuration
*           for.
*
* @return
*
* A pointer to the configuration found or XNULL if the specified device ID was
* not found.
*
* @note
*
* None.
*
******************************************************************************/
XTouchscreen_Config *XTouchscreen_LookupConfig(Xuint16 DeviceId)
{
    XTouchscreen_Config *CfgPtr = XNULL;

    int i;

    for (i=0; i < XPAR_XTOUCHSCREEN_NUM_INSTANCES; i++)
    {
        if (XTouchscreen_ConfigTable[i].DeviceId == DeviceId)
        {
            CfgPtr = &XTouchscreen_ConfigTable[i];
        }
    }

    return CfgPtr;
}

/****************************************************************************/
/**
*
* This function reads 2D (X & Y) coordinates from the touchscreen.
*
* @param    InstancePtr is a pointer to the XTouchscreen instance to be 
*           worked on.
* @param    *x pointer to store the x coordinate.
*           *y pointer to store the y coordinate.
*
* @return   None.
*
* @note     None.
*
*****************************************************************************/
void XTouchscreen_GetPosition_2D(XTouchscreen *InstancePtr, Xuint32 *x, 
                                 Xuint32 *y)
{
  *x = XTouchscreen_GetValue(InstancePtr->BaseAddress, 
			     XTOUCHSCREEN_CTRL_CHSEL_X);
  *y = XTouchscreen_GetValue(InstancePtr->BaseAddress, 
			     XTOUCHSCREEN_CTRL_CHSEL_Y);  
}

/****************************************************************************/
/**
*
* This function reads 3D (X, Y & Z) coordinates from the touchscreen. x and 
* y are the actual positions, the pressure has to be calculated from z1 and
* z2
*
* @param    InstancePtr is a pointer to the XTouchscreen instance to be 
*           worked on.
* @param    *x pointer to store the x coordinate.
*           *y pointer to store the y coordinate.
*           *z pointer to store the z coordinate (pressure)
*
* @return   None.
*
* @note     None.
*
*****************************************************************************/
void XTouchscreen_GetPosition_3D(XTouchscreen *InstancePtr, Xuint32 *x,
                                 Xuint32 *y, Xuint32 *z)
{
   Xuint32 z1;
   Xuint32 z2;

   /**x = NORM_FACTOR - XTouchscreen_GetValue(InstancePtr->BaseAddress, 
      XTOUCHSCREEN_CTRL_CHSEL_X);*/
   *x = XTouchscreen_GetValue(InstancePtr->BaseAddress, 
                              XTOUCHSCREEN_CTRL_CHSEL_X);
   *y = XTouchscreen_GetValue(InstancePtr->BaseAddress, 
                              XTOUCHSCREEN_CTRL_CHSEL_Y);

   z1 = XTouchscreen_GetValue(InstancePtr->BaseAddress, 
                              XTOUCHSCREEN_CTRL_CHSEL_Z1);
   z2 = XTouchscreen_GetValue(InstancePtr->BaseAddress, 
                              XTOUCHSCREEN_CTRL_CHSEL_Z2);

   if (z1 == 0)
   {
       *z = XTOUCHSCREEN_SAMPLE_ERROR;
       return;
   }
   else if (z1 > z2)
   {
       *z = XTOUCHSCREEN_SAMPLE_ERROR;
       return;
   }
   else
   {
       *z = ((*x) * (z2/z1 - 1));
   }
}


/****************************************************************************/
/**
*
* This function is a stub handler that is the default handler such that if the
* application has not set the handler when interrupts are enabled, this
* function will be called. The function interface has to match the interface
* specified for a handler even though none of the arguments are used.
*
* @param    CallBackRef is unused by this function.
* @param    Event is unused by this function.
* @param    ByteCount is unused by this function.
*
* @return
*
* None.
*
* @note
*
* None.
*
*****************************************************************************/
static void XTouchscreen_StubHandler (void *CallBackRef, Xuint32 Event,
                                      unsigned int ByteCount)

{
    XASSERT_VOID(XFALSE);
}