jrowberg/i2cdevlib
I2cdevlib
i2cdevlib es una colección de controladores de periféricos y capas de abstracción de hardware diseñadas para dispositivos I2C. Proporciona una colección de controladores de sensores, una base de datos de mapas de registros y un gestor de periféricos para coordinar la comunicación entre microcontroladores y componentes de hardware.
El proyecto utiliza una capa de abstracción de hardware para desacoplar la lógica del dispositivo del hardware específico del microcontrolador y las bibliotecas de cableado. Esta abstracción de la capa de transporte permite que los mismos controladores de dispositivo permanezcan portátiles a través de diferentes arquitecturas de hardware.
La biblioteca cubre una amplia gama de integración de hardware, incluyendo sensores de movimiento e inerciales, monitores ambientales, relojes de tiempo real y detección táctil capacitiva. También incluye soporte para expansión GPIO, conversión de analógico a digital y el control de pantallas OLED y medidores digitales.
El sistema incluye herramientas para la depuración del protocolo I2C y análisis de tráfico, permitiendo la correlación de datos brutos de analizadores lógicos con definiciones de mapas de registros legibles por humanos.
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.
