adafruit_bno055 / Adafruit_BNO055.cpp @ 26f98bcd
History | View | Annotate | Download (12.588 KB)
| 1 | 4bc1c0c1 | Kevin Townsend | /***************************************************************************
|
|---|---|---|---|
| 2 | This is a library for the BNO055 orientation sensor
|
||
| 3 | |||
| 4 | Designed specifically to work with the Adafruit BNO055 Breakout.
|
||
| 5 | |||
| 6 | Pick one up today in the adafruit shop!
|
||
| 7 | ------> http://www.adafruit.com/products
|
||
| 8 | |||
| 9 | These sensors use I2C to communicate, 2 pins are required to interface.
|
||
| 10 | |||
| 11 | Adafruit invests time and resources providing this open source code,
|
||
| 12 | please support Adafruit andopen-source hardware by purchasing products
|
||
| 13 | from Adafruit!
|
||
| 14 | |||
| 15 | Written by KTOWN for Adafruit Industries.
|
||
| 16 | |||
| 17 | MIT license, all text above must be included in any redistribution
|
||
| 18 | ***************************************************************************/
|
||
| 19 | |||
| 20 | #if ARDUINO >= 100 |
||
| 21 | #include "Arduino.h" |
||
| 22 | #else
|
||
| 23 | #include "WProgram.h" |
||
| 24 | #endif
|
||
| 25 | |||
| 26 | #include <math.h> |
||
| 27 | #include <limits.h> |
||
| 28 | |||
| 29 | #include "Adafruit_BNO055.h" |
||
| 30 | |||
| 31 | /***************************************************************************
|
||
| 32 | CONSTRUCTOR
|
||
| 33 | ***************************************************************************/
|
||
| 34 | |||
| 35 | /**************************************************************************/
|
||
| 36 | /*!
|
||
| 37 | @brief Instantiates a new Adafruit_BNO055 class
|
||
| 38 | */
|
||
| 39 | /**************************************************************************/
|
||
| 40 | Adafruit_BNO055::Adafruit_BNO055(int32_t sensorID, uint8_t address) |
||
| 41 | {
|
||
| 42 | _sensorID = sensorID; |
||
| 43 | _address = address; |
||
| 44 | } |
||
| 45 | |||
| 46 | /***************************************************************************
|
||
| 47 | PUBLIC FUNCTIONS
|
||
| 48 | ***************************************************************************/
|
||
| 49 | |||
| 50 | /**************************************************************************/
|
||
| 51 | /*!
|
||
| 52 | @brief Sets up the HW
|
||
| 53 | */
|
||
| 54 | /**************************************************************************/
|
||
| 55 | bool Adafruit_BNO055::begin(adafruit_bno055_opmode_t mode)
|
||
| 56 | {
|
||
| 57 | /* Enable I2C */
|
||
| 58 | Wire.begin(); |
||
| 59 | |||
| 60 | /* Make sure we have the right device */
|
||
| 61 | uint8_t id = read8(BNO055_CHIP_ID_ADDR); |
||
| 62 | if(id != BNO055_ID)
|
||
| 63 | {
|
||
| 64 | return false; |
||
| 65 | } |
||
| 66 | |||
| 67 | /* Switch to config mode (just in case since this is the default) */
|
||
| 68 | setMode(OPERATION_MODE_CONFIG); |
||
| 69 | |||
| 70 | /* Set to normal power mode */
|
||
| 71 | write8(BNO055_PWR_MODE_ADDR, POWER_MODE_NORMAL); |
||
| 72 | delay(10);
|
||
| 73 | 26f98bcd | Kevin Townsend | |
| 74 | /* Set the output units */
|
||
| 75 | uint8_t unitsel = (0 << 7) | /* Orientation = Android */ |
||
| 76 | (0 << 4) | /* Temperature = Celsius */ |
||
| 77 | (0 << 2) | /* Euler = Degrees */ |
||
| 78 | (1 << 1) | /* Gyro = Rads */ |
||
| 79 | (0 << 0); /* Accelerometer = m/s^2 */ |
||
| 80 | write8(BNO055_UNIT_SEL_ADDR, unitsel); |
||
| 81 | |||
| 82 | /* Orientation = Android (0 << )*/
|
||
| 83 | /* Temperature = Celsisu (0 << 4)
|
||
| 84 | uint8_t unitsel =
|
||
| 85 | 4bc1c0c1 | Kevin Townsend | |
| 86 | /* Set the requested operating mode (see section 3.3) */
|
||
| 87 | write8(BNO055_OPR_MODE_ADDR, mode); |
||
| 88 | delay(20);
|
||
| 89 | |||
| 90 | return true; |
||
| 91 | } |
||
| 92 | |||
| 93 | /**************************************************************************/
|
||
| 94 | /*!
|
||
| 95 | @brief Puts the chip in the specified operating mode
|
||
| 96 | */
|
||
| 97 | /**************************************************************************/
|
||
| 98 | void Adafruit_BNO055::setMode(adafruit_bno055_opmode_t mode)
|
||
| 99 | {
|
||
| 100 | _mode = mode; |
||
| 101 | |||
| 102 | write8(BNO055_OPR_MODE_ADDR, _mode); |
||
| 103 | delay(30);
|
||
| 104 | } |
||
| 105 | |||
| 106 | /**************************************************************************/
|
||
| 107 | /*!
|
||
| 108 | @brief Gets the latest system status info
|
||
| 109 | */
|
||
| 110 | /**************************************************************************/
|
||
| 111 | void Adafruit_BNO055::getSystemStatus(adafruit_bno055_system_status_t * status)
|
||
| 112 | {
|
||
| 113 | memset(status, 0, sizeof(adafruit_bno055_system_status_t)); |
||
| 114 | |||
| 115 | /* Read the system status register */
|
||
| 116 | status->system_status = read8(BNO055_SYS_STAT_ADDR); |
||
| 117 | status->self_test_result = read8(BNO055_SELFTEST_RESULT_ADDR); |
||
| 118 | status->system_error = read8(BNO055_SYS_ERR_ADDR); |
||
| 119 | } |
||
| 120 | |||
| 121 | /**************************************************************************/
|
||
| 122 | /*!
|
||
| 123 | @brief Displays system status info via Serial.print
|
||
| 124 | */
|
||
| 125 | /**************************************************************************/
|
||
| 126 | void Adafruit_BNO055::displaySystemStatus(void) |
||
| 127 | {
|
||
| 128 | adafruit_bno055_system_status_t status; |
||
| 129 | getSystemStatus(&status); |
||
| 130 | |||
| 131 | /* System Status (see section 4.3.58)
|
||
| 132 | ---------------------------------
|
||
| 133 | 0 = Idle
|
||
| 134 | 1 = System Error
|
||
| 135 | 2 = Initializing Peripherals
|
||
| 136 | 3 = System Iniitalization
|
||
| 137 | 4 = Executing Self-Test
|
||
| 138 | 5 = Sensor fusio algorithm running
|
||
| 139 | 6 = System running without fusion algorithms */
|
||
| 140 | |||
| 141 | Serial.print("System Status: 0x");
|
||
| 142 | Serial.println(status.system_status, HEX); |
||
| 143 | |||
| 144 | /* Self Test Results (see section )
|
||
| 145 | --------------------------------
|
||
| 146 | 1 = test passed, 0 = test failed
|
||
| 147 |
|
||
| 148 | Bit 0 = Accelerometer self test
|
||
| 149 | Bit 1 = Magnetometer self test
|
||
| 150 | Bit 2 = Gyroscope self test
|
||
| 151 | Bit 3 = MCU self test
|
||
| 152 |
|
||
| 153 | 0x0F = all good! */
|
||
| 154 | |||
| 155 | Serial.print("Self Test Results: 0x");
|
||
| 156 | Serial.println(status.self_test_result, HEX); |
||
| 157 | |||
| 158 | /* System Error (see section 4.3.59)
|
||
| 159 | ---------------------------------
|
||
| 160 | 0 = No error
|
||
| 161 | 1 = Peripheral initialization error
|
||
| 162 | 2 = System initialization error
|
||
| 163 | 3 = Self test result failed
|
||
| 164 | 4 = Register map value out of range
|
||
| 165 | 5 = Register map address out of range
|
||
| 166 | 6 = Register map write error
|
||
| 167 | 7 = BNO low power mode not available for selected operat ion mode
|
||
| 168 | 8 = Accelerometer power mode not available
|
||
| 169 | 9 = Fusion algorithm configuration error
|
||
| 170 | A = Sensor configuration error */
|
||
| 171 | |||
| 172 | Serial.print("System Error: 0x");
|
||
| 173 | Serial.println(status.system_error, HEX); |
||
| 174 | } |
||
| 175 | |||
| 176 | /**************************************************************************/
|
||
| 177 | /*!
|
||
| 178 | @brief Gets the chip revision numbers
|
||
| 179 | */
|
||
| 180 | /**************************************************************************/
|
||
| 181 | void Adafruit_BNO055::getRevInfo(adafruit_bno055_rev_info_t* info)
|
||
| 182 | {
|
||
| 183 | uint8_t a, b; |
||
| 184 | |||
| 185 | memset(info, 0, sizeof(adafruit_bno055_rev_info_t)); |
||
| 186 | |||
| 187 | info->accel_rev = read8(BNO055_ACCEL_REV_ID_ADDR); |
||
| 188 | info->mag_rev = read8(BNO055_MAG_REV_ID_ADDR); |
||
| 189 | info->gyro_rev = read8(BNO055_GYRO_REV_ID_ADDR); |
||
| 190 | info->bl_rev = read8(BNO055_BL_REV_ID_ADDR); |
||
| 191 | |||
| 192 | a = read8(BNO055_SW_REV_ID_LSB_ADDR); |
||
| 193 | b = read8(BNO055_SW_REV_ID_MSB_ADDR); |
||
| 194 | info->sw_rev = (((uint16_t)b) << 8) | ((uint16_t)a);
|
||
| 195 | } |
||
| 196 | |||
| 197 | /**************************************************************************/
|
||
| 198 | /*!
|
||
| 199 | @brief Displays the chip revision numbers via Serial.print
|
||
| 200 | */
|
||
| 201 | /**************************************************************************/
|
||
| 202 | void Adafruit_BNO055::displayRevInfo(void) |
||
| 203 | {
|
||
| 204 | adafruit_bno055_rev_info_t info; |
||
| 205 | getRevInfo(&info); |
||
| 206 | |||
| 207 | /* Check the accelerometer revision */
|
||
| 208 | Serial.print("Accelerometer Revision: 0x");
|
||
| 209 | Serial.println(info.accel_rev, HEX); |
||
| 210 | |||
| 211 | /* Check the magnetometer revision */
|
||
| 212 | Serial.print("Magnetometer Revision: 0x");
|
||
| 213 | Serial.println(info.mag_rev, HEX); |
||
| 214 | |||
| 215 | /* Check the gyroscope revision */
|
||
| 216 | Serial.print("Gyroscope Revision: 0x");
|
||
| 217 | Serial.println(info.gyro_rev, HEX); |
||
| 218 | |||
| 219 | /* Check the SW revision */
|
||
| 220 | Serial.print("SW Revision: 0x");
|
||
| 221 | Serial.println(info.sw_rev, HEX); |
||
| 222 | |||
| 223 | /* Check the bootloader revision */
|
||
| 224 | Serial.print("Bootloader Revision: 0x");
|
||
| 225 | Serial.println(info.bl_rev, HEX); |
||
| 226 | } |
||
| 227 | |||
| 228 | /**************************************************************************/
|
||
| 229 | /*!
|
||
| 230 | 48741e1f | Kevin Townsend | @brief Gets a vector reading from the specified source
|
| 231 | 4bc1c0c1 | Kevin Townsend | */
|
| 232 | /**************************************************************************/
|
||
| 233 | 48741e1f | Kevin Townsend | imu::Vector<3> Adafruit_BNO055::getVector(adafruit_vector_type_t vector_type)
|
| 234 | 4bc1c0c1 | Kevin Townsend | {
|
| 235 | imu::Vector<3> xyz;
|
||
| 236 | uint8_t buffer[6];
|
||
| 237 | memset (buffer, 0, 6); |
||
| 238 | |||
| 239 | int16_t x, y, z; |
||
| 240 | x = y = z = 0;
|
||
| 241 | |||
| 242 | 48741e1f | Kevin Townsend | /* Read vector data (6 bytes) */
|
| 243 | readLen((adafruit_bno055_reg_t)vector_type, buffer, 6);
|
||
| 244 | 4bc1c0c1 | Kevin Townsend | x = (((uint16_t)buffer[1]) << 8) | ((uint16_t)buffer[0]); |
| 245 | y = (((uint16_t)buffer[3]) << 8) | ((uint16_t)buffer[2]); |
||
| 246 | z = (((uint16_t)buffer[5]) << 8) | ((uint16_t)buffer[4]); |
||
| 247 | 26f98bcd | Kevin Townsend | |
| 248 | /* Convert the value to an appropriate range (section 3.6.4) */
|
||
| 249 | /* and assign the value to the Vector type */
|
||
| 250 | switch(vector_type)
|
||
| 251 | {
|
||
| 252 | case VECTOR_MAGNETOMETER:
|
||
| 253 | /* 1uT = 16 LSB */
|
||
| 254 | xyz[0] = ((double)x)/16.0; |
||
| 255 | xyz[1] = ((double)y)/16.0; |
||
| 256 | xyz[2] = ((double)z)/16.0; |
||
| 257 | break;
|
||
| 258 | case VECTOR_GYROSCOPE:
|
||
| 259 | /* 1rps = 900 LSB */
|
||
| 260 | xyz[0] = ((double)x)/900.0; |
||
| 261 | xyz[1] = ((double)y)/900.0; |
||
| 262 | xyz[2] = ((double)z)/900.0; |
||
| 263 | break;
|
||
| 264 | case VECTOR_EULER:
|
||
| 265 | /* 1 degree = 16 LSB */
|
||
| 266 | xyz[0] = ((double)x)/16.0; |
||
| 267 | xyz[1] = ((double)y)/16.0; |
||
| 268 | xyz[2] = ((double)z)/16.0; |
||
| 269 | break;
|
||
| 270 | case VECTOR_ACCELEROMETER:
|
||
| 271 | case VECTOR_LINEARACCEL:
|
||
| 272 | case VECTOR_GRAVITY:
|
||
| 273 | /* 1m/s^2 = 100 LSB */
|
||
| 274 | xyz[0] = ((double)x)/100.0; |
||
| 275 | xyz[1] = ((double)y)/100.0; |
||
| 276 | xyz[2] = ((double)z)/100.0; |
||
| 277 | break;
|
||
| 278 | } |
||
| 279 | 4bc1c0c1 | Kevin Townsend | |
| 280 | return xyz;
|
||
| 281 | } |
||
| 282 | |||
| 283 | /**************************************************************************/
|
||
| 284 | /*!
|
||
| 285 | 48741e1f | Kevin Townsend | @brief Gets a quaternion reading from the specified source
|
| 286 | */
|
||
| 287 | /**************************************************************************/
|
||
| 288 | imu::Quaternion Adafruit_BNO055::getQuat(void)
|
||
| 289 | {
|
||
| 290 | uint8_t buffer[8];
|
||
| 291 | memset (buffer, 0, 8); |
||
| 292 | |||
| 293 | int16_t x, y, z, w; |
||
| 294 | x = y = z = w = 0;
|
||
| 295 | |||
| 296 | /* Read quat data (8 bytes) */
|
||
| 297 | readLen(BNO055_QUATERNION_DATA_W_LSB_ADDR, buffer, 8);
|
||
| 298 | w = (((uint16_t)buffer[1]) << 8) | ((uint16_t)buffer[0]); |
||
| 299 | x = (((uint16_t)buffer[3]) << 8) | ((uint16_t)buffer[2]); |
||
| 300 | y = (((uint16_t)buffer[5]) << 8) | ((uint16_t)buffer[4]); |
||
| 301 | z = (((uint16_t)buffer[7]) << 8) | ((uint16_t)buffer[6]); |
||
| 302 | |||
| 303 | /* Assign to Quaternion */
|
||
| 304 | imu::Quaternion quat((double)w, (double)x, (double)y, (double)z); |
||
| 305 | return quat;
|
||
| 306 | } |
||
| 307 | |||
| 308 | /**************************************************************************/
|
||
| 309 | /*!
|
||
| 310 | 4bc1c0c1 | Kevin Townsend | @brief Provides the sensor_t data for this sensor
|
| 311 | */
|
||
| 312 | /**************************************************************************/
|
||
| 313 | void Adafruit_BNO055::getSensor(sensor_t *sensor)
|
||
| 314 | {
|
||
| 315 | /* Clear the sensor_t object */
|
||
| 316 | memset(sensor, 0, sizeof(sensor_t)); |
||
| 317 | |||
| 318 | /* Insert the sensor name in the fixed length char array */
|
||
| 319 | strncpy (sensor->name, "BNO055", sizeof(sensor->name) - 1); |
||
| 320 | sensor->name[sizeof(sensor->name)- 1] = 0; |
||
| 321 | sensor->version = 1;
|
||
| 322 | sensor->sensor_id = _sensorID; |
||
| 323 | sensor->type = SENSOR_TYPE_ORIENTATION; |
||
| 324 | sensor->min_delay = 0;
|
||
| 325 | sensor->max_value = 0.0F; |
||
| 326 | sensor->min_value = 0.0F; |
||
| 327 | sensor->resolution = 0.01F; |
||
| 328 | } |
||
| 329 | |||
| 330 | /**************************************************************************/
|
||
| 331 | /*!
|
||
| 332 | @brief Reads the sensor and returns the data as a sensors_event_t
|
||
| 333 | */
|
||
| 334 | /**************************************************************************/
|
||
| 335 | bool Adafruit_BNO055::getEvent(sensors_event_t *event)
|
||
| 336 | {
|
||
| 337 | float orientation;
|
||
| 338 | |||
| 339 | /* Clear the event */
|
||
| 340 | memset(event, 0, sizeof(sensors_event_t)); |
||
| 341 | |||
| 342 | event->version = sizeof(sensors_event_t);
|
||
| 343 | event->sensor_id = _sensorID; |
||
| 344 | event->type = SENSOR_TYPE_ORIENTATION; |
||
| 345 | event->timestamp = 0;
|
||
| 346 | /*
|
||
| 347 | getPressure(&pressure_kPa);
|
||
| 348 | event->pressure = pressure_kPa / 100.0F;
|
||
| 349 | */
|
||
| 350 | |||
| 351 | return true; |
||
| 352 | } |
||
| 353 | |||
| 354 | /***************************************************************************
|
||
| 355 | PRIVATE FUNCTIONS
|
||
| 356 | ***************************************************************************/
|
||
| 357 | |||
| 358 | /**************************************************************************/
|
||
| 359 | /*!
|
||
| 360 | @brief Writes an 8 bit value over I2C
|
||
| 361 | */
|
||
| 362 | /**************************************************************************/
|
||
| 363 | bool Adafruit_BNO055::write8(adafruit_bno055_reg_t reg, byte value)
|
||
| 364 | {
|
||
| 365 | Wire.beginTransmission(_address); |
||
| 366 | #if ARDUINO >= 100 |
||
| 367 | Wire.write((uint8_t)reg); |
||
| 368 | Wire.write((uint8_t)value); |
||
| 369 | #else
|
||
| 370 | Wire.send(reg); |
||
| 371 | Wire.send(value); |
||
| 372 | #endif
|
||
| 373 | Wire.endTransmission(); |
||
| 374 | |||
| 375 | /* ToDo: Check for error! */
|
||
| 376 | return true; |
||
| 377 | } |
||
| 378 | |||
| 379 | /**************************************************************************/
|
||
| 380 | /*!
|
||
| 381 | @brief Reads an 8 bit value over I2C
|
||
| 382 | */
|
||
| 383 | /**************************************************************************/
|
||
| 384 | byte Adafruit_BNO055::read8(adafruit_bno055_reg_t reg ) |
||
| 385 | {
|
||
| 386 | byte value = 0;
|
||
| 387 | |||
| 388 | Wire.beginTransmission(_address); |
||
| 389 | #if ARDUINO >= 100 |
||
| 390 | Wire.write((uint8_t)reg); |
||
| 391 | #else
|
||
| 392 | Wire.send(reg); |
||
| 393 | #endif
|
||
| 394 | Wire.endTransmission(); |
||
| 395 | Wire.requestFrom(_address, (byte)1);
|
||
| 396 | #if ARDUINO >= 100 |
||
| 397 | value = Wire.read(); |
||
| 398 | #else
|
||
| 399 | value = Wire.receive(); |
||
| 400 | #endif
|
||
| 401 | |||
| 402 | return value;
|
||
| 403 | } |
||
| 404 | |||
| 405 | /**************************************************************************/
|
||
| 406 | /*!
|
||
| 407 | @brief Reads the specified number of bytes over I2C
|
||
| 408 | */
|
||
| 409 | /**************************************************************************/
|
||
| 410 | bool Adafruit_BNO055::readLen(adafruit_bno055_reg_t reg, byte * buffer, uint8_t len)
|
||
| 411 | {
|
||
| 412 | Wire.beginTransmission(_address); |
||
| 413 | #if ARDUINO >= 100 |
||
| 414 | Wire.write((uint8_t)reg); |
||
| 415 | #else
|
||
| 416 | Wire.send(reg); |
||
| 417 | #endif
|
||
| 418 | Wire.endTransmission(); |
||
| 419 | Wire.requestFrom(_address, (byte)len); |
||
| 420 | |||
| 421 | /* Wait until data is available */
|
||
| 422 | while (Wire.available() < len);
|
||
| 423 | |||
| 424 | for (uint8_t i = 0; i < len; i++) |
||
| 425 | {
|
||
| 426 | #if ARDUINO >= 100 |
||
| 427 | buffer[i] = Wire.read(); |
||
| 428 | #else
|
||
| 429 | buffer[i] = Wire.receive(); |
||
| 430 | #endif
|
||
| 431 | } |
||
| 432 | |||
| 433 | /* ToDo: Check for errors! */
|
||
| 434 | return true; |
||
| 435 | } |