BMX055 Class Reference

API for the BMX055 9-axis Sensor Module. More...

Detailed Description

• ID: bmx055
• Name: BMX055 9-axis Sensor Module
• Category: accelerometer compass
• Manufacturer: mouser
• Connection: i2c gpio spi
• Link: http://www.mouser.com/ProductDetail/Bosch-Sensortec/0330SB0179/?qs=sGAEpiMZZMsrChSOYEGTCZo8d3KRE6KPUk8gVuWS2Ho%3d

The BMX055 is an integrated 9-axis sensor for the detection of movements and rotations and magnetic heading. It comprises the full functionality of a triaxial, low-g acceleration sensor, a triaxial angular rate sensor and a triaxial geomagnetic sensor.

The BMX055 senses orientation, tilt, motion, acceleration, rotation, shock, vibration and heading in cell phones, handhelds, computer peripherals, man-machine interfaces, virtual reality features and game controllers.

The BMX055 is essentially 3 separate devices in one: the BMA250E Accelerometer, the BMG160 Gyroscope, and the BMM150 Magnetometer. They are completely independant of each other.

This driver provides a very simple interface to these 3 devices. If finer control is desired, you should just use the separate BMA25E, BMG160, and BMM150 device classes directly. This driver simply initializes all three devices, and provides a mechanism to read accelerometer, gyroscope and magnetometer data from them.

  // Instantiate an BMX055 using default I2C parameters
  upm::BMX055 *sensor = new upm::BMX055();

  // now output data every 250 milliseconds
  while (shouldRun)
    {
      float x, y, z;

      sensor->update();

      sensor->getAccelerometer(&x, &y, &z);
      cout << "Accelerometer x: " << x
           << " y: " << y
           << " z: " << z
           << " g"
           << endl;

      sensor->getGyroscope(&x, &y, &z);
      cout << "Gyroscope x: " << x
           << " y: " << y
           << " z: " << z
           << " degrees/s"
           << endl;

      sensor->getMagnetometer(&x, &y, &z);
      cout << "Magnetometer x: " << x
           << " y: " << y
           << " z: " << z
           << " uT"
           << endl;

      cout << endl;

      usleep(250000);
    }

Public Member Functions
	BMX055 (int accelBus=BMA250E_I2C_BUS, int accelAddr=BMA250E_DEFAULT_ADDR, int accelCS=-1, int gyroBus=BMG160_I2C_BUS, int gyroAddr=BMG160_DEFAULT_ADDR, int gyroCS=-1, int magBus=BMM150_I2C_BUS, int magAddr=BMM150_DEFAULT_ADDR, int magCS=-1)
	~BMX055 ()
void	update ()
void	initAccelerometer (BMA250E::POWER_MODE_T pwr=BMA250E::POWER_MODE_NORMAL, BMA250E::RANGE_T range=BMA250E::RANGE_2G, BMA250E::BW_T bw=BMA250E::BW_250)
void	initGyroscope (BMG160::POWER_MODE_T pwr=BMG160::POWER_MODE_NORMAL, BMG160::RANGE_T range=BMG160::RANGE_250, BMG160::BW_T bw=BMG160::BW_400_47)
void	initMagnetometer (BMM150::USAGE_PRESETS_T usage=BMM150::USAGE_HIGH_ACCURACY)
void	getAccelerometer (float *x, float *y, float *z)
float *	getAccelerometer ()
void	getGyroscope (float *x, float *y, float *z)
float *	getGyroscope ()
void	getMagnetometer (float *x, float *y, float *z)
float *	getMagnetometer ()

Protected Attributes
BMA250E *	m_accel
BMG160 *	m_gyro
BMM150 *	m_mag

Constructor & Destructor Documentation

BMX055	(	int	accelBus = BMA250E_I2C_BUS,
		int	accelAddr = BMA250E_DEFAULT_ADDR,
		int	accelCS = -1,
		int	gyroBus = BMG160_I2C_BUS,
		int	gyroAddr = BMG160_DEFAULT_ADDR,
		int	gyroCS = -1,
		int	magBus = BMM150_I2C_BUS,
		int	magAddr = BMM150_DEFAULT_ADDR,
		int	magCS = -1
	)

BMX055 constructor.

This device can support both I2C and SPI. For SPI, set the addr to -1, and specify a positive integer representing the Chip Select (CS) pin for the cs argument. If you are using a hardware CS pin (like edison with arduino breakout), then you can connect the proper pin to the hardware CS pin on your MCU and supply -1 for cs. The default operating mode is I2C.

Parameters

