//////////////////////////////////////////////////////////////////////////// // // This file is part of RTIMULib // // Copyright (c) 2014-2015, richards-tech // // Permission is hereby granted, free of charge, to any person obtaining a copy of // this software and associated documentation files (the "Software"), to deal in // the Software without restriction, including without limitation the rights to use, // copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the // Software, and to permit persons to whom the Software is furnished to do so, // subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // 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 "RTIMUGD20HM303D.h" #include "RTIMUSettings.h" // this sets the learning rate for compass running average calculation #define COMPASS_ALPHA 0.2f RTIMUGD20HM303D::RTIMUGD20HM303D(RTIMUSettings *settings) : RTIMU(settings) { m_sampleRate = 100; } RTIMUGD20HM303D::~RTIMUGD20HM303D() { } bool RTIMUGD20HM303D::IMUInit() { unsigned char result; #ifdef GD20HM303D_CACHE_MODE m_firstTime = true; m_cacheIn = m_cacheOut = m_cacheCount = 0; #endif // set validity flags m_imuData.fusionPoseValid = false; m_imuData.fusionQPoseValid = false; m_imuData.gyroValid = true; m_imuData.accelValid = true; m_imuData.compassValid = true; m_imuData.pressureValid = false; m_imuData.temperatureValid = false; m_imuData.humidityValid = false; // configure IMU m_gyroSlaveAddr = m_settings->m_I2CSlaveAddress; // work out accel/mag address if (m_settings->HALRead(LSM303D_ADDRESS0, LSM303D_WHO_AM_I, 1, &result, "")) { if (result == LSM303D_ID) { m_accelCompassSlaveAddr = LSM303D_ADDRESS0; } } else { m_accelCompassSlaveAddr = LSM303D_ADDRESS1; } setCalibrationData(); // enable the I2C bus if (!m_settings->HALOpen()) return false; // Set up the gyro if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_LOW_ODR, 0x04, "Failed to reset L3GD20H")) return false; if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_CTRL5, 0x80, "Failed to boot L3GD20H")) return false; if (!m_settings->HALRead(m_gyroSlaveAddr, L3GD20H_WHO_AM_I, 1, &result, "Failed to read L3GD20H id")) return false; if (result != L3GD20H_ID) { HAL_ERROR1("Incorrect L3GD20H id %d\n", result); return false; } if (!setGyroSampleRate()) return false; if (!setGyroCTRL2()) return false; if (!setGyroCTRL4()) return false; // Set up the accel/compass if (!m_settings->HALRead(m_accelCompassSlaveAddr, LSM303D_WHO_AM_I, 1, &result, "Failed to read LSM303D id")) return false; if (result != LSM303D_ID) { HAL_ERROR1("Incorrect LSM303D id %d\n", result); return false; } if (!setAccelCTRL1()) return false; if (!setAccelCTRL2()) return false; if (!setCompassCTRL5()) return false; if (!setCompassCTRL6()) return false; if (!setCompassCTRL7()) return false; #ifdef GD20HM303D_CACHE_MODE // turn on gyro fifo if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_FIFO_CTRL, 0x3f, "Failed to set L3GD20H FIFO mode")) return false; #endif if (!setGyroCTRL5()) return false; gyroBiasInit(); HAL_INFO("GD20HM303D init complete\n"); return true; } bool RTIMUGD20HM303D::setGyroSampleRate() { unsigned char ctrl1; unsigned char lowOdr = 0; switch (m_settings->m_GD20HM303DGyroSampleRate) { case L3GD20H_SAMPLERATE_12_5: ctrl1 = 0x0f; lowOdr = 1; m_sampleRate = 13; break; case L3GD20H_SAMPLERATE_25: ctrl1 = 0x4f; lowOdr = 1; m_sampleRate = 25; break; case L3GD20H_SAMPLERATE_50: ctrl1 = 0x8f; lowOdr = 1; m_sampleRate = 50; break; case L3GD20H_SAMPLERATE_100: ctrl1 = 0x0f; m_sampleRate = 100; break; case L3GD20H_SAMPLERATE_200: ctrl1 = 0x4f; m_sampleRate = 200; break; case L3GD20H_SAMPLERATE_400: ctrl1 = 0x8f; m_sampleRate = 400; break; case L3GD20H_SAMPLERATE_800: ctrl1 = 0xcf; m_sampleRate = 800; break; default: HAL_ERROR1("Illegal L3GD20H sample rate code %d\n", m_settings->m_GD20HM303DGyroSampleRate); return false; } m_sampleInterval = (uint64_t)1000000 / m_sampleRate; switch (m_settings->m_GD20HM303DGyroBW) { case L3GD20H_BANDWIDTH_0: ctrl1 |= 0x00; break; case L3GD20H_BANDWIDTH_1: ctrl1 |= 0x10; break; case L3GD20H_BANDWIDTH_2: ctrl1 |= 0x20; break; case L3GD20H_BANDWIDTH_3: ctrl1 |= 0x30; break; } if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_LOW_ODR, lowOdr, "Failed to set L3GD20H LOW_ODR")) return false; return (m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_CTRL1, ctrl1, "Failed to set L3GD20H CTRL1")); } bool RTIMUGD20HM303D::setGyroCTRL2() { if ((m_settings->m_GD20HM303DGyroHpf < L3GD20H_HPF_0) || (m_settings->m_GD20HM303DGyroHpf > L3GD20H_HPF_9)) { HAL_ERROR1("Illegal L3GD20H high pass filter code %d\n", m_settings->m_GD20HM303DGyroHpf); return false; } return m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_CTRL2, m_settings->m_GD20HM303DGyroHpf, "Failed to set L3GD20H CTRL2"); } bool RTIMUGD20HM303D::setGyroCTRL4() { unsigned char ctrl4; switch (m_settings->m_GD20HM303DGyroFsr) { case L3GD20H_FSR_245: ctrl4 = 0x00; m_gyroScale = (RTFLOAT)0.00875 * RTMATH_DEGREE_TO_RAD; break; case L3GD20H_FSR_500: ctrl4 = 0x10; m_gyroScale = (RTFLOAT)0.0175 * RTMATH_DEGREE_TO_RAD; break; case L3GD20H_FSR_2000: ctrl4 = 0x20; m_gyroScale = (RTFLOAT)0.07 * RTMATH_DEGREE_TO_RAD; break; default: HAL_ERROR1("Illegal L3GD20H FSR code %d\n", m_settings->m_GD20HM303DGyroFsr); return false; } return m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_CTRL4, ctrl4, "Failed to set L3GD20H CTRL4"); } bool RTIMUGD20HM303D::setGyroCTRL5() { unsigned char ctrl5; // Turn on hpf ctrl5 = 0x10; #ifdef GD20HM303D_CACHE_MODE // turn on fifo ctrl5 |= 0x40; #endif return m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_CTRL5, ctrl5, "Failed to set L3GD20H CTRL5"); } bool RTIMUGD20HM303D::setAccelCTRL1() { unsigned char ctrl1; if ((m_settings->m_GD20HM303DAccelSampleRate < 0) || (m_settings->m_GD20HM303DAccelSampleRate > 10)) { HAL_ERROR1("Illegal LSM303D accel sample rate code %d\n", m_settings->m_GD20HM303DAccelSampleRate); return false; } ctrl1 = (m_settings->m_GD20HM303DAccelSampleRate << 4) | 0x07; return m_settings->HALWrite(m_accelCompassSlaveAddr, LSM303D_CTRL1, ctrl1, "Failed to set LSM303D CTRL1"); } bool RTIMUGD20HM303D::setAccelCTRL2() { unsigned char ctrl2; if ((m_settings->m_GD20HM303DAccelLpf < 0) || (m_settings->m_GD20HM303DAccelLpf > 3)) { HAL_ERROR1("Illegal LSM303D accel low pass fiter code %d\n", m_settings->m_GD20HM303DAccelLpf); return false; } switch (m_settings->m_GD20HM303DAccelFsr) { case LSM303D_ACCEL_FSR_2: m_accelScale = (RTFLOAT)0.000061; break; case LSM303D_ACCEL_FSR_4: m_accelScale = (RTFLOAT)0.000122; break; case LSM303D_ACCEL_FSR_6: m_accelScale = (RTFLOAT)0.000183; break; case LSM303D_ACCEL_FSR_8: m_accelScale = (RTFLOAT)0.000244; break; case LSM303D_ACCEL_FSR_16: m_accelScale = (RTFLOAT)0.000732; break; default: HAL_ERROR1("Illegal LSM303D accel FSR code %d\n", m_settings->m_GD20HM303DAccelFsr); return false; } ctrl2 = (m_settings->m_GD20HM303DAccelLpf << 6) | (m_settings->m_GD20HM303DAccelFsr << 3); return m_settings->HALWrite(m_accelCompassSlaveAddr, LSM303D_CTRL2, ctrl2, "Failed to set LSM303D CTRL2"); } bool RTIMUGD20HM303D::setCompassCTRL5() { unsigned char ctrl5; if ((m_settings->m_GD20HM303DCompassSampleRate < 0) || (m_settings->m_GD20HM303DCompassSampleRate > 5)) { HAL_ERROR1("Illegal LSM303D compass sample rate code %d\n", m_settings->m_GD20HM303DCompassSampleRate); return false; } ctrl5 = (m_settings->m_GD20HM303DCompassSampleRate << 2); #ifdef GD20HM303D_CACHE_MODE // enable fifo ctrl5 |= 0x40; #endif return m_settings->HALWrite(m_accelCompassSlaveAddr, LSM303D_CTRL5, ctrl5, "Failed to set LSM303D CTRL5"); } bool RTIMUGD20HM303D::setCompassCTRL6() { unsigned char ctrl6; // convert FSR to uT switch (m_settings->m_GD20HM303DCompassFsr) { case LSM303D_COMPASS_FSR_2: ctrl6 = 0; m_compassScale = (RTFLOAT)0.008; break; case LSM303D_COMPASS_FSR_4: ctrl6 = 0x20; m_compassScale = (RTFLOAT)0.016; break; case LSM303D_COMPASS_FSR_8: ctrl6 = 0x40; m_compassScale = (RTFLOAT)0.032; break; case LSM303D_COMPASS_FSR_12: ctrl6 = 0x60; m_compassScale = (RTFLOAT)0.0479; break; default: HAL_ERROR1("Illegal LSM303D compass FSR code %d\n", m_settings->m_GD20HM303DCompassFsr); return false; } return m_settings->HALWrite(m_accelCompassSlaveAddr, LSM303D_CTRL6, ctrl6, "Failed to set LSM303D CTRL6"); } bool RTIMUGD20HM303D::setCompassCTRL7() { return m_settings->HALWrite(m_accelCompassSlaveAddr, LSM303D_CTRL7, 0x60, "Failed to set LSM303D CTRL7"); } int RTIMUGD20HM303D::IMUGetPollInterval() { return (400 / m_sampleRate); } bool RTIMUGD20HM303D::IMURead() { unsigned char status; unsigned char gyroData[6]; unsigned char accelData[6]; unsigned char compassData[6]; #ifdef GD20HM303D_CACHE_MODE int count; if (!m_settings->HALRead(m_gyroSlaveAddr, L3GD20H_FIFO_SRC, 1, &status, "Failed to read L3GD20H fifo status")) return false; if ((status & 0x40) != 0) { HAL_INFO("L3GD20H fifo overrun\n"); if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_CTRL5, 0x10, "Failed to set L3GD20H CTRL5")) return false; if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_FIFO_CTRL, 0x0, "Failed to set L3GD20H FIFO mode")) return false; if (!m_settings->HALWrite(m_gyroSlaveAddr, L3GD20H_FIFO_CTRL, 0x3f, "Failed to set L3GD20H FIFO mode")) return false; if (!setGyroCTRL5()) return false; m_imuData.timestamp += m_sampleInterval * 32; return false; } // get count of samples in fifo count = status & 0x1f; if ((m_cacheCount == 0) && (count > 0) && (count < GD20HM303D_FIFO_THRESH)) { // special case of a small fifo and nothing cached - just handle as simple read if (!m_settings->HALRead(m_gyroSlaveAddr, 0x80 | L3GD20H_OUT_X_L, 6, gyroData, "Failed to read L3GD20H data")) return false; if (!m_settings->HALRead(m_accelCompassSlaveAddr, 0x80 | LSM303D_OUT_X_L_A, 6, accelData, "Failed to read LSM303D accel data")) return false; if (!m_settings->HALRead(m_accelCompassSlaveAddr, 0x80 | LSM303D_OUT_X_L_M, 6, compassData, "Failed to read LSM303D compass data")) return false; if (m_firstTime) m_imuData.timestamp = RTMath::currentUSecsSinceEpoch(); else m_imuData.timestamp += m_sampleInterval; m_firstTime = false; } else { if (count >= GD20HM303D_FIFO_THRESH) { // need to create a cache block if (m_cacheCount == GD20HM303D_CACHE_BLOCK_COUNT) { // all cache blocks are full - discard oldest and update timestamp to account for lost samples m_imuData.timestamp += m_sampleInterval * m_cache[m_cacheOut].count; if (++m_cacheOut == GD20HM303D_CACHE_BLOCK_COUNT) m_cacheOut = 0; m_cacheCount--; } if (!m_settings->HALRead(m_gyroSlaveAddr, 0x80 | L3GD20H_OUT_X_L, GD20HM303D_FIFO_CHUNK_SIZE * GD20HM303D_FIFO_THRESH, m_cache[m_cacheIn].data, "Failed to read L3GD20H fifo data")) return false; if (!m_settings->HALRead(m_accelCompassSlaveAddr, 0x80 | LSM303D_OUT_X_L_A, 6, m_cache[m_cacheIn].accel, "Failed to read LSM303D accel data")) return false; if (!m_settings->HALRead(m_accelCompassSlaveAddr, 0x80 | LSM303D_OUT_X_L_M, 6, m_cache[m_cacheIn].compass, "Failed to read LSM303D compass data")) return false; m_cache[m_cacheIn].count = GD20HM303D_FIFO_THRESH; m_cache[m_cacheIn].index = 0; m_cacheCount++; if (++m_cacheIn == GD20HM303D_CACHE_BLOCK_COUNT) m_cacheIn = 0; } // now fifo has been read if necessary, get something to process if (m_cacheCount == 0) return false; memcpy(gyroData, m_cache[m_cacheOut].data + m_cache[m_cacheOut].index, GD20HM303D_FIFO_CHUNK_SIZE); memcpy(accelData, m_cache[m_cacheOut].accel, 6); memcpy(compassData, m_cache[m_cacheOut].compass, 6); m_cache[m_cacheOut].index += GD20HM303D_FIFO_CHUNK_SIZE; if (--m_cache[m_cacheOut].count == 0) { // this cache block is now empty if (++m_cacheOut == GD20HM303D_CACHE_BLOCK_COUNT) m_cacheOut = 0; m_cacheCount--; } if (m_firstTime) m_imuData.timestamp = RTMath::currentUSecsSinceEpoch(); else m_imuData.timestamp += m_sampleInterval; m_firstTime = false; } #else if (!m_settings->HALRead(m_gyroSlaveAddr, L3GD20H_STATUS, 1, &status, "Failed to read L3GD20H status")) return false; if ((status & 0x8) == 0) return false; if (!m_settings->HALRead(m_gyroSlaveAddr, 0x80 | L3GD20H_OUT_X_L, 6, gyroData, "Failed to read L3GD20H data")) return false; m_imuData.timestamp = RTMath::currentUSecsSinceEpoch(); if (!m_settings->HALRead(m_accelCompassSlaveAddr, 0x80 | LSM303D_OUT_X_L_A, 6, accelData, "Failed to read LSM303D accel data")) return false; if (!m_settings->HALRead(m_accelCompassSlaveAddr, 0x80 | LSM303D_OUT_X_L_M, 6, compassData, "Failed to read LSM303D compass data")) return false; #endif RTMath::convertToVector(gyroData, m_imuData.gyro, m_gyroScale, false); RTMath::convertToVector(accelData, m_imuData.accel, m_accelScale, false); RTMath::convertToVector(compassData, m_imuData.compass, m_compassScale, false); // sort out gyro axes m_imuData.gyro.setX(m_imuData.gyro.x()); m_imuData.gyro.setY(-m_imuData.gyro.y()); m_imuData.gyro.setZ(-m_imuData.gyro.z()); // sort out accel data; m_imuData.accel.setX(-m_imuData.accel.x()); // sort out compass axes m_imuData.compass.setY(-m_imuData.compass.y()); m_imuData.compass.setZ(-m_imuData.compass.z()); // now do standard processing handleGyroBias(); calibrateAverageCompass(); calibrateAccel(); // now update the filter updateFusion(); return true; }