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