Payman Shabbaki / Mbed 2 deprecated 4180Project

4180 Final Project

Dependencies:   4DGL-uLCD-SE mbed Servo

mpr121.cpp@27:2bd737c0a8af, 2016-05-01 (annotated)

Committer:
ecarrick
Date:
Sun May 01 19:54:20 2016 +0000
Revision:
27:2bd737c0a8af
Parent:
7:52b51f507ee5 
some small fixes and adding comments

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbedTrent 7:52b51f507ee5 1 /*
mbedTrent 7:52b51f507ee5 2 Copyright (c) 2011 Anthony Buckton (abuckton [at] blackink [dot} net {dot} au)
mbedTrent 7:52b51f507ee5 3
mbedTrent 7:52b51f507ee5 4 Permission is hereby granted, free of charge, to any person obtaining a copy
mbedTrent 7:52b51f507ee5 5 of this software and associated documentation files (the "Software"), to deal
mbedTrent 7:52b51f507ee5 6 in the Software without restriction, including without limitation the rights
mbedTrent 7:52b51f507ee5 7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
mbedTrent 7:52b51f507ee5 8 copies of the Software, and to permit persons to whom the Software is
mbedTrent 7:52b51f507ee5 9 furnished to do so, subject to the following conditions:
mbedTrent 7:52b51f507ee5 10
mbedTrent 7:52b51f507ee5 11 The above copyright notice and this permission notice shall be included in
mbedTrent 7:52b51f507ee5 12 all copies or substantial portions of the Software.
mbedTrent 7:52b51f507ee5 13
mbedTrent 7:52b51f507ee5 14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
mbedTrent 7:52b51f507ee5 15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
mbedTrent 7:52b51f507ee5 16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
mbedTrent 7:52b51f507ee5 17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
mbedTrent 7:52b51f507ee5 18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
mbedTrent 7:52b51f507ee5 19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
mbedTrent 7:52b51f507ee5 20 THE SOFTWARE.
mbedTrent 7:52b51f507ee5 21 */
mbedTrent 7:52b51f507ee5 22
mbedTrent 7:52b51f507ee5 23 #include <mbed.h>
mbedTrent 7:52b51f507ee5 24 #include <sstream>
mbedTrent 7:52b51f507ee5 25 #include <string>
mbedTrent 7:52b51f507ee5 26 #include <list>
mbedTrent 7:52b51f507ee5 27
mbedTrent 7:52b51f507ee5 28 #include <mpr121.h>
mbedTrent 7:52b51f507ee5 29
mbedTrent 7:52b51f507ee5 30 Mpr121::Mpr121(I2C *i2c, Address i2cAddress)
mbedTrent 7:52b51f507ee5 31 {
mbedTrent 7:52b51f507ee5 32 this->i2c = i2c;
mbedTrent 7:52b51f507ee5 33
mbedTrent 7:52b51f507ee5 34 address = i2cAddress;
mbedTrent 7:52b51f507ee5 35
mbedTrent 7:52b51f507ee5 36 // Configure the MPR121 settings to default
mbedTrent 7:52b51f507ee5 37 this->configureSettings();
mbedTrent 7:52b51f507ee5 38 }
mbedTrent 7:52b51f507ee5 39
mbedTrent 7:52b51f507ee5 40
mbedTrent 7:52b51f507ee5 41 void Mpr121::configureSettings()
mbedTrent 7:52b51f507ee5 42 {
mbedTrent 7:52b51f507ee5 43 // Put the MPR into setup mode
mbedTrent 7:52b51f507ee5 44 this->write(ELE_CFG,0x00);
mbedTrent 7:52b51f507ee5 45
mbedTrent 7:52b51f507ee5 46 // Electrode filters for when data is > baseline
mbedTrent 7:52b51f507ee5 47 unsigned char gtBaseline[] = {
mbedTrent 7:52b51f507ee5 48 0x01, //MHD_R
mbedTrent 7:52b51f507ee5 49 0x01, //NHD_R
mbedTrent 7:52b51f507ee5 50 0x00, //NCL_R
mbedTrent 7:52b51f507ee5 51 0x00 //FDL_R
mbedTrent 7:52b51f507ee5 52 };
mbedTrent 7:52b51f507ee5 53
mbedTrent 7:52b51f507ee5 54 writeMany(MHD_R,gtBaseline,4);
mbedTrent 7:52b51f507ee5 55
mbedTrent 7:52b51f507ee5 56 // Electrode filters for when data is < baseline
mbedTrent 7:52b51f507ee5 57 unsigned char ltBaseline[] = {
mbedTrent 7:52b51f507ee5 58 0x01, //MHD_F
mbedTrent 7:52b51f507ee5 59 0x01, //NHD_F
mbedTrent 7:52b51f507ee5 60 0xFF, //NCL_F
mbedTrent 7:52b51f507ee5 61 0x02 //FDL_F
mbedTrent 7:52b51f507ee5 62 };
mbedTrent 7:52b51f507ee5 63
mbedTrent 7:52b51f507ee5 64 writeMany(MHD_F,ltBaseline,4);
mbedTrent 7:52b51f507ee5 65
mbedTrent 7:52b51f507ee5 66 // Electrode touch and release thresholds
mbedTrent 7:52b51f507ee5 67 unsigned char electrodeThresholds[] = {
mbedTrent 7:52b51f507ee5 68 E_THR_T, // Touch Threshhold
mbedTrent 7:52b51f507ee5 69 E_THR_R // Release Threshold
mbedTrent 7:52b51f507ee5 70 };
mbedTrent 7:52b51f507ee5 71
mbedTrent 7:52b51f507ee5 72 for(int i=0; i<12; i++){
mbedTrent 7:52b51f507ee5 73 int result = writeMany((ELE0_T+(i*2)),electrodeThresholds,2);
mbedTrent 7:52b51f507ee5 74 }
mbedTrent 7:52b51f507ee5 75
mbedTrent 7:52b51f507ee5 76 // Proximity Settings
mbedTrent 7:52b51f507ee5 77 unsigned char proximitySettings[] = {
mbedTrent 7:52b51f507ee5 78 0xff, //MHD_Prox_R
mbedTrent 7:52b51f507ee5 79 0xff, //NHD_Prox_R
mbedTrent 7:52b51f507ee5 80 0x00, //NCL_Prox_R
mbedTrent 7:52b51f507ee5 81 0x00, //FDL_Prox_R
mbedTrent 7:52b51f507ee5 82 0x01, //MHD_Prox_F
mbedTrent 7:52b51f507ee5 83 0x01, //NHD_Prox_F
mbedTrent 7:52b51f507ee5 84 0xFF, //NCL_Prox_F
mbedTrent 7:52b51f507ee5 85 0xff, //FDL_Prox_F
mbedTrent 7:52b51f507ee5 86 0x00, //NHD_Prox_T
mbedTrent 7:52b51f507ee5 87 0x00, //NCL_Prox_T
mbedTrent 7:52b51f507ee5 88 0x00 //NFD_Prox_T
mbedTrent 7:52b51f507ee5 89 };
mbedTrent 7:52b51f507ee5 90 writeMany(MHDPROXR,proximitySettings,11);
mbedTrent 7:52b51f507ee5 91
mbedTrent 7:52b51f507ee5 92 unsigned char proxThresh[] = {
mbedTrent 7:52b51f507ee5 93 PROX_THR_T, // Touch Threshold
mbedTrent 7:52b51f507ee5 94 PROX_THR_R // Release Threshold
mbedTrent 7:52b51f507ee5 95 };
mbedTrent 7:52b51f507ee5 96 writeMany(EPROXTTH,proxThresh,2);
mbedTrent 7:52b51f507ee5 97
mbedTrent 7:52b51f507ee5 98 this->write(FIL_CFG,0x04);
mbedTrent 7:52b51f507ee5 99
mbedTrent 7:52b51f507ee5 100 // Set the electrode config to transition to active mode
mbedTrent 7:52b51f507ee5 101 this->write(ELE_CFG,0x0c);
mbedTrent 7:52b51f507ee5 102 }
mbedTrent 7:52b51f507ee5 103
mbedTrent 7:52b51f507ee5 104 void Mpr121::setElectrodeThreshold(int electrode, unsigned char touch, unsigned char release){
mbedTrent 7:52b51f507ee5 105
mbedTrent 7:52b51f507ee5 106 if(electrode > 11) return;
mbedTrent 7:52b51f507ee5 107
mbedTrent 7:52b51f507ee5 108 // Get the current mode
mbedTrent 7:52b51f507ee5 109 unsigned char mode = this->read(ELE_CFG);
mbedTrent 7:52b51f507ee5 110
mbedTrent 7:52b51f507ee5 111 // Put the MPR into setup mode
mbedTrent 7:52b51f507ee5 112 this->write(ELE_CFG,0x00);
mbedTrent 7:52b51f507ee5 113
mbedTrent 7:52b51f507ee5 114 // Write the new threshold
mbedTrent 7:52b51f507ee5 115 this->write((ELE0_T+(electrode*2)), touch);
mbedTrent 7:52b51f507ee5 116 this->write((ELE0_T+(electrode*2)+1), release);
mbedTrent 7:52b51f507ee5 117
mbedTrent 7:52b51f507ee5 118 //Restore the operating mode
mbedTrent 7:52b51f507ee5 119 this->write(ELE_CFG, mode);
mbedTrent 7:52b51f507ee5 120 }
mbedTrent 7:52b51f507ee5 121
mbedTrent 7:52b51f507ee5 122
mbedTrent 7:52b51f507ee5 123 unsigned char Mpr121::read(int key){
mbedTrent 7:52b51f507ee5 124
mbedTrent 7:52b51f507ee5 125 unsigned char data[2];
mbedTrent 7:52b51f507ee5 126
mbedTrent 7:52b51f507ee5 127 //Start the command
mbedTrent 7:52b51f507ee5 128 i2c->start();
mbedTrent 7:52b51f507ee5 129
mbedTrent 7:52b51f507ee5 130 // Address the target (Write mode)
mbedTrent 7:52b51f507ee5 131 int ack1= i2c->write(address);
mbedTrent 7:52b51f507ee5 132
mbedTrent 7:52b51f507ee5 133 // Set the register key to read
mbedTrent 7:52b51f507ee5 134 int ack2 = i2c->write(key);
mbedTrent 7:52b51f507ee5 135
mbedTrent 7:52b51f507ee5 136 // Re-start for read of data
mbedTrent 7:52b51f507ee5 137 i2c->start();
mbedTrent 7:52b51f507ee5 138
mbedTrent 7:52b51f507ee5 139 // Re-send the target address in read mode
mbedTrent 7:52b51f507ee5 140 int ack3 = i2c->write(address+1);
mbedTrent 7:52b51f507ee5 141
mbedTrent 7:52b51f507ee5 142 // Read in the result
mbedTrent 7:52b51f507ee5 143 data[0] = i2c->read(0);
mbedTrent 7:52b51f507ee5 144
mbedTrent 7:52b51f507ee5 145 // Reset the bus
mbedTrent 7:52b51f507ee5 146 i2c->stop();
mbedTrent 7:52b51f507ee5 147
mbedTrent 7:52b51f507ee5 148 return data[0];
mbedTrent 7:52b51f507ee5 149 }
mbedTrent 7:52b51f507ee5 150
mbedTrent 7:52b51f507ee5 151
mbedTrent 7:52b51f507ee5 152 int Mpr121::write(int key, unsigned char value){
mbedTrent 7:52b51f507ee5 153
mbedTrent 7:52b51f507ee5 154 //Start the command
mbedTrent 7:52b51f507ee5 155 i2c->start();
mbedTrent 7:52b51f507ee5 156
mbedTrent 7:52b51f507ee5 157 // Address the target (Write mode)
mbedTrent 7:52b51f507ee5 158 int ack1= i2c->write(address);
mbedTrent 7:52b51f507ee5 159
mbedTrent 7:52b51f507ee5 160 // Set the register key to write
mbedTrent 7:52b51f507ee5 161 int ack2 = i2c->write(key);
mbedTrent 7:52b51f507ee5 162
mbedTrent 7:52b51f507ee5 163 // Read in the result
mbedTrent 7:52b51f507ee5 164 int ack3 = i2c->write(value);
mbedTrent 7:52b51f507ee5 165
mbedTrent 7:52b51f507ee5 166 // Reset the bus
mbedTrent 7:52b51f507ee5 167 i2c->stop();
mbedTrent 7:52b51f507ee5 168
mbedTrent 7:52b51f507ee5 169 return (ack1+ack2+ack3)-3;
mbedTrent 7:52b51f507ee5 170 }
mbedTrent 7:52b51f507ee5 171
mbedTrent 7:52b51f507ee5 172
mbedTrent 7:52b51f507ee5 173 int Mpr121::writeMany(int start, unsigned char* dataSet, int length){
mbedTrent 7:52b51f507ee5 174 //Start the command
mbedTrent 7:52b51f507ee5 175 i2c->start();
mbedTrent 7:52b51f507ee5 176
mbedTrent 7:52b51f507ee5 177 // Address the target (Write mode)
mbedTrent 7:52b51f507ee5 178 int ack= i2c->write(address);
mbedTrent 7:52b51f507ee5 179 if(ack!=1){
mbedTrent 7:52b51f507ee5 180 return -1;
mbedTrent 7:52b51f507ee5 181 }
mbedTrent 7:52b51f507ee5 182
mbedTrent 7:52b51f507ee5 183 // Set the register key to write
mbedTrent 7:52b51f507ee5 184 ack = i2c->write(start);
mbedTrent 7:52b51f507ee5 185 if(ack!=1){
mbedTrent 7:52b51f507ee5 186 return -1;
mbedTrent 7:52b51f507ee5 187 }
mbedTrent 7:52b51f507ee5 188
mbedTrent 7:52b51f507ee5 189 // Write the date set
mbedTrent 7:52b51f507ee5 190 int count = 0;
mbedTrent 7:52b51f507ee5 191 while(ack==1 && (count < length)){
mbedTrent 7:52b51f507ee5 192 ack = i2c->write(dataSet[count]);
mbedTrent 7:52b51f507ee5 193 count++;
mbedTrent 7:52b51f507ee5 194 }
mbedTrent 7:52b51f507ee5 195 // Stop the cmd
mbedTrent 7:52b51f507ee5 196 i2c->stop();
mbedTrent 7:52b51f507ee5 197
mbedTrent 7:52b51f507ee5 198 return count;
mbedTrent 7:52b51f507ee5 199 }
mbedTrent 7:52b51f507ee5 200
mbedTrent 7:52b51f507ee5 201
mbedTrent 7:52b51f507ee5 202 bool Mpr121::getProximityMode(){
mbedTrent 7:52b51f507ee5 203 if(this->read(ELE_CFG) > 0x0c)
mbedTrent 7:52b51f507ee5 204 return true;
mbedTrent 7:52b51f507ee5 205 else
mbedTrent 7:52b51f507ee5 206 return false;
mbedTrent 7:52b51f507ee5 207 }
mbedTrent 7:52b51f507ee5 208
mbedTrent 7:52b51f507ee5 209 void Mpr121::setProximityMode(bool mode){
mbedTrent 7:52b51f507ee5 210 this->write(ELE_CFG,0x00);
mbedTrent 7:52b51f507ee5 211 if(mode){
mbedTrent 7:52b51f507ee5 212 this->write(ELE_CFG,0x30); //Sense proximity from ALL pads
mbedTrent 7:52b51f507ee5 213 } else {
mbedTrent 7:52b51f507ee5 214 this->write(ELE_CFG,0x0c); //Sense touch, all 12 pads active.
mbedTrent 7:52b51f507ee5 215 }
mbedTrent 7:52b51f507ee5 216 }
mbedTrent 7:52b51f507ee5 217
mbedTrent 7:52b51f507ee5 218
mbedTrent 7:52b51f507ee5 219 int Mpr121::readTouchData(){
mbedTrent 7:52b51f507ee5 220 return this->read(0x00);
mbedTrent 7:52b51f507ee5 221 }