fsdfsdf
Fork of BSP_DISCO_F469NI by
Diff: Components/ft6x06/ft6x06.c
- Revision:
- 2:123b894b49dd
- Parent:
- 1:9e4eb47092ed
diff -r 9e4eb47092ed -r 123b894b49dd Components/ft6x06/ft6x06.c --- a/Components/ft6x06/ft6x06.c Mon May 30 11:09:05 2016 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,516 +0,0 @@ -/** - ****************************************************************************** - * @file ft6x06.c - * @author MCD Application Team - * @version V1.0.0 - * @date 03-August-2015 - * @brief This file provides a set of functions needed to manage the FT6X06 - * IO Expander devices. - ****************************************************************************** - * @attention - * - * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2> - * - * Redistribution and use in source and binary forms, with or without modification, - * are permitted provided that the following conditions are met: - * 1. Redistributions of source code must retain the above copyright notice, - * this list of conditions and the following disclaimer. - * 2. Redistributions in binary form must reproduce the above copyright notice, - * this list of conditions and the following disclaimer in the documentation - * and/or other materials provided with the distribution. - * 3. Neither the name of STMicroelectronics nor the names of its contributors - * may be used to endorse or promote products derived from this software - * without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" - * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE - * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE - * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL - * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR - * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - * - ****************************************************************************** - */ - -/* Includes ------------------------------------------------------------------*/ -#include "ft6x06.h" - -/** @addtogroup BSP - * @{ - */ - -/** @addtogroup Component - * @{ - */ - -/** @defgroup FT6X06 - * @{ - */ - -/* Private typedef -----------------------------------------------------------*/ - -/** @defgroup FT6X06_Private_Defines FT6X06 Private Defines - * @{ - */ -#define FT6x06_MAX_INSTANCE 2 -/** - * @} - */ - -/* Private macro -------------------------------------------------------------*/ - -/** @defgroup FT6X06_Private_Variables FT6X06 Private Variables - * @{ - */ - -/* Touch screen driver structure initialization */ -TS_DrvTypeDef ft6x06_ts_drv = -{ - ft6x06_Init, - ft6x06_ReadID, - ft6x06_Reset, - - ft6x06_TS_Start, - ft6x06_TS_DetectTouch, - ft6x06_TS_GetXY, - - ft6x06_TS_EnableIT, - ft6x06_TS_ClearIT, - ft6x06_TS_ITStatus, - ft6x06_TS_DisableIT - -}; - -/* ft6x06 instances by address */ -uint8_t ft6x06[FT6x06_MAX_INSTANCE] = {0}; - -/* Global ft6x06 handle */ -static ft6x06_handle_TypeDef ft6x06_handle = { FT6206_I2C_NOT_INITIALIZED, 0, 0}; - -/** - * @} - */ - -/** @defgroup ft6x06_Private_Function_Prototypes ft6x06 Private Function Prototypes - * @{ - */ -static uint8_t ft6x06_GetInstance(uint16_t DeviceAddr); -/* Private functions prototypes-----------------------------------------------*/ -#if (TS_AUTO_CALIBRATION_SUPPORTED == 1) -/** - * @brief Start TouchScreen calibration phase - * @param DeviceAddr: FT6206 Device address for communication on I2C Bus. - * @retval Status FT6206_STATUS_OK or FT6206_STATUS_NOT_OK. - */ -static uint32_t ft6x06_TS_Calibration(uint16_t DeviceAddr); -#endif /* TS_AUTO_CALIBRATION_SUPPORTED == 1 */ - -/** - * @brief Basic static configuration of TouchScreen - * @param DeviceAddr: FT6206 Device address for communication on I2C Bus. - * @retval Status FT6206_STATUS_OK or FT6206_STATUS_NOT_OK. - */ -static uint32_t ft6x06_TS_Configure(uint16_t DeviceAddr); - -/** - * @} - */ - -/** @defgroup ft6x06_Private_Functions ft6x06 Private Functions - * @{ - */ - -/** - * @brief Initialize the ft6x06 communication bus - * from MCU to FT6206 : ie I2C channel initialization (if required). - * @param DeviceAddr: Device address on communication Bus (I2C slave address of FT6206). - * @retval None - */ -void ft6x06_Init(uint16_t DeviceAddr) -{ - uint8_t instance; - uint8_t empty; - - /* Check if device instance already exists */ - instance = ft6x06_GetInstance(DeviceAddr); - - /* To prevent double initialization */ - if(instance == 0xFF) - { - /* Look for empty instance */ - empty = ft6x06_GetInstance(0); - - if(empty < FT6x06_MAX_INSTANCE) - { - /* Register the current device instance */ - ft6x06[empty] = DeviceAddr; - - /* Initialize IO BUS layer */ - TS_IO_Init(); - } - } -} - -/** - * @brief Software Reset the ft6x06. - * @note : Not applicable to FT6206. - * @param DeviceAddr: Device address on communication Bus (I2C slave address of FT6206). - * @retval None - */ -void ft6x06_Reset(uint16_t DeviceAddr) -{ - /* Do nothing */ - /* No software reset sequence available in FT6206 IC */ -} - -/** - * @brief Read the ft6x06 device ID, pre initialize I2C in case of need to be - * able to read the FT6206 device ID, and verify this is a FT6206. - * @param DeviceAddr: I2C FT6x06 Slave address. - * @retval The Device ID (two bytes). - */ -uint16_t ft6x06_ReadID(uint16_t DeviceAddr) -{ - /* Initialize I2C link if needed */ - TS_IO_Init(); - - /* Return the device ID value */ - return (TS_IO_Read(DeviceAddr, FT6206_CHIP_ID_REG)); -} - -/** - * @brief Configures the touch Screen IC device to start detecting touches - * It goes through an internal calibration process (Hw calibration sequence of - * the touch screen). - * @param DeviceAddr: Device address on communication Bus (I2C slave address). - * @retval None. - */ -void ft6x06_TS_Start(uint16_t DeviceAddr) -{ -#if (TS_AUTO_CALIBRATION_SUPPORTED == 1) - /* Hw Calibration sequence start : should be done once after each power up */ - /* This is called internal calibration of the touch screen */ - ft6x06_TS_Calibration(DeviceAddr); -#endif - /* Minimum static configuration of FT6206 */ - ft6x06_TS_Configure(DeviceAddr); - - /* By default set FT6206 IC in Polling mode : no INT generation on FT6206 for new touch available */ - /* Note TS_INT is active low */ - ft6x06_TS_DisableIT(DeviceAddr); -} - -/** - * @brief Return if there is touches detected or not. - * Try to detect new touches and forget the old ones (reset internal global - * variables). - * @param DeviceAddr: Device address on communication Bus. - * @retval : Number of active touches detected (can be 0, 1 or 2). - */ -uint8_t ft6x06_TS_DetectTouch(uint16_t DeviceAddr) -{ - volatile uint8_t nbTouch = 0; - - /* Read register FT6206_TD_STAT_REG to check number of touches detection */ - nbTouch = TS_IO_Read(DeviceAddr, FT6206_TD_STAT_REG); - nbTouch &= FT6206_TD_STAT_MASK; - - if(nbTouch > FT6206_MAX_DETECTABLE_TOUCH) - { - /* If invalid number of touch detected, set it to zero */ - nbTouch = 0; - } - - /* Update ft6x06 driver internal global : current number of active touches */ - ft6x06_handle.currActiveTouchNb = nbTouch; - - /* Reset current active touch index on which to work on */ - ft6x06_handle.currActiveTouchIdx = 0; - - return(nbTouch); -} - -/** - * @brief Get the touch screen X and Y positions values - * Manage multi touch thanks to touch Index global - * variable 'ft6x06_handle.currActiveTouchIdx'. - * @param DeviceAddr: Device address on communication Bus. - * @param X: Pointer to X position value - * @param Y: Pointer to Y position value - * @retval None. - */ -void ft6x06_TS_GetXY(uint16_t DeviceAddr, uint16_t *X, uint16_t *Y) -{ - uint8_t regAddress = 0; - uint8_t dataxy[4]; - - if(ft6x06_handle.currActiveTouchIdx < ft6x06_handle.currActiveTouchNb) - { - switch(ft6x06_handle.currActiveTouchIdx) - { - case 0 : - regAddress = FT6206_P1_XH_REG; - break; - case 1 : - regAddress = FT6206_P2_XH_REG; - break; - - default : - break; - } - - /* Read X and Y positions */ - TS_IO_ReadMultiple(DeviceAddr, regAddress, dataxy, sizeof(dataxy)); - - /* Send back ready X position to caller */ - *X = ((dataxy[0] & FT6206_MSB_MASK) << 8) | (dataxy[1] & FT6206_LSB_MASK); - - /* Send back ready Y position to caller */ - *Y = ((dataxy[2] & FT6206_MSB_MASK) << 8) | (dataxy[3] & FT6206_LSB_MASK); - - ft6x06_handle.currActiveTouchIdx++; - } -} - -/** - * @brief Configure the FT6206 device to generate IT on given INT pin - * connected to MCU as EXTI. - * @param DeviceAddr: Device address on communication Bus (Slave I2C address of FT6206). - * @retval None - */ -void ft6x06_TS_EnableIT(uint16_t DeviceAddr) -{ - uint8_t regValue = 0; - regValue = (FT6206_G_MODE_INTERRUPT_TRIGGER & (FT6206_G_MODE_INTERRUPT_MASK >> FT6206_G_MODE_INTERRUPT_SHIFT)) << FT6206_G_MODE_INTERRUPT_SHIFT; - - /* Set interrupt trigger mode in FT6206_GMODE_REG */ - TS_IO_Write(DeviceAddr, FT6206_GMODE_REG, regValue); -} - -/** - * @brief Configure the FT6206 device to stop generating IT on the given INT pin - * connected to MCU as EXTI. - * @param DeviceAddr: Device address on communication Bus (Slave I2C address of FT6206). - * @retval None - */ -void ft6x06_TS_DisableIT(uint16_t DeviceAddr) -{ - uint8_t regValue = 0; - regValue = (FT6206_G_MODE_INTERRUPT_POLLING & (FT6206_G_MODE_INTERRUPT_MASK >> FT6206_G_MODE_INTERRUPT_SHIFT)) << FT6206_G_MODE_INTERRUPT_SHIFT; - - /* Set interrupt polling mode in FT6206_GMODE_REG */ - TS_IO_Write(DeviceAddr, FT6206_GMODE_REG, regValue); -} - -/** - * @brief Get IT status from FT6206 interrupt status registers - * Should be called Following an EXTI coming to the MCU to know the detailed - * reason of the interrupt. - * @note : This feature is not applicable to FT6206. - * @param DeviceAddr: Device address on communication Bus (I2C slave address of FT6206). - * @retval TS interrupts status : always return 0 here - */ -uint8_t ft6x06_TS_ITStatus(uint16_t DeviceAddr) -{ - /* Always return 0 as feature not applicable to FT6206 */ - return 0; -} - -/** - * @brief Clear IT status in FT6206 interrupt status clear registers - * Should be called Following an EXTI coming to the MCU. - * @note : This feature is not applicable to FT6206. - * @param DeviceAddr: Device address on communication Bus (I2C slave address of FT6206). - * @retval None - */ -void ft6x06_TS_ClearIT(uint16_t DeviceAddr) -{ - /* Nothing to be done here for FT6206 */ -} - -/**** NEW FEATURES enabled when Multi-touch support is enabled ****/ - -#if (TS_MULTI_TOUCH_SUPPORTED == 1) - -/** - * @brief Get the last touch gesture identification (zoom, move up/down...). - * @param DeviceAddr: Device address on communication Bus (I2C slave address of FT6x06). - * @param pGestureId : Pointer to get last touch gesture Identification. - * @retval None. - */ -void ft6x06_TS_GetGestureID(uint16_t DeviceAddr, uint32_t * pGestureId) -{ - volatile uint8_t ucReadData = 0; - - ucReadData = TS_IO_Read(DeviceAddr, FT6206_GEST_ID_REG); - - * pGestureId = ucReadData; -} - -/** - * @brief Get the touch detailed informations on touch number 'touchIdx' (0..1) - * This touch detailed information contains : - * - weight that was applied to this touch - * - sub-area of the touch in the touch panel - * - event of linked to the touch (press down, lift up, ...) - * @param DeviceAddr: Device address on communication Bus (I2C slave address of FT6x06). - * @param touchIdx : Passed index of the touch (0..1) on which we want to get the - * detailed information. - * @param pWeight : Pointer to to get the weight information of 'touchIdx'. - * @param pArea : Pointer to to get the sub-area information of 'touchIdx'. - * @param pEvent : Pointer to to get the event information of 'touchIdx'. - - * @retval None. - */ -void ft6x06_TS_GetTouchInfo(uint16_t DeviceAddr, - uint32_t touchIdx, - uint32_t * pWeight, - uint32_t * pArea, - uint32_t * pEvent) -{ - uint8_t regAddress = 0; - uint8_t dataxy[3]; - - if(touchIdx < ft6x06_handle.currActiveTouchNb) - { - switch(touchIdx) - { - case 0 : - regAddress = FT6206_P1_WEIGHT_REG; - break; - - case 1 : - regAddress = FT6206_P2_WEIGHT_REG; - break; - - default : - break; - - } /* end switch(touchIdx) */ - - /* Read weight, area and Event Id of touch index */ - TS_IO_ReadMultiple(DeviceAddr, regAddress, dataxy, sizeof(dataxy)); - - /* Return weight of touch index */ - * pWeight = (dataxy[0] & FT6206_TOUCH_WEIGHT_MASK) >> FT6206_TOUCH_WEIGHT_SHIFT; - /* Return area of touch index */ - * pArea = (dataxy[1] & FT6206_TOUCH_AREA_MASK) >> FT6206_TOUCH_AREA_SHIFT; - /* Return Event Id of touch index */ - * pEvent = (dataxy[2] & FT6206_TOUCH_EVT_FLAG_MASK) >> FT6206_TOUCH_EVT_FLAG_SHIFT; - - } /* of if(touchIdx < ft6x06_handle.currActiveTouchNb) */ -} - -#endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ - -#if (TS_AUTO_CALIBRATION_SUPPORTED == 1) -/** - * @brief Start TouchScreen calibration phase - * @param DeviceAddr: FT6206 Device address for communication on I2C Bus. - * @retval Status FT6206_STATUS_OK or FT6206_STATUS_NOT_OK. - */ -static uint32_t ft6x06_TS_Calibration(uint16_t DeviceAddr) -{ - uint32_t nbAttempt = 0; - volatile uint8_t ucReadData; - volatile uint8_t regValue; - uint32_t status = FT6206_STATUS_OK; - uint8_t bEndCalibration = 0; - - /* >> Calibration sequence start */ - - /* Switch FT6206 back to factory mode to calibrate */ - regValue = (FT6206_DEV_MODE_FACTORY & FT6206_DEV_MODE_MASK) << FT6206_DEV_MODE_SHIFT; - TS_IO_Write(DeviceAddr, FT6206_DEV_MODE_REG, regValue); /* 0x40 */ - - /* Read back the same register FT6206_DEV_MODE_REG */ - ucReadData = TS_IO_Read(DeviceAddr, FT6206_DEV_MODE_REG); - TS_IO_Delay(300); /* Wait 300 ms */ - - if(((ucReadData & (FT6206_DEV_MODE_MASK << FT6206_DEV_MODE_SHIFT)) >> FT6206_DEV_MODE_SHIFT) != FT6206_DEV_MODE_FACTORY ) - { - /* Return error to caller */ - return(FT6206_STATUS_NOT_OK); - } - - /* Start calibration command */ - TS_IO_Write(DeviceAddr, FT6206_TD_STAT_REG, 0x04); - TS_IO_Delay(300); /* Wait 300 ms */ - - /* 100 attempts to wait switch from factory mode (calibration) to working mode */ - for (nbAttempt=0; ((nbAttempt < 100) && (!bEndCalibration)) ; nbAttempt++) - { - ucReadData = TS_IO_Read(DeviceAddr, FT6206_DEV_MODE_REG); - ucReadData = (ucReadData & (FT6206_DEV_MODE_MASK << FT6206_DEV_MODE_SHIFT)) >> FT6206_DEV_MODE_SHIFT; - if(ucReadData == FT6206_DEV_MODE_WORKING) - { - /* Auto Switch to FT6206_DEV_MODE_WORKING : means calibration have ended */ - bEndCalibration = 1; /* exit for loop */ - } - - TS_IO_Delay(200); /* Wait 200 ms */ - } - - /* Calibration sequence end << */ - - return(status); -} -#endif /* TS_AUTO_CALIBRATION_SUPPORTED == 1 */ - -/** - * @brief Basic static configuration of TouchScreen - * @param DeviceAddr: FT6206 Device address for communication on I2C Bus. - * @retval Status FT6206_STATUS_OK or FT6206_STATUS_NOT_OK. - */ -static uint32_t ft6x06_TS_Configure(uint16_t DeviceAddr) -{ - uint32_t status = FT6206_STATUS_OK; - - /* Nothing special to be done for FT6206 */ - - return(status); -} - -/** - * @brief Check if the device instance of the selected address is already registered - * and return its index - * @param DeviceAddr: Device address on communication Bus. - * @retval Index of the device instance if registered, 0xFF if not. - */ -static uint8_t ft6x06_GetInstance(uint16_t DeviceAddr) -{ - uint8_t idx = 0; - - /* Check all the registered instances */ - for(idx = 0; idx < FT6x06_MAX_INSTANCE ; idx ++) - { - if(ft6x06[idx] == DeviceAddr) - { - return idx; - } - } - - return 0xFF; -} - -/** - * @} - */ - -/** - * @} - */ - -/** - * @} - */ - -/** - * @} - */ - -/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/