David Estrada / MMA8451Q8

DE_4_1 Project 1b 150203

Fork of MMA8451Q8b by Stanley Cohen

MMA8451Q8.cpp@9:a9cba88ad7f6, 2015-02-04 (annotated)

Committer:
destradafilm
Date:
Wed Feb 04 06:50:25 2015 +0000
Revision:
9:a9cba88ad7f6
Parent:
8:993bb9e96a4b 
Single Tap _ DE_4_1_project 1b; Date: 02/03/15

Who changed what in which revision?

UserRevisionLine numberNew contents of line
samux 1:d2630136d51e 1 /* Copyright (c) 2010-2011 mbed.org, MIT License
samux 1:d2630136d51e 2 *
samux 1:d2630136d51e 3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
samux 1:d2630136d51e 4 * and associated documentation files (the "Software"), to deal in the Software without
samux 1:d2630136d51e 5 * restriction, including without limitation the rights to use, copy, modify, merge, publish,
samux 1:d2630136d51e 6 * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
samux 1:d2630136d51e 7 * Software is furnished to do so, subject to the following conditions:
samux 1:d2630136d51e 8 *
samux 1:d2630136d51e 9 * The above copyright notice and this permission notice shall be included in all copies or
samux 1:d2630136d51e 10 * substantial portions of the Software.
samux 1:d2630136d51e 11 *
samux 1:d2630136d51e 12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
samux 1:d2630136d51e 13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
samux 1:d2630136d51e 14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
samux 1:d2630136d51e 15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
samux 1:d2630136d51e 16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
samux 1:d2630136d51e 17 */
scohennm 5:5a7293378401 18 // Modify to change full scale gravity range 141207 sc
samux 1:d2630136d51e 19
scohennm 5:5a7293378401 20
scohennm 5:5a7293378401 21 #include "MMA8451Q8.h"
emilmont 0:6149091f755d 22
samux 1:d2630136d51e 23 #define REG_WHO_AM_I 0x0D
samux 1:d2630136d51e 24 #define REG_CTRL_REG_1 0x2A
emilmont 0:6149091f755d 25 #define REG_OUT_X_MSB 0x01
emilmont 0:6149091f755d 26 #define REG_OUT_Y_MSB 0x03
emilmont 0:6149091f755d 27 #define REG_OUT_Z_MSB 0x05
scohennm 5:5a7293378401 28 #define XYZ_DATA_CFG 0x0E
scohennm 8:993bb9e96a4b 29 // adding tap config register adderesses
scohennm 8:993bb9e96a4b 30 #define REG_PULSE_SRC 0x22
scohennm 8:993bb9e96a4b 31 #define REG_PULSE_CFG 0x21
emilmont 0:6149091f755d 32
destradafilm 9:a9cba88ad7f6 33 // pulse threshold for x, y , & z Registers
destradafilm 9:a9cba88ad7f6 34 #define PULSE_THSX 0x23
destradafilm 9:a9cba88ad7f6 35 #define PULSE_THSY 0x24
destradafilm 9:a9cba88ad7f6 36 #define PULSE_THSZ 0x25
destradafilm 9:a9cba88ad7f6 37
destradafilm 9:a9cba88ad7f6 38 // Pulse Time limit first pulse
destradafilm 9:a9cba88ad7f6 39 #define PULSE_TMLT 0x26
destradafilm 9:a9cba88ad7f6 40
destradafilm 9:a9cba88ad7f6 41 // Latency time for 2nd pulse
destradafilm 9:a9cba88ad7f6 42 #define PULSE_LTCY 0x27
destradafilm 9:a9cba88ad7f6 43
samux 1:d2630136d51e 44 #define UINT14_MAX 16383
emilmont 0:6149091f755d 45
scohennm 5:5a7293378401 46 #define MAX_2G 0x00
scohennm 5:5a7293378401 47 #define MAX_4G 0x01
scohennm 5:5a7293378401 48 #define MAX_8G 0x02
scohennm 5:5a7293378401 49
scohennm 5:5a7293378401 50 #define NUM_DATA 2
scohennm 5:5a7293378401 51 #define GSCALING 1024.0
scohennm 5:5a7293378401 52 #define ADDRESS_INDEX 0
scohennm 5:5a7293378401 53 #define DATA_INDEX 1
scohennm 5:5a7293378401 54
scohennm 5:5a7293378401 55 float gScaling[3] = {4095.0,2048.0,1024.0}; //scaling for acceleration of gravity values
scohennm 5:5a7293378401 56
emilmont 0:6149091f755d 57 MMA8451Q::MMA8451Q(PinName sda, PinName scl, int addr) : m_i2c(sda, scl), m_addr(addr) {
emilmont 0:6149091f755d 58 // activate the peripheral
emilmont 0:6149091f755d 59 uint8_t data[2] = {REG_CTRL_REG_1, 0x01};
samux 1:d2630136d51e 60 writeRegs(data, 2);
emilmont 0:6149091f755d 61 }
emilmont 0:6149091f755d 62
emilmont 0:6149091f755d 63 MMA8451Q::~MMA8451Q() { }
emilmont 0:6149091f755d 64
emilmont 0:6149091f755d 65 uint8_t MMA8451Q::getWhoAmI() {
emilmont 0:6149091f755d 66 uint8_t who_am_i = 0;
samux 1:d2630136d51e 67 readRegs(REG_WHO_AM_I, &who_am_i, 1);
emilmont 0:6149091f755d 68 return who_am_i;
emilmont 0:6149091f755d 69 }
scohennm 5:5a7293378401 70 void MMA8451Q::setGLimit(int gSelect) {
scohennm 5:5a7293378401 71 uint8_t data[NUM_DATA] = {REG_CTRL_REG_1, 0x00};
scohennm 5:5a7293378401 72 gChosen = gSelect;
scohennm 5:5a7293378401 73 writeRegs(data, NUM_DATA); // put in standby
scohennm 5:5a7293378401 74 data[ADDRESS_INDEX ] = XYZ_DATA_CFG;
scohennm 5:5a7293378401 75 data[DATA_INDEX] = gChosen;
scohennm 5:5a7293378401 76 writeRegs(data, 2);// change g limit
scohennm 5:5a7293378401 77 data[ADDRESS_INDEX ] = REG_CTRL_REG_1;
scohennm 5:5a7293378401 78 data[DATA_INDEX] = 0x01;
scohennm 5:5a7293378401 79 writeRegs(data, 2); // make active
scohennm 5:5a7293378401 80 }
scohennm 8:993bb9e96a4b 81 // add Puse configuratioin register access
scohennm 8:993bb9e96a4b 82 // Also add function prototype to .h file
scohennm 8:993bb9e96a4b 83 void MMA8451Q::setPulseConfiguration(uint8_t latch,uint8_t axisSet) {
scohennm 8:993bb9e96a4b 84 uint8_t configBits;
destradafilm 9:a9cba88ad7f6 85 uint8_t data[NUM_DATA] = {REG_CTRL_REG_1, 0x00}; // put in standby mode /// Q: is 0x00 saying switch off?
destradafilm 9:a9cba88ad7f6 86 // set up configuration bits.
destradafilm 9:a9cba88ad7f6 87 configBits = latch | axisSet; /// Q: what does the "|" do?
destradafilm 9:a9cba88ad7f6 88 writeRegs(data, NUM_DATA); // put in standby /// Q: is it sending data[NUM_DATA] or two seperate vars?
destradafilm 9:a9cba88ad7f6 89 data[ADDRESS_INDEX ] = REG_PULSE_CFG; /// is this a function after it is put into standby?
destradafilm 9:a9cba88ad7f6 90 data[DATA_INDEX] = configBits;
destradafilm 9:a9cba88ad7f6 91 writeRegs(data, NUM_DATA); /// Q: what is it doing here? standby again?
destradafilm 9:a9cba88ad7f6 92 data[ADDRESS_INDEX ] = REG_CTRL_REG_1; // put back in active mode // how is this back in active mode?
destradafilm 9:a9cba88ad7f6 93 data[DATA_INDEX] = 0x01;
destradafilm 9:a9cba88ad7f6 94 writeRegs(data, 2); // make active //Q: what is the 2 here?
destradafilm 9:a9cba88ad7f6 95 }
destradafilm 9:a9cba88ad7f6 96
destradafilm 9:a9cba88ad7f6 97
destradafilm 9:a9cba88ad7f6 98
destradafilm 9:a9cba88ad7f6 99 // added to .h file
destradafilm 9:a9cba88ad7f6 100 void setPulseThreshold (uint8_t axisSelect, uint8_t threshold) {
destradafilm 9:a9cba88ad7f6 101 uint8_t configBits;
destradafilm 9:a9cba88ad7f6 102 uint8_t data[NUM_DATA] = {REG_CTRL_REG_1, 0x00}; // put in standby mode
scohennm 8:993bb9e96a4b 103 // set up configuration bits.
destradafilm 9:a9cba88ad7f6 104 configBits = axisSelect | threshold;
destradafilm 9:a9cba88ad7f6 105 writeRegs(data, NUM_DATA); // put in standby
destradafilm 9:a9cba88ad7f6 106 data[ADDRESS_INDEX ] = PULSE_THSZ; // Set it to Z axis Threshold
destradafilm 9:a9cba88ad7f6 107 data[DATA_INDEX] = configBits;
destradafilm 9:a9cba88ad7f6 108 writeRegs(data, NUM_DATA);
destradafilm 9:a9cba88ad7f6 109 data[ADDRESS_INDEX ] = REG_CTRL_REG_1; // put back in active mode
destradafilm 9:a9cba88ad7f6 110 data[DATA_INDEX] = 0x01;
destradafilm 9:a9cba88ad7f6 111 writeRegs(data, 2); // make active
scohennm 8:993bb9e96a4b 112 }
destradafilm 9:a9cba88ad7f6 113
destradafilm 9:a9cba88ad7f6 114 void setPulseTimeLimit (uint8_t timeLimit){
destradafilm 9:a9cba88ad7f6 115 uint8_t configBits;
destradafilm 9:a9cba88ad7f6 116 uint8_t data[NUM_DATA] = {REG_CTRL_REG_1, 0x00}; // put in standby mode
destradafilm 9:a9cba88ad7f6 117 // set up configuration bits.
destradafilm 9:a9cba88ad7f6 118 configBits = timeLimit;
destradafilm 9:a9cba88ad7f6 119 writeRegs(data, NUM_DATA); // put in standby
destradafilm 9:a9cba88ad7f6 120 data[ADDRESS_INDEX ] = PULSE_TMLT; // Set it to Pulse Time limit Register
destradafilm 9:a9cba88ad7f6 121 data[DATA_INDEX] = configBits;
destradafilm 9:a9cba88ad7f6 122 writeRegs(data, NUM_DATA);
destradafilm 9:a9cba88ad7f6 123 data[ADDRESS_INDEX ] = REG_CTRL_REG_1; // put back in active mode
destradafilm 9:a9cba88ad7f6 124 data[DATA_INDEX] = 0x01;
destradafilm 9:a9cba88ad7f6 125 writeRegs(data, 2); // make active
destradafilm 9:a9cba88ad7f6 126 }
destradafilm 9:a9cba88ad7f6 127
destradafilm 9:a9cba88ad7f6 128 void setPulseLatency (uint8_t latencyTime){
destradafilm 9:a9cba88ad7f6 129 uint8_t configBits;
destradafilm 9:a9cba88ad7f6 130 uint8_t data[NUM_DATA] = {REG_CTRL_REG_1, 0x00}; // put in standby mode
destradafilm 9:a9cba88ad7f6 131 // set up configuration bits.
destradafilm 9:a9cba88ad7f6 132 configBits = latencyTime;
destradafilm 9:a9cba88ad7f6 133 writeRegs(data, NUM_DATA); // put in standby
destradafilm 9:a9cba88ad7f6 134 data[ADDRESS_INDEX ] = PULSE_LTCY; // Set it to Pulse Latency Register
destradafilm 9:a9cba88ad7f6 135 data[DATA_INDEX] = configBits;
destradafilm 9:a9cba88ad7f6 136 writeRegs(data, NUM_DATA);
destradafilm 9:a9cba88ad7f6 137 data[ADDRESS_INDEX ] = REG_CTRL_REG_1; // put back in active mode
destradafilm 9:a9cba88ad7f6 138 data[DATA_INDEX] = 0x01;
destradafilm 9:a9cba88ad7f6 139 writeRegs(data, 2); // make active
destradafilm 9:a9cba88ad7f6 140 }
destradafilm 9:a9cba88ad7f6 141
chris 3:db7126dbd63f 142 float MMA8451Q::getAccX() {
scohennm 5:5a7293378401 143 return (float(getAccAxis(REG_OUT_X_MSB))/gScaling[gChosen]);
emilmont 0:6149091f755d 144 }
emilmont 0:6149091f755d 145
scohennm 7:ed7e11d269f8 146
chris 3:db7126dbd63f 147 float MMA8451Q::getAccY() {
scohennm 5:5a7293378401 148 return (float(getAccAxis(REG_OUT_Y_MSB))/gScaling[gChosen]);
emilmont 0:6149091f755d 149 }
emilmont 0:6149091f755d 150
chris 3:db7126dbd63f 151 float MMA8451Q::getAccZ() {
scohennm 5:5a7293378401 152 return (float(getAccAxis(REG_OUT_Z_MSB))/gScaling[gChosen]);
emilmont 0:6149091f755d 153 }
emilmont 0:6149091f755d 154
chris 3:db7126dbd63f 155 void MMA8451Q::getAccAllAxis(float * res) {
emilmont 0:6149091f755d 156 res[0] = getAccX();
emilmont 0:6149091f755d 157 res[1] = getAccY();
emilmont 0:6149091f755d 158 res[2] = getAccZ();
emilmont 0:6149091f755d 159 }
emilmont 0:6149091f755d 160
emilmont 0:6149091f755d 161 int16_t MMA8451Q::getAccAxis(uint8_t addr) {
emilmont 0:6149091f755d 162 int16_t acc;
emilmont 0:6149091f755d 163 uint8_t res[2];
samux 1:d2630136d51e 164 readRegs(addr, res, 2);
emilmont 0:6149091f755d 165
emilmont 0:6149091f755d 166 acc = (res[0] << 6) | (res[1] >> 2);
emilmont 0:6149091f755d 167 if (acc > UINT14_MAX/2)
emilmont 0:6149091f755d 168 acc -= UINT14_MAX;
emilmont 0:6149091f755d 169
emilmont 0:6149091f755d 170 return acc;
emilmont 0:6149091f755d 171 }
emilmont 0:6149091f755d 172
samux 1:d2630136d51e 173 void MMA8451Q::readRegs(int addr, uint8_t * data, int len) {
emilmont 0:6149091f755d 174 char t[1] = {addr};
emilmont 0:6149091f755d 175 m_i2c.write(m_addr, t, 1, true);
emilmont 0:6149091f755d 176 m_i2c.read(m_addr, (char *)data, len);
emilmont 0:6149091f755d 177 }
emilmont 0:6149091f755d 178
samux 1:d2630136d51e 179 void MMA8451Q::writeRegs(uint8_t * data, int len) {
emilmont 0:6149091f755d 180 m_i2c.write(m_addr, (char *)data, len);
emilmont 0:6149091f755d 181 }