Arduino implementation for GY-85 (ADXL345 accelerometer, ITG3200 gyroscope and HMC5883L magnetometer)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Resources/Images Added basic gyro and magnetometer stuff, wiring schematic, links Jul 24, 2015
.gitignore Added .gitignore Jul 24, 2015
LICENSE Initial commit Aug 5, 2014
README.md Added ToC Jun 10, 2017

README.md

Project Status: WIP - Initial development is in progress.

GY-85

Technical documentation for GY-85 (ADXL345 accelerometer, ITG3200 gyroscope and HMC5883L magnetometer). The code shown below can be seen as pseudocode, implementations for Arduino and Processing are in the making at the moment.

Theory

An inertial measurement unit (IMU) is an electronic device that measures and reports a craft's velocity, orientation, and gravitational forces, using a combination of accelerometers and gyroscopes, sometimes also magnetometers.

Inertial measurement unit on Wikipedia, the free encyclopedia.

The GY-85 contains three microcontroller, measuring acceleration, orientation and Earth's magnetic field. Values can be gathered using the I2C protocol. The X-axis and the Y-axis are horizontal and the Z-axis is vertical.

[IMG]

Rotations around the axis will be named after the aircraft principal axes. Therefor a rotation about the X-axis is called "roll", a rotation about the Y-axis "pitch" and about the Z-axis "yaw".

[IMG]

Accelerometer (ADXL345)

An accelerometer is a device that measures proper acceleration ("g-force"). Proper acceleration is not the same as coordinate acceleration (rate of change of velocity). For example, an accelerometer at rest on the surface of the Earth will measure an acceleration g= 9.81 m/s2 straight upwards. By contrast, accelerometers in free fall orbiting and accelerating due to the gravity of Earth will measure zero.

Accelerometer on Wikipedia, the free encyclopedia.

Thing with an accelerometer is, it is quite precise and does not drift, but it is impossible to measure changes about the Y axis. Simply put, that happens, because the gravity force does not change during a vertical rotation.

The accelerometer used on the GY-85 is the ADXL345 from Analog Devices. It measures acceleration for all three axis (x, y, z) and has a resolution up to 13 bit (detects changes less than 1.0°). The ADXL345 also has some nice extra features like tap and double tab detection, that can be used to trigger an interrupt on the Arduino.

Although it comes with a pretty good calibration, it is possible to calculate new values for calibrations and store them in the chip. These will automatically applied to all future measurements. The most common way to calibrate an accelerometer is to take a couple of measurements in idle state and calculate the average.

The chip usually returns digitalized sensor values with a resolution of 10 bit. To be able to further work with this data, the values have to be converted to a common unit like G.

Value in G = Measurement Value * (G-range/(2^Resolution))

The G-range and Resolution used in this formula depends of the configuration of the chip. The ADXL345 supports the ranges ±2g/±4g/±8g/±16g. As Resolution, 10 or 13 bit can be set. Measurement Value is simple the raw value, read from the chip for one axis. If the ADXL345 is used with the default settings, a resolution of 10 bit and a range of ±2g(=a range of 4g), the following formula can be used:

Value in G = Measurement Value * (4/(2^10)) = Measurement Value * (4/1024) = Measurement Value * (1/256) = Measurement Value * 0.0039

This calculation must be done for each axis separately. The resulting values are expected to be within ±1g.

xg = valX * 0.0039;
yg = valY * 0.0039;
zg = valZ * 0.0039;

These measurements are a bit jumpy and can further be improved by filtering them. An example for a low pass filter can be found here.

fXg = xg * alpha + fXg * (1.0 - alpha);
fYg = yg * alpha + fYg * (1.0 - alpha);
fZg = zg * alpha + fZg * (1.0 - alpha);

Having calculated the x, y and z values in g, these can be used to further calculate the angles. Based on the aircraft principal axes, the rotation about the X-axis is called roll, the rotation about the Y-axis is called pitch. Additional the rotation about the Z-axis would be called yaw, but an 3-axis accelerometer is not able to measure it, as the force vector of gravity does not change during the movement.

Roll = atan2(yg, zg) * 180/PI;
Pitch = atan2(-xg, sqrt(yg*yg + zg*zg)) * 180/PI;

The formulas have been pointed out by a StackOverflow user in reference to this document.

Links

Gyroscope (ITG3200)

A gyroscope [...] is a device for measuring or maintaining orientation, based on the principles of angular momentum.

Gyroscope on Wikipedia, the free encyclopedia.

The GY-85 uses InvenSense's ITG3200 to measure orientation. It can sense motion on all three axis and the sensor values are digitalized using a 16 bit ADC. In addition is also has an integrated temperature sensor.

It is necessary to divide the measured value by the "Sensitivity Scale Factor" to get the value in degree per second. This "Sensitivity Scale Factor" can be found the the datasheet.

Value in °/s = Measurement Value / Sensitivity Scale Factor

The "Sensitivity Scale Factor" is a constant and given with 14.375 LSB pro °/s.

Value in °/s = Measurement Value / 14.375

This has to be applied to all axes separately. The resulting values are expected in between ±2000°/s.

xds = valX / 14.375;
yds = valY / 14.375;
zds = valZ / 14.375;

// Angle

Angle += Value in °/s * Delta Time in Seconds

Roll += valX * dtime * 0.001;
Pitch += valY * dtime * 0.001;
Yaw += valZ * dtime * -0.001;

Trying to read the temperature from the chip only returns a huge integer. A constants to convert the sensor readings into degree celsius can be found in the datasheet on page 7. A value of -13200 represents 35° celsius, every 280 from there is another degree celsius. Therefor the following formula can be applied:

Temperature in °C = 35 + (Measurement Value + 13200)/280;

Links

Magnetometer (HMC5883L)

Magnetometers are measurement instruments used for two general purposes: to measure the magnetization of a magnetic material like a ferromagnet, or to measure the strength and, in some cases, the direction of the magnetic field at a point in space.

Magnetometer on Wikipedia, the free encyclopedia.

Honeywell's HMC5883L is a 3-axis digital magnetometer. The chip is most commonly used as a digital compass to sense the angle from magnetic north (not true north) in degrees.

// multiplicator = Gain, Digital Resolution (mG/LSb) for ± 1.3 Ga (see datasheet p. 13)

mx = valX * 0.92;
my = valY * 0.92;
mz = valZ * 0.92;

To now get the heading, arctangent is used.

Heading = atan2(my, mx);

Magnetic declination is the deviation between the measured magnetic north and the true north. Depending on the position on the planet, magnetic declination differs. Luckily, there are websites, that help to determine this value.

Taken for my current position, Graz/Austria, the magnetic declination angle is +3.87°. Once knowing this value the rest is easy, we convert this value in rad and add it to our heading.

Declination = +3.87 * PI/180 = 0.067544242052;
Heading += Declination;

Now we correct for when signs are reversed..

if (Heading < 0)
    Heading += 2*PI;

..and due to the addition of the declination.

if (Heading > 2*PI)
    Heading -= 2*PI;

Finally we convert our value to °.

Heading in ° = Heading * 180/PI;

Links

Aligning the axes

tba.

Stabilizing the results

To get the most stable results, it makes sense to combine the data, measured by the three chips.

tba.

// http://forums.parallax.com/showthread.php/152502-Tilt-Compensation-Magnetometer-%28-HMC5883L%29 // http://theboredengineers.com/2012/09/the-quadcopter-get-its-orientation-from-sensors/

Hardware

Wiring

Wiring of the GY-85

Guides and further reading

The following list contains articles and other resources, that help to understand the basic principals of the technology used on the GY-85.