Diff: Components/STMPE1600/Stmpe1600.h

Revision:

56:37d1736bd896

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Components/STMPE1600/Stmpe1600.h	Mon Mar 13 17:57:03 2017 +0100
@@ -0,0 +1,326 @@
+/**
+ ******************************************************************************
+ * @file    Stmpe1600.h
+ * @author  AST / EST
+ * @version V0.0.1
+ * @date    14-April-2015
+ * @brief   Header file for component stmpe1600
+ ******************************************************************************
+ * @attention
+ *
+ * <h2><center>&copy; 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.
+ *
+ ******************************************************************************
+*/
+#ifndef __Stmpe1600_CLASS
+#define __Stmpe1600_CLASS
+/* Includes ------------------------------------------------------------------*/
+#include    "DevI2C.h"
+
+#define STMPE1600_DEF_DEVICE_ADDRESS  (uint8_t)0x42*2   
+#define STMPE1600_DEF_DIGIOUT_LVL      1
+
+/**  Stmpe1600 registr map **/
+#define ChipID_0_7      (uint8_t)0x00
+#define ChipID_8_15     (uint8_t)0x01
+#define VersionId       (uint8_t)0x02
+#define SYS_CTRL        (uint8_t)0x03
+#define IEGPIOR_0_7	    (uint8_t)0x08
+#define IEGPIOR_8_15	  (uint8_t)0x09
+#define ISGPIOR_0_7	    (uint8_t)0x0A
+#define ISGPIOR_8_15	  (uint8_t)0x0B
+#define GPMR_0_7	      (uint8_t)0x10
+#define GPMR_8_15	      (uint8_t)0x11
+#define GPSR_0_7	      (uint8_t)0x12
+#define GPSR_8_15	      (uint8_t)0x13
+#define GPDR_0_7	      (uint8_t)0x14
+#define GPDR_8_15	      (uint8_t)0x15
+#define GPIR_0_7	      (uint8_t)0x16
+#define GPIR_8_15	      (uint8_t)0x17
+
+#define SOFT_RESET			(uint8_t)0x80
+
+typedef enum {
+    // GPIO Expander pin names
+    GPIO_0=0,
+    GPIO_1,
+    GPIO_2,
+    GPIO_3,            
+    GPIO_4,
+    GPIO_5,
+    GPIO_6,
+    GPIO_7,            
+    GPIO_8,
+    GPIO_9,
+    GPIO_10,
+    GPIO_11,            
+    GPIO_12,
+    GPIO_13,
+    GPIO_14,
+    GPIO_15,
+	  NOT_CON
+} exp_gpio_pin_name;   
+
+typedef enum {
+    INPUT = 0,
+    OUTPUT,
+    NOT_CONNECTED
+} exp_gpio_pin_direction;
+
+
+/* Classes -------------------------------------------------------------------*/
+
+/**
+ * Class representing a single stmpe1600 GPIO expander output pin
+ */
+class Stmpe1600DigiOut {
+public: 
+    /** Constructor
+     * @param[in] &i2c device I2C to be used for communication
+     * @param[in] outpinname the desired out pin name to be created
+     * @param[in] DevAddr the stmpe1600 I2C device addres (deft STMPE1600_DEF_DEVICE_ADDRESS)
+     * @param[in] lvl the default ot pin level  
+     */ 
+    Stmpe1600DigiOut (DevI2C &i2c, ExpGpioPinName outpinname, uint8_t DevAddr=STMPE1600_DEF_DEVICE_ADDRESS, bool lvl=STMPE1600_DEF_DIGIOUT_LVL):
+    _dev_i2c(i2c),
+    _expdevaddr(DevAddr),
+    _exppinname(outpinname) 
+    {
+        uint8_t data[2];				
+        if (_exppinname == NOT_CON) {
+            return;
+        }
+        /* set the _exppinname as output */
+        _dev_i2c.i2c_read(data, _expdevaddr, GPDR_0_7, 1);
+        _dev_i2c.i2c_read(&data[1], _expdevaddr, GPDR_8_15, 1);			
+        *(uint16_t*)data = *(uint16_t*)data | (1<<(uint16_t)_exppinname);  // set gpio as out 			
+        _dev_i2c.i2c_write(data, _expdevaddr, GPDR_0_7, 1);
+        _dev_i2c.i2c_write(&data[1], _expdevaddr, GPDR_8_15, 1);			
+        write (lvl);
+    }   
+
+  	/**
+  	 * @brief       Write on the out pin
+  	 * @param[in]   lvl level to write
+  	 * @return      0 on Success
+  	 */			
+    void write (int lvl) 
+    {
+        uint8_t data[2];			
+			  if (_exppinname == NOT_CON) return;			
+        /* set the _exppinname state to lvl */
+        _dev_i2c.i2c_read(data, _expdevaddr, GPSR_0_7, 2);
+        *(uint16_t*)data = *(uint16_t*)data & (uint16_t)(~(1<<(uint16_t)_exppinname));  // set pin mask 			
+        if (lvl) *(uint16_t*)data = *(uint16_t*)data | (uint16_t)(1<<(uint16_t)_exppinname);
+        _dev_i2c.i2c_write(data, _expdevaddr, GPSR_0_7, 2);
+    }
+
+  	/**
+  	 * @brief       Overload assignement operator
+  	 */					
+    Stmpe1600DigiOut& operator=(int lvl)
+    {
+        write (lvl);
+        return *this;
+    }		
+		
+private:
+    DevI2C &_dev_i2c;
+    uint8_t _expdevaddr;
+    ExpGpioPinName _exppinname; 	
+};
+
+/* Classes -------------------------------------------------------------------*/
+/** Class representing a single stmpe1600 GPIO expander input pin
+ */
+class Stmpe1600DigiIn 
+{	
+public:
+    /** Constructor
+     * @param[in] &i2c device I2C to be used for communication
+     * @param[in] inpinname the desired input pin name to be created
+     * @param[in] DevAddr the stmpe1600 I2C device addres (deft STMPE1600_DEF_DEVICE_ADDRESS)
+     */ 
+    Stmpe1600DigiIn (DevI2C &i2c, ExpGpioPinName inpinname, uint8_t DevAddr=STMPE1600_DEF_DEVICE_ADDRESS): _dev_i2c(i2c), _expdevaddr(DevAddr), _exppinname(inpinname) 
+    {
+        uint8_t data[2];
+        if (_exppinname == NOT_CON) return;			
+        /* set the _exppinname as input pin direction */
+        _dev_i2c.i2c_read(data, _expdevaddr, GPDR_0_7, 2);
+        *(uint16_t*)data = *(uint16_t*)data & (uint16_t)(~(1<<(uint16_t) _exppinname));  // set gpio as in			
+        _dev_i2c.i2c_write(data, _expdevaddr, GPDR_0_7, 2);
+    }         
+
+  	/**
+  	 * @brief       Read the input pin
+  	 * @return      The pin logical state 0 or 1
+  	 */			
+    bool read () {
+        uint8_t data[2];
+        if (_exppinname == NOT_CON) {
+            return 0;						
+        }
+
+        /* read the _exppinname */
+        _dev_i2c.i2c_read(data, _expdevaddr, GPMR_0_7, 2);
+        *(uint16_t*)data = *(uint16_t*)data & (uint16_t)(1<<(uint16_t)_exppinname);  // mask the in gpio
+
+        if (data[0] || data[1]) {
+            return 1;
+        }
+        return 0;
+    }
+		
+    operator int() {		
+        return read();
+    }		
+		
+private:
+    DevI2C &_dev_i2c; 
+    uint8_t _expdevaddr;
+    ExpGpioPinName _exppinname;      
+};
+
+
+/* Classes -------------------------------------------------------------------*/
+
+/**
+ * Class representing a whole stmpe1600 component (16 gpio)
+ */
+class Stmpe1600 {
+public: 
+    /** Constructor
+    * @param[in] &i2c device I2C to be used for communication
+    * @param[in] DevAddr the stmpe1600 I2C device addres (deft STMPE1600_DEF_DEVICE_ADDRESS)
+    */ 
+    Stmpe1600 (DevI2C &i2c, uint8_t DevAddr=STMPE1600_DEF_DEVICE_ADDRESS ) : _dev_i2c(i2c)
+    { 
+        _dev_i2c = i2c;								
+        _expdevaddr = DevAddr;
+        write_sys_ctrl (SOFT_RESET);
+			
+        _gpdro_15 = (uint16_t)0;	// gpio dir all IN
+        _write_16_bit_reg (GPDR_0_7, &_gpdro_15);			
+        _gpsro_15 = (uint16_t)0x0ffff;  // gpio status all 1
+        _write_16_bit_reg (GPSR_0_7, &_gpsro_15);			
+    }
+
+  	/**
+  	 * @brief       Write the SYS_CTRL register 
+  	 * @param[in]   Data to be written (bit fields)
+  	 */		
+    void write_sys_ctrl (uint8_t data)     // data = SOFT_RESET reset the device
+    {
+        _dev_i2c.i2c_write((uint8_t*)SYS_CTRL, _expdevaddr, data, 1);
+    }
+      
+  	/**
+  	 * @brief       Set the out pin
+  	 * @param[in]   The pin name
+  	 * @return      0 on Success
+  	 */			
+  	bool set_gpio (ExpGpioPinName pin_name) 
+  	{
+  		  if (pin_name == NOT_CON) return true;			
+  		  _gpsro_15 = _gpsro_15 | ((uint16_t)0x0001<<pin_name);
+  		  _write_16_bit_reg (GPSR_0_7 , &_gpsro_15);
+  		  return false;
+  	}
+  	
+  	/**
+  	 * @brief       Clear the out pin
+  	 * @param[in]   The pin name
+  	 * @return      0 on Success
+  	 */			
+  	bool clr_gpio (ExpGpioPinName pin_name) 
+  	{
+  		  if (pin_name == NOT_CON) return true;			
+  		  _gpsro_15 = _gpsro_15 & (~((uint16_t)0x0001<<pin_name));
+  		   (GPSR_0_7 , &_gpsro_15);
+  		  return false;
+  	}		
+  	
+  	/**
+  	 * @brief       Read the input pin
+  	 * @param[in]   The pin name
+  	 * @return      The logical pin level
+  	 */					
+  	bool rd_gpio (ExpGpioPinName pin_name) 
+  	{				
+  		  uint16_t gpmr0_15;
+  		  if (pin_name == NOT_CON) return true;
+  		  _read_16_bit_reg (GPMR_0_7, &gpmr0_15);
+  		  gpmr0_15 = gpmr0_15 & ((uint16_t)0x0001<<pin_name);
+  		  if (gpmr0_15) {
+            return true;
+        }
+  		  return false;			
+  	}
+	
+  	/**
+  	 * @brief       Set the pin direction
+  	 * @param[in]   The pin name
+  	 * @param[in]   The pin direction	 
+  	 * @return      0 on success
+  	 */
+  	bool _set_gpio_dir (ExpGpioPinName pin_name, exp_gpio_pin_direction pin_dir) 
+  	{
+        if (pin_name == NOT_CON || pin_dir == NOT_CONNECTED) {
+            return true;
+        }
+        _gpdro_15 = _gpdro_15 & (~((uint16_t)0x0001<<pin_name));  // clear the Pin
+        _gpdro_15 = _gpdro_15 | ((uint16_t)pin_dir<<pin_name);
+        _write_16_bit_reg (GPDR_0_7 , &_gpdro_15);
+        return false;
+  	}
+
+  	/**
+  	 * @brief       Read a 16 bits register
+  	 * @param[in]   The register address
+  	 * @param[in]   The pointer to the read data
+  	 */					
+    void _read_16_bit_reg (uint8_t reg_16_addr, uint16_t *reg_16_data)
+    {
+        _dev_i2c.i2c_read((uint8_t*)reg_16_data, _expdevaddr, reg_16_addr, 2);	
+    }				
+
+  	/**
+  	 * @brief       Write a 16 bits register
+  	 * @param[in]   The register address
+  	 * @param[in]   The pointer to the data to be written
+  	 */							
+    void _write_16_bit_reg (uint8_t reg_16_addr, uint16_t *reg_16_data)
+    {
+        _dev_i2c.i2c_write((uint8_t*)reg_16_data, _expdevaddr, reg_16_addr, 2);	
+    }		
+
+private:					
+    DevI2C &_dev_i2c; 	 
+    uint16_t _gpdro_15;   // local copy of bit direction reg 
+    uint16_t _gpsro_15;   // local copy of bit status reg 
+    uint8_t _expdevaddr; // expander device i2c addr
+};
+
+#endif // __Stmpe1600_CLASS