jrowberg/i2cdevlib
I2cdevlib
i2cdevlib is a collection of peripheral drivers and hardware abstraction layers designed for I2C devices. It provides a sensor driver collection, a register map database, and a peripheral manager to coordinate communication between microcontrollers and hardware components.
The project utilizes a hardware abstraction layer to decouple device logic from specific microcontroller hardware and wire libraries. This transport-layer abstraction allows the same device drivers to remain portable across different hardware architectures.
The library covers a broad range of hardware integration, including motion and inertial sensors, environmental monitors, real-time clocks, and capacitive touch sensing. It also includes support for GPIO expansion, analog-to-digital conversion, and the driving of OLED displays and digital meters.
The system includes tools for I2C protocol debugging and traffic analysis, enabling the correlation of raw logic analyzer data with human-readable register map definitions.
Features
- I2C Bus Interfaces - Provides standardized software interfaces for connecting microcontrollers to peripherals via the I2C protocol.
- Hardware Porting - Adapts the codebase to run across different microprocessor systems by abstracting transport operations.
- Bus Transport Interfaces - Implements a generic transport interface for bus operations, enabling driver portability across different hardware architectures.
- Hardware Abstraction Layers - Implements hardware abstraction layers to decouple device driver logic from specific microcontroller hardware.
- Peripheral Abstractions - Wraps I2C peripheral behaviors into standardized C++ classes to simplify interaction with diverse hardware.
- Hardware Peripheral Drivers - Provides a collection of specialized driver layers for various I2C sensors and peripherals.
- I2C Register Maps - Maintains a repository of bitfield definitions and register maps used to generate drivers and analyze bus traffic.
- Sensor Drivers - Provides a comprehensive set of drivers for reading data from accelerometers, gyroscopes, and pressure sensors.
- Transport Abstraction Layers - Decouples high-level device logic from low-level hardware communication libraries to ensure portability.
- Hardware Register Databases - Maintains a comprehensive database of register maps and bitfield definitions for a wide variety of I2C hardware.
- I2C I/O Expansion - Increases the number of available general-purpose input and output pins via an external 24-bit I2C expander.
- I2C Port Expanders - Increases available digital input and output pins using external I2C port expanders.
- Gyroscope Data Capture - Retrieves angular velocity measurements across three axes from a gyroscope sensor via the I2C protocol.
- Multi-Bus Management - Coordinates multiple communication objects to enable simultaneous interaction with several hardware buses.
- I2C Traffic Analysis - Analyzes I2C bus traffic and correlates raw data packets with register maps to troubleshoot communication.
- Inertial Measurement Unit Interfaces - Collects combined acceleration and rotation measurements from 6-axis or 9-axis inertial measurement units.
- Magnetometer Interfaces - Measures terrestrial magnetism and magnetic flux density across three axes to determine heading and 3D orientation.
- Real-Time Clock Management - Implements a standardized I2C interface to read and write time and date information to hardware real-time clocks.
- Register-Map Driver Generation - Automatically produces functional driver code and bitfield access patterns based on predefined hardware register specifications.
- Register-to-Human Mappings - Provides tools to correlate raw I2C bus traffic with human-readable register map definitions for easier debugging.
- Triaxial Acceleration Measurement - Provides drivers to retrieve high-resolution 3-axis acceleration and gravity measurements for detecting motion, shock, or tilt.
- Driver Code Generators - Automatically creates functional management code and bitfield access patterns using defined register map specifications.
- Bus Traffic Correlation - Correlates raw logic analyzer data with register maps to display human-readable names instead of hexadecimal values.
- Capacitive Touch Sensing - Provides the ability to read touch and proximity data from capacitive sensors via I2C to detect user interaction.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
