跳到主要内容

I2C（串行总线）

LibXR::I2C 提供平台无关的 I2C 总线通信接口，支持读写设备与寄存器、通信速率配置，适用于外设控制、传感器访问等场景。

接口概览​

枚举类型​

enum class MemAddrLength : uint8_t {
  BYTE_8,
  BYTE_16
};

配置结构​

struct Configuration {
  uint32_t clock_speed;  // 通信时钟速率（单位 Hz）
};

主要方法​

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;

特性总结​

  • 支持 I2C 设备读写与寄存器读写；
  • 支持配置通信时钟频率；
  • 寄存器访问支持 8/16 位地址；
  • 接口统一，兼容异步/同步调用模型；
  • 便于派生平台相关实现，支持跨平台适配。