upm/src/bno055/bno055.cxx
Jon Trulson aa047d6b5c bno055: enhance error detection and propagation
This patch reworks error handling in the C driver to more reliably detect
errors, and for C++, throw exceptions when they are detected.

The C++ API is unchanged aside from the fact that more methods will
throw an exception on errors now.

This addresses the error handling deficiencies reported in Issue #593.

Signed-off-by: Jon Trulson <jtrulson@ics.com>
Signed-off-by: Abhishek Malik <abhishek.malik@intel.com>
2017-08-21 13:53:27 -07:00

454 lines
13 KiB
C++

/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2016-17 Intel Corporation.
*
* The MIT License
*
* 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 <iostream>
#include <stdexcept>
#include "bno055.hpp"
using namespace upm;
using namespace std;
// conversion from Celsius to Fahrenheit
static float c2f(float c)
{
return (c * (9.0 / 5.0) + 32.0);
}
BNO055::BNO055(int bus, uint8_t addr) :
m_bno055(bno055_init(bus, addr))
{
if (!m_bno055)
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_init() failed");
}
BNO055::~BNO055()
{
bno055_close(m_bno055);
}
void BNO055::update()
{
if (bno055_update(m_bno055))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_update() failed");
}
uint8_t BNO055::readReg(uint8_t reg)
{
uint8_t rv = 0;
if (bno055_read_reg(m_bno055, reg, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_read_reg() failed");
return rv;
}
void BNO055::readRegs(uint8_t reg, uint8_t *buffer, int len)
{
if (bno055_read_regs(m_bno055, reg, buffer, len))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_read_regs() failed");
}
void BNO055::writeReg(uint8_t reg, uint8_t val)
{
if (bno055_write_reg(m_bno055, reg, val))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_write_reg() failed");
}
void BNO055::writeRegs(uint8_t reg, uint8_t *buffer, int len)
{
if (bno055_write_regs(m_bno055, reg, buffer, len))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_write_regs() failed");
}
uint8_t BNO055::getChipID()
{
uint8_t rv = 0;
if (bno055_get_chip_id(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_chip_id() failed");
return rv;
}
uint8_t BNO055::getACCID()
{
uint8_t rv = 0;
if (bno055_get_acc_id(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_acc_id() failed");
return rv;
}
uint8_t BNO055::getMAGID()
{
uint8_t rv = 0;
if (bno055_get_mag_id(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_mag_id() failed");
return rv;
}
uint8_t BNO055::getGYRID()
{
uint8_t rv = 0;
if (bno055_get_gyr_id(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_gyr_id() failed");
return rv;
}
uint16_t BNO055::getSWRevID()
{
uint16_t rv = 0;
if (bno055_get_sw_revision(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_sw_revision() failed");
return rv;
}
uint8_t BNO055::getBootLoaderID()
{
uint8_t rv = 0;
if (bno055_get_bootloader_id(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_bootloader_id() failed");
return rv;
}
void BNO055::setPage(uint8_t page, bool force)
{
if (bno055_set_page(m_bno055, page, force))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_page() failed");
}
void BNO055::setClockExternal(bool extClock)
{
if (bno055_set_clock_external(m_bno055, extClock))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_clock_external() failed");
}
void BNO055::setTemperatureSource(BNO055_TEMP_SOURCES_T src)
{
if (bno055_set_temperature_source(m_bno055, src))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_temperature_source() failed");
}
void BNO055::setAccelerometerUnits(bool mg)
{
if (bno055_set_accelerometer_units(m_bno055, mg))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_accelerometer_units() failed");
}
void BNO055::setGyroscopeUnits(bool radians)
{
if (bno055_set_gyroscope_units(m_bno055, radians))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_gyroscope_units() failed");
}
void BNO055::setEulerUnits(bool radians)
{
if (bno055_set_euler_units(m_bno055, radians))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_euler_units() failed");
}
void BNO055::setOperationMode(BNO055_OPERATION_MODES_T mode)
{
if (bno055_set_operation_mode(m_bno055, mode))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_operation_mode() failed");
}
void BNO055::getCalibrationStatus(int *mag, int *acc, int *gyr, int *sys)
{
if (bno055_get_calibration_status(m_bno055, mag, acc, gyr, sys))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_calibration_status() failed");
}
vector<int> BNO055::getCalibrationStatus()
{
int v[4]; // mag, acc, gyr, sys;
getCalibrationStatus(&v[0], &v[1], &v[2], &v[3]);
return vector<int>(v, v+4);
}
bool BNO055::isFullyCalibrated()
{
return bno055_is_fully_calibrated(m_bno055);
}
void BNO055::resetSystem()
{
if (bno055_reset_system(m_bno055))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_reset_system() failed");
}
void BNO055::resetInterruptStatus()
{
if (bno055_reset_interrupt_status(m_bno055))
throw std::runtime_error(string(__FUNCTION__)
+ ": reset_interrupt_status() failed");
}
uint8_t BNO055::getInterruptStatus()
{
uint8_t rv = 0;
if (bno055_get_interrupt_status(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055get_interrupt_status() failed");
return rv;
}
uint8_t BNO055::getInterruptEnable()
{
uint8_t rv = 0;
if (bno055_get_interrupt_enable(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_interrupt_enable() failed");
return rv;
}
void BNO055::setInterruptEnable(uint8_t enables)
{
if (bno055_set_interrupt_enable(m_bno055, enables))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_interrupt_enable() failed");
}
uint8_t BNO055::getInterruptMask()
{
uint8_t rv = 0;
if (bno055_get_interrupt_mask(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_interrupt_mask() failed");
return rv;
}
void BNO055::setInterruptMask(uint8_t mask)
{
if (bno055_set_interrupt_mask(m_bno055, mask))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_interrupt_mask() failed");
}
BNO055_SYS_STATUS_T BNO055::getSystemStatus()
{
BNO055_SYS_STATUS_T rv;
if (bno055_get_system_status(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_system_status() failed");
return rv;
}
BNO055_SYS_ERR_T BNO055::getSystemError()
{
BNO055_SYS_ERR_T rv;
if (bno055_get_system_error(m_bno055, &rv))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_get_system_error() failed");
return rv;
}
std::vector<uint8_t> BNO055::readCalibrationData()
{
uint8_t calibrationData[BNO055_CALIBRATION_DATA_SIZE];
if (bno055_read_calibration_data(m_bno055, calibrationData,
BNO055_CALIBRATION_DATA_SIZE))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_read_calibration_data() failed");
return vector<uint8_t>(calibrationData,
calibrationData+BNO055_CALIBRATION_DATA_SIZE);
}
void BNO055::writeCalibrationData(vector<uint8_t> calibrationData)
{
if (bno055_write_calibration_data(m_bno055, calibrationData.data(),
calibrationData.size()))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_write_calibration_data() failed");
}
float BNO055::getTemperature(bool fahrenheit)
{
float temperature = bno055_get_temperature(m_bno055);
if (fahrenheit)
return c2f(temperature);
else
return temperature;
}
void BNO055::getEulerAngles(float *heading, float *roll, float *pitch)
{
bno055_get_euler_angles(m_bno055, heading, roll, pitch);
}
vector<float> BNO055::getEulerAngles()
{
float v[3];
getEulerAngles(&v[0], &v[1], &v[2]);
return vector<float>(v, v+3);
}
void BNO055::getQuaternions(float *w, float *x, float *y, float *z)
{
bno055_get_quaternions(m_bno055, w, x, y, z);
}
vector<float> BNO055::getQuaternions()
{
float v[4];
getQuaternions(&v[0], &v[1], &v[2], &v[3]);
return vector<float>(v, v+4);
}
void BNO055::getLinearAcceleration(float *x, float *y, float *z)
{
bno055_get_linear_acceleration(m_bno055, x, y, z);
}
vector<float> BNO055::getLinearAcceleration()
{
float v[3];
getLinearAcceleration(&v[0], &v[1], &v[2]);
return vector<float>(v, v+3);
}
void BNO055::getGravityVectors(float *x, float *y, float *z)
{
bno055_get_gravity_vectors(m_bno055, x, y, z);
}
vector<float> BNO055::getGravityVectors()
{
static float v[3];
getGravityVectors(&v[0], &v[1], &v[2]);
return vector<float>(v, v+3);
}
void BNO055::getAccelerometer(float *x, float *y, float *z)
{
bno055_get_accelerometer(m_bno055, x, y, z);
}
vector<float> BNO055::getAccelerometer()
{
static float v[3];
getAccelerometer(&v[0], &v[1], &v[2]);
return vector<float>(v, v+3);
}
void BNO055::getMagnetometer(float *x, float *y, float *z)
{
bno055_get_magnetometer(m_bno055, x, y, z);
}
vector<float> BNO055::getMagnetometer()
{
float v[3];
getMagnetometer(&v[0], &v[1], &v[2]);
return vector<float>(v, v+3);
}
void BNO055::getGyroscope(float *x, float *y, float *z)
{
bno055_get_gyroscope(m_bno055, x, y, z);
}
vector<float> BNO055::getGyroscope()
{
float v[3];
getGyroscope(&v[0], &v[1], &v[2]);
return vector<float>(v, v+3);
}
void BNO055::setAccelerationConfig(BNO055_ACC_RANGE_T range,
BNO055_ACC_BW_T bw,
BNO055_ACC_PWR_MODE_T pwr)
{
if (bno055_set_acceleration_config(m_bno055, range, bw, pwr))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_acceleration_config() failed");
}
void BNO055::setMagnetometerConfig(BNO055_MAG_ODR_T odr,
BNO055_MAG_OPR_T opr,
BNO055_MAG_POWER_T pwr)
{
if (bno055_set_magnetometer_config(m_bno055, odr, opr, pwr))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_magnetometer_config() failed");
}
void BNO055::setGyroscopeConfig(BNO055_GYR_RANGE_T range,
BNO055_GYR_BW_T bw,
BNO055_GYR_POWER_MODE_T pwr)
{
if (bno055_set_gyroscope_config(m_bno055, range, bw, pwr))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_set_gyroscope_config() failed");
}
void BNO055::installISR(int gpio, mraa_gpio_edge_t level,
void (*isr)(void *), void *arg)
{
if (bno055_install_isr(m_bno055, gpio, level, isr, arg))
throw std::runtime_error(string(__FUNCTION__)
+ ": bno055_install_isr() failed");
}
void BNO055::uninstallISR()
{
bno055_uninstall_isr(m_bno055);
}