Skip to main content

I2C (Inter-Integrated Circuit)

LibXR::I2C provides a platform-independent interface for I2C bus communication. It supports reading and writing devices and registers, and configuring communication speed, making it suitable for peripheral control, sensor access, and similar applications.

Interface Overview​

Enum Types​

enum class MemAddrLength : uint8_t {
  BYTE_8,
  BYTE_16
};

Configuration Structure​

struct Configuration {
  uint32_t clock_speed;  // Communication clock speed (in Hz)
};

Core Methods​

virtual ErrorCode Read(uint16_t slave_addr, RawData read_data, ReadOperation& op) = 0;
virtual ErrorCode Write(uint16_t slave_addr, ConstRawData write_data, WriteOperation& op) = 0;
virtual ErrorCode SetConfig(Configuration config) = 0;

virtual ErrorCode MemRead(uint16_t slave_addr, uint16_t mem_addr,
                          RawData read_data, ReadOperation& op,
                          MemAddrLength mem_addr_size = MemAddrLength::BYTE_8) = 0;

virtual ErrorCode MemWrite(uint16_t slave_addr, uint16_t mem_addr,
                           ConstRawData write_data, WriteOperation& op,
                           MemAddrLength mem_addr_size = MemAddrLength::BYTE_8) = 0;

Feature Summary​

  • Supports reading and writing I2C devices and their registers;
  • Allows configuration of communication clock speed;
  • Register access supports 8-bit and 16-bit addresses;
  • Unified interface compatible with both asynchronous and synchronous operation models;
  • Facilitates platform-specific subclassing for cross-platform adaptation.