INSAT Mini Project
Dependencies: ST_INTERFACES X_NUCLEO_COMMON
Fork of X_NUCLEO_6180XA1 by
Diff: Components/STMPE1600/Stmpe1600.h
- Revision:
- 57:fa4c622b04a7
- Parent:
- 56:37d1736bd896
- Child:
- 58:1e9a3a46f814
--- a/Components/STMPE1600/Stmpe1600.h Mon Mar 13 17:57:03 2017 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,326 +0,0 @@ -/** - ****************************************************************************** - * @file Stmpe1600.h - * @author AST / EST - * @version V0.0.1 - * @date 14-April-2015 - * @brief Header file for component stmpe1600 - ****************************************************************************** - * @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. - * - ****************************************************************************** -*/ -#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