accelBus	I2C or SPI bus to use. -1 to skip initializing this device.
accelAddr	The address for this device. -1 for SPI.
accelCS	The gpio pin to use for the SPI Chip Select. -1 for I2C or for SPI with a hardware controlled pin.
gyroBus	I2C or SPI bus to use. -1 to skip initializing this device.
gyroAddr	The address for this device. -1 for SPI.
gyroCS	The gpio pin to use for the SPI Chip Select. -1 for I2C or for SPI with a hardware controlled pin.
magBus	I2C or SPI bus to use. -1 to skip initializing this device.
magAddr	The address for this device. -1 for SPI.
magCS	The gpio pin to use for the SPI Chip Select. -1 for I2C or for SPI with a hardware controlled pin.

Here is the call graph for this function:

~BMX055

(

)

BMX055 Destructor.

Member Function Documentation

void update

(

void

)

Update the internal stored values from sensor data.

Here is the call graph for this function:

void initAccelerometer	(	BMA250E::POWER_MODE_T	pwr = BMA250E::POWER_MODE_NORMAL,
		BMA250E::RANGE_T	range = BMA250E::RANGE_2G,
		BMA250E::BW_T	bw = BMA250E::BW_250
	)

Initialize the accelerometer and start operation. This function is called from the constructor so will not typically need to be called by a user unless the device is reset or you want to change these values.

Parameters

pwr	One of the BMA250E::POWER_MODE_T values. The default is BMA250E::POWER_MODE_NORMAL.
range	One of the BMA250E::RANGE_T values. The default is BMA250E::RANGE_2G.
bw	One of the filtering BMA250E::BW_T values. The default is BMA250E::BW_250.

Here is the call graph for this function:

void initGyroscope	(	BMG160::POWER_MODE_T	pwr = BMG160::POWER_MODE_NORMAL,
		BMG160::RANGE_T	range = BMG160::RANGE_250,
		BMG160::BW_T	bw = BMG160::BW_400_47
	)

Initialize the gyroscope and start operation. This function is called from the constructor so will not typically need to be called by a user unless the device is reset or you want to change these values.

Parameters

pwr	One of the BMG160::POWER_MODE_T values. The default is BMG160::POWER_MODE_NORMAL.
range	One of the BMG160::RANGE_T values. The default is BMG160::RANGE_250.
bw	One of the filtering BMG160::BW_T values. The default is BMG160::BW_400_47.

Here is the call graph for this function:

void initMagnetometer

(

BMM150::USAGE_PRESETS_T

usage = BMM150::USAGE_HIGH_ACCURACY

)

Initialize the magnetometer and start operation. This function is called from the constructor so will not typically need to be called by a user unless the device is reset or you want to change these values. This method will call BMM150::setPresetMode() with the passed parameter.

Parameters

usage

One of the BMM150::USAGE_PRESETS_T values. The default is BMM150::USAGE_HIGH_ACCURACY.

Here is the call graph for this function:

void getAccelerometer	(	float *	x,
		float *	y,
		float *	z
	)

Return accelerometer data in gravities. update() must have been called prior to calling this method.

Parameters

x	Pointer to a floating point value that will have the current x component placed into it.
y	Pointer to a floating point value that will have the current y component placed into it.
z	Pointer to a floating point value that will have the current z component placed into it.

Here is the call graph for this function:

float * getAccelerometer

(

)

Return accelerometer data in gravities in the form of a floating point array. The pointer returned by this function is statically allocated and will be rewritten on each call. update() must have been called prior to calling this method.

Returns

A floating point array containing x, y, and z in that order.

Here is the call graph for this function:

void getGyroscope	(	float *	x,
		float *	y,
		float *	z
	)

Return gyroscope data in degrees per second. update() must have been called prior to calling this method.

Parameters

x	Pointer to a floating point value that will have the current x component placed into it.
y	Pointer to a floating point value that will have the current y component placed into it.
z	Pointer to a floating point value that will have the current z component placed into it.

Here is the call graph for this function:

float * getGyroscope

(

)

Return gyroscope data in degrees per second in the form of a floating point array. The pointer returned by this function is statically allocated and will be rewritten on each call. update() must have been called prior to calling this method.

Returns

A floating point array containing x, y, and z in that order.

Here is the call graph for this function:

void getMagnetometer	(	float *	x,
		float *	y,
		float *	z
	)

Return magnetometer data in micro-Teslas (uT). update() must have been called prior to calling this method.

Parameters

x	Pointer to a floating point value that will have the current x component placed into it.
y	Pointer to a floating point value that will have the current y component placed into it.
z	Pointer to a floating point value that will have the current z component placed into it.

Here is the call graph for this function:

float * getMagnetometer

(

)

Return magnetometer data in micro-Teslas (uT) in the form of a floating point array. The pointer returned by this function is statically allocated and will be rewritten on each call. update() must have been called prior to calling this method.

Returns

A floating point array containing x, y, and z in that order.

Here is the call graph for this function:

Collaboration diagram for BMX055:

---

The documentation for this class was generated from the following files:

• /iotdk/jenkins/workspace/upm-doc-stable/src/bmx055/bmx055.hpp
• /iotdk/jenkins/workspace/upm-doc-stable/src/bmx055/bmx055.cxx