Works with 8g
Fork of MMA8452 by
MMA8452.h@0:bcf2aa85d7f9, 2013-10-04 (annotated)
- Committer:
- nherriot
- Date:
- Fri Oct 04 14:48:02 2013 +0000
- Revision:
- 0:bcf2aa85d7f9
- Child:
- 1:ef026bf28798
Initial commit fro mma8452
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
nherriot | 0:bcf2aa85d7f9 | 1 | // Author: Nicholas Herriot |
nherriot | 0:bcf2aa85d7f9 | 2 | /* Copyright (c) 2013 Vodafone, MIT License |
nherriot | 0:bcf2aa85d7f9 | 3 | * |
nherriot | 0:bcf2aa85d7f9 | 4 | * Permission is hereby granted, free of charge, to any person obtaining a copy of this software |
nherriot | 0:bcf2aa85d7f9 | 5 | * and associated documentation files (the "Software"), to deal in the Software without restriction, |
nherriot | 0:bcf2aa85d7f9 | 6 | * including without limitation the rights to use, copy, modify, merge, publish, distribute, |
nherriot | 0:bcf2aa85d7f9 | 7 | * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is |
nherriot | 0:bcf2aa85d7f9 | 8 | * furnished to do so, subject to the following conditions: |
nherriot | 0:bcf2aa85d7f9 | 9 | * |
nherriot | 0:bcf2aa85d7f9 | 10 | * The above copyright notice and this permission notice shall be included in all copies or |
nherriot | 0:bcf2aa85d7f9 | 11 | * substantial portions of the Software. |
nherriot | 0:bcf2aa85d7f9 | 12 | * |
nherriot | 0:bcf2aa85d7f9 | 13 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING |
nherriot | 0:bcf2aa85d7f9 | 14 | * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
nherriot | 0:bcf2aa85d7f9 | 15 | * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, |
nherriot | 0:bcf2aa85d7f9 | 16 | * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
nherriot | 0:bcf2aa85d7f9 | 17 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
nherriot | 0:bcf2aa85d7f9 | 18 | */ |
nherriot | 0:bcf2aa85d7f9 | 19 | |
nherriot | 0:bcf2aa85d7f9 | 20 | // the SparkFun breakout board defaults to 1, set to 0 if SA0 jumper on the bottom of the board is set |
nherriot | 0:bcf2aa85d7f9 | 21 | // see the Table 10. I2C Device Address Sequence in Freescale MMA8452Q pdf |
nherriot | 0:bcf2aa85d7f9 | 22 | |
nherriot | 0:bcf2aa85d7f9 | 23 | //#define SA0 1 |
nherriot | 0:bcf2aa85d7f9 | 24 | //#if SA0 |
nherriot | 0:bcf2aa85d7f9 | 25 | //#define MMA8452_ADDRESS 0x3A // SA0 is high, 0x1C if low - it should be 0x1D, but we shift now to save shifting in the code |
nherriot | 0:bcf2aa85d7f9 | 26 | //#else |
nherriot | 0:bcf2aa85d7f9 | 27 | //#define MMA8452_ADDRESS 0x1C |
nherriot | 0:bcf2aa85d7f9 | 28 | //#endif |
nherriot | 0:bcf2aa85d7f9 | 29 | |
nherriot | 0:bcf2aa85d7f9 | 30 | //#ifndef MBED_MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 31 | |
nherriot | 0:bcf2aa85d7f9 | 32 | //#define MBED_MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 33 | |
nherriot | 0:bcf2aa85d7f9 | 34 | #include "mbed.h" |
nherriot | 0:bcf2aa85d7f9 | 35 | |
nherriot | 0:bcf2aa85d7f9 | 36 | /** Accelerometer MMA8452 class |
nherriot | 0:bcf2aa85d7f9 | 37 | * |
nherriot | 0:bcf2aa85d7f9 | 38 | * Example: |
nherriot | 0:bcf2aa85d7f9 | 39 | * @code |
nherriot | 0:bcf2aa85d7f9 | 40 | * |
nherriot | 0:bcf2aa85d7f9 | 41 | * #include "mbed.h" |
nherriot | 0:bcf2aa85d7f9 | 42 | * #include "MMA8452.h" |
nherriot | 0:bcf2aa85d7f9 | 43 | * |
nherriot | 0:bcf2aa85d7f9 | 44 | * |
nherriot | 0:bcf2aa85d7f9 | 45 | * Accelerometer_MMA8452 Acc(p28, p27); |
nherriot | 0:bcf2aa85d7f9 | 46 | * serial pc(USBTX, USBRX); |
nherriot | 0:bcf2aa85d7f9 | 47 | * |
nherriot | 0:bcf2aa85d7f9 | 48 | * int main() |
nherriot | 0:bcf2aa85d7f9 | 49 | * { |
nherriot | 0:bcf2aa85d7f9 | 50 | * Acc.init(); |
nherriot | 0:bcf2aa85d7f9 | 51 | * while(1) |
nherriot | 0:bcf2aa85d7f9 | 52 | * { |
nherriot | 0:bcf2aa85d7f9 | 53 | * int x=0, y=0, z=0; |
nherriot | 0:bcf2aa85d7f9 | 54 | * Acc.read_Tilt(&x, &y, &z); |
nherriot | 0:bcf2aa85d7f9 | 55 | * pc.printf("Tilt x: %2.2f degree \n", x); // Print the tilt orientation of the X axis |
nherriot | 0:bcf2aa85d7f9 | 56 | * pc.printf("Tilt y: %2.2f degree \n", y); // Print the tilt orientation of the Y axis |
nherriot | 0:bcf2aa85d7f9 | 57 | * pc.printf("Tilt z: %2.2f degree \n", z); // Print the tilt orientation of the Z axis |
nherriot | 0:bcf2aa85d7f9 | 58 | * wait(1); |
nherriot | 0:bcf2aa85d7f9 | 59 | * } |
nherriot | 0:bcf2aa85d7f9 | 60 | * } |
nherriot | 0:bcf2aa85d7f9 | 61 | * @endcode |
nherriot | 0:bcf2aa85d7f9 | 62 | */ |
nherriot | 0:bcf2aa85d7f9 | 63 | |
nherriot | 0:bcf2aa85d7f9 | 64 | // More info on MCU Master address can be found on section 5.10.1 of http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=MMA8452Q |
nherriot | 0:bcf2aa85d7f9 | 65 | #define SA0 1 |
nherriot | 0:bcf2aa85d7f9 | 66 | #if SA0 |
nherriot | 0:bcf2aa85d7f9 | 67 | #define MMA8452_ADDRESS 0x1D // SA0 is high, 0x1C if low - |
nherriot | 0:bcf2aa85d7f9 | 68 | #else |
nherriot | 0:bcf2aa85d7f9 | 69 | #define MMA8452_ADDRESS 0x1C |
nherriot | 0:bcf2aa85d7f9 | 70 | #endif |
nherriot | 0:bcf2aa85d7f9 | 71 | |
nherriot | 0:bcf2aa85d7f9 | 72 | // Register descriptions found in section 6 of pdf |
nherriot | 0:bcf2aa85d7f9 | 73 | #define STATUS 0x00 // Type 'read' : Real time status, should return 0x00 |
nherriot | 0:bcf2aa85d7f9 | 74 | #define OUT_X_MSB 0x01 // Type 'read' : x axis - 8 most significatn bit of a 12 bit sample |
nherriot | 0:bcf2aa85d7f9 | 75 | #define OUT_X_LSB 0x02 // Type 'read' : x axis - 4 least significatn bit of a 12 bit sample |
nherriot | 0:bcf2aa85d7f9 | 76 | #define OUT_Y_MSB 0x03 // Type 'read' : y axis - 8 most significatn bit of a 12 bit sample |
nherriot | 0:bcf2aa85d7f9 | 77 | #define OUT_Y_LSB 0x04 // Type 'read' : y axis - 4 least significatn bit of a 12 bit sample |
nherriot | 0:bcf2aa85d7f9 | 78 | #define OUT_Z_MSB 0x05 // Type 'read' : z axis - 8 most significatn bit of a 12 bit sample |
nherriot | 0:bcf2aa85d7f9 | 79 | #define OUT_Z_LSB 0x06 // Type 'read' : z axis - 4 least significatn bit of a 12 bit sample |
nherriot | 0:bcf2aa85d7f9 | 80 | |
nherriot | 0:bcf2aa85d7f9 | 81 | #define SYSMOD 0x0B // Type 'read' : This tells you if device is active, sleep or standy 0x00=STANDBY 0x01=WAKE 0x02=SLEEP |
nherriot | 0:bcf2aa85d7f9 | 82 | #define WHO_AM_I 0x0D // Type 'read' : This should return the device id of 0x2A |
nherriot | 0:bcf2aa85d7f9 | 83 | |
nherriot | 0:bcf2aa85d7f9 | 84 | #define PL_STATUS 0x10 // Type 'read' : This shows portrait landscape mode orientation |
nherriot | 0:bcf2aa85d7f9 | 85 | #define PL_CFG 0x11 // Type 'read/write' : This allows portrait landscape configuration |
nherriot | 0:bcf2aa85d7f9 | 86 | #define PL_COUNT 0x12 // Type 'read' : This is the portraint landscape debounce counter |
nherriot | 0:bcf2aa85d7f9 | 87 | #define PL_BF_ZCOMP 0x13 // Type 'read' : |
nherriot | 0:bcf2aa85d7f9 | 88 | #define PL_THS_REG 0x14 // Type 'read' : |
nherriot | 0:bcf2aa85d7f9 | 89 | |
nherriot | 0:bcf2aa85d7f9 | 90 | #define FF_MT_CFG 0X15 // Type 'read/write' : Freefaul motion functional block configuration |
nherriot | 0:bcf2aa85d7f9 | 91 | #define FF_MT_SRC 0X16 // Type 'read' : Freefaul motion event source register |
nherriot | 0:bcf2aa85d7f9 | 92 | #define FF_COUNT 0X17 // Type 'read' : Freefaul motion threshold register |
nherriot | 0:bcf2aa85d7f9 | 93 | #define FF_COUNT 0X18 // Type 'read' : Freefaul motion debouce counter |
nherriot | 0:bcf2aa85d7f9 | 94 | |
nherriot | 0:bcf2aa85d7f9 | 95 | #define ASLP_COUNT 0x29 // Type 'read/write' : Counter setting for auto sleep |
nherriot | 0:bcf2aa85d7f9 | 96 | #define CTRL_REG_1 0x2A // Type 'read/write' : |
nherriot | 0:bcf2aa85d7f9 | 97 | #define CTRL_REG_2 0x2B // Type 'read/write' : |
nherriot | 0:bcf2aa85d7f9 | 98 | #define CTRL_REG_3 0x2C // Type 'read/write' : |
nherriot | 0:bcf2aa85d7f9 | 99 | #define CTRL_REG_4 0x2D // Type 'read/write' : |
nherriot | 0:bcf2aa85d7f9 | 100 | #define CTRL_REG_5 0x2E // Type 'read/write' : |
nherriot | 0:bcf2aa85d7f9 | 101 | |
nherriot | 0:bcf2aa85d7f9 | 102 | |
nherriot | 0:bcf2aa85d7f9 | 103 | |
nherriot | 0:bcf2aa85d7f9 | 104 | #define TILT_STATUS 0x03 // Tilt Status (Read only) |
nherriot | 0:bcf2aa85d7f9 | 105 | #define SRST_STATUS 0x04 // Sample Rate Status Register (Read only) |
nherriot | 0:bcf2aa85d7f9 | 106 | #define SPCNT_STATUS 0x05 // Sleep Count Register (Read/Write) |
nherriot | 0:bcf2aa85d7f9 | 107 | #define INTSU_STATUS 0x06 // Interrupt Setup Register |
nherriot | 0:bcf2aa85d7f9 | 108 | #define MODE_STATUS 0x07 // Mode Register (Read/Write) |
nherriot | 0:bcf2aa85d7f9 | 109 | #define SR_STATUS 0x08 // Auto-Wake and Active Mode Portrait/Landscape Samples per Seconds Register (Read/Write) |
nherriot | 0:bcf2aa85d7f9 | 110 | #define PDET_STATUS 0x09 // Tap/Pulse Detection Register (Read/Write) |
nherriot | 0:bcf2aa85d7f9 | 111 | #define PD_STATUS 0xA // Tap/Pulse Debounce Count Register (Read/Write) |
nherriot | 0:bcf2aa85d7f9 | 112 | |
nherriot | 0:bcf2aa85d7f9 | 113 | |
nherriot | 0:bcf2aa85d7f9 | 114 | |
nherriot | 0:bcf2aa85d7f9 | 115 | |
nherriot | 0:bcf2aa85d7f9 | 116 | |
nherriot | 0:bcf2aa85d7f9 | 117 | |
nherriot | 0:bcf2aa85d7f9 | 118 | class Accelerometer_MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 119 | { |
nherriot | 0:bcf2aa85d7f9 | 120 | public: |
nherriot | 0:bcf2aa85d7f9 | 121 | |
nherriot | 0:bcf2aa85d7f9 | 122 | |
nherriot | 0:bcf2aa85d7f9 | 123 | /** Create an accelerometer object connected to the specified I2C object |
nherriot | 0:bcf2aa85d7f9 | 124 | * |
nherriot | 0:bcf2aa85d7f9 | 125 | * @param sda I2C data port |
nherriot | 0:bcf2aa85d7f9 | 126 | * @param scl I2C8452 clock port |
nherriot | 0:bcf2aa85d7f9 | 127 | * |
nherriot | 0:bcf2aa85d7f9 | 128 | */ |
nherriot | 0:bcf2aa85d7f9 | 129 | Accelerometer_MMA8452(PinName sda, PinName scl); |
nherriot | 0:bcf2aa85d7f9 | 130 | |
nherriot | 0:bcf2aa85d7f9 | 131 | /** Destroys an MMA8452 object |
nherriot | 0:bcf2aa85d7f9 | 132 | * |
nherriot | 0:bcf2aa85d7f9 | 133 | */ |
nherriot | 0:bcf2aa85d7f9 | 134 | ~Accelerometer_MMA8452(); |
nherriot | 0:bcf2aa85d7f9 | 135 | |
nherriot | 0:bcf2aa85d7f9 | 136 | /** Activate the MMA8452 (required) |
nherriot | 0:bcf2aa85d7f9 | 137 | * |
nherriot | 0:bcf2aa85d7f9 | 138 | * |
nherriot | 0:bcf2aa85d7f9 | 139 | */ |
nherriot | 0:bcf2aa85d7f9 | 140 | int activate(); |
nherriot | 0:bcf2aa85d7f9 | 141 | |
nherriot | 0:bcf2aa85d7f9 | 142 | /** Initialization of device MMA8452 (required) |
nherriot | 0:bcf2aa85d7f9 | 143 | * |
nherriot | 0:bcf2aa85d7f9 | 144 | */ |
nherriot | 0:bcf2aa85d7f9 | 145 | void init(); |
nherriot | 0:bcf2aa85d7f9 | 146 | |
nherriot | 0:bcf2aa85d7f9 | 147 | /** Read the Tilt Angle using Three Axis |
nherriot | 0:bcf2aa85d7f9 | 148 | * |
nherriot | 0:bcf2aa85d7f9 | 149 | * @param *x Value of x tilt |
nherriot | 0:bcf2aa85d7f9 | 150 | * @param *y Value of y tilt |
nherriot | 0:bcf2aa85d7f9 | 151 | * @param *z Value of z tilt |
nherriot | 0:bcf2aa85d7f9 | 152 | */ |
nherriot | 0:bcf2aa85d7f9 | 153 | void read_Tilt(float *x, float *y, float *z); |
nherriot | 0:bcf2aa85d7f9 | 154 | |
nherriot | 0:bcf2aa85d7f9 | 155 | /** Read the x register of the MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 156 | * |
nherriot | 0:bcf2aa85d7f9 | 157 | * @returns The value of x acceleration |
nherriot | 0:bcf2aa85d7f9 | 158 | */ |
nherriot | 0:bcf2aa85d7f9 | 159 | int read_x(); |
nherriot | 0:bcf2aa85d7f9 | 160 | |
nherriot | 0:bcf2aa85d7f9 | 161 | /** Read the y register of the MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 162 | * |
nherriot | 0:bcf2aa85d7f9 | 163 | * @returns The value of y acceleration |
nherriot | 0:bcf2aa85d7f9 | 164 | */ |
nherriot | 0:bcf2aa85d7f9 | 165 | int read_y(); |
nherriot | 0:bcf2aa85d7f9 | 166 | |
nherriot | 0:bcf2aa85d7f9 | 167 | /** Read the z register of the MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 168 | * |
nherriot | 0:bcf2aa85d7f9 | 169 | * @returns The value of z acceleration |
nherriot | 0:bcf2aa85d7f9 | 170 | */ |
nherriot | 0:bcf2aa85d7f9 | 171 | int read_z(); |
nherriot | 0:bcf2aa85d7f9 | 172 | |
nherriot | 0:bcf2aa85d7f9 | 173 | /** Read from specified MMA8452 register |
nherriot | 0:bcf2aa85d7f9 | 174 | * |
nherriot | 0:bcf2aa85d7f9 | 175 | * @param addr The internal registeraddress of the MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 176 | * @returns The value of the register |
nherriot | 0:bcf2aa85d7f9 | 177 | */ |
nherriot | 0:bcf2aa85d7f9 | 178 | char read_reg(char addr); |
nherriot | 0:bcf2aa85d7f9 | 179 | |
nherriot | 0:bcf2aa85d7f9 | 180 | /** Write to specified MMA8452 register |
nherriot | 0:bcf2aa85d7f9 | 181 | * |
nherriot | 0:bcf2aa85d7f9 | 182 | * @param addr The internal registeraddress of the MMA8452 |
nherriot | 0:bcf2aa85d7f9 | 183 | * @param data New value of the register |
nherriot | 0:bcf2aa85d7f9 | 184 | */ |
nherriot | 0:bcf2aa85d7f9 | 185 | void write_reg(char addr, char data); |
nherriot | 0:bcf2aa85d7f9 | 186 | |
nherriot | 0:bcf2aa85d7f9 | 187 | |
nherriot | 0:bcf2aa85d7f9 | 188 | private: |
nherriot | 0:bcf2aa85d7f9 | 189 | I2C m_i2c; |
nherriot | 0:bcf2aa85d7f9 | 190 | int m_frequencey; |
nherriot | 0:bcf2aa85d7f9 | 191 | |
nherriot | 0:bcf2aa85d7f9 | 192 | }; |
nherriot | 0:bcf2aa85d7f9 | 193 | |
nherriot | 0:bcf2aa85d7f9 | 194 | //#endif |