L3GD20 & L3G4200D / STMicroelectronics / MEMS motion sensor, three-axis gyroscope library

Dependents:   GR-PEACH_test_wo_rtos GR-PEACH_test_on_rtos_works_well

Revision:
0:de66621e5370
Child:
1:9475fd0e35ff
diff -r 000000000000 -r de66621e5370 L3GD20.cpp
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/L3GD20.cpp	Fri Aug 29 13:26:33 2014 +0000
@@ -0,0 +1,151 @@
+/*
+ * mbed library program 
+ *  L3GD20 MEMS motion sensor: 3-axis digital gyroscope, made by STMicroelectronics
+ *      http://www.st.com/web/catalog/sense_power/FM89/SC1288
+ *          /PF252443?sc=internet/analog/product/252443.jsp
+ *  L3G4200 DMEMS motion sensor: three-axis digital output gyroscope, made by STMicroelectronics
+ *      http://www.st.com/web/catalog/sense_power/FM89/SC1288
+ *          /PF250373?sc=internet/analog/product/250373.jsp
+ *
+ * Copyright (c) 2014 Kenji Arai / JH1PJL
+ *  http://www.page.sannet.ne.jp/kenjia/index.html
+ *  http://mbed.org/users/kenjiArai/
+ *      Created: July      13th, 2014 
+ *      Revised: August    29th, 2014
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
+ * AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+ * DAMAGES OR OTHER  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+#include "L3GD20.h"
+
+L3GX_GYRO::L3GX_GYRO (PinName p_sda, PinName p_scl,
+    uint8_t addr, uint8_t data_rate, uint8_t bandwidth, uint8_t fullscale) : i2c(p_sda, p_scl) {
+    initialize (addr, data_rate, bandwidth, fullscale);
+}
+
+L3GX_GYRO::L3GX_GYRO (I2C& p_i2c,
+    uint8_t addr, uint8_t data_rate, uint8_t bandwidth, uint8_t fullscale) : i2c(p_i2c) { 
+    initialize (addr, data_rate, bandwidth, fullscale);
+}
+
+void L3GX_GYRO::initialize (uint8_t addr, uint8_t data_rate, uint8_t bandwidth, uint8_t fullscale) {
+    // Check gyro is available of not
+    gyro_addr = addr;
+    dbf[0] = L3GX_WHO_AM_I; 
+    i2c.write(gyro_addr, dbf, 1); 
+    i2c.read(gyro_addr, dbf, 1);
+    if (dbf[0] == I_AM_L3G4200D){
+        gyro_ready = 1;
+    } else if (dbf[0] == I_AM_L3GD20){
+        gyro_ready = 1;
+    } else {
+        gyro_ready = 0;
+        return;     // gyro chip is NOT on I2C line then terminate this part
+    }
+    //  Reg.1
+    dbf[0] = L3GX_CTRL_REG1;
+    dbf[1] = 0x0f;
+    dbf[1] |= data_rate << 6;
+    dbf[1] |= bandwidth << 4;
+    i2c.write(gyro_addr, dbf, 2);
+    //  Reg.3 
+    dbf[0] = L3GX_CTRL_REG3;
+    dbf[1] = 0x08;
+    i2c.write(gyro_addr, dbf, 2);
+    //  Reg.4
+    dbf[0] = L3GX_CTRL_REG4;
+    switch (fullscale){
+    case L3GX_FS_250DPS:
+        fs_factor = 0.00875;
+        dbf[1] = 0x80;
+        break;
+    case L3GX_FS_500DPS:
+        fs_factor = 0.0175;
+        dbf[1] = 0x90;
+        break;
+    case L3GX_FS_2000DPS:
+        fs_factor = 0.07;
+        dbf[1] = 0xa0;
+        break;
+    default:
+        ;
+    }
+    i2c.write(gyro_addr, dbf, 2);
+}
+
+void L3GX_GYRO::read_data(float *dt) {
+char data[6];
+
+    if (gyro_ready == 0){
+        dt[0] = 0;
+        dt[1] = 0;
+        dt[2] = 0;
+        return;  
+    }
+    // X,Y & Z
+        // manual said that
+        // In order to read multiple bytes, it is necessary to assert the most significant bit
+        // of the subaddress field.
+        // In other words, SUB(7) must be equal to ‘1’ while SUB(6-0) represents the address
+        // of the first register to be read.
+    dbf[0] = L3GX_OUT_X_L | 0x80;
+    i2c.write(gyro_addr, dbf, 1, true); 
+    i2c.read(gyro_addr, data, 6, false);
+    // data normalization
+    dt[0] = float(short(data[1] << 8 | data[0])) * fs_factor;
+    dt[1] = float(short(data[3] << 8 | data[2])) * fs_factor;
+    dt[2] = float(short(data[5] << 8 | data[4])) * fs_factor;   
+}
+
+int8_t L3GX_GYRO::read_temp() {
+    if (gyro_ready == 1){
+        dbf[0] = L3GX_OUT_TEMP; 
+        i2c.write(gyro_addr, dbf, 1);
+        i2c.read(gyro_addr, dbf, 1);
+    } else {
+        dbf[0] = 99;
+    }
+    return (int8_t)dbf[0];
+}
+
+uint8_t L3GX_GYRO::read_id() {
+    dbf[0] = L3GX_WHO_AM_I; 
+    i2c.write(gyro_addr, dbf, 1); 
+    i2c.read(gyro_addr, dbf, 1);
+    return (uint8_t)dbf[0];
+}
+    
+uint8_t L3GX_GYRO::data_ready() {
+    if (gyro_ready == 1){
+        dbf[0] = L3GX_STATUS_REG; 
+        i2c.write(gyro_addr, dbf, 1); 
+        i2c.read(gyro_addr, dbf, 1);
+        if (!(dbf[0] & 0x01)){
+            return 0;
+        }
+    }
+    return 1;;
+}
+
+uint8_t L3GX_GYRO::read_reg(uint8_t addr) {
+    if (gyro_ready == 1){
+        dbf[0] = addr; 
+        i2c.write(gyro_addr, dbf, 1); 
+        i2c.read(gyro_addr, dbf, 1);
+    } else {
+        dbf[0] = 0xff;
+    }
+    return (uint8_t)dbf[0];
+}
+
+void L3GX_GYRO::write_reg(uint8_t addr, uint8_t data) {
+    if (gyro_ready == 1){
+        dbf[0] = addr;
+        dbf[1] = data; 
+        i2c.write(gyro_addr, dbf, 2); 
+    }
+}