README.md
Adafruit LSM303DLHC Driver (Accelerometer + Magnetometer)

This driver is for the Adafruit LSM303 Breakout (<![CDATA[]]>http://www.adafruit.com/products/1120<![CDATA[]]>), and is based on Adafruit's Unified Sensor Library (Adafruit_Sensor).

About the LSM303

The LSM303 is a digital (I2C) accelerometer and digital compass (magnetometer).  The accelerometer allows you to measure acceleration or direction towards the center or the earth, and the magnetometer measure magnetic force, which is useful to detect magnetic north.

More information on the LSM303 can be found in the datasheet: <![CDATA[]]>http://www.adafruit.com/datasheets/LSM303DLHC.PDF<![CDATA[]]>

What is the Adafruit Unified Sensor Library?

The Adafruit Unified Sensor Library (Adafruit_Sensor) provides a common interface and data type for any supported sensor.  It defines some basic information about the sensor (sensor limits, etc.), and returns standard SI units of a specific type and scale for each supported sensor type.

It provides a simple abstraction layer between your application and the actual sensor HW, allowing you to drop in any comparable sensor with only one or two lines of code to change in your project (essentially the constructor since the functions to read sensor data and get information about the sensor are defined in the base Adafruit_Sensor class).

This is imporant useful for two reasons:

1.) You can use the data right away because it's already converted to SI units that you understand and can compare, rather than meaningless values like 0..1023.

2.) Because SI units are standardised in the sensor library, you can also do quick sanity checks working with new sensors, or drop in any comparable sensor if you need better sensitivity or if a lower cost unit becomes available, etc.

Light sensors will always report units in lux, gyroscopes will always report units in rad/s, etc. ... freeing you up to focus on the data, rather than digging through the datasheet to understand what the sensor's raw numbers really mean.

About this Driver

Adafruit invests time and resources providing this open source code.  Please support Adafruit and open-source hardware by purchasing products from Adafruit!

Written by Kevin (KTOWN) Townsend for Adafruit Industries.


Compatibility




  
MCU
  
Tested Works
  
Doesn't Work
  
Not Tested
  
Notes




  
Atmega328 @ 16MHz
  
X
  

  

  



  
Atmega328 @ 12MHz
  
X
  

  

  



  
Atmega32u4 @ 16MHz
  
X
  

  

  



  
Atmega32u4 @ 8MHz
  
X
  

  

  



  
ESP8266
  
X
  

  

  



  
Atmega2560 @ 16MHz
  
X
  

  

  
SDA/SCL D20/D21


  
ATSAM3X8E
  
X
  

  

  
SDA/SCL D20/D21


  
ATSAM21D
  
X
  

  

  



  
ATtiny85 @ 16MHz
  
X
  

  

  



  
ATtiny85 @ 8MHz
  
X
  

  

  



  
Intel Curie @ 32MHz
  
X
  

  

  



  
STM32F2
  

  

  
X
  






ATmega328 @ 16MHz : Arduino UNO, Adafruit Pro Trinket 5V, Adafruit Metro 328, Adafruit Metro Mini
ATmega328 @ 12MHz : Adafruit Pro Trinket 3V
ATmega32u4 @ 16MHz : Arduino Leonardo, Arduino Micro, Arduino Yun, Teensy 2.0
ATmega32u4 @ 8MHz : Adafruit Flora, Bluefruit Micro
ESP8266 : Adafruit Huzzah
ATmega2560 @ 16MHz : Arduino Mega
ATSAM3X8E : Arduino Due
ATSAM21D : Arduino Zero, M0 Pro
ATtiny85 @ 16MHz : Adafruit Trinket 5V
ATtiny85 @ 8MHz : Adafruit Gemma, Arduino Gemma, Adafruit Trinket 3V