Nathan Yonkee / MPR121

use mbed os

Dependents:   Seeed_Grove_I2C_Touch_Example

Fork of MPR121 by Sam Grove

MPR121.cpp@19:eaa64138290b, 2017-07-02 (annotated)

Committer:
Nathan Yonkee
Date:
Sun Jul 02 11:55:42 2017 -0600
Revision:
19:eaa64138290b
Parent:
15:8c7fba79a28e
Child:
22:b1fa74a5123b
revert to original fixes before merges

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Nate Yonkee 9:8cb5ce483be3 1 /**
Nate Yonkee 9:8cb5ce483be3 2 * @file MPR121.cpp
Nate Yonkee 9:8cb5ce483be3 3 * @brief Device driver - MPR121 capactiive touch IC
Nate Yonkee 9:8cb5ce483be3 4 * @author sam grove
Nate Yonkee 9:8cb5ce483be3 5 * @version 1.0
Nate Yonkee 9:8cb5ce483be3 6 * @see http://cache.freescale.com/files/sensors/doc/data_sheet/MPR121.pdf
Nate Yonkee 9:8cb5ce483be3 7 *
Nate Yonkee 9:8cb5ce483be3 8 * Copyright (c) 2013
Nate Yonkee 9:8cb5ce483be3 9 *
Nate Yonkee 9:8cb5ce483be3 10 * Licensed under the Apache License, Version 2.0 (the "License");
Nate Yonkee 9:8cb5ce483be3 11 * you may not use this file except in compliance with the License.
Nate Yonkee 9:8cb5ce483be3 12 * You may obtain a copy of the License at
Nate Yonkee 9:8cb5ce483be3 13 *
Nate Yonkee 9:8cb5ce483be3 14 * http://www.apache.org/licenses/LICENSE-2.0
Nate Yonkee 9:8cb5ce483be3 15 *
Nate Yonkee 9:8cb5ce483be3 16 * Unless required by applicable law or agreed to in writing, software
Nate Yonkee 9:8cb5ce483be3 17 * distributed under the License is distributed on an "AS IS" BASIS,
Nate Yonkee 9:8cb5ce483be3 18 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Nate Yonkee 9:8cb5ce483be3 19 * See the License for the specific language governing permissions and
Nate Yonkee 9:8cb5ce483be3 20 * limitations under the License.
Nate Yonkee 9:8cb5ce483be3 21 */
Nate Yonkee 9:8cb5ce483be3 22
Nate Yonkee 9:8cb5ce483be3 23 #include "MPR121.h"
Nate Yonkee 9:8cb5ce483be3 24 #include "mbed_debug.h"
Nate Yonkee 9:8cb5ce483be3 25
Nate Yonkee 9:8cb5ce483be3 26 #define DEBUG 1
Nate Yonkee 9:8cb5ce483be3 27
Nathan Yonkee 19:eaa64138290b 28 MPR121::MPR121(I2C &i2c, InterruptIn &pin, MPR121_ADDR i2c_addr)
Nathan Yonkee 19:eaa64138290b 29 {
Nate Yonkee 9:8cb5ce483be3 30 _i2c = &i2c;
Nate Yonkee 9:8cb5ce483be3 31 _irq = &pin;
Nate Yonkee 9:8cb5ce483be3 32 _i2c_addr = (i2c_addr << 1);
Nate Yonkee 9:8cb5ce483be3 33
Nate Yonkee 9:8cb5ce483be3 34 return;
Nate Yonkee 9:8cb5ce483be3 35 }
Nate Yonkee 9:8cb5ce483be3 36
Nathan Yonkee 19:eaa64138290b 37 MPR121::MPR121(I2C &i2c, MPR121_ADDR fake)
Nathan Yonkee 19:eaa64138290b 38 {
Nathan Yonkee 12:22d36da8df91 39 _i2c = &i2c;
Nathan Yonkee 12:22d36da8df91 40 _irq = NULL;
Nathan Yonkee 12:22d36da8df91 41 _i2c_addr = (0x1b << 1);
Nathan Yonkee 12:22d36da8df91 42 char reg[1] = { 0x03 };
Nathan Yonkee 12:22d36da8df91 43 int result=0;
Nathan Yonkee 12:22d36da8df91 44 char data = 10;
Nathan Yonkee 12:22d36da8df91 45 result = _i2c->write(_i2c_addr, reg, 1, true);
Nathan Yonkee 19:eaa64138290b 46 if(result == 0 ) debug("result is 0");
Nathan Yonkee 19:eaa64138290b 47 result = _i2c->read(_i2c_addr, &data, 1);
Nathan Yonkee 19:eaa64138290b 48 if(result == 0 ) debug("result is 0");
Nathan Yonkee 12:22d36da8df91 49
Nathan Yonkee 12:22d36da8df91 50 return;
Nathan Yonkee 12:22d36da8df91 51 }
Nathan Yonkee 12:22d36da8df91 52
Nathan Yonkee 19:eaa64138290b 53 void MPR121::init(void)
Nathan Yonkee 19:eaa64138290b 54 {
Nathan Yonkee 12:22d36da8df91 55 // set the i2c speed
Nathan Yonkee 12:22d36da8df91 56 /* _i2c->frequency(400000);
Nathan Yonkee 19:eaa64138290b 57 */
Nathan Yonkee 12:22d36da8df91 58 // irq is open-collector and active-low
Nathan Yonkee 12:22d36da8df91 59 if(_irq != NULL) {
Nathan Yonkee 12:22d36da8df91 60 _irq->mode(PullUp);
Nathan Yonkee 12:22d36da8df91 61 }
Nathan Yonkee 12:22d36da8df91 62
Nathan Yonkee 12:22d36da8df91 63 // setup and registers - start with POR values (must be in stop mode)
Nathan Yonkee 12:22d36da8df91 64 MPR121::writeRegister(SRST, 0x63); //REG 0x80
Nathan Yonkee 12:22d36da8df91 65
Nathan Yonkee 12:22d36da8df91 66 // Baseline Filtering Control Register (changes response sensitivity)
Nathan Yonkee 12:22d36da8df91 67 // http://cache.freescale.com/files/sensors/doc/app_note/AN3891.pdf
Nathan Yonkee 12:22d36da8df91 68 MPR121::writeRegister(MHDR, 0x1); //REG 0x2B
Nathan Yonkee 12:22d36da8df91 69 MPR121::writeRegister(NHDR, 0x1); //REG 0x2C
Nathan Yonkee 12:22d36da8df91 70 MPR121::writeRegister(NCLR, 0x0); //REG 0x2D
Nathan Yonkee 12:22d36da8df91 71 MPR121::writeRegister(FDLR, 0x0); //REG 0x2E
Nathan Yonkee 12:22d36da8df91 72 MPR121::writeRegister(MHDF, 0x1); //REG 0x2F
Nathan Yonkee 12:22d36da8df91 73 MPR121::writeRegister(NHDF, 0x1); //REG 0x30
Nathan Yonkee 12:22d36da8df91 74 MPR121::writeRegister(NCLF, 0xFF); //REG 0x31
Nathan Yonkee 12:22d36da8df91 75 MPR121::writeRegister(FDLF, 0x2); //REG 0x32
Nathan Yonkee 12:22d36da8df91 76
Nathan Yonkee 12:22d36da8df91 77 // Touch / Release Threshold
Nathan Yonkee 12:22d36da8df91 78 // cache.freescale.com/files/sensors/doc/app_note/AN3892.pdf
Nathan Yonkee 12:22d36da8df91 79 for(int i=0; i<(12*2); i+=2) { // touch
Nathan Yonkee 12:22d36da8df91 80 MPR121::writeRegister(static_cast<MPR121_REGISTER>(E0TTH+i), 0x20); //REG 0x41...0x58 odd
Nathan Yonkee 12:22d36da8df91 81 }
Nathan Yonkee 12:22d36da8df91 82 for(int i=0; i<(12*2); i+=2) { // release
Nathan Yonkee 12:22d36da8df91 83 MPR121::writeRegister(static_cast<MPR121_REGISTER>(E0RTH+i), 0x10); //REG 0x41...0x58 even
Nathan Yonkee 12:22d36da8df91 84 }
Nathan Yonkee 12:22d36da8df91 85
Nathan Yonkee 12:22d36da8df91 86 // Debounce Register DR=b6...4, DT=b2...0
Nathan Yonkee 12:22d36da8df91 87 MPR121::writeRegister(DT_DR, 0x11); //REG 0x5B
Nathan Yonkee 12:22d36da8df91 88
Nathan Yonkee 12:22d36da8df91 89 // Filter and Global CDC CDT Configuration (sample time, charge current)
Nathan Yonkee 12:22d36da8df91 90 MPR121::writeRegister(CDC_CONFIG, 0x10); //REG 0x5C default 10
Nathan Yonkee 12:22d36da8df91 91 MPR121::writeRegister(CDT_CONFIG, 0x20); //REG 0x5D default 24
Nathan Yonkee 12:22d36da8df91 92
Nathan Yonkee 12:22d36da8df91 93 // Auto-Configuration Registers
Nathan Yonkee 12:22d36da8df91 94 // http://cache.freescale.com/files/sensors/doc/app_note/AN3889.pdf
Nathan Yonkee 12:22d36da8df91 95 MPR121::writeRegister(AUTO_CFG0, 0x33); // REG 0x7B
Nathan Yonkee 12:22d36da8df91 96 MPR121::writeRegister(AUTO_CFG1, 0x07); // REG 0x7C
Nathan Yonkee 12:22d36da8df91 97 MPR121::writeRegister(USL, 0xc9); // REG 0x7D((3.3-.07)/3.3) * 256
Nathan Yonkee 12:22d36da8df91 98 MPR121::writeRegister(LSL, 0x83); // REG 0x7E((3.3-.07)/3.3) * 256 * 0.65f
Nathan Yonkee 12:22d36da8df91 99 MPR121::writeRegister(TL, 0xb5); // REG 0x7F((3.3-.07)/3.3) * 256 * 0.9f
Nathan Yonkee 12:22d36da8df91 100 // 255 > USL > TL > LSL > 0
Nathan Yonkee 12:22d36da8df91 101
Nathan Yonkee 12:22d36da8df91 102 // Electrode Configuration Register - enable all 12 and start
Nathan Yonkee 12:22d36da8df91 103 MPR121::writeRegister(ECR, 0x8f);
Nathan Yonkee 12:22d36da8df91 104
Nathan Yonkee 12:22d36da8df91 105 return;
Nathan Yonkee 12:22d36da8df91 106 }
Nathan Yonkee 12:22d36da8df91 107
Nathan Yonkee 19:eaa64138290b 108 void MPR121::enable(void)
Nathan Yonkee 19:eaa64138290b 109 {
Nathan Yonkee 12:22d36da8df91 110 _button = 0;
Nathan Yonkee 12:22d36da8df91 111 _button_has_changed = 0;
Nathan Yonkee 12:22d36da8df91 112 // enable the 12 electrodes - allow disable to put device into
Nathan Yonkee 12:22d36da8df91 113 // lower current consumption mode
Nathan Yonkee 12:22d36da8df91 114 MPR121::writeRegister(ECR, 0x8f);
Nathan Yonkee 12:22d36da8df91 115 // and attach the interrupt handler
Nathan Yonkee 12:22d36da8df91 116 if(_irq != NULL) {
Nathan Yonkee 12:22d36da8df91 117 _irq->fall(this, &MPR121::handler);
Nathan Yonkee 12:22d36da8df91 118 }
Nathan Yonkee 12:22d36da8df91 119
Nathan Yonkee 12:22d36da8df91 120 return;
Nathan Yonkee 12:22d36da8df91 121 }
Nathan Yonkee 12:22d36da8df91 122
Nathan Yonkee 19:eaa64138290b 123 void MPR121::disable(void)
Nathan Yonkee 19:eaa64138290b 124 {
Nathan Yonkee 12:22d36da8df91 125 // detach the interrupt handler
Nathan Yonkee 12:22d36da8df91 126 _irq->fall(NULL);
Nathan Yonkee 12:22d36da8df91 127 _button = 0;
Nathan Yonkee 12:22d36da8df91 128 _button_has_changed = 0;
Nathan Yonkee 12:22d36da8df91 129 // put the device in low current consumption mode - dont re-init registers
Nathan Yonkee 12:22d36da8df91 130 MPR121::writeRegister(ECR, 0x0);
Nathan Yonkee 12:22d36da8df91 131 MPR121::writeRegister(AUTO_CFG0, 0x0); // REG 0x7B
Nathan Yonkee 12:22d36da8df91 132 MPR121::writeRegister(AUTO_CFG1, 0x0); // REG 0x7C
Nathan Yonkee 12:22d36da8df91 133
Nathan Yonkee 12:22d36da8df91 134 return;
Nathan Yonkee 12:22d36da8df91 135 }
Nathan Yonkee 12:22d36da8df91 136
Nathan Yonkee 19:eaa64138290b 137 uint32_t MPR121::isPressed(void)
Nathan Yonkee 19:eaa64138290b 138 {
Nathan Yonkee 12:22d36da8df91 139
Nathan Yonkee 12:22d36da8df91 140 char reg[1] = { 0x03 };
Nathan Yonkee 12:22d36da8df91 141 int result=0;
Nathan Yonkee 12:22d36da8df91 142 char data = -1;
Nathan Yonkee 12:22d36da8df91 143 result = _i2c->write(_i2c_addr, reg, 1, true);
Nathan Yonkee 19:eaa64138290b 144 if(result == 0 ) debug("result is 0");
Nathan Yonkee 19:eaa64138290b 145 result = _i2c->read(_i2c_addr, &data, 1);
Nathan Yonkee 19:eaa64138290b 146 if(result == 0 ) debug("result is 0");
Nathan Yonkee 12:22d36da8df91 147 if(data > 0) data = true;
Nathan Yonkee 12:22d36da8df91 148 return data;
Nathan Yonkee 12:22d36da8df91 149 /* return _button_has_changed;
Nathan Yonkee 19:eaa64138290b 150 */
Nathan Yonkee 12:22d36da8df91 151 }
Nathan Yonkee 12:22d36da8df91 152
Nathan Yonkee 19:eaa64138290b 153 uint16_t MPR121::buttonPressed(void)
Nathan Yonkee 19:eaa64138290b 154 {
Nathan Yonkee 12:22d36da8df91 155 char reg[1] = { 0x03 };
Nathan Yonkee 12:22d36da8df91 156 int result=0;
Nathan Yonkee 12:22d36da8df91 157 char data = -1;
Nathan Yonkee 12:22d36da8df91 158 result = _i2c->write(_i2c_addr, reg, 1, true);
Nathan Yonkee 19:eaa64138290b 159 if(result == 0 ) debug("result is 0");
Nathan Yonkee 19:eaa64138290b 160 result = _i2c->read(_i2c_addr, &data, 1);
Nathan Yonkee 19:eaa64138290b 161 if(result == 0 ) debug("result is 0");
Nathan Yonkee 12:22d36da8df91 162 if(data == 4) data = 3;
Nathan Yonkee 12:22d36da8df91 163 if(data == 2) data = 2;
Nathan Yonkee 12:22d36da8df91 164 if(data == 1) data = 1;
Nathan Yonkee 12:22d36da8df91 165 return data;
Nathan Yonkee 12:22d36da8df91 166 }
Nathan Yonkee 12:22d36da8df91 167
Nathan Yonkee 19:eaa64138290b 168 void MPR121::registerDump(Serial &obj) const
Nathan Yonkee 19:eaa64138290b 169 {
Nathan Yonkee 12:22d36da8df91 170 uint8_t reg_val = 0;
Nathan Yonkee 12:22d36da8df91 171
Nathan Yonkee 12:22d36da8df91 172 for(int i=0; i<0x80; i++) {
Nathan Yonkee 12:22d36da8df91 173 reg_val = MPR121::readRegister(static_cast<MPR121_REGISTER>(i));
Nathan Yonkee 12:22d36da8df91 174 obj.printf("Reg 0x%02x: 0x%02x \n", i, reg_val);
Nathan Yonkee 12:22d36da8df91 175 }
Nathan Yonkee 12:22d36da8df91 176
Nathan Yonkee 12:22d36da8df91 177 return;
Nathan Yonkee 12:22d36da8df91 178 }
Nathan Yonkee 12:22d36da8df91 179
Nathan Yonkee 19:eaa64138290b 180 void MPR121::registerDump(void) const
Nathan Yonkee 19:eaa64138290b 181 {
Nathan Yonkee 12:22d36da8df91 182 uint8_t reg_val = 0;
Nathan Yonkee 12:22d36da8df91 183
Nathan Yonkee 12:22d36da8df91 184 for(int i=0; i<0x80; i++) {
Nathan Yonkee 12:22d36da8df91 185 reg_val = MPR121::readRegister(static_cast<MPR121_REGISTER>(i));
Nathan Yonkee 12:22d36da8df91 186 printf("Reg 0x%02x: 0x%02x \n", i, reg_val);
Nathan Yonkee 12:22d36da8df91 187 }
Nathan Yonkee 12:22d36da8df91 188
Nathan Yonkee 12:22d36da8df91 189 return;
Nathan Yonkee 12:22d36da8df91 190 }
Nathan Yonkee 12:22d36da8df91 191
Nathan Yonkee 19:eaa64138290b 192 void MPR121::handler(void)
Nathan Yonkee 19:eaa64138290b 193 {
Nathan Yonkee 12:22d36da8df91 194 uint16_t reg_val = 0, oor_val = 0;
Nathan Yonkee 12:22d36da8df91 195 // read register 0 and 1
Nathan Yonkee 12:22d36da8df91 196 reg_val = MPR121::readRegister(ELE0_7_STAT);
Nathan Yonkee 12:22d36da8df91 197 reg_val |= MPR121::readRegister(ELE8_11_STAT) << 8;
Nathan Yonkee 12:22d36da8df91 198 // 2 and 3
Nathan Yonkee 12:22d36da8df91 199 oor_val = MPR121::readRegister(ELE0_7_OOR_STAT);
Nathan Yonkee 12:22d36da8df91 200 oor_val |= MPR121::readRegister(ELE8_11_OOR_STAT) << 8;
Nathan Yonkee 12:22d36da8df91 201
Nathan Yonkee 12:22d36da8df91 202 // debugging stuff and errors - if OOR fails someone was touching the pad during auto-config
Nathan Yonkee 12:22d36da8df91 203 // Just reboot until they're not doing this
Nathan Yonkee 12:22d36da8df91 204 if((0 != oor_val) && DEBUG) {
Nathan Yonkee 12:22d36da8df91 205 debug("MPR121 OOR failure - 0x%04x\n", oor_val);
Nathan Yonkee 12:22d36da8df91 206 wait(0.1f);
Nathan Yonkee 12:22d36da8df91 207 NVIC_SystemReset();
Nathan Yonkee 12:22d36da8df91 208 }
Nathan Yonkee 12:22d36da8df91 209
Nathan Yonkee 12:22d36da8df91 210 _button = reg_val;
Nathan Yonkee 12:22d36da8df91 211 _button_has_changed = 1;
Nathan Yonkee 12:22d36da8df91 212
Nathan Yonkee 12:22d36da8df91 213 return;
Nathan Yonkee 12:22d36da8df91 214 }
Nathan Yonkee 12:22d36da8df91 215
Nathan Yonkee 19:eaa64138290b 216 void MPR121::writeRegister(MPR121_REGISTER const reg, uint8_t const data) const
Nathan Yonkee 19:eaa64138290b 217 {
Nathan Yonkee 12:22d36da8df91 218 char buf[2] = {reg, data};
Nathan Yonkee 12:22d36da8df91 219 uint8_t result = 0;
Nathan Yonkee 12:22d36da8df91 220
Nathan Yonkee 12:22d36da8df91 221 result = _i2c->write(_i2c_addr, buf, 2);
Nathan Yonkee 19:eaa64138290b 222 if(result && DEBUG)
Nathan Yonkee 19:eaa64138290b 223 {
Nathan Yonkee 12:22d36da8df91 224 debug("I2C write failed\n");
Nathan Yonkee 12:22d36da8df91 225 }
Nathan Yonkee 12:22d36da8df91 226
Nathan Yonkee 12:22d36da8df91 227 return;
Nathan Yonkee 12:22d36da8df91 228 }
Nathan Yonkee 12:22d36da8df91 229
Nathan Yonkee 19:eaa64138290b 230 uint8_t MPR121::readRegister(MPR121_REGISTER const reg) const
Nathan Yonkee 19:eaa64138290b 231 {
Nathan Yonkee 12:22d36da8df91 232 char buf[1] = {reg}, data = 0;
Nathan Yonkee 12:22d36da8df91 233 uint8_t result = 1;
Nathan Yonkee 12:22d36da8df91 234
Nathan Yonkee 12:22d36da8df91 235 result &= _i2c->write(_i2c_addr, buf, 1, true);
Nathan Yonkee 19:eaa64138290b 236 result &= _i2c->read(_i2c_addr, &data, 1);
Nathan Yonkee 19:eaa64138290b 237
Nathan Yonkee 19:eaa64138290b 238 if(result && DEBUG)
Nathan Yonkee 19:eaa64138290b 239 {
Nathan Yonkee 12:22d36da8df91 240 debug("I2C read failed\n");
Nathan Yonkee 12:22d36da8df91 241 }
Nathan Yonkee 12:22d36da8df91 242
Nathan Yonkee 12:22d36da8df91 243 return data;
Nathan Yonkee 12:22d36da8df91 244 }
Nathan Yonkee 19:eaa64138290b 245