Javen Ho / Mbed 2 deprecated FinalProject4180

Bust-a-Beat

Dependencies:   mbed wave_player mbed-rtos 4DGL-uLCD-SE SDFileSystem PinDetect

mpr121.h@2:d4fbe8a6302e, 2022-04-27 (annotated)

Committer:
javenho14
Date:
Wed Apr 27 01:34:47 2022 +0000
Revision:
2:d4fbe8a6302e
Init

Who changed what in which revision?

UserRevisionLine numberNew contents of line
javenho14 2:d4fbe8a6302e 1 /*
javenho14 2:d4fbe8a6302e 2 Copyright (c) 2011 Anthony Buckton (abuckton [at] blackink [dot} net {dot} au)
javenho14 2:d4fbe8a6302e 3
javenho14 2:d4fbe8a6302e 4
javenho14 2:d4fbe8a6302e 5 Permission is hereby granted, free of charge, to any person obtaining a copy
javenho14 2:d4fbe8a6302e 6 of this software and associated documentation files (the "Software"), to deal
javenho14 2:d4fbe8a6302e 7 in the Software without restriction, including without limitation the rights
javenho14 2:d4fbe8a6302e 8 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
javenho14 2:d4fbe8a6302e 9 copies of the Software, and to permit persons to whom the Software is
javenho14 2:d4fbe8a6302e 10 furnished to do so, subject to the following conditions:
javenho14 2:d4fbe8a6302e 11
javenho14 2:d4fbe8a6302e 12 The above copyright notice and this permission notice shall be included in
javenho14 2:d4fbe8a6302e 13 all copies or substantial portions of the Software.
javenho14 2:d4fbe8a6302e 14
javenho14 2:d4fbe8a6302e 15 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
javenho14 2:d4fbe8a6302e 16 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
javenho14 2:d4fbe8a6302e 17 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
javenho14 2:d4fbe8a6302e 18 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
javenho14 2:d4fbe8a6302e 19 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
javenho14 2:d4fbe8a6302e 20 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
javenho14 2:d4fbe8a6302e 21 THE SOFTWARE.
javenho14 2:d4fbe8a6302e 22
javenho14 2:d4fbe8a6302e 23 Parts written by Jim Lindblom of Sparkfun
javenho14 2:d4fbe8a6302e 24 Ported to mbed by A.Buckton, Feb 2011
javenho14 2:d4fbe8a6302e 25 */
javenho14 2:d4fbe8a6302e 26
javenho14 2:d4fbe8a6302e 27 #ifndef MPR121_H
javenho14 2:d4fbe8a6302e 28 #define MPR121_H
javenho14 2:d4fbe8a6302e 29
javenho14 2:d4fbe8a6302e 30 //using namespace std;
javenho14 2:d4fbe8a6302e 31
javenho14 2:d4fbe8a6302e 32 class Mpr121
javenho14 2:d4fbe8a6302e 33 {
javenho14 2:d4fbe8a6302e 34
javenho14 2:d4fbe8a6302e 35 public:
javenho14 2:d4fbe8a6302e 36 // i2c Addresses, bit-shifted
javenho14 2:d4fbe8a6302e 37 enum Address { ADD_VSS = 0xb4,// ADD->VSS = 0x5a <-wiring on Sparkfun board
javenho14 2:d4fbe8a6302e 38 ADD_VDD = 0xb6,// ADD->VDD = 0x5b
javenho14 2:d4fbe8a6302e 39 ADD_SCL = 0xb8,// ADD->SDA = 0x5c
javenho14 2:d4fbe8a6302e 40 ADD_SDA = 0xba // ADD->SCL = 0x5d
javenho14 2:d4fbe8a6302e 41 };
javenho14 2:d4fbe8a6302e 42
javenho14 2:d4fbe8a6302e 43 // Real initialiser, takes the i2c address of the device.
javenho14 2:d4fbe8a6302e 44 Mpr121(I2C *i2c, Address i2cAddress);
javenho14 2:d4fbe8a6302e 45
javenho14 2:d4fbe8a6302e 46 bool getProximityMode();
javenho14 2:d4fbe8a6302e 47
javenho14 2:d4fbe8a6302e 48 void setProximityMode(bool mode);
javenho14 2:d4fbe8a6302e 49
javenho14 2:d4fbe8a6302e 50 int readTouchData();
javenho14 2:d4fbe8a6302e 51
javenho14 2:d4fbe8a6302e 52 unsigned char read(int key);
javenho14 2:d4fbe8a6302e 53
javenho14 2:d4fbe8a6302e 54 int write(int address, unsigned char value);
javenho14 2:d4fbe8a6302e 55 int writeMany(int start, unsigned char* dataSet, int length);
javenho14 2:d4fbe8a6302e 56
javenho14 2:d4fbe8a6302e 57 void setElectrodeThreshold(int electrodeId, unsigned char touchThreshold, unsigned char releaseThreshold);
javenho14 2:d4fbe8a6302e 58
javenho14 2:d4fbe8a6302e 59 protected:
javenho14 2:d4fbe8a6302e 60 // Configures the MPR with standard settings. This is permitted to be overwritten by sub-classes.
javenho14 2:d4fbe8a6302e 61 void configureSettings();
javenho14 2:d4fbe8a6302e 62
javenho14 2:d4fbe8a6302e 63 private:
javenho14 2:d4fbe8a6302e 64 // The I2C bus instance.
javenho14 2:d4fbe8a6302e 65 I2C *i2c;
javenho14 2:d4fbe8a6302e 66
javenho14 2:d4fbe8a6302e 67 // i2c address of this mpr121
javenho14 2:d4fbe8a6302e 68 Address address;
javenho14 2:d4fbe8a6302e 69 };
javenho14 2:d4fbe8a6302e 70
javenho14 2:d4fbe8a6302e 71
javenho14 2:d4fbe8a6302e 72 // MPR121 Register Defines
javenho14 2:d4fbe8a6302e 73 #define MHD_R 0x2B
javenho14 2:d4fbe8a6302e 74 #define NHD_R 0x2C
javenho14 2:d4fbe8a6302e 75 #define NCL_R 0x2D
javenho14 2:d4fbe8a6302e 76 #define FDL_R 0x2E
javenho14 2:d4fbe8a6302e 77 #define MHD_F 0x2F
javenho14 2:d4fbe8a6302e 78 #define NHD_F 0x30
javenho14 2:d4fbe8a6302e 79 #define NCL_F 0x31
javenho14 2:d4fbe8a6302e 80 #define FDL_F 0x32
javenho14 2:d4fbe8a6302e 81 #define NHDT 0x33
javenho14 2:d4fbe8a6302e 82 #define NCLT 0x34
javenho14 2:d4fbe8a6302e 83 #define FDLT 0x35
javenho14 2:d4fbe8a6302e 84 // Proximity sensing controls
javenho14 2:d4fbe8a6302e 85 #define MHDPROXR 0x36
javenho14 2:d4fbe8a6302e 86 #define NHDPROXR 0x37
javenho14 2:d4fbe8a6302e 87 #define NCLPROXR 0x38
javenho14 2:d4fbe8a6302e 88 #define FDLPROXR 0x39
javenho14 2:d4fbe8a6302e 89 #define MHDPROXF 0x3A
javenho14 2:d4fbe8a6302e 90 #define NHDPROXF 0x3B
javenho14 2:d4fbe8a6302e 91 #define NCLPROXF 0x3C
javenho14 2:d4fbe8a6302e 92 #define FDLPROXF 0x3D
javenho14 2:d4fbe8a6302e 93 #define NHDPROXT 0x3E
javenho14 2:d4fbe8a6302e 94 #define NCLPROXT 0x3F
javenho14 2:d4fbe8a6302e 95 #define FDLPROXT 0x40
javenho14 2:d4fbe8a6302e 96 // Electrode Touch/Release thresholds
javenho14 2:d4fbe8a6302e 97 #define ELE0_T 0x41
javenho14 2:d4fbe8a6302e 98 #define ELE0_R 0x42
javenho14 2:d4fbe8a6302e 99 #define ELE1_T 0x43
javenho14 2:d4fbe8a6302e 100 #define ELE1_R 0x44
javenho14 2:d4fbe8a6302e 101 #define ELE2_T 0x45
javenho14 2:d4fbe8a6302e 102 #define ELE2_R 0x46
javenho14 2:d4fbe8a6302e 103 #define ELE3_T 0x47
javenho14 2:d4fbe8a6302e 104 #define ELE3_R 0x48
javenho14 2:d4fbe8a6302e 105 #define ELE4_T 0x49
javenho14 2:d4fbe8a6302e 106 #define ELE4_R 0x4A
javenho14 2:d4fbe8a6302e 107 #define ELE5_T 0x4B
javenho14 2:d4fbe8a6302e 108 #define ELE5_R 0x4C
javenho14 2:d4fbe8a6302e 109 #define ELE6_T 0x4D
javenho14 2:d4fbe8a6302e 110 #define ELE6_R 0x4E
javenho14 2:d4fbe8a6302e 111 #define ELE7_T 0x4F
javenho14 2:d4fbe8a6302e 112 #define ELE7_R 0x50
javenho14 2:d4fbe8a6302e 113 #define ELE8_T 0x51
javenho14 2:d4fbe8a6302e 114 #define ELE8_R 0x52
javenho14 2:d4fbe8a6302e 115 #define ELE9_T 0x53
javenho14 2:d4fbe8a6302e 116 #define ELE9_R 0x54
javenho14 2:d4fbe8a6302e 117 #define ELE10_T 0x55
javenho14 2:d4fbe8a6302e 118 #define ELE10_R 0x56
javenho14 2:d4fbe8a6302e 119 #define ELE11_T 0x57
javenho14 2:d4fbe8a6302e 120 #define ELE11_R 0x58
javenho14 2:d4fbe8a6302e 121 // Proximity Touch/Release thresholds
javenho14 2:d4fbe8a6302e 122 #define EPROXTTH 0x59
javenho14 2:d4fbe8a6302e 123 #define EPROXRTH 0x5A
javenho14 2:d4fbe8a6302e 124 // Debounce configuration
javenho14 2:d4fbe8a6302e 125 #define DEB_CFG 0x5B
javenho14 2:d4fbe8a6302e 126 // AFE- Analogue Front End configuration
javenho14 2:d4fbe8a6302e 127 #define AFE_CFG 0x5C
javenho14 2:d4fbe8a6302e 128 // Filter configuration
javenho14 2:d4fbe8a6302e 129 #define FIL_CFG 0x5D
javenho14 2:d4fbe8a6302e 130 // Electrode configuration - transistions to "active mode"
javenho14 2:d4fbe8a6302e 131 #define ELE_CFG 0x5E
javenho14 2:d4fbe8a6302e 132
javenho14 2:d4fbe8a6302e 133 #define GPIO_CTRL0 0x73
javenho14 2:d4fbe8a6302e 134 #define GPIO_CTRL1 0x74
javenho14 2:d4fbe8a6302e 135 #define GPIO_DATA 0x75
javenho14 2:d4fbe8a6302e 136 #define GPIO_DIR 0x76
javenho14 2:d4fbe8a6302e 137 #define GPIO_EN 0x77
javenho14 2:d4fbe8a6302e 138 #define GPIO_SET 0x78
javenho14 2:d4fbe8a6302e 139 #define GPIO_CLEAR 0x79
javenho14 2:d4fbe8a6302e 140 #define GPIO_TOGGLE 0x7A
javenho14 2:d4fbe8a6302e 141 // Auto configration registers
javenho14 2:d4fbe8a6302e 142 #define AUTO_CFG_0 0x7B
javenho14 2:d4fbe8a6302e 143 #define AUTO_CFG_U 0x7D
javenho14 2:d4fbe8a6302e 144 #define AUTO_CFG_L 0x7E
javenho14 2:d4fbe8a6302e 145 #define AUTO_CFG_T 0x7F
javenho14 2:d4fbe8a6302e 146
javenho14 2:d4fbe8a6302e 147 // Threshold defaults
javenho14 2:d4fbe8a6302e 148 // Electrode touch threshold
javenho14 2:d4fbe8a6302e 149 #define E_THR_T 0x0F
javenho14 2:d4fbe8a6302e 150 // Electrode release threshold
javenho14 2:d4fbe8a6302e 151 #define E_THR_R 0x0A
javenho14 2:d4fbe8a6302e 152 // Prox touch threshold
javenho14 2:d4fbe8a6302e 153 #define PROX_THR_T 0x02
javenho14 2:d4fbe8a6302e 154 // Prox release threshold
javenho14 2:d4fbe8a6302e 155 #define PROX_THR_R 0x02
javenho14 2:d4fbe8a6302e 156
javenho14 2:d4fbe8a6302e 157 #endif