Skip to content

Commit 762e2de

Browse files
committed
Update README
1 parent c55b848 commit 762e2de

File tree

1 file changed

+9
-23
lines changed

1 file changed

+9
-23
lines changed

README

Lines changed: 9 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,15 @@
1-
The I2C Device Library (i2cdevlib) is a collection of uniform and well-documented classes to provide simple and intuitive interfaces to I2C devices. Each device is built to make use of the generic "i2cdev" class, which abstracts the I2C bit- and byte-level communication away from each specific device class, making it easy to keep the device class clean while providing a simple way to modify just one class to port the I2C communication code onto different platforms (Arduino, PIC, simple bit-banging, etc.).
1+
============================================================================
2+
Note: for details about this project, please visit: http://www.i2cdevlib.com
3+
============================================================================
24

3-
The code is written to support the Arduino/Wiring implementation, but it may be useful in other circumstances. The "I2CdevDemo.pde" file is an Arduino IDE sketch that demonstrates some basic usage of the generic and specific classes. Additionally, the I2Cdev class is built to be used statically, reducing the memory requirement if you have multiple I2C devices in your project. Only one instance of the I2Cdev class is required.
5+
The I2C Device Library (i2cdevlib) is a collection of uniform and well-documented classes to provide simple and intuitive interfaces to I2C devices. Each device is built to make use of the generic "I2Cdev" class, which abstracts the I2C bit- and byte-level communication away from each specific device class, making it easy to keep the device class clean while providing a simple way to modify just one class to port the I2C communication code onto different platforms (Arduino, PIC, simple bit-banging, etc.). Device classes are designed to provide complete coverage of all functionality described by each device's documentation, plus any generic convenience functions that are helpful.
46

5-
Documentation for each class is created using Doxygen-style comments placed in each class definition file, based on the information available in each device's datasheet.
7+
The code is written primarily to support the Arduino/Wiring implementation, but it may be useful in other circumstances. There are multiple I2C/TWI implementations selectable in the I2Cdev.h header file if the default Arduino "Wire.h" is not available or preferable for any reason.
68

7-
To use the library, just place the I2Cdev .cpp/.h source files and any device library .cpp/.h source files in the same folder as your sketch (or a suitable place relative to your avr-gcc project), and include just the device library headers that you need. Arduino users will also need to include <Wire.h> in your main sketch source file. Create a single device object (e.g. "ADXL345 accel();"), place any appropriate init function calls in your setup() routine (e.g. "accel.initialize();"), and off you go! See the I2CDevDemo.pde example sketch for reference.
9+
There are examples in many of the classes that demonstrate basic usage patterns. The I2Cdev class is built to be used statically, reducing the memory requirement if you have multiple I2C devices in your project. Only one instance of the I2Cdev class is required.
810

9-
COMPLETED DEVICE LIBRARIES:
10-
===========================
11-
- ADS1115 - Texas Instruments ADS1115 16-bit A/D converter
12-
- ADXL345 - Analog Devices ADXL345 3-axis accelerometer
13-
- HMC5843 - Honeywell HMC5843 3-axis magnetometer
14-
- HMC5883L - Honeywell HMC5883L 3-axis magnetometer
15-
- ITG3200 - InvenSense ITG-3200 3-axis gyroscope
16-
- TCA6424A - Texas Instruments TCA6424A 24-bit I/O expander
11+
Documentation for each class is created using Doxygen-style comments placed in each class definition file, based on the information available in each device's datasheet. This documentation is available in HTML format on the i2cdevlib.com website, which also holds helpful information for most of the classes present here on the repository.
1712

18-
IN-PROGRESS DEVICE LIBRARIES:
19-
=============================
20-
- AK8975 - AKM AK8975 3-axis magnetometer (missing documentation only)
21-
- MPR121 - Freescale MPR121 12-bit capacitive touch sensor (thanks to Andrew Schamp)
22-
- MPU6050 - InvenSense MPU-6050 6-axis accelerometer/gyroscope combo (compatible with MPU-6000)
23-
- SSD1308 - Solomon Systech SSD1308 128x64 OLED/PLED driver (thanks to Andrew Schamp)
13+
To use the library, just place the I2Cdev .cpp/.h source files and any device library .cpp/.h source files in the same folder as your sketch (or a suitable place relative to your avr-gcc project), and include just the device library headers that you need. Arduino users will also need to include <Wire.h> in your main sketch source file. Create a single device object (e.g. "ADXL345 accel();"), place any appropriate init function calls in your setup() routine (e.g. "accel.initialize();"), and off you go! See the example sketches inside many of the device class directories for reference.
2414

25-
UPCOMING DEVICE LIBRARIES:
26-
==========================
27-
- PanelPilot - Lascar Electronics PanelPilot multi-screen digital meter
28-
29-
Want something that isn't on the list? Request it, or fork the code and contribute! Better yet, send me a device on a breakout board to test the code during development. No guarantees on how fast I can get it done, but I'd love to make this the biggest consistent and well-documented I2C device library around.
15+
Want a library for a device that isn't up on the repository? Request it, or fork the code and contribute! Better yet, send me a device on a breakout board to test the code during development. No guarantees on how fast I can get it done, but I'd love to make this the biggest consistent and well-documented I2C device library around.

0 commit comments

Comments
 (0)